InfoGrab DocsInfoGrab Docs

n8n-nodes-databricks 커뮤니티 패키지에서 마이그레이션

요약

기본 제공 Databricks 노드는 n8n-nodes-databricks 커뮤니티 패키지를 대체합니다. 커뮤니티 노드와 기본 제공 노드는 노드 유형이 다르므로 노드를 그 자리에서 변환할 수 없습니다. 기본 제공 AI 노드에는 서비스 프린시펄 또는 사용자 로그인을 사용하는 Databricks OAuth2 자격 증명이 필요합니다.

기본 제공 Databricks 노드는 n8n-nodes-databricks 커뮤니티 패키지를 대체합니다. 이 페이지에서는 각 커뮤니티 노드를 대응하는 기본 제공 노드와 매핑하고, 이동한 필드를 나열하며, 예상되는 동작 변경 사항을 설명합니다.

커뮤니티 노드와 기본 제공 노드는 노드 유형이 다르므로 노드를 그 자리에서 변환할 수 없습니다. 워크플로의 각 커뮤니티 노드에 대해 기본 제공 노드를 추가하고, 설정을 복사하고, 다시 연결한 다음 커뮤니티 노드를 삭제합니다.

기본 제공 AI 노드에는 서비스 프린시펄 또는 사용자 로그인을 사용하는 Databricks OAuth2 자격 증명이 필요합니다. 커뮤니티 패키지의 호스트 및 개인 액세스 토큰 자격 증명은 AI 노드에 대응하는 기본 제공 자격 증명이 없습니다. 기본 제공 Databricks 노드와 Databricks Trigger 노드만 개인 액세스 토큰을 허용합니다.

노드 매핑#

커뮤니티 노드 기본 제공 노드 변경 내용
Databricks Databricks 리소스는 동일합니다. 기본 제공 노드에는 Job 작업과 Databricks Trigger 노드가 추가되었습니다.
Databricks Chat Model Databricks Chat Model Model에서 서빙 엔드포인트 대신 Unity AI Gateway 모델 서비스인 catalog.schema.service를 선택합니다. Conversation ID 및 Return Trace 옵션은 없습니다.
Embeddings Databricks Embeddings Databricks Serving Endpoint가 Model로 바뀌며, 임베딩을 지원하는 모델 서비스의 목록입니다.
Databricks Vector Store Databricks Vector Store Index Name이 Index로 바뀌며, 목록에서 선택하거나 전체 catalog.schema.index 이름을 입력합니다. Text Column은 Content Column으로 바뀌며, 인덱스의 칼럼에서 선택합니다. Metadata Columns는 쉼표로 구분한 목록 대신 다중 선택입니다. Score Threshold는 없어졌으므로 Limit을 사용하세요. 새로 추가된 항목은 Search Mode와 Metadata Filter입니다.
Databricks AI Agent Databricks AI Agent Enable MLflow Tracking이 Export Traces to MLflow로 바뀝니다. 기본 실험 경로 /Shared/n8n-workflows-<workflow-id>는 그대로이며, 새 Experiment 필드에서 기존 실험을 선택할 수 있습니다. 에이전트의 자격 증명은 내보내기에만 필요합니다.

Vector Store 노드의 필드 차이#

커뮤니티 필드 기본 제공 필드 참고
Index Name (텍스트) Index From List를 선택하거나 Name에 전체 이름을 입력합니다. Insert Documents 모드에서는 목록에 Direct Access 인덱스만 표시됩니다.
Text Column (기본값 text) Content Column 인덱스의 칼럼에서 선택합니다. 관리형 인덱스에서 비워 두면 임베딩 소스 칼럼을 사용합니다.
Metadata Columns (쉼표로 구분한 텍스트) Metadata Columns 옵션 다중 선택입니다. 비워 두면 기본 키, 콘텐츠 칼럼, 벡터 칼럼을 제외한 모든 칼럼을 반환합니다.
Score Threshold (기본값 0.8) 없음 Limit을 사용하세요. 이유는 점수 임계값 없음을 참조하세요.
없음 Search Mode 옵션 Vector 또는 Hybrid입니다.
없음 Metadata Filter 옵션 filters_json으로 전송되는 JSON 필터입니다.

