สคีมาและการค้นหาตัวอย่างสำหรับการส่งออกข้อมูลเมตาในไดรฟ์ใน BigQuery

รุ่นที่รองรับฟีเจอร์นี้ ได้แก่ Frontline Plus, Enterprise Standard และ Enterprise Plus, Education Standard และ Education Plus, Enterprise Essentials Plus, Cloud Identity Premium เปรียบเทียบรุ่นของคุณ

หลังจากตั้งค่าการส่งออกข้อมูลเมตาในไดรฟ์แล้ว คุณจะวิเคราะห์ชุดข้อมูลใน BigQuery ได้ หน้านี้อธิบายสคีมาตารางและการค้นหาตัวอย่างสำหรับรายงานทั่วไปที่ได้รับจาก BigQuery

หมายเหตุ: คุณต้องตั้งค่าการเรียกเก็บเงินสำหรับโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google เนื่องจากจะมีค่าใช้จ่ายการส่งออกและการค้นหาข้อมูลเมตาในไดรฟ์ใน BigQuery เปิดใช้การเรียกเก็บเงินให้กับโปรเจ็กต์

สคีมาการส่งออกข้อมูลเมตาในไดรฟ์

สคีมาการส่งออกข้อมูลเมตาในไดรฟ์

การส่งออกคลังข้อมูลเมตาในไดรฟ์จะเพิ่มไปยังชุดข้อมูล BigQuery โดยมีสคีมาต่อไปนี้

สคีมาและคำจำกัดความ
ชื่อ ฟิลด์สคีมา คำอธิบาย
รหัสรายการ id ตัวระบุรายการในไดรฟ์ที่ไม่ซ้ำกัน
เวอร์ชัน version หมายเลขเวอร์ชันล่าสุดของไฟล์ ซึ่งเวอร์ชันไฟล์มีจำนวนเพิ่มขึ้นเรื่อยๆ โดยจะเป็นการแสดงการเปลี่ยนแปลงทั้งหมดที่ทำกับไฟล์ในเซิร์ฟเวอร์ แม้ว่าผู้ใช้จะมองไม่เห็นก็ตาม
เจ้าของ

owner.user.id

รหัสผู้ใช้ของเจ้าของไฟล์ สำหรับรายการที่ผู้ใช้เป็นเจ้าของ

owner.user.email

อีเมลของเจ้าของไฟล์ สำหรับรายการที่ผู้ใช้เป็นเจ้าของ

owner.shared_drive.id

รหัสไดรฟ์ที่แชร์ สำหรับรายการในไดรฟ์ที่แชร์

ผู้สร้าง creator อีเมลและรหัสผู้ใช้ของผู้สร้างรายการ ฟิลด์นี้จะไม่มีการป้อนข้อมูลหากผู้สร้างไม่สามารถเข้าถึงรายการได้อีกต่อไป
การประทับเวลาของการสร้าง snapshot_start_time_micros และ snapshot_end_time_micros การประทับเวลาที่เริ่มต้นและสิ้นสุดการสร้างรายงาน
เวลาในการอ่าน read_time_micros การประทับเวลาของเวลาที่อ่านข้อมูลเมตาของรายการในไดรฟ์
ชื่อ title ชื่อไฟล์ที่ผู้ใช้ระบุ
คำอธิบาย description คำอธิบายสั้นๆ ของสินค้า
สถานะอยู่ในถังขยะ trashed ย้ายรายการไปที่ถังขยะแล้วแต่อาจยังไม่ได้ลบ
ประเภท MIME mime_type ประเภท MIME ของรายการ ดูประเภท MIME ที่รองรับของ Google Workspace และ Google ไดรฟ์
นามสกุลไฟล์ file_extension คอมโพเนนต์สุดท้ายของนามสกุลไฟล์แบบเต็ม ซึ่งดึงมาจากฟิลด์ชื่อ ข้อมูลนี้มีอยู่สำหรับรายการที่มีเนื้อหาไบนารีใน Google ไดรฟ์เท่านั้น
เวลาที่สร้าง create_time_micros การประทับเวลาของเวลาที่สร้างรายการ
เวลาที่แก้ไขล่าสุด last_modified_time_micros การประทับเวลาที่มีผู้แก้ไขรายการครั้งล่าสุด
ขนาด (ไบต์) size_bytes ขนาดในหน่วยไบต์ของไฟล์ BLOB และไฟล์เครื่องมือแก้ไขเอกสาร ระบบจะไม่รายงานข้อมูลนี้สำหรับรายการที่ไม่มีขนาด เช่น ทางลัดและโฟลเดอร์
โควต้าที่ใช้ไป consumed_quota_bytes จำนวนโควต้าพื้นที่เก็บข้อมูลที่ใช้ในหน่วยไบต์ของรายการ ซึ่งรวมถึงการแก้ไขหลักและการแก้ไขก่อนหน้านี้ที่เก็บไว้
หน่วยขององค์กร org_unit_path หน่วยขององค์กรของเจ้าของรายการ
การตรวจสอบข้อผิดพลาด md5_checksum การตรวจสอบข้อผิดพลาด MD5 สำหรับเนื้อหาของรายการ
การเข้ารหัสฝั่งไคลเอ็นต์ client_side_encrypted บูลีนซึ่งระบุว่ารายการมีการเข้ารหัสฝั่งไคลเอ็นต์หรือไม่
โฟลเดอร์ระดับบนสุด parent รหัสของโฟลเดอร์หลักสำหรับรายการ

