Tutorial: Gestire le pianificazioni delle analisi sismiche e scaricare i report

Important

Questa funzionalità è attualmente disponibile solo in anteprima. Vedi le Condizioni supplementari d'uso per le anteprime di Microsoft Azure per conoscere le condizioni legali applicabili alle funzionalità di Azure che sono in beta, in anteprima o non ancora rilasciate nella disponibilità generale.

Questo tutorial mostra come utilizzare l'operazione Seismic DDMS Analytics in Azure Data Manager for Energy per creare pianificazioni analitiche ricorrenti per i tuoi dati sismici, elencare e scaricare i report generati e cancellare le pianificazioni che non ti servono più. Le analisi programmate ti aiutano a monitorare il consumo dello storage e i modelli di accesso ai dati tra sottoprogetti e tenant nel tempo, così puoi pianificare la capacità e ottimizzare i costi di storage senza costruire una pipeline di reporting personalizzata. Un lavoro in background calcola le statistiche richieste su una cadenza ricorrente e scrive ogni report su Archiviazione BLOB di Azure. I dati dei report vengono scaricati direttamente dall'archiviazione e non transitano mai attraverso il servizio.

In questa esercitazione apprenderai a:

Crea un calendario di analisi per un sottoprogetto o un tenant
Elenca le pianificazioni di analisi e i report generati
Scarica un rapporto con un URL SAS di breve durata
Elimina una pianificazione di Analytics

Prerequisites

Prima di iniziare, assicurarsi di soddisfare i prerequisiti seguenti:

Una sottoscrizione di Azure.
Una risorsa di Azure Data Manager per l'energia con Seismic DDMS configurato.
Un oggetto registrato tenant e subproject nel servizio Seismic DDMS.
Il ruolo subproject.admin, datamanager o tenant.admin assegnato al tuo account utente, a seconda dell'ambito.
Token portatore per l'autenticazione API. Quando usi DefaultAzureCredential, richiedi l'ambito https://energy.azure.com/.default. Vedere Come generare il token di autenticazione.
data-partition-id del tenant. Un valore mancante restituisce 400 BAD_REQUEST.

Informazioni sugli ambiti di analisi

I lavori di analytics operano in uno di due ambiti. L'ambito determina quali dataset vengono misurati e quale ruolo è richiesto.

Scope	Cosa misura	Come impostare la destinazione	Ruolo necessario
Sottoprogetto	Un singolo sottoprogetto all'interno della partizione	`name` nel corpo della richiesta (create), oppure `subprojectid` nel percorso URL	`subproject.admin`, `datamanager` o `tenant.admin`
Tenant	L'intera partizione dei dati	`name` vuoto o omesso (creazione) oppure le route `/tenant/...`	`datamanager` oppure `tenant.admin`

Ogni pianificazione archivia tre impostazioni: statistics da calcolare, il giorno della settimana della prima esecuzione (first_execution) e la frequenza di ripetizione in giorni (freq_execution). L'API utilizza /job endpoint per le operazioni di programmazione. Un lavoro in background legge le pianificazioni e scrive report nel contenitore sdms-analytics-reports utilizzando la struttura del percorso <subproject>/YYYY/MM/DD/.

Inviare una pianificazione di analisi

Invia una PUT richiesta con un array JSON che contiene un singolo oggetto schedule. Ometti name (o invia una stringa vuota) per creare un programma a livello di tenant; fornisci un sottoprogetto name per limitare il programma a quel sottoprogetto.

Il corpo della richiesta supporta i seguenti campi:

Field	Required	Type	Description
`name`	No	string	Nome del sottoprogetto. Se vuota o omessa, la pianificazione viene creata nell'ambito del tenant e per impostazione predefinita usa `data-partition-id`.
`statistics`	Sì	string	Elenco di statistiche separate da virgole da calcolare. Gli spazi vuoti vengono rimossi e il valore viene convertito in minuscolo prima della conservazione.
`first_execution`	No	intero (1–7)	Giorno della settimana per la prima esecuzione. Per impostazione predefinita è il giorno corrente. Valori esterni da `1`–`7` restituiscono `400 BAD_REQUEST`.
`freq_execution`	No	intero (>0)	Frequenza di esecuzione in giorni. Di default è `7`.

Invia la richiesta. Per un programma di sottoprogetto, includere il sottoprogetto 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
  }
]

Per una pianificazione a livello di tenant, ometti 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
  }
]

