<budget_name>!GET_SERVICE_TYPE_USAGE_V2¶
Zeigen Sie die Credit-Nutzung für ein Budget nach Diensttyp an.
Syntax¶
<budget_name>!GET_SERVICE_TYPE_USAGE_V2( '<start_month>' , '<end_month>' )
Argumente¶
'start_month'Gibt den Beginn des Zeitraums an, für den Sie Nutzungsinformationen zurückgeben möchten. Im Format
YYYY-MMangegeben.'end_month'Gibt das Ende des Zeitraums an, für den Sie Nutzungsinformationen zurückgeben möchten. Im Format
YYYY-MMangegeben.
Rückgabewerte¶
Die Funktion gibt die folgenden Spalten zurück:
Spaltenname |
Datentyp |
Beschreibung |
|---|---|---|
SERVICE_TYPE |
VARCHAR |
Listet die Services auf, die Credits verbraucht haben. |
ENTITY_TYPE |
VARCHAR |
Typ des Objekts, das mit dem Credit-Verbrauch verknüpft ist. Alle tabellenähnlichen Objekte wie Tabellen, Ansichten, materialisierte Ansichten und externe Tabellen haben den |
ENTITY_ID |
NUMBER |
Interner Bezeichner für das Objekt im Budget. |
NAME |
VARCHAR |
Name des Objekts, das mit dem Credit-Verbrauch verknüpft ist. |
CREDITS_USED |
FLOAT |
Anzahl der verwendeten Credits. Dies ist die Summe von CREDITS_COMPUTE und CREDITS_CLOUD. |
CREDITS_COMPUTE |
FLOAT |
Anzahl der verwendeten Compute-Credits. |
CREDITS_CLOUD |
FLOAT |
Anzahl der verwendeten Credits für Clouddienste. |
Anforderungen an die Zugriffssteuerung¶
Die folgenden Mindestberechtigungen und Rollen sind erforderlich, um die Ergebnisse für kundenspezifische Budgets anzuzeigen:
Eine beliebige Instanzrolle für die Budgetinstanz.
USAGE-Berechtigung für die Datenbank und das Schema, die die Budgetinstanz enthalten.
Snowflake-Datenbankrolle USAGE_VIEWER.
Die folgende Rolle ist erforderlich, um die Ergebnisse für das Kontobudget anzuzeigen:
Eine beliege Anwendungsrolle für das Kontobudget.
Snowflake-Datenbankrolle USAGE_VIEWER.
Weitere Informationen dazu finden Sie unter Rollen und Berechtigungen für Budgets.
Nutzungshinweise¶
Wenn Sie diese Methode aufrufen, wird das Objekt nicht zurückgegeben. Aus diesem Grund können Sie keine Methodenverkettung verwenden, um eine andere Methode mit dem Rückgabewert dieser Methode aufzurufen. Rufen Sie jede Methode in einer separaten SQL-Anweisung auf.
Beispiel¶
Geben Sie Credits zurück, die von Objekten verbraucht wurden, die mit dem Budget my_budget im Januar, Februar und März 2025 verbunden sind:
CALL db.sch1.my_budget!GET_SERVICE_TYPE_USAGE_V2('2025-01', '2025-03');