ระบบจะไม่ป้อนข้อมูลโฟลเดอร์หลักในกรณีต่อไปนี้

  1. ไฟล์จะอยู่ในโฟลเดอร์ระดับบนสุดในไดรฟ์ของฉันของผู้ใช้
  2. โดเมนไม่ได้เป็นเจ้าของโฟลเดอร์หลัก
ป้ายกำกับที่ใช้* applied_labels.id รหัสของป้ายกำกับที่ใช้กับรายการ
applied_labels.title ชื่อทรัพยากรของป้ายกำกับที่ใช้กับรายการ
applied_labels.field_values.id

รหัสของฟิลด์ที่ไม่ซ้ำกันภายในป้ายกำกับหรือไลบรารี

applied_labels.field_values.type

ประเภทของฟิลด์ ซึ่งอาจมีสถานะใดสถานะหนึ่งดังต่อไปนี้

applied_labels.field_values.display_name

ข้อความที่จะแสดงใน UI ที่ระบุฟิลด์
รหัสเป้าหมายของทางลัด shortcut_target_id รหัสของไฟล์หรือโฟลเดอร์ที่ทางลัดนี้ชี้ไป
สิทธิ์ access.permissions.permission_id

รหัสของสิทธิ์นี้ ซึ่งเป็นตัวระบุที่ไม่ซ้ำกันสำหรับผู้รับสิทธิ์

หมายเหตุ: รหัสสิทธิ์ไม่ใช่รหัสเดียวกับรหัสผู้ใช้

access.permissions.name

ชื่อที่ "น่ารัก" ของค่าของสิทธิ์ โดยตัวอย่างสิทธิ์แต่ละประเภทมีดังนี้

  • user - ชื่อเต็มของผู้ใช้ตามที่กำหนดไว้สำหรับบัญชี Google เช่น "Dana Cruz"
  • 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 รหัสผู้ใช้ที่เชื่อมโยงกับอีเมลในสิทธิ์
access.permissions.permission_details
.permission_type
ประเภทสิทธิ์สำหรับผู้ใช้
access.permissions.permission_details.role บทบาทหลักของผู้ใช้
access.permissions.permission_details
.inherited_from
รหัสของรายการที่สิทธิ์นี้รับค่ามา ข้อมูลนี้จะป้อนสำหรับรายการในไดรฟ์ที่แชร์เท่านั้น
access.permissions.permission_details
.inherited
บูลีนที่ระบุว่าสิทธิ์นั้นได้รับค่ามาหรือไม่
access.permissions.inherited_permissions
_disabled
ไม่ว่าจะปิดใช้สิทธิ์ที่รับค่ามาสำหรับรายการนี้หรือไม่ ซึ่งใช้ได้กับโฟลเดอร์ที่มีการจำกัดการเข้าถึงเท่านั้น
เป็นสคีมาเทมเพลต is_template บูลีนซึ่งระบุว่ารายการเป็นเทมเพลตหรือไม่

