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

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 o assistente de criação.

Pré-requisitos

• Uma assinatura do Azure. Criar uma conta gratuita do Azure.
• Um cluster e um banco de dados do Azure Data Explorer. Criar um cluster e um banco de dados.
• Entre na interface do usuário da Web do Azure Data Explorer e adicione uma conexão ao cluster.

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 deseja criar a tabela externa. Selecione Criar tabela externa.

   

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

Aba 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 tabela podem ter até 1.024 caracteres, incluindo alfanuméricos, hifens e sublinhados. Não há suporte para caracteres especiais.

3. Selecione Avançar: Fonte.

Aba de Origem

No Link para contêineres, você pode adicionar um contêiner de duas maneiras: 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.

   

2. Escolha a assinatura e a conta de armazenamento que o contêiner usa.

   

3. Selecione Adicionar. Quando a verificação é concluída, uma verificação verde aparece à direita do link do contêiner.

   

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.

   

2. Insira cadeias de conexão de armazenamento para o contêiner de origem com permissões de leitura e lista. Quando a verificação é concluída, uma verificação verde aparece à direita do link do contêiner.

   

Filtros de arquivos

Use Filtros de arquivo para filtrar os arquivos que a tabela deve incluir. Você pode filtrar arquivos por caminho de pasta, arquivo começa com ou extensão de arquivo.

Arquivo que define o esquema

O primeiro contêiner de origem exibe arquivos abaixo dos filtros de arquivo.

1. Escolha o arquivo de definição de esquema selecionando o círculo à esquerda do arquivo. Esse arquivo é usado para gerar o esquema de tabela.
2. Selecione Próximo: esquema. A aba Esquema é aberta.

Aba 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.

1. Selecione Adicionar partição.

   

2. A janela de partição se abre. Uma partição é definida em um subcaminho do arquivo, que pode ser alterado usando o campo prefixo Path . Para cada partição que você deseja aplicar, preencha os campos da seguinte maneira:

   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
   Tipo	Tipo de dados da coluna de particionamento de dados.	Obrigatório
   Coluna de dados	A coluna usada para o 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 de data e hora	Formato de data que você usa para construir o caminho do URI da tabela.	Opcional

   

   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 anterior declara duas partições: uma partição sobre o nome do cliente e uma partição 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 você pode usar esses dados 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. Não é possível alterar colunas particionadas na visualização.

   

5. Selecione Avançar: Criar tabela. Quando você cria a tabela, uma janela de "Tabela externa criada com sucesso" é aberta.

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

   

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 encaixam nos critérios definidos. Você pode consultar essa tabela usando a external_table() função. Para obter mais informações sobre como consultar tabelas externas, confira Consultando uma tabela externa.

Conteúdo relacionado

• Visão geral das tabelas externas
• Criar e alterar tabelas externas do Armazenamento do Microsoft Azure
• função external_table()
• Tutorial: aprender operadores comuns