Freigeben über

Referenz zu Marketplace-Systemtabellen

  • Artikel

Wichtig

Dieses Feature befindet sich in der Public Preview.

Dieser Artikel enthält eine Übersicht, wie Sie das Verwenden von Systemtabellen dabei unterstützen kann, Ihren Databricks Marketplace-Verkaufsprozess zu operationalisieren.

Marketplace-Systemtabellen befinden sich im Schema system.marketplace. Die folgenden Tabellen sind verfügbar:

  • Eintragszugriff: Zeichnet die Consumerinformationen für abgeschlossene request data- oder get data-Ereignisse für Ihre Einträge auf.
  • Trichterereignisse: Zeichnet Aufrufe und Aktionen für Ihre Einträge auf.

Hinweis

Sie können das Anbieteranalysedashboard verwenden, um die Nutzungsmetriken für Empfänger zu überwachen. Das Dashboard pullt Daten aus den Marketplace-Systemtabellen. Siehe Überwachen der Auflistungsnutzungsmetriken mithilfe von Dashboards.

Tabelle mit Eintragszugriffsereignissen

Die Tabelle listing_access_events ruft die Consumerinformationen für abgeschlossene request data- oder get data-Ereignisse für Ihre Einträge ab.

system.marketplace.listing_access_events hat folgendes Schema:

Spaltenname Datentyp Beschreibung
account_id string Die Konto-ID, die das Angebot hostet.
metastore_id Zeichenfolge Die Metastore-ID, die das Angebot hostet.
metastore_cloud Zeichenfolge Der Cloudanbieter des Metastores, der das Angebot hostet.
metastore_region Zeichenfolge Der Region des Metastores, der das Angebot hostet.
provider_id Zeichenfolge Die Profil-ID des Anbieters.
provider_name Zeichenfolge Der Profilname des Anbieters.
listing_id Zeichenfolge Die ID des Angebots.
listing_name Zeichenfolge Der Name des Angebots.
consumer_delta_sharing_recipient_name Zeichenfolge Der zugrunde liegende Delta Sharing-Empfängername für den Consumer. Der Wert ist null, wenn „event-type“ REQUEST_DATA ist.
consumer_delta_sharing_recipient_type Zeichenfolge Gibt an, ob der Verbraucher ein Azure Databricks-Konto verwendet oder nicht. Der Wert ist entweder OPEN oder DATABRICKS.
consumer_cloud Zeichenfolge Die Cloud des Consumers. Ist Nullwerte zulassend, wenn consumer_delta_sharing_recipient_type den Wert OPEN hat.
consumer_region Zeichenfolge Die Region des Consumers. Ist Nullwerte zulassend, wenn consumer_delta_sharing_recipient_type den Wert OPEN hat.
consumer_metastore_id Zeichenfolge Die Metastore-ID des Consumers. Ist Nullwerte zulassend, wenn consumer_delta_sharing_recipient_type den Wert OPEN hat.
consumer_email Zeichenfolge Die E-Mail-Adresse des Consumers. PII.
consumer_name Zeichenfolge Der Name des Consumers. PII.
consumer_company Zeichenfolge Das Unternehmen des Consumers.
consumer_intended_use Zeichenfolge Die Verwendung, die der Consumer mit dem Angebot beabsichtigt.
consumer_comments Zeichenfolge Zusätzliche Kommentare, die der Consumer hinterlassen hat.
event_type Zeichenfolge Der Typ des Zugriffs. Der Wert kann entweder REQUEST_DATA oder GET_DATA sein.
event_date date Das Datum (UTC), zu der das Ereignis aufgetreten ist.
event_time Zeitstempel Der exakte UTC-Zeitstempel für den Zeitpunkt, zu dem das Ereignis aufgetreten ist.

Tabelle mit Eintragstrichterergebnissen

Die Tabelle listing_funnel_events analysiert Aufrufe und Aktionen für Ihre Einträge. event_type teilt Ihnen mit, welche Aktion der Consumer für Ihren Eintrag ausgeführt hat.

