Schema:: ACCOUNT_USAGE

Ansicht CORTEX_SEARCH_REFRESH_HISTORY¶

Diese Account Usage-Ansicht zeigt Informationen zum Aktualisierungsverlauf des Cortex Search Service an.

Spalten¶

Spaltenname	Datentyp	Beschreibung
NAME	VARCHAR	Name des Cortex Search Service.
SCHEMA_NAME	VARCHAR	Der Name des Schemas, das den Cortex Search Service enthält.
DATABASE_NAME	VARCHAR	Der Name der Datenbank, die den Cortex Search Service enthält.
STATE	VARCHAR	Der Status der Aktualisierung für den Cortex Search Service. Dies kann einer der folgenden Werte sein: . - EXECUTING: Aktualisierung läuft. . - SUCCEEDED: Aktualisierung erfolgreich abgeschlossen. . - FAILED: Aktualisierung während der Ausführung fehlgeschlagen. . - CANCELLED: Aktualisierung wurde vor der Ausführung abgebrochen.
DATA_TIMESTAMP	TIMESTAMP_LTZ	Zeitstempel der Transaktion zum Zeitpunkt, als die Aktualisierung ausgewertet wurde. (Dies kann einen Moment vor dem tatsächlichen Zeitpunkt der Aktualisierung liegen.) Alle Daten in Basisobjekten, die vor diesem Zeitstempel eingegangen sind, sind derzeit im Cortex Search Service enthalten.
REFRESH_START_TIME	TIMESTAMP_LTZ	Zeitpunkt, zu dem der Aktualisierungsjob gestartet wurde.
REFRESH_END_TIME	TIMESTAMP_LTZ	Zeitpunkt, zu dem die Aktualisierung abgeschlossen wurde.
INDEX_PREPROCESSING_DURATION	NUMBER	Dauer der Vorverarbeitungsphase des Index in Millisekunden.
INDEX_PREPROCESSING_QUERY_ID	VARCHAR	ID der Abfrage, die die Indexvorverarbeitung durchgeführt hat.
INDEX_PREPROCESSING_STATISTICS	OBJECT	Enthält die folgenden Eigenschaften für die Indexvorverarbeitung: . - `compilationTimeMs`: Zeit, die für das Kompilieren der Abfrage in Millisekunden verbraucht wurde. . - `executionTimeMs`: Zeit, die für die Ausführung der Abfrage in Millisekunden benötigt wurde. . - `queuedTimeMs`: Zeit, die in der Warteschlange vor der Ausführung gewartet wurde, in Millisekunden. . - `numInsertedRows`: Die Anzahl der eingefügten Zeilen . - `numDeletedRows`: Die Anzahl der gelöschten Zeilen. . - `numCopiedRows`: Die Anzahl der Zeilen, die unverändert kopiert wurden. . - `numAddedPartitions`: Die Anzahl der hinzugefügten Partitionen. . - `numRemovedPartitions`: Die Anzahl der entfernten Partitionen.
INDEXING_DURATION	NUMBER	Dauer der Indizierungsphase in Millisekunden.
INDEXING_QUERY_ID	VARCHAR	ID der Abfrage, die die Indizierung durchgeführt hat.
REFRESH_ACTION	VARCHAR	Einer der folgenden Werte: . - NO_DATA: Keine neuen Daten in Basistabellen. . - FULL: Vollständige Aktualisierung des Cortex Search Service. . - INCREMENTAL: Inkrementelle Aktualisierung des Cortex Search Service.
REFRESH_TRIGGER	VARCHAR	Einer der folgenden Werte: . - SCHEDULED: Normale Hintergrundaktualisierung, um den Dienst auf dem neuesten Stand zu halten. . - MANUAL: Vom Benutzer manuell ausgelöste Aktualisierung mit ALTER CORTEX SEARCH SERVICE. . - CREATION: Aktualisierung während der Erstellungs-DDL-Anweisung ausgeführt.
TARGET_LAG_SEC	NUMBER	Beschreibt den Zielverzögerungswert für den Cortex Search Service zum Zeitpunkt der Aktualisierung.
WAREHOUSE	VARCHAR	Name des Warehouses, das für die Aktualisierungsvorgang verwendet wurde.
ERROR	VARCHAR	Fehlermeldung, wenn die Aktualisierung fehlgeschlagen ist, andernfalls NULL.

Nutzungshinweise¶

Die Latenz der Ansicht kann bis zu 3 Stunden betragen.
Um diese Ansicht abzufragen, verwenden Sie eine Rolle, die über die SNOWFLAKE.USAGE_VIEWER Datenbankrolle verfügt.
Die folgenden Argumente können zum Filtern der Ergebnisse verwendet werden:
- NAME: Filtern nach dem Namen des Cortex Search Service.
- DATA_TIMESTAMP_START: Filtern der Ergebnisse nach Aktualisierungen, die am oder nach dem angegebenen Zeitstempel stattgefunden haben.
- DATA_TIMESTAMP_END: Filtern der Ergebnisse nach Aktualisierungen, die am oder vor dem angegebenen Zeitstempel stattgefunden haben.
- RESULT_LIMIT: Begrenzen der Anzahl der zurückgegebenen Ergebnisse.

Beispiele¶

Suchen Sie fehlgeschlagene Cortex Search Service-Aktualisierungen der letzten Woche:

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

Suchen Sie die letzten manuellen Aktualisierungen für einen bestimmten Cortex Search Service:

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

Analysieren Sie die Leistung der Aktualisierung für einen 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