Schema och exempel på sökfrågor för Drive-innehållsexporter i BigQuery

Utgåvor som stöds för den här funktionen: Frontline Plus, Enterprise Standard och Enterprise Plus, Education Standard och Education Plus, Enterprise Essentials Plus, Cloud Identity-premiumversion. Jämför utgåvor

När du har konfigurerat export av Drive-innehåll kan du analysera datasetet i BigQuery. På den här sidan beskriver vi tabellschemat och exempelfrågor för vanliga rapporter som du kan få från BigQuery.

Obs! Du måste konfigurera fakturering för ditt Google Cloud-projekt eftersom det kostar att exportera och fråga Drive-innehållet i BigQuery. Aktivera fakturering för ett projekt .

Schema för export av Drive-innehåll

Schema för export av Drive-innehåll

Drive-innehållsexporten läggs till i BigQuery-datasetet med följande schema:

Schema och definitioner
Namn Schemafält Beskrivning
Objekt-id id Objektets unika Drive-objektidentifierare.
Version version Filens senaste versionsnummer. Filversionen är ett monotont ökande tal. Det återspeglar alla ändringar som görs i filen på servern, även de som inte är synliga för användaren.
Ägare

owner.user.id

För objekt som ägs av en användare är detta användar-id:t för filägaren.

owner.user.email

För objekt som ägs av en användare är detta e-postadressen till filägaren.

owner.shared_drive.id

För objekt på en delad enhet: den delade enhetens id.
Skapare creator E-postadress och användar-id för den som skapade objektet. Fältet fylls inte i om skaparen inte längre har åtkomst till objektet.
Tidsstämplar för ögonblicksbilder snapshot_start_time_micros och snapshot_end_time_micros Tidsstämplarna för när rapportgenereringen startade och slutade.
Lästid read_time_micros Tidsstämpeln för när metadata för Drive-objektet lästes.
Titel title Filens titel som angetts av användaren.
Beskrivning description En kort beskrivning av objektet.
Status Papperskorgen trashed Om objektet har flyttats till papperskorgen men har ännu inte raderats.
Mime-typ mime_type Objektets MIME-typ. Se MIME-typer som stöds i Google Workspace och Google Drive.
Filnamnstillägg file_extension Den sista komponenten i det fullständiga filnamnstillägget, som extraheras från namnfältet. Det här är endast tillgängligt för objekt med binärt innehåll på Google Drive
Skapades create_time_micros Tidsstämpeln när objektet skapades.
Tid för senaste ändring last_modified_time_micros Tidsstämpeln för när objektet senast ändrades av någon.
Storlek i byte size_bytes Storleken i byte för blob-filer och Dokumentredigerare-filer. Rapporteras inte för objekt utan storlek, såsom genvägar och mappar.
Förbrukad kvot consumed_quota_bytes Antal byte lagringsutrymme som används av objektet. Det omfattar huvudversionen och tidigare omarbetningar som har behållits.
Organisationsenhet org_unit_path Organisationsenheten för objektets ägare.
Checksumma md5_checksum MD5-kontrollsumman för objektets innehåll.
Kryptering på klientsidan client_side_encrypted Ett booleskt värde som anger om objektet är krypterat på klientsidan .
Överordnad mapp parent Id för den överordnade mappen för objektet.

Den överordnade mappen fylls inte i följande fall:

  1. Filen är överordnad i en användares mapp på Min enhet på toppnivå.
  2. Den överordnade mappen ägs inte av domänen.
Tillämpade etiketter* applied_labels.id Id för etiketten som tillämpas på objektet.
applied_labels.title Resursnamnet för etiketten som tillämpas på objektet.
applied_labels.field_values.id

Id:t för ett fält, unikt inom en etikett eller ett bibliotek.

applied_labels.field_values.type

Typen av fält. Kan vara något av följande:

applied_labels.field_values.display_name

 Texten som ska visas i användargränssnittet för att identifiera fältet.
Id för genvägsmål shortcut_target_id Id:t för filen eller mappen som genvägen pekar på.
Behörigheter access.permissions.permission_id

Id för denna behörighet. Det är en unik identifierare för förmånstagaren.

Obs! Behörighets-id är inte detsamma som användar-id.
access.permissions.name

Namnet på behörighetens värde. Här följer en lista med exempel för varje typ av behörighet:

  • user – användarens fullständiga namn enligt definitionen i Google-kontot, till exempel ”Dana Cruz”
  • group – namnet på gruppen, till exempel ”Exempeladministratörer”
  • domain – domännamn i strängformat, till exempel ”example.com”
  • anyone – Inget namn rapporterat
access.permissions.type

Typ av behörighet. Giltiga värden är:

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

Rollen som beviljas av denna behörighet. Giltiga värden är:

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

Obs! Mer information om typen finns i Roller och behörigheter.
access.permissions.view

Om behörigheten tillhör en vy är värdet published.

access.permissions.allow_file_discovery

 Om behörigheten tillåter att filen är sökbar. Rapporteras endast för behörigheter av typen domain eller anyone.
