Partager via


Tutoriel : effectuer l’ingestion de l’analyseur CSV

L’ingestion d’analyseurs de valeurs séparées par des virgules (CSV) permet d’ingérer des fichiers CSV dans une instance Azure Data Manager for Energy.

Dans ce tutoriel, vous allez apprendre à :

  • Ingérez un exemple de fichier CSV de données de puits de forage dans une instance Azure Data Manager for Energy à l’aide de Postman.
  • Recherchez les enregistrements de métadonnées de stockage créés pendant l’ingestion de CSV à l’aide de Postman.

Prérequis

Avant de commencer ce tutoriel, veuillez remplir les conditions préalables suivantes.

Obtenir les détails de l’instance Azure Data Manager for Energy

  • Vous avez besoin d’une instance Azure Data Manager for Energy. Si vous n’en avez pas encore, créez-en une en suivant les étapes décrites dans Démarrage rapide : créer une instance Azure Data Manager for Energy.

  • Pour ce tutoriel, vous avez besoin des paramètres suivants :

    Paramètre Valeur à utiliser Exemple Où trouver cette valeur
    CLIENT_ID ID d’application (client) 00001111-aaaa-2222-bbbb-3333cccc4444 Vous utilisez cet ID d’application ou client lors de l’inscription de l’application à la plateforme d’identité Microsoft. Consultez Inscrire une application.
    CLIENT_SECRET Clés secrètes client _fl****************** Parfois appelée mot de passe d’application, la clé secrète client est une valeur de chaîne que votre application peut utiliser à la place d’un certificat pour s’identifier elle-même. Consultez Ajouter un secret client.
    TENANT_ID ID de l’annuaire (locataire) 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx Survoler le nom de votre compte avec la souris dans le portail Azure pour obtenir l’ID de répertoire ou de locataire. Vous pouvez également rechercher et sélectionner Microsoft Entra ID>Propriétés>ID de locataire dans le portail Azure.
    SCOPE ID d’application (client) 00001111-aaaa-2222-bbbb-3333cccc4444 Cette valeur est identique à l’ID de l’application ou client mentionné plus haut.
    refresh_token Valeur du jeton d’actualisation 0.ATcA01-XWHdJ0ES-qDevC6r........... Suivez Comment générer un jeton d’authentification pour créer un jeton d’actualisation et l’enregistrer. Vous aurez besoin de ce jeton d’actualisation ultérieurement pour générer un jeton utilisateur.
    DNS URI <instance>.energy.Azure.com Cette valeur se trouve sur la page de présentation de l’instance Azure Data Manager for Energy.
    data-partition-id Partitions de données <instance>-<data-partition-name> Cette valeur se trouve sur la page de présentation de l’instance Azure Data Manager for Energy.

Suivez le guide Gérer les utilisateurs pour ajouter les droits appropriés à l’utilisateur qui exécute ce tutoriel.

Configurer Postman et exécuter des requêtes

  1. Téléchargez et installez l’application bureau Postman.

  2. Importez les fichiers suivants dans Postman :

    Pour importer la collection Postman et les variables d’environnement, suivez les étapes décrites dans Importation de données dans Postman.

  3. Mettez à jour CURRENT VALUE pour l’environnement Postman avec les informations que vous avez obtenues dans les détails de l’instance Azure Data Manager for Energy.

  4. La collection Postman pour l’ingestion de l’analyseur CSV contient 10 requêtes que vous devez exécuter séquentiellement.

    Veillez à choisir Environnement de flux de travail d’ingestion avant de déclencher la collection Postman.

    Screenshot of the Postman environment.

  5. Déclenchez chaque requête en sélectionnant le bouton Envoyer.

    À chaque requête, Postman valide le code de réponse réel de l’API par rapport au code de réponse attendu. En cas d’incompatibilité, la section de test indique les échecs.

Voici un exemple de requête Postman réussie :

Screenshot of a successful Postman call.

Voici un exemple de requête Postman ayant échoué :

Screenshot of a failed Postman call.

Ingérez les données de puits de forage à l’aide de Postman

Pour ingérer un exemple de fichier CSV de données de puits de forage dans l’instance Azure Data Manager for Energy à l’aide de la collection Postman, suivez les étapes suivantes :

  1. Obtenir un jeton d’accès utilisateur : générez le jeton utilisateur, qui sera utilisé pour authentifier d’autres appels d’API.

  2. Créer un schéma : générez un schéma qui est conforme aux colonnes présentes dans le fichier CSV.

  3. Obtenir les détails du schéma : obtenez le schéma créé à l’étape précédente et validez-le.

  4. Créer une balise juridique : créez une balise juridique qui sera ajoutée aux données CSV à des fins de conformité des données.

  5. Obtenir une URL signée pour charger un fichier CSV : obtenez le chemin d’accès à l’URL signée vers laquelle le fichier CSV sera chargé.

  6. Charger un fichier CSV : téléchargez l’exemple Wellbore.csv sur votre ordinateur local, puis sélectionnez ce fichier dans Postman en cliquant sur le bouton Sélectionner un fichier.

    Screenshot of uploading a CSV file.

  7. Charger les métadonnées du fichier CSV: chargez les informations relatives aux métadonnées du fichier, telles que l’emplacement du fichier et d’autres champs pertinents.

  8. Créer un flux de travail d’ingestion d’analyseur CSV : créez le graphe orienté acyclique (DAG) pour le flux de travail d’ingestion de l’analyseur CSV.

  9. Déclencher un flux de travail d’ingestion d’analyseur CSV : déclenchez le DAG pour le flux de travail d’ingestion de l’analyseur CSV.

  10. Rechercher l’état du flux de travail d’ingestion de l’analyseur CSV : obtenez l’état de l’exécution du DAG de l’analyseur CSV.

Recherchez les données de puits de forage ingérées à l’aide de Postman

Pour rechercher les enregistrements de métadonnées de stockage créés pendant l’ingestion CSV à l’aide de la collection Postman, effectuez l’étape suivante :

  • Rechercher les enregistrements CSV ingérés : recherchez les enregistrements CSV créés précédemment.

    Screenshot of searching ingested CSV records.

Étape suivante

Passez au tutoriel suivant :