예상되는 동작 변경 사항#

  • 관리형 인덱스에서 검색이 작동합니다. 커뮤니티 노드는 항상 query_vector를 전송했으므로, Databricks가 임베딩을 계산하는 Delta Sync 인덱스의 모든 검색이 실패했습니다. 기본 제공 노드는 인덱스가 요구하는 대로 query_text 또는 query_vector를 전송합니다. 인덱스 유형과 임베딩을 참조하세요.
  • 임계값 때문에 결과가 누락되지 않습니다. 커뮤니티 노드의 Score Threshold 기본값은 0.8이었으며, 유사도 점수가 이보다 훨씬 낮은 인덱스에서는 모든 결과가 버려졌습니다. 기본 제공 노드는 상위 Limit개의 결과를 반환합니다.
  • 하이브리드 검색과 메타데이터 필터는 에이전트가 인덱스를 도구로 사용하는 경우를 포함하여 모든 검색 모드에서 사용할 수 있습니다.
  • 삽입은 요청 전에 검사됩니다. Delta Sync 인덱스나 잘못된 Content Column은 원시 API 오류 대신 문제를 명시하는 메시지와 함께 실패합니다.
  • 에이전트가 갈라지지 않습니다. 기본 제공 Databricks AI Agent는 포크가 아니라 AI Agent 노드 자체의 코드를 실행하므로 동일한 옵션을 제공하고 동일한 수정 사항을 받습니다.
  • 트레이스가 계속 같은 실험에 기록됩니다. 기존 워크플로 안에서 에이전트 노드를 교체해도 기본 실험 경로에 워크플로 ID가 포함되어 있으므로 동일합니다.

관련 리소스#

n8n-nodes-databricks 커뮤니티 패키지에서 마이그레이션

n8n v2.47
원문 보기

요약

기본 제공 Databricks 노드는 n8n-nodes-databricks 커뮤니티 패키지를 대체합니다. 커뮤니티 노드와 기본 제공 노드는 노드 유형이 다르므로 노드를 그 자리에서 변환할 수 없습니다. 기본 제공 AI 노드에는 서비스 프린시펄 또는 사용자 로그인을 사용하는 Databricks OAuth2 자격 증명이 필요합니다.

기본 제공 Databricks 노드는 n8n-nodes-databricks 커뮤니티 패키지를 대체합니다. 이 페이지에서는 각 커뮤니티 노드를 대응하는 기본 제공 노드와 매핑하고, 이동한 필드를 나열하며, 예상되는 동작 변경 사항을 설명합니다.

커뮤니티 노드와 기본 제공 노드는 노드 유형이 다르므로 노드를 그 자리에서 변환할 수 없습니다. 워크플로의 각 커뮤니티 노드에 대해 기본 제공 노드를 추가하고, 설정을 복사하고, 다시 연결한 다음 커뮤니티 노드를 삭제합니다.

기본 제공 AI 노드에는 서비스 프린시펄 또는 사용자 로그인을 사용하는 Databricks OAuth2 자격 증명이 필요합니다. 커뮤니티 패키지의 호스트 및 개인 액세스 토큰 자격 증명은 AI 노드에 대응하는 기본 제공 자격 증명이 없습니다. 기본 제공 Databricks 노드와 Databricks Trigger 노드만 개인 액세스 토큰을 허용합니다.

노드 매핑#

