Схема и примеры запросов для экспорта данных о ресурсах Диска в BigQuery

Эта функция доступна в версиях Enterprise Standard и Enterprise Plus, Education Standard и Education Plus, Enterprise Essentials Plus и Cloud Identity Premium. Сравнение версий

После экспорта данных о ресурсах Диска вы можете проанализировать их в BigQuery. На этой странице вы найдете схему таблицы и примеры запросов для создания отчетов в BigQuery.

Примечание. Для проекта Google Cloud нужно настроить платежные функции, поскольку за экспорт данных о ресурсах Диска в BigQuery взимается плата. Подробнее…

Схема экспорта данных о ресурсах Диска

Схема и определения

Схема данных о ресурсах Диска, которые добавляются в набор данных BigQuery, такова:

Название Поле схемы Описание
Идентификатор объекта id Уникальный идентификатор объекта на Диске.
Версия version Номер последней версии файла. Номер версии файла – это число, которое увеличивается от версии к версии. Оно отражает каждое изменение, внесенное в файл на сервере, даже когда эти изменения невидимы для пользователя.
Идентификатор владельца owner.user.id

Для объектов, которые принадлежат пользователю, – идентификатор пользователя файла.

Адрес электронной почты владельца owner.user.email Для объектов, которые принадлежат пользователю, – адрес электронной почты владельца файла.
Идентификатор общего диска owner.shared_drive.id Для объектов на общем диске – идентификатор общего диска.
Автор creator Адрес электронной почты и идентификатор пользователя, создавшего файл. Это поле не заполняется, если автор больше не имеет доступа к объекту.
Временные метки снимков snapshot_start_time_micros и snapshot_end_time_micros Временные метки начала и окончания создания отчета.
Название title

Заданное пользователем название файла.

Описание description Краткое описание объекта.
Статус перемещенного в корзину trashed Перемещен ли объект в корзину (но ещё не удален).
MIME-тип mime_type MIME-тип объекта. Ознакомьтесь с перечнем поддерживаемых MIME-типов для Google Workspace и Google Диска.
Расширение имени файла file_extension Последний компонент полного расширения имени файла, извлеченный из поля названия. Он доступен только для объектов с двоичным контентом на Google Диске.
Время создания create_time_micros Временная метка, указывающая, когда создан файл.
Время последнего изменения last_modified_time_micros Временная метка, указывающая, когда файл в последний раз был кем-либо изменен.
Размер файла file_size_bytes Размер в байтах файлов BLOB и редакторов Документов. Не указывается для объектов, не имеющих размера, таких как ярлыки и папки.
Израсходованная квота consumed_quota_bytes Количество байт квоты на хранение, которые использованы объектом. Включает размер основной версии и сохраненных предыдущих версий.
Идентификатор общего диска shared_drive_id Для объектов на общем диске – идентификатор общего диска.
Организационное подразделение org_unit_path Организационное подразделение, к которому относится владелец объекта.
Назначенные ярлыки* applied_labels.id Идентификатор ярлыка, назначенного объекту.
applied_labels.title Название ресурса ярлыка, назначенного объекту.
applied_labels.field_values.id

Идентификатор поля, уникальный для ярлыка или библиотеки.

applied_labels.field_values.type

Тип поля. Может быть одним из следующих:

applied_labels.field_values.display_name

Текст, который отображается в интерфейсе и идентифицирует поле.
Разрешения access.permissions.permission_id

Идентификатор разрешения. Это уникальный идентификатор получателя разрешения.

Примечание. Идентификатор разрешения – не то же самое, что идентификатор пользователя.

access.permissions.name

Понятное название для значения разрешения. Вот примеры для каждого типа разрешения:

  • user – полное имя пользователя, указанное в аккаунте Google, например "Ирина Иванова"
  • group – название группы, например "Администраторы"
  • domain – строка доменного имени, например "example.com"
  • anyone – имя не указано
access.permissions.type

Тип разрешения. Допустимые значения:

  • user
  • group
  • domain
  • anyone
access.permissions.role

Роль, назначаемая разрешением. Допустимые значения:

  • owner
  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader

