Data Landing Zone

重要

此頁面專屬於 Data Landing Zone 來源 連接器Experience Platform。 有關連接到 Data Landing Zone 目的地 連接器,請參閱 Data Landing Zone 目的地檔案頁面.

Data Landing Zone 是 Azure Blob 由Adobe Experience Platform布建的儲存介面,可授予您存取安全、雲端型檔案儲存功能,將檔案匯入Platform。 您可以存取 Data Landing Zone 每個沙箱的容器,且所有容器的資料量總計僅限於您的Platform產品與服務授權隨附的資料總計。 Platform及其應用程式服務的所有客戶,例如 Customer Journey Analytics, Journey Orchestration, Intelligent Services,和 Adobe 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會對上傳至 Data Landing Zone 容器。 所有檔案會在七天後刪除。

檔案和目錄的命名限制

以下是在命名雲儲存檔案或目錄時必須考慮的限制清單。

  • 目錄和檔案元件名稱不能超過255個字元。
  • 目錄和檔案名不能以斜線結尾(/)。 如果提供,則會自動移除。
  • 下列保留的URL字元必須正確逸出: ! ' ( ) ; @ & = + $ , % # [ ]
  • 不允許使用下列字元: " \ / : | < > * ?.
  • 不允許使用非法的URL路徑字元。 程式碼點,例如 \uE000,但在NTFS檔案名中有效,則不是有效的Unicode字元。 此外,有些ASCII或Unicode字元,例如控制字元(例如 0x00 to 0x1F, \u0081、等),也不允許。 如需HTTP/1.1中管理Unicode字串的規則,請參閱 RFC 2616,第2.2節:基本規則RFC 3987.
  • 不允許使用下列檔案名:LPT1、LPT2、LPT3、LPT4、LPT5、LPT6、LPT7、LPT8、LPT9、COM1、COM2、COM3、COM4、COM5、COM6、COM7、COM8、COM9、PRN、NUL、CON、CON$、點字元(…

管理 Data Landing Zone

您可以使用 Azure Storage Explorer 管理 Data Landing Zone 容器。

在 Azure Storage Explorer UI,在左側導覽中選取連線圖示。 此 選擇資源 窗口,提供連接到的選項。 選擇 Blob container 連接到 Data Landing Zone.

select-resource

下一步,選擇 共用訪問簽名URL(SAS) 作為連接方法,然後選取 下一個.

select-connection-method

選取連線方法後,您接下來必須提供 顯示名稱Blob容器SAS URL 與 Data Landing Zone 容器。

秘訣

您可以擷取 Data Landing Zone 平台UI中來源目錄的憑證。

提供您的 Data Landing Zone SAS URL,然後選擇 下一個

enter-connection-info

摘要 視窗中顯示,提供設定的概觀,包括您 Blob 端點和權限。 準備就緒時,請選取 Connect.

摘要

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

dlz-user-container

使用 Data Landing Zone 連接至 Azure Storage Explorer,您現在可以開始將檔案上傳至 Data Landing Zone 容器。 若要上傳,請選取 上傳 然後選取 上傳檔案.

上傳

選取要上傳的檔案後,您必須識別 Blob 輸入您要上傳的作為和所需目的地目錄。 完成後,請選取 上傳.

Blob 類型 說明
區塊 Blob 區塊 Blobs 已針對以有效方式上傳大量資料而最佳化。 區塊 Blobs 是 Data Landing Zone.
附加 Blob 附加 Blobs 會針對將資料附加至檔案結尾而最佳化。

上傳檔案

將檔案上傳至 Data Landing Zone 使用命令行介面

您也可以使用裝置的命令列介面,並存取上傳檔案至 Data Landing Zone.

使用Bash上傳檔案

下列範例使用Bash和cURL將檔案上傳至 Data Landing Zone 和 Azure Blob Storage REST API:

# Set Azure Blob-related settings
DATE_NOW=$(date -Ru | sed 's/\+0000/GMT/')
AZ_VERSION="2018-03-28"
AZ_BLOB_URL="<URL TO BLOB ACCOUNT>"
AZ_BLOB_CONTAINER="<BLOB CONTAINER NAME>"
AZ_BLOB_TARGET="${AZ_BLOB_URL}/${AZ_BLOB_CONTAINER}"
AZ_SAS_TOKEN="<SAS TOKEN, STARTING WITH ? AND ENDING WITH %3D>"

# Path to the file we wish to upload
FILE_PATH="</PATH/TO/FILE>"
FILE_NAME=$(basename "$FILE_PATH")

# Execute HTTP PUT to upload file (remove '-v' flag to suppress verbose output)
curl -v -X PUT \
   -H "Content-Type: application/octet-stream" \
   -H "x-ms-date: ${DATE_NOW}" \
   -H "x-ms-version: ${AZ_VERSION}" \
   -H "x-ms-blob-type: BlockBlob" \
   --data-binary "@${FILE_PATH}" "${AZ_BLOB_TARGET}/${FILE_NAME}${AZ_SAS_TOKEN}"

使用Python上載檔案

下列範例使用 Microsoft’s Python v12 SDK可將檔案上傳至 Data Landing Zone:

秘訣

下面的示例使用完整的SAS URI連接到 Azure Blob 容器,則可以使用其他方法和操作來驗證。 看這個 Microsoft 關於Python v12 SDK的文檔 以取得更多資訊。

import os
from azure.storage.blob import ContainerClient

try:
    # Set Azure Blob-related settings
    sasUri = "<SAS URI>"
    srcFilePath = "<FULL PATH TO FILE>"
    srcFileName = os.path.basename(srcFilePath)

    # Connect to container using SAS URI
    containerClient = ContainerClient.from_container_url(sasUri)

    # Upload file to Data Landing Zone with overwrite enabled
    with open(srcFilePath, "rb") as fileToUpload:
        containerClient.upload_blob(srcFileName, fileToUpload, overwrite=True)

except Exception as ex:
    print("Exception: " + ex.strerror)

使用上傳檔案 AzCopy

下列範例使用 Microsoft’s AzCopy 上傳檔案至 Data Landing Zone:

秘訣

以下範例是使用 copy 命令,可使用其他命令和選項將檔案上載到 Data Landing Zone,使用 AzCopy. 看這個 Microsoft AzCopy 檔案 以取得更多資訊。

set sasUri=<FULL SAS URI, PROPERLY ESCAPED>
set srcFilePath=<PATH TO LOCAL FILE(S); WORKS WITH WILDCARD PATTERNS>

azcopy copy "%srcFilePath%" "%sasUri%" --overwrite=true --recursive=true

Connect Data Landing Zone to Platform

以下檔案提供如何從 Data Landing Zone 容器至Adobe Experience Platform。

使用API

使用UI

本頁內容