Schemat i przykładowe zapytania dotyczące eksportów zasobów na Dysku w BigQuery

Ta funkcja jest dostępna w tych wersjach: Frontline Plus; Enterprise Standard i Enterprise Plus; Education Standard i Education Plus; Enterprise Essentials Plus; Cloud Identity Premium. Porównaj wersje

Po skonfigurowaniu eksportu zasobów na Dysku możesz przeanalizować zbiór danych w BigQuery. Ta strona zawiera opis schematu tabeli i przykładowe zapytania dotyczące typowych raportów, które można uzyskać z BigQuery.

Uwaga: musisz skonfigurować płatności w projekcie w chmurze Google Cloud, ponieważ eksportowanie i wykonywanie zapytań dotyczących zasobów na Dysku w BigQuery wiąże się z kosztami. Sekcja dotycząca włączania płatności za projekt materiału o modyfikowaniu płatności za projekt (w języku angielskim).

Schemat eksportu zasobów na Dysku

Schemat eksportu zasobów na Dysku

Eksport zasobów na Dysku jest dodawany do zbioru danych BigQuery zgodnie z tym schematem:

Schemat i definicje
Nazwa Pole schematu Opis
Identyfikator elementu id Unikalny identyfikator elementu na Dysku.
Wersja version Numer najnowszej wersji pliku. Wersja pliku to liczba monotonicznie rosnąca. Odzwierciedla wszystkie zmiany wprowadzone w pliku na serwerze, nawet te niewidoczne dla użytkownika.
Właściciel

owner.user.id

W przypadku elementów należących do użytkownika – identyfikator użytkownika, do którego należy plik.

owner.user.email

W przypadku elementów należących do użytkownika – adres e-mail właściciela pliku.

owner.shared_drive.id

W przypadku elementów na dysku współdzielonym – identyfikator dysku współdzielonego.

twórca; creator Adres e-mail i identyfikator użytkownika twórcy elementu. To pole jest puste, jeśli twórca nie ma już dostępu do elementu.
Sygnatury czasowe zrzutu snapshot_start_time_micros i snapshot_end_time_micros Sygnatury czasowe rozpoczęcia i zakończenia generowania raportu.
Czas odczytu read_time_micros Sygnatura czasowa odczytu metadanych elementu na Dysku.
Tytuł title Określony przez użytkownika tytuł pliku.
Opis description Krótki opis elementu.
Stan przeniesienia do kosza trashed Czy element został przeniesiony do kosza, ale nie został jeszcze usunięty.
Typ MIME mime_type Typ MIME elementu. Zobacz obsługiwane typy MIME w Google Workspace i na Dysku Google.
Rozszerzenie pliku file_extension Ostatni komponent pełnego rozszerzenia pliku wyodrębniony z pola nazwy. Ta funkcja jest dostępna tylko w przypadku elementów z zawartością binarną na Dysku Google.
Czas utworzenia create_time_micros Sygnatura czasowa utworzenia elementu.
Czas ostatniej modyfikacji last_modified_time_micros Sygnatura czasowa ostatniej modyfikacji elementu przez dowolną osobę.
Rozmiar (bajty) size_bytes Rozmiar w bajtach plików blob i plików edytorów Dokumentów. Te dane nie są raportowane w przypadku elementów, które nie mają określonego rozmiaru, takich jak skróty czy foldery.
Wykorzystany limit consumed_quota_bytes Liczba bajtów limitu miejsca na dane wykorzystanych przez element. Obejmuje to wersję główną oraz wcześniejsze wersje, które zostały zachowane.
Jednostka organizacyjna org_unit_path Jednostka organizacyjna właściciela elementu.
Suma kontrolna md5_checksum Suma kontrolna MD5 treści elementu.
Szyfrowanie po stronie klienta client_side_encrypted Wartość logiczna wskazująca, czy element jest zaszyfrowany po stronie klienta.
Folder nadrzędny parent Identyfikator folderu nadrzędnego elementu.

Folder nadrzędny nie zostanie wypełniony w tych przypadkach:

  1. Plik znajduje się w folderze najwyższego poziomu na Moim dysku użytkownika.
  2. Folder nadrzędny nie należy do domeny.
Zastosowane etykiety* applied_labels.id Identyfikator etykiety zastosowanej do elementu.
applied_labels.title Nazwa zasobu etykiety zastosowanej do elementu.
applied_labels.field_values.id

Identyfikator pola unikalny w ramach etykiety lub biblioteki.

applied_labels.field_values.type

Typ pola. Użyj jednego z tych rodzajów wartości:

