Data Landing Zone

Data Landing Zone est un Azure Blob Interface de stockage configurée par Adobe Experience Platform, qui vous permet d’accéder à une fonctionnalité de stockage de fichiers sécurisée basée sur le cloud pour importer des fichiers dans Platform. Vous avez accès à une Data Landing Zone conteneur par environnement de test et le volume total de données sur tous les conteneurs est limité au total des données fournies avec votre licence Produits et Services Platform. Tous les clients de Platform et ses services d’application tels que Customer Journey Analytics, Journey Orchestration, Intelligent Services, et Real-time Customer Data Platform sont configurés avec un Data Landing Zone conteneur par environnement de test. Vous pouvez lire et écrire des fichiers dans votre conteneur par le biais de Azure Storage Explorer ou votre interface de ligne de commande.

Data Landing Zone prend en charge l’authentification SAS et ses données sont protégées par la norme Azure Blob des mécanismes de sécurité du stockage au repos et en transit. L’authentification SAS vous permet d’accéder en toute sécurité à votre Data Landing Zone Conteneur via une connexion Internet publique. Aucune modification réseau n’est requise pour accéder à votre Data Landing Zone , ce qui signifie que vous n’avez pas besoin de configurer de listes autorisées ou de configurations inter-régions pour votre réseau. Platform applique une durée de vie stricte de sept jours sur tous les fichiers chargés dans un Data Landing Zone conteneur. Tous les fichiers sont supprimés au bout de sept jours.

Contraintes de dénomination pour les fichiers et répertoires

Vous trouverez ci-dessous une liste des contraintes dont vous devez tenir compte lorsque vous nommez vos fichiers ou répertoires de stockage dans le cloud.

  • Les noms des composants de répertoire et de fichier ne doivent pas dépasser 255 caractères.
  • Les noms de répertoire et de fichier ne peuvent pas se terminer par une barre oblique (/). S’il est fourni, il sera automatiquement supprimé.
  • Les caractères d’URL réservés suivants doivent être correctement précédés d’une séquence d’échappement : ! ' ( ) ; @ & = + $ , % # [ ]
  • Les caractères suivants ne sont pas autorisés : " \ / : | < > * ?.
  • Caractères de chemin d’URL interdits. Points de code comme \uE000, s’ils sont valides dans les noms de fichier NTFS, ne sont pas des caractères Unicode valides. En outre, certains caractères ASCII ou Unicode, tels que les caractères de contrôle (tels que 0x00 to 0x1F, \u0081, etc.), ne sont pas non plus autorisés. Pour les règles régissant les chaînes Unicode en HTTP/1.1, voir RFC 2616, section 2.2 : Règles de base et RFC 3987.
  • Les noms de fichier suivants ne sont pas autorisés : LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, PRN, AUX, NUL, CON, CLOCK$, caractère point (…) et deux caractères de point (.).

Gérez le contenu de vos Data Landing Zone

Vous pouvez utiliser Azure Storage Explorer pour gérer le contenu de votre Data Landing Zone conteneur.

Dans le Azure Storage Explorer Dans l’interface utilisateur, sélectionnez l’icône de connexion dans le volet de navigation de gauche. Le Sélectionner la ressource s’affiche, vous permettant d’accéder à des options de connexion. Sélectionner Blob container pour se connecter à Data Landing Zone.

select-resource

Ensuite, sélectionnez URL de signature d’accès partagé (SAS) comme méthode de connexion, puis sélectionnez Suivant.

select-connection-method

Après avoir sélectionné votre méthode de connexion, vous devez ensuite fournir un nom d'affichage et le Blobcontainer SAS URL qui correspond à votre Data Landing Zone conteneur.

CONSEIL

Vous pouvez récupérer votre Data Landing Zone informations d’identification provenant du catalogue des sources dans l’interface utilisateur de Platform.

Fournissez les Data Landing Zone URL SAS , puis sélectionnez Suivant

enter-connection-info

Le Résumé s’affiche, vous donnant ainsi une vue d’ensemble de vos paramètres, y compris des informations sur vos Blob point de terminaison et autorisations. Une fois prêt, sélectionnez Connexion.

summary

Une connexion réussie met à jour votre Azure Storage Explorer l’interface utilisateur de Data Landing Zone conteneur.

dlz-user-container

Avec votre Data Landing Zone conteneur connecté à Azure Storage Explorer, vous pouvez maintenant commencer à charger des fichiers dans votre Data Landing Zone conteneur. Pour charger, sélectionnez Télécharger puis sélectionnez Chargement de fichiers.

charger

Une fois que vous avez sélectionné le fichier à charger, vous devez alors identifier la variable Blob saisissez pour le charger en tant que et dans le répertoire de destination de votre choix. Lorsque vous avez terminé, sélectionnez Télécharger.

Blob types Description
Bloc Blob Bloc Blobs sont optimisés pour le transfert efficace de grandes quantités de données. Bloc Blobs sont l’option par défaut pour Data Landing Zone.
Ajouter Blob Ajouter Blobs sont optimisés pour ajouter des données à la fin du fichier.

upload-files

Chargement de fichiers dans Data Landing Zone utilisation de l’interface de ligne de commande

Vous pouvez également utiliser l’interface de ligne de commande de votre périphérique et accéder aux fichiers de transfert vers votre Data Landing Zone.

Chargement d’un fichier à l’aide de Bash

L’exemple suivant utilise Bash et cURL pour charger un fichier vers un Data Landing Zone avec le Azure Blob Storage API 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}"

Téléchargement d’un fichier à l’aide de Python

L’exemple suivant utilise Microsoft’s SDK Python v12 pour charger un fichier dans une Data Landing Zone:

CONSEIL

Bien que l’exemple ci-dessous utilise l’URI SAS complet pour se connecter à un Azure Blob conteneur, vous pouvez utiliser d’autres méthodes et opérations pour vous authentifier. Voir Microsoft document sur le SDK Python v12 pour plus d’informations.

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)

Chargement d’un fichier à l’aide de AzCopy

L’exemple suivant utilise Microsoft’s AzCopy pour télécharger un fichier vers un Data Landing Zone:

CONSEIL

Bien que l’exemple ci-dessous utilise la variable copy , vous pouvez utiliser d’autres commandes et options pour charger un fichier dans votre Data Landing Zone, à l’aide de AzCopy. Voir Microsoft AzCopy document pour plus d’informations.

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

Connexion Data Landing Zone to Platform

La documentation ci-dessous fournit des informations sur la manière d’importer des données de votre Data Landing Zone conteneur vers Adobe Experience Platform à l’aide des API ou de l’interface utilisateur.

Utilisation des API

Utiliser l’interface utilisateur

Sur cette page