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

A Microsoft Fabric utiliza bibliotecas de variáveis em espaços de trabalho para definir constantes dentro de pipelines e outros itens do Data Factory e Fabric. Podes migrar parâmetros globais ADF para bibliotecas de variáveis Fabric com alguns passos manuais.

Este guia guia-o pelo processo:

  • Exporte os seus parâmetros globais ADF
  • Criar variáveis de espaço de trabalho no Fabric
  • Atualizar expressões de pipeline
  • Validar comportamento

Compreender a biblioteca de variáveis Fabric

A biblioteca de variáveis Fabric armazena valores ao nível do espaço de trabalho que podem ser referenciados entre pipelines e atividades. Suporta tipos como string, number e boolean, além de valores seguros para segredos. Podes versionar bibliotecas de variáveis e implementá-las em ambientes com pipelines de implementaçã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 controlos de governação. Podes aplicá-los em todos os itens Fabric. Para mais informações, consulte Começar com bibliotecas de variáveis.

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

  1. Exporta os teus parâmetros globais do ADF.

    1. Em Azure Data Factory Studio, vá a Gerir>Parâmetros Globais. Regista o nome, tipo e valor de cada parâmetro.
    2. Para migrações grandes, vá a Gerenciar>template ARM e exporte templates ARM para extrair parâmetros programaticamente. Podes encontrá-los na pasta de templates, abaixo da pasta de fábrica , no ficheiro que termina em ParametersForFactory

  2. Compare os tipos disponíveis.

    Revê os teus tipos globais de parâmetros ADF (string, int, bool, etc.) e compara-os com Fabric tipos de bibliotecas de variáveis. Note quaisquer diferenças de tipo que possam exigir ajustes durante a migração.

  3. Criar uma biblioteca de variáveis em Fabric.

    1. No seu espaço de trabalho Fabric, selecione + Novo item e depois procure e selecione Variable library.
    2. Crie uma biblioteca (por exemplo, GlobalParams).
    3. Abra a sua nova biblioteca de variáveis, selecione +Nova variável e cada parâmetro global ADF como variável.

    Para mais informações sobre a criação de bibliotecas de variáveis, consulte Começar com bibliotecas de variáveis.

  4. Atualizar expressões de pipeline migradas.

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

    Atualiza todas as expressões de atividade, strings de ligação, argumentos de script, lógica de filtro e propriedades do conjunto de dados. Para obter mais informações, veja Integração de bibliotecas de variáveis com pipelines de dados.

  5. Valide o comportamento do pipeline.

    Execute validações e testes para confirmar que as variáveis resolvem corretamente nos seus pipelines. Verifica se as ligações, as ligações de parâmetros e o uso seguro de variáveis funcionam como esperado.

Padrões comuns de migração

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

  • Mapeamento direto — Parâmetros simples de ADF, como região ou nome do inquilino, mapeiam entradas de biblioteca de um para um.

  • Bibliotecas específicas do ambiente — Em vez de uma única biblioteca, crie múltiplas bibliotecas (Global-Dev, Global-Test, Global-Prod). As pipelines de implementação podem associar a biblioteca correta com base no ambiente.

  • Modelo híbrido — Mantém as constantes partilhadas na biblioteca de variáveis, mas transmite informação específica da execução através dos parâmetros do pipeline.

Limitações atuais

Atualmente, existem algumas limitações a ter em conta:

  • Nem a experiência de atualização incorporada nem a ferramenta de migração PowerShell migram automaticamente parâmetros globais.
  • Expressões dentro de serviços vinculados ou pipelines que referenciam @globalParameters() não são automaticamente reescritas.
  • As conexões Fabric (a substituição dos serviços vinculados do Azure Data Factory) não suportam expressões de parâmetros da mesma forma. Tens de reescrever manualmente quaisquer parâmetros dinâmicos usados nas definições de ligação.

Melhores práticas

Tenha estas dicas em mente:

  • Alinhe as convenções de nomeação antes da migração.
  • Evite sobrecarregar variáveis ao nível do espaço de trabalho. Use os parâmetros do pipeline para os valores de tempo de execução em vez disso.
  • Use pipelines de implementação para gerir bibliotecas de variáveis específicas do ambiente.
  • Documente a sua biblioteca de variáveis para que os membros da equipa saibam quais pipelines dependem de quais variáveis.

Conteúdo relacionado

  • Last updated on