applied_labels.field_values.display_name

Tekst określający pole, który będzie wyświetlany w interfejsie.
Identyfikator celu skrótu shortcut_target_id Identyfikator pliku lub folderu, do którego prowadzi ten skrót.
Uprawnienia access.permissions.permission_id

Identyfikator tego uprawnienia. To jest unikalny identyfikator obdarowanego.

Uwaga: identyfikator uprawnienia to nie to samo co identyfikator użytkownika.

access.permissions.name

„Czytelna” nazwa wartości uprawnienia. Poniżej znajdziesz listę przykładów dla każdego typu uprawnień:

  • user – imię i nazwisko użytkownika zgodnie z definicją konta Google, na przykład „Dana Cruz”;
  • group – nazwa grupy, na przykład „Przykładowi administratorzy”;
  • domain – ciąg tekstowy z nazwą domeny, na przykład „example.com”;
  • anyone – brak zgłoszonej nazwy.
access.permissions.type

Typ uprawnienia. Prawidłowe wartości:

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

Rola przyznana przez to uprawnienie. Prawidłowe wartości:

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

Uwaga: szczegółowe informacje o typie znajdziesz w przewodniku po rolach i uprawnieniach (w języku angielskim).

access.permissions.view

Jeśli uprawnienie należy do widoku, wartość to published.

access.permissions.allow_file_discovery

Określa, czy uprawnienie umożliwia wyszukiwanie pliku. Raportowane tylko w przypadku uprawnień typu domain lub anyone.
access.permissions.email Adres e-mail użytkownika lub grupy, do których odnosi się to uprawnienie.
access.permissions.domain Nazwa domeny elementu, do którego odnosi się to uprawnienie. Jest on obecny, gdy typem uprawnień jest user, group lub domain.
access.permissions.user_id Identyfikator użytkownika powiązany z adresem e-mail w uprawnieniach.
access.permissions.permission_details
.permission_type
Typ uprawnień użytkownika.
access.permissions.permission_details.role Główna rola użytkownika.
access.permissions.permission_details
.inherited_from
Identyfikator elementu, z którego to uprawnienie jest dziedziczone. Ta wartość jest podawana tylko w przypadku elementów na dyskach współdzielonych.
access.permissions.permission_details
.inherited
Wartość logiczna wskazująca, czy uprawnienie jest dziedziczone.
access.permissions.inherited_permissions
_disabled
Określa, czy uprawnienia dziedziczone są wyłączone dla tego elementu. Dotyczy tylko folderów z ograniczonym dostępem.
Is Template Schema is_template Wartość logiczna wskazująca, czy element jest szablonem.

* Dotyczy etykiet zastosowanych do elementów na Dysku.

Schemat dysków współdzielonych

Tabela dysków współdzielonych

Tabela zawiera szczegółowe informacje o schemacie pól związanych z dyskami współdzielonymi w eksportowanych zasobach na Dysku.

Nazwa Pole schematu Opis
Identyfikator dysku współdzielonego shared_drive_id Unikalny identyfikator dysku współdzielonego.
Nazwa dysku współdzielonego name Nazwa dysku współdzielonego podana przez użytkownika.
Czas odczytu read_time_micros Sygnatura czasowa odczytu metadanych dysku współdzielonego (w mikrosekundach).

Schemat udostępniania zewnętrznego

Schemat i definicje udostępniania zewnętrznego

Dane dotyczące udostępniania zewnętrznego są dodawane do zbioru danych BigQuery (tego samego zbioru danych co schemat eksportu zasobów na Dysku) zgodnie z tym schematem:

Nazwa Pole schematu Opis
Udostępnianie zewnętrzne access.has_external_sharing Pokazuje, czy plik jest udostępniony użytkownikom zewnętrznym lub kontom usługi, w tym tym, które mają dostęp pośredni dzięki członkostwu w grupie.
  • To pole ma wartość True, jeśli plik jest udostępniany zewnętrznym użytkownikom, w tym w sytuacjach, gdy:
    • Wszyscy użytkownicy, którym udostępniono zasób, to konta usługi.
    • Dostęp jest dozwolony przez ustawienia zasad.
    • Plik jest opublikowany publicznie.
    • Plik jest udostępniany wszystkim.
  • Pole ma wartość False, jeśli plik nie jest udostępniany zewnętrznie lub jeśli ustawienia zasad blokują dostęp wszystkim zewnętrznym użytkownikom, którym udostępniono plik.
