Partilhar via

Criar atalhos do OneLake em um banco de dados KQL

  • Artigo

O OneLake é um data lake lógico único e unificado para o Microsoft Fabric armazenar lakehouses, armazéns, bancos de dados KQL e outros itens. Os atalhos são referências incorporadas no OneLake que apontam para locais de armazenamento de outros arquivos sem mover os dados originais. A referência incorporada faz parecer que os arquivos e pastas são armazenados localmente, mas na realidade; eles existem em outro local de armazenamento. Os atalhos podem ser atualizados ou removidos dos itens, mas essas alterações não afetam os dados originais e sua origem.

Neste artigo, você aprenderá a criar um atalho OneLake em um banco de dados KQL que aponta para malha interna ou fontes externas. Esse tipo de atalho é acessado posteriormente para consulta em conjuntos de consultas KQL usando a external_table() função. Os atalhos criados em um banco de dados KQL não podem ser renomeados e apenas um atalho pode ser criado de cada vez.

Além de criar atalhos a partir de um banco de dados KQL, os atalhos também podem ser criados a partir de outros itens do Fabric. Esses atalhos também apontam para dados armazenados no Fabric interno ou em fontes externas, mas têm limitações diferentes e são acessados de forma diferente. Para obter mais informações, consulte Atalhos do OneLake.

Nota

Use os atalhos do OneLake quando quiser executar consultas com pouca frequência em dados históricos sem particionar ou indexar os dados. Se você quiser executar consultas com frequência e acelerar o desempenho, importe os dados diretamente para seu banco de dados KQL.

Selecione a guia que corresponde ao atalho que você deseja criar:

Pré-requisitos

Para acessar os dados em seu banco de dados KQL em outras experiências do Microsoft Fabric, consulte Uma cópia lógica.

Criar atalho

Nota

O fluxo a seguir mostra como criar um atalho que aponta para dados em um Lakehouse no Fabric. Da mesma forma, você pode criar atalhos que apontam para Data Warehouses ou outros bancos de dados KQL.

  1. Navegue até um banco de dados KQL existente.

  2. Selecione Novo>atalho do OneLake.

    Captura de ecrã do separador Base a mostrar a lista pendente do botão Novo. A opção intitulada Atalho OneLake é realçada.

Selecione uma fonte

  1. Em Fontes internas, selecione Microsoft OneLake.

    Captura de tela da janela Novo atalho mostrando os dois métodos para criar um atalho. A opção intitulada OneLake é destacada.

  2. Selecione a fonte de dados à qual deseja se conectar e selecione Avançar.

    Captura de tela da janela Selecione um tipo de fonte de dados mostrando as fontes de dados disponíveis para usar com o atalho. O botão Avançar é realçado.

  3. Expanda Tabelas e selecione uma tabela específica à qual se conectar.

    Captura de tela da janela de atalho Novo mostrando os dados na LakeHouse. A subpasta intitulada StrmSC e o botão Criar são realçados.

  4. Selecione Criar.

Nota

Você só pode se conectar a uma subpasta ou tabela por atalho. Para se conectar a mais dados, repita essas etapas e crie atalhos adicionais.

O banco de dados é atualizado automaticamente. O atalho aparece em Atalhos no painel Explorer .

Captura de ecrã do painel Explorador a mostrar o novo atalho.

O atalho OneLake foi criado. Agora você pode consultar esses dados.

Consultar os dados

Para consultar dados do atalho OneLake, use a external_table() função.

  1. No lado direito do banco de dados, selecione Explorar seus dados. A janela é aberta com alguns exemplos de consultas que você pode executar para obter uma visão inicial dos seus dados.
  2. Substitua o espaço reservado do nome da tabela pelo external_table('nome') do atalho.
  3. Selecione Executar ou pressione Shift + Enter para executar uma consulta selecionada.

Captura de ecrã da janela Explorar os seus dados mostrando os resultados de uma consulta de exemplo.

Mapeamento de tipos de dados

Mapeamento de tipos de dados Delta parquet para Eventhouse

Os tipos de dados primitivos delta são mapeados para tipos de dados escalares do Eventhouse usando as seguintes regras. Para obter mais informações sobre tipos de dados do Eventhouse, consulte Tipos de dados escalares.

Tipo Delta Tipo de dados escalar do Eventhouse
string string
long long
integer int
short int
byte real
float real
double real
decimal decimal
boolean bool
binary string
date datetime
timestamp_ntz (sem fuso horário) datetime
struct dynamic
array dynamic
map dynamic

Conteúdos relacionados