Data Landing Zone

Data Landing Zone 是 Azure Blob 由Adobe Experience Platform提供的儲存介面，允許您訪問安全、基於雲的檔案儲存設施，以將檔案帶入平台。 您可以訪問 Data Landing Zone 每個沙箱的容器，並且所有容器的總資料量僅限於隨平台產品和服務許可證提供的總資料。 平台及其應用服務(如 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 容器，這意味著您不需要為網路配置任何允許清單或跨區域設定。 平台對上載到的所有檔案強制實施嚴格的七天生存時間(TTL) Data Landing Zone 容器。 七天後刪除所有檔案。

檔案和目錄的命名約束

以下是命名雲儲存檔案或目錄時必須考慮的約束條件清單。

• 目錄和檔案元件名稱不能超過255個字元。
• 目錄和檔案名不能以正斜槓結尾(/)。 如果提供，將自動刪除。
• 必須正確轉義以下保留URL字元： ! ' ( ) ; @ & = + $ , % # [ ]
• 不允許使用以下字元： " \ / : | < > * ?。
• 不允許使用非法的URL路徑字元。 代碼點類似 \uE000，但在NTFS檔案名中有效，則不是有效的Unicode字元。 此外，某些ASCII或Unicode字元，如控制字元(如 0x00 至 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、COM9、COM9prn、AUX、NUL、CON、CLOCK$、點字元(.)和兩個點字元(…)。

管理您的內容 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 終結點和權限。 準備好後，選擇 連接。

成功連接將更新您的 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

連接 Data Landing Zone 至 Platform

以下文檔提供了有關如何從您的 Data Landing Zone 使用API或用戶介面將容器連接到Adobe Experience Platform。

使用API

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

使用UI

• 連接 Data Landing Zone 到使用UI的平台
• 在UI中為雲儲存連接建立資料流