Uso de funções, scripts e variáveis

Projetando objetos reutilizáveis independentes com variáveis e parâmetros

Objective

After completing this lesson, you will be able to projetar objetos reutilizáveis independentes

Variáveis e parâmetros

Definições

Variáveis

Uma variável é um componente comum que atua como caractere de preenchimento para representar valores com potencial de modificação cada vez que um job é executado. Para facilitar a identificação de variáveis em uma expressão, os nomes das variáveis começam com um sinal de dólar ($). Eles podem ser de qualquer tipo de dados suportado pelo Data Services.

Uma variável pode ser Global ou Local.

  • Variáveis globais
    • Definir no nível do job
    • Disponível para atribuição ou referência em objetos inferiores
    • Pode ser atribuído no job e/ou características de execução
  • Variáveis locais
    • Variável relacionada ao objeto
    • Não disponível diretamente em objetos referenciados
    • Só pode ser atribuído por meio de scripts

Parâmetros

Um parâmetro é outro tipo de caractere de preenchimento que chama uma variável.

Esta chamada permite que o valor da variável em um job ou fluxo de trabalho seja transferido para o parâmetro em um fluxo de trabalho ou fluxo de dados dependente. Os parâmetros são mais comumente usados para filtrar dados em cláusulas WHERE.

  • Parâmetros
    • Pode ser entrada ou saída, uma maneira ou duas maneiras
    • Atribuído na aba Chamadas de Variáveis e Parâmetros
    • Chama uma variável

Nomeação de variáveis e parâmetros

Convenção de nomes

Inicie todos os nomes com um sinal de dólar ($) e use os prefixos na tabela como uma convenção de nomes para garantir a consistência em todos os projetos:

TipoConvenção de nomes
Variável global$G_
Variável local$L_
Parâmetro$P_

Variáveis globais versus variáveis e parâmetros locais

As variáveis locais são restritas ao job ou fluxo de trabalho no qual são criadas. Você só pode atribuir uma variável local por meio de um script. Você pode usar parâmetros para transferir variáveis locais para os fluxos de trabalho e fluxos de dados no objeto. Uma variável local é incluída como parte da definição do fluxo de trabalho ou fluxo de dados e, portanto, é portátil entre os trabalhos.

As variáveis globais também estão restritas ao job no qual são criadas. Seu valor pode ser atribuído por meio de um script ou na execução. Eles não exigem que os parâmetros sejam transferidos para fluxos de trabalho e fluxos de dados nesse job. Você pode referenciar a variável global diretamente em expressões para qualquer objeto do job.

Cuidado

Tenha cuidado ao usar Variáveis globais. Seu fluxo de trabalho ou fluxo de dados utilizando variáveis globais se tornam dependentes da definição de job e podem não ser facilmente reutilizados.

Variáveis globais podem simplificar seu trabalho. Defina valores para variáveis globais em objetos de script, usando a execução externa do job ou propriedades de programação. Por exemplo, durante a produção, você pode modificar valores para variáveis globais padrão no momento da execução a partir da programação de um job sem ter que abrir um job no Designer.

Variáveis e parâmetros por tipo de objeto

A tabela resume as variáveis e os parâmetros que você pode criar para cada tipo de objeto:

ObjetoTipoUtilizado por
CargoVariável globalQualquer objeto no job.
CargoVariável localUm script ou condicional no job.
Fluxo de trabalhoVariável localEsse fluxo de trabalho ou passado para outros fluxos de trabalho ou fluxos de dados usando um parâmetro.
Fluxo de trabalhoParâmetroObjetos superiores para transferir variáveis. Os fluxos de trabalho também podem retornar variáveis ou parâmetros a objetos pai.
Fluxo de dadosParâmetroUma cláusula WHERE, mapeamento de coluna ou função no fluxo de dados. Os fluxos de dados não podem retornar valores de saída.

Definir valor padrão de variáveis globais

Além de definir uma variável dentro de um job usando um script, você pode definir e atualizar valores padrão globais de variável usando propriedades do job.

Os valores definidos nas propriedades do job são processados da mesma forma que os valores definidos em um script. Se você definir um valor para a mesma variável em um script e nas propriedades do job, o valor do script substituirá o valor da propriedade.

Todos os valores definidos como propriedades do job são exibidos na janela Propriedades. Ao definir valores fora de um script, você pode confiar na janela Propriedades para visualizar valores que foram definidos para variáveis globais e editar facilmente valores ao testar ou programar um job.

Configuração de variáveis globais utilizando propriedades de execução

Você também pode visualizar e editar esses valores padrão na caixa de diálogo Propriedades de execução do Designer. Isso permite que você substitua valores de característica de job no momento da execução. O Data Services grava valores no repositório como características de job.

Vamos tentar isso

Primeiro, vou orientá-lo sobre o uso de uma variável global:

Agora, vamos ver como você pode tornar seu fluxo de dados mais facilmente reutilizável:

Se você quiser testá-lo sozinho, vá em frente: