O que é uma biblioteca de variáveis?

Uma biblioteca de variáveis do Microsoft Fabric é um bucket de variáveis que outros itens no workspace podem consumir como parte do ALM (gerenciamento do ciclo de vida do aplicativo). Ela funciona como um item dentro do workspace que contém uma lista de variáveis, juntamente com seus respectivos valores para cada estágio do pipeline de lançamento. Ele apresenta uma abordagem unificada para o gerenciamento eficiente de configurações de item em um workspace, para ajudar a garantir a escalabilidade e a consistência em estágios de ciclo de vida.

Por exemplo, uma biblioteca de variáveis pode conter variáveis que contêm valores para:

• Um inteiro a ser usado em uma atividade de espera em um pipeline.
• Uma referência de lakehouse para ser a origem em uma atividade de cópia de dados . Cada valor é usado em um pipeline diferente, com base no estágio de lançamento do pipeline.
• Uma referência de lakehouse a ser configurada como um bloco de anotações padrão lakehouse. Cada valor é usado em um pipeline diferente, com base no estágio de lançamento do notebook.

A resolução de valor no item do consumidor não está necessariamente vinculada à sua implantação. Em vez disso, cada item do consumidor resolve o valor com base em seu próprio contexto.

A experiência de uma biblioteca de variáveis difere com base no tipo de variável, mas todas as bibliotecas de variáveis permitem que você defina e gerencie variáveis que outros itens podem usar.

Uma biblioteca de variáveis do Fabric:

• É compatível com processos de CI/CD (integração contínua e entrega contínua). Essa compatibilidade permite a integração com o Git e a implantação por meio de pipelines de implantação.
• Dá suporte à automação por meio de APIs públicas do Fabric.

Benefícios

As bibliotecas de variáveis permitem que os clientes personalizem e compartilhem configurações.

Personalizar configurações

Você pode configurar um valor variável com base no estágio do pipeline de lançamento. Você pode configurar a biblioteca de variáveis com conjuntos de valores: um valor para cada estágio do pipeline de lançamento. Em seguida, após as configurações pontuais do conjunto de valores ativos para cada estágio, o valor correto é usado automaticamente no estágio do pipeline. Os exemplos incluem:

• Alterando a conexão de um item com base no estágio.
• Alternar para uma fonte de dados de nuvem diferente com base no estágio.
• Ajustando a quantidade de dados em uma consulta com base no estágio.

Compartilhamento de configurações

As bibliotecas de variáveis fornecem uma maneira centralizada de gerenciar configurações nos itens do workspace. Por exemplo, se você tiver várias lakehouses no workspace e cada uma tiver um atalho que use a mesma fonte de dados, você poderá criar uma biblioteca de variáveis com essa fonte de dados como uma das variáveis. Dessa forma, se você quiser alterar a fonte de dados, precisará alterá-la apenas uma vez na biblioteca de variáveis. Você não precisa mudá-lo em cada lakehouse separadamente.

Estrutura de biblioteca de variáveis

As bibliotecas de variáveis contêm uma ou mais variáveis. Cada variável tem um nome, um tipo e um valor padrão. Você também pode adicionar uma anotação em cada variável para descrever a finalidade dela ou como usá-la.

Valor padrão

O valor padrão é o valor usado, a menos que você defina especificamente um valor diferente.

Todas as variáveis devem ter um valor padrão. Se o tipo de variável for cadeia de caracteres, o valor padrão poderá ser null.

Conjuntos de valores alternativos

Os conjuntos de valores definem os valores de cada variável na biblioteca de variáveis. Uma biblioteca de variáveis normalmente contém vários conjuntos de valores. O conjunto de valores ativo (ou efetivo) contém o valor que o item de consumidor recebe para esse workspace.

Em cada workspace, você seleciona um valor definido como ativo. O conjunto de valores ativos de um workspace não é alterado durante uma implantação ou atualização do Git.

Quando você cria um conjunto de valores alternativo, o novo conjunto de valores é criado com ponteiros para o valor padrão de cada variável. Em seguida, você pode alterar o valor de cada variável no novo conjunto de valores.

Itens com suporte

Os seguintes itens dão suporte à biblioteca de variáveis:

• Pipeline
• Atalho para uma casa no lago
• Notebook, por meio do NotebookUtils e %%configure
• Fluxo de dados Gen 2
• Trabalho de cópia
• Funções de dados do usuário

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.

Conteúdo relacionado

• Permissões da biblioteca de variáveis
• Criar e gerenciar bibliotecas de variáveis