* หมายถึงป้ายกำกับที่ใช้กับรายการในไดรฟ์

สคีมาไดรฟ์ที่แชร์

ตารางไดรฟ์ที่แชร์

ตารางนี้แสดงรายละเอียดสคีมาสำหรับช่องเฉพาะของไดรฟ์ที่แชร์ในการส่งออกข้อมูลเมตาในไดรฟ์

ชื่อ ฟิลด์สคีมา คำอธิบาย
รหัสไดรฟ์ที่แชร์ shared_drive_id ตัวระบุไดรฟ์ที่แชร์ที่ไม่ซ้ำกัน
ชื่อไดรฟ์ที่แชร์ name ชื่อของไดรฟ์ที่แชร์ตามที่ผู้ใช้ระบุ
เวลาในการอ่าน read_time_micros การประทับเวลาเมื่ออ่านข้อมูลเมตาของไดรฟ์ที่แชร์ในหน่วยไมโครวินาที

สคีมาการแชร์กับภายนอก

สคีมาและคำจำกัดความของการแชร์กับภายนอก

ระบบจะเพิ่มข้อมูลการแชร์ภายนอกไปยังชุดข้อมูล BigQuery (ชุดข้อมูลเดียวกับสคีมาการส่งออกข้อมูลเมตาในไดรฟ์) โดยมีสคีมาต่อไปนี้

ชื่อ ฟิลด์สคีมา คำอธิบาย
มีการแชร์กับภายนอก access.has_external_sharing แสดงว่ามีการแชร์ไฟล์กับผู้ใช้ภายนอกหรือบัญชีบริการหรือไม่ รวมถึงผู้ที่มีสิทธิ์เข้าถึงโดยอ้อมโดยใช้การเป็นสมาชิกกลุ่ม
  • ระบบจะตั้งค่าช่องนี้เป็น True หากไฟล์มีผู้ใช้ภายนอกที่แชร์ด้วย ซึ่งรวมถึงกรณีต่อไปนี้
    • ผู้ที่แชร์ด้วยทั้งหมดเป็นบัญชีบริการ
    • การควบคุมนโยบายอนุญาตให้เข้าถึง
    • ไฟล์จะเผยแพร่แบบสาธารณะ
    • ระบบจะแชร์ไฟล์กับทุกคน
  • ระบบจะตั้งค่าช่องเป็น False หากไม่ได้แชร์ไฟล์กับภายนอก หรือหากการควบคุมนโยบายบล็อกการเข้าถึงสำหรับผู้ใช้ภายนอกทั้งหมดที่แชร์ด้วย
มีการแชร์กับภายนอก (ไม่รวมบัญชีบริการ) access.has_external_sharing_excluding_service_accounts ระบุว่าไฟล์มีผู้ใช้ภายนอกองค์กรที่แชร์ด้วยอย่างน้อย 1 คนหรือไม่ ค่านี้จะตั้งเป็น False หากผู้ใช้ภายนอกทั้งหมดเป็นบัญชีบริการ
เผยแพร่ภายนอก access.is_published_externally ระบุว่ามีการเผยแพร่ไฟล์ภายนอกหรือไม่
แชร์กับทุกคน access.is_shared_with_everyone แสดงว่ามีการแชร์ไฟล์กับทุกคนหรือไม่
ผู้รับการแชร์ภายนอก

access.external_sharees.type

แสดงประเภทของผู้ใช้ภายนอกที่แชร์ด้วย รายการต่อไปนี้แสดงตัวอย่างสิทธิ์แต่ละประเภท

  • ผู้ใช้
  • GROUP
  • ไม่ได้ระบุ - บัญชีส่วนใหญ่ในหมวดหมู่นี้เป็นบัญชีที่ไม่มีการอ้างสิทธิ์

access.external_sharees.email

