Tutorial: Verwaltung seismischer Analysepläne und Herunterladen von Berichten

Important

Diese Funktion steht derzeit als Vorschau zur Verfügung. Die zusätzlichen Nutzungsbestimmungen für Microsoft Azure-Vorschauen enthalten rechtliche Bedingungen. Sie gelten für diejenigen Azure-Features, die sich in der Beta- oder Vorschauversion befinden oder aber anderweitig noch nicht zur allgemeinen Verfügbarkeit freigegeben sind.

Dieses Tutorial zeigt, wie man die Operation Seismic DDMS Analytics in Azure Data Manager for Energy verwendet, um wiederkehrende Analysepläne für Ihre seismischen Daten zu erstellen, die generierten Berichte aufzulisten und herunterzuladen sowie Zeitpläne zu löschen, die Sie nicht mehr benötigen. Geplante Analysen helfen Ihnen, Speicherverbrauch und Datenzugriffsmuster zwischen Unterprojekten und Mandanten über die Zeit hinweg zu verfolgen, sodass Sie Kapazitäten planen und die Speicherkosten optimieren können, ohne eine individuelle Berichtspipeline aufbauen zu müssen. Ein Hintergrundjob berechnet die angeforderten Statistiken in einem wiederkehrenden Rhythmus und schreibt jeden Bericht in Azure Blob Storage. Du lädst die Berichtsdaten direkt vom Speicher herunter, und sie fließen nie durch den Dienst.

In diesem Tutorial erfahren Sie, wie:

  • Erstellen Sie einen Analyseplan für ein Teilprojekt oder einen Tenant
  • Analysepläne und generierte Berichte auflisten
  • Laden Sie einen Bericht mit einer kurzlebigen SAS-URL herunter
  • Löschen Sie einen Analysezeitplan

Prerequisites

Bevor Sie beginnen, stellen Sie sicher, dass Sie die folgenden Voraussetzungen erfüllen:

  • Ein Azure-Abonnement.
  • Eine Azure Data Manager for Energy-Ressource, bei der Seismic DDMS konfiguriert wurde.
  • Ein registrierter tenant und subproject im Seismic DDMS-Dienst.
  • Die deinem Benutzerkonto je nach Geltungsbereich zugewiesene subproject.admin-, datamanager- oder tenant.admin-Rolle
  • Ein Bearertoken für die API-Authentifizierung. Wenn Sie DefaultAzureCredential verwenden, fordern Sie den https://energy.azure.com/.default-Bereich an. Informationen zum Generieren eines Authentifizierungstokens.
  • Das data-partition-id Ihres Mieters. Ein fehlender Wert ergibt 400 BAD_REQUEST.

Verstehen Sie Analysebereiche

Analytics-Jobs laufen auf einem von zwei Scopes. Der Umfang bestimmt, welche Datensätze gemessen werden und welche Rolle benötigt wird.

Umfang Gegenstand der Messung So legen Sie das Targeting fest Erforderliche Rolle
Subproject Ein einzelnes Unterprojekt innerhalb der Partition name im Request-Body (erstellen) oder subprojectid im URL-Pfad subproject.admin, datamanager oder tenant.admin
Mandant Die gesamte Datenpartition Leer oder weggelassen name (erstellen) oder die /tenant/...-Routen datamanager oder tenant.admin

Jeder Zeitplan speichert drei Einstellungen: den zu berechnenden Wert statistics, den Wochentag für den ersten Durchlauf (first_execution) und in welchem Intervall in Tagen er sich wiederholt (freq_execution). Die API verwendet /job Endpunkte für Zeitplanvorgänge. Ein Hintergrundjob liest die Zeitpläne und schreibt Berichte an den Container sdms-analytics-reports , indem er das Pfad-Layout <subproject>/YYYY/MM/DD/verwendet.

Analytics-Zeitplan übermitteln

Reichen Sie eine PUT Anfrage mit einem JSON-Array ein, das ein einzelnes Schedule-Objekt enthält. Weglassen name (oder einen leeren String senden), um einen tenantweiten Zeitplan zu erstellen; ein Unterprojekt name bereitstellen, um den Zeitplan auf dieses Unterprojekt abzugrenzen.

Der Body der Anfrage unterstützt die folgenden Felder:

Feld Required Type Description
name No string Name des Unterprojekts. Wenn der Plan leer oder weggelassen wird, wird er im Tenant-Scope erstellt und setzt standardmäßig auf den data-partition-id.
statistics Yes string Komma-separierte Liste der zu berechnenden Statistiken. Der Weißraum wird entfernt und der Wert vor der Speicherung in Kleinbuchstaben umgewandelt.
first_execution No Ganzzahl (1–7) Wochentag für den ersten Lauf. Standardmäßig ist der aktuelle Tag ausgewählt. Werte außerhalb 1–7 geben 400 BAD_REQUEST zurück.
freq_execution No Ganzzahl (>0) Ausführungshäufigkeit in Tagen. Wird standardmäßig auf 7 festgelegt.

  1. Senden Sie die Anforderung. Für einen Teilprojektplan fügen Sie das Teilprojekt namehinzu:

    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
  }
]

    Für einen mandantenweiten Zeitplan lassen Sie name weg:

    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. Überprüfen Sie den normalisierten Zeitplan, der in der Antwort zurückgegeben wurde. Das Feld type ist subproject für einen Teilprojektplan und partition für einen mieterweiten Zeitplan. Das Feld first_execution wird als Zeitstempel für den nächsten geplanten Lauf zurückgegeben:

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

