Criar um atalho OneLake interno

Neste artigo, aprende como criar um atalho OneLake dentro de um item do Fabric. Pode usar uma base de dados lakehouse ou Kusto Query Language (KQL) como fonte para o seu atalho.

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

Pré-requisito

Uma base de dados lakehouse ou KQL em OneLake. Se não tiver uma destas, crie uma casa de lago de teste seguindo estes passos: Crie uma casa de lago.

Criar um atalho

  1. Abra a sua base de dados Lakehouse ou KQL.

  2. Clique com o botão direito num diretório dentro do painel do Explorador .

  3. Crie um novo atalho a partir do menu.

    • Num lakehouse, selecione Novo atalho, Novo atalho de tabela ou Novo atalho de esquema, dependendo das definições do seu lakehouse.
    • Numa base de dados KQL, selecione +>o atalho New>OneLake.

    Captura de ecrã a mostrar onde selecionar Novo atalho a partir da vista do lago.

Selecione uma fonte

Pode selecionar uma fonte de dados do mesmo locatário ou de um locatário fora da sua organização. Escolha os passos que se adequam ao seu cenário:

Fonte do mesmo inquilino

Siga estes passos para criar um atalho para dados no seu próprio tenant do Fabric.

  1. Em Fontes internas, selecione Microsoft OneLake.

    Captura de ecrã da nova janela de atalhos que mostra as fontes de atalhos disponíveis. A opção intitulada OneLake está destacada.

  2. Selecione a fonte de dados à qual deseja ligar-se e, em seguida, selecione Avançar.

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

  3. Selecione um método de Ligação:

    • Pass-through (predefinição): A identidade de cada utilizador é utilizada para aceder aos dados de destino. Continue para a próxima etapa.

    • Identidade delegada: Uma identidade de ligação configurada é usada para aceder aos dados alvo em vez da identidade de cada utilizador. Se selecionares esta opção, seleciona Ligar e depois configura a ligação. Para obter mais informações, veja Autenticação.

      Para configurar uma ligação delegada:

      1. Selecione Ligação Existente e escolha uma ligação da lista, ou selecione Nova ligação para criar uma.
      2. Para uma nova ligação, introduza os detalhes da ligação:
      • Caminho: Confirme ou entre no caminho OneLake.
      • Conexão: Selecione Criar nova conexão.
      • Nome da ligação: Insira um nome reconhecível.
      • Tipo de autenticação: Escolha conta organizacional ou principal de serviço.
        • Para a conta organizacional, selecione Iniciar sessão e conclua a autenticação.
      1. Selecione Seguinte.

  4. Expanda Ficheiros ou Tabelas para ver as subpastas disponíveis. As 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 de tabelas são indicados com um ícone de pasta.

    Captura de ecrã que mostra os diretórios expandidos de Tabelas e Ficheiros de uma casa de lago.

  5. Selecione uma ou mais subpastas às quais se conectar e, em seguida, selecione Avançar.

    Pode selecionar até 50 subpastas ao criar atalhos no OneLake.

    Captura de ecrã da nova janela de atalho que mostra os dados no lakehouse.

  6. Reveja as localizações de atalho selecionadas. Use a ação de edição para alterar o nome do atalho padrão. Use a ação de exclusão para remover seleções indesejadas. Selecione Criar para gerar atalhos.

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

O lakehouse atualiza-se automaticamente. O atalho aparece sob o diretório selecionado no painel Explorer. Você pode diferenciar um arquivo ou tabela regular do atalho de suas propriedades. As propriedades têm um Shortcut Type parâmetro que indica que o item é um atalho.

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

Para editar ou eliminar um atalho existente, consulte Editar ou eliminar um atalho OneLake.

Origem entre locatários

Utilize os passos seguintes para criar um atalho para dados noutro inquilino do Fabric. Fornece um caminho de ligação para dados externos do OneLake e autentica-se com uma identidade desse tenant. Os utilizadores a jusante do atalho podem aceder aos dados externos através da identidade delegada configurada.

Se não tiver uma identidade no outro tenant Fabric, como se quiser usar dados de um parceiro ou cliente externo, use a partilha de dados externa em vez disso.

  1. Em Fontes internas, selecione Microsoft OneLake.

    Captura de ecrã da nova janela de atalhos que mostra as fontes de atalhos disponíveis. A opção intitulada OneLake está destacada.

  2. No banner Criar um atalho para dados noutro tenant? , selecione Introduzir detalhes da ligação.

    Captura de ecrã que mostra o botão para introduzir detalhes de ligação ao OneLake num tenant externo.

  3. Selecione Ligação Existente e escolha uma ligação da lista, ou selecione Nova ligação para criar uma.

    • Para uma nova ligação, introduza os detalhes da ligação:
      • Caminho: Introduza o caminho do OneLake do tenant externo.
      • Conexão: Selecione Criar nova conexão.
      • Nome da ligação: Insira um nome reconhecível.
      • Tipo de autenticação: Selecione Conta Organizacional ou Principal de Serviço.
        • Para conta organizacional, selecione Iniciar sessão e complete a autenticação com uma conta que tenha acesso aos dados do inquilino externo.

  4. Selecione Seguinte.

  5. Na página Microsoft OneLake (Cross-tenant), procure a origem de dados externa.

  6. Selecione as pastas ou tabelas a incluir, depois selecione Próximo para rever e criar o atalho.

Authentication

Os atalhos OneLake suportam dois métodos de autenticação: pass-through e identidade delegada.

  • Pass-through (padrão): Quando um utilizador lê o atalho, o Fabric acede aos dados de destino utilizando a identidade desse utilizador com sessão iniciada. Cada utilizador precisa de permissões individuais sobre os dados de origem.

  • Identidade delegada: O atalho utiliza uma identidade de ligação configurada (conta organizacional ou principal de serviço) para aceder aos dados alvo, em vez da identidade do utilizador iniciado sessão. Esta abordagem proporciona acesso consistente aos dados entre itens e espaços de trabalho Fabric sem exigir que cada utilizador tenha permissões individuais sobre a fonte.

Use autenticação delegada quando o comportamento padrão de passagem não corresponde ao padrão de acesso que pretende para os seus dados. Por exemplo, em vez de gerir os acessos individuais para utilizadores de negócio subsequentes, um atalho delegado pode utilizar uma identidade de ligação fixa que representa uma unidade de negócio. Esta abordagem dá à unidade de negócio flexibilidade para gerir o acesso de segurança OneLake para os seus utilizadores finais, respeitando ao mesmo tempo os controlos de segurança aplicados à identidade da ligação.

Para mais informações sobre como estes modelos de autenticação interagem com a segurança do OneLake, consulte a segurança de atalhos do OneLake.

Considerações sobre atalhos de teclado delegados

  • A autenticação delegada é opcional. Se não o selecionar, o atalho usa a autenticação passthrough por defeito.
  • Os atalhos entre tenants usam sempre autenticação delegada.
  • A identidade de ligação configurada necessita de acesso aos dados de destino.
  • Para alternar um atalho existente entre passthrough e autenticação delegada, elimine e recrie o atalho com o método de autenticação desejado.
  • Os atalhos delegados suportam segurança ao nível da coluna (CLS) tanto no alvo como no próprio atalho.
  • Os atalhos delegados suportam segurança ao nível da linha (RLS) apenas nos dados alvo.

Conteúdo relacionado

  • Last updated on