資料登陸區域目的地

概觀 overview

Data Landing Zone 是一個由 Adobe Experience Platform 提供所需的 Azure Blob 儲存介面，可授權您存取安全、雲端式檔案儲存設施，並讓您將檔案匯出至平台之外。您可以存取一個 Data Landing Zone 每個沙箱的容器，以及所有容器的總資料量限於您的Platform產品和服務授權所提供的總資料。 Platform及其應用程式的所有客戶，例如 Customer Journey Analytics， Journey Orchestration， Intelligent Services、和 Real-Time Customer Data Platform 已布建一個 Data Landing Zone 每個沙箱的容器。 您可以透過讀取檔案並將檔案寫入容器 Azure Storage Explorer 或您的命令列介面。

Data Landing Zone 支援SAS驗證，其資料受到標準保護 Azure Blob 存放區安全機制在存放和傳輸中。 SAS式驗證可讓您安全地存取 Data Landing Zone 透過公用網際網路連線的容器。 您不需要變更網路即可存取 Data Landing Zone 容器，表示您不需要為網路設定任何允許清單或跨區域設定。

Platform會對上傳至的所有檔案強制實施嚴格的七天存留時間(TTL) Data Landing Zone 容器。 所有檔案會在七天後刪除。

連線至您的 資料登陸區域 透過API或UI儲存 connect-api-or-ui

支援的對象 supported-audiences

本節說明您可以將哪些型別的對象匯出至此目的地。

匯出型別和頻率 export-type-frequency

請參閱下表以取得目的地匯出型別和頻率的資訊。

匯出資料集 export-datasets

此目的地支援資料集匯出。 如需如何設定資料集匯出的完整資訊，請閱讀教學課程：

匯出資料的檔案格式 file-format

匯出時 對象資料，平台會建立 .csv， parquet，或 .json 檔案中所指定的儲存位置。 如需檔案的詳細資訊，請參閱 支援的匯出檔案格式 區段建立模型。

匯出時 資料集，平台會建立 .parquet 或 .json 檔案中所指定的儲存位置。 如需檔案的詳細資訊，請參閱 驗證資料集匯出成功 區段的資料。

先決條件 prerequisites

使用前，請注意下列必須符合的先決條件 Data Landing Zone 目的地。

連線您的 Data Landing Zone 容器至 Azure Storage Explorer

您可以使用 Azure Storage Explorer 管理您的內容 Data Landing Zone 容器。 若要開始使用 Data Landing Zone，您必須先擷取憑證，並在中輸入這些憑證 Azure Storage Explorer，並連線您的 Data Landing Zone 容器至 Azure Storage Explorer.

在 Azure Storage Explorer UI，請在左側導覽列中選取連線圖示。 此 選取資源 視窗隨即出現，為您提供可連線的選項。 選取 Blob container 以連線至您的 Data Landing Zone 儲存。

接下來，選取 共用存取簽章URL (SAS) 作為您的連線方法，然後選取 下一個.

選取連線方法後，您必須提供 顯示名稱 和 Blob容器SAS URL 與您的 Data Landing Zone 容器。

擷取您的憑證 Data Landing Zone retrieve-dlz-credentials

您必須使用Platform API來擷取 Data Landing Zone 認證。 擷取您認證的API呼叫說明如下。 如需有關取得標頭所需值的資訊，請參閱 Adobe Experience Platform API快速入門 指南。

API格式

GET /data/foundation/connectors/landingzone/credentials?type=dlz_destination

要求

以下請求範例會擷取現有登陸區域的認證。

curl -X GET \
  'https://platform.adobe.io/data/foundation/connectors/landingzone/credentials?type=dlz_destination' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \

回應

下列回應會傳回您登陸區域的認證資訊，包括目前的 SASToken 和 SASUri，以及 storageAccountName 與您的登陸區域容器相對應。

{
    "containerName": "dlz-user-container",
    "SASToken": "sv=2022-09-11&si=dlz-ed86a61d-201f-4b50-b10f-a1bf173066fd&sr=c&sp=racwdlm&sig=4yTba8voU3L0wlcLAv9mZLdZ7NlMahbfYYPTMkQ6ZGU%3D",
    "storageAccountName": "dlblobstore99hh25i3df123",
    "SASUri": "https://dlblobstore99hh25i3dflek.blob.core.windows.net/dlz-user-container?sv=2022-09-11&si=dlz-ed86a61d-201f-4b50-b10f-a1bf173066fd&sr=c&sp=racwdlm&sig=4yTba8voU3L0wlcLAv9mZLdZ7NlMahbfYYPTMkQ6ZGU%3D"
}