Ma udostępnianie zewnętrzne (z wyjątkiem kont usługi) access.has_external_sharing_excluding_service_accounts Wskazuje, czy plik ma co najmniej 1 użytkownika zewnętrznego spoza organizacji. Jeśli wszyscy zewnętrzni użytkownicy, którym udostępniono plik, to konta usługi, ta wartość jest ustawiona na False.
jest opublikowany zewnętrznie, access.is_published_externally Określa, czy plik jest opublikowany zewnętrznie.
jest udostępniony wszystkim, access.is_shared_with_everyone Pokazuje, czy plik jest udostępniony wszystkim.
Użytkownicy zewnętrzni, którym udostępniono pliki

access.external_sharees.type

Pokazuje typ zewnętrznego użytkownika, któremu udostępniono plik. Poniżej znajdziesz przykłady dla każdego typu uprawnień:

  • UŻYTKOWNIK
  • GRUPA
  • NIE OKREŚLONO – większość kont w tej kategorii to konta bez właściciela

access.external_sharees.email

Pokazuje adres e-mail zewnętrznego użytkownika, któremu udostępniono plik.

access.external_sharees.is_service_account

Wskazuje, czy zewnętrzne konto, któremu udostępniono plik, jest kontem usługi.

access.external_sharees.access_blocked_by_policy_control

Pokazuje, czy dostęp jest blokowany przez zasady (np. DLP lub reguły zaufania). Jeśli True, użytkownik, któremu udostępniono plik, jest wykluczony z obliczeń has_external_sharing i has_external_sharing_excluding_service_accounts.

Informacje o DLP access.dlp_info.matching_dlp_rules Zawiera listę pasujących reguł DLP zastosowanych do tego elementu.

Uwagi dotyczące wydajności: obliczanie pól udostępniania zewnętrznego może potrwać dłużej, jeśli masz grupy z wieloma zagnieżdżonymi użytkownikami. To opóźnienie może mieć wpływ na aktualność danych (np. w raportach dziennych).

Przykładowe zapytania

Zapytania te opierają się na założeniu, że użytkownik korzysta ze starszej wersji SQL. Dowiedz się więcej o zapytaniach o dane BigQuery.

Zastąp project_name.dataset_name nazwą własnego projektu i zbioru danych.

To zapytanie zwraca tabelę z identyfikatorem pliku, tytułem, adresem e-mail właściciela i typem.

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
)

Wyszukiwanie elementów z określoną etykietą

Zastąp project_name.dataset_name nazwą własnego projektu i zbioru danych. Zastąp label_id identyfikatorem etykiety, który możesz pobrać w menedżerze etykiet.

To zapytanie zwraca tabelę z identyfikatorem pliku, tytułem, adresem e-mail właściciela i typem.

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
)

Wyszukiwanie użytkowników, którzy przekroczyli próg wykorzystania miejsca na Dysku

Zastąp project_name.dataset_name nazwą własnego projektu i zbioru danych. Zastąp threshold progiem wyrażonym w MB. Aby na przykład znaleźć użytkowników, którzy wykorzystują ponad 15 GB miejsca na Dysku, użyj przedostatniego wiersza HAVING total_storage_mb > 15000.

To zapytanie zwraca e-maila użytkownika i łączną ilość miejsca na Dysku wyrażoną w MB w kolejności malejącej.

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

Sprawdzanie, które typy produktów zajmują najwięcej miejsca

Zastąp project_name.dataset_name nazwą własnego projektu i zbioru danych.

To zapytanie zwraca tabelę typów elementów posortowaną w kolejności malejącej według rozmiaru.

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

Wyszukiwanie elementów zaszyfrowanych po stronie klienta

Zastąp project_name.dataset_name nazwą własnego projektu i zbioru danych.

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

Wyszukiwanie elementów udostępnionych określonemu użytkownikowi

Zastąp project_name.dataset_name nazwą własnego projektu i zbioru danych. Zastąp user@example.com nazwą określonego użytkownika.

Uwaga: to zapytanie nie znajduje udostępnień przez użytkownika w grupach ani grupie odbiorców.

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
)

Znajdowanie elementów według nazw dysków współdzielonych

Zastąp project_name.dataset_name nazwą własnego projektu i zbioru danych.

To zapytanie zwraca tabelę z tytułem elementu na Dysku i nazwą dysku współdzielonego.

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;

Sprawdzanie liczby elementów na dysku współdzielonym

Zastąp project_name.dataset_name nazwą własnego projektu i zbioru danych.

To zapytanie zwraca tabelę z nazwą dysku współdzielonego i liczbą elementów.

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;