Criar uma tabela externa usando o assistente de interface do usuário da Web do Azure Data Explorer

  • Artigo

Uma tabela externa é uma entidade de esquema que faz referência a dados armazenados fora do banco de dados do Azure Data Explorer. A interface do usuário da Web do Azure Data Explorer pode criar tabelas externas, coletando arquivos de exemplo de um contêiner de armazenamento e criando um esquema com base nesses exemplos. Então, você poderá analisar e consultar os dados nas tabelas externas sem ingestão no Azure Data Explorer. Para obter uma breve visão geral, consulte tabelas externas. Para obter mais informações sobre as diferentes maneiras de criar tabelas externas, confira Criar e alterar tabelas externas do Armazenamento do Azure. Este artigo mostra como criar uma tabela externa usando a experiência do assistente de criação.

Pré-requisitos

Criar uma tabela externa

  1. No menu esquerdo, selecione Consulta.

  2. Clique com o botão direito do mouse no banco de dados em que você deseja criar a tabela externa. Selecione Criar tabela externa.

    Captura de tela da opção para criar uma tabela externa na página de consulta.

A janela Criar tabela externa é aberta com a guia Destino selecionada.

Guia Destino

  1. Os campos Cluster e Banco de dados já vêm preenchidos. Você pode selecionar um destino diferente no menu suspenso.
  2. Em Nome da tabela, insira um nome para a tabela.

    Dica

    Os nomes de tabelas podem ter até 1.024 caracteres, incluindo caracteres alfanuméricos, hifens e sublinhados. Não há suporte para caracteres especiais.

  3. Selecione Avançar: origem

Captura de tela da guia Destino com os campos Cluster, Banco de Dados e Nome da Tabela.

Guia Origem

Em Link para contêineres, há duas maneiras de adicionar um contêiner: Adicionar um contêiner com o botão Selecionar contêiner e Adicionar um contêiner com o botão Adicionar URL ou Adicionar contêiner.

Você pode adicionar até dez contêineres de origem.

Adicionar um contêiner com o botão Selecionar contêiner

  1. Selecione Selecionar contêiner.

    Captura de tela do botão Selecionar contêiner na guia Origem.

  2. Escolha a assinatura e a conta de armazenamento relevantes associadas ao contêiner.

    Captura de tela da janela selecionar contêiner.

  3. Selecione o botão Adicionar. Quando a verificação for concluída, um sinal de verificação verde será exibido à direita do link do contêiner.

    Captura de tela do link do contêiner verificado.

Adicionar um contêiner com o botão Adicionar URL ou Adicionar contêiner

  1. Selecione o botão Adicionar URL ou Adicionar contêiner.

    Captura de tela do botão Adicionar URL.

  2. Insira uma cadeia de conexão de armazenamento para o contêiner de origem com permissões de leitura e lista. Quando a verificação for concluída, um sinal de verificação verde será exibido à direita do link do contêiner.

    Captura de tela da adição da URL da SAS.

Filtros de arquivos

Use Filtros de arquivo para filtrar os arquivos que a tabela deve incluir. Os arquivos podem ser filtrados de acordo com o caminho da pasta, com o começo do nome ou com a extensão do arquivo.

Captura de tela da seleção do arquivo de definição de esquema.

Arquivo que define o esquema

O primeiro contêiner de origem exibirá arquivos abaixo dos Filtros de arquivo.

Captura de tela da guia Criar tabela externa de origem no Azure Data Explorer.

  1. Escolha o arquivo de definição de esquema selecionando o círculo à esquerda do arquivo. Esse arquivo será usado para gerar o esquema de tabela.
  2. Selecione Avançar: esquema. A guia esquema é aberta.

Guia Esquema

No lado direito da guia, você pode visualizar seus dados. No lado esquerdo, você pode adicionar partições às definições de tabela para acessar os dados de origem mais rapidamente e obter um melhor desempenho.

Observação

Mapeamentos não fazem parte da definição de uma tabela externa e não têm suporte neste assistente. Os mapeamentos podem ser configurados posteriormente, se necessário. Algumas funcionalidades, como excluir a última coluna em arquivos CSV ou alterar nomes de coluna em arquivos JSON, exigem mapeamentos para funcionar corretamente.

  1. Selecione Adicionar partição.

    Captura de tela do arquivo de exibição da tabela externa no Azure Data Explorer.

  2. A janela Partição é aberta. Uma partição é definida em um subcaminho do arquivo, que pode ser alterado usando o campo Prefixo do caminho. Para cada partição que você deseja aplicar, preencha os campos da seguinte forma:

    Campo Descrição Obrigatório/Opcional
    Nome da partição Usado para identificação da partição. O nome pode ser arbitrário. Obrigatório
    Type Tipo de dados da coluna de particionamento de dados. Obrigatório
    Coluna de dados Coluna usada para particionamento. Partição de colunas virtuais de acordo com o caminho da URL. Obrigatório
    Função Função aplicada à coluna de dados usada para particionamento. Opcional
    Argumento da função Argumento a ser usado na função de partição. Necessário se a função for usada.
    Prefixo do caminho Subcaminho do arquivo em que o particionamento está definido. Esse prefixo altera a URL da tabela externa, conforme visto na caixa Visualização do URI, e deve corresponder ao URI do arquivo que define o esquema. Opcional
    Padrão datetime Formato de data que será usado para construir o caminho do URI da tabela. Opcional

    Captura de tela que mostra a adição de partições à tabela externa no Azure Data Explorer.

    Por exemplo, o nome da partição CustomerName sugere que o valor pelo qual particionar está na parte nome do cliente da URL. O exemplo acima declarou duas partições: uma partição sobre o nome do cliente e outra sobre a data inserida na URL.

    Observação

    As colunas virtuais aparecem como parte do esquema como os dados de colunas extraídos do caminho do arquivo e esses dados podem ser usados posteriormente em consultas.

  3. Selecione Adicionar partição para adicionar outra partição.

  4. Selecione Salvar. As partições que você adicionou agora aparecem na lista de Partições no painel esquerdo. As colunas particionadas não podem ser alteradas na versão prévia.

    Captura de tela da tabela externa do esquema do Azure Data Explorer.

  5. Selecione Avançar: Criar tabela. Quando a tabela é criada, a janela Tabela externa criada com sucesso é exibida.

  6. Para exibir o comando usado para criar a tabela, selecione Exibir comando.

    Captura de tela que mostra a criação bem-sucedida da tabela externa no Azure Data Explorer.

  7. Para desfazer a criação da tabela externa, selecione Ferramentas>Desfazer.

Consultar a tabela externa

A tabela resultante inclui dados de todos os arquivos que se ajustam aos critérios definidos acima. Você pode consultar essa tabela usando a função external_table(). Para obter mais informações sobre como consultar tabelas externas, confira Consultando uma tabela externa.

Captura de tela que mostra a saída da consulta à tabela externa no Azure Data Explorer.

Conteúdo relacionado