Handledning: Hantera seismiska analysscheman och ladda ner rapporter

Denna handledning visar hur man använder Seismic DDMS Analytics-operationen i Azure Data Manager for Energy för att skapa återkommande analysscheman för din seismiska data, lista och ladda ner genererade rapporter samt ta bort scheman du inte längre behöver. Schemalagda analyser hjälper dig att följa lagringskonsumtion och dataåtkomstmönster över delprojekt och tenanter över tid, så att du kan planera kapacitet och optimera lagringskostnader utan att bygga en anpassad rapporteringspipeline. Ett bakgrundsjobb beräknar den begärda statistiken i en återkommande takt och skriver varje rapport till Azure Blob Storage. Du laddar ner rapportdata direkt från lagringsplatsen, och det passerar aldrig genom tjänsten.

I den här tutorialen lär du dig följande:

Prerequisites

Kontrollera att du uppfyller följande krav innan du börjar:

• Ett Azure-abonnemang.
• En Azure Data Manager för en energiresurs med Seismic DDMS konfigurerat.
• En registrerad tenant och subproject i Seismic DDMS-tjänsten.
• subproject.admin, datamanager eller tenant.admin-rollen som har tilldelats ditt användarkonto, beroende på omfattningen.
• En ägartoken för API-autentisering. När du använder DefaultAzureCredential, begär behörigheten https://energy.azure.com/.default. Se Så här genererar du autentiseringstoken.
• data-partition-id för din klient. Ett saknat värde ger 400 BAD_REQUEST.

Förstå analysomfång

Analysjobb körs inom en av två omfattningar. Omfattningen avgör vilka dataset som mäts och vilken roll som krävs.

Varje schema lagrar tre inställningar: vad som ska beräknas statistics, veckodagen för första körningen (first_execution), och hur ofta det upprepas i dagar (freq_execution). API:t använder /job slutpunkter för schemaåtgärder. Ett bakgrundsjobb läser scheman och skriver rapporter till containern sdms-analytics-reports med sökvägslayouten <subproject>/YYYY/MM/DD/.

Skicka ett analysschema

Skicka en PUT begäran med en JSON-array som innehåller ett enda schemaobjekt. Utelämna name (eller skicka en tom sträng) för att skapa ett klientomfattande schema; ange ett delprojekt name för att avgränsa schemat till det delprojektet.

Brödtexten i begäran stöder följande fält:

1. Skicka begäran. För ett delprojektschema, inkludera delprojektet 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
     }
   ]
   

   För ett hyresgästövergripande schema, utelämna: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. Gå igenom det normaliserade schemat som returnerades i svaret. Fältet type är subproject för ett delprojektschema och partition för ett hyresgästövergripande schema. Fältet first_execution returneras som en tidsstämpel för nästa schemalagda körning:

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

Tjänsten skapar det återkommande analysschemat för den valda omfattningen. Begär bara den statistik du behöver och ställ freq_execution in så att den matchar hur ofta du konsumerar rapporter.

Hämta analysscheman

Anropa endpointen schedules för att se vilka scheman du kan se. Användare med rollen tenant.admin eller datamanager får hela listan. En användare med rollen subproject.admin får bara scheman för delprojekt de kan administrera.

1. Skicka begäran.

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

2. Gå igenom de returnerade schemana.

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

Svaret innehåller analysscheman som din tilldelade roll kan se.

Hämta genererade rapporter

Rapporter blir tillgängliga efter att den första planerade körningen är klar. Hämta rapporter för ett enskilt delprojekt eller för hela tenanten, och eventuellt begränsa resultaten efter datum.

Följande frågeparametrar styr report-list- och SAS URL-förfrågningar:

1. För att lista rapporter för ett delprojekt, anropa delprojektrutten:

   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}
   

   För att lista rapporter för hela tenanten, anropa tenant-sökvägen:

   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. Gå igenom listan över rapportblobbanor i svaret:

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

Svaret innehåller rapportblob-sökvägar som matchar det valda omfånget och datumfiltret. Använd den mest specifika filter-date som uppfyller dina behov för att minska antalet returnerade sökvägar.

Ladda ner en rapport med en SAS-URL

Rapportdata flödar aldrig genom tjänsten. Begär istället kortlivade SAS-autentiseringsuppgifter från endpointen /connection-string och använd sedan den returnerade SAS-URL:en för att läsa rapportblobsen direkt från Azure Blob Storage. Det filter-date du anger läggs till lagringsvägen, så ett mer specifikt datum avgränsar behörigheten till en smalare uppsättning blobbar. Du kan också använda parametern extension som beskrivs i föregående avsnitt för att rikta in dig på en alternativ rapportcontainer.

1. För att begära en SAS-URL för en delprojektrapport, anropa delprojektrutten:

   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}
   

   För att begära en SAS-URL för en tenant-rapport, anropa tenant-rutten:

   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. Läs svaret. access_token innehåller SAS-URL:en:

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

3. Använd SAS-URL:en med Azure Storage SDK eller REST API för att ladda ner rapportsökvägen som du valde i föregående avsnitt.

Den returnerade SAS-URL:en ger tillfällig åtkomst till rapportblobsen för den valda sökvägen och går ut om knappt en timme. Behandla URL:en som en hemlighet: logga inte eller spara den, och begär en ny efter att den gått ut.

Ta bort ett analysschema

Ta bort ett schema för analys när du inte längre vill att tjänsten ska generera återkommande rapporter för det omfånget.

1. För att ta bort ett schema för delprojekt, anropa delprojektrouten:

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

   För att ta bort ett tenant-schema, anropa tenant-rutten:

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

2. Bekräfta att begäran returnerar 200 OK. Att ta bort ett schema som inte finns lyckas också, så operationen är säker att försöka igen.

Analysschemat tas bort och tjänsten genererar inte längre återkommande rapporter för den omfattningen.

Rensa resurser

Denna handledning skapar inte en ny Azure-resurs. För att förhindra att framtida rapporter genereras, ta bort analysschemat som beskrivs i Ta bort ett analysschema.

Relaterat innehåll

• Självstudie: Arbeta med seismiska data med hjälp av Seismic DDMS-API:er
• Hur man genererar autentiseringstoken
• Referens för Seismic DDMS API