BigQuery 中雲端硬碟項目清單匯出作業的結構定義和查詢範例

支援這項功能的版本：Frontline Plus；Enterprise Standard 和 Enterprise Plus；Education Standard 和 Education Plus；Enterprise Essentials Plus；Cloud Identity 進階版。 版本比較

設定雲端硬碟項目清單匯出作業後，您就可以在 BigQuery 中分析資料集。本頁針對可從 BigQuery 取得的常見報告，說明資料表結構定義和查詢範例。

注意：您必須設定 Google Cloud 專案的帳單，因為在 BigQuery 中匯出雲端硬碟項目清單，以及查詢該清單都需要付費。啟用專案的帳單功能。

雲端硬碟項目清單匯出結構定義

結構定義和定義

雲端硬碟項目清單匯出資料會新增到 BigQuery 資料集，並採用下列結構定義：

名稱 結構定義欄位 說明
項目 ID id 檔案的專屬雲端硬碟項目 ID。
版本 version 檔案的最新版本編號。檔案版本的數字不斷增加。這會反映所有對伺服器上檔案所做的變更，包括使用者看不到的內容。
擁有者 ID owner.user.id

如果是使用者擁有的項目，指的是擁有者的使用者 ID。
擁有者電子郵件地址 owner.user.email 如果是使用者擁有的項目，指的是擁有者的電子郵件地址。
共用雲端硬碟 ID owner.shared_drive.id 共用雲端硬碟中項目的共用雲端硬碟 ID。
建立者 creator 項目建立者的電子郵件地址和使用者 ID。如果建立者已無法存取該項目，則系統不會填入這個欄位。
快照時間戳記 snapshot_start_time_micros和snapshot_end_time_micros 報表產生作業的開始和結束時間戳記。
讀取時間 read_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 項目使用的儲存空間配額位元組數，包括最新修訂版本及先前保留的修訂版本。
共用雲端硬碟 ID shared_drive_id 共用雲端硬碟中項目的共用雲端硬碟 ID。
機構單位 org_unit_path 項目擁有者的組織單位。
檢查碼 md5_checksum 項目內容的 MD5 核對和。
用戶端加密 client_side_encrypted 布林值，指出項目是否經過用戶端加密。
上層資料夾 parent 項目的上層資料夾 ID。
已套用的標籤* applied_labels.id 項目所套用標籤的 ID。
applied_labels.title 項目所套用標籤的資源名稱。
applied_labels.field_values.id

欄位的 ID，在標籤或資源庫中不得重複。

applied_labels.field_values.type

欄位類型，可以是下列任一值：

applied_labels.field_values.display_name

 在 UI 中顯示的文字，用於識別欄位。
捷徑目標 ID shortcut_target_id 捷徑所指向檔案或資料夾的 ID。
權限 access.permissions.permission_id

這項權限的 ID。此為授予對象的專屬 ID。

注意：權限 ID 與使用者 ID 不同。
access.permissions.name

權限值的「可識別」名稱。以下列出每種權限類型的範例：

  • user - 使用者在 Google 帳戶中定義的全名，例如「Dana Cruz」
  • group - 群組名稱，例如「Example Admins」
  • 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 與權限電子郵件地址相關聯的使用者 ID。
access.permissions.permission_details
.permission_type		 使用者的權限類型。
access.permissions.permission_details.role 使用者的主要角色。
access.permissions.permission_details
.inherited_from		 沿用這項權限的項目 ID。只有共用雲端硬碟中的項目會填入這項資料。
access.permissions.permission_details
.inherited		 布林值，指出權限是否為沿用。
access.permissions.inherited_permissions
_disabled		 該項目是否已停用沿用權限，僅適用於設有存取限制的資料夾。

* 請參閱「套用至雲端硬碟項目的標籤」。

查詢範例

這類查詢範例會假設您使用的是舊版 SQL。請將 project_name.dataset_nameproject_name.dataset_name 改成您的專案名稱和資料集名稱。進一步瞭解如何查詢 BigQuery 資料。

請將 project_name.dataset_nameproject_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_nameproject_name.dataset_name 改成您的專案名稱和資料集名稱。將 label_idlabel_id 替換為您的標籤 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_nameproject_name.dataset_name 改成您的專案名稱和資料集名稱。將 threshold 替換為以 MB 為單位的閥值。舉例來說，如要找出雲端硬碟儲存空間使用量超過 15 GB 的使用者，則倒數第二行應為 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_nameproject_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

尋找採用用戶端加密 (CSE) 的項目

請將 project_name.dataset_nameproject_name.dataset_name 改成您的專案名稱和資料集名稱。

SELECT id, owner.user.email, title
FROM project_name.dataset_name
WHERE mime_type LIKE '%.encrypted'

尋找與特定使用者共用的項目

請將 project_name.dataset_nameproject_name.dataset_name 改成您的專案名稱和資料集名稱。將 user@example.com 替換為特定使用者。

注意：這項查詢不會尋找使用者透過群組或目標對象群組成員分享的內容。

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 = user@example.com
)