Variáveis - Data Management: Central de Documentação do Alibaba Cloud

Visão geral das variáveis

Variáveis são valores dinâmicos em um fluxo de tarefas, classificadas como variáveis de sistema, variáveis de tempo e variáveis sem tempo. Referencie qualquer variável dentro de um nó usando a sintaxe ${varName}.

Variáveis de sistema

Variáveis de sistema são valores predefinidos, como o ID do fluxo de tarefas atual e o horário de execução do fluxo.

Nota

Se uma variável personalizada tiver o mesmo nome de uma variável de sistema, o valor da variável personalizada substituirá o da variável de sistema, pois tem prioridade mais alta.

Variáveis de tempo

Variável de fluxo de tarefas (variável global): calculada pela aplicação de um deslocamento de tempo ao timestamp de dados. Por padrão, o timestamp de dados corresponde ao horário de execução menos um dia. Como variável global, está disponível para todos os nós no fluxo de tarefas atual.

Nota
Configure uma variável de fluxo de tarefas em qualquer nó do fluxo. O sistema sincroniza automaticamente a configuração com todos os outros nós.
Variável de nó: variável de tempo criada pela aplicação de um deslocamento à variável integrada bizdate (T-1). O escopo dessa variável limita-se ao nó que a define.

Por exemplo, se a data atual for 22 de agosto de 2023 e você aplicar um deslocamento de +1 dia, o valor da variável será 23 de agosto de 2023.

Variáveis sem tempo

Constante de fluxo de tarefas (variável global): valor fixo utilizável em todos os nós do fluxo de tarefas atual.
Variável de entrada: o sistema preenche automaticamente essas variáveis. Referencie uma variável de entrada nas instruções SQL do nó atual usando a sintaxe ${var_name} ou como variável condicional em um nó Conditional Branch. As variáveis de entrada incluem:
- Variável upstream: variável de saída proveniente de um nó anterior.
- Variável de status: para mais informações, consulte Variáveis de status.
- Variável de sistema: para mais informações, consulte Variáveis de sistema.
Variável de saída: defina e atribua um valor a essa variável no nó atual. Nós subsequentes poderão acessá-la e referenciá-la.

Por exemplo, ao configurar uma variável de saída em um nó Script, referencie-a nas instruções SQL de um nó downstream.
Variável de saída de um nó Single Instance SQL: use este nó para definir um conjunto de resultados a partir de uma consulta SQL, formando uma matriz bidimensional. Durante a definição da variável, extraia um único elemento ou concatene todos os valores de uma linha ou coluna.
Variável de saída de script: se a última linha da saída do script for um objeto JSON no formato { key1: value1, key2: value2, … } e os valores forem do tipo String, a tarefa de script analisará automaticamente os pares chave-valor do JSON. Isso cria uma variável chamada key, cujo valor corresponde ao respectivo valor no JSON. Referencie essa variável como ${key}.

Por exemplo, se a última linha do script for echo {"hello": "world"}, a tarefa criará uma variável chamada hello com o valor world.

Configurar variáveis de tempo

Parâmetro

Descrição

Variable name

Insira o nome da variável personalizada.

Nota

Para excluir uma variável configurada, clique em 删除-变量 .

Variable rule

Configure as regras para a variável de tempo.

Formato de hora: especifique o formato desejado. Para mais informações, consulte Formatos de tempo.
Deslocamento de tempo: o sistema calcula a variável de tempo aplicando um deslocamento ao timestamp de dados (bizdate), que por padrão é o dia anterior ao horário de execução do fluxo de tarefas.

Por exemplo, considere uma variável chamada 6_month_ago com formato yyyy-MM-dd e deslocamento de -6 meses. Se o horário de execução for 2021-08-12 (tornando o bizdate 2021-08-11), o valor da variável ${6_month_ago} será 2021-02-11.

O uso de mês ou ano como unidade de deslocamento pode resultar em sequências de datas não contínuas. Para uma sequência diária contínua, utilize dia como unidade de deslocamento.

Nota

Após configurar uma variável de tempo, referencie-a em instruções SQL usando a sintaxe ${var_name}. Clique também em SQL Preview para verificar o valor da variável.

Formatos de tempo

A tabela a seguir descreve os especificadores de formato de tempo compatíveis.

