Tutorial: Beheer planningen voor seismische analyses en download rapporten

Important

Deze functie is momenteel beschikbaar als preview-versie. Zie de Aanvullende Gebruiksvoorwaarden voor Microsoft Azure Previews voor juridische voorwaarden die van toepassing zijn op Azure-functies die in bèta, preview, of anderszins nog niet algemeen beschikbaar zijn.

Deze tutorial laat zien hoe je de Seismic DDMS Analytics-operatie in Azure Data Manager for Energy kunt gebruiken om terugkerende analyticsplanningen te maken voor je seismische data, de gegenereerde rapporten te vermelden en te downloaden, en planningen te verwijderen die je niet meer nodig hebt. Geplande analyses helpen u om opslagverbruik en data-toegangspatronen over subprojecten en tenants heen in de loop van de tijd te volgen, zodat u capaciteit kunt plannen en opslagkosten kunt optimaliseren zonder een aangepaste rapportagepijplijn op te bouwen. Een achtergrondtaak berekent de gevraagde statistieken op een terugkerende cadans en schrijft elk rapport naar Azure Blob Storage. Je downloadt rapportgegevens direct uit de opslag, en het stroomt nooit door de service.

In deze handleiding leer je hoe je:

Maak een analyseschema voor een subproject of een tenant
Geef analyseschema's en gegenereerde rapporten weer
Download een rapport met een kortstondige SAS-URL
Verwijder een analytics-schema

Prerequisites

Voordat u begint, moet u ervoor zorgen dat u voldoet aan de volgende vereisten:

Een Azure-abonnement.
Een Azure Data Manager for Energy-bron waarop Seismic DDMS is geconfigureerd.
Een geregistreerde tenant en subproject in de Seismic DDMS-service.
De subproject.admin, datamanager of tenant.admin rol die aan je gebruikersaccount is toegewezen, afhankelijk van de scope.
Een bearer-token voor API-verificatie. Wanneer je DefaultAzureCredential gebruikt, vraag dan om de https://energy.azure.com/.default scope. Zie Hoe u een verificatietoken genereert.
De data-partition-id van uw tenant. Een ontbrekende waarde retourneert 400 BAD_REQUEST.

Analyticsbereiken begrijpen

Analyticstaken worden uitgevoerd op een van twee scopes. De scope bepaalt welke datasets worden gemeten en welke rol vereist is.

Scope	Wat het meet	Hoe je het target	Vereiste rol
Subproject	Een enkel subproject binnen de partitie	`name` in de request body (create), of `subprojectid` in het URL-pad	`subproject.admin`, `datamanager` of `tenant.admin`
Tenant	De gehele datapartitie	Leeg of weggelaten `name` (creëren), of de `/tenant/...` routes	`datamanager` of `tenant.admin`

Elke planning slaat drie instellingen op: de statistics die wordt berekend, de dag van de week voor de eerste run (first_execution), en hoe vaak deze wordt herhaald in dagen (freq_execution). De API gebruikt /job eindpunten voor bewerkingen voor planning. Een achtergrondtaak leest de schema's en schrijft rapporten naar de sdms-analytics-reports container door gebruik te maken van de padindeling <subproject>/YYYY/MM/DD/.

Dien een analyseschema in

Dien een PUT verzoek in met een JSON-array die één schedule-object bevat. Laat name weg (of stuur een lege string) om een tenant-brede planning te maken; bied een subproject name aan om het schema op dat subproject te scopen.

Het verzoeklichaam ondersteunt de volgende velden:

Veld	Required	Type	Description
`name`	No	string	Subprojectnaam. Wanneer dit leeg is of wordt weggelaten, wordt het schema aangemaakt in de tenant scope en standaard ingesteld op de `data-partition-id`.
`statistics`	Yes	string	Comma-gescheiden lijst van statistieken die berekend moeten worden. Witruimte wordt verwijderd en de waarde wordt naar kleine letters omgezet voordat deze wordt opgeslagen.
`first_execution`	No	integer (1–7)	Dag van de week voor de eerste uitvoering. Standaard staat het op de huidige dag. Waarden buiten `1`–`7` retourneren `400 BAD_REQUEST`.
`freq_execution`	No	geheel getal (>0)	Uitvoeringsfrequentie in dagen. Wordt standaard ingesteld op `7`.

Dien de aanvraag in. Voor een subprojectschema, neem het subproject nameop:

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

Voor een tenantbreed schema, laat 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
  }
]

