Kategorien:: Systemfunktionen (Systemsteuerung)

SYSTEM$CREATE_BILLING_EVENTS¶

Erstellt mehrere abrechenbare Ereignisse, die die Nutzung der installierten monetarisierten Anwendungen durch den Verbraucher verfolgen. Verwenden Sie diese Systemfunktion, wenn Sie die Häufigkeitsbeschränkung von einem Ereignis pro Minute von SYSTEM$CREATE_BILLING_EVENT überschreiten müssen. Diese Systemfunktion kann nur von einer Anwendung aus aufgerufen werden, die in einem Verbraucherkonto installiert ist.

Syntax¶

SYSTEM$CREATE_BILLING_EVENTS('<json_array_of_events>')

Copy

Argumente¶

'json_array_of_events'

Eine STRING mit einem JSON-Array von Objekten. Jedes Objekt spezifiziert ein Abrechnungsereignis.

Jedes JSON-Objekt enthält die folgenden Schlüssel-Wert-Paare:

{
  "class": "my_class",
  "subclass": "my_subclass",
  "start_timestamp": 1730825611,
  "timestamp": 1730826611,
  "base_charge": 1.00,
  "objects": "[\"my_schema.my_udf\"]",
  "additional_info": "my_additional_info"
}

Copy

Die folgende Tabelle beschreibt diese Schlüssel-Wert-Paare:

Schlüssel-Wert-Paar

Typ

Beschreibung

"class"

STRING

Bezeichner für die kundenspezifische Ereignisklasse.

"subclass"

STRING

Bezeichner für die kundenspezifische Ereignis-Unterklasse. Dieses Feld wird nur vom Anbieter verwendet.

"start_timestamp"

INTEGER

Die Startzeit (UTC) des Ereignisses als Unix-Zeitstempel in Millisekunden.

"timestamp"

INTEGER

Der Zeitstempel (UTC), wann das Ereignis als Unix-Zeitstempel in Millisekunden erstellt wurde.

"base_charge"

DOUBLE

Der Betrag in US-Dollar, der für das kostenpflichtige Ereignis berechnet werden soll. Der Wert muss größer als Null und kleiner als 99.999,99 sein und darf eine Genauigkeit von zwei Dezimalstellen nicht überschreiten. Beispiel: 1.00 oder 0.07

"objects"

STRING

Ein JSON-Zeichenfolgen-Array mit vollqualifizierten Objektnamen, die auf das Ereignis zutreffen.

"additional_info"

STRING

Eine JSON-Zeichenfolge mit Schlüssel-Wert-Paaren, die der Anbieter verwenden kann, um zusätzliche Informationen zu senden.

Schlüssel-Wert-Paar	Typ	Beschreibung
`"class"`	STRING	Bezeichner für die kundenspezifische Ereignisklasse.
`"subclass"`	STRING	Bezeichner für die kundenspezifische Ereignis-Unterklasse. Dieses Feld wird nur vom Anbieter verwendet.
`"start_timestamp"`	INTEGER	Die Startzeit (UTC) des Ereignisses als Unix-Zeitstempel in Millisekunden.
`"timestamp"`	INTEGER	Der Zeitstempel (UTC), wann das Ereignis als Unix-Zeitstempel in Millisekunden erstellt wurde.
`"base_charge"`	DOUBLE	Der Betrag in US-Dollar, der für das kostenpflichtige Ereignis berechnet werden soll. Der Wert muss größer als Null und kleiner als 99.999,99 sein und darf eine Genauigkeit von zwei Dezimalstellen nicht überschreiten. Beispiel: `1.00` oder `0.07`
`"objects"`	STRING	Ein JSON-Zeichenfolgen-Array mit vollqualifizierten Objektnamen, die auf das Ereignis zutreffen.
`"additional_info"`	STRING	Eine JSON-Zeichenfolge mit Schlüssel-Wert-Paaren, die der Anbieter verwenden kann, um zusätzliche Informationen zu senden.

Rückgabewerte¶

Diese Funktion gibt die folgenden Statusmeldungen zurück:

Statusmeldung

Beschreibung

Success

Zeigt an, dass das abrechenbare Ereignis erfolgreich erstellt wurde.

Invalid parameter: <PARAM_NAME>.

Zeigt an, dass ein nicht unterstützter Parameter an die Funktion übergeben wurde.

Nur aus einer Anwendung heraus aufrufbar.

Zeigt an, dass die Funktion von außerhalb einer Anwendung aufgerufen wurde.

Die Länge der Nutzdaten (Payload) überschreitet die Grenze von 9000 Zeichen.

Zeigt an, dass der Aufruf der Funktion die Zeichenbeschränkung überschreitet.

Die Anzahl der Ereignisse überschreitet die Beschränkung von 100.

Zeigt an, dass die maximale Anzahl von abrechenbaren Ereignissen für einen einzelnen Anruf erreicht wurde. Die angegebene kundenspezifische Ereignisklasse wird bei dieser Bestimmung nicht verwendet.

Zu viele Aufrufe. Pro 10-Millisekunden-Fenster ist maximal 1 Aufruf erlaubt.

Zeigt an, dass eine Anwendung innerhalb eines bestimmten Zeitraums zu viele Aufrufe an diese Systemfunktion gesendet hat.

Statusmeldung	Beschreibung
Success	Zeigt an, dass das abrechenbare Ereignis erfolgreich erstellt wurde.
Invalid parameter: `<PARAM_NAME>`.	Zeigt an, dass ein nicht unterstützter Parameter an die Funktion übergeben wurde.
Nur aus einer Anwendung heraus aufrufbar.	Zeigt an, dass die Funktion von außerhalb einer Anwendung aufgerufen wurde.
Die Länge der Nutzdaten (Payload) überschreitet die Grenze von 9000 Zeichen.	Zeigt an, dass der Aufruf der Funktion die Zeichenbeschränkung überschreitet.
Die Anzahl der Ereignisse überschreitet die Beschränkung von 100.	Zeigt an, dass die maximale Anzahl von abrechenbaren Ereignissen für einen einzelnen Anruf erreicht wurde. Die angegebene kundenspezifische Ereignisklasse wird bei dieser Bestimmung nicht verwendet.
Zu viele Aufrufe. Pro 10-Millisekunden-Fenster ist maximal 1 Aufruf erlaubt.	Zeigt an, dass eine Anwendung innerhalb eines bestimmten Zeitraums zu viele Aufrufe an diese Systemfunktion gesendet hat.

Nutzungshinweise¶

Diese Systemfunktion kann nur aus einer gespeicherten Prozedur im Setup-Skript einer Anwendung aufgerufen werden, die mit dem Snowflake Native App Framework erstellt wurde.

Beispiele¶

Siehe Beispiele für abrechenbare Ereignisse.