Partilhar via


Criar atalhos do OneLake em uma base de dados KQL

OneLake é um data lake lógico único e unificado do Microsoft Fabric para armazenar lakehouses, data warehouses, 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

Para acelerar consultas sobre os atalhos do OneLake, consulte Acelerar consultas sobre atalhos do OneLake.

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

  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

O OneLake suporta atalhos tanto para recursos internos do OneLake (como bases de dados KQL, casas de lago e armazéns) como para recursos externos (como Azure Data Lake Storage, Amazon S3 ou Google Cloud Storage). Para uma lista de todos os tipos de atalhos suportados e ligações para as suas instruções de configuração específicas, veja Atalhos > OneLake Tipos de atalhos.

Os atalhos nas bases de dados KQL suportam aceleração de consultas. Para habilitar a aceleração de consulta em um novo atalho, alterne o botão Acelerar para Ativado.

Captura de ecrã da nova janela de atalhos a mostrar os detalhes do atalho. A opção Acelerar está destacada.

Nota

  1. Você só pode se conectar a uma subpasta ou tabela por atalho. Para ligar a mais dados, crie atalhos adicionais.
  2. Não pode criar um atalho sobre uma tabela que tenha um asterisco (*) em qualquer nome de coluna. Renomeie a(s) coluna(s) antes de criar o atalho.

Depois de criar um atalho, a base de dados atualiza-se automaticamente. O atalho aparece em Atalhos no painel Explorer . Agora você pode consultar esses dados.

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

Consultar os dados

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

  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 para o 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 escalar de dados 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