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 通过公共Internet连接的容器。 您无需更改网络即可访问 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) 作为连接方法,然后选择 下一个.
选择连接方法后,必须提供 显示名称 和 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:
copy
命令,则可以使用其他命令和选项将文件上传到 Data Landing Zone,使用 AzCopy. 查看此 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
以下文档提供了有关如何从获取数据的信息 Data Landing Zone 通过API或用户界面发送到Adobe Experience Platform的容器。