system.marketplace.listing_funnel_events hat folgendes Schema:

Spaltenname Datentyp Beschreibung
account_id string Die Konto-ID, die das Angebot hostet.
metastore_id Zeichenfolge Die Metastore-ID, die das Angebot hostet.
metastore_cloud Zeichenfolge Der Cloudanbieter des Metastores, der das Angebot hostet.
metastore_region Zeichenfolge Der Region des Metastores, der das Angebot hostet.
provider_id Zeichenfolge Die Profil-ID des Anbieters.
provider_name Zeichenfolge Der Profilname des Anbieters.
listing_id Zeichenfolge Die ID des Angebots.
listing_name Zeichenfolge Der Name des Angebots.
event_type Zeichenfolge Der Typ der Consumeraktion. Siehe Ereignistypen
event_time Zeitstempel Der exakte UTC-Zeitstempel für den Zeitpunkt, zu dem das Ereignis aufgetreten ist.
event_date Datum Das Datum (UTC), zu der das Ereignis aufgetreten ist.
consumer_cloud Zeichenfolge Die Cloud des Consumers. Ist Nullwerte zulassend, wenn consumer_delta_sharing_recipient_type den Wert OPEN hat.
consumer_region Zeichenfolge Die Region des Consumers. Ist Nullwerte zulassend, wenn consumer_delta_sharing_recipient_type den Wert OPEN hat.

Ereignistypen

Mögliche Werte für die spalte „event_type“:

  • VIEW_LISTING
  • START_REQUEST_DATA
  • COMPLETE_REQUEST_DATA
  • ABANDON_REQUEST_DATA
  • START_GET_DATA
  • COMPLETE_GET_DATA
  • ABANDON_GET_DATA
  • UNINSTALL_DATA
  • FAIL_REQUEST_DATA
  • FAIL_GET_DATA

Bekannte Einschränkungen

  • Ab dem 12. März 2024 schließen Marketplace-Systemtabellen die Aktivitäten von Consumern, die Databricks in Google Cloud verwenden, ein. Die Tabellen enthalten keine Google Cloud-Consumeraktivitäten vor diesem Datum.
  • In der Tabelle listing_funnel_events wurden die Ereignistypen ABANDON_FAIL_DATA und FAIL_GET_DATA vor dem 30. November 2023 nicht aufgezeichnet.

Beispielabfragen

Dieser Abschnitt enthält die folgenden Beispielabfragen, die Sie verwenden können, um Einblicke in Consumeraktivitäten in Ihren Angeboten zu erhalten.

Consumeranforderungen der letzten 10 Tage

SELECT event_date, provider_name, listing_name, listing_id, consumer_delta_sharing_recipient_name, consumer_cloud, consumer_region, consumer_name, consumer_email, consumer_company
FROM system.marketplace.listing_access_events
WHERE event_type = 'REQUEST_DATA'
AND event_date >= date_add(current_date(), -10)

Top-Angebote nach Anzahl der Anforderungen

SELECT listing_name, consumer_cloud, count(*) as requestCount
FROM system.marketplace.listing_access_events
GROUP BY listing_name, consumer_cloud
ORDER BY requestCount DESC

Anzeigen der wichtigsten Anforderer

SELECT consumer_name, consumer_email, count(*) as requestCount
FROM system.marketplace.listing_access_events
GROUP BY consumer_name, consumer_email
ORDER BY requestCount DESC

Anzeigen der Häufigkeit, mit der jede Consumeraktion für einen Eintrag ausgeführt wurde

SELECT event_type, COUNT(*) as occurrences
FROM system.marketplace.listing_funnel_events
WHERE listing_name = `{{listing_name}}`
GROUP BY event_type

Notebook-Demo: Analysieren der Marketplace-Systemtabellen

Das folgende Notebook enthält die Beispielabfragen aus diesem Artikel zusammen mit zusätzlichen Zellen, die weitere Analysen bereitstellen.

Demo für Marketplace-Systemtabellen

Notebook abrufen