カテゴリ：

システム関数 （システム制御）

SYSTEM$CREATE_BILLING_EVENTS

インストールされた収益化アプリケーションのコンシューマーの使用状況を追跡する複数の 請求可能イベント を作成します。このシステム関数は、 SYSTEM$CREATE_BILLING_EVENT の1分間に1回のイベント頻度制限を超える必要がある場合に使用します。このシステム関数は、コンシューマーアカウントにインストールされたアプリケーションからのみ呼び出すことができます。

構文

SYSTEM$CREATE_BILLING_EVENTS('<json_array_of_events>')
Copy

引数

'json_array_of_events'

JSON オブジェクトの配列を含む STRING。各オブジェクトは請求イベントを指定します。

各 JSON オブジェクトには、以下のキーと値のペアが含まれています。

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

以下のテーブルは、これらのキーと値のペアについて説明したものです。

キーと値のペア

型

説明

"class"

STRING

カスタムイベントクラスの識別子。

"subclass"

STRING

カスタムイベントのサブクラスの識別子。このフィールドはプロバイダーのみが使用します。

"start_timestamp"

INTEGER

イベントの開始時刻（UTC）（Unixタイムスタンプとしてミリ秒単位）。

"timestamp"

INTEGER

イベントが作成された時のタイムスタンプ（UTC）をUnixタイムスタンプとしてミリ秒単位で返します。

"base_charge"

DOUBLE

請求可能なイベントに請求する US ドル単位の金額。値は0より大きく、99,999.99より小さくし、小数点以下2桁の精度を超えないようにする必要があります。例: 1.00 または 0.07。

"objects"

STRING

イベントに適用される完全修飾オブジェクト名を含む JSON 文字列配列。

"additional_info"

STRING

プロバイダーが追加情報を送信するために使用できるキーと値のペアの JSON 文字列。

戻り値

この関数は以下のステータスメッセージを返します。

ステータスメッセージ

説明

Success

請求対象イベントが正常に作成されたことを示します。

Invalid parameter: <PARAM_NAME>.

関数にサポートされていないパラメーターが渡されたことを示します。

Only callable from within an application.

この関数がアプリケーションの外部から呼び出されたことを示します。

Payload length exceeds the limit of 9000 characters.

関数の呼び出しが文字数制限を超えたことを示します。

Number of events exceeds the limit of 100.

単一呼び出しの最大請求対象イベント数に達したことを示します。指定されたカスタムイベントクラスは、この決定では使用されません。

Too many calls.10ミリ秒ウィンドウごとに最大1コールまで使用できます。

特定の期間内で、アプリケーションがこのシステム関数を過剰に呼び出したことを示します。

使用上の注意

このシステム関数は、 Snowflake Native App Framework を使用して作成されたアプリケーションのセットアップスクリプト内にあるストアドプロシージャからのみ呼び出すことができます。

例

請求対象イベントの例 をご参照ください。

言語: 日本語