پرس‌وجوهای طرحواره و نمونه برای صادرات موجودی درایو در BigQuery

نسخه‌های پشتیبانی‌شده برای این ویژگی: Frontline Plus؛ Enterprise Standard و Enterprise Plus؛ Education Standard و Education Plus؛ Enterprise Essentials Plus؛ Cloud Identity Premium. نسخه خود را مقایسه کنید

پس از تنظیم صادرات موجودی درایو ، می‌توانید مجموعه داده‌ها را در BigQuery تجزیه و تحلیل کنید. این صفحه طرح جدول و نمونه‌هایی از پرس‌وجوها را برای گزارش‌های رایجی که می‌توانید از BigQuery دریافت کنید، شرح می‌دهد.

توجه: شما باید برای پروژه Google Cloud خود صورتحساب تنظیم کنید زیرا صادر کردن و جستجوی موجودی Drive شما در 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_type نوع MIME مورد. به انواع MIME پشتیبانی‌شده توسط Google Workspace و Google Drive مراجعه کنید.
پسوند فایل file_extension جزء نهایی پسوند کامل فایل، که از فیلد نام استخراج می‌شود. این فقط برای مواردی با محتوای دودویی در گوگل درایو در دسترس است.
زمان ایجاد create_time_micros مهر زمانی که آیتم ایجاد شده است.
آخرین زمان تغییر last_modified_time_micros مهر زمانی آخرین باری که آیتم توسط کسی تغییر داده شده است.
حجم فایل file_size_bytes اندازه‌ی بایت‌های فایل‌های blobs و Docs Editors. برای مواردی که اندازه‌ای ندارند، مانند میانبرها و پوشه‌ها، گزارش نشده است.
سهمیه مصرفی consumed_quota_bytes تعداد بایت‌های سهمیه ذخیره‌سازی مورد استفاده توسط آیتم. این شامل ویرایش اصلی و همچنین ویرایش‌های قبلی که نگه داشته شده‌اند، می‌شود.
شناسه درایو مشترک shared_drive_id برای موارد موجود در یک درایو مشترک، شناسه درایو مشترک.
واحد سازمانی org_unit_path واحد سازمانی مالک کالا.
چک سام md5_checksum مجموع بررسی MD5 برای محتوای آیتم.
رمزگذاری سمت کلاینت client_side_encrypted یک مقدار بولی که نشان می‌دهد آیا آیتم سمت کلاینت رمزگذاری شده است یا خیر.
پوشه والد parent شناسه‌ی پوشه‌ی والد برای آیتم.
برچسب‌های کاربردی* 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

نام "زیبا"ی مقدار مجوز. در زیر لیستی از مثال‌ها برای هر نوع مجوز آمده است:

  • user - نام کامل کاربر، همانطور که برای حساب گوگل او تعریف شده است، مانند "دانا کروز"
  • 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
اینکه آیا مجوزهای ارثی برای این مورد غیرفعال هستند یا خیر. فقط برای پوشه‌هایی با دسترسی محدود صادق است.

* به برچسب‌های اعمال‌شده روی موارد در Drive اشاره دارد.

نمونه‌های پرس‌وجو

این مثال‌های پرس‌وجو، SQL قدیمی را در نظر می‌گیرند. نام پروژه و نام مجموعه داده خود را جایگزین project_name.dataset_name کنید. درباره پرس‌وجو از داده‌های 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
)

یافتن کاربرانی که از فضای ذخیره‌سازی درایو خود بیشتر استفاده می‌کنند

به جای project_name.dataset_name نام پروژه و نام مجموعه داده خود را قرار دهید. به جای threshold ، آستانه خود را بر حسب مگابایت قرار دهید. برای مثال، برای یافتن کاربرانی که بیش از ۱۵ گیگابایت از فضای ذخیره‌سازی درایو استفاده می‌کنند، خط یکی مانده به آخر HAVING total_storage_mb > 15000 است.

این پرس و جو جدولی از ایمیل کاربر و کل فضای ذخیره‌سازی درایو را به صورت نزولی و بر حسب مگابایت برمی‌گرداند.

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
)