Data Landing Zone

IMPORTANT
Cette page est spécifique au connecteur Data Landing Zone source dans Experience Platform. Pour plus d'informations sur la connexion au connecteur Data Landing Zone destination, consultez la Data Landing Zone page de documentation de destination.

Data Landing Zone est une interface de stockage Azure Blob 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 à un conteneur Data Landing Zone par sandbox 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 d’Experience Platform sont configurés avec un conteneur Data Landing Zone par environnement de test. Vous pouvez lire et écrire des fichiers dans votre conteneur via 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 des mécanismes de sécurité du stockage Azure Blob standard au repos et en transit. L’authentification SAS vous permet d’accéder en toute sécurité à votre conteneur Data Landing Zone via une connexion Internet publique. Aucune modification réseau n’est requise pour accéder à votre conteneur 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. Experience Platform applique un délai d’expiration de sept jours strict pour tous les fichiers et dossiers chargés dans un conteneur Data Landing Zone. Tous les fichiers et dossiers sont supprimés au bout de sept jours.

NOTE
Si vous souhaitez accéder à Data Landing Zone à partir de Azure Data Factory, vous devez créer un service lié pour Data Landing Zone à l'aide des informations d'identification SAS fournies par l'Experience Platform. Une fois que vous avez créé votre service lié, vous pouvez explorer votre Data Landing Zone en sélectionnant le chemin du conteneur au lieu du chemin racine par défaut.

Contraintes de dénomination pour 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 (/). Elle sera le cas échéant automatiquement supprimée.
  • Les caractères d’URL réservés suivants doivent être des caractères d’échappement : ! ' ( ) ; @ & = + $ , % # [ ]
  • Les caractères suivants ne sont pas autorisés : " \ / : | < > * ?.
  • Caractères de chemin d’URL illégaux interdits. Les points de code tels que \uE000, bien que 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 à 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$, point (.) et deux points (…).

Gestion du contenu de votre zone d’entrée des données manage-the-contents-of-your-data-landing-zone

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

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

Sélection de ressource

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

Sélection d’une méthode de connexion

Après avoir sélectionné votre méthode de connexion, vous devez ensuite fournir un nom d’affichage et l’ Blobconteneur SAS URL correspondant à votre conteneur Data Landing Zone.

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

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

Saisie des informations de connexion

La fenêtre Résumé s’affiche, vous donnant ainsi une présentation de vos paramètres, y compris des informations sur votre point d’entrée et vos autorisations Blob. Quand vous avez terminé, sélectionnez Se connecter.

Résumé

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

Conteneur utilisateur DLZ

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

upload

Une fois que vous avez sélectionné le fichier que vous souhaitez charger, vous devez identifier le type Blob dans lequel vous souhaitez le charger et le répertoire de destination souhaité. Lorsque vous avez terminé, sélectionnez Télécharger.

Blob types
Description
Bloc Blob
Le bloc Blobs est optimisé pour le chargement de grandes quantités de données de manière efficace. Le bloc Blobs est l'option par défaut pour Data Landing Zone.
Ajouter Blob
Les Blobs ajoutés sont optimisés pour ajouter des données à la fin du fichier.

upload-files

Chargez des fichiers sur votre Data Landing Zone à l’aide de l’interface de ligne de commande

Vous pouvez également utiliser l’interface de ligne de commande de votre appareil et accéder aux fichiers de chargement 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 l’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}"

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

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

TIP
Bien que l’exemple ci-dessous utilise l’URI SAS complet pour se connecter à un conteneur Azure Blob, vous pouvez utiliser d’autres méthodes et opérations pour vous authentifier. Pour plus d’informations, consultez ce Microsoft document sur le SDK Python v12 .
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)

Télécharger un fichier à l’aide de AzCopy

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

TIP
Bien que l'exemple ci-dessous utilise la commande copy, vous pouvez utiliser d'autres commandes et options pour télécharger un fichier vers votre Data Landing Zone, à l'aide de AzCopy. Pour plus d’informations, consultez ce Microsoft AzCopy document .
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

Connectez Data Landing Zone à Platform

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

Utiliser les API

Utiliser l’interface utilisateur

IMPORTANT
Les liens privés ne sont actuellement pas pris en charge lors de la connexion à Experience Platform à l’aide de Data Landing Zone. Les seules méthodes prises en charge pour l’accès sont les méthodes répertoriées ici.
recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089