Compartilhar via

Converter parâmetros globais do Azure Data Factory em bibliotecas de variáveis do Fabric Data Factory

Microsoft Fabric usa bibliotecas de variáveis em workspaces para definir constantes em pipelines e outros itens do Data Factory e Fabric. Você pode migrar parâmetros globais do ADF para bibliotecas de variáveis do Fabric com algumas etapas manuais.

Este guia orienta você pelo processo:

  • Exportar seus parâmetros globais do ADF
  • Criar variáveis de workspace no Fabric
  • Atualizar expressões de pipeline
  • Validar o comportamento

Entender a biblioteca de variáveis do Fabric

A biblioteca de variáveis do Fabric armazena valores em nível de espaço de trabalho que você pode referenciar dentro de pipelines e atividades. Ele dá suporte a tipos como cadeia de caracteres, número e booliano, além de valores seguros para segredos. Você pode versionar bibliotecas de variáveis e implantá-las em diferentes ambientes utilizando pipelines de implantação.

Ao contrário dos parâmetros globais do ADF, as variáveis fabric oferecem segurança mais rigorosa, reutilização mais fácil e melhores controles de governança. Você pode aplicá-los em todos os itens do Fabric. Para obter mais informações, consulte Introdução às bibliotecas de variáveis.

Migrar parâmetros globais do ADF para a biblioteca de variáveis do Fabric

  1. Exporte seus parâmetros globais do ADF.

    1. No Azure Data Factory Studio, vá para Gerenciar>Parâmetros Globais. Registre o nome, o tipo e o valor de cada parâmetro.
    2. Para migrações grandes, acesse Gerenciar>modelo do ARM e exportar modelos do ARM para extrair parâmetros programaticamente. Você pode encontrá-los na pasta de modelo dentro da pasta de fábrica, no arquivo que termina em ParametersForFactory

  2. Compare os tipos disponíveis.

    Examine os tipos de parâmetro global do ADF (cadeia de caracteres, int, bool etc.) e compare-os com tipos de biblioteca de variáveis do Fabric. Anote quaisquer diferenças de tipo que possam exigir ajustes durante a migração.

  3. Crie uma biblioteca de variáveis no Fabric.

    1. No workspace do Fabric, selecione + Novo Item e pesquise e selecione Biblioteca de variáveis.
    2. Crie uma biblioteca (por exemplo, GlobalParams).
    3. Abra sua nova biblioteca de variáveis, selecione +Nova variável e cada parâmetro global do ADF como uma variável.

    Para obter mais informações sobre como criar bibliotecas de variáveis, consulte Introdução às bibliotecas de variáveis.

  4. Atualizar expressões de pipeline migradas.

    Atualize referências de parâmetros globais como @globalParameters('ParamName') para referências de bibliotecas de variáveis como @pipeline.libraryVariables.ParamName.

    Atualize todas as expressões de atividade, cadeias de conexão, argumentos de script, lógica de filtro e propriedades do conjunto de dados. Para obter mais informações, consulte a integração da biblioteca de variáveis com pipelines de dados.

  5. Validar o comportamento do pipeline.

    Realize execuções de validação e teste para confirmar se as variáveis são resolvidas corretamente em seus pipelines. Verifique se conexões, associações de parâmetro e uso seguro de variável funcionam conforme o esperado.

Padrões comuns de migração

Aqui estão alguns padrões de migração que você pode usar ao converter parâmetros globais em bibliotecas de variáveis:

  • Mapeamento direto – parâmetros simples do ADF, como região ou nome de locatário, são mapeados um a um para entradas da biblioteca de variáveis.

  • Bibliotecas específicas do ambiente — em vez de uma biblioteca, crie várias bibliotecas (Global-Dev, Global-Test, Global-Prod). Pipelines de implantação podem vincular a biblioteca correta com base no ambiente.

  • Modelo híbrido – Mantenha constantes compartilhadas na biblioteca de variáveis, mas passe informações específicas da execução por meio de parâmetros de pipeline.

Limitações atuais

Atualmente, há algumas limitações a serem observadas:

  • A ferramenta de migração do PowerShell do Azure Data Factory para o Microsoft Fabric não migra automaticamente parâmetros globais.
  • Expressões dentro de serviços vinculados ou pipelines que fazem referência a @globalParameters() não são reescritas automaticamente.
  • As conexões de Fabric (substituição dos serviços vinculados do Azure Data Factory) não suportam expressões de parâmetro da mesma forma. Você precisa re-criar manualmente todos os parâmetros dinâmicos usados nas definições de conexão.

Práticas recomendadas

Tenha estas dicas em mente:

  • Alinhar convenções de nomenclatura antes da migração.
  • Evite sobrecarregar variáveis no nível do workspace. Em vez disso, use parâmetros de pipeline para valores de tempo de execução.
  • Use pipelines de implantação para gerenciar bibliotecas de variáveis específicas do ambiente.
  • Documente sua biblioteca de variáveis para que os membros da equipe saibam quais pipelines dependem de quais variáveis.

Conteúdo relacionado

  • Last updated on