Especificador	Descrição	Exemplo de entrada	Exemplo de saída
Era	`G` indica a era.	Gyyyy	AD 2021
Ano	`y` ou `yyyy`: o ano. `yy`: os dois últimos dígitos do ano. `Y`: o ano de numeração de semana, correspondente ao ano no final da semana (domingo).	yyyy	2021
Mês	`M`: o mês do ano. Valores válidos: [1,12]. `MM`: preenchido com zero à esquerda. Valores válidos: [01,12].	MM	08
Semana	`w`: a semana do ano. Valores válidos: [1, 52]. `ww`: preenchido com zero à esquerda. Valores válidos: [01, 52]. `W`: a semana do mês. Valores válidos: [1, 5].	ww	13
Dia	`D`: o dia do ano. Valores válidos: [1, 365]. `DD`: preenchido com zero à esquerda. Valores válidos: [01, 365]. `DDD`: preenchido com dois zeros à esquerda. Valores válidos: [001, 365]. `d`: o dia do mês. Valores válidos: [1, 31]. `dd`: preenchido com zero à esquerda. Valores válidos: [01, 31].	D	360
Dia da semana	`E`: o nome do dia da semana, de segunda a domingo. `e`: o número do dia da semana. Valores válidos: [1, 7]. Por padrão, 1 representa segunda-feira. Nota Defina o deslocamento de tempo como +1 dia para alinhar com calendários em que 1 representa domingo.	e	1
AM/PM	`a`: o marcador AM/PM. Retorna AM para horários de 00:00 a 11:59 e PM para horários de 12:00 a 23:59.	a	AM
Hora	`H`: a hora do dia (0-23). `0` representa meia-noite. Valores válidos: [0, 23]. `HH`: preenchido com zero à esquerda. Valores válidos: [00, 23]. `h`: a hora no formato AM/PM (1-12). `1` representa a primeira hora. Valores válidos: [1, 12]. `hh`: preenchido com zero à esquerda. Valores válidos: [01, 12]. `K`: a hora no formato AM/PM (0-11). `0` representa a primeira hora. Valores válidos: [0, 11]. `KK`: preenchido com zero à esquerda. Valores válidos: [00, 11]. `k`: a hora do dia (1-24). `1` representa a primeira hora. Valores válidos: [1, 24]. `kk`: preenchido com zero à esquerda. Valores válidos: [01, 24].	HH	10
Minuto	`m`: o minuto da hora. Valores válidos: [0, 59]. `mm`: preenchido com zero à esquerda. Valores válidos: [00, 59].	m	27
Segundo	`s`: o segundo do minuto. `S`: o milissegundo.	ss	08
Fuso horário	`z`: o fuso horário.	z	UTC+08:00

Exemplos de formatos de tempo combinados:

Exemplo de entrada	Exemplo de saída
`yyyy-MM-dd`	2021-08-12
`yyyyMM01`	20210801
`HH:mm:ss`	11:05:21
`yyyyMMdd HH:mm:ss`	20210812 11:05:21

Variáveis de sistema

Nome da variável	Descrição	Exemplo
sys.flow.start.timestamp	O timestamp do horário de execução.	2021-05-24T11:20:07.562+08:00
sys.flow.start.year	O ano do horário de execução.	2021
sys.flow.start.month	O mês do horário de execução.	5
sys.flow.start.day	O dia do horário de execução.	24
sys.flow.start.hour	A hora do horário de execução.	11
sys.flow.start.minute	O minuto do horário de execução.	20
sys.flow.start.second	O segundo do horário de execução.	7
sys.flow.start.milliseconds	Os milissegundos do horário de execução.	562
sys.flow.start.timezone	O fuso horário do horário de execução.	Asia/Shanghai
sys.flow.biztime	O timestamp de dados. Por padrão, corresponde ao horário de execução menos um dia.	1621740007562
sys.flow.name	O nome do fluxo de tarefas.	dwd_activity_daily_pv
sys.node.name	O nome do nó.	Single Instance SQL-1

Variáveis de status

Nome da variável	Descrição
all_success	Todas as tarefas upstream foram executadas com êxito.
all_failed	Todas as tarefas upstream falharam.
one_success	Pelo menos uma tarefa upstream foi executada com êxito.
one_failed	Pelo menos uma tarefa upstream falhou.

Nota

Use variáveis de status em um nó Conditional Branch para controlar se o fluxo de tarefas executa tarefas subsequentes com base em um status específico de execução.