Parâmetros e variáveis de pipeline em Azure Data Factory e Azure Synapse Analytics

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Tip

Data Factory no Microsoft Fabric é a próxima geração de Azure Data Factory, com uma arquitetura mais simples, IA interna e novos recursos. Se você não estiver familiarizado com a integração de dados, comece com Fabric Data Factory. As cargas de trabalho existentes do ADF podem ser atualizadas para Fabric para acessar novos recursos em ciência de dados, análise em tempo real e relatórios.

Este artigo ajuda você a entender a diferença entre parâmetros de pipeline e variáveis em Azure Data Factory e Azure Synapse Analytics e como usá-los para controlar o comportamento do pipeline.

Parâmetros do pipeline

Os parâmetros são definidos no nível do pipeline e não podem ser modificados durante uma execução de pipeline. Os parâmetros de pipeline podem ser usados para controlar o comportamento de um pipeline e suas atividades, como passando os detalhes da conexão para um conjunto de dados ou o caminho de um arquivo a ser processado.

Como definir um parâmetro de pipeline

Para definir um parâmetro de pipeline, siga estas etapas:

  • Selecione seu pipeline para visualizar suas guias de configuração.
  • Selecione a guia "Parâmetros" e selecione o botão "+ Novo" para definir um novo parâmetro.
  • Insira um nome e uma descrição para o parâmetro e selecione seu tipo de dados no menu suspenso. Os tipos de dados podem ser String, Int, Float, Bool, Array, Object ou SecureString.
  • Opcionalmente, você também pode atribuir um valor padrão ao parâmetro.

Depois de definir um parâmetro de pipeline, você pode acessar seu valor durante uma execução de pipeline usando a expressão @pipeline().parameters.<parameter name> em uma atividade de pipeline. Por exemplo, se você definiu um parâmetro chamado account_name do tipo String, poderá acessar seu valor em uma atividade usando a expressão @pipeline().parameters.account_name.

Captura de tela da definição de parâmetro.

Antes de cada execução de pipeline, você pode atribuir um novo valor ao parâmetro no painel direito, caso contrário, o pipeline usará o padrão ou o valor definido anteriormente.

Variáveis de pipeline

Variáveis de pipeline são valores que podem ser definidos e modificados durante uma execução de pipeline. Ao contrário dos parâmetros de pipeline, que são definidos no nível do pipeline e não podem ser alterados durante uma execução de pipeline, as variáveis de pipeline podem ser definidas e modificadas em um pipeline usando uma atividade Set Variable .

As variáveis de pipeline podem ser usadas para armazenar e manipular dados durante uma execução de pipeline, como armazenando os resultados de uma computação ou o estado atual de um processo.

Note

No momento, as variáveis estão no escopo no nível do pipeline. Isso significa que eles não são thread safe e podem causar comportamento inesperado e indesejado se forem acessados de dentro de uma atividade de iteração paralela, como um loop foreach, especialmente quando o valor também está sendo modificado dentro dessa atividade foreach.

Para definir uma variável de pipeline, siga estas etapas:

  • Selecione seu pipeline para visualizar suas guias de configuração.

  • Selecione a guia "Variáveis" e selecione o botão "+ Novo" para definir uma nova variável.

  • Insira um nome e uma descrição para a variável e selecione seu tipo de dados no menu suspenso. Os tipos de dados podem ser String, Bool ou Array.

  • Opcionalmente, você também pode atribuir um valor padrão à variável. Esse valor será usado como o valor inicial da variável no início de uma execução de pipeline.

Depois de definir um parâmetro de pipeline, você pode acessar seu valor durante uma execução de pipeline usando a expressão @variables('<variable name>') em uma atividade de pipeline. Por exemplo, se você definiu uma variável chamada sinalizador do tipo Array, poderá acessar seu valor em uma atividade usando a expressão @variables('flag'). Você também pode usar uma atividade "Definir Variável" para modificar o valor da variável em um pipeline.

Captura de tela da definição de variável.

Conteúdo relacionado

Confira os tutoriais a seguir para obter instruções passo a passo para criar pipelines com atividades:

Como obter CI/CD (integração e entrega contínuas) usando Azure Data Factory

  • Last updated on