Tutorial: Trabalhar com registros de dados do Petrel usando APIs do Petrel DDMS

Use APIs do DDMS (Petrel Domain Gerenciamento de Dados Services) para trabalhar com dados do Petrel em sua instância do Azure Data Manager for Energy.

Neste tutorial, você aprenderá a:

  • Gerar um token de autorização.
  • Use APIs do Petrel DDMS para trabalhar com registros de dados e projetos do Petrel.

Para obter mais informações sobre DDMS, consulte os conceitos de DDMS.

Prerequisites

Obter detalhes da instância do Azure Data Manager para Energia

Para este tutorial, você precisa dos seguintes parâmetros:

Parameter Valor a ser usado Example Onde encontrar esse valor
DNS URI <instance>.energy.azure.com Localize esse valor na página de visão geral da instância do Azure Data Manager para Energia.
data-partition-id Partição de dados <data-partition-id> Localize esse valor na seção Partição de Dados na instância do Azure Data Manager for Energy.
access_token Valor do token de acesso 0.ATcA01-XWHdJ0ES-qDevC6r........... Siga Como gerar um token de autenticação para criar um token de acesso e salvá-lo.

Siga o guia Gerenciar usuários para adicionar direitos apropriados para o usuário que está executando este tutorial.

Configure seu ambiente

Certifique-se de ter cURL instalado em seu sistema para fazer chamadas à API.

Usar APIs do Petrel DDMS para trabalhar com projetos do Petrel

Realizar com sucesso as chamadas à API presentes no swagger indica uma interação correta com seus projetos do Petrel salvos. Embora a API forneça uma maneira de carregar dados, recomendamos carregar seus projetos por meio do DeLFI Petrel Project Explorer. Todas as chamadas à API a seguir pressupõem que você tenha um projeto carregado no Petrel Project Explorer.

Crie uma marca legal que você pode usar para conformidade de dados.

Execute o seguinte cURL comando para criar uma marca legal:

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"
           }
       }'

Resposta de exemplo:

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

Para obter mais informações, consulte Gerenciar marcas legais.

Adicionar usuários a um grupo de direitos

Para que os usuários tenham as permissões adequadas para fazer chamadas à API do Petrel DDMS, eles devem fazer parte do users.datalake.admins@{data-partition-id}.dataservices.energy grupo de direitos. Essa chamada adiciona um usuário ao grupo apropriado.

Nesse caso, o usuário é a ID do cliente ou o OID no token usado para autenticação. Por exemplo, se você gerar um token usando uma ID do cliente de 8cdxxxxxxxxxxxx, deverá adicionar 8cdxxxxxxxxxxxx ao grupo users.datalake.admins. Siga o guia Gerenciar usuários para adicionar direitos apropriados ao usuário.

Obter um projeto

Use uma ID do projeto para retornar o registro de projeto do Petrel correspondente em sua instância do Azure Data Manager for Energy.

API

Excluir um projeto

Use uma ID do projeto para excluir um projeto e os dados de registro de projeto do Petrel associados em sua instância do Azure Data Manager for Energy.

API

Obter uma versão do projeto

Use uma ID de projeto e uma ID de versão para obter o registro de versão do Petrel associado ao projeto e à versão em sua instância do Azure Data Manager for Energy.

API

Obter uma URL de download do projeto

Use uma ID de projeto para obter uma URL de SAS (assinatura de acesso compartilhado) para que você possa baixar os dados do projeto correspondente de sua instância do Azure Data Manager for Energy.

API

Obter uma URL de upload do projeto

Use uma ID do projeto para obter duas URLs SAS. Uma URL carrega dados para o projeto correspondente em sua instância do Azure Data Manager for Energy. A outra URL baixa dados do projeto correspondente na instância do Azure Data Manager for Energy.

API

A URL de upload da SAS deve ser semelhante a este exemplo:

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

Você pode modificar essa URL para conter o nome do arquivo de dados que deseja carregar:

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

Fazer uma chamada PUT para essa URL carrega o conteúdo de body para o armazenamento de blobs sob o valor FILENAME fornecido.

Atualizar um projeto

Use uma ID de projeto e uma URL de upload de SAS para atualizar um registro de projeto do Petrel no Azure Data Manager for Energy com os novos valores. Você também pode carregar dados em um projeto, se desejar.

API

Pesquisar projetos

Você pode pesquisar projetos do Petrel usando muitos campos. A chamada retorna todas as IDs de projeto correspondentes. A API de Pesquisa dá suporte a:

  • Pesquisa de texto completo em campos de cadeia de caracteres.
  • Intervalo de consultas com base em campos de data, numérico ou de cadeia de caracteres.
  • Busca geoespacial.

API

Conteúdo relacionado

Use os seguintes links DELFI para ler outros tutoriais que envolvem o Explorador de Projetos Petrel e fluxos de trabalho Petrel.

  • Última atualização em