Criar uma tabela externa usando o assistente de 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 pegando arquivos de exemplo de um contêiner de armazenamento e criando esquema com base nesses exemplos. Em seguida, você pode analisar e consultar dados em tabelas externas sem ingestão no Azure Data Explorer. Para uma breve visão geral, consulte tabelas externas. Para obter informações sobre diferentes maneiras de criar tabelas externas, consulte 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. Crie uma conta do Azure gratuita.
• Um cluster e um banco de dados do Azure Data Explorer. Crie um cluster e um banco de dados.
• Inicie sessão na interface web do Azure Data Explorer e adicione uma conexão ao seu cluster.

Criar uma tabela externa

1. No menu à esquerda, selecione Consulta.

2. Clique com o botão direito do rato na base de dados onde pretende 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 são pré-preenchidos. Pode selecionar um destino diferente no menu suspenso.
2. Em Nome da tabela, insira um nome para a tabela.

   Sugestão

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

3. Selecione Next: Source.

Separador Origem

Em Link to containers, pode adicionar um contentor de duas formas: adicionar um contentor com o botão Select container e adicionar um container com o botão Adicionar URL ou Add container.

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

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

1. Selecione Selecionar contêiner.

   

2. Escolha a subscrição e a conta de armazenamento que o seu contentor utiliza.

   

3. Selecione Adicionar. Quando a verificação termina, aparece um check verde à direita do link do contentor.

   

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 no contentor de origem com permissões de leitura e listagem. Quando a verificação termina, aparece uma marca de verificação verde à direita do link do contenedor.

   

Filtros de ficheiros

Use filtros de arquivo para filtrar os arquivos que a tabela deve incluir. Podes filtrar ficheiros por caminho de pasta, início de ficheiro com ou extensão de ficheiro.

Arquivo de definição de esquema

O primeiro contentor de origem apresenta ficheiros abaixo de Filtros de Ficheiros.

1. Escolha o arquivo que define o esquema selecionando o círculo à esquerda do arquivo. Este ficheiro é usado para gerar o esquema da tabela.
2. Selecione Next: schema. A guia Esquema é aberta.

Guia Esquema

No lado direito do separador, pode pré-visualizar os seus dados. No lado esquerdo, pode adicionar partições às definições das suas tabelas para aceder mais rapidamente aos dados de origem e obter melhor desempenho.

1. Selecione Adicionar partição.

   

2. A janela da partição abre-se. Uma partição é definida sobre um subcaminho do ficheiro, que pode alterar usando o campo de prefixo de caminho . Para cada partição que pretende 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
   Tipo	O tipo de dados da coluna de particionamento de dados.	Obrigatório
   Coluna de dados	A coluna usada para particionamento. Partição de colunas virtuais de acordo com o caminho da URL.	Obrigatório
   Função	A função aplicada à coluna de dados usada para particionamento.	Opcional
   Argumento da função	Argumento a ser usado na função de partição.	Obrigatório se a função for usada.
   Prefixo do caminho	O subcaminho do arquivo no qual o particionamento é definido. Esse prefixo altera a URL da tabela externa, como visto na caixa de visualização de Uri , e deve corresponder ao URI do arquivo que define o esquema.	Opcional
   padrão de data e hora	Formato da data que usas para construir o caminho do URI da tabela.	Opcional

   

   Por exemplo, o nome da partição CustomerName sugere que o valor de particionamento está na parte do nome do cliente da URL. O exemplo anterior declara duas partições: uma partição sobre o nome do cliente e outra sobre a data embutida na URL.

   Observação

   Colunas virtuais aparecem como parte do esquema como dados das colunas extraídos do caminho do ficheiro, e podes usar esses dados mais tarde em consultas.

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

4. Selecione Guardar. As partições adicionadas agora aparecem na lista de Partições no painel esquerdo. Não podes alterar colunas particionadas no Preview.

   

5. Selecione Avançar: Criar tabela. Quando crias a tabela, abre-se uma janela Tabela Externa criada com sucesso.

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 ficheiros que se enquadram nos critérios que definiste. Pode consultar esta tabela usando a external_table() função. Para obter mais informações sobre como consultar tabelas externas, consulte Consultando uma tabela externa.

Conteúdo relacionado

• Visão geral de tabelas externas
• Criar e alterar tabelas externas do Armazenamento do Azure
• Função external_table()
• Tutorial: Aprenda operadores comuns