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 espaço de trabalho, 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 sobre o uso de bibliotecas de variáveis.

Prerequisites

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

• Uma conta de inquilino da Fabric com uma subscrição ativa. Crie uma conta gratuitamente.

• Um espaço de trabalho com uma capacidade ativada por Microsoft Fabric.

• As seguintes opções de locatário habilitadas no Portal de administração:

  • Os usuários podem criar itens de malha

  O administrador de locatário, administrador de capacidade ou administrador de espaço de trabalho pode 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

As bibliotecas de variáveis de malha são construções poderosas que permitem o gerenciamento centralizado de variáveis em vários itens de malha. No entanto, essa flexibilidade introduz considerações críticas de segurança.

Como as próprias bibliotecas de variáveis são itens de malha, elas são regidas por seus próprios conjuntos de permissões . Esses conjuntos de permissões podem diferir 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 variável, mas não tem acesso ao item de consumo.

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

Para mitigar esses riscos, siga estas práticas principais:

• Adotar controles de permissão rigorosos: 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 acessos excessivamente permissivos e auditar regularmente as atribuições de permissão.
• Usar referências de bibliotecas confiáveis: os itens devem fazer referência a variáveis somente de bibliotecas explicitamente designadas como confiáveis. Esse modelo de confiança deve ser aplicado por meio de políticas de governança que validem a fonte de referências variáveis durante o desenvolvimento e a implantação.

Para obter mais informações, consulte Permissões de biblioteca variável.

Criar um item de biblioteca variável

Você pode criar um item de biblioteca variável na página inicial do Fabric ou de dentro do seu espaço de trabalho:

Página inicial

1. Na barra lateral, selecione Criar. (Se não estiver lá, selecione os três pontos e, em seguida, selecione Criar.)

2. Na seção Data Factory , selecione Biblioteca de variáveis.

   

3. Nomeie a nova biblioteca de variáveis e selecione Criar. Certifique-se de que o nome está em conformidade com as convenções de nomenclatura necessárias.

Workspace

1. Selecione + Novo item.

2. Role para baixo até a seção Desenvolver dados e selecione Biblioteca de variáveis.

   

3. Nomeie a nova biblioteca de variáveis e selecione Criar. Certifique-se de que o nome está em conformidade com as convenções de nomenclatura necessárias.

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

Gerenciar bibliotecas de variáveis e suas variáveis

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

Adicionar uma variável

Para adicionar uma nova variável à biblioteca:

1. Selecione + Nova variável.
2. Insira um nome. Certifique-se de que segue as convenções de nomenclatura.
3. Na lista suspensa, selecione um tipo. Consulte uma lista de tipos de variáveis suportados.
4. Insira um valor padrão.
5. Adicione uma nota que explique para que serve a variável ou como usá-la (opcional).
6. Selecione Guardar.

Excluir ou editar uma variável

• Para excluir uma variável, selecione uma ou mais variáveis e, em seguida, 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.

Note

Selecionar Salvar depois de editar qualquer variável na biblioteca de variáveis dispara uma verificação de validação de erro para certificar-se de que todos os nomes e valores das variáveis são válidos. Você deve corrigir quaisquer erros antes de salvar as alterações.

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. Certifique-se de que segue as convenções de nomenclatura. Dê-lhe uma descrição (opcional) de até 2.048 caracteres.

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

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

5. Selecione Guardar.

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 espaço de trabalho), Renomear ou Excluir.

   

3. Selecione Guardar. As alterações só entram em vigor depois de as guardar.

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

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 é inferior a 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 notas 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

• Os conjuntos de valores alternativos em uma biblioteca de variáveis aparecem na ordem em que foram adicionados. Atualmente, não é possível 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 dentro de uma biblioteca de variáveis.
• Os nomes das variáveis devem ser exclusivos dentro de uma biblioteca de variáveis. Você pode ter duas variáveis com o mesmo nome em um espaço de trabalho se elas estiverem em itens diferentes.
• Há sempre um (e apenas um) valor ativo definido em uma biblioteca variável 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.