CORTEX_SEARCH_REFRESH_HISTORY¶

Syntaxe¶

CORTEX_SEARCH_REFRESH_HISTORY(
  [ NAME => '<string>' ]
  [ , DATA_TIMESTAMP_START => <constant_expr> ]
  [ , DATA_TIMESTAMP_END => <constant_expr> ]
  [ , RESULT_LIMIT => <integer> ]
)

Arguments¶

Tous les arguments sont facultatifs. Si aucun argument n’est fourni, alors 100 actualisations de tous les Cortex Search Services du compte seront renvoyées.

NAME => string

Le nom d’un service Cortex Search.

Les noms doivent être mis entre guillemets simples et ne sont pas sensibles à la casse.

Vous pouvez spécifier le nom incomplet (service_name), le nom partiellement complet (schema_name.service_name) ou le nom complet (database_name.schema_name.service_name).

Pour plus d’informations sur la résolution des noms d’objets, reportez-vous à Résolution de nom d’objet.

La fonction renvoie les actualisations pour ce service.

DATA_TIMESTAMP_START => constant_expr , . DATA_TIMESTAMP_END => constant_expr

Plage de temps (au format TIMESTAMP_LTZ) pendant laquelle les actualisations ont eu lieu.

• Si aucune heure de début ni de fin n’est spécifiée, la plage par défaut correspondra aux dernières 24 heures.

• Si aucune heure de fin n’est spécifiée, CURRENT_TIMESTAMP est utilisée comme fin de plage.

• Si aucune heure de début n’est spécifiée, la plage commence 1 jour avant le début de DATA_TIMESTAMP_END.

RESULT_LIMIT => integer

Un nombre spécifiant le nombre maximum de lignes renvoyé par la fonction. Si le nombre de lignes correspondantes est supérieur à cette limite, les actualisations avec l’heure de fin la plus récente (ou celles qui sont toujours en cours d’exécution) sont renvoyées, jusqu’à la limite spécifiée.

Pour appliquer un filtre aux résultats, vous devez également spécifier une valeur limite RESULT_LIMIT assez grande pour le filtre à appliquer sur tous les Cortex Search Services.

Plage : de 1 à 10000

Par défaut : 100.

Sortie¶

La fonction renvoie les colonnes suivantes.

Notes sur l’utilisation¶

• Lors de l’appel d’une fonction de la table de schémas d’informations, la session doit avoir un schéma INFORMATION_SCHEMA en cours d’utilisation ou le nom de la fonction doit être complètement qualifié. Pour plus de détails, voir Schéma d’information de Snowflake.

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
  TABLE (
    INFORMATION_SCHEMA.CORTEX_SEARCH_REFRESH_HISTORY (
      DATA_TIMESTAMP_START => DATEADD(WEEK, -1, CURRENT_TIMESTAMP())
    )
  )
ORDER BY
  data_timestamp DESC
LIMIT 10;

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
  TABLE (
    INFORMATION_SCHEMA.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;

Analyser les performances d’actualisation d’un service Cortex Search Service :

SELECT
  name,
  data_timestamp,
  index_preprocessing_duration,
  indexing_duration,
  TIMEDIFF(SECOND, refresh_start_time, refresh_end_time) AS total_refresh_duration_sec,
  index_preprocessing_statistics:numInsertedRows AS rows_processed
FROM
  TABLE (
    INFORMATION_SCHEMA.CORTEX_SEARCH_REFRESH_HISTORY (
      NAME => 'MYSVC',
      DATA_TIMESTAMP_START => DATEADD(DAY, -30, CURRENT_TIMESTAMP())
    )
  )
WHERE
  state = 'SUCCEEDED'
ORDER BY
  data_timestamp DESC;