Data Landing Zone

Data Landing Zone是Adobe Experience Platform布建的Azure Blob儲存體介面，可授予您存取安全、雲端式的檔案儲存設施，以將檔案帶入Platform。 您有權存取每個沙箱的一個Data Landing Zone容器，而且所有容器的資料量總計以您的Platform產品和服務授權所提供的資料量為限。 所有Experience Platform客戶都已為每個沙箱布建一個Data Landing Zone容器。 您可以透過Azure Storage Explorer或命令列介面讀取及寫入檔案至容器。

Data Landing Zone支援SAS式驗證，其資料受到標準Azure Blob存放裝置安全機制的保護。 SAS式驗證可讓您透過公用網際網路連線，安全地存取Data Landing Zone容器。 您不需要變更網路即可存取Data Landing Zone容器，這表示您不需要為網路設定任何允許清單或跨區域設定。 Experience Platform對上傳至Data Landing Zone容器的所有檔案和資料夾強制實施嚴格的七天到期時間。 所有檔案和資料夾都會在七天後刪除。

檔案和目錄的命名限制

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

管理資料登陸區域的內容 manage-the-contents-of-your-data-landing-zone

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

在Azure Storage Explorer UI中，選取左側導覽中的連線圖示。 選取資源 ​視窗會出現，提供您連線的選項。 選取​ Blob container ​以連線至Data Landing Zone。

接著，選取​ 共用存取簽章URL (SAS) ​作為您的連線方法，然後選取​ 下一步。

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

提供您的Data Landing Zone SAS URL，然後選取​ 下一步

「摘要」視窗會出現，提供您設定的總覽，包括Blob端點與許可權的相關資訊。 準備就緒後，選取​ 連線。

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

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

選取要上傳的檔案後，您必須識別要上傳的Blob型別，以及您想要的目的地目錄。 完成後，選取​ 上傳。

使用命令列介面上傳檔案至您的Data Landing Zone

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

使用Bash上傳檔案

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

# 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

以下檔案提供如何使用API或使用者介面將資料從您的Data Landing Zone容器帶入Adobe Experience Platform的資訊。

使用API

使用UI