Der Dienst erstellt den wiederkehrenden Analyseplan für den ausgewählten Bereich. Fordere nur die Statistiken an, die du brauchst, und stelle freq_execution so ein, wie oft du Berichte konsumierst.

Analysepläne abrufen

Ruf den Zeitpläne-Endpunkt an, um die Zeitpläne zu sehen, die du einsehen kannst. Benutzer mit der tenant.admin oder datamanager Rolle erhalten die vollständige Liste. Ein Nutzer mit der Rolle subproject.admin erhält nur die Zeitpläne für Teilprojekte, die er administrieren kann.

  1. Senden Sie die Anforderung.

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

  2. Überprüfen Sie die zurückgegebenen Zeitpläne.

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

Die Antwort enthält die Analysezeitpläne, die deine zugewiesene Rolle einsehen kann.

Generierte Berichte abrufen

Berichte werden nach Abschluss des ersten geplanten Laufs verfügbar. Berichte für ein einzelnes Teilprojekt oder für den gesamten Tenant abrufen und optional die Ergebnisse nach Datum eingrenzen.

Die folgenden Abfrageparameter steuern Berichtslisten- und SAS-URL-Anfragen:

Parameter Required Type Description
filter-date No string Beschränkt die Ergebnisse nach Datum. Muss YYYY, YYYY-MM oder YYYY-MM-DD sein. Jedes andere Format gibt 400 BAD_REQUEST zurück.
extension No string Wählt einen alternativen Berichtscontainer namens sdms-analytics-reports-<extension>aus. Es darf nur kleine alphanumerische Zeichen und Bindestriche enthalten, ohne aufeinanderfolgende Bindestriche, und der kombinierte Containername darf 63 Zeichen nicht überschreiten.

  1. Um Berichte für ein Teilprojekt aufzulisten, rufen Sie die Subprojekt-Route auf:

    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}

    Um Berichte für den gesamten Mandanten aufzulisten, rufen Sie die Mandantenroute auf:

    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. Überprüfen Sie die Liste der Berichts-Blob-Pfade in der Antwort:

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

Die Antwort enthält die Berichts-Blob-Pfade, die mit dem ausgewählten Scope- und Datumsfilter übereinstimmen. Verwenden Sie die spezifischste filter-date, die Ihren Anforderungen entspricht, um die Anzahl der zurückgegebenen Pfade zu reduzieren.

Laden Sie einen Bericht mit einer SAS-URL herunter

Berichtsdaten fließen niemals durch den Dienst. Stattdessen fordern Sie kurzlebige SAS-Anmeldeinformationen vom /connection-string Endpunkt an und verwenden Sie dann die zurückgegebene SAS-URL, um die Berichtsblobs direkt aus Azure Blob Storage zu lesen. Das filter-date angegebene Datum wird dem Speicherpfad angehängt, sodass ein spezifischeres Datum die Zugangsdaten auf eine engere Gruppe von Blobs begrenzt. Sie können auch den extension im vorherigen Abschnitt beschriebenen Parameter verwenden, um einen alternativen Berichtscontainer zu wählen.

  1. Um eine SAS-URL für einen Teilprojektbericht anzufordern, rufen Sie die Unterprojektroute auf:

    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}

    Um eine SAS-URL für einen Mandantenbericht anzufordern, rufen Sie die Mandantenroute an:

    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. Überprüfen Sie die Antwort. Die access_token enthält die SAS-URL:

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

  3. Verwenden Sie die SAS-URL mit dem Azure Storage SDK oder der REST API, um den von Ihnen im vorherigen Abschnitt ausgewählten Berichtspfad herunterzuladen.

Die zurückgegebene SAS-URL gewährt vorübergehenden Zugriff auf die Berichtsblobs für den ausgewählten Pfad und läuft in knapp einer Stunde ab. Behandle die URL als Geheimnis: Logge sie nicht und speichere sie nicht und fordere nach Ablauf eine neue an.

Löschen Sie einen Analytics-Zeitplan

Löschen Sie einen Analysezeitplan, wenn Sie nicht mehr möchten, dass der Dienst wiederkehrende Berichte für diesen Bereich erstellt.

  1. Um einen Teilprojektplan zu löschen, rufen Sie die Subprojekt-Route auf:

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

    Um einen Mandantenzeitplan zu löschen, rufen Sie die Mandantenroute auf:

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

  2. Bestätigen Sie, dass die Anfrage 200 OK zurückgibt. Das Löschen eines Zeitplans, der nicht existiert, gelingt ebenfalls, sodass die Operation sicher erneut versucht werden kann.

Der Analyseplan wird gelöscht, und der Dienst generiert keine wiederkehrenden Berichte mehr für diesen Bereich.

Bereinigen von Ressourcen

Dieses Tutorial stellt keine neue Azure-Ressource bereit. Um zu verhindern, dass zukünftige Berichte generiert werden, löschen Sie den Analyseplan wie in Einen Analyseplan löschen beschrieben.

Verwandte Inhalte

  • Zuletzt aktualisiert um