Data Landing Zone

IMPORTANT
Esta página es específica de Data Landing Zone origen conector en el Experience Platform. Para obtener información sobre la conexión a Data Landing Zone destino conector, consulte el Data Landing Zone página de documentación de destino.

Data Landing Zone es un Azure Blob interfaz de almacenamiento 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 uno Data Landing Zone contenedor por zona protegida 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 aplicaciones, como Customer Journey Analytics, Journey Orchestration, Intelligent Services, y Adobe Real-Time Customer Data Platform se han aprovisionado con uno Data Landing Zone contenedor por zona protegida. Puede leer y escribir archivos en su contenedor mediante 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 de 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 es necesario configurar listas de permitidos ni configuraciones entre regiones para la red. Platform aplica un estricto plazo de caducidad de siete días a todos los archivos cargados en una Data Landing Zone contenedor. Todos los archivos se eliminan a los 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 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 eliminará automáticamente.
  • Los siguientes caracteres de URL reservadas deben evitarse correctamente: ! ' ( ) ; @ & = + $ , % # [ ]
  • No se permiten los siguientes caracteres: " \ / : | < > * ?.
  • No se permiten caracteres de ruta de URL no válidos. Puntos de código como \uE000, aunque son válidos en los nombres de archivo NTFS, no son caracteres Unicode válidos. Además, algunos caracteres ASCII o Unicode, como los caracteres de control (como 0x00 hasta 0x1F, \u0081, etc.), tampoco se permiten. Para ver 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$, carácter de punto (.) y dos caracteres de punto (…).

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

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

En el Azure Storage Explorer IU, seleccione el icono de conexión en el panel de navegación izquierdo. El Seleccionar medio aparece una ventana de, que le proporciona opciones para conectarse a. Seleccionar 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 un nombre para mostrar y el BlobURL de SAS de contenedor que se corresponde con su Data Landing Zone contenedor.

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

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

enter-connection-info

El Resumen aparece una ventana que le proporciona información general sobre su configuración, incluida la información sobre su Blob punto de conexión y permisos. Cuando esté listo, seleccione Connect.

resumen

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

dlz-user-container

Con su 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 luego seleccione Cargar archivos.

cargar

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

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

upload-files

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

También puede utilizar 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 utiliza Bash y cURL para cargar un archivo en una Data Landing Zone con el 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}"

Carga de un archivo mediante Python

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

TIP
Mientras que el ejemplo siguiente utiliza el URI SAS completo para conectarse a un Azure Blob contenedor, puede utilizar otros métodos y operaciones para autenticarse. Ver esto 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 una Data Landing Zone:

TIP
Mientras que el ejemplo siguiente utiliza el copy , puede utilizar otros comandos y opciones para cargar un archivo en su Data Landing Zone, usando AzCopy. Ver esto 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 hasta Platform

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

Uso de API

Uso de la IU

IMPORTANT
Actualmente no se admiten vínculos privados al conectarse al Experience Platform mediante Data Landing Zone. Los únicos métodos admitidos para el acceso son los métodos enumerados aquí.
recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089