Partager via

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

Important

Cette table système est en préversion publique.

Cette page fournit une référence sur l’utilisation des tables système pour surveiller votre processus de vente de la Place de marché Databricks .

Les tables système de la Place de marché sont actives dans le schéma system.marketplace. Ce schéma est activé automatiquement lorsqu’une description de la place de marché est ajoutée dans votre metastore. Le schéma comprend les tableaux suivants :

  • 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 Descriptif
account_id ficelle L’ID du compte qui héberge le référencement.
metastore_id ficelle ID du metastore qui héberge la liste.
metastore_cloud ficelle Le fournisseur de cloud du metastore qui héberge le référencement.
metastore_region ficelle La région du metastore qui héberge le référencement.
provider_id ficelle L’ID du profil du fournisseur.
provider_name ficelle Le nom du profil du fournisseur.
listing_id ficelle L’ID du référencement.
listing_name ficelle Le nom du référencement.
consumer_delta_sharing_recipient_name ficelle 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 ficelle Indique si le consommateur se trouve sur un compte Azure Databricks ou non. Les valeurs seront OPEN ou DATABRICKS.
consumer_cloud ficelle Le cloud du consommateur. Nullable si consumer_delta_sharing_recipient_type est OPEN.
consumer_region ficelle Région du consommateur. Nullable si consumer_delta_sharing_recipient_type est OPEN.
consumer_metastore_id ficelle ID du metastore du consommateur. Nullable si consumer_delta_sharing_recipient_type est OPEN.
consumer_email ficelle Adresse e-mail du consommateur.
consumer_name ficelle Nom du consommateur.
consumer_company ficelle L’entreprise du consommateur.
consumer_intended_use ficelle Utilisation prévue par le consommateur de la liste.
consumer_comments ficelle Tout commentaire supplémentaire laissé par le consommateur.
event_type ficelle 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 horodatage 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 Descriptif
account_id ficelle L’ID du compte qui héberge le référencement.
metastore_id ficelle ID du metastore qui héberge la liste.
metastore_cloud ficelle Le fournisseur de cloud du metastore qui héberge le référencement.
metastore_region ficelle La région du metastore qui héberge le référencement.
provider_id ficelle L’ID du profil du fournisseur.
provider_name ficelle Le nom du profil du fournisseur.
listing_id ficelle L’ID du référencement.
listing_name ficelle Le nom du référencement.
event_type ficelle Le type d’action du consommateur. Consultez Types d’événements.
event_time horodatage 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 ficelle Le cloud du consommateur. Nullable si consumer_delta_sharing_recipient_type est OPEN.
consumer_region ficelle 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

  • Last updated on