Unterstützte Versionen für diese Funktion: Frontline Plus; Enterprise Standard und Enterprise Plus; Education Standard und Education Plus; Enterprise Essentials Plus; Cloud Identity Premiumversion. Versionen vergleichen
Nachdem Sie Exporte des Drive-Inventars eingerichtet haben, können Sie das Dataset in BigQuery analysieren. Auf dieser Seite werden das Tabellenschema und Beispielabfragen für häufig verwendete Berichte beschrieben, die Sie mit BigQuery erstellen können.
Hinweis: Sie müssen die Abrechnung für Ihr Google Cloud-Projekt einrichten, da das Exportieren und Abfragen Ihres Drive-Inventars in BigQuery kostenpflichtig ist. Abrechnung für ein Projekt aktivieren
Schema für den Export von Google Drive-Inventar
Schema für den Export von Google Drive-Inventar
Der Export von Drive-Inventar wird dem BigQuery-Dataset mit dem folgenden Schema hinzugefügt:
Schema und Definitionen| Name | Schemafeld | Beschreibung |
|---|---|---|
| Artikel-ID | id |
Die eindeutige Drive-Element-ID des Elements. |
| Version | version |
Die aktuelle Versionsnummer der Datei. Die Dateiversion ist eine monoton steigende Zahl. Dies spiegelt jede Änderung wider, die an der Datei auf dem Server vorgenommen wurde, auch solche, die für den Nutzer nicht sichtbar sind. |
| Inhaber |
|
Bei Elementen, die einem Nutzer gehören, die Nutzer-ID des Dateieigentümers. |
|
|
Bei Elementen, die einem Nutzer gehören, die E-Mail-Adresse des Dateieigentümers. |
|
|
|
Bei Elementen in einer geteilten Ablage die ID der geteilten Ablage. |
|
| Ersteller | creator |
Die E-Mail-Adresse und die Nutzer-ID des Erstellers des Elements. Dieses Feld ist leer, wenn der Ersteller 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. |
| Lesezeit | read_time_micros |
Der Zeitstempel, zu dem die Metadaten des Drive-Elements gelesen wurden. |
| Titel | title |
Der vom Nutzer angegebene Dateititel. |
| Beschreibung | description |
Eine kurze Beschreibung des Elements |
| Status „In den Papierkorb verschoben“ | trashed |
Ob das Element in den Papierkorb verschoben, aber noch nicht gelöscht wurde. |
| MIME-Typ | mime_type |
Der MIME-Typ des Elements. Unterstützte MIME-Typen für Google Workspace und Google Drive |
| Dateiendung | file_extension |
Die letzte Komponente der vollständigen Dateiendung, die aus dem Feld „Name“ extrahiert wird. Diese Funktion ist nur für Elemente mit binären Inhalten in Google Drive verfügbar. |
| Erstellungszeit | create_time_micros |
Der Zeitstempel der Erstellung des Elements. |
| Uhrzeit der letzten Aktualisierung | last_modified_time_micros |
Der Zeitstempel der letzten Änderung des Elements durch eine beliebige Person. |
| Größe in Byte | size_bytes |
Die Größe von Blobs und Dateien aus Docs-Editoren in Byte. Wird nicht für Elemente ohne Größe wie Verknüpfungen und Ordner gemeldet. |
| Verbrauchtes Kontingent | consumed_quota_bytes |
Die Anzahl der vom Element verwendeten Speicherkontingent-Byte. Dazu gehören die Head-Version sowie frühere Versionen, die beibehalten wurden. |
| Organisationseinheit | org_unit_path |
Die Organisationseinheit des Inhabers des Elements. |
| Prüfsumme | md5_checksum |
Die MD5-Prüfsumme für den Inhalt des Elements. |
| Clientseitige Verschlüsselung | client_side_encrypted |
Ein boolescher Wert, der angibt, ob das Element clientseitig verschlüsselt ist. |
| Übergeordneter Ordner | parent |
Die ID des übergeordneten Ordners für das Element. In den folgenden Fällen wird der übergeordnete Ordner nicht ausgefüllt:
|
| 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. |
|
|
|
Der Typ des Felds. folgende Arten von Werten sind möglich: |
|
|
|
Der Text, der in der Benutzeroberfläche angezeigt werden soll, um das Feld zu identifizieren. | |
| Ziel-ID der Verknüpfung | shortcut_target_id |
Die ID der Datei oder des Ordners, auf die bzw. den diese Verknüpfung verweist. |
| Berechtigungen | access.permissions.permission_id |
Die ID dieser Berechtigung. Dies ist eine eindeutige Kennung für den Empfänger der Förderung. 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:
|
|
access.permissions.type |
Der Typ der Berechtigung. Gültige Werte sind:
|
|
access.permissions.role |
Die durch diese Berechtigung gewährte Rolle. Gültige Werte sind:
Hinweis: Weitere Informationen zum Typ finden Sie unter Rollen und Berechtigungen. |
|
access.permissions.view |
Wenn die Berechtigung zu einer Ansicht gehört, lautet der Wert |
|
|
|
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. | |
access.permissions.permission_details |
Der Berechtigungstyp für den Nutzer. | |
access.permissions.permission_details.role |
Die primäre Rolle des Nutzers. | |
access.permissions.permission_details |
Die ID des Elements, von dem diese Berechtigung übernommen wird. Dies wird nur für Elemente in geteilten Ablagen ausgefüllt. | |
access.permissions.permission_details |
Ein boolescher Wert, der angibt, ob die Berechtigung übernommen wird. | |
access.permissions.inherited_permissions |
Gibt an, ob übernommene Berechtigungen für dieses Element deaktiviert sind. Gilt nur für Ordner mit eingeschränktem Zugriff. | |
| Ist Vorlagenschema | is_template |
Ein boolescher Wert, der angibt, ob das Element eine Vorlage ist. |
* Bezieht sich auf Labels, die auf Elemente in Drive angewendet werden.
Schema für geteilte Ablagen
Tabelle für geteilte Ablagen
In der Tabelle wird das Schema für Felder für geteilte Ablagen im Drive-Inventarexport beschrieben.
| Name | Schemafeld | Beschreibung |
|---|---|---|
| ID der geteilten Ablage | shared_drive_id |
Die eindeutige Kennung der geteilten Ablage. |
| Name der geteilten Ablage | name |
Der vom Nutzer angegebene Name der geteilten Ablage. |
| Lesezeit | read_time_micros |
Der Zeitstempel, zu dem die Metadaten der geteilten Ablage gelesen wurden, in Mikrosekunden. |
Schema für externe Freigabe
Schema und Definitionen für die externe Freigabe
Die Daten zur externen Freigabe werden dem BigQuery-Dataset (dasselbe Dataset wie das Schema für den Export von Drive-Inventar) mit dem folgenden Schema hinzugefügt:
| Name | Schemafeld | Beschreibung |
|---|---|---|
| Externe Freigabe aktiviert | access.has_external_sharing |
Zeigt an, ob die Datei für externe Nutzer oder Dienstkonten freigegeben ist, einschließlich derer mit indirektem Zugriff über eine Gruppenmitgliedschaft.
|
| Hat externe Freigabe (außer Dienstkonten) | access.has_external_sharing_excluding_service_accounts |
Gibt an, ob die Datei mindestens einen externen Freigabeempfänger außerhalb der Organisation hat. Der Wert ist auf False festgelegt, wenn alle externen Freigabeempfänger Dienstkonten sind. |
| Extern veröffentlicht ist | access.is_published_externally |
Gibt an, ob die Datei extern veröffentlicht wird. |
| Für alle freigegeben ist | access.is_shared_with_everyone |
Zeigt an, ob die Datei für alle freigegeben ist. |
| Externe Empfänger |
|
Zeigt den Typ des externen Empfängers an. Die folgende Liste enthält Beispiele für die einzelnen Berechtigungstypen:
|
|
|
Zeigt die E-Mail-Adresse des externen Empfängers an. |
|
|
|
Gibt an, ob der externe Empfänger ein Dienstkonto ist. |
|
|
|
Zeigt an, ob der Zugriff durch eine Richtlinie blockiert wird (z. B. DLP- oder Vertrauensregeln). Wenn True, wird der Empfänger der Freigabe von den Berechnungen für |
|
| DLP-Informationen | access.dlp_info.matching_dlp_rules |
Hier werden die übereinstimmenden DLP-Regeln aufgeführt, die auf dieses Element angewendet wurden. |
Leistungsaspekte: Die Berechnung der Felder für die externe Freigabe kann länger dauern, wenn Sie Gruppen mit mehreren verschachtelten Nutzern haben. Diese Verzögerung kann sich auf die Aktualität Ihrer Daten auswirken, z. B. in täglichen Berichten.
Beispielabfragen
Für die Abfragen wird Legacy-SQL vorausgesetzt. Weitere Informationen zum Abfragen von BigQuery-Daten
Elemente finden, die über die Suche in Google Drive gefunden werden können
Ersetzen Sie project_name.dataset_name durch Ihren eigenen Projektnamen und Dataset-Namen.
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(access.permissions) AS permission
WHERE permission.allow_file_discovery = true
)Elemente mit einem bestimmten Label finden
Ersetzen Sie project_name.dataset_name durch Ihren eigenen 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 finden, die einen Grenzwert für die Drive-Speichernutzung überschreiten
Ersetzen Sie project_name.dataset_name durch Ihren eigenen Projektnamen und Dataset-Namen. Ersetzen Sie threshold durch Ihren Grenzwert in MB. Wenn Sie beispielsweise Nutzer mit mehr als 15 GB Drive-Speicherplatznutzung ermitteln möchten, lautet die vorletzte Zeile HAVING total_storage_mb > 15000.
Diese Abfrage gibt eine Tabelle mit der E‑Mail-Adresse des Nutzers und der gesamten Drive-Speichernutzung in MB in absteigender Reihenfolge 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 eigenen 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 clientseitiger Verschlüsselung (CSE) verschlüsselte Elemente finden
Ersetzen Sie project_name.dataset_name durch Ihren eigenen Projektnamen und Dataset-Namen.
SELECT id, owner.user.email, title
FROM project_name.dataset_name
WHERE mime_type LIKE '%.encrypted'
Elemente finden, die für einen bestimmten Nutzer freigegeben wurden
Ersetzen Sie project_name.dataset_name durch Ihren eigenen Projektnamen und Dataset-Namen. Ersetzen Sie user@example.com durch den gewünschten Nutzer.
Hinweis: Mit dieser Abfrage werden keine Freigaben für den Nutzer über Gruppen oder Zielgruppen 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 = user@example.com
)
Elemente mit Namen geteilter Ablagen suchen
Ersetzen Sie project_name.dataset_name durch Ihren eigenen Projektnamen und Dataset-Namen.
Diese Abfrage gibt eine Tabelle mit dem Titel des Drive-Elements und dem Namen der geteilten Ablage zurück.
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;
Anzahl der Elemente in einer geteilten Ablage ermitteln
Ersetzen Sie project_name.dataset_name durch Ihren eigenen Projektnamen und Dataset-Namen.
Diese Abfrage gibt eine Tabelle mit dem Namen der geteilten Ablage und der Anzahl der Elemente zurück.
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;