Parâmetros globais no Azure Data Factory

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Gorjeta

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

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 nomes e valores de parâmetros idênticos. Ao promover uma fábrica de dados usando o processo de integração contínua e implantação (CI/CD), você pode substituir esses parâmetros em cada ambiente.

Criação de parâmetros globais

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

No painel de 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 só vez, selecione Editar tudo.

Usando parâmetros globais em um pipeline

Os parâmetros globais podem ser usados em qualquer expressão de pipeline. Se um pipeline estiver fazendo referência a outro recurso, como um conjunto de dados ou fluxo de dados, você poderá transmitir o valor do parâmetro global por meio dos parâmetros desse recurso. Os parâmetros globais são referenciados como pipeline().globalParameters.<parameterName>.

Parâmetros globais na CI/CD

Recomendamos a inclusão de parâmetros globais no modelo ARM durante o CI/CD. O novo mecanismo de inclusão de parâmetros globais no modelo ARM (de 'Gerenciar hub' - 'Modelo ARM' ->> 'Incluir parâmetros globais no modelo ARM'), conforme ilustrado abaixo, não entrará em conflito/substituirá as configurações de nível de fábrica como costumava fazer anteriormente, portanto, não exigirá PowerShell adicional para implantação de parâmetros globais durante o CI/CD.

Nota

Mudamos a experiência da interface do usuário para incluir parâmetros globais da seção 'Parâmetros globais' para a seção 'Modelo ARM' no hub de gerenciamento. Se você já estiver usando o mecanismo mais antigo (de 'Gerenciar hub' - 'Parâmetros globais' ->> 'Incluir no modelo ARM'), você pode continuar. Continuaremos a apoiá-la.

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á a funcionar:

• Incluir parâmetros globais no modelo ARM (de 'Gerenciar hub' - 'Parâmetros globais' ->> 'Incluir no modelo ARM')

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

Recomendamos vivamente a utilização do novo mecanismo de inclusão de parâmetros globais no modelo ARM (de 'Gerir hub' - 'Modelo ARM' ->> 'Incluir parâmetros globais num modelo ARM'), uma vez que torna o CICD com parâmetros globais muito mais simples e fácil de gerir.

Nota

A configuração Incluir parâmetros globais em um modelo ARM só está disponível no "modo Git". Atualmente, está desativada nos modos “em direto” e “Data Factory”.

Aviso

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

Conteúdos relacionados

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