แสดงอีเมลของผู้รับการแชร์ภายนอก

access.external_sharees.is_service_account

ระบุว่าผู้ใช้ภายนอกที่แชร์ด้วยเป็นบัญชีบริการหรือไม่

access.external_sharees.access_blocked_by_policy_control

แสดงว่านโยบายบล็อกการเข้าถึงหรือไม่ (เช่น DLP หรือกฎการเชื่อถือ) หากเป็น True ระบบจะไม่รวมผู้รับการแชร์ไว้ในการคำนวณ has_external_sharing และ has_external_sharing_excluding_service_accounts

ข้อมูล DLP access.dlp_info.matching_dlp_rules แสดงรายการกฎ DLP ที่ตรงกันซึ่งใช้กับรายการนี้

ข้อควรพิจารณาด้านประสิทธิภาพ: การคำนวณช่องการแชร์ภายนอกอาจใช้เวลานานกว่าจะเสร็จสมบูรณ์หากคุณมีกลุ่มที่มีผู้ใช้ที่ซ้อนกันหลายคน ความล่าช้านี้อาจส่งผลต่อความใหม่ของข้อมูล (เช่น ในรายงานรายวัน)

ตัวอย่างการค้นหา

ตัวอย่างการค้นหาเหล่านี้จะถือว่าใช้ SQL เดิม ดูข้อมูลเพิ่มเติมเกี่ยวกับการค้นหาข้อมูล 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 ด้วยรหัสป้ายกำกับของคุณ ซึ่งสามารถดูได้ในเครื่องมือจัดการป้ายกำกับ

การค้นหานี้จะแสดงตารางที่มีรหัสไฟล์ ชื่อ อีเมลเจ้าของ และประเภท

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
)

ค้นหาผู้ใช้ที่ใช้พื้นที่เก็บข้อมูล Google ไดรฟ์เกินเกณฑ์

แทนที่ project_name.dataset_name ด้วยชื่อโปรเจ็กต์และชื่อชุดข้อมูลของคุณ แทนที่ threshold ด้วยเกณฑ์ของคุณในหน่วย MB เช่น หากต้องการค้นหาผู้ที่ใช้พื้นที่เก็บข้อมูล Google ไดรฟ์มากกว่า 15 GB บรรทัดก่อนสุดท้ายจะเป็น HAVING total_storage_mb > 15000

การค้นหานี้จะแสดงตารางอีเมลของผู้ใช้และพื้นที่เก็บข้อมูล Google ไดรฟ์ทั้งหมดที่ใช้ในหน่วย 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

ค้นหารายการที่เข้ารหัสด้วยการเข้ารหัสฝั่งไคลเอ็นต์ (CSE)

แทนที่ project_name.dataset_name ด้วยชื่อโปรเจ็กต์และชื่อชุดข้อมูลของคุณ

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

ค้นหารายการที่แชร์กับผู้ใช้ที่ต้องการ

แทนที่ project_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
)

ค้นหารายการด้วยชื่อไดรฟ์ที่แชร์

แทนที่ project_name.dataset_name ด้วยชื่อโปรเจ็กต์และชื่อชุดข้อมูลของคุณ

การค้นหานี้จะแสดงตารางที่มีชื่อรายการในไดรฟ์และชื่อไดรฟ์ที่แชร์

SELECT i.title, s.name
FROM project_name.dataset_name.inventory AS i
JOIN project_name.dataset_name.shared_drives AS s
ON i.owner.shared_drive.id = s.shared_drive_id;

ค้นหาจำนวนรายการในไดรฟ์ที่แชร์

แทนที่ project_name.dataset_name ด้วยชื่อโปรเจ็กต์และชื่อชุดข้อมูลของคุณ

การค้นหานี้จะแสดงตารางที่มีชื่อไดรฟ์ที่แชร์และจำนวนรายการ

SELECT  s.name as shared_drive, count(*) as item_count
FROM project_name.dataset_name.inventory AS i
JOIN project_name.dataset_name.shared_drives AS s
ON i.owner.shared_drive.id = s.shared_drive_id
GROUP BY shared_drive;