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!

Os parâmetros globais são constantes em uma fábrica de dados que podem ser consumidas por um pipeline 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 (em 'Gerenciar hub' –> 'Modelo do ARM' – >'Incluir parâmetros globais no modelo do ARM'), conforme ilustrado abaixo, não entrará em conflito ou substituirá as configurações de nível de fábrica como costumava ocorrer antes, portanto, não é necessário utilizar o PowerShell para a implantação de parâmetros globais durante a CI/CD.

Observação

Modificamos a experiência da interface do usuário para incluir os parâmetros globais da seção 'Parâmetros globais' na seção 'Modelo do ARM' no hub de gerenciamento. Se você já estiver usando o mecanismo mais antigo (em 'Gerenciar hub' –> 'Parâmetros globais' –> 'Incluir no modelo do ARM'), será possível continuar com o uso. O suporte continuará sendo fornecido.

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ínuas, 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 ao vivo" ou no modo "Data Factory".

Aviso

Não é possível usar '-' no nome do parâmetro. Você receberá um errorcode "{"code":"BadRequest","message":"ErrorCode=InvalidTemplate,ErrorMessage=The expression >'pipeline().globalParameters.myparam-dbtest-url' is not valid: .....}". É 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