Integração de bibliotecas variáveis com pipelines

A biblioteca de variáveis é um novo tipo de item no Microsoft Fabric. Ao usar a biblioteca de variáveis, pode definir e gerir variáveis ao nível do espaço de trabalho. Pode usar estas variáveis em vários itens do espaço de trabalho, como pipelines, cadernos, atalhos para a casa do lago e mais. Proporciona uma forma unificada e centralizada de gerir as configurações, reduzindo a necessidade de valores codificados fixamente e simplificando os seus processos CI/CD. É mais fácil gerir configurações em diferentes ambientes.

Como usar a biblioteca de variáveis com pipelines

  1. Vai ao teu espaço de trabalho e cria um novo item.

    Captura de tela realçada mostrando onde adicionar um novo item no seu espaço de trabalho do Fabric.

  2. Use o filtro para localizar Biblioteca de variáveis ou role para baixo até a seção Desenvolver dados.

    Captura de tela mostrando o filtro para um novo item de biblioteca Variável.

  3. Selecione Biblioteca de variáveis para criar uma nova biblioteca de variáveis. Introduza um nome e selecione Criar.

    Captura de ecrã mostrando um novo item variável da biblioteca com um nome definido e o botão Criar realçado.

  4. Depois de criares a biblioteca de variáveis, és levado para a página inicial. Selecione + Novo para adicionar uma nova variável.

    Captura de tela mostrando a página inicial de um novo item de biblioteca de variáveis.

  5. Quando adicionas uma nova variável, podes configurar a tua variável e definir o Nome, o Tipo e o valor Padrão. Também pode adicionar Notas.

    Captura de ecrã mostrando as configurações a serem definidas para uma nova variável.

  6. Adicione conjuntos de valores alternativos conforme necessário (por exemplo, valores diferentes para diferentes ambientes de pipeline de implementação). Depois de definires um nome e selecionares Criar, podes editar os valores das variáveis e escolher qual o conjunto de valores a ativar.

    Captura de tela destacando onde adicionar novos conjuntos de valores para uma variável.

    Captura de tela mostrando como adicionar um nome para um novo conjunto de valores.

  7. Guarda as tuas alterações quando terminares.

    Captura de ecrã mostrando o botão Guardar realçado no canto superior esquerdo.

Usar as variáveis da biblioteca de variáveis no seu pipeline

  1. Para usar uma variável da biblioteca no seu pipeline, crie um novo pipeline ou acesse um pipeline existente.

    Captura de tela destacando o botão criar novo item no canto superior esquerdo e o item de pipeline realçado.

  2. No seu pipeline, crie uma referência para a variável da sua biblioteca de variáveis no painel inferior.

    Captura de tela destacando a guia Variáveis da biblioteca e o botão +Novo no painel inferior da tela do pipeline.

  3. Selecione + Novo. Abre um pop-up que mostra todas as tuas bibliotecas de variáveis. Use este seletor para selecionar a variável da biblioteca de variáveis e selecionar Ok.

    Captura de ecrã a mostrar o botão +Novo no separador de variáveis da biblioteca realçado.

    Captura de tela mostrando uma variável Library selecionada no seletor de variáveis.

    Captura de tela mostrando o conjunto de configurações para uma nova referência de variável Biblioteca.

  4. Depois de adicionares as referências das variáveis da tua biblioteca, adiciona as atividades do teu pipeline. Nas configurações de atividade, selecione Adicionar conteúdo dinâmico para a configuração que você deseja parametrizar.

    Captura de ecrã mostrando

  5. O construtor de expressões abre. Se não conseguir ver as variáveis de Biblioteca, selecione os três pontos junto às Funções e escolha variáveis de Biblioteca.

    Captura de tela mostrando os 3 pontos ao lado de Funções no construtor de expressões e a guia Variáveis de biblioteca realçada.

  6. Selecione a referência da variável Biblioteca para adicionar uma nova expressão ao construtor de expressões. Em seguida, selecione Ok para adicionar sua expressão.

    Captura de tela mostrando uma referência de variável Library realçada para ser adicionada ao construtor de expressões.

    Captura de tela mostrando o conjunto de expressões no construtor de expressões.

Note

Se estiveres a usar uma referência de Conexão ou um tipo de referência de item, adiciona um '.' para obter as propriedades da variável depois de adicionares a variável ao construtor de expressões. Este passo permite-lhe usar valores como ID de ligação, ID de item ou espaço de trabalho de items.

  1. Vês que o conteúdo dinâmico é adicionado à tua configuração de atividade.

    Captura de ecrã a mostrar a expressão definida como conteúdo dinâmico nas definições de atividade de Pesquisa.

  2. Você pode visualizar seus dados selecionando Visualizar dados. Esta ação abre um novo painel que mostra o valor da variável da tua biblioteca. Selecione Ok para obter uma pré-visualização dos seus dados.

    Captura de ecrã a mostrar a opção de pré-visualização de dados.

    Captura de ecrã a mostrar o painel de dados de pré-visualização.

  3. Salve e execute o seu pipeline como faria normalmente. Vês que o valor passado é o valor definido como Ativo na tua biblioteca de variáveis.

    Captura de ecrã mostrando as configurações de Salvar e Executar realçadas no painel do pipeline.

Limitações conhecidas

As seguintes restrições conhecidas aplicam-se à integração da biblioteca de variáveis em pipelines no Data Factory do Microsoft Fabric:

  • A biblioteca de variáveis suporta Boolean, Datetime, Guid, Integer, Number e String como tipos de dados. No seu pipeline, vê Boolean como tipo Bool, Datetime como tipo String, Guid como tipo String, Integer como tipo Int e String como tipo String. Os tipos numéricos não são suportados em pipelines.

Conteúdo relacionado

  • Last updated on