Поделиться через

Справочник по системным таблицам Marketplace

  • Статья

Внимание

Эта функция предоставляется в режиме общедоступной предварительной версии.

В этой статье представлен обзор использования системных таблиц для реализации процесса продажи Databricks Marketplace .

Системные таблицы Marketplace живут в схеме system.marketplace . Доступны следующие таблицы:

  • Перечисление доступа: записывает сведения о потребителе для завершенных данных запроса или получение событий данных в списках.
  • События воронки: записывает впечатления и действия, выполненные на ваших списках.

Примечание.

Панель мониторинга аналитики поставщиков позволяет отслеживать метрики использования получателей. Панель мониторинга извлекает данные из системных таблиц Marketplace. См. статью "Мониторинг метрик использования" с помощью панелей мониторинга.

Перечисление таблицы событий доступа

В listing_access_events таблице извлекаются сведения о потребителе для завершенных данных запроса или получение событий данных в списках.

system.marketplace.listing_access_events имеет следующую схему:

Имя столбца Тип данных Description
account_id строка Идентификатор учетной записи, на котором размещено описание.
metastore_id строка Идентификатор метатора, на котором размещается список.
metastore_cloud строка Поставщик облачных хранилищ метаданных, на котором размещается список.
metastore_region строка Регион хранилища метаданных, на котором размещается список.
provider_id строка Идентификатор профиля поставщика.
provider_name строка Имя профиля поставщика.
listing_id строка Идентификатор описания.
listing_name строка Имя перечисления.
consumer_delta_sharing_recipient_name строка Базовое имя получателя разностного общего доступа для потребителя. Значение имеет значение null , если event_type REQUEST_DATA.
consumer_delta_sharing_recipient_type строка Указывает, находится ли потребитель в учетной записи Azure Databricks или нет. Значения будут либо OPENDATABRICKS.
consumer_cloud строка Облако потребителя. Значение NULL, если consumer_delta_sharing_recipient_type имеет значение OPEN.
consumer_region строка Регион потребителя. Значение NULL, если consumer_delta_sharing_recipient_type имеет значение OPEN.
consumer_metastore_id строка Идентификатор хранилища метаданных потребителя. Значение NULL, если consumer_delta_sharing_recipient_type имеет значение OPEN.
consumer_email строка Адрес электронной почты потребителя. PII.
consumer_name строка Имя потребителя. PII.
consumer_company строка Компания потребителя.
consumer_intended_use строка Целевое использование списка потребителем.
consumer_comments строка Любой дополнительный комментарий слева от потребителя.
event_type строка Тип доступа. Возможные значения: REQUEST_DATA и GET_DATA.
event_date Дата Дата события в формате UTC.
event_time TIMESTAMP Точную метку времени UTC, когда произошло событие.

Перечисление таблицы событий воронки

В listing_funnel_events таблице анализируются впечатления и действия, выполненные в списках. В этой event_type статье рассказывается, какие действия потребитель взял на себя в вашем списке.

system.marketplace.listing_funnel_events имеет следующую схему:

Имя столбца Тип данных Description
account_id строка Идентификатор учетной записи, на котором размещено описание.
metastore_id строка Идентификатор метатора, на котором размещается список.
metastore_cloud строка Поставщик облачных хранилищ метаданных, на котором размещается список.
metastore_region строка Регион хранилища метаданных, на котором размещается список.
provider_id строка Идентификатор профиля поставщика.
provider_name строка Имя профиля поставщика.
listing_id строка Идентификатор описания.
listing_name строка Имя перечисления.
event_type строка Тип действия потребителя. См . типы событий.
event_time TIMESTAMP Точную метку времени UTC, когда произошло событие.
event_date Дата Дата события в формате UTC.
consumer_cloud строка Облако потребителя. Значение NULL, если consumer_delta_sharing_recipient_type имеет значение OPEN.
consumer_region строка Регион потребителя. Значение NULL, если consumer_delta_sharing_recipient_type имеет значение OPEN.

Типы событий

Возможные значения для столбца event_type:

  • 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

Известные ограничения

  • По состоянию на 12 марта 2024 года системные таблицы Marketplace включают действия потребителей с помощью Databricks в Google Cloud. Таблицы не включают действия потребителей Google Cloud до этой даты.
  • listing_funnel_events В таблице типы ABANDON_FAIL_DATA событий и FAIL_GET_DATA не были записаны до 30 ноября 2023 года.

Примеры запросов

Этот раздел содержит следующие примеры запросов, которые можно использовать для получения сведений о активности потребителей в списках.

Запросы потребителей за последние 10 дней

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)

Основные списки по количеству запросов

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

Просмотр верхних запрашивающих запросов

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

Просмотр количества попыток каждого действия потребителя в списке

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

Демонстрация записной книжки: анализ системных таблиц Marketplace

Следующая записная книжка содержит примеры запросов из этой статьи вместе с дополнительными ячейками, которые обеспечивают дальнейший анализ.

Демонстрация системной таблицы Marketplace

Получить записную книжку