نسخههای پشتیبانیشده برای این ویژگی: 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 | شناسهی یک فیلد، منحصر به فرد در یک برچسب یا کتابخانه. | |
| نوع فیلد. میتواند یکی از موارد زیر باشد: | |
| متنی که در رابط کاربری نمایش داده میشود و فیلد را مشخص میکند. | |
| شناسه هدف میانبر | shortcut_target_id | شناسه فایل یا پوشهای که این میانبر به آن اشاره میکند. |
| مجوزها | access.permissions.permission_id | شناسه این مجوز. این یک شناسه منحصر به فرد برای دارنده مجوز است. نکته: شناسه مجوز با شناسه کاربر یکسان نیست. |
access.permissions.name | نام "زیبا"ی مقدار مجوز. در زیر لیستی از مثالها برای هر نوع مجوز آمده است:
| |
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 | اینکه آیا مجوزهای ارثی برای این مورد غیرفعال هستند یا خیر. فقط برای پوشههایی با دسترسی محدود صادق است. |
* به برچسبهای اعمالشده روی موارد در 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
)