Criar uma tabela externa com o assistente de IU web do Azure Data Explorer
Uma tabela externa é uma entidade de esquema que referencia dados armazenados fora da base de dados do Azure Data Explorer. A IU do Azure Data Explorer Web pode criar tabelas externas ao tirar ficheiros de exemplo de um contentor de armazenamento e criar esquemas com base nestes exemplos. Em seguida, pode analisar e consultar dados em tabelas externas sem ingestão no Azure Data Explorer. Para obter uma breve descrição geral, veja tabelas externas. Para obter informações sobre diferentes formas de criar tabelas externas, veja Criar e alterar tabelas externas do Armazenamento do Microsoft Azure. Este artigo mostra-lhe como criar uma tabela externa com a experiência do assistente de criação.
Pré-requisitos
- Uma subscrição do Azure. Crie uma conta gratuita do Azure.
- Um cluster e uma base de dados do Azure Data Explorer. Criar um cluster e uma base de dados.
- Inicie sessão na IU da Web do Azure Data Explorer e adicione uma ligação ao cluster.
Criar uma tabela externa
No menu esquerdo, 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 o separador Destino selecionado.
Separador Destino
- Os campos Cluster e Base de Dados são pré-preenchidos. Pode selecionar um destino diferente no menu pendente.
- Em Nome da tabela, introduza um nome para a sua tabela.
Dica
Os nomes das tabelas podem ter até 1024 carateres, incluindo alfanuméricos, hífenes e carateres de sublinhado. Os carateres especiais não são suportados.
- Selecione Seguinte: Origem
Separador Origem
Em Ligar a contentores, existem duas formas de adicionar um contentor: Adicionar um contentor com o botão Selecionar contentor e Adicionar um contentor com o botão Adicionar URL ou Adicionar contentor.
Pode adicionar até 10 contentores de origem.
Adicionar um contentor com o botão Selecionar contentor
Selecione Selecionar contentor.
Escolha a subscrição e a conta de armazenamento relevantes associadas ao contentor.
Selecione o botão Adicionar . Quando a verificação estiver concluída, será apresentada uma verificação verde à direita da ligação do contentor.
Adicionar um contentor com o botão Adicionar URL ou Adicionar contentor
Selecione o botão Adicionar URL ou Adicionar contentor .
Introduza uma cadeia de ligação de armazenamento no contentor de origem com permissões de leitura e lista. Quando a verificação estiver concluída, será apresentada uma verificação verde à direita da ligação do contentor.
Filtros de ficheiros
Utilize filtros de ficheiro para filtrar os ficheiros que a tabela deve incluir. Os ficheiros podem ser filtrados de acordo com o caminho da pasta, o ficheiro começa com ou a extensão de ficheiro.
Ficheiro de definição de esquema
O primeiro contentor de origem apresentará os ficheiros abaixo dos Filtros de ficheiros.
- Selecione o ficheiro que define o esquema ao selecionar o círculo à esquerda do ficheiro. Este ficheiro será utilizado para gerar o esquema da tabela.
- Selecione Seguinte: esquema. O separador Esquema é aberto.
Separador Esquema
No lado direito do separador, pode pré-visualizar os seus dados. No lado esquerdo, pode adicionar partições às definições da tabela para aceder mais rapidamente aos dados de origem e obter um melhor desempenho.
Nota
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 mais tarde , se necessário. Algumas funcionalidades, como eliminar a última coluna em ficheiros CSV ou alterar nomes de colunas em ficheiros JSON, requerem mapeamentos para funcionar corretamente.
Selecione Adicionar partição.
A janela de partição é aberta. Uma partição é definida através de um subcaminho do ficheiro, que pode ser alterado com o campo prefixo Caminho . Para cada partição que pretende aplicar, preencha os campos da seguinte forma:
Campo Descrição Obrigatório/Opcional Nome da partição Utilizado para identificação da partição. O nome pode ser arbitrário. Necessário Tipo O tipo de dados da coluna de criação de partições de dados. Necessário Coluna de dados A coluna utilizada para a criação de partições. Partição de colunas virtuais de acordo com o caminho do URL. Necessário Função A função aplicada à coluna de dados utilizada para a criação de partições. Opcional Argumento da função Argumento a ser utilizado na função de partição. Necessário se a função for utilizada. Prefixo de caminho O subcaminho do ficheiro no qual a criação de partições está definida. Este prefixo altera o URL da tabela externa, conforme visto na caixa de pré-visualização do Uri , e deve corresponder ao URI do ficheiro que define o esquema. Opcional Padrão datetime Formato da data que será utilizado para construir o caminho do URI da tabela. Opcional 
Por exemplo, o nome da partição CustomerName sugere que o valor para particionar por está na parte do nome do cliente do URL. O exemplo acima declarou duas partições: uma partição sobre o nome do cliente e uma partição sobre a data incorporada no URL.
Nota
As colunas virtuais são apresentadas como parte do esquema como dados de colunas extraídos do caminho do ficheiro e estes dados podem ser utilizados posteriormente em consultas.
Selecione Adicionar partição para adicionar outra partição.
Selecione Guardar. As partições que adicionou aparecem agora na lista de Partições no painel esquerdo. As colunas particionadas não podem ser alteradas na pré-visualização.
Selecione Seguinte: Criar tabela. Quando a tabela é criada, é aberta uma janela Externa criada com êxito .
Para ver o comando utilizado para criar a tabela, selecione Ver comando.
Para anular a criação da tabela externa, selecione Ferramentas>Anular.
Consultar a tabela externa
A tabela resultante inclui dados de todos os ficheiros que se adequam aos critérios definidos acima. Pode consultar esta tabela com a external_table() função . Para obter mais informações sobre como consultar tabelas externas, veja Consultar uma tabela externa.
