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
• Nota (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 próprio nome do item de biblioteca variável 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, hífenes e espaços
• Não excede 256 caracteres

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 hífenes
• Não excede 256 caracteres

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

Nome do conjunto de valores

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

Tipos de variáveis

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:

• String: Qualquer caractere. Pode estar null ou vazio.

• Booleano: True ou False.

• DateTime: Data e hora representadas como a norma ISO 8601 aaaa-MM-ddTHH:mm:ss.xxxZ, onde:

  • aaaa-MM-dd é o ano de quatro dígitos, seguido do mês de dois dígitos e do 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 milissegundos de três dígitos.
  • Z indica que a hora está em Tempo Universal Coordenado (UTC).

  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 das variáveis serão redefinidos e que essa alteração pode ser uma alteração de quebra 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 ser 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 em que os conjuntos de valores aparecem, ou alterar o valor de uma variável no conjunto de valores alternativo, 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 é 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.