Compartilhar via

Tutorial: Executar ingestão de arquivo baseada em manifesto

  • Artigo

A ingestão de manifesto fornece a capacidade de ingerir manifestos em uma instância do Gerenciador de Dados do Azure para Energia.

Neste tutorial, você aprenderá a:

  • Ingerir manifestos de amostra em uma instância do Gerenciador de Dados do Azure para Energia usando o Postman.
  • Pesquisar registros de metadados de armazenamento criados durante a ingestão de manifesto usando o Postman.

Pré-requisitos

Antes de iniciar este tutorial, conclua os seguintes pré-requisitos.

Obter detalhes para a instância do Gerenciador de Dados do Azure para Energia

  • Como excluir uma instância do Gerenciador de Dados do Azure para Energia. Se você ainda não tiver um, crie um seguindo as etapas no Início Rápido: Criar uma instância do Gerenciador de Dados do Azure para Energia.

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

    Parâmetro Valor a ser usado Exemplo Onde encontrar esse valor
    CLIENT_ID ID do aplicativo (cliente) 00001111-aaaa-2222-bbbb-3333cccc4444 Você usa essa ID de aplicativo ou cliente ao registrar o aplicativo na plataforma de identidade da Microsoft. Consulte Registrar um aplicativo.
    CLIENT_SECRET Segredos do cliente _fl****************** Às vezes chamado de senha do aplicativo, um segredo do cliente é um valor de cadeia de caracteres que seu aplicativo pode usar no lugar de um certificado para se identificar. Confira Adicionar um segredo do cliente.
    TENANT_ID ID do Diretório (locatário) 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx Passe o mouse sobre o nome da sua conta no portal do Azure para obter o diretório ou a ID do locatário. Como alternativa, pesquise e selecione Microsoft Entra ID>Propriedades>ID do locatário no portal do Azure.
    SCOPE ID do aplicativo (cliente) 00001111-aaaa-2222-bbbb-3333cccc4444 Esse valor é o mesmo que o aplicativo ou a ID do cliente mencionada anteriormente.
    refresh_token Atualizar valor do token 0.ATcA01-XWHdJ0ES-qDevC6r........... Siga Como gerar um token de autenticação para criar um token de atualização e salvá-lo. Você precisa desse token de atualização mais tarde para gerar um token de usuário.
    DNS URI <instance>.energy.Azure.com Localize esse valor na página de visão geral da instância do Gerenciador de Dados do Azure para Energia.
    data-partition-id Partições de dados <instance>-<data-partition-name> Localize esse valor na página de visão geral da instância do Gerenciador de Dados do Azure para Energia.

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

Configurar o Postman e executar solicitações

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

  2. Importe os seguintes arquivos para o Postman:

    Para importar as variáveis de ambiente e coleção do Postman, siga as etapas descritas na importação de dados para o Postman.

  3. Atualize o CURRENT VALUE para o ambiente do Postman com as informações obtidas nos detalhes da instância do Gerenciador de Dados do Azure para Energia.

  4. A coleção Postman para ingestão de manifesto contém várias solicitações que você deve executar sequencialmente.

    Escolha ambiente de fluxo de trabalho de ingestão antes de disparar a coleção Postman.

    Screenshot of the Postman environment.

  5. Dispare cada solicitação selecionando o botão Enviar.

    Em cada solicitação, o Postman valida o código de resposta da API real em relação ao código de resposta esperado. Se houver alguma incompatibilidade, a seção de teste indicará falhas.

Aqui está um exemplo de uma solicitação bem-sucedida do Postman:

Screenshot of a successful Postman call.

Aqui está um exemplo de uma solicitação do Postman com falha:

Screenshot of a failed Postman call.

Ingerir manifestos de exemplo usando o Postman

Para ingerir manifestos de exemplo na instância do Gerenciador de Dados do Azure para Energia usando a coleção Postman, conclua as seguintes etapas:

  1. Obter um token de acesso de usuário - Gere o token de usuário, que será usado para autenticar outras chamadas de API.

  2. Criar uma tag legal - Crie uma tag legal que será adicionada aos dados do manifesto para fins de conformidade de dados.

  3. Obter uma URL assinada para carregar um arquivo - Obtenha o caminho da URL assinada para o qual o arquivo manifesto será carregado.

  4. Carregar um arquivo: baixe o exemplo Wellbore.csv no computador local. Pode ser qualquer tipo de arquivo, incluindo CSV, LAS ou JSON. Selecione este arquivo no Postman clicando no botão Selecionar Arquivo.

    Screenshot of uploading a manifest file.

  5. Fazer upload de metadados do arquivo - Faça upload das informações de metadados do arquivo, como local do arquivo e outros campos relevantes.

  6. Obter os metadados do arquivo - Chame para validar se os metadados foram criados com sucesso.

  7. Ingerir dados mestre, de referência e de componente de produto de trabalho (WPC): ingere os metadados de manifesto mestre, de referência e de componente de produto de trabalho (WPC).

  8. Obter o status do fluxo de trabalho de ingestão de manifesto: o fluxo de trabalho é iniciado e está no estado em execução. Continue consultando até que o estado mude para concluído (normalmente de 20 a 30 segundos).

Pesquisar dados ingeridos usando o Postman

Para pesquisar registros de metadados de armazenamento criados durante a ingestão de manifesto usando a coleção Postman, conclua as seguintes etapas:

  1. Pesquisar produtos de trabalho - Chame o serviço de pesquisa para recuperar os registros de metadados do produto de trabalho.
  2. Pesquisar componentes do produto de trabalho: chame o serviço de pesquisa para recuperar os registros de metadados do WPC.
  3. Pesquisar conjunto de dados - Chame o serviço de pesquisa para recuperar os registros de metadados do conjunto de dados.
  4. Pesquisar dados mestres - Chame o serviço de pesquisa para recuperar os registros de metadados mestres.
  5. Pesquisar dados de referência - Chame o serviço de pesquisa para recuperar os registros de metadados de referência.

Próxima etapa

Prosseguir para o próximo tutorial:

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

Para obter mais informações sobre a ingestão de manifesto, consulte o Guia de Início Rápido do Carregamento de Dados do Operador OSDU.