Partilhar via

Integração de bibliotecas variáveis com pipelines

A biblioteca de variáveis é um novo tipo de item no Microsoft Fabric que permite aos usuários definir e gerenciar 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, blocos de anotações, atalho para 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 espaço de trabalho e crie 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. Escolha um nome e pressione 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 que a biblioteca de variáveis for criada, você será levado para a página inicial. Clique em + 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. Depois de adicionar uma nova variável, você pode configurar sua variável e definir o conjunto de valores Name, Type e Default. 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 implantação). Depois de definir um nome e clicar em Criar, você pode editar os valores das variáveis e escolher o conjunto de valores para tornar ativo.

    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. Guarde as alterações assim que terminar.

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 de biblioteca de variáveis 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 painel inferior do seu pipeline, você precisa criar uma referência à variável da biblioteca de variáveis.

    Captura de tela destacando a guia Variáveis da 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 de variáveis. Você pode usar esse seletor para selecionar sua variável de biblioteca de variáveis e clicar em 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 adicionar as referências de variáveis da sua biblioteca, adicione as atividades do pipeline. Nas configurações de atividade, clique em 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 variáveis de biblioteca, clique nos três pontos ao lado de funções e selecione 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. Clique na referência da 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 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.

  7. Agora você verá que o conteúdo dinâmico foi adicionado à sua 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.

  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 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.

  9. Salve e execute o seu pipeline como faria normalmente. Você verá que o valor passado é qualquer valor definido como Ativo na sua 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. Em seu pipeline, você verá 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.
  • A parametrização de conexão externa é suportada através de uma biblioteca de variáveis integrada com pipelines. No entanto, é necessário procurar o GUID para a sua conexão em Definições | Gerir ligações e gateways. Lá, você encontrará o GUID da sua conexão, selecionando Configurações ao lado do nome da sua conexão.

Conteúdo relacionado

  • Last updated on