- 카테고리:
시스템 함수 (시스템 제어)
SYSTEM$CREATE_BILLING_EVENT¶
설치된 수익 창출 애플리케이션의 컨슈머 사용량을 추적하는 청구 가능한 이벤트 를 생성합니다. 이 시스템 함수의 분당 이벤트 1개 빈도 제한을 초과해야 하는 경우 SYSTEM$CREATE_BILLING_EVENTS 을 사용하십시오. 이 시스템 함수는 컨슈머 계정에 설치된 애플리케이션에서만 호출할 수 있습니다.
구문¶
SYSTEM$CREATE_BILLING_EVENT(
'<class>',
'<subclass>',
<start_timestamp>,
<timestamp>,
<base_charge>,
'<objects>',
'<additional_info>'
)
인자¶
필수:
'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 를 사용하여 만든 애플리케이션의 설정 스크립트에 있는 저장 프로시저 내에서만 호출할 수 있습니다.
예¶
청구 가능한 이벤트의 예 섹션을 참조하십시오.