Criar e gerenciar bibliotecas de variáveis

As bibliotecas de variáveis do Microsoft Fabric permitem que os desenvolvedores personalizem e compartilhem configurações de itens em um workspace, com o objetivo de simplificar o gerenciamento do ciclo de vida do conteúdo. Este artigo explica como criar, gerenciar e consumir bibliotecas de variáveis.

Para obter um passo a passo mais detalhado do processo, consulte o tutorial para usar bibliotecas de variáveis.

Prerequisites

Para criar itens de biblioteca variável no Fabric, você precisa:

• Uma conta de locatário do Fabric com uma assinatura ativa. Crie uma conta gratuitamente.

• Um workspace com uma capacidade habilitada para Microsoft Fabric.

• Os seguintes comutadores de locatário habilitados no portal de administração:

  • Usuários podem criar itens do Fabric

  O administrador do locatário, o administrador de capacidade ou o administrador do workspace podem habilitar essas opções, dependendo das configurações da sua organização.

Considerações de segurança e gerenciamento de permissões para bibliotecas de variáveis do Fabric

Bibliotecas de variáveis de malha são constructos poderosos que permitem o gerenciamento centralizado de variáveis em vários itens do Fabric. No entanto, essa flexibilidade apresenta considerações críticas de segurança.

Como as próprias bibliotecas de variáveis são itens do Fabric, elas são regidas por seus próprios conjuntos de permissões . Esses conjuntos de permissões podem ser diferentes daqueles dos itens que consomem suas variáveis. Essa discrepância pode levar a cenários em que um usuário tem acesso de gravação a uma biblioteca de variáveis, mas não tem acesso ao item de consumo.

Nesses casos, usuários não autorizados podem modificar valores variáveis de maneiras que alteram intencionalmente ou não o comportamento de itens dependentes do Fabric. Essa capacidade cria um vetor de ataque potencial em que atualizações mal-intencionadas em variáveis compartilhadas podem comprometer a integridade, a segurança ou a funcionalidade desses itens.

Para atenuar esses riscos, siga estas práticas-chave:

• Adote controles de permissão estritos: os administradores devem gerenciar cuidadosamente as permissões de gravação em bibliotecas variáveis para que apenas usuários ou serviços confiáveis possam modificá-las. Essa prática inclui evitar acesso excessivamente permissivo e auditar regularmente as atribuições de permissão.
• Use referências de biblioteca confiável: os itens devem referenciar variáveis somente de bibliotecas que são explicitamente designadas como confiáveis. Esse modelo de confiança deve ser imposto por meio de políticas de governança que validam a origem das referências de variáveis durante o desenvolvimento e a implantação.

Para obter mais informações, consulte as permissões de biblioteca de variáveis.

Criar um item de biblioteca de variáveis

Você pode criar um item de biblioteca variável na home page do Fabric ou de dentro do workspace:

Uma biblioteca de variáveis vazia é exibida. Agora você pode adicionar variáveis a ela.

Gerenciar bibliotecas de variáveis e suas variáveis

Você pode gerenciar as variáveis na biblioteca de variáveis na barra de menus superior.

Adicionar uma variável

Para adicionar uma nova variável à biblioteca:

1. Selecione + Nova variável.
2. Insira um nome. Verifique se ele segue as convenções de nomenclatura.
3. Na lista suspensa, selecione um tipo. Confira uma lista de tipos de variáveis com suporte.
4. Insira um valor padrão.
5. Adicione uma observação que explica para que serve a variável ou como usá-la (opcional).
6. Clique em Salvar.

Excluir ou editar uma variável

• Para excluir uma variável, selecione uma ou mais variáveis e selecione Excluir variável>Salvar.
• Para editar o nome, o tipo ou o conjunto de valores de uma variável, altere o valor e selecione Salvar.
• Para adicionar outro conjunto de valores alternativo, selecione Adicionar conjunto de valores.

Adicionar um conjunto de valores

Para adicionar outro conjunto de valores que você pode usar em um estágio diferente:

1. Selecione Adicionar conjunto de valores.

2. Nomeie o conjunto de valores. Verifique se ele segue as convenções de nomenclatura. Dê a ele uma descrição (opcional) de até 2.048 caracteres.

3. Se você quiser usar esse valor para ser o valor atualmente ativo definido neste workspace, selecione Definir como ativo.

4. Insira valores para todas as variáveis na biblioteca de variáveis.

5. Clique em Salvar.

Editar um conjunto de valores

Para editar um conjunto de valores:

1. Selecione os três pontos ao lado do nome do conjunto de valores.

2. Selecione Definir como ativo (para este workspace), Renomear ou Excluir.

   

3. Clique em Salvar. As alterações só entrarão em vigor depois de salvá-las.

Para redefinir o valor de cada variável para o valor padrão, selecione o botão redefinir.

Considerações e limitações

Limitações de tamanho

• Pode haver até 1.000 variáveis e até 1.000 conjuntos de valores, desde que você atenda a ambos os requisitos:

  • O número total de células nos conjuntos de valores alternativos é menor que 10.000.
  • O tamanho do item não excede 1 MB.

  Esses requisitos são validados quando você salva as alterações.

• O campo de observação pode ter até 2.048 caracteres.

• O campo de descrição do conjunto de valores pode ter até 2.048 caracteres.

Limitações para conjuntos de valores alternativos

• Conjuntos de valores alternativos em uma biblioteca de variáveis aparecem na ordem em que você os adicionou. Atualmente, você não pode reordená-los na interface do usuário. Para alterar a ordem, edite o arquivo JSON diretamente.
• O nome de cada conjunto de valores deve ser exclusivo em uma biblioteca de variáveis.
• Os nomes de variáveis devem ser exclusivos em uma biblioteca de variáveis. Você pode ter duas variáveis com o mesmo nome em um workspace se elas estiverem em itens diferentes.
• Há sempre um (e apenas um) valor ativo definido em uma biblioteca de variáveis de cada vez. Não é possível excluir um conjunto de valores enquanto ele estiver ativo. Para excluí-lo, primeiro configure outro conjunto de valores para estar ativo. Você pode ter um valor ativo diferente definido para cada estágio de um pipeline de implantação.