Delta Sharing

AVAILABILITY
有限測試版已經結束。 一般可用性(GA)目前計畫於​ 2027 ​推出。 如需未來可用性的其他資訊,請聯絡您的Adobe客戶團隊。

透過Delta Sharing來源聯結器,您可以安全地連線至您的Databricks Delta Sharing來源,並在Adobe Experience Platform中建立虛擬資料集。 這可讓您透過Experience Platform服務查詢及使用外部表格,同時透過關聯式結構描述呈現共用資料,而不會將資料實際擷取到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表格:您計畫共用的表格必須:

    • 為​差異資料表。
    • 在支援開啟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來源功能。 如果您在來源目錄中看不到「資料共用→資料庫差異共用」卡片,請聯絡Adobe支援或您的Adobe代表。

此外,建立連線的使用者必須在目標沙箱中擁有下列許可權:

  • 存取來源和建立來源連線/資料流程的許可權。
  • 建立結構描述和資料集(包括虛擬資料集)的許可權。

治理期望

  • Delta Sharing個連線會在目錄中建立虛擬資料集。 這些資料集是唯讀的,在Experience Platform中會顯示為虛擬資料集。
  • Experience Platform中未擷取任何列。 只會儲存中繼資料,例如結構、歷程和連線詳細資訊。
  • 標準治理標籤和原則可套用至虛擬結構描述,但隱私權/保留工作不會修改來源資料。

收集必要的認證 gather-required-credentials

您必須提供下列認證的值,才能驗證及使用Delta Sharing來源:

認證
說明
範例
端點
端點是裝載共用資料表之Delta Sharing伺服器的基底URL。 Databricks在啟用外部Delta Sharing時產生,此端點會出現在收件者的.share認證檔案中,並由Experience Platform用來列舉共用、瀏覽結構描述和資料表,以及擷取中繼資料和資料預覽。
https://adb-1234567890123.4.azuredatabricks.net/api/2.0/delta-sharing/metastores/0a1b2c3d-4e5f-6789-abcd-0123456789ef
持有人權杖
持有人權杖是唯讀的Delta Sharing存取權杖,與Databricks中的特定收件者相關聯。 它會將Experience Platform作為收件者來驗證Delta Sharing伺服器,方法是作為授權標頭包含在每個請求(Authorization: Bearer {BEARER_TOKEN})中。
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

閱讀Databricks Delta Sharing ​ UI指南,瞭解如何使用Delta Sharing來源將資料內嵌至Experience Platform。

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