커뮤니티 노드 기본 제공 노드 변경 내용
Databricks Databricks 리소스는 동일합니다. 기본 제공 노드에는 Job 작업과 Databricks Trigger 노드가 추가되었습니다.
Databricks Chat Model Databricks Chat Model Model에서 서빙 엔드포인트 대신 Unity AI Gateway 모델 서비스인 catalog.schema.service를 선택합니다. Conversation ID 및 Return Trace 옵션은 없습니다.
Embeddings Databricks Embeddings Databricks Serving Endpoint가 Model로 바뀌며, 임베딩을 지원하는 모델 서비스의 목록입니다.
Databricks Vector Store Databricks Vector Store Index Name이 Index로 바뀌며, 목록에서 선택하거나 전체 catalog.schema.index 이름을 입력합니다. Text Column은 Content Column으로 바뀌며, 인덱스의 칼럼에서 선택합니다. Metadata Columns는 쉼표로 구분한 목록 대신 다중 선택입니다. Score Threshold는 없어졌으므로 Limit을 사용하세요. 새로 추가된 항목은 Search Mode와 Metadata Filter입니다.
Databricks AI Agent Databricks AI Agent Enable MLflow Tracking이 Export Traces to MLflow로 바뀝니다. 기본 실험 경로 /Shared/n8n-workflows-<workflow-id>는 그대로이며, 새 Experiment 필드에서 기존 실험을 선택할 수 있습니다. 에이전트의 자격 증명은 내보내기에만 필요합니다.

Vector Store 노드의 필드 차이#

커뮤니티 필드 기본 제공 필드 참고
Index Name (텍스트) Index From List를 선택하거나 Name에 전체 이름을 입력합니다. Insert Documents 모드에서는 목록에 Direct Access 인덱스만 표시됩니다.
Text Column (기본값 text) Content Column 인덱스의 칼럼에서 선택합니다. 관리형 인덱스에서 비워 두면 임베딩 소스 칼럼을 사용합니다.
Metadata Columns (쉼표로 구분한 텍스트) Metadata Columns 옵션 다중 선택입니다. 비워 두면 기본 키, 콘텐츠 칼럼, 벡터 칼럼을 제외한 모든 칼럼을 반환합니다.
Score Threshold (기본값 0.8) 없음 Limit을 사용하세요. 이유는 점수 임계값 없음을 참조하세요.
없음 Search Mode 옵션 Vector 또는 Hybrid입니다.
없음 Metadata Filter 옵션 filters_json으로 전송되는 JSON 필터입니다.

예상되는 동작 변경 사항#

  • 관리형 인덱스에서 검색이 작동합니다. 커뮤니티 노드는 항상 query_vector를 전송했으므로, Databricks가 임베딩을 계산하는 Delta Sync 인덱스의 모든 검색이 실패했습니다. 기본 제공 노드는 인덱스가 요구하는 대로 query_text 또는 query_vector를 전송합니다. 인덱스 유형과 임베딩을 참조하세요.
  • 임계값 때문에 결과가 누락되지 않습니다. 커뮤니티 노드의 Score Threshold 기본값은 0.8이었으며, 유사도 점수가 이보다 훨씬 낮은 인덱스에서는 모든 결과가 버려졌습니다. 기본 제공 노드는 상위 Limit개의 결과를 반환합니다.
  • 하이브리드 검색과 메타데이터 필터는 에이전트가 인덱스를 도구로 사용하는 경우를 포함하여 모든 검색 모드에서 사용할 수 있습니다.
  • 삽입은 요청 전에 검사됩니다. Delta Sync 인덱스나 잘못된 Content Column은 원시 API 오류 대신 문제를 명시하는 메시지와 함께 실패합니다.
  • 에이전트가 갈라지지 않습니다. 기본 제공 Databricks AI Agent는 포크가 아니라 AI Agent 노드 자체의 코드를 실행하므로 동일한 옵션을 제공하고 동일한 수정 사항을 받습니다.
  • 트레이스가 계속 같은 실험에 기록됩니다. 기존 워크플로 안에서 에이전트 노드를 교체해도 기본 실험 경로에 워크플로 ID가 포함되어 있으므로 동일합니다.

관련 리소스#