Exibição QUERY_HISTORY (Account Usage): mudanças nas colunas e novas colunas (pendente)¶

Atenção

Essa mudança de comportamento está no pacote 2024_02.

Para saber o status atual do pacote, consulte Histórico do pacote.

O Exibição QUERY_HISTORY inclui as seguintes novas colunas e alterações nas colunas:

Novas colunas na exibição QUERY_HISTORY¶

Quando esse pacote de mudança de comportamento está ativado, a exibição Account Usage QUERY_HISTORY inclui as seguintes novas colunas:

Nome da coluna	Tipo de dados	Descrição
SECONDARY_ROLE_STATS	VARCHAR	Uma cadeia de caracteres formatada em JSON que contém três campos relacionados às funções secundárias que foram avaliadas na consulta: uma lista de funções secundárias ou `ALL` dependendo da sessão, uma contagem do número de funções secundárias e o ID interno/gerado pelo sistema para cada função secundária. A contagem e o número de IDs têm no máximo 50.
ROWS_WRITTEN_TO_RESULT	NUMBER	Número de linhas gravadas em um objeto de resultado. Para CREATE TABLE AS SELECT (CTAS) e todas as operações DML, esse resultado é `1`. Os valores nas colunas ROWS_INSERTED, ROWS_UPDATED e ROWS_DELETED refletem o número de linhas realmente inseridas, atualizadas ou excluídas. Para obter mais informações, consulte Coluna obsoleta ROWS_PRODUCED
ROWS_INSERTED	NUMBER	Número de linhas inseridas pela consulta.
QUERY_RETRY_TIME	NUMBER	Tempo total de execução (em milissegundos) para novas tentativas de consulta causadas por erros acionáveis. Para obter mais informações, consulte Colunas de nova tentativa de consulta.
QUERY_RETRY_CAUSE	VARIANT	Matriz de mensagens de erro para erros acionáveis. A matriz contém uma mensagem de erro para cada nova tentativa de consulta. Se não houver nova tentativa de consulta, a matriz estará vazia. Para obter mais informações, consulte Colunas de nova tentativa de consulta.
FAULT_HANDLING_TIME	NUMBER	Tempo total de execução (em milissegundos) para novas tentativas de consulta causadas por erros que não são acionáveis. Para obter mais informações, consulte Colunas de nova tentativa de consulta.

Essas colunas são adicionadas como as últimas colunas (mais à direita) da exibição.

Para obter mais informações, consulte também Information Schema: novas colunas na saída para funções QUERY_HISTORY, QUERY_HISTORY_BY_* (pendente).

Colunas de nova tentativa de consulta¶

Uma consulta pode precisar ser repetida uma ou mais vezes para ser concluída com êxito. Pode haver diversas causas que resultam em uma nova tentativa de consulta. Algumas dessas causas são acionáveis, ou seja, um usuário pode fazer alterações para reduzir ou eliminar novas tentativas de consulta para uma consulta específica. Por exemplo, se uma consulta for repetida devido a um erro de falta de memória, a modificação das configurações do warehouse poderá resolver o problema.

Algumas novas tentativas de consulta são causadas por uma tolerância a falhas que não é acionável. Ou seja, não há nenhuma alteração que um usuário possa fazer para impedir a repetição da consulta. Por exemplo, uma interrupção na rede pode resultar em uma nova tentativa de consulta. Neste caso, não há nenhuma alteração na consulta ou no warehouse que a executa que possa impedir a nova tentativa da consulta.

As colunas QUERY_RETRY_TIME, QUERY_RETRY_CAUSE e FAULT_HANDLING_TIME podem ajudar você a otimizar as consultas que são repetidas e a entender melhor as flutuações no desempenho da consulta.

Coluna obsoleta ROWS_PRODUCED¶

A coluna ROWS_PRODUCED será descontinuada em uma versão futura. O valor na coluna ROWS_PRODUCED nem sempre reflete o número lógico de linhas afetadas por uma consulta. Por exemplo, o valor na coluna ROWS_PRODUCED pode incluir linhas que foram excluídas devido à reescrita de micropartições e pode ser maior que o número real de linhas afetadas. Snowflake recomenda usar as colunas ROWS_INSERTED, ROWS_UPDATED, ROWS_WRITTEN_TO RESULTS ou ROWS_DELETED.

Mudanças em colunas na exibição QUERY_HISTORY¶

As colunas a seguir estão incluídas no Account Usage Exibição QUERY_HISTORY:

BYTES_WRITTEN_TO_RESULT
ROWS_INSERTED

Os valores nessas colunas para tipos específicos de consultas são os seguintes:

Antes da mudança:

BYTES_WRITTEN_TO_RESULT	`0` para pequenas consultas.
ROWS_INSERTED:	`0` para consultas CREATE TABLE AS SELECT (CTAS).

Após a mudança:

BYTES_WRITTEN_TO_RESULT	Número de bytes gravados em um objeto de resultado para pequenas consultas.
ROWS_INSERTED:	Número de linhas inseridas para consultas CREATE TABLE AS SELECT (CTAS).

Para obter mais informações, consulte também Information Schema: novas colunas na saída para funções QUERY_HISTORY, QUERY_HISTORY_BY_* (pendente).

Ref: 1431, 1524, 1540