Data Landing Zone

Data Landing Zone es un Azure Blob interfaz de almacenamiento de información aprovisionada por Adobe Experience Platform, lo que le permite acceder a un servicio de almacenamiento de archivos seguro y basado en la nube para introducir archivos en Platform. Tiene acceso a uno Data Landing Zone contenedores por entorno limitado, y el volumen total de datos en todos los contenedores se limita a los datos totales proporcionados con la licencia de productos y servicios de Platform. Todos los clientes de Platform y sus servicios de aplicación, como Customer Journey Analytics, Journey Orchestration, Intelligent Servicesy Real-time Customer Data Platform se aprovisionan con uno Data Landing Zone contenedor por simulador de pruebas. Puede leer y escribir archivos en el contenedor a través de Azure Storage Explorer o su interfaz de línea de comandos.

Data Landing Zone admite la autenticación basada en SAS y sus datos están protegidos con Azure Blob mecanismos de seguridad del almacenamiento en reposo y en tránsito. La autenticación basada en SAS le permite acceder de forma segura a su Data Landing Zone a través de una conexión pública a Internet. No se requieren cambios de red para acceder a su Data Landing Zone contenedor, lo que significa que no necesita configurar ninguna lista de permitidos o configuración entre regiones para su red. Platform exige un tiempo de vida estricto de siete días (TTL) en todos los archivos cargados en un Data Landing Zone contenedor. Todos los archivos se eliminan al cabo de 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.

  • Los nombres de los componentes de directorio y archivo no pueden superar los 255 caracteres.
  • Los nombres de directorio y archivo no pueden terminar con una barra diagonal (/). Si se proporciona, se elimina automáticamente.
  • Los siguientes caracteres de URL reservados deben tener un escape correcto: ! ' ( ) ; @ & = + $ , % # [ ]
  • No se permiten los siguientes caracteres: " \ / : | < > * ?.
  • No se permiten caracteres de ruta de URL no permitidos. Puntos de código como \uE000, aunque válido en nombres de archivo NTFS, no son caracteres Unicode válidos. Además, algunos caracteres ASCII o Unicode, como los caracteres de control (como 0x00 a 0x1F, \u0081, etc.), tampoco están permitidos. Para las reglas que rigen las cadenas Unicode en HTTP/1.1, consulte RFC 2616, sección 2.2: Reglas básicas y RFC 3987.
  • No se permiten los siguientes nombres de archivo: LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, PRN, AUX, NUL, CON, CLOCK$, caracteres de punto (.) y dos caracteres de punto (.).

Administre el contenido de su Data Landing Zone

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

En el Azure Storage Explorer En la interfaz de usuario, seleccione el icono de conexión en el panel de navegación izquierdo. La variable Seleccionar recurso , proporcionando las opciones a las que conectarse. Select Blob container para conectarse a Data Landing Zone.

select-resource

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

select-connection-method

Después de seleccionar el método de conexión, debe proporcionar una nombre para mostrar y BlobURL de contenedor SAS que corresponde a su Data Landing Zone contenedor.

SUGERENCIA

Puede recuperar su Data Landing Zone credenciales del catálogo de fuentes en la interfaz de usuario de Platform.

Proporcione su Data Landing Zone Dirección URL de SAS y, a continuación, seleccione Siguiente

enter-connection-info

La variable Resumen , que le proporciona una descripción general de la configuración, incluida información sobre Blob y permisos. Cuando esté listo, seleccione Connect.

resumen

Una conexión correcta actualiza su Azure Storage Explorer La interfaz de usuario de Data Landing Zone contenedor.

dlz-user-container

Con Data Landing Zone contenedor conectado a Azure Storage Explorer, ahora puede empezar a cargar archivos en su Data Landing Zone contenedor. Para cargar, seleccione Cargar y, a continuación, seleccione Cargar archivos.

cargar

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

Blob tipos Descripción
Bloque Blob Bloque Blobs están optimizados para cargar grandes cantidades de datos de forma eficaz. Bloque Blobs son la opción predeterminada para Data Landing Zone.
Anexar Blob Anexar Blobs están optimizados para anexar datos al final del archivo.

upload-files

Cargue archivos en su Data Landing Zone uso de la interfaz de la línea de comandos

También puede utilizar la interfaz de línea de comandos del dispositivo y acceder a los archivos de carga del Data Landing Zone.

Cargar un archivo mediante Bash

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

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

Cargar un archivo con Python

El siguiente ejemplo utiliza Microsoft’s SDK de Python v12 para cargar un archivo en un Data Landing Zone:

SUGERENCIA

Mientras que el ejemplo siguiente utiliza el URI SAS completo para conectarse a un Azure Blob , puede utilizar otros métodos y operaciones para autenticarse. Consulte esta Microsoft documento sobre el SDK de Python v12 para obtener más información.

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 Microsoft’s AzCopy utilidad para cargar un archivo en un Data Landing Zone:

SUGERENCIA

Mientras que el ejemplo siguiente está usando la variable copy puede utilizar otros comandos y opciones para cargar un archivo en su Data Landing Zone, usando AzCopy. Consulte esta Microsoft AzCopy documento para obtener más información.

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

Connect Data Landing Zone a Platform

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

Uso de API

Uso de la interfaz de usuario

En esta página