Compartilhar via


Permissões de biblioteca de variáveis

Este artigo explica quem pode acessar bibliotecas variáveis e seus valores.

Permissões para um elemento do acervo de variáveis

As permissões da biblioteca de variáveis do Microsoft Fabric são alinhadas com o modelo de workspace do Fabric. As permissões estão de acordo com sua função no espaço de trabalho ou a biblioteca de variáveis pode ser compartilhada diretamente.

Função de workspace Permissions
Visualizador Pode exibir o item da biblioteca de variáveis
Contributor Pode exibir, adicionar, editar e excluir o item da biblioteca de variáveis
Membro Pode exibir, adicionar, editar, excluir e compartilhar novamente o item de biblioteca de variáveis
Admin Pode exibir, adicionar, editar, excluir e compartilhar novamente o item de biblioteca de variáveis

Para compartilhar um item de biblioteca variável, vá para o menu de item no workspace e selecione Compartilhar. Se o usuário com o qual você compartilha o item não tiver permissão para o espaço de trabalho, mas tiver permissão para um dos itens consumidores da variável (por exemplo, um pipeline), a biblioteca de variáveis não estará visível ou disponível para uso nesse pipeline.

Para definir um item como um valor variável em uma biblioteca de variáveis, você precisa ter pelo menos permissão de leitura para esse item. Por exemplo, se você quiser definir o valor de uma variável como um lakehouse, precisará de permissão de leitura para o lakehouse.

Para obter mais informações sobre funções de workspace, consulte Funções em workspaces no Microsoft Fabric.

Observação

Não há gerenciamento de permissões no nível da variável. A permissão para cada variável é a mesma que as permissões para o item inteiro.

Tipo de variável de referência de item (versão prévia)

A seção a seguir fornece informações de permissões sobre variáveis de referência de item.

Requisitos de permissões

O uso de variáveis de referência de item envolve duas camadas de permissões:

  • Criar e editar uma variável de referência de item: usuários no espaço de trabalho com função de Colaborador ou superior podem criar e editar variáveis na biblioteca, enquanto os Observadores têm permissão de apenas leitura.
  • Acessando a variável de referência de item: além dos direitos na Biblioteca de Variáveis, você deve ter pelo menos permissão de leitura na variável de referência de item que você pretende referenciar.

Aplicação de permissões

  1. Durante atualizações de item de biblioteca variável: ao atualizar um item de biblioteca de variáveis, a Biblioteca de Variáveis impõe as seguintes verificações de permissões:
  • Todos os itens referenciados no conjunto de valores ativos devem existir.
  • O usuário de chamada deve ter permissões READ para cada item referenciado no conjunto de valores ativos.
  1. Durante o uso de variável em um item consumido:

Ao chamar APIs de consumo (como Resolver ou Descobrir), a solicitação não falhará se a entidade de chamada não tiver permissão para o item referenciado ou se o item não existir. Em vez disso, a API retorna um status específico que indica o resultado, conforme descrito abaixo.

Permissões ausentes ou itens inexistentes

Se o chamador não tiver permissões READ ou o item não existir, o valor da variável ainda será retornado, mas sem metadados estendidos.

Tipo de variável de referência de conexão (versão prévia)

A seção a seguir fornece informações de permissões sobre variáveis de referência de conexão.

Requisitos de permissões

O uso de variáveis de referência de conexão envolve duas camadas de permissões:

  • Criar e editar uma variável de referência de conexão: usuários com funções de Colaborador ou superior no workspace podem criar e editar variáveis na biblioteca, enquanto Visualizadores somente têm permissão de leitura.
  • Acessando a variável de referência de conexão: além dos direitos na Biblioteca de Variáveis, você deve ter pelo menos permissão de leitura na variável de referência de conexão que você pretende referenciar.

Imposição de permissões

  1. Durante atualizações de item de biblioteca variável: ao atualizar um item de biblioteca de variáveis, a Biblioteca de Variáveis impõe as seguintes verificações de permissões:
  • Todas as conexões referenciadas no conjunto de valores ativos devem existir.
  • O usuário de chamada deve ter permissões READ para cada conexão referenciada no conjunto de valores ativo.
  1. Durante o uso de variável em um item consumido:

Ao chamar APIs de consumo (como Resolve ou Discover), se o principal do chamador não tiver permissões para a conexão referenciada ou se a conexão referenciada não existir, a solicitação não falha. Em vez disso, um status apropriado é retornado, conforme explicado abaixo.

Permissões ausentes ou itens inexistentes

Se o chamador não tiver permissões READ ou a conexão não existir, o valor da variável ainda será retornado, mas sem metadados estendidos. O seguinte mostra isso no portal do Fabric.

Captura de tela das permissões que estão sendo negadas.