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 Premium. 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 ger exempel på sökfrå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 söka i Drive-innehållet i BigQuery. Aktivera fakturering för ett projekt .

Exportschema för Drive-innehåll

Exportschema för 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, användar-id för filägaren.

owner.user.email

För objekt som ägs av en användare, 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ämplar för när rapportgenereringen startade och slutade
Lästid read_time_micros Tidsstämpeln för när Drive-objektets metadata lästes.
Titel title Den användarspecifika filtiteln.
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 för 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 Antalet byte av 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:t för objektets överordnade mapp.

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

  1. Filen har en överordnad mapp på toppnivå på användarens Min enhet.
  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 på 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

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

applied_labels.field_values.display_name

Texten som ska visas i användargränssnittet och som identifierar fältet.
Genvägens mål-id shortcut_target_id Id:t för filen eller mappen som genvägen pekar på.
Behörigheter access.permissions.permission_id

Id:t för behörigheten. 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 är en lista med exempel på varje typ av behörighet:

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

Behörighetstypen. 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 gäller.
access.permissions.domain Domännamnet för den enhet som behörigheten gäller. 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örighetstypen 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 bara i för objekt på delade enheter.
access.permissions.permission_details
.inherited
Ett booleskt värde som anger om behörigheten ärvs.
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 exporten av Drive-innehåll.

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 metadata för den delade enheten lästes, i mikrosekunder.

Schema för extern delning

Schema och definitioner för extern delning

Den externa delningsdatan läggs till i BigQuery-datasetet (samma dataset som exportschemat för Drive-innehåll) 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.
  • Det här fältet är inställt på True om filen har externa deltagare, inklusive instanser där
    • Alla delade konton är tjänstkonton.
    • Åtkomst tillåts av policykontroller.
    • Filen publiceras offentligt.
    • Filen delas med alla.
  • Fältet är inställt på Falskt om filen inte delas externt eller om principkontroller blockerar åtkomsten för alla externa deltagare.
Har extern delning (exklusive tjänstkonton) access.has_external_sharing_excluding_service_accounts Anger om filen har minst en extern delning 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 publiceras externt.
delas med alla access.is_shared_with_everyone Visar om filen delas med alla.
Externa delningar

access.external_sharees.type

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

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

access.external_sharees.email

Visar e-postadressen för 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 True utesluts den delade användaren 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å det här 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 dagliga rapporter).

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.

Den här sökfrå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(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.

Den här sökfrå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 gräns för lagringsutrymme på Drive

Ersätt project_name.dataset_name med ditt projektnamn och datasetnamn. Ersätt threshold med gränsen 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 total användning av lagringsutrymme i 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

Ta reda på vilka artikeltyper som tar upp mest utrymme

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

Den här sökfrågan returnerar en tabell med artikeltyper i fallande storleksordning.

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 har krypterats 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 delas 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 Drive-objektets titel 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å en 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;