Référence des tables système de la Place de marché
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 vous aider à 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. 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_LISTINGSTART_REQUEST_DATACOMPLETE_REQUEST_DATAABANDON_REQUEST_DATASTART_GET_DATACOMPLETE_GET_DATAABANDON_GET_DATAUNINSTALL_DATAFAIL_REQUEST_DATAFAIL_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 deABANDON_FAIL_DATAetFAIL_GET_DATAn’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
- Principaux référencements par nombre de requêtes
- Afficher les principaux demandeurs
- Afficher le nombre de fois qu’une action du consommateur a été effectuée sur une annonce
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.