Obter dados do arquivo

Neste artigo, você aprenderá como obter dados de um arquivo local em uma tabela nova ou existente.

Pré-requisitos

• Um espaço de trabalho com uma capacidade de habilitada para Microsoft Fabric
• Um banco de dados KQL com permissões de edição

Fonte

1. Na faixa de opções inferior do banco de dados KQL, selecione Obter dados .

   Na janela Obter Dados, o separador Origem está selecionado.

2. Selecione a fonte de dados na lista disponível. Neste exemplo, está a ingerir dados de Local file.

   

Configurar

1. Selecione uma tabela de destino. Se pretender ingerir dados numa nova tabela, selecione + Nova tabela e introduza um nome de tabela.

   Observação

   Os nomes das tabelas podem ter até 1024 caracteres, incluindo espaços, alfanuméricos, hífenes e sublinhados. Não há suporte para caracteres especiais.

2. Arraste os ficheiros para a janela ou selecione Procurar ficheiros .

   Observação

   Você pode adicionar até 1.000 arquivos. Cada ficheiro pode ter um máximo de 1 GB descomprimido.

   

3. Selecione Próximo

Inspecionar

A guia Inspecionar abre-se com uma pré-visualização dos dados.

Para concluir o processo de ingestão, selecione Concluir.

Opcionalmente:

• Selecione visualizador de comandos para visualizar e copiar os comandos automáticos gerados a partir de suas entradas.
• Use a lista suspensa do arquivo de definição de esquema para alterar o arquivo do qual o esquema é inferido.
• Altere o formato de dados inferido automaticamente selecionando o formato desejado na lista suspensa. Para obter mais informações, consulte Formatos de dados suportados pelo Real-Time Intelligence.
• Editar colunas.
• Explore opções avançadas com base no tipo de dados.

Editar colunas

Observação

• Para formatos tabulares (CSV, TSV, PSV), não é possível mapear uma coluna duas vezes. Para mapear para uma coluna existente, primeiro exclua a nova coluna.
• Não é possível alterar um tipo de coluna existente. Se você tentar mapear para uma coluna com um formato diferente, você pode acabar com colunas vazias.

As alterações que você pode fazer em uma tabela dependem dos seguintes parâmetros:

• O tipo de tabela é novo ou existente
• O tipo de mapeamento é novo ou existente

Tipo de tabela	Tipo de mapeamento	Ajustes disponíveis
Nova tabela	Novo mapeamento	Renomear coluna, alterar tipo de dados, alterar fonte de dados, transformação de mapeamento , adicionar coluna, eliminar coluna
Tabela existente	Novo mapeamento	Adicionar coluna (na qual você pode alterar o tipo de dados, renomear e atualizar)
Tabela existente	Mapeamento existente	nenhum

Mapeando transformações

Alguns mapeamentos de formato de dados (Parquet, JSON e Avro) suportam transformações simples em tempo de ingestão de dados. Para aplicar transformações de mapeamento, crie ou atualize uma coluna na janela Editar colunas.

As transformações de mapeamento podem ser executadas em uma coluna do tipo string ou datetime, com a fonte tendo o tipo de dados int ou long. As transformações de mapeamento suportadas são:

• DateTimeFromUnixSeconds
• DateTimeFromUnixMilliseconds
• DateTimeFromUnixMicroseconds
• DateTimeFromUnixNanoseconds

Opções avançadas com base no tipo de dados

Tabela (CSV, TSV, PSV):

• Se estiveres a ingerir formatos tabulares numa tabela existente, podes selecionar Avançado - Manter esquema de tabela>. Os dados tabulares não incluem necessariamente os nomes das colunas usadas para mapear os dados de origem para as colunas existentes. Quando essa opção é marcada, o mapeamento é feito por ordem e o esquema da tabela permanece o mesmo. Se essa opção estiver desmarcada, novas colunas serão criadas para os dados de entrada, independentemente da estrutura dos dados.

• Para usar a primeira linha como nomes de coluna, selecione Avançado>A primeira linha é o cabeçalho da coluna.

  

JSON:

• Para determinar a divisão de colunas dos dados JSON, selecione níveis Aninhados Avançados>, de 1 a 100.

• Se você selecionar Avançado>Ignorar linhas JSON com erros, os dados serão ingeridos no formato JSON. Se você deixar essa caixa de seleção desmarcada, os dados serão ingeridos no formato multijson.

  

Resumo

Na janela de preparação de dados, todas as três etapas são marcadas com marcas de seleção verdes quando a ingestão de dados é concluída com êxito. Pode selecionar um item para consultar, eliminar os dados ingeridos ou ver um painel com o resumo da ingestão de dados.

Conteúdo relacionado

• Para gerenciar seu banco de dados, consulte Gerenciar dados
• Para criar, armazenar e exportar consultas, consulte Consultar dados em um conjunto de consultas KQL