Dynamische Tabellen überwachen¶
Unter diesem Thema wird beschreiben, wie Sie die dynamischen Tabellen in Ihren Pipelines anzeigen und verstehen können:
Abschnitt |
Beschreibung |
|---|---|
Dynamische Tabellen auflisten oder Informationen zu bestimmten Spalten anzeigen |
Dynamischen Tabellen in einem Schema auflisten und Informationen dazu anzeigen |
Diagramm der Tabellen anzeigen, die mit Ihren dynamischen Tabellen verbunden sind |
Diagramm der Tabellen ansehen, die mit Ihren dynamischen Tabellen verbunden sind |
Überwachen Sie Ihre dynamischen Tabellen mit SQL-Tabellenfunktionen |
Ihre dynamischen Tabellen mit den SQL-Tabellenfunktionen überwachen |
Aktualisierungsstatus für Ihre dynamischen Tabellen überwachen |
Aktualisierungsstatus für Ihre dynamischen Tabellen ansehen |
Dynamische Tabellen auflisten oder Informationen zu bestimmten Spalten anzeigen¶
Um die dynamischen Tabellen in einem Schema aufzulisten und Informationen über diese dynamischen Tabellen anzuzeigen, können Sie entweder die folgenden SQL-Befehle oder Snowsight verwenden, solange Sie eine Rolle verwenden, die die MONITOR-Berechtigung für die dynamischen Tabellen hat.
Weitere Informationen dazu finden Sie unter Berechtigung zum Anzeigen der Metadaten einer dynamischen Tabelle.
Um die dynamischen Tabellen aufzulisten, die in der aktuellen Datenbank vorhanden sind (oder im Konto, wenn derzeit keine Datenbank verwendet wird), verwenden Sie den Befehl SHOW DYNAMIC TABLES.
Um beispielsweise die dynamischen Tabellen in der Datenbank mydb und dem Schema myschema aufzulisten, deren Namen mit product_ beginnen, führen Sie die folgende SQL-Anweisung aus:
SHOW DYNAMIC TABLES LIKE 'product_%' IN SCHEMA mydb.myschema;
+-------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| created_on | name | database_name | schema_name | cluster_by | rows | bytes | owner | target_lag | refresh_mode | refresh_mode_reason | warehouse | comment | text | automatic_clustering | scheduling_state | last_suspended_on | is_clone | is_replica | is_iceberg | data_timestamp | owner_role_type |
|-------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|2025-01-01 16:32:28 +0000 | product_dt | my_db | my_schema | | 2 | 2048 | ORGADMIN | DOWNSTREAM | INCREMENTAL | null | mywh | | create or replace dynamic table | OFF | ACTIVE | null | false | false | false |2025-01-01 16:32:28 +0000 | ROLE |
| product dt ... | | |
+-------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
Um Informationen zu den Spalten in einer dynamischen Tabelle auszugeben, verwenden Sie den Befehl DESCRIBE DYNAMIC TABLE.
Um zum Beispiel die Spalten in my_dynamic_table aufzulisten, führen Sie die folgende SQL-Anweisung aus:
DESC DYNAMIC TABLE my_dynamic_table;
+-------------------+--------------------------------------------------------------------------------------------------------------------------+
| name | type | kind | null? | default | primary key | unique key | check | expression | comment | policy name | privacy domain |
|-------------------+------------------------------------------------------------------------------------------------------------------------|
| AMOUNT | NUMBER(38,0) | COLUMN | Y | null | N | N | null | null | null | null | null | | |
+-------------------+------------------------------------------------------------------------------------------------------------------------+
Dynamische Tabellen sind auch in den Ergebnissen der Ansicht TABLES enthalten.
Um die dynamischen Tabellen in einem Schema aufzulisten und Informationen über eine bestimmte dynamische Tabelle anzuzeigen, gehen Sie wie folgt vor:
Melden Sie sich bei Snowsight an.
Wählen Sie Data » Databases aus.
Wählen Sie eine Datenbank und ein Schema aus.
Wählen Sie die Registerkarte Dynamic Tables, oder erweitern Sie Dynamic Tables im Datenbankobjekt-Explorer.
Um Informationen über eine bestimmte dynamische Tabelle anzuzeigen, wählen Sie die dynamische Tabelle aus der Liste der dynamischen Tabellen auf der Registerkarte Dynamic Tables oder im Datenbankobjekt-Explorer aus.
Die Registerkarten auf dieser Seite enthalten die folgenden Details über die von Ihnen ausgewählte dynamische Tabelle:
Table Details: Zeigt grundlegende Informationen über die dynamische Tabelle an, darunter:
den Planungsstatus Ihrer dynamischen Tabelle.
den letzte Aktualisierungsstatus Ihrer dynamischen Tabelle. Bei fehlgeschlagenen Aktualisierungen sehen Sie weitere Informationen über den Fehler, wenn Sie den Mauszeiger über den Status bewegen.
die aktuelle und die angestrebte Verzögerungszeit für Ihre dynamische Tabelle.
ob inkrementelle Aktualisierungen oder vollständige Aktualisierungen zur Aktualisierung der Tabelle verwendet werden.
die Definition der dynamischen Tabelle.
die Tags für die dynamische Tabelle.
die Berechtigungen, die für die Arbeit mit der dynamischen Tabelle gewährt werden.
Columns: Informationen zu den Spalten der dynamischen Tabelle.
Data Preview: Eine Vorschau von bis zu 100 Zeilen der Daten in der dynamischen Tabelle.
Graph: Zeigt den gerichteten azyklischen Graphen (DAG) an, der diese dynamische Tabelle enthält.
Refresh History: Zeigt den Verlauf der Aktualisierungen und die Verzögerungsmetriken an.
Diagramm der Tabellen anzeigen, die mit Ihren dynamischen Tabellen verbunden sind¶
Die Anzeige von Abhängigkeiten ist besonders nützlich bei der Fehlersuche in dynamischen Tabellenketten. In der Snowsight können Sie mit dem Verlaufsdiagramm visualisieren, von welchen dynamischen Tabellen eine bestimmte dynamische Tabelle abhängt. Sie können zum Beispiel Folgendes identifizieren:
vorgelagerte Abhängigkeiten, aus denen eine dynamische Tabelle Daten bezieht-.
nachgelagerte Abhängigkeiten, die durch Änderungen an einer dynamischen Tabelle beeinträchtigt werden könnten.
Abhängigkeiten können die Aktualisierungsleistung beeinträchtigen. Nehmen wir zum Beispiel an, dass die vorgelagerte Tabelle Ihrer dynamischen Tabelle kurz vor ihrer geplanten Aktualisierung eine große Datenmenge enthält. Ihre dynamische Tabelle wartet, bis die Aktualisierung abgeschlossen ist, wodurch sie ihre Zielverzögerungszeit verfehlt. Im Verlaufsdiagramm sehen Sie die Eingabetabelle als „in Ausführung“ markiert, was auf die Verzögerung hinweist.
Um das Diagramm einer bestimmten dynamischen Tabelle anzuzeigen, gehen Sie wie folgt vor:
Melden Sie sich bei Snowsight an.
Gehen Sie im Navigationsmenü auf Monitoring » Dynamic Tables.
Wählen Sie Ihre dynamische Tabelle. Die Ansicht Graph wird standardmäßig angezeigt. Auf dieser Registerkarte wird der Task-Graph mit dem Knoten für die ausgewählte dynamische Tabelle angezeigt. Der Bereich Details auf der rechten Seite zeigt Informationen zu ihren Verzögerungsmetriken und ihrer Konfiguration an.
Um die Details einer anderen Tabelle im Diagramm anzuzeigen, wählen Sie diese Tabelle aus.
Um die Grafik zu aktualisieren, wählen Sie die Aktualisierungsschaltfläche in der Leiste oberhalb der Grafik.
Wenn eine Aktualisierung aufgrund eines UPSTREAM_FAILED-Fehlercodes fehlgeschlagen ist, können Sie das Diagramm verwenden, um zu sehen, welche vorgelagerte Tabelle den Fehler verursacht hat.
Um die vollständigen Details einer Tabelle im Diagramm anzuzeigen, siehe Dynamische Tabellen auflisten oder Informationen zu bestimmten Spalten anzeigen.
Überwachen Sie Ihre dynamischen Tabellen mit SQL-Tabellenfunktionen¶
Verwenden Sie die folgenden INFORMATION_SCHEMA-Tabellenfunktionen, um Ihre dynamischen Tabellen zu überwachen:
DYNAMIC_TABLES: Gibt Metadaten zu Ihren dynamischen Tabellen zurück, einschließlich aggregierter Verzögerungsmetriken und des Status der letzten Aktualisierungen innerhalb von sieben Tagen ab dem aktuellen Zeitpunkt.
DYNAMIC_TABLE_REFRESH_HISTORY: Gibt Informationen zu jeder abgeschlossenen und laufenden Aktualisierung Ihrer dynamischen Tabellen zurück, einschließlich Aktualisierungsstatus und Trigger sowie der Zielverzögerung.
Ansicht DYNAMIC_TABLE_REFRESH_HISTORY: In dieser Account Usage-Ansicht werden auch Informationen zum Aktualisierungsverlauf der dynamischen Tabelle angezeigt. Sie ist nützlich für die Fehlersuche bei Problemen, die länger als die Datenaufbewahrungsdauer der Tabellenfunktion DYNAMIC_TABLE_REFRESH_HISTORY (sieben Tage) andauern.
DYNAMIC_TABLE_GRAPH_HISTORY: Gibt Informationen zurück, die den Verlauf jeder dynamischen Tabelle, ihre Eigenschaften und ihre Abhängigkeiten von anderen Tabellen und dynamischen Tabellen enthalten.
Sie können diese Tabellenfunktion verwenden, um einen Snapshot der Abhängigkeitsstruktur von dynamischen Tabellen zu einem bestimmten Zeitpunkt zu erhalten.
Die Ausgabe spiegelt auch die Änderungen wider, die im Laufe der Zeit an den Eigenschaften einer dynamischen Tabelle vorgenommen wurden. Jede Zeile steht für eine dynamische Tabelle und einen bestimmten Satz von Eigenschaften. Wenn Sie eine Eigenschaft einer dynamischen Tabelle (z. B. die Zielverzögerung) ändern, gibt die Funktion die aktuellste Eigenschaft zurück.
Aktualisierungsstatus für Ihre dynamischen Tabellen überwachen¶
In diesem Abschnitt wird erklärt, wie Sie den Aktualisierungsstatus aller oder bestimmter dynamischer Tabellen anzeigen können.
Informationen zur Problembehandlung finden Sie unter Problembehandlungbei übersprungenen, langsamen oder fehlgeschlagenen Aktualisierungen dynamischer Tabellen und Diagnose häufiger Probleme bei der Automatisierung dynamischer Tabellen.
Aktualisierungen für alle Ihre dynamischen Tabellen überwachen¶
Sie können die Snowsight oder die Tabellenfunktion DYNAMIC_TABLES verwenden, um den Aktualisierungsstatus für alle Ihre dynamischen Tabellen anzuzeigen.
Melden Sie sich bei Snowsight an. Wählen Sie im Navigationsmenü die Option Monitoring » Dynamic Tables aus.
Auf dieser Seite können Sie den Status und den letzten Aktualisierungsstatus für alle Ihre dynamischen Tabellen einsehen. Sie können auch nach Datenbank oder Schema filtern, um die Ergebnisse einzugrenzen.
DYNAMIC_TABLES liefert Informationen über alle dynamischen Tabellen in Ihrem Konto.
Das folgende Beispiel ruft die Informationen zum Status und zur Zielverzögerung für alle dynamischen Tabellen im Konto und die zugehörige Datenbank und das Schema ab.
SELECT
name,
database_name,
schema_name,
scheduling_state,
target_lag_type,
target_lag_sec,
FROM
TABLE (
INFORMATION_SCHEMA.DYNAMIC_TABLES ()
)
ORDER BY
name;
+--------------------+------------------------------+--------------------------------------------------------------------------------------------------+-----------------+----------------+
| NAME | DATABASE_NAME | SCHEMA_NAME | SCHEDULING_STATE | TARGET_LAG_TYPE | TARGET_LAG_SEC |
|--------------------+------------------------------+--------------------------------------------------------------------------------------------------|-----------------+----------------+
| MY_DYNAMIC_TABLE_1 | MY_DB_1 | MY_SCHEMA_1 | { | | |
| | | | "reason_code": "UPSTREAM_SUSPENDED_DUE_TO_ERRORS", | | |
| | | | "reason_message": "The DT was suspended because an input DT had 5 consecutive refresh errors", | | |
| | | | "state": "SUSPENDED", | | |
| | | | "suspended_on": "2025-04-14 11:49:09.576 Z" | USER_DEFINED | 60 |
| | | | } | | |
| MY_DYNAMIC_TABLE_2 | MY_DB_2 | MY_SCHEMA_2 | null | | |
+--------------------+------------------------------+--------------------------------------------------------------------------------------------------+-----------------+----------------|
Das folgende Beispiel ruft den Status und Informationen zu jedem Status für die Aktualisierung für alle dynamischen Tabellen im Konto ab.
-- latest_data_timestamp is the refresh timestamp associated with last successful refresh.
SELECT
name,
last_completed_refresh_state,
last_completed_refresh_state_code,
last_completed_refresh_state_message,
latest_data_timestamp,
time_within_target_lag_ratio,
maximum_lag_sec,
executing_refresh_query_id
FROM
TABLE (
INFORMATION_SCHEMA.DYNAMIC_TABLES ()
)
ORDER BY
name;
-- Both dynamic tables in the example below have a target lag of one minute.
+--------------------+------------------------------+-----------------------------------+-----------------------------------------------+-----------------------+------------------------------+-----------------+----------------------------+
| NAME | LAST_COMPLETED_REFRESH_STATE | LAST_COMPLETED_REFRESH_STATE_CODE | LAST_COMPLETED_REFRESH_STATE_MESSAGE | LATEST_DATA_TIMESTAMP | TIME_WITHIN_TARGET_LAG_RATIO | MAXIMUM_LAG_SEC | EXECUTING_REFRESH_QUERY_ID |
|--------------------+------------------------------+-----------------------------------+-----------------------------------------------|-----------------------+------------------------------+-----------------+----------------------------+
| MY_DYNAMIC_TABLE_1 | UPSTREAM_FAILED | UPSTREAM_FAILURE | Skipped refreshing because an input DT failed | 2025-04-12 09:00:48 | null | null | null |
| MY_DYNAMIC_TABLE_2 | SUCCEEDED | SUCCESS | null | 2025-04-12 09:01:36 | 0.999 | 125 | null |
+--------------------+------------------------------+-----------------------------------+-----------------------------------------------+-----------------------+------------------------------+-----------------+----------------------------+
Alle Aktualisierungen für eine bestimmte dynamische Tabelle überwachen¶
Sie können die Snowsight oder die Tabellenfunktion DYNAMIC_TABLES_REFRESH_HISTORY verwenden, um den Aktualisierungsverlauf für eine bestimmte dynamische Tabelle anzuzeigen.
Melden Sie sich bei Snowsight an.
Wählen Sie im Navigationsmenü die Option Monitoring » Dynamic Tables aus.
Wählen Sie Ihre dynamische Tabelle aus und gehen Sie dann zur Registerkarte Refresh History.
Diese Seite zeigt den Aktualisierungsverlauf Ihrer dynamischen Tabelle an, der Informationen über den Status, die Dauer und die tatsächliche Verzögerungszeit jeder Aktualisierung sowie die Anzahl der bei jeder Aktualisierung geänderten Zeilen enthält.
Sie zeigt außerdem die Verzögerungsmetrik Ihrer dynamischen Tabelle an, die den Prozentsatz der Zeit innerhalb der Zielverzögerung und die längste tatsächliche Verzögerungszeit während des gegebenen Intervalls umfasst.
Um die Aktualisierungshistorie für eine bestimmte dynamische Tabelle anzuzeigen, verwenden Sie die Tabellenfunktion DYNAMIC_TABLE_REFRESH_HISTORY.
Wenn Sie beispielsweise die Aktualisierungshistorie für alle dynamischen Tabellen in der Datenbank my_db und im Schema my_schema anzeigen möchten, führen Sie die folgende Anweisung aus:
SELECT
name,
data_timestamp,
state,
state_code,
state_message
FROM TABLE (INFORMATION_SCHEMA.DYNAMIC_TABLE_REFRESH_HISTORY (NAME_PREFIX => 'MY_DB.MY_SCHEMA')) ORDER BY data_timestamp desc;
+--------------------+---------------------+-----------+------------------------------+----------------------------------------------------------------+
| NAME | DATA_TIMESTAMP | STATE | STATE_CODE | STATE_MESSAGE |
|--------------------+---------------------+-----------+------------------------------+----------------------------------------------------------------|
| MY_DYNAMIC_TABLE_1 | 2025-04-12 09:01:36 | SKIPPED | SKIP_DUE_TO_UPSTREAM_FAILURE | Skipped refreshing because an input DT failed. |
| MY_DYNAMIC_TABLE_1 | 2025-04-12 09:00:48 | SUCCEEDED | | |
| MY_DYNAMIC_TABLE_1 | 2025-04-12 09:00:00 | FAILED | 100038 | Numeric value 'Good' is not recognized. |
| MY_DYNAMIC_TABLE_2 | 2025-04-12 09:01:36 | SUCCEEDED | | |
| MY_DYNAMIC_TABLE_2 | 2025-04-12 09:00:48 | FAILED | 091930 | SQL compilation error: Change tracking is not enabled or has |
| | | | | been missing for the time range requested on table 'MY_TABLE'. |
| MY_DYNAMIC_TABLE_2 | 2025-04-12 09:00:00 | CANCELLED | 002724 | Dynamic Table refresh job cancelled. |
+--------------------+---------------------+-----------+------------------------------+----------------------------------------------------------------+
Um nach fehlerhaften Aktualisierungen zu filtern, geben Sie das Argument ERROR_ONLY => TRUE ein. Beispiel:
SELECT
name,
data_timestamp,
state,
state_code,
state_message
FROM TABLE (INFORMATION_SCHEMA.DYNAMIC_TABLE_REFRESH_HISTORY (NAME_PREFIX => 'MY_DB.MY_SCHEMA', ERROR_ONLY => TRUE));
+--------------------+---------------------+-----------+------------------------------+----------------------------------------------------------------+
| NAME | DATA_TIMESTAMP | STATE | STATE_CODE | STATE_MESSAGE |
|--------------------+---------------------+-----------+------------------------------+----------------------------------------------------------------|
| MY_DYNAMIC_TABLE_1 | 2025-04-12 09:00:00 | FAILED | 100038 | Numeric value 'Good' is not recognized. |
| MY_DYNAMIC_TABLE_2 | 2025-04-12 09:00:48 | FAILED | 091930 | SQL compilation error: Change tracking is not enabled or has |
| | | | | been missing for the time range requested on table 'MY_TABLE'. |
| MY_DYNAMIC_TABLE_2 | 2025-04-12 09:00:00 | CANCELLED | 002724 | Dynamic Table refresh job cancelled. |
+--------------------+---------------------+-----------+------------------------------+----------------------------------------------------------------+