Esercitazione: Lavorare con i record di dati Petrel utilizzando le API Petrel DDMS

Usare le API Petrel Domain Gestione dati Services (DDMS) per usare i dati Petrel nell'istanza di Azure Data Manager for Energy.

In questa esercitazione si apprenderà come:

  • Generare un token di autorizzazione.
  • Usare le API Petrel DDMS per lavorare con i progetti e i record di dati Petrel.

Per altre informazioni su DDMS, vedere Concetti relativi a DDMS.

Prerequisites

Ottieni i dettagli dell'istanza di Azure Data Manager for Energy

Per questa esercitazione sono necessari i parametri seguenti:

Parameter Valore da utilizzare Example Dove trovare questo valore
DNS URI <instance>.energy.azure.com Trovare questo valore nella pagina di panoramica dell'istanza di Azure Data Manager for Energy.
data-partition-id Partizione dei dati <data-partition-id> Trovare questo valore nella sezione Partizione dati nell'istanza di Azure Data Manager for Energy.
access_token Valore del token di accesso 0.ATcA01-XWHdJ0ES-qDevC6r........... Seguire Come generare il token di autenticazione per creare un token di accesso e salvarlo.

Seguire la guida Gestire gli utenti per aggiungere diritti appropriati per l'utente che esegue questa esercitazione.

Configurazione dell'ambiente

Assicurarsi di aver cURL installato nel sistema per effettuare chiamate API.

Usare le API Petrel DDMS per lavorare con i progetti Petrel

Il completamento delle chiamate API presenti in swagger indica un'interazione riuscita con i progetti Petrel salvati. Sebbene l'API fornisca un modo per caricare i dati, è consigliabile caricare i progetti tramite DELFI Petrel Project Explorer. Tutte le chiamate API seguenti presuppongono che sia stato caricato un progetto in Petrel Project Explorer.

Creare un tag legale che è possibile usare per la conformità dei dati.

Eseguire il comando seguente cURL per creare un tag legale:

curl -X POST "https://<DNS>/api/legal/v1/legaltags" \
     -H "Authorization: Bearer <access_token>" \
     -H "Content-Type: application/json" \
     -H "data-partition-id: <data-partition-id>" \
     -d '{
           "name": "LegalTagName",
           "description": "Legal Tag added for Well",
           "properties": {
               "contractId": "123456",
               "countryOfOrigin": ["US", "CA"],
               "dataType": "Third Party Data",
               "exportClassification": "EAR99",
               "originator": "xyz",
               "personalData": "No Personal Data",
               "securityClassification": "Private",
               "expirationDate": "2025-12-25"
           }
       }'

Risposta di esempio:

{
  "name": "LegalTagName",
  "status": "Created"
}

Per altre informazioni, vedere Gestire i tag legali.

Aggiungere utenti a un gruppo di entitlement

Affinché gli utenti dispongano delle autorizzazioni appropriate per effettuare chiamate API DDMS Petrel, devono far parte del users.datalake.admins@{data-partition-id}.dataservices.energy gruppo di autorizzazione. Questa chiamata aggiunge un utente al gruppo appropriato.

L'utente in questo caso è l'ID client o l'OID nel token usato per l'autenticazione. Ad esempio, se si genera un token usando un ID client di 8cdxxxxxxxxxxxx, è necessario aggiungere 8cdxxxxxxxxxxxx al users.datalake.admins gruppo. Seguire la guida Gestire gli utenti per aggiungere diritti appropriati per l'utente .

Ottenere un progetto

Usare un ID progetto per restituire il record di progetto Petrel corrispondente nell'istanza di Azure Data Manager per l'energia.

API

Eliminare un progetto

Usare un ID progetto per eliminare un progetto e i dati dei record del progetto Petrel associati nell'istanza di Azure Data Manager per l'energia.

API

Ottenere una versione del progetto

Usare un ID progetto e un ID versione per ottenere il record della versione Petrel associato al progetto e alla versione nell'istanza di Azure Data Manager per Energy.

API

Ottenere un URL di download del progetto

Usare un ID progetto per ottenere un URL di firma di accesso condiviso (SAS) in modo da poter scaricare i dati del progetto corrispondente dall'istanza di Azure Data Manager per l'energia.

API

Ottenere un URL di caricamento del progetto

Usare un ID progetto per ottenere due URL SAS. Un URL carica i dati nel progetto corrispondente nell'istanza di Azure Data Manager per l'energia. L'altro URL scarica i dati dal progetto corrispondente nell'istanza di Azure Data Manager per l'energia.

API

La tua URL di caricamento SAS dovrebbe somigliare a questo esempio:

https://{storage-account}.z15.blob.storage.azure.net/projects/{data-partition-id}/{projectID}.staging/{versionID}?{SAS-token-info}

È possibile modificare questo URL in modo da contenere il nome file dei dati da caricare:

https://{storage-account}.z15.blob.storage.azure.net/projects/{data-partition-id}/{projectID}.staging/{versionID}/{FILENAME}?{SAS-token-info}

Se si effettua una PUT chiamata a questo URL, il contenuto di body viene caricato nell'archivio BLOB con il valore specificato FILENAME .

Aggiornare un progetto

Usare un ID progetto e un URL SAS di caricamento per aggiornare un record di progetto Petrel in Azure Data Manager for Energy con i nuovi valori. È anche possibile caricare i dati in un progetto, se necessario.

API

Eseguire ricerche nei progetti

È possibile eseguire ricerche nei progetti Petrel usando molti campi. La chiamata restituisce tutti gli ID di progetto corrispondenti. L'API di ricerca supporta:

  • Ricerca full-text nei campi di stringhe.
  • Query di intervallo basate su campi data, numerici o stringa.
  • Ricerca geospaziale.

API

Contenuti correlati

Utilizzare i collegamenti DELFI seguenti per leggere altri tutorial che coinvolgono Petrel Project Explorer e Petrel Flussi di lavoro.

  • Ultimo aggiornamento: