Schema:: DATA_SHARING_USAGE

Ansicht PAID_LISTING_ACCESS_AND_CHANGE_LOG¶

Anbieter können diese Ansicht im Nutzung von Data Sharing-Schema verwenden, um das Änderungsprotokoll für kostenpflichtige Angebote eines Kunden abzufragen, um den Status eines Preistarifs zu ermitteln und festzustellen, wann Kunden den Zugang zu kostenpflichtigen Angeboten oder Testangeboten verlieren werden.

Diese Ansicht wird aktualisiert, wenn ein Kunde seinen Preistarif ändert, ein Probeangebot beginnt oder beendet oder wenn er ein Abonnement kündigt.

Spalten¶

Spaltenname	Datentyp	Beschreibung
EVENT_DATE	DATETIME	Datum und Uhrzeit der Erstellung der Zeile.
LISTING_NAME	VARCHAR	Der Name des Freigabeangebots, das mit dem Preistarif verbunden ist.
LISTING_DISPLAY_NAME	VARCHAR	Der Anzeigename der Freigabeangebots.
LISTING_GLOBAL_NAME	VARCHAR	Der Unique Listing Locator (ULL) für das Freigabeangebot.
CONSUMER_ACCOUNT_NAME	VARCHAR	Name des Verbraucherkontos.
CONSUMER_ACCOUNT_LOCATOR	VARCHAR	Snowflake Konto-Locator des Verbraucherkontos.
CONSUMER_ORGANIZATION_NAME	VARCHAR	Der Name der Verbraucherorganisation.
CONSUMER_SNOWFLAKE_REGION	VARCHAR	Die Snowflake-Region, die der Rechnungs- und Lieferadresse des Kunden entspricht.
CURRENT_PRICING_PLAN	VARIANT	Informationen im JSON-Formt über den Preistarif, der an dem in der Spalte EVENT_DATE angegebenen Datum und Uhrzeit aktiv war. Die folgenden Informationen können zurückgegeben werden: PLAN_TYPE: Art des Preistarifs. Folgende Werte sind möglich: (SUBSCRIPTION, USAGE) PLAN_SUB_TYPEEine der folgenden Optionen: Wenn der PLAN_TYPE SUBSCRIPTION ist: Entweder INSTALLMENTS oder FIXED. Wenn der PLAN_TYPE USAGE ist: Entweder PER_QUERY, COMPUTE_POOL_SURCHARGE oder CUSTOM_BILLING. FREE_QUERIES_LIMIT: Die Anzahl der kostenlosen Abfragen, die ein Verbraucher durchführen darf, bevor ein Nutzungspreis anfällt. PER_QUERY_PRICE: Die Kosten pro Abfrage für nutzungsbasierte Pläne. BASE_PRICE: Die monatliche Basisnutzungsgebühr. MAX_MONTHLY_PRICE_LIMIT: Die maximale monatliche Nutzungsgebühr. MAX_TRIAL_DAYS_LIMIT: Das Zeitlimit für Verbrauchertests. MAX_TRIAL_QUERIES_LIMIT: Das Nutzungslimit für Verbrauchertests. BILLING_DURATION_MONTHS: Die Vertragsdauer in Monaten. CUSTOM_BILLING_EVENTS: Eine Liste der vorhandenen benutzerdefinierten Abrechnungsereignisse. Eine der folgenden Optionen: CLASS_NAME: Name der Abrechnungsereignisklasse. DISPLAY_NAME: Der Name des Abrechnungsereignisses. UNIT_PRICE: Preis pro abrechenbare Einheit. DESCRIPTION: Beschreibung des Preistarifs. IS_AUTO_RENEWAL_ALLOWED: Gibt an, ob der Verbraucher das Angebot automatisch verlängern kann: `true` oder `false`. INSTALLMENT_SCHEDULE: Zeitplan für den Ratenzahlungsplan. INSTALLMENT_DURATION_MONTHS: Anzahl der Monate, in denen Ratenzahlungen fällig sind. DEFAULT_INSTALLMENT_PRICE: Der übliche Dollarbetrag jeder Ratenzahlung, ohne Ausnahmen wie anteilige Zahlungen oder Vorauszahlungen. INSTALLMENT_OVERRIDES: Liste der überschriebenen Raten. Eine der folgenden Optionen: INSTALLMENT_NUMBER: Nummer der zu überschreibenden Rate. INSTALLMENT_PRICE: Der Ratenzahlungspreis. IS_EARLY_ACCESS_ALLOWED: Verbraucher können vor der Zahlung auf die Daten zugreifen. COMPUTE_POOL_SURCHARGES: Eine Liste der definierten der zusätzlichen Computepool-Gebühren für Snowpark Container Services (SPCS). Eine der folgenden Optionen: COMPUTE_POOL_NAMEName des Computepools. UNIT_PRICE: Preis pro Credit oder pro Stunde für die Computepool-Nutzung. CURRENCY: Währung des Preistarifs in US-Dollar.
NEXT_PRICING_PLAN	VARIANT	Informationen im JSON-Format über den Preistarif, der zu dem in der Spalte `CURRENT_PRICING_PLAN_END_ON` angegebenen Datum und Uhrzeit aktiv wird. Das JSON-Format für diese Spalte ist identisch mit dem von `CURRENT_PRICING_PLAN`.
IS_CONSUMER_AUTO_RENEWAL_ENABLED	BOOLEAN	Der Verbraucher hat die automatische Erneuerung aktiviert. Dies gilt nur für Abonnement-Angebote.
PURCHASE_STATE	VARCHAR	Status des Freigabeangebots. Der Status kann einer der folgenden sein: TRIAL EXPIRED DELETED PURCHASED
CURRENT_PRICING_PLAN_START_ON	DATETIME	Datum und Uhrzeit der Aktivierung eines Preistarifs.
CURRENT_PRICING_PLAN_END_ON	DATETIME	Datum und Uhrzeit der Beendigung des aktuellen Zeitplans.
TRIAL_END_ON	DATETIME	Enddatum des Tests des Freigabeangebots.
ACCESS_END_ON	DATETIME	Datum und Uhrzeit des Endes des aktuellen Abonnementbedingungen. NULL zeigt an, dass es sich bei dem aktuellen Plan nicht um ein Abonnement handelt, sondern um einen nutzungsbasierten Plan.

