Schema's en voorbeeldquery's voor exports van Drive-voorraad in BigQuery

Deze functie wordt ondersteund in de volgende versies: Frontline Plus, Enterprise Standard, Enterprise Plus, Education Standard, Education Plus, Enterprise Essentials Plus en Cloud Identity Premium. Versies vergelijken

Nadat u exports van Drive-voorraad heeft ingesteld, kunt u de dataset analyseren in BigQuery. Op deze pagina worden het tabelschema en voorbeeldquery's beschreven voor veelgebruikte rapporten die u kunt bekijken in BigQuery.

Opmerking: U moet de facturering instellen voor uw Google Cloud-project, omdat er kosten verbonden zijn aan de export van uw Drive-voorraad naar BigQuery en het uitvoeren van query's hierop. Facturering aanzetten voor een project.

Schema voor export van Drive-voorraad

Schema voor export van Drive-voorraad

De export van Drive-voorraad wordt met het volgende schema toegevoegd aan de BigQuery-dataset:

Schema en definities
Naam Schemaveld Beschrijving
Item-ID id De unieke Drive-item-ID van het item.
Versie version Het nieuwste versienummer van het bestand. De bestandsversie is een oplopend getal. Hiermee worden alle wijzigingen doorgevoerd die in het bestand op de server worden aangebracht, zelfs wijzigingen die niet zichtbaar zijn voor de gebruiker.
Eigenaar

owner.user.id

De gebruikers-ID van de bestandseigenaar voor items die eigendom zijn van een gebruiker.

owner.user.email

Het e-mailadres van de bestandseigenaar voor items die eigendom zijn van een gebruiker.

owner.shared_drive.id

Voor items in een gedeelde Drive is dit de ID van de gedeelde Drive.

Maker creator Het e-mailadres en de gebruikers-ID van de maker van het item. Dit veld wordt niet ingevuld als de maker geen toegang meer heeft tot het item.
Tijdstempels van momentopname snapshot_start_time_micros en snapshot_end_time_micros De tijdstempels van wanneer het maken van het rapport is begonnen en beëindigd.
Leestijd read_time_micros Het tijdstempel van wanneer de metadata van het Drive-item is gelezen.
Titel title De door de gebruiker ingevoerde bestandstitel.
Beschrijving description Een korte beschrijving van het item.
Status Prullenbak trashed Of het item naar de prullenbak is verplaatst maar nog niet is verwijderd.
MIME-type mime_type Het MIME-type van het item. Ga naar de ondersteunde MIME-typen voor Google Workspace en Google Drive.
Bestandsextensie file_extension De laatste component van de volledige bestandsextensie, die wordt opgehaald uit het naamveld. Dit is alleen beschikbaar voor items met binaire content in Google Drive.
Aanmaaktijd create_time_micros Het tijdstempel van wanneer het item is gemaakt.
Laatst aangepast om last_modified_time_micros Het tijdstempel van de laatste keer dat het item door iemand is aangepast.
Grootte in bytes size_bytes De grootte in bytes van blobs en bestanden in Editors van Documenten. Wordt niet gerapporteerd voor items zonder grootte, zoals snelkoppelingen en mappen.
Gebruikt quotum consumed_quota_bytes Het aantal opslagquotumbytes dat door het item wordt gebruikt. Dit omvat de hoofdrevisie en eerdere revisies die zijn bewaard.
Organisatie-eenheid org_unit_path De organisatie-eenheid van de eigenaar van het item.
Controlecijfer md5_checksum Het MD5-controlegetal voor de content van het item.
Versleuteling aan de clientzijde client_side_encrypted Een Booleaanse waarde die aangeeft of het item is versleuteld aan de clientzijde.
Bovenliggende map parent De ID van de bovenliggende map voor het item.

In de volgende gevallen wordt de bovenliggende map niet ingevuld:

  1. Het bestand is bovenliggend in de map op het hoogste niveau van de Mijn Drive van een gebruiker.
  2. De bovenliggende map is geen eigendom van het domein.
Toegepaste labels* applied_labels.id De ID van het label dat is toegepast op het item.
applied_labels.title De resourcenaam van het label dat is toegepast op het item.
applied_labels.field_values.id

