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.

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

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

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

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

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

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

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

將檔案上傳至 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:

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:

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

• 建立 Data Landing Zone 源連接（使用流服務API）
• 使用流服務API為雲儲存源建立資料流

使用UI

• Connect Data Landing Zone 使用UI設為Platform
• 在UI中為雲儲存連線建立資料流

Business.Adobe.com 資源