InfoGrab DocsInfoGrab Docs

Databricks Lakebase Chat Memory 노드

요약

Databricks Lakebase Chat Memory 노드를 사용하면 AI 에이전트의 메모리1로 채팅 기록을 Databricks Lakebase 테이블에 저장할 수 있습니다. 이 페이지에서는 최초 1회 테이블 설정, 노드 파라미터, 세션 공유 방법, 추가 리소스 링크, 자주 발생하는 문제를 확인할 수 있습니다.

Databricks Lakebase Chat Memory 노드를 사용하면 AI 에이전트의 메모리1로 채팅 기록을 Databricks Lakebase 테이블에 저장할 수 있습니다. 이 노드는 Lakebase Data API로 테이블을 읽고 쓰므로 연결 문자열이나 데이터베이스 드라이버가 필요하지 않습니다.

이 페이지에서는 최초 1회 테이블 설정, 노드 파라미터, 세션 공유 방법, 추가 리소스 링크, 자주 발생하는 문제를 확인할 수 있습니다.

Note

자격 증명

이 노드의 인증 정보는 Databricks 자격 증명 문서를 참조하세요. 이 노드는 사용자 로그인 또는 서비스 프린시펄 방식의 Databricks OAuth2 자격 증명만 허용합니다. 프로젝트 소유자는 Data API를 사용할 수 없으므로, Lakebase 프로젝트를 소유하지 않은 ID로 인증하세요.

참고

이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.

테이블 생성#

Postgres Chat Memory 노드와 달리 이 노드는 테이블을 직접 생성하지 않습니다. Data API는 CREATE TABLE을 실행할 수 없으므로, 첫 실행 전에 Lakebase SQL 편집기에서 SQL을 한 번 실행해야 합니다. 노드를 실행할 때 테이블이 없으면, 오류 설명에 선택한 Schema와 Table Name이 채워진 동일한 구문이 출력됩니다.

설정에는 두 가지 ID가 사용됩니다. Lakebase SQL 편집기의 ID는 프로젝트 소유자 또는 관리자이며, 역할과 테이블을 생성합니다. 자격 증명이 인증에 사용하는 ID는 소유자가 아니며, 역할을 부여받아 테이블을 읽고 씁니다. 테이블을 생성하기 전에 Data API용 Lakebase 설정을 따라 Data API를 켜고, 자격 증명 ID용 Postgres 역할을 생성한 다음 이를 authenticator에 부여하세요. authenticator에 역할 부여 아래의 OpenAPI 사양 단계와 두 번째 SQL 블록은 건너뛸 수 있습니다. 이 노드는 테이블 목록을 조회하지 않으며, 아래 SQL에 필요한 권한 부여가 포함되어 있기 때문입니다. 그런 다음 역할을 생성한 ID로 Lakebase SQL 편집기에서 다음을 실행하세요. 이 ID가 테이블 소유자가 되며, GRANT 구문에 소유자 권한이 필요합니다.

CREATE TABLE "public"."n8n_chat_histories" (id SERIAL PRIMARY KEY, session_id VARCHAR(255) NOT NULL, message JSONB NOT NULL);
CREATE INDEX ON "public"."n8n_chat_histories" (session_id, id);
GRANT USAGE ON SCHEMA "public" TO "your-role";
GRANT SELECT, INSERT, DELETE ON "public"."n8n_chat_histories" TO "your-role";
GRANT USAGE ON SEQUENCE "public"."n8n_chat_histories_id_seq" TO "your-role";
  • "your-role"을 OAuth2 ID의 Postgres 역할로 바꾸세요. 사용자의 이메일 주소 또는 서비스 프린시펄의 애플리케이션 ID입니다. 설정 중에 databricks_create_role로 생성한 역할입니다.
  • Schema 또는 Table Name을 public과 n8n_chat_histories가 아닌 다른 값으로 설정했다면, 모든 구문에서 해당 값으로 바꾸세요. 시퀀스 이름도 포함하며, 시퀀스 이름은 테이블 이름 뒤에 _id_seq를 붙인 형태입니다.