De ID van een veld, uniek binnen een label of bibliotheek.

applied_labels.field_values.type

Het type veld. Dit kan een van de volgende zijn:

applied_labels.field_values.display_name

De tekst die in de UI wordt getoond en het veld identificeert.
Doel-ID van snelkoppeling shortcut_target_id De ID van het bestand of de map waarnaar deze snelkoppeling verwijst.
Rechten access.permissions.permission_id

De ID van dit recht. Dit is een unieke ID voor de begunstigde.

Opmerking: De rechten-ID is niet hetzelfde als de gebruikers-ID.

access.permissions.name

De beschrijvende naam van de waarde van het recht. Hieronder volgt een lijst met voorbeelden voor elk type recht:

  • user: De volledige naam van de gebruiker, zoals gedefinieerd voor het Google-account, zoals 'Dana Cruz'
  • group: De naam van de groep, zoals 'Voorbeeldbeheerders'.
  • domain: De domeinnaam van de tekenreeks, zoals example.com
  • anyone: geen naam gemeld
access.permissions.type

Het type recht. Geldige waarden zijn:

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

De rol die door dit recht is verleend. Geldige waarden zijn:

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

Opmerking: Ga naar Rollen en rechten voor meer informatie over het type.

access.permissions.view

Als het recht bij een weergave hoort, is de waarde published.

access.permissions.allow_file_discovery

Of het recht toestaat dat het bestand kan worden doorzocht. Wordt alleen gerapporteerd voor rechten van het type domain of anyone.
access.permissions.email Het e-mailadres van de gebruiker of groep waarnaar dit recht verwijst.
access.permissions.domain De domeinnaam van de entiteit waarnaar dit recht verwijst. Dit recht is aanwezig als het type recht user, group of domain is.
access.permissions.user_id De gebruikers-ID die is gekoppeld aan het e-mailadres van de rechten.
access.permissions.permission_details
.permission_type
Het rechtentype voor de gebruiker.
access.permissions.permission_details.role De primaire rol voor de gebruiker.
access.permissions.permission_details
.inherited_from
De ID van het item waarvan dit recht is overgenomen. Dit wordt alleen ingevuld voor items in gedeelde Drives.
access.permissions.permission_details
.inherited
Een Booleaanse waarde die aangeeft of het recht is overgenomen.
access.permissions.inherited_permissions
_disabled
Of overgenomen rechten zijn uitgezet voor dit item. Alleen waar voor mappen met beperkte toegang.
Is templateschema is_template Een booleaanse waarde die aangeeft of het item een template is.

* Verwijst naar labels die zijn toegepast op items in Drive.

Schema voor gedeelde Drives

Tabel met gedeelde Drives

In de tabel staat het schema voor velden die specifiek zijn voor gedeelde Drives in de export van de Drive-voorraad.

Naam Schemaveld Beschrijving
ID gedeelde Drive shared_drive_id De unieke ID van de gedeelde Drive.
Naam van gedeelde Drive name De naam van de gedeelde Drive, zoals ingevoerd door de gebruiker.
Leestijd read_time_micros De tijdstempel van wanneer de metadata van de gedeelde Drive is gelezen, in microseconden.

Schema voor extern delen

Schema en definities voor extern delen

De gegevens over extern delen worden met het volgende schema toegevoegd aan de BigQuery-dataset (dezelfde dataset als het schema voor de export van Drive-voorraad):

Naam Schemaveld Beschrijving
Wordt extern gedeeld access.has_external_sharing Geeft aan of het bestand is gedeeld met externe gebruikers of serviceaccounts, inclusief gebruikers of accounts met indirecte toegang via groepslidmaatschap.
  • Dit veld is ingesteld op True als het bestand externe ontvangers heeft, waaronder instanties waarbij:
    • Alle gebruikers met wie je deelt, zijn serviceaccounts.
    • Toegang is toegestaan door beleidsopties.
    • Het bestand is openbaar gepubliceerd.
    • Het bestand is met iedereen gedeeld.
  • Het veld is ingesteld op False als het bestand niet extern wordt gedeeld of als beleidsopties de toegang blokkeren voor alle externe ontvangers.
