설명서Experience Platform소스 커넥터 안내서

Delta Sharing

마지막 업데이트: 2026년 10월 23일

작성 대상:

  • 개발자
AVAILABILITY
제한된 베타가 종료되었습니다. 현재 2027​에 GA(일반 가용성)가 예정되어 있습니다. 향후 가용성에 대한 자세한 내용은 Adobe 계정 팀에 문의하십시오.

Delta Sharing 소스 커넥터를 사용하면 Databricks Delta Sharing 소스에 안전하게 연결하고 Adobe Experience Platform에서 가상 데이터 세트를 만들 수 있습니다. 이렇게 하면 데이터를 실제로 Platform에 수집하지 않고도 관계형 스키마를 통해 공유 데이터를 나타내는 동시에 Experience Platform 서비스를 통해 외부 테이블을 쿼리하고 사용할 수 있습니다. Delta Sharing을(를) 사용하면 중복 데이터 저장소를 줄이고 저장소 비용을 낮추고 데이터 관리를 간소화할 수 있습니다.

사전 요구 사항 prerequisites

Adobe Experience Platform에서 Databricks Delta Sharing 소스에 연결하기 전에 다음 요구 사항이 충족되는지 확인하십시오.

IMPORTANT
Delta Sharing은(는) 소스 데이터를 Experience Platform으로 실제로 수집하거나 복사하지 않습니다. 대신 공유 데이터는 Experience Platform에서 가상 데이터 세트로 표시됩니다. 사용하려는 공유 테이블이 델타 공유를 통해 사용 가능하고 Experience Platform의 관계형 스키마를 통해 표시될 수 있는지 확인합니다.

Databricks 공급자 필수 구성 요소

공급자 측에서 다음을 확인해야 합니다.

  • 외부 Delta Sharing이(가) 활성화됨: Databricks 계정/작업 영역에 대해 외부 Delta Sharing을(를) 활성화하고 기본 토큰 TTL을 구성해야 합니다.

  • 적격 델타 테이블: 공유할 테이블은 다음과 같아야 합니다.

    • 델타 테이블​이어야 합니다.
    • 열려 있는 Delta Sharing을(를) 지원하는 저장소(외부 저장소 또는 Databricks에서 지원하는 구성)에서 구성하십시오.
    • Not​에 행 필터 또는 열 마스크가 적용되어 있습니다(Databricks에서는 이러한 테이블을 공유할 수 없음).

공유 및 수신자 구성

Databricks 관리자는 다음 단계를 완료해야 합니다.

  1. 공유​를 만들고 테이블 추가:

    code language-sql 
    CREATE SHARE IF NOT EXISTS my_first_share
  COMMENT 'Share for Adobe Experience Platform';

ALTER SHARE my_first_share
  ADD TABLE {CATALOG}.{SCHEMA}.{TABLE};

  2. Experience Platform에 대한 수신자를 만들고 공유를 부여합니다.

    code language-sql 
    CREATE RECIPIENT IF NOT EXISTS plat_recipient
  COMMENT 'Recipient for Platform Delta Sharing source';
GRANT SELECT ON SHARE my_first_share TO RECIPIENT plat_recipient;

이 받는 사람의 Delta Sharing 자격 증명 파일(.share)을 다운로드합니다. 이 파일에는 Experience Platform UI에서 사용할 네 가지 값이 포함되어 있습니다.

예제 .share 파일을 보려면 선택하십시오.
code language-json 
{
  "shareCredentialsVersion": 1,
  "endpoint": "https://{WORKSPACE}.azuredatabricks.net/api/2.0/delta-sharing/metastores/{ID}",
  "bearerToken": "dapi1234567890abcdef1234567890abcdef-1234567890abcdef",
  "expirationTime": "2026-03-31T23:59:59Z"
}

네트워크 및 방화벽 구성

Azure Data Lake Storage Gen2, Amazon S3, Google Cloud Storage과(와) 같은 클라우드 저장소 계정이 방화벽 규칙에 의해 보호되는 경우 Experience Platform에서 필요한 Delta Sharing resource, including에 액세스할 수 있는지 확인하십시오.

  • .share 파일의 Delta Sharing 끝점입니다.
  • 공유 테이블에 대한 기본 저장소 경로입니다.

