الإصدارات المتوافقة مع هذه الميزة: Frontline Plus وEnterprise Standard وEnterprise Plus وEducation Standard وEducation Plus وEnterprise Essentials Plus والنسخة المدفوعة من Cloud Identity مقارنة إصدارك
يمكنك تحليل مجموعة البيانات في BigQuery بعد إعداد عمليات تصدير قائمة بالبيانات الوصفية في Drive. توضّح هذه الصفحة مخطّط الجدول ونماذج الطلبات للتقارير الشائعة التي يمكنك الحصول عليها من BigQuery.
ملاحظة: يجب إعداد الفوترة لمشروعك على Google Cloud حيث يترتب على تصدير مستودع Drive وإجراء طلبات بحث عنه في BigQuery تكلفة إضافية. تفعيل الفوترة لمشروع .
مخطّط تصدير مستودع Drive
مخطّط تصدير مستودع Drive
تُضاف عمليات تصدير مستودع Drive إلى مجموعة بيانات BigQuery باستخدام المخطط التالي:
المخطّطات والتعريفات| الاسم | حقل المخطط | الوصف |
|---|---|---|
| معرف العنصر | id |
المعرّف الفريد لعنصر في Drive |
| الإصدار | version |
رقم أحدث إصدار من الملف إصدار الملف هو رقم يتزايد بشكل منتظم، ويعكس هذا كل تغيير يتم إجراؤه على الملف على الخادم، حتى تلك التغييرات غير المرئية للمستخدم. |
| المالك |
|
بالنسبة إلى العناصر التي يملكها مستخدم، وهي رقم تعريف المستخدم الخاص بمالك الملف |
|
|
بالنسبة إلى العناصر التي يملكها مستخدم، وهي عنوان البريد الإلكتروني الخاص بمالك الملف |
|
|
|
بالنسبة إلى العناصر في مساحة تخزين سحابي مشتركة، فهو رقم تعريف مساحة التخزين السحابي المشتركة. |
|
| المُنشئ | 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 |
رقم تعريف المجلد الرئيسي للعنصر لن تتم تعبئة المجلد الرئيسي في الحالات التالية:
|
| التصنيفات المطبَّقة* | applied_labels.id |
رقم تعريف التصنيف المطبّق على العنصر |
applied_labels.title |
اسم مصدر التصنيف المطبّق على العنصر | |
applied_labels.field_values.id |
رقم تعريف أحد الحقول، ويكون فريدًا داخل التصنيف أو المكتبة. |
|
|
|
نوع الحقل. يمكن أن يكون أحد القيم التالية: |
|
|
|
النص المطلوب عرضه في واجهة المستخدم والذي يحدّد الحقل | |
| معرّف هدف الاختصار | shortcut_target_id |
تمثّل هذه السمة معرّف الملف أو المجلد الذي يشير إليه هذا الاختصار. |
| الأذونات | access.permissions.permission_id |
رقم تعريف هذا الإذن. هذا المعرّف هو معرّف فريد للمستفيد من المنحة. ملاحظة: يختلف رقم تعريف الإذن عن رقم تعريف المستخدم. |
access.permissions.name |
الاسم "pretty" (جميلة) الخاص بقيمة الإذن. في ما يلي قائمة أمثلة لكل نوع من الأذونات:
|
|
access.permissions.type |
نوع الإذن القيم الصالحة هي:
|
|
access.permissions.role |
الدور الذي يمنحه هذا الإذن القيم الصالحة هي:
ملاحظة: يُرجى الاطلاع على الأدوار والأذونات للحصول على تفاصيل حول النوع. |
|
access.permissions.view |
إذا كان الإذن ينتمي إلى عرض، تكون القيمة |
|
|
|
يوضح ما إذا كان الإذن يسمح بأن يكون الملف قابلاً للبحث أم لا. يُسجل تقرير عنه في حال وجود أذونات النوع domain أو anyone فقط. |
|
access.permissions.email |
عنوان البريد الإلكتروني الخاص بالمستخدم أو المجموعة التي يشير إليها هذا الإذن | |
access.permissions.domain |
اسم النطاق الخاص بالكيان الذي يشير إليه هذا الإذن يتوفّر ذلك عندما يكون نوع الإذن user أو group أو domain. |
|
access.permissions.user_id |
رقم تعريف المستخدم المرتبط بالبريد الإلكتروني في الأذونات | |
access.permissions.permission_details |
نوع إذن المستخدم | |
access.permissions.permission_details.role |
دور المستخدم الأساسي | |
access.permissions.permission_details |
معرّف العنصر الذي يتم اكتساب هذا الإذن منه. لا تتم تعبئة هذا الحقل إلا للعناصر في مساحات التخزين السحابي المشتركة. | |
access.permissions.permission_details |
قيمة منطقية تشير إلى ما إذا كان الإذن مكتسَبًا أم لا. | |
access.permissions.inherited_permissions |
تُستخدَم لتحديد ما إذا كانت أذونات الوصول المكتسَبة غير مفعَّلة لهذا العنصر. لا ينطبق ذلك إلا على المجلدات ذات إذن الوصول المحدود. | |
| هل هو مخطط نموذج؟ | is_template |
قيمة منطقية تشير إلى ما إذا كان العنصر نموذجًا أم لا. |
* يشير إلى التصنيفات المطبَّقة على العناصر في Drive.
مخطّط مساحات التخزين السحابي المشتركة
جدول مساحات التخزين السحابي المشتركة
يوضّح الجدول تفاصيل المخطّط للحقول الخاصة بمساحة التخزين السحابي المشتركة في عملية تصدير قائمة بالبيانات الوصفية في Drive.
| الاسم | حقل المخطط | الوصف |
|---|---|---|
| رقم تعريف مساحة التخزين السحابي المشتركة | shared_drive_id |
المعرّف الفريد لمساحة التخزين السحابي المشتركة |
| اسم مساحة التخزين السحابي المشتركة | name |
اسم مساحة التخزين السحابي المشتركة، كما حدّده المستخدم |
| وقت القراءة | read_time_micros |
الطابع الزمني لوقت قراءة البيانات الوصفية لمساحة التخزين السحابي المشتركة، بالميكرو ثانية |
مخطط المشاركة الخارجية
مخطّطات المشاركة الخارجية وتعريفاتها
تتم إضافة بيانات المشاركة الخارجية إلى مجموعة بيانات BigQuery (مجموعة البيانات نفسها مثل مخطط تصدير قائمة بالبيانات الوصفية في Drive) باستخدام المخطط التالي:
| الاسم | حقل المخطط | الوصف |
|---|---|---|
| تتضمّن مشاركة خارجية | access.has_external_sharing |
يعرض ما إذا تمت مشاركة الملف مع أي مستخدمين خارجيين أو حسابات خدمة، بما في ذلك المستخدمين الذين لديهم إذن وصول غير مباشر باستخدام عضوية المجموعة.
|
| تتضمّن مشاركة خارجية (باستثناء حسابات الخدمة) | access.has_external_sharing_excluding_service_accounts |
يشير هذا الحقل إلى ما إذا كان الملف يحتوي على مستخدم خارجي واحد على الأقل خارج المؤسسة. يتم ضبط هذه السياسة على False إذا كان جميع المشاركين الخارجيين حسابات خدمة. |
| منشور خارجيًا | access.is_published_externally |
تحدّد ما إذا كان الملف منشورًا خارجيًا. |
| تتم مشاركته مع جميع المستخدمين | access.is_shared_with_everyone |
يعرض ما إذا كان الملف مشتركًا مع الجميع. |
| المستخدمون الخارجيون الذين تمت مشاركة الملفات معهم |
|
تعرض نوع المشارِك الخارجي. تعرض القائمة التالية أمثلة لكل نوع من أنواع الأذونات:
|
|
|
تعرض هذه السمة عنوان البريد الإلكتروني للمستخدم الخارجي الذي تمت مشاركة الملف معه. |
|
|
|
يشير هذا العمود إلى ما إذا كان المستخدم الخارجي الذي تمت مشاركة الملف معه هو حساب خدمة. |
|
|
|
يعرض ما إذا كان الوصول محظورًا بموجب سياسة (على سبيل المثال، قواعد "منع فقدان البيانات" أو "قواعد الثقة"). إذا كانت القيمة صحيحة، يتم استبعاد المشارِك من عمليات احتساب |
|
| معلومات "منع فقدان البيانات" | access.dlp_info.matching_dlp_rules |
يعرض هذا الحقل قواعد "منع فقدان البيانات" المطابقة التي تم تطبيقها على هذا العنصر. |
اعتبارات الأداء: قد يستغرق احتساب حقول المشاركة الخارجية وقتًا أطول إذا كانت لديك مجموعات تضم عدة مستخدمين متداخلين. قد يؤثّر هذا التأخير في مدى حداثة بياناتك (على سبيل المثال، في التقارير اليومية).
أمثلة على طلبات البحث
تستند نماذج طلبات البحث هذه إلى لغة الاستعلامات البنيوية (SQL) القديمة. مزيد من المعلومات عن طلب البحث عن بيانات BigQuery
العثور على العناصر التي يسهل العثور عليها من خلال البحث في Drive
استبدل 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
العثور على العناصر المشفَّرة باستخدام ميزة "التشفير من جهة العميل" (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 باسم مشروعك واسم مجموعة البيانات.
يعرض هذا الطلب جدولاً يتضمّن عنوان عنصر 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;
العثور على عدد العناصر في مساحة Drive المشتركة
استبدل 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;