Heeft extern delen (exclusief serviceaccounts) access.has_external_sharing_excluding_service_accounts Geeft aan of het bestand minstens één externe ontvanger buiten de organisatie heeft. Dit is ingesteld op False als alle externe ontvangers van de gedeelde items serviceaccounts zijn.
Extern is gepubliceerd access.is_published_externally Geeft aan of het bestand extern is gepubliceerd.
Is gedeeld met iedereen access.is_shared_with_everyone Geeft aan of het bestand met iedereen is gedeeld.
Externe gebruikers met wie is gedeeld

access.external_sharees.type

Toont het type externe gebruiker met wie is gedeeld. De volgende lijst bevat voorbeelden voor elk rechtentype:

  • GEBRUIKER
  • GROEP
  • NIET GESPECIFICEERD: de meeste accounts in deze categorie zijn niet-geclaimde accounts

access.external_sharees.email

Toont het e-mailadres van de externe ontvanger.

access.external_sharees.is_service_account

Geeft aan of de externe ontvanger een serviceaccount is.

access.external_sharees.access_blocked_by_policy_control

Geeft aan of de toegang wordt geblokkeerd door beleid (bijvoorbeeld DLP of vertrouwensregels). Als True, wordt de gebruiker met wie wordt gedeeld uitgesloten van de berekeningen van has_external_sharing en has_external_sharing_excluding_service_accounts.

DLP-informatie access.dlp_info.matching_dlp_rules Hier staan de overeenkomende DLP-regels die op dit item zijn toegepast.

Prestatieoverwegingen: Het kan langer duren om velden voor extern delen te berekenen als u groepen met meerdere geneste gebruikers heeft. Deze vertraging kan van invloed zijn op hoe actueel je gegevens zijn (bijvoorbeeld in dagelijkse rapporten).

Voorbeelden van zoekopdrachten

In deze voorbeeldquery's wordt uitgegaan van verouderde SQL. Meer informatie over zoeken in BigQuery-gegevens.

Vervang project_name.dataset_name door uw projectnaam en datasetnaam.

Deze query retourneert een tabel met de bestands-ID, titel, het e-mailadres van de eigenaar en het type.

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
)

Items met een specifiek label zoeken

Vervang project_name.dataset_name door uw projectnaam en datasetnaam. Vervang label_id door uw label-ID, die u kunt vinden in Labelbeheer.

Deze query retourneert een tabel met de bestands-ID, titel, het e-mailadres van de eigenaar en het type.

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
)

Gebruikers vinden die een drempelwaarde voor Drive-opslaggebruik overschrijden

Vervang project_name.dataset_name door uw projectnaam en datasetnaam. Vervang drempelwaarde door uw drempelwaarde in MB. Als u bijvoorbeeld gebruikers wilt vinden die meer dan 15 GB aan Drive-opslag gebruiken, is de voorlaatste regel HAVING total_storage_mb > 15000.

Deze query retourneert een tabel met het e-mailadres van de gebruiker en het totale Drive-opslaggebruik in MB in aflopende volgorde.

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

Zoeken welke itemtypen de meeste ruimte gebruiken

Vervang project_name.dataset_name door uw projectnaam en datasetnaam.

Deze query retourneert een tabel met itemtypen in aflopende grootte.

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

Items zoeken die zijn versleuteld met versleuteling aan de clientzijde (VCZ)

Vervang project_name.dataset_name door uw projectnaam en datasetnaam.

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

Items zoeken die zijn gedeeld met een specifieke gebruiker

Vervang project_name.dataset_name door uw projectnaam en datasetnaam. Vervang user@example.com door de specifieke gebruiker.

Opmerking: Met deze query wordt niet gevonden of de gebruiker iets deelt via groepen of lidmaatschap van een doelgroep.

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
)

Items zoeken met namen van gedeelde Drives

Vervang project_name.dataset_name door uw projectnaam en datasetnaam.

Deze query retourneert een tabel met de titel van het Drive-item en de naam van de gedeelde Drive.

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;

Aantal items in gedeelde Drive zoeken

Vervang project_name.dataset_name door uw projectnaam en datasetnaam.

Deze query retourneert een tabel met de naam van de gedeelde Drive en het aantal items.

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;