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)	3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx	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)	3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx	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 :

   • Collection Postman du flux de travail CSV
   • Environnement Postman du flux de travail CSV

   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.

   

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 :

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

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.

   

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.

  

Étape suivante

Passez au tutoriel suivant :

Tutoriel : effectuer une ingestion de fichiers basée sur un manifeste