Tutorial: Trabalhar com registos de dados Petrel utilizando as APIs Petrel DDMS

Utilize os serviços Petrel Domain Gestão de Dados Services (DDMS) para trabalhar com dados Petrel na sua instância do Azure Data Manager for Energy.

Neste tutorial, você aprende a:

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

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

Prerequisites

Obter detalhes para a instância do Azure Data Manager for Energy

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

Parameter Valor a utilizar Example Onde encontrar este valor
DNS URI <instance>.energy.azure.com Encontre esse valor na página de visão geral da instância do Azure Data Manager for Energy.
data-partition-id Partição de dados <data-partition-id> Encontre 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.

Configurar o ambiente

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

Usar APIs DDMS Petrel para trabalhar com projetos Petrel

Concluir com sucesso as chamadas de API que estão presentes no swagger indica uma interação bem-sucedida com os projetos Petrel que guardou. Embora a API forneça uma maneira de carregar dados, recomendamos o upload de seus projetos via DELFI Petrel Project Explorer. Todas as chamadas de API a seguir pressupõem que você tenha um projeto carregado no Petrel Project Explorer.

Crie uma tag legal que você possa 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"
           }
       }'

Exemplo de resposta:

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

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

Adicionar usuários a um grupo de direitos

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

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

Obter um projeto

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

API

Eliminar um projeto

Use uma ID de projeto para excluir um projeto e os dados de registro de projeto 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 Petrel associado ao projeto e à versão em sua instância do Azure Data Manager for Energy.

API

Obter um URL de download do projeto

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

API

Obter um URL de carregamento de projeto

Use um ID de 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 em sua instância do Azure Data Manager for Energy.

API

O URL de carregamento do 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}

Pode modificar este URL para conter o nome de ficheiro dos dados que pretende carregar:

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

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

Atualizar um projeto

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

API

Pesquisar em projetos

Você pode pesquisar em projetos Petrel usando muitos campos. A chamada retorna todas as IDs de projeto correspondentes. A API de pesquisa suporta:

  • Pesquisa de texto completo em campos de cadeia de caracteres.
  • Consultas de intervalo com base em campos de data, numéricos ou texto.
  • Pesquisa geoespacial.

API

Conteúdo relacionado

Use os seguintes links DELFI para ler outros tutoriais que envolvem os fluxos de trabalho Petrel Project Explorer e Petrel:

  • Última atualização a