Tabelas dinâmicas: alterações no valor de retorno e novas colunas adicionadas a DYNAMIC_TABLE_GRAPH_HISTORY, DYNAMIC_TABLE_REFRESH_HISTORY e SHOW DYNAMIC TABLES¶
Atenção
Essa mudança de comportamento está no pacote 2024_02.
Para saber o status atual do pacote, consulte Histórico do pacote.
Comportamento do valor de retorno¶
O comportamento das funções DYNAMIC_TABLE_GRAPH_HISTORY, DYNAMIC_TABLE_REFRESH_HISTORY e SHOW DYNAMIC TABLES mudou. Os valores de retorno para essas funções são exibidos como segue.
Comportamento do valor de retorno para a função DYNAMIC_TABLE_GRAPH_HISTORY¶
Quando esse pacote de mudança de comportamento está ativado, a saída da função DYNAMIC_TABLE_GRAPH_HISTORY inclui as seguintes alterações no valor de retorno:
- Antes da mudança:
 A coluna SCHEDULING_STATE retorna
"state": "RUNNING"ou"state": "SUSPENDED"para descrever o estado da tabela dinâmica.A coluna SCHEDULING_STATE retorna RUNNING se uma tabela upstream foi suspensa e você não tinha o privilégio MONITOR nessa tabela upstream.
- Após a mudança:
 A coluna SCHEDULING_STATE retorna
"state": "ACTIVE"ou"state": "SUSPENDED"para descrever o estado da tabela dinâmica.A coluna SCHEDULING_STATE retorna SUSPENDED, mesmo se você não tiver o privilégio MONITOR em tabelas upstream.
Comportamento do valor de retorno para a função DYNAMIC_TABLE_REFRESH_HISTORY¶
Quando esse pacote de mudança de comportamento está ativado, a saída da função DYNAMIC_TABLE_REFRESH_HISTORY inclui as seguintes alterações no valor de retorno:
- Antes da mudança:
 A coluna LAST_COMPLETED_DEPENDENCY pode retornar valores NULL incorretamente.
A coluna STATE retornou SKIPPED para trabalhos de atualização que foram ignorados devido a uma falha upstream.
Os históricos de atualização foram exibidos para todos os estados dinâmicos da tabela.
- Após a mudança:
 A coluna LAST_COMPLETED_DEPENDENCY agora retorna valores precisos.
A coluna STATE agora retorna UPSTREAM_FAILED para trabalhos de atualização ignorados devido a uma falha upstream.
Os históricos de atualização não serão mais exibidos se a coluna STATE retornar QUEUED ou SKIPPED. (Se a atualização dinâmica da tabela foi ignorada devido a uma falha no upstream, a coluna STATE agora retornará UPSTREAM_FAILED.)
Comportamento do valor de retorno para a função SHOW DYNAMIC TABLE¶
Quando esse pacote de mudança de comportamento está ativado, a saída do comando SHOW DYNAMIC TABLES inclui as seguintes alterações no valor de retorno:
- Antes da mudança:
 A coluna SCHEDULING_STATE retorna RUNNING ou SUSPENDED para descrever o estado da tabela dinâmica.
- Após a mudança:
 A coluna SCHEDULING_STATE retorna ACTIVE ou SUSPENDED para descrever o estado da tabela dinâmica.
Mudanças de coluna¶
Quando ativado, as colunas adicionais a seguir são adicionadas às funções DYNAMIC_TABLE_GRAPH_HISTORY e DYNAMIC_TABLE_REFRESH_HISTORY.
Função DYNAMIC_TABLE_GRAPH_HISTORY: nova coluna na saída¶
Quando esse pacote de mudança de comportamento está ativado, a saída da função DYNAMIC_TABLE_GRAPH_HISTORY inclui a(s) seguinte(s) nova(s) coluna(s):
Nome da coluna  | 
Tipo de dados  | 
Descrição  | 
|---|---|---|
ALTER_TRIGGER  | 
ARRAY  | 
Descreve por que uma nova entrada é criada na função DYNAMIC_TABLE_GRAPH_HISTORY. Isso pode ser o seguinte: 
  | 
Função DYNAMIC_TABLE_REFRESH_HISTORY: novas colunas na saída¶
Quando esse pacote de mudança de comportamento está ativado, a saída da função DYNAMIC_TABLE_REFRESH_HISTORY inclui a(s) seguinte(s) nova(s) coluna(s):
Nome da coluna  | 
Tipo de dados  | 
Descrição  | 
|---|---|---|
TARGET_LAG  | 
TEXT  | 
Esta coluna descreve o valor TARGET_LAG da tabela dinâmica no momento em que ocorreu a atualização.  | 
GRAPH_HISTORY_VALID_FROM  | 
TIMESTAMP_NTZ  | 
Codifica o carimbo de data/hora VALID_FROM da função de tabela DYNAMIC_TABLE_GRAPH_HISTORY quando a atualização ocorreu.  | 
Ref: 1543