Compartilhar via

Tutorial: realizar ingestão do analisador CSV

  • Artigo

A ingestão do Analisador CSV (valores separados por vírgula) oferece a capacidade de ingerir arquivos CSV em uma instância do Gerenciador de Dados do Azure para Energia.

Neste tutorial, você aprenderá a:

  • Ingerir um arquivo CSV de dados de poços de amostra na instância do Gerenciador de Dados do Azure para Energia usando o Postman.
  • Pesquise registros de metadados de armazenamento criados durante a ingestão de CSV 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 do 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 do analisador CSV contém 10 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 dados de poços usando o Postman

Para ingerir arquivo CSV de dados de poços de amostra 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 à API.

  2. Criar um esquema: gere um esquema que adere às colunas presentes no arquivo CSV.

  3. Obter detalhes do esquema: obtenha o esquema criado na etapa anterior e o valida.

  4. Criar uma tag legal: crie uma tag legal que será adicionada aos dados do CSV para fins de conformidade de dados.

  5. Obter um URL assinado para fazer upload de um arquivo CSV: obtenha o caminho do URL assinado no qual o arquivo CSV será carregado.

  6. Fazer upload de um arquivo CSV: baixe a amostra Wellbore.csv para sua máquina local e selecione esse arquivo no Postman clicando no botão Selecionar arquivo.

    Screenshot of uploading a CSV file.

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

  8. Criar um fluxo de trabalho de ingestão de analisador CSV: crie o DAG (grafo direcionado acíclico) para o fluxo de trabalho de ingestão do analisador CSV.

  9. Acionar um fluxo de trabalho de ingestão do analisador CSV: acione o DAG do fluxo de trabalho de ingestão do analisador CSV.

  10. Procurar o status do fluxo de trabalho de ingestão do analisador CSV ingerido: obtenha o status da execução do DAG do analisador CSV.

Pesquisar dados ingeridos dos poços usando o Postman

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

  • Pesquisar registros CSV ingeridos: pesquise os registros CSV criados anteriormente.

    Screenshot of searching ingested CSV records.

Próxima etapa

Prosseguir para o próximo tutorial:

Tutorial: executar ingestão de arquivo baseada em manifesto