Aller au contenu principal

Référence des tables système de la marketplace

info

Aperçu

Cette table système est en aperçu public.

Cette page fournit une référence sur la façon d'utiliser les tables système pour vous aider à surveiller votre processus de vente sur Databricks Marketplace.

Les tables système de la marketplace se trouvent dans le schéma system.marketplace. Ce schéma est activé automatiquement lorsqu'une annonce Marketplace est créée dans votre métastore. Le schéma comprend les tables suivantes :

  • Accès aux annonces: Enregistre les informations du consommateur pour les événements terminés de demande de données ou d' obtention de données sur vos annonces.
  • Événements d'entonnoir: enregistre les impressions et les actions effectuées sur vos annonces.
remarque

Vous pouvez utiliser le tableau de bord d'analytique des fournisseurs pour surveiller les métriques d'utilisation des destinataires. Le tableau de bord extrait les données des tables système de la marketplace. Consultez Surveiller les métriques d'utilisation des annonces à l'aide de tableaux de bord.

Table des événements d'accès de la liste

La table des événements d'accès au listing récupère les informations du consommateur pour les événements demande de données ou obtention de données terminés sur vos listings.

**Chemin de la table** : Cette table système est située system.marketplace.listing_access_events à.

Nom de colonne

Type de données

Description

account_id

chaîne

L’ID de compte qui héberge la fiche.

metastore_id

chaîne

L’ID du metastore qui héberge la fiche.

metastore_cloud

chaîne

Le fournisseur de services cloud du métastore qui héberge le catalogue.

metastore_region

chaîne

La région du métastore qui héberge le catalogue.

provider_id

chaîne

L'ID du profil de fournisseur.

provider_name

chaîne

Le nom du profil du fournisseur.

listing_id

chaîne

L'ID du listing.

listing_name

chaîne

Le nom du listing.

consumer_delta_sharing_recipient_name

chaîne

Le nom du destinataire OpenSharing sous-jacent pour le consommateur. La valeur est null lorsque le type d'événement est REQUEST_DATA.

consumer_delta_sharing_recipient_type

chaîne

Que le consommateur soit sur un compte Databricks ou non. Les valeurs seront OPEN ou DATABRICKS.

consumer_cloud

chaîne

Le cloud du consommateur. Peut être nul si consumer_delta_sharing_recipient_type est OPEN.

consumer_region

chaîne

La région du consommateur. Peut être nul si consumer_delta_sharing_recipient_type est OPEN.

consumer_metastore_id

chaîne

L'ID du métastore du consommateur. Peut être nul si consumer_delta_sharing_recipient_type est OPEN.

consumer_email

chaîne

L'adresse e-mail du consommateur.

consumer_name

chaîne

Le nom du consommateur.

consumer_company

chaîne

La société du consommateur.

consumer_intended_use

chaîne

L'utilisation prévue du listing par le consommateur.

consumer_comments

chaîne

Tout commentaire supplémentaire laissé par le consommateur.

event_type

chaîne

Le type d'accès. La valeur peut être soit REQUEST_DATA ou GET_DATA.

event_date

Date

La date UTC à laquelle l'événement s'est produit.

event_time

Horodatage

Le Timestamp UTC exact où l'événement s'est produit. Les informations de fuseau horaire sont enregistrées à la fin de la valeur, où +00:00 représente l'UTC.

Nom de colonne

Type de données

Description

account_id

chaîne

L’ID de compte qui héberge la fiche.

metastore_id

chaîne

L’ID du metastore qui héberge la fiche.

metastore_cloud

chaîne

Le fournisseur de services cloud du métastore qui héberge le catalogue.

metastore_region

chaîne

La région du métastore qui héberge le catalogue.

provider_id

chaîne

L'ID du profil de fournisseur.

provider_name

chaîne

Le nom du profil du fournisseur.

listing_id

chaîne

L'ID du listing.

listing_name

chaîne

Le nom du listing.

consumer_delta_sharing_recipient_name

chaîne

Le nom du destinataire OpenSharing sous-jacent pour le consommateur. La valeur est null lorsque le type d'événement est REQUEST_DATA.

consumer_delta_sharing_recipient_type

chaîne

Que le consommateur soit sur un compte Databricks ou non. Les valeurs seront OPEN ou DATABRICKS.

consumer_cloud

chaîne

Le cloud du consommateur. Peut être nul si consumer_delta_sharing_recipient_type est OPEN.

consumer_region

chaîne

La région du consommateur. Peut être nul si consumer_delta_sharing_recipient_type est OPEN.

consumer_metastore_id

chaîne