노드 파라미터#

  • Project: 목록에서 Lakebase 프로젝트를 선택하거나, By ID를 선택하고 프로젝트 ID를 입력합니다.
  • Branch: 목록에서 프로젝트의 브랜치를 선택하거나, By ID를 선택하고 브랜치 ID를 입력합니다(예: production).
  • Database: 목록에서 브랜치의 Postgres 데이터베이스를 선택하거나, By ID를 선택하고 Postgres 데이터베이스 이름을 입력합니다(예: databricks_postgres).
  • Schema: 테이블이 있는 Postgres 스키마입니다. 기본값은 public이며, 목록에는 public만 표시됩니다. 다른 스키마를 사용하려면 By ID를 선택하고 이름을 입력하세요. Data API가 해당 스키마를 노출해야 합니다.
  • Table Name: 채팅 기록을 저장할 테이블 이름을 입력합니다. 기본값은 n8n_chat_histories입니다. 노드는 테이블을 생성하지 않습니다. 테이블 생성을 참조하세요.
  • Session ID: 노드가 세션 ID를 찾는 방법을 선택합니다.
    • Connected Chat Trigger Node: 직접 연결된 Chat Trigger 노드의 입력에서 sessionId 필드를 읽습니다.
    • Define below: 메모리에 세션 ID를 저장할 때 사용할 Key를 입력합니다. 여러 메모리 노드에서 같은 키를 사용하면 하나의 세션을 공유할 수 있습니다.
  • Context Window Length: 컨텍스트로 고려할 이전 상호작용의 수를 입력합니다. 기본값은 5입니다.

메모리 노드 간 세션 공유#

Session ID를 Connected Chat Trigger Node로 설정하면, 각 Databricks Lakebase Chat Memory 노드는 세션 범위를 자신의 노드 이름으로 한정하므로 한 워크플로의 두 메모리 노드가 기록을 공유하지 않습니다. 노드 이름을 변경하면 이 접미사가 바뀌어 에이전트가 빈 기록으로 시작하며, 기존 행은 테이블에 그대로 남습니다. 메모리 노드 간에 하나의 기록을 공유하려면 각 노드에서 Session ID를 Define below로 설정하고 같은 Key를 사용하세요. Chat Memory Manager 노드의 Override All Messages 삽입 모드처럼 기존 메모리 내용을 덮어쓰는 파괴적인 작업을 할 때는 주의하세요.

관련 리소스#

서비스에 대한 자세한 내용은 Lakebase Data API 문서를 참조하세요.

참고

이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.

자주 발생하는 문제#

테이블이 없음#

노드가 Table <schema>.<table> does not exist 오류로 실패합니다. 아직 테이블을 생성하지 않았거나, Schema 또는 Table Name이 테이블과 일치하지 않거나(PGRST205), 삭제한 테이블을 Data API 스키마 캐시가 여전히 나열하고 있는 경우(42P01)입니다. 오류 설명에는 선택한 스키마와 테이블에 대한 CREATE TABLE, CREATE INDEX, GRANT 구문이 들어 있습니다. 역할을 생성한 ID로 Lakebase SQL 편집기에서 실행하세요. 테이블 생성을 참조하세요.

역할에 권한이 없음#

노드가 The OAuth2 identity cannot use table <schema>.<table> 오류로 실패합니다. 테이블은 존재하지만 역할에 스키마, 테이블 또는 시퀀스에 대한 권한이 없는 경우입니다(42501). 오류 설명에는 세 개의 GRANT 구문이 들어 있습니다. 테이블 소유자로 실행하세요.

세션이 너무 커서 읽을 수 없음#

노드가 The session holds more rows than one run can read (100000) 오류로 실패합니다. 노드는 요청마다 최대 1,000개 행을 읽고 최대 100번 요청하므로, 세션이 100,000행을 넘으면(Lakebase 프로젝트의 Maximum rows 설정이 더 낮으면 그보다 적은 행에서) 기록의 일부만 반환하지 않고 실패합니다. 새 Session ID를 사용하거나, 테이블 소유자로 Lakebase SQL 편집기에서 해당 세션의 행을 삭제하세요. Chat Memory Manager 노드는 세션을 비울 수 없습니다. 전체 기록을 먼저 읽기 때문에 같은 오류로 실패합니다. Session ID를 Connected Chat Trigger Node로 설정한 경우, 저장된 session_id는 __<node-name>으로 끝납니다.

설정 오류#

invalid token permissions(PGRST301), permission denied to set role(42501), Data API가 노출하지 않는 스키마(PGRST106), The branch has no read-write compute endpoint는 테이블이 아니라 Data API 설정에서 발생합니다. Databricks 노드 페이지의 Lakebase 관련 일반 문제를 참조하세요.

Footnotes

  1. AI 맥락에서 메모리는 AI 도구가 상호작용 간에 메시지 컨텍스트를 유지하도록 합니다. 예를 들어 메시지마다 진행 중인 컨텍스트를 다시 제출하지 않고도 AI 에이전트와 대화를 이어갈 수 있습니다. n8n에서는 AI 에이전트 노드가 메모리를 사용할 수 있지만, AI 체인은 사용할 수 없습니다. ↩

