데이터 테이블

데이터 테이블

개요

데이터 테이블은 n8n 환경 안에 데이터 저장소를 통합해요. 데이터 테이블을 쓰면 외부 데이터베이스 시스템에 의존하지 않고도 워크플로에서 직접 데이터를 저장·관리·활용할 수 있어요. 이런 시나리오에서 특히 유용해요.

• 같은 프로젝트의 워크플로 간에 데이터 유지
• 중복 실행 방지나 워크플로 트리거 제어를 위한 마커 저장
• 워크플로 간 프롬프트·메시지 재사용
• AI 워크플로를 위한 평가(evaluation) 데이터 저장
• 워크플로 실행에서 생성된 데이터 저장
• 여러 출처의 데이터를 합쳐 데이터셋 보강
• 워크플로 안에서 빠르게 참조할 수 있는 룩업 테이블 생성

데이터 테이블 다루기

데이터 테이블과 그 안의 데이터는 세 가지 방법으로 만들고, 필터링하고, 관리할 수 있어요. Data Table 노드, DataTable API 엔드포인트, 데이터 테이블 탭이 바로 그것이에요.

Data Table 노드

워크플로 안에서 데이터 테이블을 사용해 데이터를 저장·관리해요. 워크플로가 실행되면서 생성·조회·수정·삭제를 자동화할 수 있어요.

전체 문서는 Data Table 노드에서 확인하세요.

DataTable API 엔드포인트

n8n API의 /datatables 엔드포인트를 사용해 프로그래밍 방식으로 데이터 테이블을 다뤄요.

전체 문서는 API 레퍼런스에서 확인하세요.

데이터 테이블 탭

UI의 시각적 인터페이스로 데이터 테이블을 직접 보고 다뤄요. 워크플로를 만들지 않고도 데이터를 살펴보고 편집하며, 테이블을 관리할 수 있어요.

1. n8n 프로젝트에서 Data tables 탭을 선택해요.

2. 오른쪽 위에 있는 분할 버튼을 클릭하고 Create Data table을 선택해요.

   

3. 테이블에 알맞은 이름을 입력해요.

4. 테이블을 만들 방식을 선택해요.

   • From scratch: 시각적 인터페이스로 열(column)을 직접 정의하고 행(row)을 추가해 새 테이블을 만들어요.
   • Import CSV: CSV 파일을 업로드해 테이블 구조를 자동으로 만들고 파일의 데이터로 채워요.

   나타나는 테이블 보기에서는 이런 작업을 할 수 있어요.

   • 데이터 테이블이나 그 열 이름 바꾸기·삭제
   • 열 추가·순서 변경으로 데이터 정리
   • 행 추가·삭제·업데이트
   • 기존 데이터 편집
   • 데이터 테이블 즐겨찾기로 빠르게 접근

데이터 내보내기·가져오기

Data tables 탭에서는 다음을 할 수 있어요.

• 이전 섹션에서 설명한 대로 CSV 데이터를 데이터 테이블로 직접 가져오기
• 데이터 테이블을 CSV로 내려받기. 왼쪽 위의 세 점 메뉴를 클릭하고 Download CSV를 선택하면 돼요.

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

• 데이터 테이블은 가볍고 중간 정도의 데이터 저장에 적합해요. 기본적으로 인스턴스의 모든 데이터 테이블이 사용하는 총 저장 공간은 200 MiB로 제한돼요. 셀프호스팅 환경에서는 환경 변수 N8N_DATA_TABLES_MAX_SIZE_BYTES로 이 크기 제한을 바꿀 수 있어요.
• 데이터 테이블이 저장 한도의 약 80%에 다다르면 n8n이 경고를 표시해요. 저장 한도에 도달하면 최종 경고가 나와요. 한도를 초과하면 테이블에 수동 추가가 비활성화되고, 데이터를 삽입·업데이트하려다가 워크플로 실행 오류가 발생해요.
• 기본적으로 프로젝트 안에서 만든 데이터 테이블은 그 프로젝트의 모든 팀원이 접근할 수 있어요.
• 관리자(Admins)와 소유자(Owner)는 모든 사용자의 데이터 테이블을 볼 수 있어요.
• Code 노드에서 데이터 테이블에 프로그램 방식으로 직접 접근하는 것은 지원되지 않아요. 내장 메서드나 변수로 데이터 테이블 값에 접근할 수 없어요.

데이터 테이블과 변수 비교