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 vindt u het tabel-schema en voorbeeldquery's voor veelgebruikte rapporten die u kunt ophalen uit 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 zijn 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 een onderliggend item 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 rechtstype 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 uitstaan voor dit item. Dit geldt alleen 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

De tabel bevat het schema voor velden die specifiek zijn voor gedeelde Drives in de export van 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 de gebruiker die heeft gegeven.
Leestijd read_time_micros Het tijdstempel van het moment waarop de metadata van de gedeelde Drive zijn 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
Heeft extern delen access.has_external_sharing Toont of het bestand is gedeeld met externe gebruikers of serviceaccounts, waaronder gebruikers met indirecte toegang via groepslidmaatschap.
  • Dit veld is ingesteld op Waar als het bestand externe deelgenoten heeft, waaronder in de volgende gevallen:
    • Alle gedeelde gebruikers zijn serviceaccounts.
    • Toegang is toegestaan door beleidsbeheer.
    • 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 beleidsbeheer de toegang blokkeert voor alle externe deelgenoten.
Extern delen (exclusief serviceaccounts) access.has_external_sharing_excluding_service_accounts Geeft aan of het bestand minstens één externe persoon heeft buiten de organisatie. Deze is ingesteld op Onwaar als alle externe deelgenoten serviceaccounts zijn.
Extern is gepubliceerd access.is_published_externally Geeft aan of het bestand extern is gepubliceerd.
Met iedereen wordt gedeeld access.is_shared_with_everyone Toont of het bestand met iedereen is gedeeld.
Externe gebruikers met wie is gedeeld

access.external_sharees.type

Toont het type externe persoon met wie je deelt. De volgende lijst toont voorbeelden voor elk rechtstype:

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

access.external_sharees.email

Toont het e-mailadres van de externe persoon met wie je het item hebt gedeeld.

access.external_sharees.is_service_account

Geeft aan of de externe gedeelde gebruiker een serviceaccount is.

access.external_sharees.access_blocked_by_policy_control

Toont of de toegang wordt geblokkeerd door beleid (bijvoorbeeld DLP of vertrouwensregels). Als Waar, wordt de gedeelde gebruiker uitgesloten van de berekeningen voor has_external_sharing en has_external_sharing_excluding_service_accounts.
DLP-informatie access.dlp_info.matching_dlp_rules Toont 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 uw 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, de 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. U vindt deze in de labelmanager.

Deze query retourneert een tabel met de bestands-ID, de 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 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 op 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 met een specifieke gebruiker zijn gedeeld

Vervang project_name.dataset_name door uw projectnaam en datasetnaam. Vervang user@example.com door uw 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;

Het aantal items in een gedeelde Drive vinden

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;