Configurer une destination de rapport pour une requête Data Warehouse

Plusieurs options de configuration sont disponibles lors de la création d’une requête Data Warehouse. Les informations suivantes expliquent comment configurer une destination de rapport pour la requête.

Pour plus d’informations sur la façon de commencer à créer une requête, ainsi que des liens vers d’autres options de configuration importantes, voir Créer une requête Data Warehouse.

NOTE
Tenez compte de ce qui suit lors de la configuration du rapport de destination :
  • Nous vous recommandons d’utiliser un compte cloud ou un e-mail pour votre destination de rapport. Les comptes FTP et SFTP hérités sont disponibles, mais ne sont pas recommandés.

  • Tous les comptes cloud que vous avez configurés précédemment sont disponibles pour Data Warehouse. Vous pouvez configurer des comptes cloud de l’une des manières suivantes :

  • Les comptes cloud sont associés à votre compte d’utilisateur ou d’utilisatrice Adobe Analytics. Les autres utilisateurs et utilisatrices ne peuvent pas utiliser ni afficher les comptes cloud que vous configurez.

  • Vous pouvez modifier les emplacements que vous créez à partir du gestionnaire d’emplacements dans Composants > Emplacements.

Pour configurer la destination vers laquelle les rapports de Data Warehouse sont envoyés :

  1. Si vous ne l’avez pas déjà fait, commencez à créer une requête dans Adobe Analytics en sélectionnant Outils  > Data Warehouse  > Ajouter.

    Pour plus d’informations, voir Créer une requête Data Warehouse.

  2. Sur la page Nouvelle requête de Data Warehouse, sélectionnez l’onglet Destination du rapport.

    Onglet de destination du rapport

  3. (Le cas échéant) Si un compte cloud (et une destination sur ce compte) a déjà été configuré dans Adobe Analytics, vous pouvez l’utiliser comme destination de votre rapport :

    note note
    NOTE
    Vous ne pouvez accéder aux comptes que si vous les avez configurés ou s’ils ont été partagés avec une organisation dont vous faites partie.
    Si vous êtes administrateur ou administratrice système, l’option Afficher toutes les destinations est disponible. Activez cette option si vous souhaitez avoir accès à tous les comptes et emplacements créés par un utilisateur ou une utilisatrice de l’entreprise.
    1. Sélectionnez le compte dans le menu déroulant Sélectionner un compte.

      Les comptes cloud que vous avez configurés dans l’une des zones suivantes d’Adobe Analytics sont disponibles :

    2. Sélectionnez la destination associée au compte à partir du menu déroulant Sélectionner la destination.

  4. (Le cas échéant) Si vous n’avez pas accès à un compte cloud déjà configuré dans Adobe Analytics, vous pouvez en configurer un :

    1. Sélectionnez Ajouter un compte, puis spécifiez les informations suivantes :

      table 0-row-2 1-row-2 2-row-2 3-row-2
      Champ Fonction
      Type de compte

      Sélectionnez le type de compte cloud. Nous vous recommandons de disposer d’un compte unique pour chaque type de compte, avec plusieurs emplacements selon les besoins dans ce compte.

      Après avoir choisi un type de compte, des champs spécifiques à ce type de compte s’affichent.

      Nom du compte Spécifiez le nom du compte. Ce nom apparaît lors de la création d’un emplacement.
      Description du compte Fournissez une brève description du compte pour le différencier des autres comptes du même type de compte.

      Pour obtenir des instructions sur la configuration, développez la section ci-dessous qui correspond au type de compte que vous avez sélectionné.

      Utilisez l’un des types de compte suivants lors de la configuration d’une destination de rapport. Pour obtenir des instructions sur la configuration, développez le type de compte. (Des destinations héritées supplémentaires sont également disponibles, mais ne sont pas recommandées.)

      accordion
      Amazon S3

      Pour configurer un compte ARN de rôle Amazon S3, spécifiez les informations suivantes :

      table 0-row-2 1-row-2 2-row-2 layout-auto
      Champ Fonction
      ARN de rôle

      Vous devez fournir un ARN de rôle (nom de ressource Amazon) qu’Adobe peut utiliser pour accéder au compte Amazon S3. Pour ce faire, vous créez une politique d’autorisation IAM pour le compte source, vous la joignez à un utilisateur ou à une utilisatrice, puis vous créez un rôle pour le compte de destination. Pour plus d’informations, consultez cette documentation AWS.

      Pour plus d’informations sur la configuration de l’autorisation du compartiment, consultez l’article Comment fournir un accès entre comptes aux objets stockés dans des compartiments Amazon S3 ? dans le centre de connaissances Amazon.

      ARN d’utilisateur ou d’utilisatrice L’ARN d’utilisateur ou d’utilisatrice (nom de ressource Amazon) est fourni par Adobe. Vous devez associer cet utilisateur ou cette utilisatrice à la politique que vous avez créée.
      accordion
      Google Cloud Platform

      Pour configurer un compte Google Cloud Platform, spécifiez les informations suivantes :

      table 0-row-2 1-row-2 layout-auto
      Champ Fonction
      Identifiant du projet ID de projet Google Cloud. Consultez la documentation de Google Cloud sur l’obtention d’un ID de projet.
      accordion
      Azure SAS

      Pour configurer un compte Azure SAS, spécifiez les informations suivantes :

      table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto
      Champ Fonction
      ID de l’application Copiez cet ID à partir de l’application Azure que vous avez créée. Dans Microsoft Azure, ces informations sont situées sur la page Vue d’ensemble dans votre application. Pour plus d’informations, voir Documentation de Microsoft Azure sur l’enregistreement d’une application avec la plateforme d’identité Microsoft.
      ID de cliente ou client Copiez cet ID à partir de l’application Azure que vous avez créée. Dans Microsoft Azure, ces informations sont situées sur la page Vue d’ensemble dans votre application. Pour plus d’informations, consultez la documentation Microsoft Azure sur la façon d’enregistrer une application avec la plateforme d’identité Microsoft.
      URI du coffre de clés

      Chemin d’accès à l’URI SAS dans Azure Key Vault. Pour configurer une signature d’accès partagé Azure (SAS), vous devez stocker un URI SAS en tant que secret à l’aide d’Azure Key Vault. Pour plus d’informations, consultez la documentation de Microsoft Azure sur la définition et la récupération d’un secret à partir d’Azure Key Vault.

      Une fois l’URI de coffre de clés créé :

      • Ajoutez une politique d’accès sur Key Vault afin d’accorder l’autorisation à l’application Azure que vous avez créée.

      • Assurez-vous que l’ID de l’application a bien reçu le rôle intégré Key Vault Certificate User afin d’accéder à l’URI de coffre de clés.

        Pour plus d’informations, voir Rôles intégrés Azure.

      Pour plus d’informations, voir Documentation de Microsoft Azure sur l’affectation d’une politique d’accès Key Vault.

      Nom secret du coffre de clés Le nom du secret que vous avez créé lors de l’ajout du secret à Azure Key Vault. Dans Microsoft Azure, ces informations se trouvent dans le coffre Key Vault que vous avez créé, sur la page de paramètres de Key Vault. Pour plus d’informations, voir Documentation de Microsoft Azure sur la définition et la récupération d’un secret à partir d’Azure Key Vault.
      Secret Copiez le secret depuis l’application Azure que vous avez créée. Dans Microsoft Azure, ces informations sont situées sur l’onglet Certificats et secrets dans votre application. Pour plus d’informations, voir Documentation de Microsoft Azure sur l’enregistrement d’une application avec la plateforme d’identité Microsoft.
      accordion
      Azure RBAC

      Pour configurer un compte Azure RBAC, spécifiez les informations suivantes :

      table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto
      Champ Fonction
      ID de l’application Copiez cet ID à partir de l’application Azure que vous avez créée. Dans Microsoft Azure, ces informations sont situées sur la page Vue d’ensemble dans votre application. Pour plus d’informations, voir Documentation de Microsoft Azure sur l’enregistreement d’une application avec la plateforme d’identité Microsoft.
      ID de cliente ou client Copiez cet ID à partir de l’application Azure que vous avez créée. Dans Microsoft Azure, ces informations sont situées sur la page Vue d’ensemble dans votre application. Pour plus d’informations, voir Documentation de Microsoft Azure sur l’enregistrement d’une application avec la plateforme d’identité Microsoft.
      Secret Copiez le secret depuis l’application Azure que vous avez créée. Dans Microsoft Azure, ces informations sont situées sur l’onglet Certificats et secrets dans votre application. Pour plus d’informations, voir Documentation de Microsoft Azure sur l’enregistrement d’une application avec la plateforme d’identité Microsoft.
      accordion
      E-mail

      Pour configurer un compte de messagerie, spécifiez les informations suivantes :

      table 0-row-2 1-row-2
      Champ Fonction
      Personnes destinataires Des notifications par e-mail peuvent être envoyées à des personnes spécifiques lorsque le rapport est envoyé. Spécifiez une seule adresse e-mail ou une liste d’adresses e-mail séparées par des virgules.
    2. Sélectionnez Ajouter un emplacement, puis spécifiez les informations suivantes :
      |Champ | Fonction |
      |---------|----------|
      | Nom | Nom de l’emplacement. |
      | Description | Fournissez une brève description du compte pour le différencier des autres comptes du même type de compte. |
      | Compte d’emplacement | Sélectionnez le compte d’emplacement que vous avez créé dans Ajouter un compte. |

    3. Dans la section Propriétés d’emplacement, indiquez les informations spécifiques au type de votre compte d’emplacement.

      Pour obtenir des instructions sur la configuration, développez la section ci-dessous qui correspond au type de compte que vous avez sélectionné précédemment.

      accordion
      Amazon S3

      Pour configurer un emplacement Amazon S3, spécifiez les informations suivantes :

      table 0-row-2 1-row-2 2-row-2 layout-auto
      Champ Fonction
      Nom du compartiment

      Compartiment de votre compte Amazon S3 dans lequel vous souhaitez que les données Adobe Analytics soient envoyées.

      Assurez-vous que l’ARN d’utilisateur ou d’utilisatrice fourni par Adobe dispose de l’autorisation S3:PutObject pour charger des fichiers vers ce compartiment. Cette autorisation permet à l’ARN d’utilisateur ou d’utilisatrice de charger les fichiers initiaux et de remplacer les fichiers pour les chargements suivants.

      Les noms des compartiments doivent respecter des règles de nommage spécifiques. Par exemple, ils doivent avoir une longueur comprise entre 3 et 63 caractères, ne peuvent être composés que de lettres minuscules, de chiffres, de points (.) et de traits d’union (-), et doivent commencer et se terminer par une lettre ou un chiffre. Une liste complète des règles de nommage est disponible dans la documentation AWS.

      Préfixe clé Dossier dans le compartiment où vous souhaitez placer les données. Indiquez un nom de dossier, puis ajoutez une barre oblique inverse après le nom pour créer le dossier. Par exemple, folder_name/
      accordion
      Google Cloud Platform

      Pour configurer un emplacement Google Cloud Platform, spécifiez les informations suivantes :

      table 0-row-2 1-row-2 2-row-2 layout-auto
      Champ Fonction
      Nom du compartiment

      Compartiment de votre compte GCP où vous souhaitez que les données Adobe Analytics soient envoyées.

      Assurez-vous que vous avez accordé l’une des autorisations suivantes au compte principal fourni par Adobe : (pour plus d’informations sur l’octroi des autorisations, voir Ajouter un compte principal à une politique au niveau du compartiment dans la documentation de Google Cloud.)

      • roles/storage.objectCreator : utilisez cette autorisation si vous souhaitez limiter le principal uniquement à la création de fichiers dans votre compte GCP.
        Important : si vous utilisez cette autorisation avec les rapports planifiés, vous devez utiliser un nom de fichier unique pour chaque nouvel export planifié. Sinon, la génération du rapport échouera, car le principal n’a pas accès pour remplacer les fichiers existants.
      • roles/storage.objectUser : utilisez cette autorisation si vous souhaitez que le principal ait accès à l’affichage, à la liste, à la mise à jour et à la suppression des fichiers dans votre compte GCP.
        Cette autorisation permet au principal d’écraser les fichiers existants pour les chargements ultérieurs, sans avoir à générer automatiquement des noms de fichier uniques pour chaque nouvel export planifié.

      Si votre entreprise utilise des Contraintes applicables aux politiques des organisations pour n’autoriser que le compte Google Cloud Platform dans votre liste autorisée, vous avez besoin de cet identifiant d’organisation Google Cloud Platform détenu par Adobe :

      • DISPLAY_NAME : adobe.com
      • ID : 178012854243
      • DIRECTORY_CUSTOMER_ID : C02jo8puj
      Préfixe clé Dossier dans le compartiment où vous souhaitez placer les données. Indiquez un nom de dossier, puis ajoutez une barre oblique inverse après le nom pour créer le dossier. Par exemple, folder_name/
      accordion
      Azure SAS

      Pour configurer un emplacement Azure SAS, spécifiez les informations suivantes :

      table 0-row-2 1-row-2 2-row-2 layout-auto
      Champ Fonction
      Nom du conteneur Conteneur dans le compte que vous avez spécifié où vous souhaitez que les données Adobe Analytics soient envoyées.
      Préfixe de clé

      Dossier du conteneur dans lequel vous souhaitez placer les données. Indiquez un nom de dossier, puis ajoutez une barre oblique inverse après le nom pour créer le dossier. Par exemple, folder_name/

      Assurez-vous que le magasin d’URI SAS que vous avez spécifié dans le champ Nom du secret Key Vault lors de la configuration du compte Azure SAS dispose de l’autorisation Write. Cela permet à l’URI SAS de créer des fichiers dans votre conteneur Azure.

      Si vous souhaitez que l’URI SAS remplace également les fichiers, assurez-vous que le magasin d’URI SAS dispose de l’autorisation Delete.

      Pour plus d’informations, consultez Ressources de stockage Blob dans la documentation Azure Blob Storage.

      accordion
      Azure RBAC

      Pour configurer un emplacement Azure RBAC, spécifiez les informations suivantes :

      table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto
      Champ Fonction
      Nom du conteneur Conteneur dans le compte que vous avez spécifié où vous souhaitez que les données Adobe Analytics soient envoyées. Assurez-vous d’accorder les autorisations de chargement de fichiers vers l’application Azure que vous avez créée précédemment.
      Préfixe de clé

      Dossier du conteneur dans lequel vous souhaitez placer les données. Indiquez un nom de dossier, puis ajoutez une barre oblique inverse après le nom pour créer le dossier. Par exemple, folder_name/.

      Assurez-vous que l’ID d’application que vous avez spécifié lors de la configuration du compte Azure RBAC a reçu le rôle Storage Blob Data Contributor pour accéder au conteneur (dossier).

      Pour plus d’informations, consultez Rôles intégrés Azure.

      Nom du compte Compte de stockage Azure.
  5. Poursuivez la configuration de votre requête Data Warehouse sur l’onglet Options de rapport. Pour plus d’informations, voir Configurer des options de rapport pour une requête Data Warehouse.

