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字元,例如控制字元(例如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、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。
接著,選取 共用存取簽章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:
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的資訊。