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产品和服务许可证提供的总数据为限。 所有Experience Platform客户都为每个沙盒配置一个Data Landing Zone容器。 您可以通过Azure Storage Explorer或命令行界面将文件读取和写入容器。

Data Landing Zone支持基于SAS的身份验证,其数据受标准Azure Blob存储安全机制的静态和传输保护。 基于SAS的身份验证允许您通过公共Internet连接安全地访问Data Landing Zone容器。 访问Data Landing Zone容器不需要更改网络,这意味着您不需要为网络配置任何允许列表或跨区域设置。 Experience Platform对上传到Data Landing Zone容器的所有文件和文件夹强制实施严格的七天过期时间。 所有文件和文件夹都会在七天后删除。

NOTE
如果要从Azure Data Factory访问Data Landing Zone,则必须使用Experience Platform提供的SAS凭据为Data Landing Zone创建链接的服务。 创建链接的服务后,您可以通过选择容器路径而不是默认的根路径来浏览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