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

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

Este guia guia-o pelo processo:

  • Exporte os seus parâmetros globais do Azure Data Factory
  • 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 ao nível da área de trabalho, aos quais pode fazer referência 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 Azure Data Factory, 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 do Azure Data Factory para a biblioteca de variáveis Fabric

  1. Exporte os seus parâmetros globais do Azure Data Factory.

    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 tipos globais de parâmetros do Azure Data Factory (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. 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 do Azure Data Factory 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 do Azure Data Factory, como a região ou o nome do tenant, correspondem diretamente a entradas na biblioteca de variáveis.

  • 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 integrada nem a ferramenta de atualização PowerShell atualizam 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

  • Última atualização a