Schéma :: ACCOUNT_USAGE

Vue CORTEX_SEARCH_REFRESH_HISTORY¶

Cette vue d’utilisation du compte affiche des informations sur l’historique d’actualisation du service Cortex Search Service.

Colonnes¶

Nom de la colonne	Type de données	Description
NAME	VARCHAR	Nom du Cortex Search Service.
SCHEMA_NAME	VARCHAR	Le nom du schéma contenant le Cortex Search Service.
DATABASE_NAME	VARCHAR	Le nom de la base de données qui contient le Cortex Search Service.
STATE	VARCHAR	Statut de l’actualisation du service Cortex Search Service. Il peut être sous la forme suivante : . - EXECUTING: actualisation en cours. . - SUCCEEDED: actualisation exécutée avec succès. . - FAILED : échec de l’actualisation pendant l’exécution. . - CANCELLED : l’actualisation a été annulée avant l’exécution.
DATA_TIMESTAMP	TIMESTAMP_LTZ	Horodatage transactionnel de l’évaluation de l’actualisation. (Il se peut que cette date soit légèrement antérieure à l’heure réelle de l’actualisation.) Toutes les données, dans les objets de base, qui sont arrivées avant cet horodatage sont actuellement incluses dans le service Cortex Search Service.
REFRESH_START_TIME	TIMESTAMP_LTZ	Heure à laquelle la tâche d’actualisation a commencé.
REFRESH_END_TIME	TIMESTAMP_LTZ	Heure à laquelle l’actualisation s’est achevée.
INDEX_PREPROCESSING_DURATION	NUMBER	Durée de la phase de prétraitement de l’index en millisecondes.
INDEX_PREPROCESSING_QUERY_ID	VARCHAR	ID de la requête qui a effectué le prétraitement de l’index.
INDEX_PREPROCESSING_STATISTICS	OBJECT	Contient les propriétés suivantes pour le prétraitement de l’index : . - `compilationTimeMs`: Temps passé à compiler la requête en millisecondes. . - `executionTimeMs`: Temps passé à exécuter la requête en millisecondes. . - `queuedTimeMs`: Temps passé dans la file d’attente avant l’exécution en millisecondes. . - `numInsertedRows`: Le nombre de lignes insérées. . - `numDeletedRows`: Le nombre de lignes qui ont été supprimées. . - `numCopiedRows`: Le nombre de lignes qui ont été copiées sans modification. . - `numAddedPartitions`: Le nombre de partitions ajoutées. . - `numRemovedPartitions`: Le nombre de partitions supprimées.
INDEXING_DURATION	NUMBER	Durée de la phase d’indexation en millisecondes.
INDEXING_QUERY_ID	VARCHAR	ID de la requête qui a effectué l’indexation.
REFRESH_ACTION	VARCHAR	Une des options suivantes : . - NO_DATA - pas de nouvelles données dans les tables de base. . - FULL - actualisation complète du service Cortex Search Service. . - INCREMENTAL - actualisation incrémentielle du service Cortex Search Service.
REFRESH_TRIGGER	VARCHAR	Une des options suivantes : . - SCHEDULED - actualisation normale de l’arrière-plan pour maintenir le service à jour. . - MANUAL - actualisation déclenchée manuellement par l’utilisateur à l’aide de ALTER CORTEX SEARCH SERVICE. . - CREATION - actualisation effectuée lors de la création de l’instruction DDL.
TARGET_LAG_SEC	NUMBER	Décrit la valeur de latence cible du service Cortex Search Service au moment de l’actualisation.
WAREHOUSE	VARCHAR	Nom de l’entrepôt utilisé pour l’opération d’actualisation.
ERROR	VARCHAR	Message d’erreur si l’actualisation a échoué, sinon NULL.

Notes sur l’utilisation¶

La latence pour la vue peut atteindre 3 heures.
Pour interroger cette vue, utilisez un rôle auquel est accordé le </sql-reference/snowflake-db-roles>rôle de base de données SNOWFLAKE.USAGE_VIEWER.
Les arguments suivants peuvent être utilisés pour filtrer les résultats :
- NAME : Filtre par nom de service Cortex Search Service.
- DATA_TIMESTAMP_START : Filtrer les résultats selon les actualisations qui se sont produites à partir de l’horodatage spécifié ou après.
- DATA_TIMESTAMP_END : Filtrer les résultats selon les actualisations qui se sont produites au moment de l’horodatage spécifié ou avant.
- RESULT_LIMIT : Limiter le nombre de résultats renvoyés.

Exemples¶

Rechercher les actualisations du service Cortex Search Service ayant échoué au cours de la semaine écoulée :

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

Rechercher les actualisations manuelles récentes d’un service Cortex Search Service spécifique :

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

Analyser les performances d’actualisation d’un service 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