SYSTEM$CREATE_BILLING_EVENT¶

構文¶

SYSTEM$CREATE_BILLING_EVENT(
  <class>,
  <subclass>,
  <start_timestamp>,
  <timestamp>,
  <base_charge>,
  <objects>,
  <additional_info>)

引数¶

必須:

class

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

型: 文字列

識別子には以下の要件があります。

• 文字（A～Z）またはアンダースコア（"_"）で始める必要がある。

• 文字、アンダースコア、10進数（0～9）、およびドル記号（"$"）のみが含まれている必要がある。

• 長さは64文字以下にする必要がある。

• SNOWFLAKE_ で始めることはできない。 SNOWFLAKE_ 内部識別子用に予約されています。

クラス名は大文字で格納され、解決されます。クラス名の比較では、大文字と小文字は区別されません。

timestamp

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

型: 整数

base_charge

請求対象イベントで課金される金額を US ドルで指定します。

型: Double

オプション:

subclass

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

型: 文字列

識別子には、 class 引数と同じ命名要件があります。

start_timestamp

イベントの開始時刻をUnixタイムスタンプとしてミリ秒単位で指定します。

型: 整数

プロバイダーが時間範囲に基づいてイベントを発行する場合、開始時間を設定するために使用します。それ以外の場合は、 TIMESTAMP 引数に使用される値と同じ値を設定します。

objects

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

型: 文字列

最大サイズは4 KB です。

additional_info

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

型: 文字列

最大サイズは4 KB です。

戻り値¶

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

ステータスメッセージ	説明	戻り値の型
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.At most 1 call is allowed per 1 second window.	特定の時間枠内で、アプリケーションがこのシステム関数を過剰に呼び出したことを示します。

使用上の注意¶

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

例¶

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