
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:
| Tipo | Convençã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
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:
| Objeto | Tipo | Utilizado por |
|---|---|---|
| Cargo | Variável global | Qualquer objeto no job. |
| Cargo | Variável local | Um script ou condicional no job. |
| Fluxo de trabalho | Variável local | Esse fluxo de trabalho ou passado para outros fluxos de trabalho ou fluxos de dados usando um parâmetro. |
| Fluxo de trabalho | Parâmetro | Objetos superiores para transferir variáveis. Os fluxos de trabalho também podem retornar variáveis ou parâmetros a objetos pai. |
| Fluxo de dados | Parâmetro | Uma 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.