Tutoriel : Gérer les plannings d’analyses sismiques et télécharger les rapports

Ce tutoriel montre comment utiliser l’opération Seismic DDMS Analytics dans Azure Data Manager for Energy pour créer des plannings analytiques récurrents de vos données sismiques, lister et télécharger les rapports générés, et supprimer les plannings dont vous n’avez plus besoin. Les analyses planifiées vous aident à suivre la consommation de stockage et les schémas d’accès aux données entre sous-projets et locataires au fil du temps, afin de planifier la capacité et d’optimiser les coûts de stockage sans construire un pipeline de rapports personnalisé. Un travail en arrière-plan calcule les statistiques demandées à intervalles réguliers et écrit chaque rapport dans Stockage Blob Azure. Vous téléchargez les données du rapport directement depuis le stockage, et elles ne passent jamais par le service.

Dans ce tutoriel, vous allez apprendre à :

Prerequisites

Avant de commencer, vérifiez que vous remplissez les conditions préalables suivantes :

• Un abonnement Azure.
• Une ressource Azure Data Manager for Energy avec un DDMS sismique configuré.
• Un tenant et un subproject enregistrés dans le service Seismic DDMS.
• Le rôle subproject.admin, datamanager ou tenant.admin attribué à votre compte utilisateur, en fonction de l’étendue.
• Un token Bearer pour l’authentification API. Lorsque vous utilisez DefaultAzureCredential, demandez le https://energy.azure.com/.default scope. Découvrez comment générer un jeton d’authentification.
• Le data-partition-id de votre locataire. Une valeur manquante retourne 400 BAD_REQUEST.

Comprendre les étendues des analyses

Les travaux d’analyse s’exécutent selon l’une des deux étendues. Le périmètre détermine quels ensembles de données sont mesurés et quel rôle est requis.

Chaque planification stocke trois paramètres : le statistics pour calculer, le jour de la semaine pour la première exécution (first_execution), et la fréquence à laquelle elle se répète en jours (freq_execution). L’API utilise les points de terminaison /job pour les opérations de planification. Une tâche en arrière-plan lit les plannings et écrit des rapports dans le conteneur sdms-analytics-reports en utilisant la structure de chemin <subproject>/YYYY/MM/DD/.

Soumettre un programme analytique

Soumettez une PUT requête avec un tableau JSON contenant un seul objet de planification. Omettez name (ou envoyer une chaîne vide) pour créer une planification applicable à l’ensemble du locataire ; fournissez un sous-projet name pour définir la planification de ce sous-projet.

Le corps de la requête prend en charge les champs suivants :

1. Envoyez la demande. Pour un calendrier de sous-projet, incluez le sous-projet name:

   PUT https://<instance>.energy.azure.com/seistore-svc/api/v3/analytics/job
   Authorization: Bearer {access_token}
   data-partition-id: {data_partition_id}
   Content-Type: application/json
   
   [
     {
       "name": "{subproject_name}",
       "statistics": "count,size",
       "first_execution": 1,
       "freq_execution": 7
     }
   ]
   

   Pour un planning au niveau du locataire, omettez name:

   PUT https://<instance>.energy.azure.com/seistore-svc/api/v3/analytics/job
   Authorization: Bearer {access_token}
   data-partition-id: {data_partition_id}
   Content-Type: application/json
   
   [
     {
       "statistics": "count,size",
       "freq_execution": 7
     }
   ]
   

2. Examinez le planning normalisé indiqué dans la réponse. Le type champ est subproject pour un calendrier de sous-projet et partition pour un planning à l’échelle du locataire. Le champ first_execution est renvoyé sous forme d’horodatage pour la prochaine exécution planifiée :

   [
     {
       "name": "{subproject_name}",
       "type": "subproject",
       "statistics": "count,size",
       "first_execution": 1743552000000,
       "freq_execution": 7
     }
   ]
   

Le service crée le planning analytique récurrent pour le périmètre sélectionné. Demandez uniquement les statistiques dont vous avez besoin, et configurez freq_execution pour qu’il corresponde à la fréquence à laquelle vous consommez les rapports.

Récupérer les planifications d’analyse

Interrogez le point de terminaison des plannings pour voir les plannings que vous pouvez consulter. Les utilisateurs ayant le rôle tenant.admin ou datamanager obtiennent la liste complète. Un utilisateur ayant le rôle subproject.admin ne reçoit que les plannings des sous-projets qu’il peut gérer.

1. Envoyez la demande.

   GET https://<instance>.energy.azure.com/seistore-svc/api/v3/analytics/job
   Authorization: Bearer {access_token}
   data-partition-id: {data_partition_id}
   

2. Examinez les planifications renvoyées.

   [
     {
       "name": "{subproject_name}",
       "type": "subproject",
       "statistics": "count,size",
       "first_execution": 1743552000000,
       "freq_execution": 7
     }
   ]
   

La réponse contient les plannings analytiques que votre rôle attribué peut consulter.

Récupérer les rapports générés

Les rapports deviennent disponibles après la fin de la première exécution planifiée. Récupérez les rapports pour un seul sous-projet ou pour l’ensemble du locataire, et éventuellement restreignez les résultats par date.

Les paramètres de requête suivants contrôlent la liste de rapports et les requêtes URL SAS :

1. Pour lister les rapports d’un sous-projet, appelez la route du sous-projet :

   GET https://<instance>.energy.azure.com/seistore-svc/api/v3/analytics/job/{subprojectid}?filter-date=2026-09
   Authorization: Bearer {access_token}
   data-partition-id: {data_partition_id}
   

   Pour lister les rapports pour l’ensemble du tenant, appelez la route tenant :

   GET https://<instance>.energy.azure.com/seistore-svc/api/v3/analytics/tenant/job?filter-date=2026
   Authorization: Bearer {access_token}
   data-partition-id: {data_partition_id}
   

2. Consultez la liste des chemins de blobs de signalement dans la réponse :

   [
     "{subproject_name}/2026/09/15/{report_file_name}",
     "{subproject_name}/2026/09/22/{report_file_name}"
   ]
   

La réponse contient les chemins de blobs de rapport correspondant au filtre de portée et de date sélectionnés. Utilisez l’élément filter-date le plus spécifique qui répond à vos besoins pour réduire le nombre de chemins retournés.

Téléchargez un rapport avec une URL SAS

Les données de rapport ne circulent jamais via le service. À la place, demandez des informations d’identification SAS de courte durée auprès du point de terminaison /connection-string, puis utilisez l’URL SAS retournée pour lire les blobs de rapport directement depuis Stockage Blob Azure. Le filter-date que vous fournissez est ajouté au chemin de stockage, donc une date plus précise limite les informations d’identification à un ensemble plus restreint de blobs. Vous pouvez également utiliser le extension paramètre décrit dans la section précédente pour cibler un conteneur de rapports alternatifs.

1. Pour demander une URL SAS pour un rapport de sous-projet, appelez la route du sous-projet :

   GET https://<instance>.energy.azure.com/seistore-svc/api/v3/analytics/job/{subprojectid}/connection-string?filter-date=2026-09-15
   Authorization: Bearer {access_token}
   data-partition-id: {data_partition_id}
   

   Pour demander une URL SAS pour un rapport de tenant, appelez la route de tenant :

   GET https://<instance>.energy.azure.com/seistore-svc/api/v3/analytics/tenant/job/connection-string?filter-date=2026-09
   Authorization: Bearer {access_token}
   data-partition-id: {data_partition_id}
   

2. Passez en revue la réponse. access_token contient l’URL SAS :

   {
     "access_token": "https://<account>.blob.core.windows.net/sdms-analytics-reports/...&sig=...",
     "expires_in": 3599,
     "token_type": "SasUrl"
   }
   

3. Utilisez l’URL SAS avec le SDK stockage Azure ou l’API REST pour télécharger le chemin du rapport que vous avez sélectionné dans la section précédente.

L’URL SAS retournée offre un accès temporaire aux blobs de rapport pour le chemin sélectionné et expire en un peu moins d’une heure. Considérez l’URL comme un secret : ne la journalisez pas et ne la conservez pas, et demandez-en une nouvelle une fois qu’elle a expiré.

Supprimer une planification d’analyse

Supprimez un planning d’analyse lorsque vous ne souhaitez plus que le service génère des rapports récurrents pour ce périmètre.

1. Pour supprimer une planification de sous-projet, appelez la route de sous-projet :

   DELETE https://<instance>.energy.azure.com/seistore-svc/api/v3/analytics/job/{subprojectid}
   Authorization: Bearer {access_token}
   data-partition-id: {data_partition_id}
   

   Pour supprimer une planification du locataire, appelez la route du locataire :

   DELETE https://<instance>.energy.azure.com/seistore-svc/api/v3/analytics/tenant/job
   Authorization: Bearer {access_token}
   data-partition-id: {data_partition_id}
   

2. Confirmez que la requête renvoie 200 OK. La suppression d’un planning qui n’existe pas réussit également, donc l’opération peut être retentée sans danger.

Le planning analytique est supprimé, et le service ne génère plus de rapports récurrents pour ce périmètre.

Nettoyer les ressources

Ce tutoriel ne provisionne pas de nouvelle ressource Azure. Pour empêcher la génération de rapports futurs, supprimez le planning analytique décrit dans Supprimer un planning analytique.

Contenu connexe

• Tutoriel : Utiliser des données sismiques à l’aide des API DDMS sismiques
• Comment générer un jeton d’authentification
• Informations de référence sur l’API DDMS sismique