Zyklusstartaktionen für Budgets¶

Anforderungen gespeicherter Prozeduren¶

Die gespeicherte Prozedur, die durch eine Zyklusstart-Aktion aufgerufen wird, muss die folgenden Anforderungen erfüllen:

• Die Prozedur muss mit Eigentümerrechten ausgeführt werden, nicht mit Aufruferrechten. Weitere Informationen dazu finden Sie unter Erläuterungen zu gespeicherten Prozeduren mit Aufruferrechten und Eigentümerrechten.

• Das Ausführen der Prozedur darf nicht länger als 30 Minuten dauern.

• Die Prozedur dar kein OUTPUT-Argument aufweisen.

• Gestalten Sie Ihre Prozedur also so, dass sie mehrere Aufrufe problemlos verarbeiten kann, ohne doppelte oder unbeabsichtigte Auswirkungen zu verursachen.

• Die erforderlichen Argumente der Prozedur müssen einen der folgenden Datentypen aufweisen:

  • Numerische Datentypen

  • Zeichenfolgen- und Binärdatentypen

  • Logische Datentypen

  • Datentypen für Datum und Uhrzeit

Nachdem Sie eine gespeicherte Prozedur erstellt haben, die diese Anforderungen erfüllt, müssen Sie der SNOWFLAKE-Anwendung die USAGE-Berechtigung für die Prozedur und deren übergeordnete Datenbank und Schema gewähren. Wenn der vollqualifizierte Name Ihrer gespeicherten Prozedur zum Beispiel code_db.sch1.reset_resources lautet, führen Sie die folgenden Befehle aus:

GRANT USAGE ON DATABASE code_db TO APPLICATION SNOWFLAKE;
GRANT USAGE ON SCHEMA code_db.sch1 TO APPLICATION SNOWFLAKE;
GRANT USAGE ON PROCEDURE code_db.sch1.reset_resources(STRING, STRING) TO APPLICATION SNOWFLAKE;

Eine Zyklusstartaktion für ein Budget festlegen¶

Sie können eine Aktion zum Starten des Zyklus pro Budget festlegen (entweder das Kontobudget oder ein benutzerdefiniertes Budget). Eine Zyklusstartaktion besteht aus den folgenden Komponenten:

• Gespeicherte Prozedur Ein Verweis auf die Prozedur, die aufgerufen werden soll, wenn der Budgetzyklus neu gestartet wird.

• Argumente: Ein Array von Argumenten, das an die gespeicherte Prozedur übergeben werden soll.

Um eine Zyklusstartaktion für ein Budget festzulegen, rufen Sie die SET_CYCLE_START_ACTION-Methode für die Budgetinstanz auf. Der folgende Code stellt zum Beispiel eine Zyklusstartaktion ein, die die reset_resources gespeicherte Prozedur aufruft, wenn der Budgetzyklus neu gestartet wird:

CALL budget_db.sch1.my_budget!SET_CYCLE_START_ACTION(
  SYSTEM$REFERENCE('PROCEDURE', 'code_db.sch1.reset_resources(STRING, STRING, STRING, STRING)'),
  ARRAY_CONSTRUCT('my_int', 'admin@example.com', 'Budget Alert', 'New budget cycle started'));

Ein durchgängiges Beispiel, das das Erstellen der gespeicherten Prozedur enthält, die von der Zyklusstartaktion aufgerufen wird, finden Sie unter:ref:label-budget_cycle_start_actions_extended_example.

Eine Zyklusstartaktion aus einem Budget entfernen¶

Um eine Zyklusstartaktion aus einem Budget zu entfernen, rufen Sie die Methode REMOVE_CYCLE_START_ACTION für die Budgetinstanz auf:

CALL budget_db.sch1.my_budget!REMOVE_CYCLE_START_ACTION();

Erweitertes Beispiel¶

Das folgende Beispiel zeigt, wie Sie eine gespeicherte Prozedur schreiben, die durch eine Zyklusstartaktion aufgerufen wird, wie Sie die erforderlichen Berechtigungen für die Prozedur erteilen und dann die Zyklusstartaktion für das Budget festlegen.

1. Erstellen Sie eine gespeicherte Prozedur, die allen Anforderungen entspricht:

   CREATE OR REPLACE PROCEDURE code_db.sch1.reset_resources(
       integration_name STRING,
       email_list STRING,
       email_subject STRING,
       email_content STRING)
   RETURNS STRING
   LANGUAGE JAVASCRIPT
   EXECUTE AS OWNER
   AS
   $$
       // Re-enable warehouses or reset configurations here
       var enable_wh = "ALTER WAREHOUSE my_warehouse RESUME;";
       var statement1 = snowflake.createStatement({sqlText: enable_wh});
       statement1.execute();
   
       // Send notification about new cycle
       var sql_command = "CALL SYSTEM$SEND_EMAIL('" + INTEGRATION_NAME + "', " +
                                               "'" + EMAIL_LIST + "', " +
                                               "'" + EMAIL_SUBJECT + "'," +
                                               "'" + EMAIL_CONTENT + "'" + ");";
       var statement2 = snowflake.createStatement({sqlText: sql_command});
       statement2.execute();
       return "Resources reset for new budget cycle";
   $$;
   

   Copy

2. Erteilen Sie der SNOWFLAKE-Anwendung Berechtigungen für die gespeicherte Prozedur:

   GRANT USAGE ON DATABASE code_db TO APPLICATION SNOWFLAKE;
   GRANT USAGE ON SCHEMA code_db.sch1 TO APPLICATION SNOWFLAKE;
   GRANT USAGE ON PROCEDURE code_db.sch1.reset_resources(STRING, STRING, STRING, STRING)
     TO APPLICATION SNOWFLAKE;
   

   Copy

3. Legen Sie die Zyklusstartaktion für das Budget fest:

   CALL budget_db.sch1.my_budget!SET_CYCLE_START_ACTION(
     SYSTEM$REFERENCE('PROCEDURE', 'code_db.sch1.reset_resources(STRING, STRING, STRING, STRING)'),
     ARRAY_CONSTRUCT('my_int', 'admin@example.com', 'Budget Cycle Restarted', 'New budget cycle has begun'));
   

   Copy

Problembehandlung bei Zyklusstartaktionen¶

Wenn eine Zyklusstartaktion nicht wie erwartet funktioniert, verwenden Sie die folgenden Methoden, um das Problem zu diagnostizieren.

SELECT th.*, ci.name AS budget_name
  FROM SNOWFLAKE.ACCOUNT_USAGE.TASK_HISTORY th
  JOIN SNOWFLAKE.ACCOUNT_USAGE.CLASS_INSTANCES ci
    ON th.instance_id = ci.id
  WHERE ci.class_name = 'BUDGET'
    AND th.name ILIKE '_budget_cycle_start_task'
    AND ci.name = '<budget_name>'
  ORDER BY th.completed_time DESC
  LIMIT 10;

SHOW GRANTS ON PROCEDURE code_db.sch1.reset_resources(STRING, STRING, STRING, STRING);

CALL budget_db.sch1.my_budget!GET_CONFIG();

CALL budget_db.sch1.my_budget!GET_CYCLE_START_ACTION();