Destinations héritées

IMPORTANT
Les destinations décrites dans cette section sont héritées et ne sont pas recommandées. Utilisez plutôt l’une des destinations suivantes lors de la création d’une destination d’entrepôt de données : Amazon S3, Google Cloud Platform, Azure RBAC, Azure SAS ou E-mail. Consultez les informations ci-dessus pour plus d’informations sur chacune de ces destinations recommandées.

Les informations suivantes fournissent des informations de configuration pour chacune des destinations héritées :

FTP

Les données d’entrepôt de données peuvent être distribuées vers un emplacement FTP hébergé par Adobe ou par le client ou la cliente. Nécessite un hôte FTP, un nom d’utilisateur et un mot de passe. Utilisez le champ Chemin d’accès pour placer les fichiers de flux dans un dossier. Les dossiers doivent déjà exister ; les fichiers lancent une erreur si le chemin d’accès précisé n’existe pas.

Renseignez les informations suivantes pour les champs disponibles :

Champs de compte

  • Nom du compte  : nom du compte FTP.

  • Description du compte  : description du compte FTP.

  • Nom d’hôte  : saisissez l’URL de destination FTP de votre choix. Par exemple : ftp.company.com.

    note note
    NOTE
    Ne pas inclure ftp:// au début de l’URL.
  • Nom d’utilisateur ou d’utilisatrice  : saisissez le nom d’utilisateur ou d’utilisatrice pour vous connecter au site FTP.

  • Mot de passe et confirmation du mot de passe  : saisissez le mot de passe pour vous connecter au site FTP.

