카테고리:

시스템 함수 (시스템 제어)

SYSTEM$CREATE_BILLING_EVENTS

설치된 수익 창출 애플리케이션의 컨슈머 사용량을 추적하는 여러 개의 청구 가능 이벤트 를 생성합니다. SYSTEM$CREATE_BILLING_EVENT 의 분당 이벤트 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)을 밀리초 단위의 유닉스 타임스탬프로 표시합니다.

"timestamp"

INTEGER

이벤트가 생성된 타임스탬프(UTC)는 밀리초 단위의 유닉스 타임스탬프입니다.

"base_charge"

DOUBLE

청구 가능한 이벤트에 대해 청구할 US 달러 단위의 금액입니다. 값은 0보다 크고 99,999.99보다 작아야 하며 소수점 이하 두 자리의 정밀도를 넘지 않아야 합니다. 예: 1.00 또는 0.07.

"objects"

STRING

이벤트에 적용되는 정규화된 오브젝트 이름이 포함된 JSON 문자열 배열입니다.

"additional_info"

STRING

공급자가 추가 정보를 보내는 데 사용할 수 있는 키-값 페어의 JSON 문자열입니다.

반환

이 함수는 다음 상태 메시지를 반환합니다.

상태 메시지

설명

성공

청구 가능한 이벤트가 성공적으로 생성되었음을 나타냅니다.

유효하지 않은 매개 변수: <PARAM_NAME>.

지원되지 않는 매개 변수가 함수에 전달되었음을 나타냅니다.

애플리케이션 내에서만 호출할 수 있습니다.

함수가 애플리케이션 외부에서 호출되었음을 나타냅니다.

페이로드 길이가 9,000자 제한을 초과합니다.

함수 호출이 문자 제한을 초과함을 나타냅니다.

이벤트 수가 100개 제한을 초과합니다.

단일 호출에 대한 최대 청구 가능 이벤트 수에 도달했음을 나타냅니다. 지정된 사용자 지정 이벤트 클래스는 이 결정에 사용되지 않습니다.

호출이 너무 많습니다. 10밀리초의 간격마다 많아야 1개의 호출이 허용됩니다.

애플리케이션이 특정 기간 내에 이 시스템 함수를 너무 많이 호출했음을 나타냅니다.

사용법 노트

이 시스템 함수는 Snowflake Native App Framework 를 사용하여 만든 애플리케이션의 설정 스크립트에 있는 저장 프로시저 내에서만 호출할 수 있습니다.

예

청구 가능한 이벤트의 예 섹션을 참조하십시오.

언어: 한국어