Crie um atalho OneLake com o mesmo inquilino

Neste artigo, você aprende como criar um atalho OneLake que aponta para dados dentro de outro item Fabric no seu tenant.

Para obter uma visão geral dos atalhos, confira Atalhos do OneLake. Para criar atalhos programaticamente, consulte APIs REST de atalhos do OneLake.

Pré-requisitos

Um lakehouse ou banco de dados KQL no OneLake. Se você não tiver um destes, crie um lakehouse de teste seguindo estas etapas: Criar uma lakehouse.

Criar um atalho

  1. Abra o lakehouse ou o banco de dados KQL.

  2. Clique com o botão direito do mouse em um diretório no painel Do Explorer .

  3. Crie um novo atalho no menu.

    • Em um lakehouse, selecione Novo atalho, Novo atalho de tabela ou atalho de esquema Novo , dependendo das configurações do lakehouse.
    • Em um banco de dados KQL, selecione+>Novo>Atalho do OneLake.

    Captura de tela mostrando onde selecionar Novo atalho na Visualização do Lake.

  4. Em Fontes internas, selecione Microsoft OneLake.

    Captura de tela da janela Novo Atalho mostrando fontes de atalho disponíveis. A opção intitulada OneLake está realçada.

  5. Selecione a fonte de dados à qual você deseja se conectar e selecione Avançar.

    Captura de tela da janela Selecionar um tipo de fonte de dados mostrando as fontes de dados disponíveis para uso com o atalho. O botão Avançar está realçado.

    Tip

    Se você quiser conectar a dados em um inquilino Fabric diferente, siga os passos para criar um atalho OneLake entre inquilinos.

  6. Selecione um método de conexão:

    • Passagem (padrão): a própria identidade de cada usuário é usada para acessar os dados de destino. Continue para o passo seguinte.

    • Identidade delegada: uma identidade de conexão configurada é usada para acessar os dados de destino em vez da identidade de cada usuário. Se você selecionar essa opção, selecione Conectar e configure a conexão. Para mais informações, veja Autenticação Delegada.

      Para configurar uma conexão delegada:

      1. Selecione Conexão existente e escolha uma conexão na lista ou selecione Nova conexão para criar uma.
      2. Para uma nova conexão, insira os detalhes da conexão:
      • Caminho: confirme ou insira o caminho do OneLake.
      • Conexão: selecione Criar nova conexão.
      • Nome da conexão: insira um nome reconhecível.
      • Tipo de autenticação: escolha conta organizacional ou entidade de serviço.
        • Para a conta organizacional, selecione Entrar e concluir a autenticação.
          • Para o principal de serviço, insira o ID do inquilino, ID da aplicação (cliente) e o cliente secreto.
      1. Selecione Próximo.
  7. Expanda Arquivos ou Tabelas para exibir as subpastas disponíveis. Subpastas no diretório de tabelas que contêm tabelas Delta ou Iceberg válidas são indicadas com um ícone de tabela. Arquivos ou pastas não identificadas na seção tabelas são indicados com um ícone de pasta.

    Captura de tela que mostra os diretórios de Tabelas e Arquivos expandidos de um lakehouse.

  8. Selecione uma ou mais subpastas às quais se conectar e selecione Avançar.

    Você pode selecionar até 50 subpastas ao criar atalhos no OneLake.

    Captura de tela da janela Novo atalho mostrando os dados no lakehouse.

  9. Examine os locais de atalho selecionados. Use a ação de editar para alterar o nome de atalho padrão. Use a ação de excluir para remover as seleções indesejadas. Selecione Criar para gerar atalhos.

    Captura de tela da janela Novo atalho mostrando a localização dos atalhos selecionados e fornecendo a opção de excluir ou renomear as seleções.

O lakehouse se atualiza automaticamente. Os atalhos são exibidos no diretório selecionado no painel Explorer. Você pode diferenciar um arquivo ou tabela regular do atalho de suas propriedades. As propriedades têm um parâmetro Tipo de atalho que indica que o item é um atalho.

Captura de tela mostrando uma lista de pastas na Lake view que exibem o símbolo de atalho.

Para editar ou excluir um atalho existente, consulte Editar ou excluir um atalho do OneLake.