Esquema:: ACCOUNT_USAGE

Exibição CORTEX_SEARCH_REFRESH_HISTORY¶

Esta visualização do uso da conta exibe informações do histórico de atualização do Cortex Search Service.

Colunas¶

Nome da coluna	Tipo de dados	Descrição
NAME	VARCHAR	Nome do Cortex Search Service.
SCHEMA_NAME	VARCHAR	O nome do esquema que contém o Cortex Search Service.
DATABASE_NAME	VARCHAR	O nome do banco de dados que contém o Cortex Search Service.
STATE	VARCHAR	Status da atualização do Cortex Search Service. Pode ser uma das seguintes opções: . – EXECUTING: atualização em andamento. . – SUCCEEDED: atualização concluída com sucesso. . – FAILED: falha na atualização durante a execução. . – CANCELLED: atualização cancelada antes da execução.
DATA_TIMESTAMP	TIMESTAMP_LTZ	Carimbo de data/hora transacional quando a atualização foi avaliada. (Isso pode ocorrer um pouco antes da hora real da atualização.) Todos os dados, em objetos base, que chegaram antes desse carimbo de data/hora estão incluídos no Cortex Search Service.
REFRESH_START_TIME	TIMESTAMP_LTZ	Hora em que o trabalho de atualização foi iniciado.
REFRESH_END_TIME	TIMESTAMP_LTZ	Hora em que a atualização foi concluída.
INDEX_PREPROCESSING_DURATION	NUMBER	Duração da fase de pré-processamento do índice em milissegundos.
INDEX_PREPROCESSING_QUERY_ID	VARCHAR	ID da consulta que realizou o pré-processamento do índice.
INDEX_PREPROCESSING_STATISTICS	OBJECT	Contém as seguintes propriedades para pré-processamento do índice: . – `compilationTimeMs`: tempo gasto na compilação da consulta em milissegundos. . – `executionTimeMs`: tempo gasto na execução da consulta em milissegundos. . – `queuedTimeMs`: tempo gasto na fila antes da execução em milissegundos. . – `numInsertedRows`: o número de linhas inseridas. . – `numDeletedRows`: o número de linhas que foram excluídas. . – `numCopiedRows`: o número de linhas que foram copiadas inalteradas. . – `numAddedPartitions`: o número de partições adicionadas. . – `numRemovedPartitions`: o número de partições removidas.
INDEXING_DURATION	NUMBER	Duração da fase de indexação em milissegundos.
INDEXING_QUERY_ID	VARCHAR	ID da consulta que realizou a indexação.
REFRESH_ACTION	VARCHAR	As opções são: . – NO_DATA: sem novos dados nas tabelas base. . – FULL: atualização completa do Cortex Search Service. . – INCREMENTAL: atualização incremental do Cortex Search Service.
REFRESH_TRIGGER	VARCHAR	As opções são: . – SCHEDULED: atualização normal em segundo plano para manter o serviço atualizado. . – MANUAL: atualização acionada manualmente pelo usuário por meio de ALTER CORTEX SEARCH SERVICE. . – CREATION: atualização realizada durante a instrução DDL de criação.
TARGET_LAG_SEC	NUMBER	Descreve o valor da meta de atraso para o Cortex Search Service no momento em que ocorreu a atualização.
WAREHOUSE	VARCHAR	Nome do warehouse usado para a operação de atualização.
ERROR	VARCHAR	Mensagem de erro se a atualização tiver falhado; caso contrário NULL.

Notas de uso¶

A latência da visualização pode ser de até 3 horas.
Para consultar esta exibição, use uma função que tenha a função de banco de dados SNOWFLAKE.USAGE_VIEWER concedida.
Os seguintes argumentos podem ser usados para filtrar os resultados:
- NAME: filtrar pelo nome do Cortex Search Service.
- DATA_TIMESTAMP_START: filtrar os resultados para atualizações que ocorreram em ou após o carimbo de data/hora especificado.
- DATA_TIMESTAMP_END: filtrar os resultados para atualizações que ocorreram em ou antes do carimbo de data/hora especificado.
- RESULT_LIMIT: limitar o número de resultados retornados.

Exemplos¶

Encontrar atualizações do Cortex Search Service com falha na semana passada:

SELECT
    data_timestamp,
    database_name,
    schema_name,
    name,
    state,
    error,
    refresh_trigger
  FROM snowflake.account_usage.cortex_search_refresh_history
  WHERE state = 'FAILED' AND data_timestamp >= dateadd(WEEK, -1, current_date())
  ORDER BY data_timestamp DESC
  LIMIT 10;

Copy

Encontrar atualizações manuais recentes para um Cortex Search Service específico:

SELECT
    data_timestamp,
    refresh_start_time,
    refresh_end_time,
    refresh_action,
    state
  FROM snowflake.account_usage.cortex_search_refresh_history(
    NAME => 'MYSVC',
    DATA_TIMESTAMP_START => dateadd(DAY, -7, current_timestamp()),
    RESULT_LIMIT => 20
  )
  WHERE refresh_trigger = 'MANUAL'
  ORDER BY data_timestamp DESC;

Copy

Analisar o desempenho da atualização de um Cortex Search Service:

SELECT
    name,
    data_timestamp,
    index_preprocessing_duration,
    indexing_duration,
    (refresh_end_time::TIMESTAMP_NTZ - refresh_start_time::TIMESTAMP_NTZ) AS total_refresh_duration_sec,
    index_preprocessing_statistics:numInsertedRows AS rows_processed
  FROM snowflake.account_usage.cortex_search_refresh_history
  WHERE name = 'MYSVC'
    AND state = 'SUCCEEDED'
    AND data_timestamp >= dateadd(DAY, -30, current_date())
  ORDER BY data_timestamp DESC;

Copy