Schema und Beispielabfragen für Drive-Inventarexporte in BigQuery

Unterstützte Versionen für diese Funktion: Enterprise Standard und Enterprise Plus; Education Standard und Education Plus; Enterprise Essentials Plus; Cloud Identity Premiumversion. Versionen vergleichen

Nachdem Sie Drive-Inventarexporte eingerichtet haben, können Sie den Datensatz in BigQuery analysieren. Auf dieser Seite werden das Tabellenschema und Beispielabfragen für häufig verwendete Berichte beschrieben, die Sie in BigQuery abrufen können.

Hinweis: Sie müssen die Abrechnung für Ihr Google Cloud-Projekt einrichten, da der Export und die Abfrage Ihres Drive-Inventars in BigQuery kostenpflichtig ist. Abrechnung für ein Projekt aktivieren

Exportschema für Google Drive-Inventar

Schema und Definitionen

Der Export von Drive-Inventar wird dem BigQuery-Dataset mit dem folgenden Schema hinzugefügt:

Name	Schemafeld	Beschreibung
Artikel-ID	id	Die eindeutige Google Drive-Element-ID des Elements.
Version	Version	Die Versionsnummer der neuesten Version der Datei. Die Dateiversion ist eine monoton steigende Zahl. Dies spiegelt alle Änderungen wider, die an der Datei auf dem Server vorgenommen wurden, auch solche, die für den Nutzer nicht sichtbar sind.
Inhaber-ID	owner.user.id	Bei Elementen, die einem Nutzer gehören, die Nutzer-ID des Dateiinhabers.
E-Mail-Adresse des Eigentümers	owner.user.email	Bei Elementen, die einem Nutzer gehören, die E-Mail-Adresse des Dateieigentümers.
ID der geteilten Ablage	owner.shared_drive.id	Bei Elementen in einer geteilten Ablage die ID der geteilten Ablage.
Ersteller	creator	Die E-Mail-Adresse und die Nutzer-ID des Erstellers des Artikels. Dieses Feld ist leer, wenn der Creator keinen Zugriff mehr auf das Element hat.
Snapshot-Zeitstempel	snapshot_start_time_micros und snapshot_end_time_micros	Die Zeitstempel für den Beginn und das Ende der Berichterstellung.
Titel	title	Der vom Nutzer angegebene Dateititel.
Beschreibung	Beschreibung	Eine kurze Beschreibung des Elements
Status „In den Papierkorb verschoben“	trashed	Gibt an, ob das Element in den Papierkorb verschoben, aber noch nicht gelöscht wurde.
MIME-Typ	mime_type	Der MIME-Typ des Artikels. Unterstützte MIME-Typen für Google Workspace und Google Drive
Dateiendung	file_extension	Die letzte Komponente der vollständigen Dateiendung, die aus dem Namensfeld extrahiert wird. Diese Funktion ist nur für Elemente mit binären Inhalten in Google Drive verfügbar.
Erstellungszeit	create_time_micros	Der Zeitstempel für den Zeitpunkt, zu dem das Element erstellt wurde.
Uhrzeit der letzten Aktualisierung	last_modified_time_micros	Der Zeitstempel der letzten Änderung des Elements durch eine beliebige Person.
Dateigröße	file_size_bytes	Die Größe in Byte von Blobs und Docs-Editor-Dateien. Wird nicht für Elemente ohne Größe erfasst, z. B. Verknüpfungen und Ordner.
Verbrauchtes Kontingent	consumed_quota_bytes	Die Anzahl der vom Artikel verwendeten Speicherkontingent-Byte. Dazu gehören die Hauptversion sowie vorherige Versionen, die beibehalten wurden.
ID der geteilten Ablage	shared_drive_id	Bei Elementen in einer geteilten Ablage die ID der geteilten Ablage.
Organisationseinheit	org_unit_path	Die Organisationseinheit des Inhabers des Artikels.
Angewendete Labels*	applied_labels.id	Die ID des Labels, das auf den Artikel angewendet wurde.
	applied_labels.title	Der Ressourcenname des Labels, das auf das Element angewendet wird.
	applied_labels.field_values.id	Die ID eines Felds, die innerhalb eines Labels oder einer Bibliothek eindeutig ist.
	applied_labels.field_values.type	Der Typ des Felds. folgende Arten von Werten sind möglich: Text Ganzzahl Datum Auswahl Nutzer
	applied_labels.field_values.display_name	Der Text, der in der Benutzeroberfläche angezeigt wird und das Feld identifiziert.
