サポート対象エディション: Enterprise Standard、Enterprise Plus、Education Standard、Education Plus、Enterprise Essentials Plus、Cloud Identity Premium。エディションの比較
ドライブのインベントリのエクスポートを設定したら、BigQuery でデータセットを分析できます。このページでは、BigQuery から取得できる一般的なレポートのテーブル スキーマとクエリ例について説明します。
注: BigQuery でドライブのインベントリをエクスポートしてクエリするには費用がかかるため、Google Cloud プロジェクトの課金を設定する必要があります。プロジェクトの課金を有効にする
ドライブのインベントリのエクスポート スキーマ
スキーマと定義
ドライブ インベントリのエクスポートは、次のスキーマで BigQuery データセットに追加されます。
名前 | スキーマ フィールド | 説明 |
---|---|---|
アイテム ID | id |
アイテムの固有の Google ドライブ アイテム ID |
バージョン | version |
ファイルの最新バージョン番号。ファイル バージョンの数値は単調に増加します。ユーザーには表示されない変更も含め、サーバー上のファイルに加えられたすべての変更が反映されます。 |
オーナー ID | owner.user.id |
ユーザーが所有するアイテムの場合は、ファイルのオーナーのユーザー ID。 |
オーナーのメールアドレス | owner.user.email |
ユーザーが所有するアイテムの場合は、ファイルのオーナーのメールアドレス。 |
共有ドライブ ID | owner.shared_drive.id |
共有ドライブ内のアイテムの場合は、共有ドライブ ID。 |
作成者 | creator |
アイテムの作成者のメールアドレスとユーザー ID。クリエイターがアイテムにアクセスできなくなった場合、このフィールドには値が入力されません。 |
スナップショットのタイムスタンプ | snapshot_start_time_micros と snapshot_start_time_micros |
レポート生成の開始時刻と終了時刻のタイムスタンプ。 |
タイトル | title |
ユーザーが指定したファイルのタイトル。 |
説明 | description |
アイテムの短い説明。 |
ゴミ箱のステータス | trashed |
アイテムがゴミ箱に移動されているがまだ削除されていないかどうか |
MIME タイプ | mime_type |
アイテムの MIME タイプ。Google Workspace と Google ドライブのサポートされている MIME タイプをご覧ください。 |
ファイル拡張子 | file_extension |
完全なファイル拡張子の最後のコンポーネント。名前フィールドから抽出されます。これは、Google ドライブ内のバイナリ コンテンツを含むアイテムでのみ使用できます。 |
作成時間 | create_time_micros |
アイテムが作成されたときのタイムスタンプ |
最終更新時刻 | last_modified_time_micros |
アイテムが最後に変更された時刻のタイムスタンプ |
ファイル サイズ | file_size_bytes |
blob とドキュメント エディタ ファイルのサイズ(バイト単位)。ショートカットやフォルダなど、サイズのないアイテムについては報告されません。 |
消費した割り当て | consumed_quota_bytes |
アイテムによって使用された保存容量のバイト数。これには、HEAD リビジョンと保持された以前のリビジョンが含まれます。 |
共有ドライブ ID | shared_drive_id |
共有ドライブ内のアイテムの場合は、共有ドライブ ID。 |
組織部門 | org_unit_path |
アイテムのオーナーの組織部門。 |
適用されたラベル* | applied_labels.id |
アイテムに適用されるラベルの ID |
applied_labels.title |
アイテムに適用されるラベルのリソース名 | |
applied_labels.field_values.id |
ラベルまたはライブラリ内で一意のフィールド ID。 |
|
|
フィールドのタイプ。次のいずれか 1 つを指定できます。 |
|
|
UI に表示する、フィールドを識別するテキスト | |
権限 | access.permissions.permission_id |
この権限の ID。これは、権限を付与されたユーザー向けの固有の識別子です。 注: 権限 ID はユーザー ID と同じではありません。 |
access.permissions.name |
権限の値の「略式の」名前。各タイプの権限の例を以下に示します。
|
|
access.permissions.type |
権限のタイプ。以下のような値を指定できます。
|
|
access.permissions.role |
この権限によって付与されるロール。以下のような値を指定できます。
注: タイプの詳細については、ロールと権限をご覧ください。 |
|
access.permissions.view |
権限がビューに属する場合、値は |
|
|
ファイルの検索を許可するかどうかを決める権限。domain または anyone のタイプの権限についてのみ報告されます。 |
|
access.permissions.email |
この権限が参照するユーザーまたはグループのメールアドレス | |
access.permissions.domain |
この権限が参照するエンティティのドメイン名。権限の種類が user 、group 、domain のいずれかである場合に表示されます。 |
|
access.permissions.user_id |
権限のメールアドレスに関連付けられているユーザー ID |
* ドライブのアイテムに適用されたラベルを指します。
クエリの例
こうしたクエリでは、レガシー SQL が使用されます。project_name.dataset_name の部分を、実際のプロジェクト名とデータセット名に置き換えてください。詳しくは、BigQuery データのクエリの概要をご覧ください。
ドライブ検索で表示可能なアイテムを探すproject_name.dataset_name は、プロジェクト名とデータセット名に置き換えてください。
ファイル ID、タイトル、オーナーのメールアドレス、タイプを含むテーブルを返します。
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 は、ラベル マネージャーで確認できるラベル ID に置き換えます。
このクエリは、ファイル ID、タイトル、オーナーのメールアドレス、タイプを含むテーブルを返します。
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 は、プロジェクト名とデータセット名に置き換えてください。[しきい値] は、MB 単位のしきい値に置き換えます。たとえば、ドライブ ストレージの使用量が 15 GB を超えるユーザーを検索するには、最後から 2 番目の行を HAVING total_storage_mb > 15000
にします。
このクエリは、ユーザーのメールアドレスとドライブ ストレージの合計使用量(MB)を降順で返します。
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]
)