Data Landing Zone

IMPORTANT
此頁面是Experience Platform中Data Landing Zone 來源 ​聯結器的專屬頁面。 如需有關連線至Data Landing Zone 目的地 ​聯結器的資訊,請參閱Data Landing Zone 目的地檔案頁面

Data Landing Zone是Adobe Experience Platform布建的Azure Blob儲存體介面,可授予您存取安全、雲端式的檔案儲存設施,以將檔案帶入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字元,例如控制字元(例如0x000x1F\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、AUX、NUL、CON、CLOCK$、點字元(.)和兩個點字元(…)。

管理資料登陸區域的內容 manage-the-contents-of-your-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

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

TIP
您可以從Platform UI中的來源目錄擷取您的Data Landing Zone認證。

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

enter-connection-info

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

摘要

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

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,透過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:

TIP
雖然下列範例使用完整SAS URI連線至Azure Blob容器,但您可以使用其他方法和作業來進行驗證。 如需詳細資訊,請參閱Python v12 SDK🔗上的此Microsoft 檔案。
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:

TIP
雖然下列範例是使用copy命令,但您可以使用AzCopy使用其他命令和選項將檔案上傳至Data Landing Zone。 如需詳細資訊,請參閱此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

將Data Landing Zone連線至Platform

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

使用API

使用UI

IMPORTANT
使用Data Landing Zone連線到Experience Platform時,目前不支援私人連結。 唯一支援的存取方法是這裡列出的方法。
recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089