BigQuery'de Drive envanteri dışa aktarma işlemleri için şema ve örnek sorgular

Bu özelliğin desteklendiği sürümler: Frontline Plus, Enterprise Standard ve Enterprise Plus, Education Standard ve Education Plus, Enterprise Essentials Plus, Cloud Identity Premium. Sürümünüzü karşılaştırın

Drive envanterini dışa aktarma işlemlerini ayarladıktan sonra BigQuery'de veri kümesini analiz edebilirsiniz. Bu sayfada, BigQuery'den alabileceğiniz genel raporlar için tablo şeması ve örnek sorgular açıklanmaktadır.

Not: Drive envanterinizi BigQuery'ye aktarmak ve sorgulamak ücretli olduğundan Google Cloud projeniz için faturalandırma ayarlarını yapmanız gerekir. Proje için faturalandırmayı etkinleştirin.

Drive envanterini dışa aktarma şeması

Şema ve tanımlar

Drive envanter dışa aktarımı, aşağıdaki şema ile BigQuery veri kümesine eklenir:

Ad Şema alanı Açıklama
Öğe Kimliği id Öğenin benzersiz Drive öğesi tanımlayıcısı.
Sürüm version Dosyanın en yeni sürüm numarası. Dosya sürümü tekdüze şekilde artan bir sayıdır. Bu, kullanıcı tarafından görülemeyenler dahil olmak üzere sunucudaki dosyada yapılan her değişikliği yansıtır.
Sahip Kimliği owner.user.id

Kullanıcıya ait öğeler için dosya sahibinin kullanıcı kimliği.

Sahibin e-posta adresi owner.user.email Kullanıcıya ait öğeler için dosya sahibinin e-posta adresi.
Ortak Drive kimliği owner.shared_drive.id Ortak Drive'daki öğeler için ortak Drive kimliği.
İçerik üretici creator Öğeyi oluşturan kişinin e-posta adresi ve kullanıcı kimliği. İçerik üreticinin öğeye artık erişimi yoksa bu alan doldurulmaz.
Anlık görüntü zaman damgaları snapshot_start_time_micros ve snapshot_end_time_micros Rapor oluşturma işleminin başladığı ve bittiği zaman damgaları.
Okuma Süresi read_time_micros Drive öğesi meta verilerinin okunduğu zamanı gösteren zaman damgası.
Başlık title

Kullanıcı tarafından belirtilen dosya başlığı.

Açıklama description Öğenin kısa bir açıklaması.
Çöp kutusuna taşınma durumu trashed Öğenin çöp kutusuna taşınıp taşınmadığı ve henüz tamamen silinip silinmediği.
MIME türü mime_type Öğenin MIME türü. Google Workspace ve Google Drive'ın desteklenen MIME türlerini inceleyin.
Dosya uzantısı file_extension Tam dosya uzantısının ad alanından çıkarılan son bileşeni. Bu özellik yalnızca Google Drive'da ikili program içeriğine sahip öğeler için kullanılabilir.
Oluşturulma Zamanı create_time_micros Öğenin oluşturulduğu zamanı gösteren zaman damgası.
Son Değiştirilme Saati last_modified_time_micros Öğenin herhangi bir kullanıcı tarafından en son değiştirildiği anın zaman damgası.
Dosya Boyutu file_size_bytes Blob ve Dokümanlar'daki düzenleyici dosyalarının bayt cinsinden boyutu. Kısayollar ve klasörler gibi boyutu olmayan öğeler için raporlanmaz.
Kullanılan kota consumed_quota_bytes Öğenin kullandığı bayt cinsinden depolama alanı kotası. Buna, ana düzeltmenin yanı sıra korunmuş olan önceki düzeltmeler de dahildir.
Ortak Drive kimliği shared_drive_id Ortak Drive'daki öğeler için ortak Drive kimliği.
Kuruluş Birimi org_unit_path Öğenin sahibinin kuruluş birimi.
Denetim Toplamı md5_checksum Öğenin içeriği için MD5 sağlama toplamı.
İstemci Tarafı Şifreleme client_side_encrypted Öğenin istemci tarafında şifrelenmiş olup olmadığını belirten bir boole değeri .
Üst klasör parent Öğenin üst klasörünün kimliği.
Uygulanan etiketler* applied_labels.id Öğeye uygulanan etiketin kimliği.
applied_labels.title Öğeye uygulanan etiketin kaynak adı.
applied_labels.field_values.id

Bir alanın; bir etiket veya kitaplık içinde benzersiz olan kimliği.

applied_labels.field_values.type

Alanın türü. Aşağıdakilerden biri olabilir:

applied_labels.field_values.display_name

Kullanıcı arayüzünde gösterilen, alanı tanımlayan metin.
Kısayol Hedef Kimliği shortcut_target_id Bu kısayolun işaret ettiği dosyanın veya klasörün kimliği.
İzinler access.permissions.permission_id

