Como criar um shortcut no OneLake do Microsoft Fabric
Um shortcut (atalho) no OneLake é uma referência que aponta para dados guardados noutro local — como uma conta Azure Data Lake Storage (ADLS) Gen2 ou um bucket Amazon S3 — e fá-los aparecer dentro da sua Lakehouse do Microsoft Fabric sem os copiar. Assim evita duplicar ficheiros, poupa armazenamento e trabalha sempre com a versão mais atual dos dados. Ao criar um shortcut no OneLake, a sua Lakehouse passa a consultar essa pasta externa como se os ficheiros fossem locais.
Pré-requisitos
- Uma capacidade Fabric ativa (avaliação, F SKU ou Premium por capacidade) e permissões para criar itens numa workspace.
- Uma Lakehouse já criada na workspace — ou permissões para criar uma.
- Acesso à origem dos dados: por exemplo, uma conta ADLS Gen2 com um container e o respetivo método de autenticação.
- O URL DFS da conta de armazenamento, no formato
https://<conta>.dfs.core.windows.net/<container>.
Passo 1: Abrir a Lakehouse onde vai criar o atalho
Na sua workspace do Microsoft Fabric, abra a Lakehouse onde quer que os dados externos apareçam. No explorador da Lakehouse, à esquerda, encontra duas áreas: Tables (tabelas em formato Delta) e Files (ficheiros em qualquer formato). O shortcut pode ser criado em qualquer uma delas. Se ainda não tiver uma Lakehouse, clique em New item na workspace e escolha Lakehouse.
Passo 2: Iniciar a criação do shortcut
Passe o rato sobre Files (ou Tables), clique nos três pontos ... ou use o botão direito e selecione New shortcut. Em alternativa, use Get data → New shortcut no friso da Lakehouse. Abre-se uma janela a perguntar qual é a origem dos dados.
Passo 3: Escolher a origem dos dados
A janela mostra as origens disponíveis. Para dados que já estão dentro do Fabric, escolha Microsoft OneLake. Para dados externos, escolha o conector certo — os mais comuns são Azure Data Lake Storage Gen2 e Amazon S3, mas também há Google Cloud Storage e Dataverse, entre outros. Neste exemplo, selecione Azure Data Lake Storage Gen2.
Passo 4: Configurar a ligação e o caminho
Indique o URL DFS da conta e crie (ou reutilize) uma ligação. Escolha o método de autenticação — conta organizacional, Account key, SAS ou service principal — e preencha as credenciais no Fabric; nunca as coloque em texto simples fora da plataforma.
URL: https://vendasglobais.dfs.core.windows.net/dados
Autenticacao: Organizational account (ou Account key / SAS / Service principal)Quando a ligação for validada, navegue pela árvore de pastas e escolha a subpasta que quer expor — por exemplo dados/vendas-externas. Dê um nome claro ao shortcut e clique em Create.
Passo 5: Consultar os dados do shortcut
O shortcut aparece agora como uma pasta normal dentro de Files (ou como tabela em Tables). Numa notebook, pode lê-lo com Spark:
# Ler os ficheiros do shortcut numa notebook do Fabric
df = spark.read.option("header", True).csv("Files/vendas-externas/2026.csv")
df.show(5)Se o shortcut estiver em Tables em formato Delta, também o pode consultar em T-SQL através do SQL analytics endpoint da Lakehouse:
SELECT TOP 10 pais, total_vendas
FROM vendas_externas
ORDER BY total_vendas DESC;Verificar o resultado
Para confirmar que ficou tudo bem: o shortcut aparece com um pequeno ícone de elo (seta) no explorador da Lakehouse; ao clicar nele, vê os ficheiros ou as linhas da origem sem qualquer cópia; e uma consulta simples devolve dados. Faça um teste final: altere um ficheiro na origem (ADLS Gen2), volte a consultar e confirme que vê a alteração — prova de que está a ler os dados no local original, e não uma cópia.
Conclusão
Acabou de criar um shortcut no OneLake que liga a sua Lakehouse do Microsoft Fabric a dados externos sem os duplicar — a base de uma arquitetura mais simples e sempre atualizada. A partir daqui pode juntar vários shortcuts na mesma Lakehouse, aplicar a arquitetura Medallion por cima deles ou criar um modelo semântico em Direct Lake. Qual seria a primeira origem de dados da sua organização que faria sentido ligar por shortcut, em vez de a copiar?