Partager via

Référence des tables système de la Place de marché

  • Article

Important

Cette table système est en préversion publique. Pour accéder à la table, le schéma doit être activé dans votre catalogue system. Pour plus d’informations, consultez Activer les schémas de table système.

Cet article fournit une vue d’ensemble de l’utilisation des tables système pour faciliter l’opérationnalisation de votre processus de vente Place de marché Databricks.

Les tables système de la Place de marché sont actives dans le schéma system.marketplace. Les tables suivantes sont disponibles :

  • Accès à l’annonce : 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 de synthèse : enregistre les impressions et les actions effectuées sur vos annonces.

Remarque

Vous pouvez utiliser le tableau de bord d’analyse du fournisseur pour monitorer les métriques d’utilisation des destinataires. Le tableau de bord extraie des données des tables système de Place de marché. Consultez Monitorer les métriques d’utilisation des référencements à l’aide de tableaux de bord.

Répertorier la table d’événements d’accès

La table des événements d’accès à la liste récupère les informations du consommateur pour les données de demande terminées ou obtient des événements de données sur vos descriptions.

Chemin d’accès de la table : cette table système se trouve à l’emplacement system.marketplace.listing_access_events.

Nom de la colonne Type de données Description
account_id string L’ID du compte qui héberge le référencement.
metastore_id string L’ID du metastore qui héberge le référencement.
metastore_cloud string Le fournisseur de cloud du metastore qui héberge le référencement.
metastore_region string La région du metastore qui héberge le référencement.
provider_id string L’ID du profil du fournisseur.
provider_name string Le nom du profil du fournisseur.
listing_id string L’ID du référencement.
listing_name string Le nom du référencement.
consumer_delta_sharing_recipient_name string Le nom du destinataire Delta Sharing sous-jacent pour le consommateur. La valeur est null lorsque la valeur event_type est REQUEST_DATA.
consumer_delta_sharing_recipient_type string Indique si le consommateur se trouve sur un compte Azure Databricks ou non. Les valeurs seront OPEN ou DATABRICKS.
consumer_cloud string Le cloud du consommateur. Nullable si consumer_delta_sharing_recipient_type est OPEN.
consumer_region string La région du consommateur. Nullable si consumer_delta_sharing_recipient_type est OPEN.
consumer_metastore_id string L’ID du metastore du consommateur. Nullable si consumer_delta_sharing_recipient_type est OPEN.
consumer_email string L’adresse e-mail du consommateur. PII.
consumer_name string Le nom du consommateur. PII.
consumer_company string La société du consommateur.
consumer_intended_use string L’utilisation prévue du référencement par le consommateur.
consumer_comments string Tout commentaire supplémentaire laissé par le consommateur.
event_type string Type d'accès. La valeur peut être REQUEST_DATA ou GET_DATA.
event_date date La date UTC à laquelle l’événement s’est produit.
event_time timestamp L’exact timestamp UTC auquel l’événement s’est produit. Les informations de fuseau horaire sont enregistrées à la fin de la valeur, où +00:00 représente le fuseau horaire UTC.

Répertorier la table d’événement d’entonnoir

Le tableau des événements d’entonnoir de référencement analyse les impressions et les actions effectuées sur vos descriptions. Le event_type vous indique l’action que le consommateur a effectuée sur votre annonce.

Chemin d’accès de la table : cette table système se trouve à l’emplacement system.marketplace.listing_funnel_events.

Nom de la colonne Type de données Description
account_id string L’ID du compte qui héberge le référencement.
metastore_id string L’ID du metastore qui héberge le référencement.
metastore_cloud string Le fournisseur de cloud du metastore qui héberge le référencement.
metastore_region string La région du metastore qui héberge le référencement.
provider_id string L’ID du profil du fournisseur.
provider_name string Le nom du profil du fournisseur.
listing_id string L’ID du référencement.
listing_name string Le nom du référencement.
event_type string Le type d’action du consommateur. Consultez Types d’événements.
event_time timestamp L’exact timestamp UTC auquel l’événement s’est produit. Les informations de fuseau horaire sont enregistrées à la fin de la valeur, où +00:00 représente le fuseau horaire UTC.
event_date date La date UTC à laquelle l’événement s’est produit.
consumer_cloud string Le cloud du consommateur. Nullable si consumer_delta_sharing_recipient_type est OPEN.
consumer_region string La région du consommateur. Nullable si consumer_delta_sharing_recipient_type est OPEN.

Types d’événement

Les valeurs possibles pour la colonne event_type sont les suivantes :

  • 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

  • Depuis le 12 mars 2024, les tables système de la Place de marché incluent l’activité des consommateurs utilisant Databricks sur Google Cloud. Avant cette date, les tables n’incluaient pas l’activité des consommateurs Google Cloud.
  • Dans le tableau listing_funnel_events, les types d’événements de ABANDON_FAIL_DATA et FAIL_GET_DATA n’ont pas été enregistrés avant le 30 novembre 2023.

Exemples de requêtes

Cette section inclut les exemples de requêtes suivants que vous pouvez utiliser pour obtenir des informations sur l’activité des consommateurs sur vos référencements.

Demandes de consommateurs des 10 derniers jours

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)

Principaux référencements par nombre de requêtes

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

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

Afficher le nombre de fois qu’une action du consommateur a été effectuée sur une annonce

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

Version de démonstration du notebook : Analyser les tables système de la Place de marché

Le notebook suivant comprend les exemples de requêtes de cet article, ainsi que d’autres cellules qui fournissent une analyse plus poussée.

Version de démonstration de la table système de la marketplace

Obtenir le notebook