Champs d’emplacement

  • Nom de l’emplacement  : nom de l’emplacement sur le compte FTP où vous souhaitez envoyer les fichiers.

  • Description de l’emplacement  : description de l’emplacement sur le compte FTP.

  • Chemin du répertoire  : chemin d’accès à l’emplacement sur le compte FTP.

SFTP

La prise en charge SFTP de l’entrepôt de données est disponible. Nécessite un hôte SFTP, un nom d’utilisateur ou d’utilisatrice et un site de destination contenant une clé publique RSA ou DSA. Vous pouvez télécharger la clé publique appropriée lors de la création de la destination de l’entrepôt de données.

Renseignez les informations suivantes pour les champs disponibles :

Champs de compte

  • Nom du compte  : nom du compte FTP.

  • Description du compte  : description du compte FTP.

  • Nom d’hôte  : saisissez l’URL de destination SFTP de votre choix. Par exemple : sftp.company.com.

    note note
    NOTE
    Ne pas inclure sftp:// au début de l’URL.
  • Nom d’utilisateur ou d’utilisatrice  : saisissez le nom d’utilisateur ou d’utilisatrice pour vous connecter au site SFTP.

  • Utiliser des extensions de fichier temporaires lors du chargement  : lorsque cette option est activée, l’extension de fichier .part est utilisée pendant le processus de chargement. Laissez cette option activée, sauf si votre serveur SFTP empêche la modification des noms de fichier une fois le chargement terminé.

  • Clés publiques  : téléchargez la clé publique appropriée lors de la création de la destination de l’entrepôt de données.

