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的身份验证允许您通过公共Internet连接安全地访问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
您可以从平台UI中的源目录中检索Data Landing Zone凭据。

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

enter-connection-info

此时将显示​ 摘要 ​窗口,其中提供了设置的概述,包括有关Blob端点和权限的信息。 准备就绪后,选择​ 连接

摘要

成功连接将更新包含Data Landing Zone容器的Azure Storage Explorer用户界面。

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