Criar atalhos do OneLake em um banco de dados KQL

Os atalhos do OneLake em um banco de dados KQL permitem consultar dados em itens de Fabric internos e armazenamento externo sem mover os dados. Em um banco de dados KQL, cada atalho aparece em Atalhos e é consultado como uma tabela externa em um conjunto de consultas KQL usando a external_table() função.

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. Você não pode renomear atalhos criados em um banco de dados KQL e pode criar apenas um atalho de cada vez.

Para obter informações gerais sobre tipos de atalho, instruções específicas da origem e limitações mais amplas, consulte atalhos do OneLake.

Observação

Para melhorar o desempenho da consulta em atalhos com suporte, consulte Aceleração de 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 um 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

Os bancos de dados KQL dão suporte a atalhos para recursos internos do OneLake, como bancos de dados KQL, lakehouses e armazéns, e para recursos externos, como Azure Data Lake Storage, Amazon S3 e Google Cloud Storage. Para obter uma lista completa de tipos de atalho com suporte e diretrizes de configuração específicas da origem, consulte Tipos de atalhos.

  1. Na janela Novo atalho , escolha o tipo de origem ao qual você deseja se conectar.
  2. Conclua os detalhes de conexão necessários para a origem e selecione a pasta ou tabela que você deseja expor no banco de dados KQL.
  3. Opcional: para habilitar a aceleração de consulta no novo atalho, defina Accelerate to On.
  4. Selecione Criar.

Para cenários e limitações com suporte, consulte Aceleração de consulta para atalhos do OneLake – visão geral.

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 o atalho, o banco de dados é atualizado automaticamente. O atalho aparece em Atalhos no painel Explorer. Agora você pode consultar os dados.

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

Organize atalhos em pastas

Para criar uma subpasta ou mover para uma pasta existente:

  1. No painel do Explorador, execute um destes procedimentos:
    • Clique com o botão direito do mouse no atalho e selecione Mover para pasta>+ Nova pasta.
      Captura de tela do menu pop-up mostrando a opção de criar uma nova pasta para o atalho.
    • Ou selecione as reticências (...) ao lado do atalho desejado e selecione Mover para pasta>+ Nova pasta ou escolha uma pasta existente.
      Captura de tela do menu pop-up mostrando a opção de mover o atalho para uma pasta existente ou criar uma nova.
  2. Para criar uma pasta, insira um nome para a pasta e selecione Criar. O atalho é movido para a nova pasta.
    Captura de tela da nova pasta que está sendo criada.
  3. Para mover mais de um atalho, insira outro nome de pasta ou selecione o menu suspenso e marque as caixas ao lado dos atalhos que você deseja mover para a mesma pasta.
    Captura de tela do menu pop-up mostrando a opção de mover vários atalhos para a mesma pasta.
  4. Você também pode mover atalhos para uma pasta existente. Para fazer isso, selecione Mover para a pasta e, em seguida, selecione a pasta para a qual deseja mover o atalho ou arraste e solte o atalho para a pasta.

Observação

  • Se você excluir uma subpasta, os atalhos dentro da pasta não serão excluídos, mas serão movidos de volta para a pasta pai.
  • Uma subpasta é excluída automaticamente quando não há atalhos dentro da pasta.
  • As pastas podem ser criadas por tipo de ativo e o nome deve ser exclusivo por tipo de ativo. Por exemplo, você pode ter uma pasta de tabela e uma pasta de atalhos com o mesmo nome, mas não pode ter duas pastas de atalhos com o mesmo nome.

Consultar dados

Para consultar dados do atalho do 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 ter uma análise inicial dos seus dados.
  2. Substitua o espaço reservado do nome da tabela por external_table('<shortcut-name>').
  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 tipo de dados

Mapeamento de tipos de dados de Delta Parquet para Eventhouse

Os tipos de dados primitivos do Delta correspondem aos tipos de dados escalares do Eventhouse, conforme mostrado na tabela a seguir. Para obter mais informações, 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

Sincronização automática de esquema

Os esquemas de tabela para um atalho sincronizam automaticamente, então adições de colunas, exclusãos, renomeações e mudanças de tipo na tabela de origem são refletidos no atalho sem necessidade de atualizações manuais. Esse comportamento é ativado por padrão. Para desativá-lo, execute o seguinte comando no banco de dados de origem:

.create-or-alter external table ExternalTable
kind=delta
(
   h@'https://storageaccount.blob.core.windows.net/container1;secretKey'
) with (AutoUpdateSchema=false)

Para mais informações sobre o comportamento de sincronização de esquema, veja Sincronização automática de esquema.

Conteúdo relacionado

  • Last updated on