개요#

데이터 테이블은 n8n 환경 내에 데이터 저장소를 통합합니다. 데이터 테이블을 사용하면 다음과 같은 시나리오에서 외부 데이터베이스 시스템에 의존하지 않고도 워크플로 내에서 직접 데이터를 저장, 관리, 조작할 수 있습니다.

• 동일한 프로젝트 내 워크플로 간 데이터 유지
• 중복 실행을 방지하거나 워크플로 트리거를 제어하기 위한 마커 저장
• 워크플로 간 프롬프트 또는 메시지 재사용
• AI 워크플로용 평가 데이터 저장
• 워크플로 실행으로 생성된 데이터 저장
• 서로 다른 소스의 데이터를 결합하여 데이터셋 보강
• 워크플로 내에서 빠른 참조 지점 역할을 하는 조회 테이블 생성

데이터 테이블 사용하기#

데이터 테이블과 그 데이터를 생성, 필터링, 관리하는 방법에는 Data Table node, DataTable API 엔드포인트, Data tables 탭의 세 가지가 있습니다.

Data Table 노드#

워크플로 내에서 데이터 테이블을 사용하여 데이터를 저장하고 관리함으로써, 워크플로가 실행되는 동안 생성, 조회, 업데이트, 삭제를 자동화할 수 있습니다.

전체 문서는 Data Table node를 참조하세요.

DataTable API 엔드포인트#

n8n API의 /datatables 엔드포인트를 사용하여 데이터 테이블을 프로그래밍 방식으로 다룰 수 있습니다.

전체 문서는 API reference를 참조하세요.

Data table 탭#

시각적 인터페이스를 통해 UI에서 직접 데이터 테이블을 보고 작업할 수 있습니다. 이를 통해 워크플로를 구축하지 않고도 데이터를 탐색하고 편집하며 테이블을 관리할 수 있습니다.

1. 프로젝트에서 Data tables 탭을 선택합니다.

2. 오른쪽 상단의 분할 버튼을 클릭하고 Create Data table을 선택합니다.

   

3. 테이블에 대한 설명이 담긴 이름을 입력합니다.

4. 테이블 생성 방법을 선택합니다.

   • From scratch: 시각적 인터페이스를 사용하여 칼럼을 직접 정의하고 행을 추가함으로써 새 테이블을 생성합니다.
   • Import CSV: CSV 파일을 업로드하여 테이블 구조를 자동으로 생성하고 파일의 데이터로 채웁니다.

   표시되는 테이블 보기에서 다음 작업을 수행할 수 있습니다.

   • 데이터 테이블 또는 그 칼럼의 이름 변경 및 삭제
   • 데이터를 정리하기 위한 칼럼 추가 및 순서 변경
   • 행 추가, 삭제, 업데이트
   • 기존 데이터 편집

데이터 내보내기 및 가져오기#

Data tables 탭에서 다음 작업을 수행할 수 있습니다.

• 이전 섹션에서 설명한 대로 CSV 데이터를 데이터 테이블로 직접 가져옵니다
• 데이터 테이블의 CSV를 다운로드합니다. 왼쪽 상단의 점 3개 메뉴를 클릭하고 Download CSV를 선택합니다.

데이터 테이블의 고려 사항 및 제한 사항#

• 데이터 테이블은 가볍거나 중간 정도 수준의 데이터 저장에 적합합니다. 기본적으로 인스턴스 내 모든 데이터 테이블이 사용하는 총 저장 공간은 50MB로 제한됩니다. 셀프 호스팅 환경에서는 환경 변수 N8N_DATA_TABLES_MAX_SIZE_BYTES를 사용하여 이 기본 크기 제한을 늘릴 수 있습니다.
• 데이터 테이블이 저장 공간 제한의 80%에 근접하면 n8n에서 경고가 표시됩니다. 저장 공간 제한에 도달하면 최종 경고가 표시됩니다. 이 제한을 초과하면 테이블에 대한 수동 추가가 비활성화되고, 데이터를 삽입하거나 업데이트하려는 시도 중 워크플로 실행 오류가 발생합니다.
• 기본적으로 프로젝트 내에서 생성된 데이터 테이블은 해당 프로젝트의 모든 팀원이 액세스할 수 있습니다.
• 관리자와 소유자는 모든 사용자의 데이터 테이블을 볼 수 있습니다.
• Code node에서 데이터 테이블에 직접 프로그래밍 방식으로 액세스하는 것은 지원되지 않습니다. 내장 메서드나 변수를 통해 데이터 테이블 값에 액세스할 수 없습니다.

데이터 테이블 대 변수#