카테고리:

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

SYSTEM$CREATE_BILLING_EVENT

설치된 수익 창출 애플리케이션의 컨슈머 사용량을 추적하는 청구 가능한 이벤트 를 생성합니다. 이 시스템 함수는 컨슈머 계정에 설치된 애플리케이션에서만 호출할 수 있습니다.

구문

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

인자

필수:

class

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

유형: 문자열

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

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

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

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

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

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

timestamp

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

유형: 정수

base_charge

청구 가능한 이벤트에 대해 청구할 금액을 미국 달러 단위로 지정합니다. 값은 0보다 크고 99,999.99보다 작아야 하며 소수점 이하 자릿수 2개를 초과하면 안 됩니다. 예: 1.00 또는 0.07.

유형: Double

선택 사항:

subclass

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

유형: 문자열

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

start_timestamp

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

유형: 정수

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

objects

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

유형: 문자열

최대 크기는 4KB입니다.

additional_info

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

유형: 문자열

최대 크기는 4KB입니다.

반환

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

상태 메시지

설명

반환되는 값의 유형

성공

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

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

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

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

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

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

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

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

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

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

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

사용법 노트

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

예

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

언어: 한국어