Schema:: ACCOUNT_USAGE

Ansicht CORTEX_AISQL_USAGE_HISTORY¶

Die Ansicht CORTEX_AISQL_USAGE_HISTORY kann verwendet werden, um den Nutzungsverlauf von:doc:Cortex AI-Funktionen </user-guide/snowflake-cortex/aisql> abzufragen.

Die Informationen in der Ansicht beinhalten die Anzahl der Credits, die jedes Mal verbraucht werden, wenn eine AI-Funktion aufgerufen wird, und zwar in Ein-Stunden-Schritten aggregiert, basierend auf der Zeit jeder abgeschlossenen Abfrage. Die Ansicht enthält auch relevante Metadaten, wie z. B. die Benutzer-ID, die Abfrage-ID, Funktion und Modell. Jede Zeile in der Ansicht steht für die Nutzung für eine bestimmte Kombination aus Funktion, Modell, Abfrage und Warehouse. Weitere Informationen zur Cortex-Abrechnung finden Sie unter Hinweise zu Kosten.

Wichtig

Diese Ansicht ersetzt sowohl die CORTEX_FUNCTIONS_USAGE_HISTORY-Ansicht als auch die CORTEX_FUNCTIONS_QUERY_USAGE_HISTORY-Ansicht.

Spalten¶

Spaltenname	Datentyp	Beschreibung
USAGE_TIME	TIMESTAMP_LTZ	Das Datum und der Beginn der Stunde (in der lokalen Zeitzone), in der dieser Nutzungsdatensatz abgerechnet wurde. Die Nutzung wird erst nach Abschluss der Abfrage erfasst, sodass dieser Zeitstempel die Stunde darstellt, in der die Abfrage abgeschlossen wurde. Wenn eine Abfrage beispielsweise um 05:30 beginnt und um 08:30 abgeschlossen ist, wird der Datensatz in der Stunde 08:00–09:00 aggregiert.
MODEL_NAME	TEXT	Name des in der Abfrage verwendeten Modells. Eine Abfrage kann mehr als ein Modell verwenden. In diesem Fall enthält der Nutzungsverlauf eine Zeile für jedes Modell.
FUNCTION_NAME	TEXT	Der Name der aufgerufenen Cortex AI-Funktion. Eine Abfrage kann mehr als eine Funktion verwenden. In diesem Fall enthält der Nutzungsverlauf eine Zeile für jede Funktion.
TOKEN_CREDITS	NUMBER	Anzahl der Credits, die für die Nutzung der Cortex-AI-Funktion basierend auf den Token, die für die angegebene Funktion und das Modell für die Kombination von QUERY_ID, MODEL_NAME und WAREHOUSE_ID verarbeitet wurden, in Rechnung gestellt wurden. Credits für Warehouse-Nutzung sind nicht enthalten.
TOKENS	NUMBER	Anzahl der Token, die für die angegebene Funktion und das Modell für die Kombination von QUERY_ID, MODEL_NAME und WAREHOUSE_ID verarbeitet wurden.
TOKEN_CREDITS_GRANULAR	OBJECT	Ein SQL-Objekt, das eine Aufschlüsselung der nach Token-Typ (Eingabe oder Ausgabe) für die angegebene Funktion und das Modell für die Kombination von QUERY_ID, MODEL_NAME und WAREHOUSE_ID abgerechneten Credits bietet.
TOKENS_GRANULAR	OBJECT	Ein SQL-Objekt, das eine Aufschlüsselung der nach Token-Typ (Eingabe oder Ausgabe) für die angegebene Funktion und das Modell für die Kombination von QUERY_ID, MODEL_NAME und WAREHOUSE_ID verarbeiteten Token bietet.
QUERY_ID	TEXT	Die ID der Abfrage, in der die Funktion aufgerufen wurde.
QUERY_TAG	TEXT	Das Tag, falls vorhanden, das mit der Abfrage verknüpft ist, in der die Funktion aufgerufen wurde.
USER_ID	TEXT	Die interne ID des Benutzenden, der die Funktion aufgerufen hat. Weitere Informationen zum Authentifizierung finden Sie unter Authentifizierung am Server.
WAREHOUSE_ID	TEXT	Die ID des virtuellen Warehouse, das die Abfrage verarbeitet hat, in der die Funktion aufgerufen wurde.

Nutzungshinweise¶

Diese Ansicht enthält nur Nutzungen, die am oder nach dem 17. November 2025 stattgefunden haben.
Die Abrechnung wird erst nach Abschluss der Abfrage gemeldet, und der Zeitstempel ist die Stunde, in der die Abfrage abgeschlossen wurde.
Die Credit-Nutzung basiert auf der Anzahl der verarbeiteten Token, wie in der Snowflake Service Consumption Table dargelegt.