Partilhar via

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

O Microsoft Fabric utiliza bibliotecas de variáveis em espaços de trabalho para definir constantes entre pipelines e outros itens do Data Factory e do 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 do Fabric armazena valores a nível de espaço de trabalho que pode referenciar em 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 do 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. No Azure Data Factory Studio, vá a Gerenciar>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 os tipos de bibliotecas de variáveis do Fabric. Note quaisquer diferenças de tipo que possam exigir ajustes durante a migração.

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

    1. No teu espaço de trabalho do Fabric, seleciona + Novo Item e depois procura e seleciona Biblioteca de variáveis.
    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:

  • A ferramenta de migração Azure Data Factory para Microsoft Fabric PowerShell não migra automaticamente parâmetros globais.
  • Expressões dentro de serviços vinculados ou pipelines que referenciam @globalParameters() não são automaticamente reescritas.
  • As ligações Fabric (a substituição dos serviços associados 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