Partilhar via


Permissões de biblioteca variável

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

Permissões para um item de biblioteca variável

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

Função de espaço de trabalho Permissões
Visualizador Pode exibir o item de biblioteca variável
Contribuidor Pode visualizar, adicionar, editar e excluir o item de biblioteca variável
Membro Pode exibir, adicionar, editar, excluir e compartilhar novamente o item de biblioteca variável
Administrador Pode exibir, adicionar, editar, excluir e compartilhar novamente o item de biblioteca variável

Para compartilhar um item de biblioteca variável, vá para o menu de item no espaço de trabalho e selecione Compartilhar. Se o usuário com quem você compartilha o item não tiver permissão para o espaço de trabalho, mas tiver permissão para um dos itens de consumidor 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 de variável em uma biblioteca de variáveis, você precisa ter pelo menos permissão de leitura para esse item. Por exemplo, se quiseres atribuir o valor de uma variável a um lakehouse, precisas de permissão de leitura para o lakehouse.

Para obter mais informações sobre funções de espaço de trabalho, consulte Funções em espaços de trabalho 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 do item (pré-visualização)

A secção seguinte fornece informações sobre permissões sobre variáveis de referência de itens.

Requisitos de Permissões

A utilização 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: Utilizadores com funções de Colaborador ou superiores no espaço de trabalho podem criar e editar variáveis na biblioteca, enquanto os Visualizadores apenas têm permissões de leitura.
  • Aceder à variável de referência do item: Para além dos direitos sobre a Biblioteca de Variáveis, deve ter pelo menos permissão de leitura na variável de referência do item que pretende referenciar.

Execução de permissões

  1. Durante as atualizações de itens da biblioteca de variáveis: Ao atualizar um item da biblioteca de variáveis, a Biblioteca de Variáveis aplica as seguintes verificações de permissões:
  • Todos os itens referenciados no conjunto de valores ativos devem existir.
  • O utilizador que chama deve ter permissões de LEITURA para cada item referenciado no conjunto de valores ativos.
  1. Durante o uso de variáveis num objeto consumidor:

Ao chamar APIs de consumo (como Resolve ou Discover), o pedido não falha se o principal chamador não tiver permissão para o item referenciado ou se o item não existir. Em vez disso, a API devolve um estado específico que indica o resultado, conforme descrito abaixo.

Permissões em falta ou itens inexistentes

Se o chamador não tiver permissões de LEITURA ou o item não existir, o valor da variável continuará a ser devolvido, mas sem metadados estendidos.

Tipo de variável de referência de ligação (pré-visualização)

A secção seguinte fornece informações sobre permissões relativas às variáveis de referência da ligação.

Requisitos de permissões

A utilização de variáveis de referência de ligação envolve duas camadas de permissões:

  • Criar e editar uma variável de referência de ligação: Utilizadores com funções de Colaborador ou superiores no espaço de trabalho podem criar e editar variáveis na biblioteca, enquanto os Visualizadores têm acesso apenas de leitura.
  • Aceder à variável de referência de ligação: Para além dos direitos na Biblioteca de Variáveis, deve ter pelo menos permissão de leitura sobre a variável de referência de ligação que pretende referenciar.

Aplicação de permissões

  1. Durante as atualizações de itens da biblioteca de variáveis: Ao atualizar um item da biblioteca de variáveis, a Biblioteca de Variáveis aplica as seguintes verificações de permissões:
  • Todas as ligações referenciadas no conjunto de valores ativos devem existir.
  • O utilizador que chama deve ter permissões de LEITURA para cada ligação referenciada no conjunto de valores ativos.
  1. Durante o uso de variáveis num objeto consumidor:

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

Permissões em falta ou itens inexistentes

Se o chamador não tiver permissões de LEITURA ou a ligação não existir, o valor da variável ainda será devolvido, mas sem metadados estendidos. O seguinte mostra isto no portal do Fabric.

Captura de ecrã das permissões a serem negadas.