Champs d’emplacement

  • Nom de l’emplacement  : nom de l’emplacement sur le compte SFTP où vous souhaitez envoyer les fichiers.

  • Description de l’emplacement  : description de l’emplacement sur le compte SFTP.

  • Chemin du répertoire  : chemin d’accès à l’emplacement sur le compte SFTP.

Pour plus d’informations sur la configuration SFTP, voir Envoi de requêtes Data Warehouse aux serveurs SFTP.

S3

Vous pouvez envoyer des données d’entrepôt de données directement vers des compartiments Amazon S3. Ce type de destination requiert un nom de compartiment, un identifiant de clé d’accès et une clé secrète. Consultez les exigences de nommage pour des compartiments Amazon S3 dans les documents Amazon S3 pour plus d’informations.

L’utilisateur ou l’utilisatrice que vous désignez pour charger des données d’entrepôt de données doit disposer des autorisations suivantes :

  • s3:GetObject
  • s3:PutObject
  • s3:PutObjectAcl

Les 16 régions standard AWS suivantes sont prises en charge (en utilisant l’algorithme de signature approprié si nécessaire) :

  • us-east-2
  • us-east-1
  • us-west-1
  • us-west-2
  • ap-south-1
  • ap-northeast-2
  • ap-southeast-1
  • ap-southeast-2
  • ap-northeast-1
  • ca-central-1
  • eu-central-1
  • eu-west-1
  • eu-west-2
  • eu-west-3
  • eu-north-1
  • sa-east-1
NOTE
La région cn-north-1 n’est pas prise en charge.

Azure Blob

Les entrepôts de données prennent en charge les destinations Azure Blob. Nécessite un conteneur, un compte et une clé. Amazon chiffre automatiquement les données au repos. Les données que vous téléchargez sont automatiquement déchiffrées. Pour en savoir plus, consultez Création d’un compte Azure Storage dans la documentation Microsoft Azure.

NOTE
Vous devez mettre en œuvre votre propre processus pour gérer l’espace disque sur la destination d’entrepôt de données. Adobe ne supprime pas les données du serveur.
recommendation-more-help
6b7d49d5-f5fe-4b7f-91ae-5b0745755ed2