Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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.
- Entre no da interface do usuário da Web do
Azure Data Explorer e adicionar uma conexão ao seu cluster .
Criar uma tabela externa
No menu à esquerda, selecione Consulta.
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.
Guia Destino
- Os campos Cluster e Banco de Dados são pré-preenchidos. Você pode selecionar um destino diferente no menu de opções.
- Em Nome da tabela, insira um nome para a tabela.
Sugestão
Os nomes das tabelas podem ter até 1024 caracteres, incluindo alfanuméricos, hífenes e sublinhados. Não há suporte para caracteres especiais.
- Selecione Seguinte: Origem
Separador Origem
Em Vincular a 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é 10 contêineres de origem.
Adicionar um contêiner com o botão Selecionar contêiner
Selecione Selecionar contêiner.
Escolha a conta de assinatura e armazenamento relevante associada ao seu contêiner.
Selecione o botão Adicionar . Quando a verificação for concluída, uma verificação verde aparecerá à direita do link do contêiner.
Adicionar um contêiner com o botão Adicionar URL ou Adicionar contêiner
Selecione o botão Adicionar URL ou Adicionar contêiner .
Insira cadeias de conexão de armazenamento no contentor de origem com permissões de leitura e listagem. Quando a verificação for concluída, uma verificação verde aparecerá à direita do link do contêiner.
Filtros de ficheiros
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, o arquivo começa com ou a extensão do arquivo.
Arquivo de definição de esquema
O primeiro contêiner de origem exibirá arquivos abaixo Filtros de arquivo.
- Escolha o arquivo que define o esquema selecionando o círculo à esquerda do arquivo. Este arquivo será usado para gerar o esquema de tabela.
- Selecione Next: schema. A guia Esquema é aberta.
Guia Esquema
No lado direito do separador, pode pré-visualizar os seus dados. No lado esquerdo, você pode adicionar partições às definições da tabela para acessar os dados de origem mais rapidamente e obter um melhor desempenho.
Observação
Os mapeamentos não fazem parte da definição de uma tabela externa e não são suportados 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 colunas em arquivos JSON, exigem mapeamentos para funcionar corretamente.
Selecione Adicionar partição.
A janela da partição abre-se. Uma partição é definida sobre um subcaminho do arquivo, que pode ser alterado usando o campo Prefixo do caminho . Para cada partição que 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 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 de data que será usado para construir o caminho 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 acima declarou duas partições: uma partição sobre o nome do cliente e uma partição sobre a data incorporada na URL.
Observação
As colunas virtuais aparecem como parte do esquema como os dados das colunas extraídos do caminho do arquivo, e esses dados podem ser usados posteriormente em consultas.
Selecione Adicionar partição para adicionar outra partição.
Selecione Guardar. As partições adicionadas agora aparecem na lista de Partições no painel esquerdo. As colunas particionadas não podem ser alteradas na visualização.
Selecione Avançar: Criar tabela. Quando a tabela é criada, uma janela Tabela externa criada com êxito é aberta.
Para exibir o comando usado para criar a tabela, selecione Exibir comando.
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 acima. Você 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.
