<budget_name>!GET_SERVICE_TYPE_USAGE

Snowflake logo in black (no text) Vorschau-Feature – Offen

Verfügbar bei allen Editionen von Snowflake-Konten.

Dieses Feature ist derzeit nicht bei Testkonten oder Konten in Regionen für Regierungsbehörden verfügbar.

Zeigen Sie die Credit-Nutzung für ein Budget nach Diensttyp an.

Siehe auch:

<budget_name>!GET_SPENDING_HISTORY

Syntax

<budget_name>!GET_SERVICE_TYPE_USAGE( SERVICE_TYPE => '<service_type>' ,
                                      TIME_DEPART => '<time_interval>' ,
                                      USER_TIMEZONE => '<timezone>' ,
                                      TIME_LOWER_BOUND => <constant_expr> ,
                                      TIME_UPPER_BOUND => <constant_expr>
                                    )
Copy

Argumente

SERVICE_TYPE => service_type

Der Diensttyp, der zur Einschränkung der Ergebnisse verwendet wird.

Gültige Werte:

Typ des Dienstes, der Credits verbraucht. Dies kann einer der folgenden sein:

  • AUTO_CLUSTERING

  • MATERIALIZED_VIEW

  • PIPE

  • QUERY_ACCELERATION

  • SEARCH_OPTIMIZATION

  • SERVERLESS_TASK

  • SNOWPIPE_STREAMING

  • WAREHOUSE_METERING

  • WAREHOUSE_METERING_READER

TIME_DEPART => time_interval

Zeitintervall, das zur Abgrenzung der Nutzungsdatensätze verwendet wird. Jede Zeile zeigt die Dienstnutzung nach dem angegebenen Zeitintervall an.

Gültige Werte:

  • HOUR, Stunde

  • DAY, Tag

  • WEEK, Woche

USER_TIMEZONE => timezone

Zeichenfolge zur Angabe der Zeitzone des Benutzers. Die Budgetmessung basiert auf der Zeitzone UTC.

TIME_LOWER_BOUND => constant_expr

Der Beginn des Zeitbereichs, in dem die Ausgaben getätigt wurden.

TIME_UPPER_BOUND => constant_expr

Das Ende des Zeitbereichs, in dem die Ausgaben getätigt wurden.

Rückgabewerte

Die Funktion gibt die folgenden Spalten zurück:

Spaltenname

Datentyp

Beschreibung

START_TIME

TIMESTAMP_TZ

Datum und Uhrzeit der Nutzung.

ENTITY_ID

NUMBER

Interner Bezeichner für das Objekt im Budget.

NAME

VARCHAR

Name des gemessenen Objekts.

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 Rolle mit einer beliebigen Instanzrolle für die Budgetinstanz.

    • Eine Rolle mit der USAGE-Berechtigung für die Datenbank und das Schema, das die Budgetinstanz enthält.

  • Die folgende Rolle ist erforderlich, um die Ergebnisse für das Kontobudget anzuzeigen:

    Eine Rolle mit einer beliebigen Anwendungsrolle für das Kontobudget.

Nutzungshinweise

Für timezone können Sie einen Zeitzonennamen oder einen Verknüpfungsnamen aus Release 2021a der IANA-Zeitzonendatenbank angeben (z. B. America/Los_Angeles, Europe/London, UTC, Etc/GMT usw.).

Bemerkung

  • Bei Zeitzonennamen wird zwischen Groß-/Kleinschreibung unterschieden. Außerdem müssen sie in einfache Anführungszeichen gesetzt werden (z. B. 'UTC').

  • Snowflake bietet keine Unterstützung für die meisten Zeitzonen abkürzungen (z. B. PDT, EST usw.), da sich eine bestimmte Abkürzung auf mehrere verschiedenen Zeitzonen beziehen kann. So kann sich CST beispielsweise auf die „Central Standard Time“ in Nordamerika (UTC-6), die „Cuba Standard Time“ (UTC-5) und die „China Standard Time“ (UTC+8) beziehen.

Beispiele

Sehen Sie sich die täglichen Credits an, die für jedes Warehouse in der vergangenen Woche für das Kontobudget ausgegeben wurden:

CALL snowflake.local.account_root_budget!GET_SERVICE_TYPE_USAGE(
   SERVICE_TYPE => 'WAREHOUSE_METERING',
   TIME_DEPART => 'day',
   USER_TIMEZONE => 'UTC',
   TIME_LOWER_BOUND => dateadd('day', -7, current_timestamp()),
   TIME_UPPER_BOUND => current_timestamp()
);
Copy

Fehlermeldungen

Die folgenden Szenarios können Ihnen helfen, möglicherweise auftretende Probleme zu beheben.

Fehler

 
001044 (42P13): SQL compilation error: error line 0 at position -1
Invalid argument types for function 'GET_SERVICE_TYPE_USAGE':
(VARCHAR(X), VARCHAR(X), VARCHAR(X), VARCHAR(X))

Ursache

Sie haben die Methode mit ungültigen Argumenten oder der falschen Anzahl von Argumenten aufgerufen.

Lösung

Überprüfen Sie, ob die Argumente, die Sie zum Aufrufen der Methode verwenden, gültig sind und ob Sie alle erforderlichen Argumente angegeben haben.

Fehler

 
002151 (22023): Uncaught exception of type 'STATEMENT_ERROR' on line 16
at position 23 : SQL compilation error: [:TIME_DEPART] is not a valid
date/time component for function DATE_TRUNC.

Ursache

Das Argument TIME_DEPART ist eine ungültige Zeichenfolge.

Lösung

Um diesen Fehler zu beheben, verwenden Sie einen der gültigen Werte, die oben aufgeführt sind.

Fehler

 
100094 (22000): Uncaught exception of type 'STATEMENT_ERROR' on line 16
at position 23 : Unknown timezone: '<invalid_timezone>'

Ursache

Das Argument USER_TIMEZONE ist eine ungültige Zeichenfolge.

Lösung

Verwenden Sie eine gültige Zeichenfolge für die Zeitzone. Weitere Informationen dazu finden Sie oben in den Nutzungshinweisen.
Sprache: Deutsch