Nomes e tipos de variáveis

Um item de 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 da biblioteca de variáveis

O nome do item de biblioteca variável em si deve seguir estas convenções:

• Não está vazio
• Não tem espaços à esquerda ou à direita
• Começa com uma letra
• Pode incluir letras, números, sublinhados, hifens e espaços
• Não excede 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 estas convenções:

• Não está vazio
• Não tem espaços à esquerda ou à direita
• Começa com uma letra ou um sublinhado
• Pode incluir letras, números, sublinhados e hifens
• Não excede 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 qualquer um dos seguintes tipos:

• Cadeia de caracteres: qualquer caractere. Pode estar null ou vazio.

• Booliano: True ou False.

• DateTime: data e hora representadas como o ISO 8601 standard yyyy-MM-ddTHH:mm:ss.xxxZ, em que:

  • yyyy-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 UTC (Tempo Universal Coordenado).

  Um exemplo é 2025-01-14T16:15:20.123Z.

• Número: qualquer número.

• GUID: um identificador global exclusivo.

• 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 será exibida. A caixa de diálogo alerta 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 para conjuntos de valores. Você pode alterar a ordem na qual os conjuntos de valores aparecem ou alterar o valor de uma variável no conjunto de valores alternativos, 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 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.