Bekijk het genormaliseerde schema dat in de reactie is teruggegeven. Het type veld is subproject bedoeld voor een subprojectschema en partition voor een tenant-breed schema. Het first_execution veld wordt teruggegeven als tijdstempel voor de volgende geplande uitvoering:
```
[
  {
    "name": "{subproject_name}",
    "type": "subproject",
    "statistics": "count,size",
    "first_execution": 1743552000000,
    "freq_execution": 7
  }
]
```

De dienst maakt het terugkerende analyseschema voor de geselecteerde scope. Vraag alleen de statistieken aan die je nodig hebt en stel freq_execution zo in dat het overeenkomt met hoe vaak je rapporten bekijkt.

Analytics-schema's ophalen

Roep het schedules-endpoint aan om de schedules te zien die je kunt bekijken. Gebruikers met de tenant.admin of datamanager rol krijgen de volledige lijst. Een gebruiker met de subproject.admin-rol krijgt alleen de schema's voor subprojecten die hij kan beheren.

Dien de aanvraag in.

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

Bekijk de geretourneerde roosters.

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

Het antwoord bevat de analyticsschema’s die jouw toegewezen rol kan bekijken.

Haal gegenereerde rapporten op

Rapporten worden beschikbaar nadat de eerste geplande run is voltooid. Haal rapporten op voor één subproject of voor de hele tenant, en beperk optioneel de resultaten op datum.

De volgende queryparameters regelen rapportlijst- en SAS-URL-verzoeken:

Parameter	Required	Type	Description
`filter-date`	No	string	Beperkt de resultaten op datum. Moet zijn `YYYY`, `YYYY-MM`of `YYYY-MM-DD`. Elk ander formaat geeft `400 BAD_REQUEST`.
`extension`	No	string	Selecteert een alternatieve rapportcontainer met de naam `sdms-analytics-reports-<extension>`. Mag alleen kleine alfanumerieke tekens en koppeltekens bevatten, zonder opeenvolgende koppeltekens, en de gecombineerde containernaam mag niet langer zijn dan 63 tekens.

Om rapporten voor een subproject te vermelden, roep de route van het subproject aan:

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}

Om rapporten voor de hele tenant weer te geven, roep de tenant-route aan:

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}

Bekijk de lijst met rapportblobpaden in de reactie:

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

De reactie bevat de rapportblobpaden die overeenkomen met het geselecteerde scope- en datumfilter. Gebruik het meest specifieke filter-date dat aan jouw behoeften voldoet om het aantal teruggestuurde paden te verminderen.

Download een rapport met een SAS-URL

Rapportgegevens lopen nooit door de service. Vraag in plaats daarvan een kortstondig SAS-credential aan bij het /connection-string endpoint en gebruik vervolgens de teruggegeven SAS-URL om de rapportblobs rechtstreeks van Azure Blob Storage te lezen. De filter-date die je opgeeft wordt toegevoegd aan het opslagpad, dus een specifiekere datum beperkt de credential tot een kleinere set blobs. Je kunt ook de extension parameter die in de voorgaande sectie is beschreven gebruiken om een alternatieve rapportcontainer te targeten.

Om een SAS-URL voor een subprojectrapport aan te vragen, roep de subprojectroute aan:

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}

Om een SAS-URL voor een tenantrapport aan te vragen, roep de tenant-route aan:

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}

Bekijk het antwoord. De access_token bevat de SAS-URL:

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

Gebruik de SAS-URL met de Azure Storage SDK of REST API om het rapportpad te downloaden dat je in de voorgaande sectie hebt geselecteerd.

De teruggegeven SAS-URL biedt tijdelijke toegang tot de rapportblobs voor het geselecteerde pad en verloopt over iets minder dan een uur. Behandel de URL als een geheim: log of bewaar hem niet, en vraag een nieuwe aan nadat deze is verlopen.

Verwijder een analyticsschema

Verwijder een analyseschema voor analytics wanneer je niet meer wilt dat de dienst terugkerende rapporten genereert voor die scope.

Om een subprojectschema te verwijderen, roep je de subprojectroute aan:

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

Om een tenantschema te verwijderen, roep de tenantroute aan:

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

Bevestig dat het verzoek 200 OK retourneert. Het verwijderen van een schema dat niet bestaat lukt ook, dus de operatie is veilig om opnieuw te proberen.

Het analyseschema is verwijderd en de dienst genereert geen terugkerende rapporten meer voor die scope.

De hulpbronnen opschonen

Deze tutorial maakt geen nieuwe Azure-resource aan. Om te voorkomen dat toekomstige rapporten worden gegenereerd, verwijder je de analysesplanning zoals beschreven in Een analysesplanning verwijderen.

Feedback

Is deze pagina nuttig?

Laatst bijgewerkt om 2026-10-08