Databricks Lakebase Chat Memory 노드

n8n v2.47
원문 보기

요약

Databricks Lakebase Chat Memory 노드를 사용하면 AI 에이전트의 메모리1로 채팅 기록을 Databricks Lakebase 테이블에 저장할 수 있습니다. 이 페이지에서는 최초 1회 테이블 설정, 노드 파라미터, 세션 공유 방법, 추가 리소스 링크, 자주 발생하는 문제를 확인할 수 있습니다.

Databricks Lakebase Chat Memory 노드를 사용하면 AI 에이전트의 메모리1로 채팅 기록을 Databricks Lakebase 테이블에 저장할 수 있습니다. 이 노드는 Lakebase Data API로 테이블을 읽고 쓰므로 연결 문자열이나 데이터베이스 드라이버가 필요하지 않습니다.

이 페이지에서는 최초 1회 테이블 설정, 노드 파라미터, 세션 공유 방법, 추가 리소스 링크, 자주 발생하는 문제를 확인할 수 있습니다.

Note

자격 증명

이 노드의 인증 정보는 Databricks 자격 증명 문서를 참조하세요. 이 노드는 사용자 로그인 또는 서비스 프린시펄 방식의 Databricks OAuth2 자격 증명만 허용합니다. 프로젝트 소유자는 Data API를 사용할 수 없으므로, Lakebase 프로젝트를 소유하지 않은 ID로 인증하세요.

참고

이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.

테이블 생성#

Postgres Chat Memory 노드와 달리 이 노드는 테이블을 직접 생성하지 않습니다. Data API는 CREATE TABLE을 실행할 수 없으므로, 첫 실행 전에 Lakebase SQL 편집기에서 SQL을 한 번 실행해야 합니다. 노드를 실행할 때 테이블이 없으면, 오류 설명에 선택한 Schema와 Table Name이 채워진 동일한 구문이 출력됩니다.

설정에는 두 가지 ID가 사용됩니다. Lakebase SQL 편집기의 ID는 프로젝트 소유자 또는 관리자이며, 역할과 테이블을 생성합니다. 자격 증명이 인증에 사용하는 ID는 소유자가 아니며, 역할을 부여받아 테이블을 읽고 씁니다. 테이블을 생성하기 전에 Data API용 Lakebase 설정을 따라 Data API를 켜고, 자격 증명 ID용 Postgres 역할을 생성한 다음 이를 authenticator에 부여하세요. authenticator에 역할 부여 아래의 OpenAPI 사양 단계와 두 번째 SQL 블록은 건너뛸 수 있습니다. 이 노드는 테이블 목록을 조회하지 않으며, 아래 SQL에 필요한 권한 부여가 포함되어 있기 때문입니다. 그런 다음 역할을 생성한 ID로 Lakebase SQL 편집기에서 다음을 실행하세요. 이 ID가 테이블 소유자가 되며, GRANT 구문에 소유자 권한이 필요합니다.

CREATE TABLE "public"."n8n_chat_histories" (id SERIAL PRIMARY KEY, session_id VARCHAR(255) NOT NULL, message JSONB NOT NULL);
CREATE INDEX ON "public"."n8n_chat_histories" (session_id, id);
GRANT USAGE ON SCHEMA "public" TO "your-role";
GRANT SELECT, INSERT, DELETE ON "public"."n8n_chat_histories" TO "your-role";
GRANT USAGE ON SEQUENCE "public"."n8n_chat_histories_id_seq" TO "your-role";
  • "your-role"을 OAuth2 ID의 Postgres 역할로 바꾸세요. 사용자의 이메일 주소 또는 서비스 프린시펄의 애플리케이션 ID입니다. 설정 중에 databricks_create_role로 생성한 역할입니다.
  • Schema 또는 Table Name을 public과 n8n_chat_histories가 아닌 다른 값으로 설정했다면, 모든 구문에서 해당 값으로 바꾸세요. 시퀀스 이름도 포함하며, 시퀀스 이름은 테이블 이름 뒤에 _id_seq를 붙인 형태입니다.

