Data Landing Zone

Data Landing Zone es una interfaz de almacenamiento de Azure Blob aprovisionada por Adobe Experience Platform, que le permite acceder a una función de almacenamiento de archivos segura y basada en la nube para traer archivos a Platform. Tiene acceso a un contenedor Data Landing Zone por zona protegida, y el volumen total de datos en todos los contenedores se limita a los datos totales proporcionados con su licencia de productos y servicios de Platform. A todos los clientes de Experience Platform se les ha proporcionado un contenedor Data Landing Zone por zona protegida. Puede leer y escribir archivos en su contenedor a través de Azure Storage Explorer o de la interfaz de línea de comandos.

Data Landing Zone admite la autenticación basada en SAS y sus datos están protegidos con mecanismos de seguridad de almacenamiento estándar de Azure Blob en reposo y en tránsito. La autenticación basada en SAS le permite tener acceso de forma segura a su contenedor de Data Landing Zone a través de una conexión pública a Internet. No se requieren cambios de red para tener acceso al contenedor de Data Landing Zone, lo que significa que no es necesario configurar listas de permitidos ni configuraciones entre regiones para la red. Experience Platform exige una caducidad estricta de siete días para todos los archivos y carpetas cargados en un contenedor de Data Landing Zone. Todos los archivos y carpetas se eliminan pasados siete días.

Restricciones de nomenclatura para archivos y directorios

A continuación se muestra una lista de restricciones que debe tener en cuenta al nombrar los archivos o directorios de almacenamiento en la nube.

Administrar el contenido de la zona de aterrizaje de datos manage-the-contents-of-your-data-landing-zone

Puede usar Azure Storage Explorer para administrar el contenido de su contenedor de Data Landing Zone.

En la interfaz de usuario de Azure Storage Explorer, seleccione el icono de conexión en el panel de navegación izquierdo. Aparecerá la ventana Seleccionar recurso, que le proporcionará las opciones para conectarse a. Seleccione Blob container para conectarse a Data Landing Zone.

A continuación, seleccione URL de firma de acceso compartido (SAS) como método de conexión y, a continuación, seleccione Siguiente.

Después de seleccionar el método de conexión, debe proporcionar nombre para mostrar y la URL de SAS de contenedor Blob que corresponda a su contenedor Data Landing Zone.

Proporcione su URL SAS Data Landing Zone y seleccione Siguiente

Aparece la ventana Resumen, que le proporciona una descripción general de la configuración, incluida información sobre el extremo y los permisos de Blob. Cuando esté listo, seleccione Conectar.

Una conexión correcta actualiza la interfaz de usuario de Azure Storage Explorer con el contenedor de Data Landing Zone.

Con el contenedor Data Landing Zone conectado a Azure Storage Explorer, ahora puede empezar a cargar archivos en el contenedor Data Landing Zone. Para cargar, selecciona Cargar y luego selecciona Cargar archivos.

Una vez que haya seleccionado el archivo que desea cargar, debe identificar el tipo de Blob con el que desea cargarlo y el directorio de destino deseado. Cuando termine, seleccione Cargar.

Cargar archivos en su Data Landing Zone mediante la interfaz de línea de comandos

También puede usar la interfaz de línea de comandos de su dispositivo y acceder a cargar archivos en su Data Landing Zone.

Carga de un archivo mediante Bash

El siguiente ejemplo usa Bash y cURL para cargar un archivo en un Data Landing Zone con la API REST Azure Blob Storage:

# 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}"

Carga de un archivo mediante Python

El siguiente ejemplo usa Microsoft’s Python v12 SDK para cargar un archivo en un 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)

Cargar un archivo mediante AzCopy

El siguiente ejemplo utiliza la utilidad Microsoft’s AzCopy para cargar un archivo en un Data Landing Zone:

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

Conectar Data Landing Zone a Platform

La siguiente documentación proporciona información sobre cómo obtener datos del contenedor de Data Landing Zone a Adobe Experience Platform mediante API o la interfaz de usuario.

Uso de API

Uso de la IU