access.permissions.email E-postadressen till användaren eller gruppen som behörigheten avser.
access.permissions.domain Domännamnet för enheten som behörigheten avser. Visas när behörighetstypen är user, group eller domain.
access.permissions.user_id Användar-id kopplat till e-postadressen för behörigheterna.
access.permissions.permission_details
.permission_type		 Behörighetstyp för användaren.
access.permissions.permission_details.role Användarens primära roll.
access.permissions.permission_details
.inherited_from		 Id för objektet som behörigheten ärvs från. Det här fylls endast i för objekt på delade enheter.
access.permissions.permission_details
.inherited		 Ett booleskt värde som anger om behörigheten är ärvd.
access.permissions.inherited_permissions
_disabled		 Om ärvda behörigheter har inaktiverats för det här objektet. Gäller endast mappar med begränsad åtkomst.
Är mallschema is_template Ett booleskt värde som anger om objektet är en mall.

* Avser etiketter som tillämpas på objekt i Drive.

Schema för delade enheter

Tabell över delade enheter

Tabellen beskriver schemat för fält som är specifika för delade enheter i Drive-innehållsexporten.

Namn Schemafält Beskrivning
Id för delad enhet shared_drive_id Den unika identifieraren för den delade enheten.
Namn på delad enhet name Namnet på den delade enheten som användaren har angett.
Lästid read_time_micros Tidsstämpeln för när metadatan för den delade enheten lästes, i mikrosekunder.

Schema för extern delning

Schema och definitioner för extern delning

Data om extern delning läggs till i BigQuery-datasetet (samma dataset som schemat för Drive-innehållsexport) med följande schema:

Namn Schemafält Beskrivning
Har extern delning access.has_external_sharing Visar om filen delas med externa användare eller tjänstkonton, inklusive de med indirekt åtkomst via gruppmedlemskap.
  • Fältet är inställt på True om filen har externa mottagare, inklusive i följande fall:
    • Alla deltagare är tjänstkonton.
    • Åtkomst tillåts av policykontroller.
    • Filen är offentligt publicerad.
    • Filen delas med alla.
  • Fältet är inställt på False om filen inte delas externt eller om principstyrningar blockerar åtkomsten för alla externa mottagare.
har extern delning (utom tjänstkonton) access.has_external_sharing_excluding_service_accounts Anger om filen har minst en extern mottagare utanför organisationen. Detta är inställt på False om alla externa mottagare är tjänstkonton.
publiceras externt access.is_published_externally Anger om filen är publicerad externt.
delas med alla access.is_shared_with_everyone Visar om filen delas med alla.
Externa mottagare

access.external_sharees.type

Visar typen av extern mottagare. Följande lista visar exempel för varje behörighetstyp:

  • ANVÄNDARE
  • GRUPP
  • UNSPECIFIED – de flesta kontona i den här kategorin är konton som inte har gjort anspråk

access.external_sharees.email

Visar e-postadressen till den externa mottagaren.

access.external_sharees.is_service_account

Anger om den externa mottagaren är ett tjänstkonto.

access.external_sharees.access_blocked_by_policy_control

Visar om åtkomsten blockeras av en policy (till exempel DLP eller förtroenderegler). Om värdet är True utesluts mottagaren från beräkningarna av has_external_sharing och has_external_sharing_excluding_service_accounts.
DLP-information access.dlp_info.matching_dlp_rules Visar de matchande DLP-regler som tillämpas på objektet.

Prestandaöverväganden: Det kan ta längre tid att beräkna fält för extern delning om du har grupper med flera kapslade användare. Fördröjningen kan påverka hur aktuell din data är (till exempel i dagsrapporter).

Exempel på frågor

Dessa exempel på sökfrågor förutsätter äldre SQL. Läs mer om att söka i BigQuery-data.

Ersätt project_name.dataset_name med ditt projektnamn och datasetnamn.

Frågan returnerar en tabell med fil-id, titel, e-postadress till ägaren och typ.

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
)

Hitta objekt med en viss etikett

Ersätt project_name.dataset_name med ditt projektnamn och datasetnamn. Ersätt label_id med ditt etikett-id som du hittar i etiketthanteraren.

Frågan returnerar en tabell med fil-id, titel, ägarens e-postadress och typ.

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
)

Hitta användare som överskrider en viss gräns för användning av lagringsutrymme på Drive

Ersätt project_name.dataset_name med ditt projektnamn och datasetnamn. Ersätt gräns med din gräns i MB. Om du till exempel vill hitta användare med mer än 15 GB lagringsutrymme i Drive är den näst sista raden HAVING total_storage_mb > 15000.

Den här sökfrågan returnerar en tabell med användarens e-postadress och totalt använt lagringsutrymme på Drive i MB i fallande ordning.

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

Se vilka objekttyper som använder mest utrymme

Ersätt project_name.dataset_name med ditt projektnamn och datasetnamn.

Den här sökfrågan returnerar en tabell med varutyper efter fallande storlek.

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

Hitta objekt som är krypterade med kryptering på klientsidan (CSE)

Ersätt project_name.dataset_name med ditt projektnamn och datasetnamn.

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

Hitta objekt som har delats med en viss användare

Ersätt project_name.dataset_name med ditt projektnamn och datasetnamn. Ersätt användare@example.com med den specifika användaren.

Obs! Den här sökfrågan hittar inte delning för användaren via grupper eller medlemskap i målgrupper.

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
)

Hitta objekt med namn på delade enheter

Ersätt project_name.dataset_name med ditt projektnamn och datasetnamn.

Den här sökfrågan returnerar en tabell med titeln på Drive-objektet och namnet på den delade enheten.

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;

Hitta antal objekt på delad enhet

Ersätt project_name.dataset_name med ditt projektnamn och datasetnamn.

Den här sökfrågan returnerar en tabell med namnet på den delade enheten och antalet objekt.

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;