Partilhar via

O que é uma biblioteca variável?

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

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

  • Um inteiro a ser utilizado numa atividade de espera num pipeline.
  • Uma referência lakehouse para ser a fonte em uma atividade de cópia de dados . Cada valor é usado em um pipeline diferente, com base no estágio de liberação do pipeline.
  • Uma referência lakehouse a ser configurada como um notebook padrão lakehouse. Cada valor é usado em um pipeline diferente, com base no estágio de liberação do notebook.

A resolução de valor de um item de consumo não está necessariamente ligada à sua utilização. Em vez disso, cada item de consumo 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 definir e gerenciar variáveis que outros itens podem usar.

Uma biblioteca de variáveis Fabric:

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

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 liberação. Você pode configurar a biblioteca de variáveis com conjuntos de valores: um valor para cada estágio do pipeline de liberação. Em seguida, após configurações únicas do conjunto de valores ativos para cada estágio, o valor correto é usado automaticamente no estágio de pipeline. Os exemplos incluem:

  • Alterar a conexão de um item com base no palco.
  • Mudar para uma fonte de dados na nuvem diferente com base no palco.
  • Ajustar a quantidade de dados em uma consulta com base no estágio.

Compartilhar configurações

As bibliotecas de variáveis fornecem uma maneira centralizada de gerenciar configurações nos itens do espaço de trabalho. Por exemplo, se você tiver várias lakehouses no espaço de trabalho e cada uma tiver um atalho que usa a mesma fonte de dados, 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, terá que alterá-la apenas uma vez na biblioteca de variáveis. Você não precisa trocá-lo em cada casa do lago separadamente.

Estrutura variável da biblioteca

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

Captura de tela de uma biblioteca de variáveis com várias variáveis e seus componentes principais.

Valor predefinido

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 string, o valor padrão pode 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 espaço de trabalho.

Em cada espaço de trabalho, você seleciona um conjunto de valores para ser ativo. O conjunto de valores ativos de um espaço de trabalho não é alterado durante uma implantação ou atualização do Git.

Captura de tela de uma biblioteca variável com vários conjuntos de valores alternativos.

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

Itens suportados

Os seguintes itens suportam a biblioteca de variáveis:

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.

Conteúdo relacionado

  • Last updated on