Bu iznin kimliği. Bu, izni verene ait benzersiz bir tanımlayıcıdır.

Not: İzin kimliği, kullanıcı kimliğiyle aynı değildir.

access.permissions.name

İzin değerinin "takma adı". Aşağıda, her izin türüne ilişkin örnek listesi verilmiştir:

  • user: Kullanıcının Google Hesabı için tanımlanan tam adı (ör. "Deniz Candan")
  • group: Grubun adı; ör. "Örnek Yöneticiler"
  • domain: "example.com" gibi dize alan adı
  • anyone: Ad bildirilmemiş
access.permissions.type

İznin türü. Geçerli değerler şunlardır:

  • user
  • group
  • domain
  • anyone
access.permissions.role

Bu izinle verilen rol. Geçerli değerler şunlardır:

  • owner
  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader

Not: Türle ilgili ayrıntılar için roller ve izin bölümüne bakın.

access.permissions.view

İzin bir görünüme aitse değer published olur.

access.permissions.allow_file_discovery

İznin, dosyanın aranabilir olmasını sağlayıp sağlamadığı bilgisi. Yalnızca domain veya anyone türündeki izinler için raporlanır.
access.permissions.email Bu iznin ait olduğu kullanıcı veya grubun e-posta adresi.
access.permissions.domain Bu iznin ait olduğu gerçek veya tüzel kişinin alan adı. İzin türü user, group veya domain olduğunda gösterilir.
access.permissions.user_id İzinlerdeki e-posta adresiyle ilişkilendirilen kullanıcı kimliği.
access.permissions.permission_details
.permission_type
Kullanıcının izin türü.
access.permissions.permission_details.role Kullanıcının birincil rolü.
access.permissions.permission_details
.inherited_from
Bu iznin devralındığı öğenin kimliği. Bu alan yalnızca ortak Drive'lardaki öğeler için doldurulur.
access.permissions.permission_details
.inherited
İznin devralınıp devralınmadığını belirten bir boole değeri.
access.permissions.inherited_permissions
_disabled
Bu öğe için devralınan izinlerin devre dışı bırakılıp bırakılmadığı. Yalnızca sınırlı erişim uygulanan klasörler için geçerlidir.

* Drive'daki öğelere uygulanan etiketler anlamına gelir.

Sorgu örnekleri

Bu sorgu örneklerinde, eski SQL'in bulunduğu varsayılır. project_name.dataset_name ifadesini kendi proje adınız ve veri kümesi adınızla değiştirin. BigQuery verilerini sorgulama hakkında daha fazla bilgi edinin.

project_name.dataset_name ifadesini kendi proje adınız ve veri kümesi adınızla değiştirin.

Dosya kimliği, başlık, sahibin e-postası ve türün bulunduğu bir tablo döndürür.

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
)

Belirli bir etikete sahip öğeleri bulma

project_name.dataset_name ifadesini kendi proje adınız ve veri kümesi adınızla değiştirin. label_id değerini etiket yöneticisinden alabileceğiniz etiket kimliğinizle değiştirin.

Bu sorgu; dosya kimliği, başlık, sahibin e-postası ve türü içeren bir tablo döndürür.

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
)

Belirli bir Drive depolama alanı kullanım eşiğini aşan kullanıcıları bulma

project_name.dataset_name ifadesini kendi proje adınız ve veri kümesi adınızla değiştirin. threshold değerini MB cinsinden eşiğinizle değiştirin. Örneğin, 15 GB'tan fazla Drive depolama alanı kullanan kullanıcıları bulmak için sondan ikinci satır HAVING total_storage_mb > 15000 olur.

Bu sorgu, tabloda kullanıcı e-postalarını ve toplam Drive depolama alanı kullanımını MB cinsinden azalan düzende döndürür.

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

En fazla alanı hangi öğe türlerinin kullandığını bulma

project_name.dataset_name ifadesini kendi proje adınız ve veri kümesi adınızla değiştirin.

Bu sorgu, öğe türlerini boyuta göre azalan düzende bir tabloda döndürür.

SELECT mime_type, SUM(consumed_quota_bytes) AS total_consumed
FROM project_name.dataset_name
GROUP BY mime_type
ORDER BY total_consumed DESC

İstemci tarafı şifreleme (İTŞ) ile şifrelenmiş öğeleri bulma

project_name.dataset_name ifadesini kendi proje adınız ve veri kümesi adınızla değiştirin.

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

Belirli bir kullanıcıyla paylaşılan öğeleri bulma

project_name.dataset_name ifadesini kendi proje adınız ve veri kümesi adınızla değiştirin. user@example.com adresini belirli kullanıcınızla değiştirin.

Not: Bu sorgu, kullanıcının gruplar veya hedef kitle üyeliği üzerinden yaptığı paylaşımları bulmaz.

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
)