Data Landing Zone

IMPORTANT
此页面特定于 Data Landing Zone Experience Platform中的连接器。 有关连接到 Data Landing Zone 目标 连接器,请参阅 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字符,如控制字符(如 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.

选择资源

接下来,选择 共享访问签名URL (SAS) 作为连接方法,然后选择 下一个.

select-connection-method

选择连接方法后,必须提供 显示名称Blob容器SAS URL 与您的 Data Landing Zone 容器。

TIP
您可以检索 Data Landing Zone 来自Platform UI中源目录的凭据。

提供您的 Data Landing Zone SAS URL,然后选择 下一个

enter-connection-info

摘要 窗口,为您提供设置的概述,包括有关您的设置的信息 Blob 端点和权限。 准备就绪后,选择 连接.

摘要

连接成功更新您的 Azure Storage Explorer 包含您的UI Data Landing Zone 容器。

dlz-user-container

与您的 Data Landing Zone 容器已连接到 Azure Storage Explorer,您现在可以开始将文件上传到 Data Landing Zone 容器。 要上载,请选择 上传 然后选择 上载文件.

上传

选择要上传的文件后,您必须识别 Blob 键入要将其上传为以及所需的目标目录。 完成后,选择 上传.

Blob 类型
描述
块 Blob
块 Blobs 已针对以高效方式上传大量数据进行了优化。 块 Blobs 是的默认选项 Data Landing Zone.
附加 Blob
附加 Blobs 已针对在文件末尾附加数据进行了优化。

upload-file

将文件上传到 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:

TIP
虽然下面的示例使用完整的SAS URI连接到 Azure Blob 容器,则可以使用其他方法和操作进行身份验证。 查看此 Microsoft Python v12 SDK文档 以了解更多信息。
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 命令,则可以使用其他命令和选项将文件上传到 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的容器。

使用API

使用UI

IMPORTANT
使用连接到Experience Platform时,当前不支持专用链接 Data Landing Zone. 唯一支持访问的方法是列出的方法 此处.
recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089