Compartilhar via


Criar atalhos do OneLake em um banco de dados KQL

O OneLake é um data lake lógico único e unificado para o Microsoft Fabric armazenar lakehouses, warehouses, bancos de dados KQL e outros itens. Atalhos são referências inseridas no OneLake que apontam para locais de armazenamento de outros arquivos sem mover os dados originais. A referência embutida 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 seus itens, mas essas alterações não afetam os dados originais e sua fonte.

Neste artigo, você aprenderá a criar um atalho do OneLake em um banco de dados KQL que aponta para fontes internas ou externas do Fabric. 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 por 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 em fontes internas ou externas do Fabric, mas têm limitações diferentes e são acessados de forma diferente. Para obter mais informações, consulte Atalhos do OneLake.

Observação

Para acelerar consultas em atalhos do OneLake, consulte Acelerar consultas em 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 tela de uma guia Página Inicial mostrando a lista suspensa do botão Novo. A opção Atalho do OneLake está realçada.

Selecionar uma fonte

O OneLake dá suporte a atalhos para recursos internos do OneLake (como bancos de dados KQL, lakehouses e armazéns) e recursos externos (como o Azure Data Lake Storage, o Amazon S3 ou o Google Cloud Storage). Para obter uma lista de todos os tipos de atalhos com suporte e links para suas instruções de configuração específicas, consulte Tipos de atalhos do OneLake.

Os atalhos em bancos de dados KQL dão suporte à aceleração de consulta. Para habilitar a aceleração de consulta em um novo atalho, alterne o botão Acelerar para Ativado.

Captura de tela da janela Novo atalho mostrando os detalhes do atalho. A alternância Acelerar está realçada.

Observação

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

Depois de criar um atalho, o banco de dados é atualizado automaticamente. O atalho aparece em Atalhos no painel Explorer. Agora você pode consultar esses dados.

Captura de tela do painel do Explorer mostrando o novo atalho.

Consultar dados

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

  1. No lado mais à direita do banco de dados, selecione Explorar seus dados. A janela é aberta com alguns exemplos de consultas que você pode executar para ter uma análise 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 tela da janela Explorar seus dados mostrando os resultados de um exemplo de consulta.

Mapeamento de tipos de dados

Mapeamento de tipos de dados do Delta Parquet para o Eventhouse

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

Tipo delta Tipo de dados escalares 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