<budget_name>!GET_SERVICE_TYPE_USAGE

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

Wichtig

Diese Methode ist veraltet. Verwenden Sie stattdessen <budget_name>!GET_SERVICE_TYPE_USAGE_V2.

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

  • DATA_QUALITY_MONITORING

  • HYBRID_TABLE_REQUESTS

  • MATERIALIZED_VIEW

  • PIPE

  • QUERY_ACCELERATION

  • SEARCH_OPTIMIZATION

  • SERVERLESS_ALERTS

  • 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:

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

Weitere Informationen dazu finden Sie unter Rollen und Berechtigungen für Budgets.

Nutzungshinweise

  • Für timezone können Sie einen Zeitzonennamen oder einen Verknüpfungsnamen aus Release 2025b 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.

  • 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.

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

Informationen zum Beheben von Problemen, die beim Aufruf dieser Methode auftreten können, finden Sie unter Sie können die Methode GET_SERVICE_TYPE_USAGE nicht erfolgreich aufrufen.

Sprache: Deutsch