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.
- 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 ser de escape correcto:
! ' ( ) ; @ & = + $ , % # [ ]
- No se permiten los siguientes caracteres:
" \ / : | < > * ?
. - No se permiten caracteres de ruta de URL no válidos. Los puntos de código como
\uE000
, si bien 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 (como0x00
a0x1F
,\u0081
, etc.), tampoco están permitidos. Para las reglas que rigen las cadenas Unicode en HTTP/1.1, consulte RFC 2616, Section 2.2: Basic Rules 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 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:
copy
, puede usar otros comandos y opciones para cargar un archivo en su Data Landing Zone, usando AzCopy. Consulte este 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
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.