Parâmetros globais no Azure Data Factory

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Dica

Experimente o Data Factory no Microsoft Fabric, uma solução de análise tudo-em-um para empresas. O Microsoft Fabric abrange desde movimentação de dados até ciência de dados, análise em tempo real, business intelligence e relatórios. Saiba como iniciar uma avaliação gratuita!

Parâmetros globais são constantes em um data factory que os pipelines podem consumir em qualquer expressão. Eles são úteis quando você tem vários pipelines com valores e nomes de parâmetro idênticos. Ao promover uma fábrica de dados usando o processo de implantação e integração contínuas (CI/CD), você pode substituir esses parâmetros em cada ambiente.

Criar parâmetros globais

Para criar um parâmetro global, vá para a guia Parâmetros globais na seção Gerenciar. Selecione Novo para abrir a barra de navegação lateral de criação.

Na navegação lateral, insira um nome, selecione um tipo de dados e especifique o valor do parâmetro.

Depois que um parâmetro global é criado, você pode editá-lo clicando no nome do parâmetro. Para alterar vários parâmetros de uma vez, selecione Editar tudo.

Como usar parâmetros globais em um pipeline

Parâmetros globais podem ser usados em qualquer expressão de pipeline. Se um pipeline estiver referenciando outro recurso, como um conjunto de dados ou um fluxo de dados, você poderá passar o valor dos parâmetros globais por meio dos parâmetros desse recurso. Parâmetros globais são referenciados como pipeline().globalParameters.<parameterName>.

Parâmetros globais no CI/CD

Recomenda-se incluir parâmetros globais no modelo do ARM durante a CI/CD. O novo mecanismo de inclusão de parâmetros globais no modelo do ARM (de "Hub de gerenciamento" -> "modelo do ARM" -> "Incluir parâmetros globais no modelo do ARM") conforme ilustrado na imagem a seguir, não entrará em conflito/ substituirá as configurações de nível de fábrica como costumava fazer anteriormente, não exigindo o PowerShell extra para implantação de parâmetros globais durante CI/CD.

Observação

Movemos a experiência de interface do usuário para incluir parâmetros globais da seção "Parâmetros globais" para a seção "Modelo do ARM" no hub de gerenciamento.

Se você já estiver usando o mecanismo mais antigo (de "Hub de gerenciamento" -> "Parâmetros globais" -> "Incluir no modelo do ARM"), você poderá continuar. Continuaremos a fornecer suporte a ele.

A pasta Parâmetros no modelo do ARM baixado contém arquivos JSON que definem os parâmetros usados no modelo do ARM. Cada arquivo corresponde a um parâmetro global específico.

Se você estiver usando o fluxo mais antigo de integração de parâmetros globais em sua solução de integração e implantação contínua, ele continuará funcionando:

• Incluir parâmetros globais no modelo do ARM (em 'Gerenciar hub' –> 'Parâmetros globais' –> 'Incluir no modelo do ARM')

• Implantar parâmetros globais por meio de um script do PowerShell

É altamente recomendável usar o novo mecanismo de inclusão de parâmetros globais no modelo do ARM (em 'Gerenciar hub' –> 'Modelo do ARM' –> 'Incluir parâmetros globais em um modelo do ARM'), pois ele torna a CI/CD com parâmetros globais muito mais simples e fácil de gerenciar.

Observação

A configuração Incluir parâmetros globais em um modelo do ARM só está disponível no "Modo Git". Atualmente, ele está desabilitado no modo "modo dinâmico" ou "Data Factory".

Aviso

Não é possível usar "-" no nome do parâmetro. Você recebe um código de erro "{"code":"BadRequest","message":"ErrorCode=InvalidTemplate,ErrorMessage=A expressão >"pipeline().globalParameters.myparam-dbtest-url" não é válida: .....}". É possível, no entanto, usar '_' no nome do parâmetro.

Conteúdo relacionado

• Saiba mais sobre o processo de implantação e integração contínuas do Azure Data Factory
• Saiba como usar a linguagem de expressão de fluxo de controle