Berechtigungen	access.permissions.permission_id	Die ID dieser Berechtigung. Dies ist eine eindeutige Kennung für den Begünstigten. Hinweis: Die Berechtigungs-ID ist nicht mit der Nutzer-ID identisch.
	access.permissions.name	Der „hübsche“ Name des Berechtigungswerts. Im Folgenden finden Sie Beispiele für die einzelnen Berechtigungstypen: user: Der vollständige Name des Nutzers, wie er für sein Google-Konto definiert ist, z. B. „Dana Cruz“ group: Name der Gruppe, z. B. „Beispieladministratoren“ domain: String-Domainname, wie z. B. "example.com" anyone: Kein Name gemeldet
	access.permissions.type	Der Typ der Berechtigung. Gültige Werte sind: Nutzer Gruppe Domain anyone
	access.permissions.role	Die Rolle, die durch diese Berechtigung gewährt wird. Gültige Werte sind: Inhaber Organisator fileOrganizer writer Kommentator Leser Hinweis: Weitere Informationen zum Typ finden Sie unter Rollen und Berechtigungen.
	access.permissions.view	Wenn die Berechtigung zu einer Datenansicht gehört, ist der Wert veröffentlicht.
	access.permissions.allow_file_discovery	Gibt an, ob die Datei aufgrund der Berechtigung durchsucht werden kann. Wird nur für Berechtigungen vom Typ domain oder anyone gemeldet.
	access.permissions.email	Die E-Mail-Adresse des Nutzers oder der Gruppe, auf die sich diese Berechtigung bezieht.
	access.permissions.domain	Der Domainname der Entität, auf die sich diese Berechtigung bezieht. Dieser ist vorhanden, wenn der Berechtigungstyp user, group oder domain ist.
	access.permissions.user_id	Die Nutzer-ID, die mit der E-Mail-Adresse in den Berechtigungen verknüpft ist.

* Bezieht sich auf Labels, die auf Elemente in Drive angewendet werden.

Beispielabfragen

Für die Abfragen wird Legacy-SQL vorausgesetzt. Ersetzen Sie api_project_name.dataset_name durch Ihren eigenen Projektnamen und Dataset-Namen. Weitere Informationen zum Abfragen von BigQuery-Daten

Alle maximieren  |  Alle minimieren

Elemente finden, die über die Drive-Suche gefunden werden können

Ersetzen Sie project_name.dataset_name durch Ihren Projektnamen und Dataset-Namen.

Gibt eine Tabelle mit Datei-ID, Titel, E-Mail-Adresse des Eigentümers und Typ zurück.

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
)

Elemente mit einem bestimmten Label finden

Ersetzen Sie project_name.dataset_name durch Ihren Projektnamen und Dataset-Namen. Ersetzen Sie label_id durch Ihre Label-ID, die Sie im Label-Manager finden.

Diese Abfrage gibt eine Tabelle mit Datei-ID, Titel, E-Mail-Adresse des Eigentümers und Typ zurück.

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
)

Nutzer ermitteln, die einen Grenzwert für die Drive-Speichernutzung überschritten haben

Ersetzen Sie project_name.dataset_name durch Ihren Projektnamen und Dataset-Namen. Ersetzen Sie threshold durch Ihren Grenzwert in MB. Wenn Sie beispielsweise Nutzer mit mehr als 15 GB Drive-Speicherplatz ermitteln möchten, lautet die vorletzte Zeile HAVING total_storage_mb > 15000.

Diese Abfrage gibt in absteigender Reihenfolge die E-Mail-Adresse des Nutzers und die Gesamtnutzung des Drive-Speicherplatzes in MB zurück.

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

Herausfinden, welche Elementtypen den meisten Speicherplatz belegen

Ersetzen Sie project_name.dataset_name durch Ihren Projektnamen und Dataset-Namen.

Diese Abfrage gibt eine Tabelle mit Artikeltypen in absteigender Größe zurück.

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

Mit der clientseitigen Verschlüsselung (CSE) verschlüsselte Elemente suchen

Ersetzen Sie project_name.dataset_name durch Ihren Projektnamen und Dataset-Namen.

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

Elemente suchen, die für einen bestimmten Nutzer freigegeben wurden

Ersetzen Sie project_name.dataset_name durch Ihren Projektnamen und Dataset-Namen. Ersetzen Sie [e-mail] durch den Nutzer, für den Sie die Berechtigung erteilen möchten.

Hinweis: Mit dieser Abfrage werden keine Freigaben für den Nutzer über Gruppen oder Zielgruppenmitgliedschaften gefunden.

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 = [e-mail]
)

Weitere Informationen

• Drive-Inventar Ihrer Organisation exportieren
• Google Workspace-Protokolle und -Berichte in BigQuery