Partilhar via

Parâmetros globais no Azure Data Factory

  • Artigo

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 e implantação contínua (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.

Captura de tela que destaca o botão Novo selecionado para criar parâmetros globais.

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

Captura de tela que mostra onde você adiciona o nome, o tipo de dados e o valor para o novo parâmetro global.

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.

Criar parâmetros globais

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>.

Usando parâmetros globais

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.

Captura de ecrã de 'Incluir no modelo ARM'.

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.

A pasta Parâmetros no modelo ARM baixado contém arquivos JSON que definem os parâmetros usados no modelo 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á a funcionar:

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

  • 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