Share via

Tutorial: trabalhar com registros de dados de poço usando APIs do Wellbore DDMS

  • Artigo

Use APIs do DDMS (Wellbore Domain Data Management Services) no Postman para trabalhar com dados de poço em sua instância do Gerenciador de Dados do Microsoft Azure para Energia.

Neste tutorial, você aprenderá a:

  • Configurar o Postman para usar uma coleção do Wellbore DDMS.
  • Configurar o Postman para usar um ambiente do Wellbore DDMS.
  • Enviar solicitações por meio do Postman.
  • Gerar um token de autorização.
  • Usar APIs do Wellbore DDMS para trabalhar com registros de dados de poços.

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

Pré-requisitos

Obter os detalhes da instância do Gerenciador de Dados de Energia do Azure

A primeira etapa é obter as seguintes informações da instância do Gerenciador de Dados de Energia do Azure no portal do Azure:

Parâmetro Valor Exemplo
client_id ID do aplicativo (cliente) 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx
client_secret Segredos do cliente _fl******************
tenant_id ID do Diretório (locatário) 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx
base_url URL https://<instance>.energy.azure.com
data-partition-id Partições de dados <data-partition-name>

Você usará essa informação mais adiante neste tutorial.

Configurar o Postman

  1. Baixe e instale o aplicativo da área de trabalho Postman.

  2. Importe os seguintes arquivos para o Postman:

    Para importar os arquivos:

    1. Selecione Importar no Postman.

      Screenshot that shows the Import button in Postman.

    2. Cole a URL de cada arquivo na caixa de pesquisa.

      Screenshot that shows importing collection and environment files in Postman via URL.

  3. No ambiente Postman, atualize o Valor atual com as informações dos detalhes da instância do Gerenciador de Dados do Microsoft Azure para Energia:

    1. No Postman, no menu à esquerda, selecione Ambientes e, em seguida, selecione Ambiente do Wellbore DDMS.

    2. Na coluna Valor atual, insira as informações da tabela na seção Obter detalhes da instância do Gerenciador de Dados do Microsoft Azure para Energia deste tutorial.

    Screenshot that shows where to enter current values in the Wellbore DDMS environment.

Enviar uma solicitação de exemplo do Postman

A coleção do Postman para Wellbore DDMS contém solicitações que você pode usar para interagir com dados sobre poços, perfurações de poço, logs de poços e trajetória bem em sua instância do Gerenciador de Dados do Microsoft Azure para Energia.

  1. No Postman, no menu à esquerda, selecione Coleções e selecione Wellbore DDMS. Em Configuração, selecione Obter um Token SPN.

  2. Na lista suspensa do ambiente no canto superior direito, selecione Ambiente do Wellbore DDMS.

    Screenshot that shows selections for getting an SPN token and choosing an environment.

  3. Para enviar a solicitação, selecione Enviar.

    Screenshot that shows the Send button for a request in Postman.

  4. A solicitação valida o código de resposta da API real em relação ao código de resposta esperado. Selecione a guia Resultados de Teste para ver se a solicitação foi bem-sucedida ou falhou.

    Aqui está um exemplo de uma chamada bem-sucedida do Postman:

    Screenshot that shows success for a Postman call.

    Aqui está um exemplo de uma chamada do Postman com falha:

    Screenshot that shows failure for a Postman call.

Usar APIs do Wellbore DDMS para trabalhar com registros de dados de poços

A conclusão com êxito das solicitações do Postman descritas nas APIs do Wellbore DDMS a seguir indica o sucesso da ingestão e da recuperação de registros de poços na instância de versão prévia do Wellbore DDMS do Azure Data Manager for Energy.

Crie uma marca legal que é adicionada automaticamente ao ambiente do Wellbore DDMS para conformidade de dados.

API: Configuração>Criar marca legal para WDMS

Método: POST

Screenshot that shows the API that creates a legal tag.

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

Criar um registro de poço

Crie um registro de poço na instância de versão prévia do Azure Data Manager for Energy.

API: Poço>Criar Poço

Método: POST

Screenshot that shows the API that creates a well record.

Obter um registro de poço

Obtenha os dados de registro de poço da instância da versão prévia do Azure Data Manager for Energy.

API: Poço>Poço pela ID

Método: GET

Screenshot that shows the API that gets a well record by ID.

Obter versões de poço

Obtenha as versões de cada registro de poço ingerido na instância de versão prévia do Azure Data Manager for Energy.

API: Poço>Versões do Poço

Método: GET

Screenshot that shows the API that gets all well versions.

Obter uma versão de poço específica

Obtenha os detalhes de uma versão específica de um registro de poço específico na instância da versão prévia do Azure Data Manager for Energy.

API: Poço>Versão Específica do Poço

Método: GET

Screenshot that shows the API that gets a specific well version.

Excluir um registro de poço

Exclua um registro de poço específico da instância da versão prévia do Azure Data Manager for Energy.

API: Limpar>Registro de Poço

Método: DELETE

Screenshot that shows the API that deletes a well record.

Próxima etapa

Leia o tutorial a seguir para saber como usar a ferramenta de linha de comando sdutil para carregar dados sísmicos no Repositório Sísmico:

Tutorial: Usar o sdutil para carregar dados no Repositório Sísmico