Rivedi il programma normalizzato restituito nella risposta. Il type campo è subproject per un programma di sottoprogetto e partition per un programma a livello di tenant. Il first_execution campo viene restituito come timestamp per la prossima corsa programmata:
```
[
  {
    "name": "{subproject_name}",
    "type": "subproject",
    "statistics": "count,size",
    "first_execution": 1743552000000,
    "freq_execution": 7
  }
]
```

Il servizio crea la pianificazione ricorrente delle analisi per l'ambito selezionato. Richiedere solo le statistiche necessarie e impostare freq_execution in base alla frequenza con cui vengono utilizzati i report.

Recuperare le pianificazioni di analisi

Chiama l'endpoint delle pianificazioni per vedere le pianificazioni che puoi visualizzare. Gli utenti con il tenant.admin ruolo o datamanager ricevono l'elenco completo. Un utente con questo subproject.admin ruolo riceve solo i calendari dei sottoprogetti che può amministrare.

Invia la richiesta.

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

Esaminare le pianificazioni restituite.

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

La risposta contiene le pianificazioni di Analytics che il ruolo assegnato può visualizzare.

Recupera i report generati

I rapporti diventano disponibili dopo il completamento della prima esecuzione pianificata. Recupera i report per un singolo sottoprogetto o per l'intero tenant, e opzionalmente restringi i risultati per data.

I seguenti parametri di query controllano la lista di report e le richieste URL SAS:

Parametro	Required	Type	Description
`filter-date`	No	string	Limita i risultati per data. Deve essere `YYYY`, `YYYY-MM`o `YYYY-MM-DD`. Qualsiasi altro formato restituisce `400 BAD_REQUEST`.
`extension`	No	string	Seleziona un contenitore alternativo per i report chiamato `sdms-analytics-reports-<extension>`. Deve contenere solo caratteri alfanumerici minuscoli e trattini, senza trattini consecutivi, e il nome combinato del contenitore non deve superare i 63 caratteri.

Per elencare i report di un sottoprogetto, chiama la route del sottoprogetto:

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}

Per elencare i report per l'intero tenant, chiama la route del 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}

Rivedere l'elenco dei percorsi di blob di segnalazione nella risposta:

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

La risposta contiene i percorsi dei blob di report che corrispondono all'ambito e al filtro di data selezionati. Usa il filtro più specifico filter-date che soddisfi le tue esigenze per ridurre il numero di percorsi restituiti.

Scarica un rapporto con un URL SAS

I dati del report non transitano mai attraverso il servizio. Invece, richiedi una credenziale SAS di breve durata dall'endpoint/connection-string, poi usa l'URL SAS restituito per leggere i blob del report direttamente da Archiviazione BLOB di Azure. Il filter-date che fornisci viene aggiunto al percorso di archiviazione, quindi una data più specifica limita la credenziale a un insieme più ristretto di blob. Puoi anche usare il parametro extension descritto nella sezione precedente per mirare a un contenitore di report alternativi.

Per richiedere un URL SAS per un report di sottoprogetto, chiama la rotta del sottoprogetto:

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}

Per richiedere un URL SAS per un report tenant, chiama la route del 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}

Esaminare la risposta. access_token contiene l'URL SAS:

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

Usa l'URL SAS con l'Archiviazione di Azure SDK o l'API REST per scaricare il percorso del report che hai selezionato nella sezione precedente.

L'URL SAS restituito fornisce accesso temporaneo ai blob del report per il percorso selezionato e scade in poco meno di un'ora. Considera l'URL come un segreto: non registrarlo né conservarlo, e richiederne uno nuovo dopo la scadenza.

Elimina un programma di analisi

Elimina un programma di analisi quando non vuoi più che il servizio generi report ricorrenti per quell'ambito.

Per eliminare una pianificazione di sottoprogetto, chiama la route del sottoprogetto:

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

Per eliminare una pianificazione del tenant, chiamare la route del tenant:

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

Conferma che la richiesta restituisca 200 OK. Anche l'eliminazione di una pianificazione inesistente viene completata correttamente, quindi è possibile ritentare l'operazione in sicurezza.

Il calendario delle analisi viene eliminato e il servizio non genera più report ricorrenti per quell'ambito.

Pulire le risorse

Questo tutorial non esegue il provisioning di una nuova risorsa Azure. Per impedire la generazione di report futuri, elimina la pianificazione di analisi come descritto in Elimina una pianificazione di analisi.

Commenti e suggerimenti

Questa pagina è stata utile?

Ultimo aggiornamento: 2026-10-12