카테고리:

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

SYSTEM$CREATE_BILLING_EVENT

설치된 수익 창출 애플리케이션의 컨슈머 사용량을 추적하는 청구 가능한 이벤트 를 생성합니다. 이 시스템 함수의 분당 이벤트 1개 빈도 제한을 초과해야 하는 경우 SYSTEM$CREATE_BILLING_EVENTS 을 사용하십시오. 이 시스템 함수는 컨슈머 계정에 설치된 애플리케이션에서만 호출할 수 있습니다.

구문

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

인자

필수:

'class'

사용자 지정 이벤트 클래스의 식별자입니다.

유형: STRING

식별자에는 다음과 같은 요구 사항이 있습니다.

  • 문자(A-Z) 또는 밑줄(“_”)로 시작해야 합니다.

  • 문자, 밑줄, 10진수(0-9), 달러 기호(“$”)만 포함해야 합니다.

  • 길이는 64자를 초과할 수 없습니다.

  • SNOWFLAKE_ 로 시작하면 안 됩니다. SNOWFLAKE_ 는 내부 식별자용으로 예약되어 있기 때문입니다.

클래스 이름이 저장되고 대문자로 확인됩니다. 클래스 이름 비교는 대/소문자를 구분하지 않습니다.

timestamp

이벤트가 생성된 타임스탬프(UTC)를 밀리초 단위의 Unix 타임스탬프로 지정합니다.

유형: 정수

base_charge

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

유형: DOUBLE

선택 사항:

'subclass'

사용자 지정 이벤트 하위 클래스의 식별자입니다. 공급자만 사용하는 필드입니다.

유형: STRING

식별자의 명명 요구 사항은 class 인자와 동일합니다.

start_timestamp

이벤트의 시작 시간(UTC)을 밀리초 단위의 Unix 타임스탬프로 지정합니다.

유형: INTEGER

공급자가 시간 범위를 기반으로 이벤트를 내보내려는 경우 시작 시간을 설정하는 데 사용합니다. 그렇지 않으면 TIMESTAMP 인자에 사용된 것과 동일한 값으로 설정됩니다.

'objects'

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

유형: STRING

최대 크기는 4KB입니다.

'additional_info'

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

유형: STRING

최대 크기는 4KB입니다.

반환

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

상태 메시지

설명

성공

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

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

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

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

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

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

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

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

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

사용법 노트

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

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