스키마:: DATA_SHARING_USAGE

PAID_LISTING_ACCESS_AND_CHANGE_LOG 뷰¶

공급자는 데이터 공유 사용 스키마에서 이 뷰를 사용하여 컨슈머의 유료 목록 변경 로그를 쿼리하여 가격 계획의 상태와 컨슈머가 유료 또는 평가판 목록에 액세스할 수 없게 되는 시기를 확인할 수 있습니다.

이 뷰는 컨슈머가 가격 계획을 변경하거나 평가판 목록을 시작 또는 종료하거나 구독을 취소할 때 업데이트됩니다.

열¶

열 이름	데이터 타입	설명
EVENT_DATE	DATETIME	행이 생성된 날짜 및 시간입니다.
LISTING_NAME	VARCHAR	가격 계획과 관련된 목록의 이름입니다.
LISTING_DISPLAY_NAME	VARCHAR	목록 표시 이름입니다.
LISTING_GLOBAL_NAME	VARCHAR	목록의 Unique Listing Locator(ULL)입니다.
CONSUMER_ACCOUNT_NAME	VARCHAR	컨슈머 계정 이름입니다.
CONSUMER_ACCOUNT_LOCATOR	VARCHAR	Snowflake 컨슈머 계정 찾기.
CONSUMER_ORGANIZATION_NAME	VARCHAR	컨슈머 조직 이름입니다.
CONSUMER_SNOWFLAKE_REGION	VARCHAR	컨슈머의 조직 청구 및 배송 주소에 해당하는 Snowflake Region입니다.
CURRENT_PRICING_PLAN	VARIANT	EVENT_DATE 열에 지정된 날짜와 시간에 활동한 가격 계획에 대한 JSON 형식의 정보입니다. 반환할 수 있는 정보는 다음과 같습니다. PLAN_TYPE: 가격 계획 유형. 값은 (SUBSCRIPTION, USAGE)일 수 있습니다. PLAN_SUB_TYPE: 다음 중 하나: PLAN_TYPE 은 SUBSCRIPTION 이며, INSTALLMENTS 또는 FIXED 중 하나입니다. PLAN_TYPE 은 USAGE 이며, PER_QUERY, COMPUTE_POOL_SURCHARGE 또는 CUSTOM_BILLING 중 하나 입니다. FREE_QUERIES_LIMIT: 사용량 가격이 적용되기 전에 컨슈머에게 허용되는 무료 쿼리 횟수입니다. PER_QUERY_PRICE: 사용량 기반 계획의 쿼리당 비용입니다. BASE_PRICE: 월 기본 사용 요금입니다. MAX_MONTHLY_PRICE_LIMIT: 월 최대 사용 요금입니다. MAX_TRIAL_DAYS_LIMIT: 컨슈머 평가판의 시간 제한입니다. MAX_TRIAL_QUERIES_LIMIT: 컨슈머 평가판의 사용 제한입니다. BILLING_DURATION_MONTHS: 계약 기간(개월)입니다. CUSTOM_BILLING_EVENTS: 기존 사용자 지정 청구 이벤트 목록입니다. 다음 중 하나: CLASS_NAME: 청구 이벤트 클래스 이름입니다. DISPLAY_NAME: 청구 이벤트 이름입니다. UNIT_PRICE: 청구 가능한 단위당 가격입니다. DESCRIPTION: 가격 계획 설명입니다. IS_AUTO_RENEWAL_ALLOWED: 컨슈머가 목록을 자동으로 갱신할 수 있는지 여부를 나타내며, `true` 또는 `false` 입니다. INSTALLMENT_SCHEDULE: 할부 계획 일정입니다. INSTALLMENT_DURATION_MONTHS: 할부 만기 개월 수입니다. DEFAULT_INSTALLMENT_PRICE: 일할 계산 또는 선불 결제와 같은 예외를 제외한 각 할부 결제의 일반적인 달러 금액입니다. INSTALLMENT_OVERRIDES: 재정의된 설치 관리자 목록입니다. 다음 중 하나: INSTALLMENT_NUMBER: 할부 번호가 재정의되었습니다. INSTALLMENT_PRICE: 할부 가격입니다. IS_EARLY_ACCESS_ALLOWED: 컨슈머는 결제 전에 데이터에 액세스할 수 있습니다. COMPUTE_POOL_SURCHARGES: 정의된 Snowpark Container Services(SPCS) 계산 풀 할증료 목록입니다. 다음 중 하나: COMPUTE_POOL_NAME: 컴퓨팅 풀 이름입니다. UNIT_PRICE: 컴퓨팅 풀 사용에 대한 크레딧당 또는 시간당 가격입니다. CURRENCY: 가격 계획 통화는 미국 달러입니다.
NEXT_PRICING_PLAN	VARIANT	`CURRENT_PRICING_PLAN_END_ON` 열에 지정된 날짜와 시간에 활성화되는 가격 계획에 대한 JSON 형식의 정보입니다. 이 열의 JSON 형식은 `CURRENT_PRICING_PLAN` 의 형식과 동일합니다.
IS_CONSUMER_AUTO_RENEWAL_ENABLED	BOOLEAN	컨슈머가 자동 갱신을 사용하도록 설정했습니다. 이는 구독 애플리케이션 목록에만 적용됩니다.
PURCHASE_STATE	VARCHAR	목록 상태입니다. 상태는 다음 중 하나일 수 있습니다. TRIAL EXPIRED DELETED PURCHASED
CURRENT_PRICING_PLAN_START_ON	DATETIME	가격 계획이 활성화된 날짜와 시간입니다.
CURRENT_PRICING_PLAN_END_ON	DATETIME	현재 가격 계획이 종료되는 날짜와 시간입니다.
TRIAL_END_ON	DATETIME	목록 평가판의 종료일입니다.
ACCESS_END_ON	DATETIME	현재 구독 기간이 종료되는 날짜와 시간입니다. NULL 은 현재 요금제가 구독이 아닌 사용량 기반 요금제임을 나타냅니다.

