Nomes e tipos de variáveis (versão prévia)

Um item da Biblioteca de Variáveis no Microsoft Fabric contém uma lista de variáveis e seus valores padrão. Ele também pode conter outros conjuntos de valores que contêm valores alternativos.

Cada variável na Biblioteca de Variáveis tem as seguintes propriedades:

• Nome
• Observação (opcional) até 2.048 caracteres
• Tipo
• Conjunto de valores padrão
• Conjuntos de valores alternativos (opcional)

Convenções de nomenclatura

Nome do item da Biblioteca de Variáveis

O nome do item de Biblioteca de Variáveis em si deve seguir estas convenções:

• Não estar vazio.
• Não ter espaços à esquerda ou à direita.
• Iniciar por uma letra.
• Pode incluir letras, números, sublinhados, hifens e espaços.
• Não exceder 256 caracteres de comprimento.

O nome da Biblioteca de Variáveis não diferencia maiúsculas de minúsculas.

Nome da variável

O nome de uma variável dentro da Biblioteca de Variáveis deve seguir essas convenções:

• Não estar vazio.
• Não ter espaços à esquerda ou à direita.
• Começar por uma letra ou um sublinhado.
• Pode incluir letras, números, sublinhados e hifens.
• Não exceder 256 caracteres de comprimento.

O nome da variável não diferencia maiúsculas de minúsculas.

Nome do conjunto de valores

Os nomes do conjunto de valores têm as mesmas restrições que os nomes de variáveis.

Tipos de variável

Antes de adicionar um valor a uma variável, você deve definir o tipo de variável. As variáveis na Biblioteca de Variáveis podem ser de qualquer um dos seguintes tipos:

• Cadeia de caracteres: qualquer caractere pode ser nulo ou vazio.
• Booliano: True ou False.
• DateTime: a data e a hora são representadas usando o padrão ISO 8601, aaaa-MM-ddTHH:mm:ss.xxxZ, em que:
  • aaaa-MM-dd é o ano de quatro dígitos, seguido pelo mês de dois dígitos e dia de dois dígitos
  • T separa a data e a hora
  • HH:mm:ss.xxx é a hora de dois dígitos no formato de 24 horas, seguida pelo minuto de dois dígitos, segundo de dois dígitos e milissegundo de três dígitos
  • Z indica que a hora está em empo Universal Coordenado (UTC) Por exemplo, 2025-01-14T16:15:20.123Z.
• Número: qualquer número.
• GUID: use esse tipo para representar GUIDs.
• Inteiro: um número inteiro que pode ser positivo, negativo ou zero.

Depois que uma variável tiver um valor definido, se você tentar alterar seu tipo, uma caixa de diálogo de consentimento aparecerá alertando o usuário de que todos os valores de variável serão redefinidos e que essa alteração pode ser uma alteração significativa no lado do item do consumidor.

Conjuntos de valores alternativos

Quando você cria um novo conjunto de valores em uma biblioteca de variáveis, os novos valores são definidos como ponteiros para os valores padrão. Você pode alterá-los para que sejam um valor fixo. Se você alterar o valor de uma variável no conjunto de valores alternativo, o valor alternativo será salvo no arquivo JSON de conjuntos de valores. Você pode alterar a ordem em que os conjuntos de valores são exibidos ou alterar o valor de uma variável no valor alternativo definido neste arquivo JSON no Git.

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 o número total de células nos conjuntos de valores alternativos seja inferior a 10.000 células e o tamanho do item não seja maior que 1 MB. Isso é validado quando o usuário 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 alternativas do conjunto de valores

• Os conjuntos de valores alternativos na Biblioteca de Variáveis aparecem na ordem em que foram adicionados. 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 na 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áveisde cada vez. Não é possível excluir o conjunto de valores ativos. Para excluí-lo, primeiro defina outro conjunto de valores como ativo. Você pode definir um conjunto de valores ativos diferente para cada estágio de um pipeline de implantação.