更新 Data Landing Zone 認證 update-dlz-credentials

您也可以視需要重新整理您的認證。 您可以更新 SASToken 向發出POST請求 /credentials 的端點 Connectors API。

API格式

POST /data/foundation/connectors/landingzone/credentials?type=dlz_destination&action=refresh

要求

以下請求會更新您的登陸區域認證。

curl -X POST \
  'https://platform.adobe.io/data/foundation/connectors/landingzone/credentials?type=dlz_destination&action=refresh' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \

回應

以下回應會傳回您的已更新值 SASToken 和 SASUri.

{
    "containerName": "dlz-user-container",
    "SASToken": "sv=2020-04-08&si=dlz-9c4d03b8-a6ff-41be-9dcf-20123e717e99&sr=c&sp=racwdlm&sig=JbRMoDmFHQU4OWOpgrKdbZ1d%2BkvslO35%2FXTqBO%2FgbRA%3D",
    "storageAccountName": "dlblobstore99hh25i3dflek",
    "SASUri": "https://dlblobstore99hh25i3dflek.blob.core.windows.net/dlz-user-container?sv=2020-04-08&si=dlz-9c4d03b8-a6ff-41be-9dcf-20123e717e99&sr=c&sp=racwdlm&sig=JbRMoDmFHQU4OWOpgrKdbZ1d%2BkvslO35%2FXTqBO%2FgbRA%3D"
}

提供您的顯示名稱(containerName)和 Data Landing Zone SAS URL，如上所述API呼叫中所傳回，然後選取「 下一個.

此 摘要 視窗會出現，為您提供設定的概觀，包括有關您的設定的 Blob 端點與許可權。 準備就緒後，選擇 連線.

成功的連線會更新您的 Azure Storage Explorer 含您的UI Data Landing Zone 容器。

使用您的 Data Landing Zone 容器已連線至 Azure Storage Explorer，您現在可以開始從Experience Platform將檔案匯出至 Data Landing Zone 容器。 若要匯出檔案，您必須建立與 Data Landing Zone Experience Platform UI中的目的地，如下節所述。

連線到目的地 connect

若要連線至此目的地，請遵循以下說明的步驟： 目的地設定教學課程. 在目標設定工作流程中，填寫以下兩個區段中列出的欄位。

驗證到目的地 authenticate

請確定您已連線至 Data Landing Zone 容器至 Azure Storage Explorer 如 必備條件 區段。 因為 Data Landing Zone 是Adobe布建的儲存體，您不需要在Experience PlatformUI中執行任何進一步步驟，即可對目的地進行驗證。

填寫目的地詳細資料 destination-details

若要設定目的地的詳細資訊，請填寫下方的必填和選用欄位。 UI中欄位旁的星號表示該欄位為必填欄位。

啟用警示 enable-alerts

您可以啟用警報以接收有關傳送到您目的地的資料流狀態的通知。 從清單中選取警報以訂閱接收有關資料流狀態的通知。 如需警示的詳細資訊，請參閱以下指南： 使用UI訂閱目的地警報.

當您完成提供目的地連線的詳細資訊時，請選取「 」 下一個.

啟用此目的地的對象 activate

另請參閱 啟用對象資料至批次設定檔匯出目的地 以取得啟用此目的地對象的指示。

正在排程

在 正在排程 步驟，您可以 設定匯出排程 針對您的 Data Landing Zone 目的地和您也可以 設定匯出檔案的名稱.

對應屬性和身分 map

在 對應 步驟，您可以選取要為設定檔匯出的屬性和身分欄位。 您也可以選取將匯出檔案中的標題變更為任何您想要的易記名稱。 如需詳細資訊，請檢視 對應步驟 在啟動批次目的地UI教學課程中。

驗證資料匯出成功 exported-data

若要確認資料是否已成功匯出，請檢查 Data Landing Zone 儲存，並確認匯出的檔案包含預期的設定檔母體。