Partilhar via


Obter dados do OneLake

Neste artigo, você aprenderá como obter dados do OneLake em uma tabela nova ou existente.

Pré-requisitos

Copiar caminho do arquivo do Lakehouse

  1. No espaço de trabalho, selecione o ambiente Lakehouse que contém a fonte de dados que você deseja usar.

  2. Coloque o cursor sobre o ficheiro desejado e, em seguida, selecione o menu Mais (...) e, em seguida, selecione Propriedades.

    Importante

    • Não há suporte para caminhos de pasta.
    • Caracteres universais (*) não são suportados.

    Captura de ecrã do menu desdobrável de um arquivo Lakehouse. A opção intitulada Propriedades é realçada.

  3. Em URL, selecione o ícone Copiar para a área de transferência e salve-o em algum lugar para recuperar em uma etapa posterior.

    Captura de ecrã do painel Propriedades de um ficheiro Lakehouse. O ícone de cópia à direita do URL do ficheiro está realçado.

  4. Volte ao seu espaço de trabalho e selecione um banco de dados KQL.

Fonte

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

    Na janela Obter Dados, o separador de origem está selecionado.

  2. Selecione a fonte de dados na lista disponível. Neste exemplo, estás a ingerir dados do OneLake.

    Captura de ecrã da janela obter dados com o separador origem selecionado.

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. No arquivo do OneLake em, cole o caminho do ficheiro do Lakehouse que copiou em Copiar caminho do ficheiro do Lakehouse.

    Observação

    Você pode adicionar até 10 itens de até 1 GB de tamanho descompactado cada.

    Captura de tela da guia configurar com a nova tabela inserida e um caminho de arquivo OneLake adicionado.

  3. Selecione Avançar.

Inspecionar

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

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

Captura de tela da guia inspecionar.

Opcionalmente:

  • Selecione visualizador de comandos para visualizar e copiar os comandos automáticos gerados a partir de suas entradas.
  • Use o menu suspenso do arquivo de definição do esquema para alterar o arquivo do qual o esquema é inferido.
  • Altere o formato de dados que foi inferido automaticamente selecionando, a partir do menu pendente, o formato desejado. Para obter mais informações, consulte Formatos de dados suportados pelo Real-Time Intelligence.
  • Editar colunas.
  • Explore as opções avançadas baseadas 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:

  • 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

Captura de tela de colunas abertas para edição.

Mapeando transformações

Alguns mapeamentos de formato de dados (Parquet, JSON e Avro) suportam transformações simples durante a ingestão. 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:

  • Date_Hora_De_Segundos_Unix
  • 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>Primeira linha é cabeçalho de coluna.

    Captura de ecrã das opções avançadas de CSV.

JSON:

  • Para determinar a divisão de colunas dos dados JSON, selecione Avançado>níveis Aninhados, 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.

    Captura de tela das opções avançadas de JSON.

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. Você pode selecionar um cartão para consultar, soltar os dados ingeridos ou ver um painel do resumo da sua ingestão.

Captura de ecrã da página de resumo com a ingestão bem-sucedida concluída.