Примечание. Подробнее об этом типе рассказывается в статье Роли и разрешения.

access.permissions.view

Если разрешение относится к просмотру, значением является published.

access.permissions.allow_file_discovery

Допускается ли разрешением поиск этого файла. Указывается только для разрешений типа domain или anyone.
access.permissions.email Адрес электронной почты пользователя или группы, к которым относится это разрешение.
access.permissions.domain Доменное имя лица, к которому относится это разрешение Присутствует, когда типом разрешения является user, group или domain.
access.permissions.user_id Идентификатор пользователя, связанный с адресом электронной почты в разрешении.

* Относится к ярлыкам, назначенным объектам на Диске.

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

В примерах используется прежняя версия SQL. Замените project_name.dataset_name названиями своего проекта и набора данных. Подробнее об извлечении данных BigQuery

Развернуть все  |  Свернуть все

Как получить список файлов, которые можно найти с помощью поиска на Диске

Замените project_name.dataset_name названиями своего проекта и набора данных.

Вы получите таблицу со следующими столбцами: идентификатор файла, название, адрес электронной почты владельца и тип.

SELECT id, title, mime_type, owner.user.email
FROM project_name.dataset_name
WHERE EXISTS (
  SELECT 1
  FROM UNNEST(access.permissions) AS permission
  WHERE permission.allow_file_discovery = true
)
Как найти объекты с определенным ярлыком

Замените project_name.dataset_name названиями своего проекта и набора данных. Замените label_id идентификатором ярлыка, который можно узнать в Label Manager.

Результатом этого запроса будет таблица со следующими столбцами: идентификатор файла, название, адрес электронной почты владельца и тип.

SELECT id, title, mime_type, owner.user.email
FROM project_name.dataset_name
WHERE EXISTS (
  SELECT 1
  FROM UNNEST(applied_labels) AS label
  WHERE label.id = label_id
)
Как найти пользователей, превышающих пороговое значение занимаемого пространства на Диске

Замените project_name.dataset_name названиями своего проекта и набора данных. Замените threshold пороговым значением в МБ. Например, чтобы найти пользователей, у которых занято более 15 ГБ пространства на Диске, вторая с конца строка должна быть следующей: HAVING total_storage_mb > 15000.

Результатом этого запроса будет таблица со списком пользователей, отсортированным по занятому их данными пространству на Диске в МБ от большего к меньшему.

SELECT owner.user.email AS user_email,
  SUM(size_bytes) / (1000000) AS total_storage_mb
FROM project_name.dataset_name
GROUP BY user_email
HAVING total_storage_mb > threshold
ORDER BY total_storage_mb DESC
Как узнать, какие типы объектов занимают больше всего пространства на Диске

Замените project_name.dataset_name названиями своего проекта и набора данных.

Результатом этого запроса будет таблица со списком типов объектов, отсортированным от большего занимаемого пространства на Диске к меньшему.

SELECT mime_type, SUM(consumed_quota_bytes) AS total_consumed
FROM project_name.dataset_name
GROUP BY mime_type
ORDER BY total_consumed DESC
Как найти зашифрованные на стороне клиента объекты

Замените project_name.dataset_name названиями своего проекта и набора данных.

SELECT id, owner.user.email, title
FROM project_name.dataset_name
WHERE mime_type LIKE '%.encrypted'
Как найти объекты, к которым предоставлен доступ определенному пользователю

Замените project_name.dataset_name названиями своего проекта и набора данных. Замените [email protected] адресом электронной почты пользователя.

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

SELECT id, title, mime_type, owner.user.email as owner_email
FROM project_name.dataset_name
WHERE EXISTS (
  SELECT 1
  FROM UNNEST(access.permissions) AS permissions
  WHERE permissions.email = [email protected]
)

Статьи по теме

Эта информация оказалась полезной?

Как можно улучшить эту статью?
Поиск
Очистить поле поиска
Закрыть поиск
Приложения Google
Главное меню
14514319800449138458
true
Поиск по Справочному центру
true
true
true
true
true
73010
false
false