Nutzungshinweise¶

Die Latenz der Ansicht kann bis zu zwei Tage betragen.
Die Daten werden bis zu einem Jahr gespeichert.
Eine Zeile wird erstellt, wenn sich eine beliebige Spalte ändert. Zum Beispiel, wenn ein Verbraucher seinen Preistarif ändert, eine Testphase beginnt oder beendet, ein Abonnement kündigt oder die Daten löscht.
Die Daten umfassen alle Verbraucher, die mindestens einmal auf das Freigabeangebot zugegriffen haben, einschließlich derer, die ihr Abonnement oder ihre Testversion des Angebots gekündigt haben.
Die Ansicht enthält Daten für bezahlte Snowflake-Angebote, die einen oder mehrere Verbraucher haben.
Dieser Bericht enthält eine Zeile pro Freigabeangebot pro Verbraucher. Wenn ein Verbraucher zum Beispiel zwei Freigabeangebote von einem Anbieter gekauft hat und jeder Kauf dreimal aktualisiert wurde, enthält die Ansicht sechs Einträge. Eine einzelne Spalte stellt den Status eines einzelnen, spezifischen Kaufs dar.
Die folgenden Daten sind in der Ansicht nicht enthalten:
- Begrenzte Testversionen von Freigabeangeboten
- Kostenlose Freigabeangebote – kostenlos auf oder außerhalb der Snowflake-Plattform bereitgestellt
- Kostenlose Freigabeangebote – kostenlos auf der Plattform bereitgestellt, aber außerhalb der Plattform direkt an den Anbieter bezahlt
- Freigabeangebote, auf die Verbraucher noch nie zugegriffen haben

Beispiele¶

Änderungsprotokoll für ein bestimmtes Freigabeangebot und einen bestimmten Verbraucher anzeigen:

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

Freigabeangebote und Kunden anzeigen, deren Preistarife im nächsten Abrechnungszeitraum enden:

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