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 |
|
För objekt som ägs av en användare, användar-id för filägaren. |
|
|
För objekt som ägs av en användare, e-postadressen till filägaren. |
|
|
|
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:
|
| 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. |
|
|
|
Typ av fält. Kan vara något av följande: |
|
|
|
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:
|
|
access.permissions.type |
Behörighetstypen. Giltiga värden är:
|
|
access.permissions.role |
Rollen som beviljas av denna behörighet. Giltiga värden är:
Obs! Mer information om typen finns i roller och behörigheter. |
|
access.permissions.view |
Om behörigheten tillhör en vy är värdet |
|
|
|
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 |
Behörighetstypen för användaren. | |
access.permissions.permission_details.role |
Användarens primära roll. | |
access.permissions.permission_details |
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 |
Ett booleskt värde som anger om behörigheten ärvs. | |
access.permissions.inherited_permissions |
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. |
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.
|
| 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 |
|
Visar typen av extern mottagare. Följande lista visar exempel på varje behörighetstyp:
|
|
|
Visar e-postadressen för den externa mottagaren. |
|
|
|
Anger om den externa mottagaren är ett tjänstkonto. |
|
|
|
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 |
|
| 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.
Hitta objekt som går att hitta med Drive-sökning
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;