L'ID du métastore du consommateur. Peut être nul si consumer_delta_sharing_recipient_type est OPEN.

consumer_email

chaîne

L'adresse e-mail du consommateur.

consumer_name

chaîne

Le nom du consommateur.

consumer_company

chaîne

La société du consommateur.

consumer_intended_use

chaîne

L'utilisation prévue du listing par le consommateur.

consumer_comments

chaîne

Tout commentaire supplémentaire laissé par le consommateur.

event_type

chaîne

Le type d'accès. La valeur peut être soit REQUEST_DATA ou GET_DATA.

event_date

Date

La date UTC à laquelle l'événement s'est produit.

event_time

Horodatage

Le Timestamp UTC exact où l'événement s'est produit. Les informations de fuseau horaire sont enregistrées à la fin de la valeur, où +00:00 représente l'UTC.

Tableau de la liste des événements du funnel

La table des événements de l'entonnoir d'annonces analyse les impressions et les actions effectuées sur vos annonces. Le event_type vous indique quelle action le consommateur a effectuée sur votre annonce.

**Chemin de la table** : Cette table système est située system.marketplace.listing_funnel_events à.

Nom de colonne

Type de données

Description

account_id

chaîne

L’ID de compte qui héberge la fiche.

metastore_id

chaîne

L’ID du metastore qui héberge la fiche.

metastore_cloud

chaîne

Le fournisseur de services cloud du métastore qui héberge le catalogue.

metastore_region

chaîne

La région du métastore qui héberge le catalogue.

provider_id

chaîne

L'ID du profil de fournisseur.

provider_name

chaîne

Le nom du profil du fournisseur.

listing_id

chaîne

L'ID du listing.

listing_name

chaîne

Le nom du listing.

event_type

chaîne

Le type d’action des consommateurs. Consultez Types d'événement.

event_time

Horodatage

Le Timestamp UTC exact où l'événement s'est produit. Les informations de fuseau horaire sont enregistrées à la fin de la valeur, où +00:00 représente l'UTC.

event_date

Date

La date UTC à laquelle l'événement s'est produit.

consumer_cloud

chaîne

Le cloud du consommateur. Peut être nul si consumer_delta_sharing_recipient_type est OPEN.

consumer_region

chaîne

La région du consommateur. Peut être nul si consumer_delta_sharing_recipient_type est OPEN.

Nom de colonne

Type de données

Description

account_id

chaîne

L’ID de compte qui héberge la fiche.

metastore_id

chaîne

L’ID du metastore qui héberge la fiche.

metastore_cloud

chaîne

Le fournisseur de services cloud du métastore qui héberge le catalogue.

metastore_region

chaîne

La région du métastore qui héberge le catalogue.

provider_id

chaîne

L'ID du profil de fournisseur.

provider_name

chaîne

Le nom du profil du fournisseur.

listing_id

chaîne

L'ID du listing.

listing_name

chaîne

Le nom du listing.

event_type

chaîne

Le type d’action des consommateurs. Consultez Types d'événement.

event_time

Horodatage

Le Timestamp UTC exact où l'événement s'est produit. Les informations de fuseau horaire sont enregistrées à la fin de la valeur, où +00:00 représente l'UTC.

event_date

Date

La date UTC à laquelle l'événement s'est produit.

consumer_cloud

chaîne

Le cloud du consommateur. Peut être nul si consumer_delta_sharing_recipient_type est OPEN.

consumer_region

chaîne

La région du consommateur. Peut être nul si consumer_delta_sharing_recipient_type est OPEN.

Types d'événement

Les valeurs possibles pour la colonne event_type sont :

  • 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

Limitations connues

  • Au 12 mars 2024, les tables système du marketplace incluent l'activité des consommateurs utilisant Databricks sur Google Cloud. Les tables n'incluent pas l'activité des consommateurs Google Cloud avant cette date.

Exemples de requêtes

Cette section comprend les exemples de queries suivants que vous pouvez utiliser pour obtenir des insights sur l'activité des consommateurs sur vos listings.

Demandes des consommateurs des 10 derniers jours

SQL
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)

Listes principales par nombre de requêtes

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

Afficher les principaux demandeurs

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

Affichez le nombre de fois que chaque action du consommateur a été effectuée sur une annonce

SQL
SELECT event_type, COUNT(*) as occurrences
FROM system.marketplace.listing_funnel_events
WHERE listing_name = :listing_name
GROUP BY event_type

Démonstration de Notebook : Analysez les tables système de la marketplace.

Le Notebook suivant comprend les exemples de queries de cet article, ainsi que des cellules supplémentaires qui fournissent une analyse plus approfondie.

Démo de la table système marketplace