노드 파라미터#

  • Project: 목록에서 Lakebase 프로젝트를 선택하거나, By ID를 선택하고 프로젝트 ID를 입력합니다.
  • Branch: 목록에서 프로젝트의 브랜치를 선택하거나, By ID를 선택하고 브랜치 ID를 입력합니다(예: production).
  • Database: 목록에서 브랜치의 Postgres 데이터베이스를 선택하거나, By ID를 선택하고 Postgres 데이터베이스 이름을 입력합니다(예: databricks_postgres).
  • Schema: 테이블이 있는 Postgres 스키마입니다. 기본값은 public이며, 목록에는 public만 표시됩니다. 다른 스키마를 사용하려면 By ID를 선택하고 이름을 입력하세요. Data API가 해당 스키마를 노출해야 합니다.
  • Table Name: 채팅 기록을 저장할 테이블 이름을 입력합니다. 기본값은 n8n_chat_histories입니다. 노드는 테이블을 생성하지 않습니다. 테이블 생성을 참조하세요.
  • Session ID: 노드가 세션 ID를 찾는 방법을 선택합니다.
    • Connected Chat Trigger Node: 직접 연결된 Chat Trigger 노드의 입력에서 sessionId 필드를 읽습니다.
    • Define below: 메모리에 세션 ID를 저장할 때 사용할 Key를 입력합니다. 여러 메모리 노드에서 같은 키를 사용하면 하나의 세션을 공유할 수 있습니다.
  • Context Window Length: 컨텍스트로 고려할 이전 상호작용의 수를 입력합니다. 기본값은 5입니다.

메모리 노드 간 세션 공유#

Session ID를 Connected Chat Trigger Node로 설정하면, 각 Databricks Lakebase Chat Memory 노드는 세션 범위를 자신의 노드 이름으로 한정하므로 한 워크플로의 두 메모리 노드가 기록을 공유하지 않습니다. 노드 이름을 변경하면 이 접미사가 바뀌어 에이전트가 빈 기록으로 시작하며, 기존 행은 테이블에 그대로 남습니다. 메모리 노드 간에 하나의 기록을 공유하려면 각 노드에서 Session ID를 Define below로 설정하고 같은 Key를 사용하세요. Chat Memory Manager 노드의 Override All Messages 삽입 모드처럼 기존 메모리 내용을 덮어쓰는 파괴적인 작업을 할 때는 주의하세요.

관련 리소스#

서비스에 대한 자세한 내용은 Lakebase Data API 문서를 참조하세요.

참고

이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.

자주 발생하는 문제#

테이블이 없음#

노드가 Table <schema>.<table> does not exist 오류로 실패합니다. 아직 테이블을 생성하지 않았거나, Schema 또는 Table Name이 테이블과 일치하지 않거나(PGRST205), 삭제한 테이블을 Data API 스키마 캐시가 여전히 나열하고 있는 경우(42P01)입니다. 오류 설명에는 선택한 스키마와 테이블에 대한 CREATE TABLE, CREATE INDEX, GRANT 구문이 들어 있습니다. 역할을 생성한 ID로 Lakebase SQL 편집기에서 실행하세요. 테이블 생성을 참조하세요.

역할에 권한이 없음#

노드가 The OAuth2 identity cannot use table <schema>.<table> 오류로 실패합니다. 테이블은 존재하지만 역할에 스키마, 테이블 또는 시퀀스에 대한 권한이 없는 경우입니다(42501). 오류 설명에는 세 개의 GRANT 구문이 들어 있습니다. 테이블 소유자로 실행하세요.

세션이 너무 커서 읽을 수 없음#

노드가 The session holds more rows than one run can read (100000) 오류로 실패합니다. 노드는 요청마다 최대 1,000개 행을 읽고 최대 100번 요청하므로, 세션이 100,000행을 넘으면(Lakebase 프로젝트의 Maximum rows 설정이 더 낮으면 그보다 적은 행에서) 기록의 일부만 반환하지 않고 실패합니다. 새 Session ID를 사용하거나, 테이블 소유자로 Lakebase SQL 편집기에서 해당 세션의 행을 삭제하세요. Chat Memory Manager 노드는 세션을 비울 수 없습니다. 전체 기록을 먼저 읽기 때문에 같은 오류로 실패합니다. Session ID를 Connected Chat Trigger Node로 설정한 경우, 저장된 session_id는 __<node-name>으로 끝납니다.

설정 오류#

invalid token permissions(PGRST301), permission denied to set role(42501), Data API가 노출하지 않는 스키마(PGRST106), The branch has no read-write compute endpoint는 테이블이 아니라 Data API 설정에서 발생합니다. Databricks 노드 페이지의 Lakebase 관련 일반 문제를 참조하세요.

Footnotes

  1. AI 맥락에서 메모리는 AI 도구가 상호작용 간에 메시지 컨텍스트를 유지하도록 합니다. 예를 들어 메시지마다 진행 중인 컨텍스트를 다시 제출하지 않고도 AI 에이전트와 대화를 이어갈 수 있습니다. n8n에서는 AI 에이전트 노드가 메모리를 사용할 수 있지만, AI 체인은 사용할 수 없습니다. ↩