Compartilhar via


Integração da biblioteca de variáveis com pipelines

A biblioteca de variáveis é um novo tipo de item no Microsoft Fabric que permite que os usuários definam e gerenciem variáveis no nível do espaço de trabalho, para que possam ser usadas em breve em vários itens do espaço de trabalho, como pipelines, notebooks, atalhos para o lakehouse e muito mais. Ele fornece uma maneira unificada e centralizada de gerenciar configurações, reduzindo a necessidade de valores codificados e simplificando seus processos de CI/CD, facilitando o gerenciamento de configurações em diferentes ambientes.

Como usar a biblioteca de variáveis com pipelines

  1. Navegue até o workspace e crie um novo item.

    Captura de tela mostrando onde adicionar um novo item ao ambiente de trabalho do Fabric destacado.

  2. Use o filtro para localizar a biblioteca de variáveis ou desça até a seção de Desenvolvimento de dados.

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

  3. Selecione a biblioteca variável para criar uma nova biblioteca de variáveis. Escolha um nome e clique em Criar.

    Captura de tela mostrando um novo item de biblioteca variável com um conjunto de nomes e o botão Criar realçado.

  4. Depois que a biblioteca variável for criada, você será levado para a home page. Clique em + Novo para adicionar uma nova variável.

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

  5. Depois de adicionar uma nova variável, você pode configurar sua variável e definir o conjunto de valores Name, Type e Default. Você também pode adicionar Anotações.

    Captura de tela 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 implantação). Depois de definir um nome e clicar em Criar, você pode editar os valores da variável e escolher o valor definido para tornar ativo.

    Captura de tela realçando 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. Salve suas alterações quando terminar.

Captura de tela mostrando o botão Salvar realçado no canto superior esquerdo.

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

  1. Para usar uma variável da biblioteca de variáveis no pipeline, crie um pipeline ou navegue até um pipeline existente.

    Captura de tela destacando o botão de criar novo item no canto superior esquerdo e o item da pipeline destacado.

  2. No pipeline, você precisa criar uma referência à variável da biblioteca de variáveis no painel inferior.

    Captura de tela realçando a guia Variáveis de Biblioteca e o botão +Novo no painel inferior da tela do pipeline.

  3. Depois de clicar em + Novo, será aberto um pop-up que mostra todas as suas bibliotecas variáveis. Você pode usar esse seletor para selecionar sua variável de biblioteca variável e clicar em Ok.

    Captura de tela mostrando o botão +Novo na guia de variáveis da biblioteca destacado.

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

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

  4. Depois de adicionar as referências de variável da biblioteca, adicione as atividades de pipeline. Nas configurações de atividade, clique em Adicionar conteúdo dinâmico para a configuração que você deseja parametrizar.

    Captura de tela que mostra Adicionar o conteúdo dinâmico realçado nas configurações de uma atividade de Pesquisa.

  5. O Construtor de Expressões é aberto. Se você não vir variáveis de Biblioteca, clique nos três ponto ao lado de Funções e selecione Variáveis de Biblioteca.

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

  6. Clique em sua referência de variável biblioteca para adicionar uma nova expressão ao construtor de expressões. Em seguida, clique em Ok para adicionar sua expressão.

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

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

  7. Agora você verá que o conteúdo dinâmico é adicionado à sua configuração de atividade.

    Captura de tela mostrando o conjunto de expressões como conteúdo dinâmico nas configurações de atividade de pesquisa.

  8. Você pode visualizar seus dados clicando em Visualizar dados. Isso abrirá um novo painel que mostra o valor da variável de biblioteca. Clique em Ok para obter uma visualização dos dados.

    Captura de tela mostrando a opção de dados de visualização.

    Captura de tela mostrando o painel de dados de visualização.

  9. Salve e execute o pipeline como faria normalmente. Você verá que o valor passado é qualquer valor definido como Ativo em sua biblioteca de variáveis.

    Captura de tela que mostra as configurações Salvar e Executar realçadas na tela do pipeline.

Limitações conhecidas

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

  • A biblioteca variável dá suporte a Boolean, Datetime, Guid, Integer, Number e String como tipos de dados. No pipeline, você verá Boolean como tipo Bool, Datetime como tipo String, Guid como tipo String, Integer como tipo Int e String como tipo String. Não há suporte para tipos numéricos em pipelines.
  • Há suporte para a parametrização de conexões externas com uma biblioteca de variáveis integrada aos pipelines. No entanto, você deve procurar o GUID para sua conexão em Configurações | Gerenciar conexões e gateways. Lá, você encontrará o GUID para sua conexão selecionando Configurações ao lado do nome da conexão.