مخطّط ونماذج طلبات عمليات تصدير مستودع Drive في BigQuery

الإصدارات المتوافقة مع هذه الميزة: Frontline Plus وEnterprise Standard وEnterprise Plus وEducation Standard وEducation Plus وEnterprise Essentials Plus والنسخة المدفوعة من Cloud Identity. مقارنة إصدارك

بعد إعداد عمليات تصدير قائمة بالبيانات الوصفية في Drive، يمكنك تحليل مجموعة البيانات في BigQuery. توضّح هذه الصفحة مخطّط الجدول ونماذج الطلبات للتقارير الشائعة التي يمكنك الحصول عليها من BigQuery.

ملاحظة: يجب إعداد الفوترة لمشروعك على Google Cloud حيث يترتب على تصدير قائمة بالبيانات الوصفية في Drive وإجراء طلبات بحث عنها في BigQuery تكلفة إضافية. تفعيل الفوترة لمشروع

مخطّط تصدير مستودع Drive

المخطّطات والتعريفات

تُضاف عمليات تصدير مستودع Drive إلى مجموعة بيانات BigQuery باستخدام المخطط التالي:

الاسم حقل المخطط الوصف
معرف العنصر id المعرّف الفريد لعنصر في Drive
الإصدار version رقم أحدث إصدار من الملف إصدار الملف هو رقم يتزايد بشكل منتظم، ويعكس هذا كل تغيير يتم إجراؤه على الملف على الخادم، حتى تلك التغييرات غير المرئية للمستخدم.

المالك

owner.user.id

بالنسبة إلى العناصر التي يملكها مستخدم، وهي رقم تعريف المستخدم الخاص بمالك الملف

owner.user.email

بالنسبة إلى العناصر التي يملكها مستخدم، وهي عنوان البريد الإلكتروني الخاص بمالك الملف

owner.shared_drive.id

بالنسبة إلى العناصر في مساحة تخزين سحابي مشتركة، فهو رقم تعريف مساحة التخزين السحابي المشتركة.
المُنشئ creator البريد الإلكتروني ورقم تعريف المستخدم الذي أنشأ العنصر. لا تتم تعبئة هذا الحقل إذا لم يعد بإمكان صانع المحتوى الوصول إلى العنصر.
الطوابع الزمنية للقطات snapshot_start_time_micros وsnapshot_end_time_micros الطوابع الزمنية لوقت بدء إنشاء التقرير وانتهائه
وقت القراءة read_time_micros الطابع الزمني لوقت قراءة البيانات الوصفية لعنصر Drive
العنوان title

عنوان الملف الذي حدّده المستخدم
الوصف description وصف موجز للعنصر
حالة النقل إلى المهملات trashed يحدد ما إذا كان قد تم نقل العنصر إلى المهملات ولكن لم يتم حذفه بعد.
نوع MIME mime_type نوع MIME الخاص بالعنصر. يُرجى الاطّلاع على أنواع MIME المتوافقة في Google Workspace وGoogle Drive.
امتداد الملف file_extension المكون الأخير لامتداد الملف الكامل، الذي يتم استخراجه من حقل الاسم. لا يتوفّر هذا الخيار إلا للعناصر ذات المحتوى الثنائي في Google Drive.
وقت الإنشاء create_time_micros الطابع الزمني لوقت إنشاء العنصر
وقت آخر تعديل last_modified_time_micros الطابع الزمني لآخر مرة عدَّل فيها أي مستخدم العنصر
حجم البايت size_bytes الحجم بالبايت لملفات "الملفات الثنائية الكبيرة" و"أدوات تحرير المستندات" لا يتم تسجيل هذه البيانات للعناصر التي ليس لها حجم، مثل الاختصارات والمجلدات.
الحصة المستهلكة 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

 النص المطلوب عرضه في واجهة المستخدم والذي يحدّد الحقل
معرّف هدف الاختصار shortcut_target_id تمثّل هذه السمة معرّف الملف أو المجلد الذي يشير إليه هذا الاختصار.
الأذونات access.permissions.permission_id

رقم تعريف هذا الإذن. هذا المعرّف هو معرّف فريد للمستفيد من المنحة.

ملاحظة: يختلف رقم تعريف الإذن عن رقم تعريف المستخدم.
access.permissions.name

الاسم "pretty" (جميلة) الخاص بقيمة الإذن. في ما يلي قائمة أمثلة لكل نوع من الأذونات:

  • user - الاسم الكامل للمستخدم، كما هو محدّد في حسابه على Google، مثل "Dana Hamed"
  • group - اسم المجموعة، مثل "مشرفين تمثيليين"
  • domain - اسم نطاق السلسلة، مثل "example.com"
  • anyone - No name reported
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		 تُستخدَم لتحديد ما إذا كانت أذونات الوصول المكتسَبة غير مفعَّلة لهذا العنصر. لا ينطبق ذلك إلا على المجلدات ذات إذن الوصول المحدود.

* يشير إلى التصنيفات المطبَّقة على العناصر في Drive.

مخطط مساحات التخزين السحابي المشتركة

جدول مساحات التخزين السحابي المشتركة

يقدّم الجدول تفاصيل حول مخطّط الحقول الخاصة بمساحة التخزين السحابي المشتركة في عملية تصدير قائمة بالبيانات الوصفية في Drive.

الاسم حقل المخطط الوصف
رقم تعريف مساحة التخزين السحابي المشتركة shared_drive_id المعرّف الفريد لمساحة التخزين السحابي المشتركة
اسم مساحة التخزين السحابي المشتركة name اسم مساحة التخزين السحابي المشتركة، كما حدّده المستخدم.
وقت القراءة read_time_micros الطابع الزمني لوقت قراءة البيانات الوصفية لمساحة التخزين السحابي المشتركة، بالميكرو ثانية

أمثلة على طلبات البحث

تستند نماذج طلبات البحث هذه إلى لغة الاستعلامات البنيوية (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
)

العثور على المستخدمين الذين تجاوزوا الحدّ الأقصى من مساحة تخزين في Drive

استبدل project_name.dataset_name باسم مشروعك واسم مجموعة البيانات. استبدِل threshold بالحدّ الذي تريده بالميغابايت. على سبيل المثال، للعثور على المستخدمين الذين يستخدِمون أكثر من 15 غيغابايت من مساحة التخزين في Drive، يكون السطر قبل الأخير كالتالي HAVING total_storage_mb > 15000.

يعرض هذا الطلب جدولاً يتضمّن بريد المستخدم الإلكتروني وإجمالي استخدام مساحة التخزين في Drive بالميغابايت بترتيب تنازلي.

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 باسم مشروعك واسم مجموعة البيانات. استبدِل 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 باسم مشروعك واسم مجموعة البيانات.

يعرض هذا الطلب جدولاً يتضمّن عنوان عنصر Drive واسم مساحة التخزين السحابي المشتركة.

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;