Partilhar via

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

  • Artigo

Use as APIs do Wellbore Domain Data Management Services (DDMS) no Postman para trabalhar com dados de poço em sua instância do Azure Data Manager for Energy.

Neste tutorial, irá aprender a:

  • Configure o Postman para usar uma coleção DDMS Wellbore.
  • Configure o Postman para usar um ambiente DDMS Wellbore.
  • Envie pedidos via Carteiro.
  • Gere um token de autorização.
  • Use as APIs DDMS da Wellbore para trabalhar com registros de dados de poços.

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

Pré-requisitos

Obtenha os detalhes da instância do Azure Data Manager for Energy

A primeira etapa é obter as seguintes informações da sua instância do Azure Data Manager for Energy no portal do Azure:

Parâmetro Valor Exemplo
client_id ID da aplicação (cliente) 00001111-aaaa-2222-bbbb-3333cccc4444
client_secret Segredos de cliente _fl******************
tenant_id ID do Diretório (inquilino) 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á essas informações mais adiante no tutorial.

Configurar o Postman

  1. Transfira e instale a aplicação de ambiente de trabalho Postman .

  2. Importe os seguintes arquivos no Postman:

    Para importar os ficheiros:

    1. Selecione Importar no Postman.

      Screenshot that shows the Import button in Postman.

    2. Cole o URL de cada ficheiro 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 Azure Data Manager for Energy:

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

    2. Na coluna Valor atual, insira as informações da tabela na seção Obter seus detalhes da instância do Azure Data Manager for Energy deste tutorial.

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

Enviar um exemplo de pedido de carteiro

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

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

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

    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 do teste para ver se a solicitação foi bem-sucedida ou falhou.

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

    Screenshot that shows success for a Postman call.

    Aqui está um exemplo de uma chamada de carteiro com falha:

    Screenshot that shows failure for a Postman call.

Use APIs DDMS Wellbore para trabalhar com registros de dados de poço

A conclusão bem-sucedida das solicitações do Postman descritas nas APIs DDMS Wellbore a seguir indica a ingestão e a recuperação bem-sucedidas de registros de poço em sua instância do Azure Data Manager for Energy.

Crie uma tag legal que é adicionada automaticamente ao seu ambiente 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, consulte Gerenciar tags legais.

Criar um registo de poço

Crie um registro de poço em sua instância do Azure Data Manager for Energy.

API: Bem Criar Bem>

Método: POST

Screenshot that shows the API that creates a well record.

Obtenha um registo de poço

Obtenha os dados de registro de poço para sua instância do Azure Data Manager for Energy.

API: Bem>Bem por ID

Método: GET

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

Obter versões bem

Obtenha as versões de cada registro de poço ingerido em sua instância do Azure Data Manager for Energy.

API: Versões Well>Well

Método: GET

Screenshot that shows the API that gets all well versions.

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

Obtenha os detalhes de uma versão específica para um registro de poço específico em sua instância do Azure Data Manager for Energy.

API: Versão bem>específica

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 sua instância 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óximo passo

Leia o tutorial a seguir para saber como usar a ferramenta de linha de comando sdutil para carregar dados sísmicos no Seismic Store:

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