Experience Platform 사전 요구 사항

지원되는 환경

  • Experience Platform 조직은 지원되는 Azure 지역에서 호스팅되어야 합니다.
  • 조직에 대해 Delta Sharing 원본 기능을 사용하도록 설정해야 합니다. 소스 카탈로그에 “데이터 공유 → Databricks Delta Share” 카드가 표시되지 않으면 Adobe 지원 센터 또는 Adobe 담당자에게 문의하십시오.

또한 연결을 만드는 사용자는 대상 샌드박스에서 다음 권한이 있어야 합니다.

  • 소스에 대한 액세스 및 소스 연결/데이터 흐름을 만들기 위한 권한.
  • 가상 데이터 세트를 포함하여 스키마 및 데이터 세트를 만들 수 있는 권한.

거버넌스 기대치

  • Delta Sharing개의 연결에서 카탈로그에 가상 데이터 세트를 만듭니다. 이러한 데이터 세트는 읽기 전용이며 Experience Platform에서 가상 데이터 세트로 표시됩니다.
  • Experience Platform에 수집된 행이 없습니다. 스키마, 계보 및 연결 세부 정보와 같은 메타데이터만 저장됩니다.
  • 표준 거버넌스 레이블 및 정책은 가상 스키마에 적용할 수 있지만 개인 정보 보호/보존 작업은 소스 데이터를 수정하지 않습니다.

필요한 자격 증명 수집 gather-required-credentials

Delta Sharing 원본을 인증하고 사용하려면 다음 자격 증명에 대한 값을 제공해야 합니다.

자격 증명
설명
예
엔드포인트
Endpoint는 공유 테이블을 호스팅하는 Delta Sharing 서버의 기본 URL입니다. 외부 Delta Sharing을(를) 사용하도록 설정할 때 Databricks에서 생성한 이 끝점은 받는 사람의 .share 자격 증명 파일에 나타나며 Experience Platform에서 공유를 열거하고, 스키마 및 테이블을 찾고, 메타데이터 및 데이터 미리 보기를 가져오는 데 사용됩니다.
https://adb-1234567890123.4.azuredatabricks.net/api/2.0/delta-sharing/metastores/0a1b2c3d-4e5f-6789-abcd-0123456789ef
전달자 토큰
전달자 토큰은 Databricks의 특정 받는 사람과 연결된 읽기 전용 Delta Sharing 액세스 토큰입니다. 모든 요청(Authorization: Bearer {BEARER_TOKEN})에서 인증 헤더로 포함되어 Delta Sharing 서버에 대한 수신자로 Experience Platform을 인증합니다.
dapi1a2b3c4d5e6f7g8h9i0jklmnopqrstuvwx
자격 증명 버전 공유
공유 자격 증명 버전이 .share 파일의 shareCredentialsVersion에 해당합니다. 토큰 버전이 아니라 자격 증명 파일 스키마의 버전입니다. Experience Platform은 이 플러그인을 사용하여 프로필의 필드를 해석하는 방법을 이해합니다. 오늘의 Databricks Delta Sharing 프로필의 경우 값은 1입니다.
1
만료 시간
만료 시간은 전달자 토큰이 만료되는 시기를 지정하는 선택적 타임스탬프입니다. 만료 시간은 유효한 UTC ISO-8601 타임스탬프여야 합니다.
2026-03-31T23:59:59Z

허용된 XDM 필드 데이터 유형 allowed-xdm-field-data-types

공유 테이블을 Experience Platform 스키마에 매핑할 때 다음 XDM 필드 데이터 유형만 허용됩니다.

  • 코어 기본 형식: 문자열, 숫자, 정수, 부울
  • 제약 조건을 통한 하위 형식:​바이트, 짧음, 정수(32비트), 길음
  • 임시: 날짜, DateTime
  • 구조적: 배열, 개체
  • 제한된 문자열 변형: 열거형/제안 목록(meta:enum)

UI에서 Databricks Delta Sharing에 연결

Delta Sharing 소스를 사용하여 Experience Platform으로 데이터를 수집하는 방법에 대해 알아보려면 Databricks Delta Sharing ​ UI 안내서를 읽어 보십시오.

recommendation-more-help
experience-platform-help-sources