Catégories :

Fonctions système (Contrôle du système)

SYSTEM$CREATE_BILLING_EVENTS

Crée plusieurs événements facturables qui permettent de suivre l’utilisation par les consommateurs des applications installées et monétisées. Utilisez cette fonction système si vous devez dépasser la limite de fréquence d’un événement par minute de SYSTEM$CREATE_BILLING_EVENT. Cette fonction système ne peut être appelée qu’à partir d’une application installée sur un compte consommateur.

Syntaxe

SYSTEM$CREATE_BILLING_EVENTS('<json_array_of_events>')
Copy

Arguments

'json_array_of_events'

Une STRING contenant un tableau d’objets JSON. Chaque objet spécifie un événement de facturation.

Chaque objet JSON contient les paires clé-valeur suivantes :

{
  "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

Le tableau suivant décrit ces paires clé-valeur :

Paire clé-valeur.

Type

Description

"class"

STRING

Identificateur de la classe d’événement personnalisée.

"subclass"

STRING

Identificateur de la sous-classe d’événement personnalisé. Ce champ n’est utilisé que par le fournisseur.

"start_timestamp"

INTEGER

Heure de début (UTC) de l’événement sous la forme d’un horodatage Unix en millisecondes.

"timestamp"

INTEGER

Horodatage (UTC) de la création de l’événement sous forme d’horodatage Unix en millisecondes.

"base_charge"

DOUBLE

Montant en dollars US à facturer pour l’événement facturable. La valeur doit être supérieure à zéro, inférieure à 99999,99 et ne doit pas dépasser deux décimales de précision. Par exemple, 1.00 ou 0.07

"objects"

STRING

Tableau de chaînes JSON contenant des noms d’objets complets qui s’appliquent à l’événement.

"additional_info"

STRING

Une chaîne JSON de paires clé-valeur que le fournisseur peut utiliser pour envoyer des informations supplémentaires.

Renvoie

Cette fonction renvoie les messages de statut suivants :

Message de statut

Description

Succès

Indique que l’événement facturable a bien été créé.

Paramètre non valide : <PARAM_NAME>.

Indique qu’un paramètre non pris en charge a été transmis à la fonction.

Ne peut être appelé qu’à partir d’une application.

Indique que la fonction a été appelée depuis l’extérieur d’une application.

La longueur de la charge utile dépasse la limite de 9 000 caractères.

Indique que l’appel à la fonction dépasse la limite de caractères.

Le nombre d’événements dépasse la limite de 100.

Indique que le nombre maximal d’événements facturables a été atteint pour un seul appel. La classe d’événement personnalisée spécifiée n’est pas utilisée dans cette détermination.

Trop d’appels. Au plus 1 appel est autorisé par fenêtre de 10 millisecondes.

Indique qu’une application a effectué un trop grand nombre d’appels à cette fonction du système dans une période donnée.

Notes sur l’utilisation

Cette fonction système ne peut être appelée qu’à partir d’une procédure stockée dans le script d’installation d’une application créée à l’aide de Snowflake Native App Framework.

Exemples

Voir Exemples d’événements facturables.

Langage: Français