Criar atalhos do OneLake em uma base de dados KQL

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

Neste artigo, você aprenderá a criar um atalho OneLake em um banco de dados KQL que aponta para malha interna ou fontes externas. Não podes renomear atalhos criados numa base de dados KQL, e só podes criar um atalho de cada vez.

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

Nota

Para melhorar o desempenho das consultas em atalhos suportados, veja 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 ecrã do separador Base a mostrar a lista pendente do botão Novo. A opção intitulada Atalho OneLake é realçada.

Selecione uma fonte

As bases de dados KQL suportam atalhos para recursos internos da OneLake, como bases de dados KQL, lakehouses e armazéns, e para recursos externos, como Azure Data Lake Storage, Amazon S3 e Google Cloud Storage. Para uma lista completa dos tipos de atalhos suportados e orientações de configuração específicas para a fonte, veja Tipos de atalhos.

  1. Na janela Novo atalho, escolha o tipo de origem à qual pretende estabelecer ligação.
  2. Preencha os detalhes de ligação necessários para a fonte e depois selecione a pasta ou tabela que pretende expor na base de dados KQL.
  3. Opcional: Para ativar a aceleração de consultas no novo atalho, defina Acelerar para Ligado.
  4. Selecione Criar.

Para os cenários suportados e as limitações, consulte Aceleração de consultas para atalhos do OneLake - descrição geral.

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. Renomeia as colunas antes de criares o atalho.

Depois de criares o atalho, a base de dados atualiza-se automaticamente. O atalho aparece em Atalhos no painel Explorer . Agora pode consultar os dados.

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

Organize os atalhos em pastas

Para criar uma subpasta ou mover para uma pasta existente:

  1. No painel do Explorador, proceda de uma das seguintes formas:
    • Clique com o botão direito no atalho e selecione Mover para pasta>+Nova pasta.
      Captura de ecrã do menu pop-up que mostra a opção de criar uma nova pasta para o atalho.
    • Ou, selecione a reticência (...) ao lado do atalho específico e selecione Mover para pasta>+Nova pasta ou escolha uma pasta existente.
      Captura de ecrã do menu pop-up que mostra a opção de mover o atalho para uma pasta existente ou criar uma nova.
  2. Para criar uma pasta, introduza o nome da pasta e selecione Criar. O atalho é movido para a nova pasta.
    Captura de ecrã da nova pasta a ser criada.
  3. Para mover mais do que um atalho, introduza o nome de outra pasta ou selecione o menu suspenso e assinale as caixas ao lado dos atalhos que quer mover para a mesma pasta.
    Captura de ecrã do menu pop-up que mostra a opção de mover vários atalhos para a mesma pasta.
  4. Também podes mover atalhos para uma pasta existente. Para isso, selecione Mover para a pasta e depois selecione a pasta para onde quer mover o atalho, ou arraste e larga o atalho para dentro da pasta.

Nota

  • Se apagares uma subpasta, os atalhos dentro da pasta não são eliminados, mas são movidos de volta para a pasta principal.
  • Uma subpasta é automaticamente apagada quando não há atalhos dentro da pasta.
  • As pastas podem ser criadas por tipo de ativo e o nome deve ser único por tipo de ativo. Por exemplo, podes ter uma pasta de tabela e uma pasta de atalhos com o mesmo nome, mas não podes ter duas pastas de atalhos com o mesmo nome.

Consultar os dados

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

  1. No lado direito da sua base de dados, selecione Explorar os 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 marcador de posição do nome da tabela por external_table('<shortcut-name>').
  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 de Delta Parquet para Eventhouse

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

Os esquemas de tabelas para uma tabela de atalhos sincronizam-se automaticamente, por isso as adições, eliminações, renomeações e alterações de tipos na tabela de origem são refletidas no atalho sem necessidade de atualizações manuais. Este comportamento está ativado por defeito. Para o desativar, execute o seguinte comando na base 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 esquemas, veja Sincronização automática de esquema.

Conteúdos relacionados

  • Last updated on