Delta Sharing

AVAILABILITY
限定ベータが終了しました。 一般提供(GA)は現在、2027​に予定されています。 今後のご利用に関する詳細については、Adobe アカウントチームにお問い合わせください。

Delta Sharing ソースコネクタを使用すると、Databricks Delta Sharing ソースに安全に接続し、Adobe Experience Platformでバーチャルデータセットを作成できます。 これにより、Experience Platform サービスを通じて外部テーブルをクエリおよび使用しながら、リレーショナルスキーマを通じて共有データを表すことができます。 Delta Sharingを使用すると、重複データ ストレージを削減し、ストレージ コストを削減して、データ管理を簡素化できます。

前提条件 prerequisites

Adobe Experience PlatformからDatabricks Delta Sharing ソースに接続する前に、次の要件を満たしていることを確認してください。

IMPORTANT
Delta Sharingは、ソースデータをExperience Platformに物理的に取り込んだりコピーしたりしません。 Experience Platformでは、共有データはバーチャルデータセットとして表されます。 使用する共有テーブルがDelta Sharingを通じて使用可能であり、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で使用する4つの値が含まれています。

選択すると、例.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 ソース機能を有効にする必要があります。 ソースカタログに「Data Sharing → Databricks Delta Share」カードが表示されない場合は、Adobe サポートまたはAdobe担当者にお問い合わせください。

さらに、接続を作成するユーザーは、ターゲットサンドボックスで次の権限を持っている必要があります。

  • ソースへのアクセスと、ソース接続/データフローを作成するための権限。
  • 仮想データセットを含む、スキーマとデータセットを作成する権限。

ガバナンスへの期待

  • Delta Sharing接続がカタログに仮想データセットを作成します。 これらのデータセットは読み取り専用で、Experience Platformではバーチャルデータセットとして表されます。
  • Experience Platformには行は取り込まれません。 スキーマ、リネージ、接続の詳細などのメタデータのみが保存されます。
  • 標準のガバナンスラベルとポリシーは仮想スキーマに適用できますが、プライバシー/保持ジョブはソースデータを変更しません。

必要な資格情報の収集 gather-required-credentials

Delta Sharing ソースを認証して使用するには、次の資格情報の値を指定する必要があります:

資格情報
説明
例
エンドポイント
エンドポイントは、共有テーブルをホストする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
Bearer トークン
ベアラートークンは、Databricksの特定の受信者に関連付けられた読み取り専用のDelta Sharing アクセストークンです。 すべてのリクエスト (Authorization: Bearer {BEARER_TOKEN})にAuthorization ヘッダーとして含まれることで、Experience PlatformをDelta Sharing サーバーの受信者として認証します。
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 ビット)、ロング
  • 一時:​日付、日時
  • 構造:​配列、オブジェクト
  • 制約のある文字列のバリエーション:​列挙/候補リスト (meta:enum)

UIでDatabricks Delta Sharingに接続

Delta Sharing ソースを使用してExperience Platformにデータを取り込む方法については、Databricks Delta Sharing ​ UI ガイド ​を参照してください。

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