Compartir vía

Referencia de las tablas del sistema Marketplace

  • Artículo

Importante

Esta tabla del sistema está en versión preliminar pública. Para acceder a la tabla, el esquema debe estar habilitado en el catálogo system. Para obtener más información, consulte Habilitación de esquemas de tabla del sistema.

Este artículo proporciona una información general sobre cómo utilizar las tablas del sistema para ayudar a hacer operativo su proceso de venta en Databricks Marketplace.

Las tablas del sistema Marketplace viven en el esquema system.marketplace. Están disponibles las siguientes tablas:

  • Acceso a listados: Registra la información del consumidor para los eventos de solicitud de datos u obtención de datos completados en sus listados.
  • Eventos de embudo: Registra las impresiones y acciones realizadas en sus anuncios.

Nota:

Puede usar el panel de Análisis de proveedores para supervisar las métricas de uso de los destinatarios. El panel extrae datos de las tablas del sistema de Marketplace. Consulte Supervisión de la enumeración de métricas de uso mediante paneles.

Listado de la tabla de eventos de acceso

La tabla de eventos de acceso de lista recupera la información del consumidor para los datos de solicitud completados o para obtener eventos de datos en sus listados.

Ruta de acceso de tabla: esta tabla del sistema se encuentra en system.marketplace.listing_access_events.

Nombre de la columna Tipo de datos Descripción
account_id cadena El id. de la cuenta que hospeda la lista.
metastore_id cadena Identificador de metatore que hospeda la lista.
metastore_cloud cadena Proveedor de nube del metastore que hospeda la lista.
metastore_region cadena Región del metastore que hospeda la lista.
provider_id cadena Identificador del perfil de proveedor.
provider_name cadena Nombre del perfil de proveedor.
listing_id cadena Id. de la lista.
listing_name cadena Nombre de la lista.
consumer_delta_sharing_recipient_name cadena Nombre de destinatario subyacente de Delta Sharing para el consumidor. El valor es null cuando el event_type es REQUEST_DATA.
consumer_delta_sharing_recipient_type cadena Si el consumidor está en una cuenta de Azure Databricks o no. Los valores serán OPEN o DATABRICKS.
consumer_cloud cadena La nube del consumidor. Admite valores NULL si consumer_delta_sharing_recipient_type es OPEN.
consumer_region cadena Región del consumidor. Admite valores NULL si consumer_delta_sharing_recipient_type es OPEN.
consumer_metastore_id cadena Identificador de metastore del consumidor. Admite valores NULL si consumer_delta_sharing_recipient_type es OPEN.
consumer_email cadena Dirección de correo electrónico del consumidor. PII.
consumer_name cadena Nombre del consumidor. PII.
consumer_company cadena La empresa del consumidor.
consumer_intended_use cadena El uso previsto del consumidor de la lista.
consumer_comments cadena Cualquier comentario adicional que el consumidor dejó.
event_type cadena Tipo de acceso. El valor puede ser o REQUEST_DATA o GET_DATA.
event_date date Fecha UTC en la que se produjo el evento.
event_time timestamp Marca de tiempo UTC exacta cuando se produjo el evento. La información de zona horaria se registra al final del valor con +00:00, que representa la hora UTC.

Listado de la tabla de eventos del embudo

La tabla de eventos de embudo de lista analiza las impresiones y las acciones realizadas en las listas. event_type le indica qué acción realizó el consumidor en su anuncio.

Ruta de acceso de tabla: esta tabla del sistema se encuentra en system.marketplace.listing_funnel_events.

Nombre de la columna Tipo de datos Descripción
account_id cadena El id. de la cuenta que hospeda la lista.
metastore_id cadena Identificador de metatore que hospeda la lista.
metastore_cloud cadena Proveedor de nube del metastore que hospeda la lista.
metastore_region cadena Región del metastore que hospeda la lista.
provider_id cadena Identificador del perfil de proveedor.
provider_name cadena Nombre del perfil de proveedor.
listing_id cadena Id. de la lista.
listing_name cadena Nombre de la lista.
event_type string El tipo de acción de consumidor. Consulte Tipos de eventos.
event_time timestamp Marca de tiempo UTC exacta cuando se produjo el evento. La información de zona horaria se registra al final del valor con +00:00, que representa la hora UTC.
event_date date Fecha UTC en la que se produjo el evento.
consumer_cloud string La nube del consumidor. Admite valores NULL si consumer_delta_sharing_recipient_type es OPEN.
consumer_region cadena Región del consumidor. Admite valores NULL si consumer_delta_sharing_recipient_type es OPEN.

Tipos de eventos

Los valores posibles para la columna event_type son:

  • 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

Limitaciones conocidas

  • A partir del 12 de marzo de 2024, las tablas del sistema de Marketplace incluyen la actividad de los consumidores que usan Databricks en Google Cloud. Las tablas no incluyen la actividad de consumidor de Google Cloud antes de esta fecha.
  • En la tabla listing_funnel_events, los tipos de evento de ABANDON_FAIL_DATA y FAIL_GET_DATA no se registraron antes del 30 de noviembre de 2023.

Consultas de ejemplo

En esta sección se incluyen las siguientes consultas de ejemplo que puede usar para obtener información sobre la actividad del consumidor en sus listados.

Solicitudes de consumidor de los últimos 10 días

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)

Listados principales por número de solicitudes

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

Visualización de los solicitantes principales

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

Ver el número de veces que se ha realizado cada acción del consumidor en un anuncio

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

Demostración del bloc de notas: Analizar las tablas del sistema Marketplace

El siguiente bloc de notas incluye las consultas de ejemplo de este artículo junto con celdas adicionales que proporcionan un análisis más profundo.

Demostración de la tabla del sistema Marketplace

Obtener el cuaderno