사용법 노트¶

뷰 지연 시간은 최대 2일이 소요될 수 있습니다.
데이터는 최대 1년까지 보관됩니다.
열이 변경되면 행이 생성됩니다. 예를 들어, 컨슈머가 가격 계획을 변경하거나 평가판을 시작 또는 종료하거나 구독을 취소하거나 데이터를 삭제하는 경우 등입니다.
이 데이터에는 목록 구독 또는 평가판을 취소한 컨슈머를 포함하여 목록에 한 번 이상 액세스한 모든 컨슈머가 포함됩니다.
이 뷰에는 한 명 이상의 컨슈머가 있는 유료 Snowflake 목록에 대한 데이터가 포함되어 있습니다.
이 보고서에는 컨슈머당 목록당 한 행이 포함됩니다. 예를 들어, 컨슈머가 공급자로부터 두 개의 목록을 구매하고 각 구매가 세 번 업데이트된 경우 뷰에는 6개의 항목이 포함됩니다. 개별 열은 단일 특정 구매의 상태를 나타냅니다.
다음 데이터는 뷰에 포함되지 않습니다.
- 제한적 평가판 목록
- 무료 목록 - Snowflake 플랫폼 안팎에서 무료로 제공됩니다
- 무료 목록 - 플랫폼 내에서는 무료로 제공되지만 플랫폼 외부에서는 공급자에게 직접 유료로 제공됩니다
- 컨슈머가 한 번도 액세스하지 않은 목록

예¶

지정된 목록 및 컨슈머에 대한 변경 로그를 표시합니다.

SELECT
  event_date,
  listing_name,
  listing_global_name,
  consumer_account_name,
  consumer_account_locator,
  consumer_organization_name,
  current_pricing_plan,
  next_pricing_plan,
  is_consumer_auto_renewal_enabled,
  purchase_state,
  current_pricing_plan_start_on,
  current_pricing_plan_end_on,
  trial_end_on,
  access_end_on
FROM snowflake.data_sharing_usage.paid_listing_access_and_change_log
WHERE TRUE
  AND consumer_organization_name = 'specific_organization_name'
  AND listing_display_name = 'specific_listing_display_name'
ORDER BY event_date DESC;

Copy

다음 청구 기간에 종료되는 가격 계획이 있는 목록과 컨슈머를 표시합니다.

SELECT
  event_date,
  listing_name,
  listing_global_name,
  consumer_account_name,
  consumer_account_locator,
  consumer_organization_name,
  current_pricing_plan,
  next_pricing_plan,
  is_consumer_auto_renewal_enabled,
  purchase_state,
  current_pricing_plan_start_on,
  current_pricing_plan_end_on,
  trial_end_on,
  access_end_on
FROM snowflake.data_sharing_usage.paid_listing_access_and_change_log
WHERE TRUE
  AND consumer_organization_name = 'specific_organization_name'
  AND listing_display_name = 'specific_listing_display_name'
QUALIFY TRUE
  AND ROW_NUMBER() OVER (
   PARTITION BY
    consumer_organization_name,
    consumer_snowflake_region,
    consumer_account_name,
    listing_display_name
ORDER BY event_date DESC ) = 1;

Copy