Delta Sharing
Delta Sharing ソースコネクタを使用すると、Databricks Delta Sharing ソースに安全に接続し、Adobe Experience Platformでバーチャルデータセットを作成できます。 これにより、Experience Platform サービスを通じて外部テーブルをクエリおよび使用しながら、リレーショナルスキーマを通じて共有データを表すことができます。 Delta Sharingを使用すると、重複データ ストレージを削減し、ストレージ コストを削減して、データ管理を簡素化できます。
前提条件 prerequisites
Adobe Experience PlatformからDatabricks Delta Sharing ソースに接続する前に、次の要件を満たしていることを確認してください。
プロバイダーの前提条件:Databricks
プロバイダー側で、次の情報が必要であることを確認します。
-
外部Delta Sharingが有効になっています: Databricks アカウント/ワークスペースに対して外部Delta Sharingを有効にし、デフォルトのトークン TTLを設定する必要があります。
-
対象となるデルタ テーブル:共有するテーブルは、次の条件を満たす必要があります。
- 差分テーブルになります。
- オープン Delta Sharing (外部ストレージまたはDatabricks サポートの設定)をサポートするストレージで設定してください。
- Notには行フィルターまたは列マスクが適用されています(Databricksでは、そのようなテーブルの共有は許可されていません)。
共有と受信者の設定
Databricks管理者は次の手順を完了する必要があります。
-
共有を作成し、テーブルを追加します。
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}; -
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で使用する4つの値が含まれています。
.share ファイルが表示されます| code language-json |
|---|
|
ネットワークとファイアウォールの設定
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 ソース機能を有効にする必要があります。 ソースカタログに「Data Sharing → Databricks Delta Share」カードが表示されない場合は、Adobe サポートまたはAdobe担当者にお問い合わせください。
さらに、接続を作成するユーザーは、ターゲットサンドボックスで次の権限を持っている必要があります。
- ソースへのアクセスと、ソース接続/データフローを作成するための権限。
- 仮想データセットを含む、スキーマとデータセットを作成する権限。
ガバナンスへの期待
- Delta Sharing接続がカタログに仮想データセットを作成します。 これらのデータセットは読み取り専用で、Experience Platformではバーチャルデータセットとして表されます。
- Experience Platformには行は取り込まれません。 スキーマ、リネージ、接続の詳細などのメタデータのみが保存されます。
- 標準のガバナンスラベルとポリシーは仮想スキーマに適用できますが、プライバシー/保持ジョブはソースデータを変更しません。
必要な資格情報の収集 gather-required-credentials
Delta Sharing ソースを認証して使用するには、次の資格情報の値を指定する必要があります:
.share資格情報ファイルに表示され、Experience Platformで共有の列挙、スキーマとテーブルの参照、メタデータとデータのプレビューの取得に使用されます。https://adb-1234567890123.4.azuredatabricks.net/api/2.0/delta-sharing/metastores/0a1b2c3d-4e5f-6789-abcd-0123456789efAuthorization: Bearer {BEARER_TOKEN})にAuthorization ヘッダーとして含まれることで、Experience PlatformをDelta Sharing サーバーの受信者として認証します。dapi1a2b3c4d5e6f7g8h9i0jklmnopqrstuvwx.share ファイルのshareCredentialsVersionに対応しています。 これは、トークンのバージョンではなく、資格情報ファイルスキーマのバージョンです。 Experience Platformは、プロファイル内のフィールドの解釈を理解するために使用します。 現在のDatabricks Delta Sharing個のプロファイルの値は1です。12026-03-31T23:59:59Z許可されているXDM フィールドデータタイプ allowed-xdm-field-data-types
共有テーブルをExperience Platform スキーマにマッピングする場合、次のXDM フィールドデータタイプのみが許可されます。
- コアプリミティブ:文字列、数値、整数、ブール値
- 制約を使用したサブタイプ: バイト、ショート、整数(32 ビット)、ロング
- 一時:日付、日時
- 構造:配列、オブジェクト
- 制約のある文字列のバリエーション:列挙/候補リスト (meta:enum)
UIでDatabricks Delta Sharingに接続
Delta Sharing ソースを使用してExperience Platformにデータを取り込む方法については、Databricks Delta Sharing UI ガイド を参照してください。