Tampilan SESSIONS_BY_PROJECT

Tampilan INFORMATION_SCHEMA.SESSIONS_BY_PROJECT berisi metadata real-time tentang semua sesi BigQuery dalam project saat ini.

Izin yang diperlukan

Untuk menjalankan kueri tampilan INFORMATION_SCHEMA.SESSIONS_BY_PROJECT, Anda memerlukan izin Identity and Access Management (IAM) bigquery.jobs.listAll untuk project tersebut. Setiap peran IAM yang telah ditetapkan berikut menyertakan izin yang diperlukan:

  • Pemilik Project
  • BigQuery Admin

Untuk mengetahui informasi selengkapnya tentang izin BigQuery, lihat Kontrol akses dengan IAM.

Skema

Saat Anda membuat kueri tampilan INFORMATION_SCHEMA.SESSIONS_BY_*, hasil kueri akan berisi satu baris untuk setiap sesi BigQuery.

Tampilan INFORMATION_SCHEMA.SESSIONS_BY_* memiliki skema berikut:

Nama kolom Jenis data Nilai
creation_time TIMESTAMP (Kolom partisi) Waktu pembuatan sesi ini. Partisi didasarkan pada waktu UTC stempel waktu ini.
expiration_time TIMESTAMP (Kolom partisi) Waktu habis masa berlaku sesi ini. Partisi didasarkan pada waktu UTC stempel waktu ini.
is_active BOOL Apakah sesi masih aktif? TRUE jika ya, dan FALSE jika tidak.
last_modified_time TIMESTAMP (Kolom partisi) Waktu saat sesi terakhir diubah. Partisi didasarkan pada waktu UTC stempel waktu ini.
project_id STRING (Kolom pengelompokan) untuk project.
project_number INTEGER Nomor project.
session_id STRING ID sesi. Misalnya, bquxsession_1234.
user_email STRING (Kolom pengelompokan) Alamat email atau akun layanan pengguna yang menjalankan sesi.

Retensi data

Tampilan ini berisi sesi yang sedang berjalan dan histori sesi yang selesai dalam 180 hari terakhir.

Cakupan dan sintaksis

Kueri terhadap tabel virtual ini harus menyertakan penentu region. Jika Anda tidak menentukan penentu regional, metadata akan diambil dari semua region. Tabel berikut menjelaskan cakupan region untuk tabel virtual ini:

Nama tabel virtual Cakupan resource Cakupan region
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SESSIONS_BY_PROJECT Level project REGION
Ganti kode berikut:

  • Opsional: PROJECT_ID: ID project Google Cloud Anda. Jika tidak ditentukan, project default akan digunakan.

  • REGION: nama region set data apa pun. Misalnya, `region-us`.

    • Contoh

    Untuk menjalankan kueri terhadap project selain project default Anda, tambahkan project ID dalam format berikut: 

    `PROJECT_ID`.`region-REGION_NAME`.INFORMATION_SCHEMA.SESSIONS_BY_PROJECT
     Misalnya, `myproject`.`region-us`.INFORMATION_SCHEMA.SESSIONS_BY_PROJECT. Contoh berikut mencantumkan semua pengguna atau akun layanan yang membuat sesi untuk project tertentu dalam satu hari terakhir:

    SELECT
  DISTINCT(user_email) AS user
FROM
  `region-us`.INFORMATION_SCHEMA.SESSIONS_BY_PROJECT
WHERE
  is_active = true
  AND creation_time >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 1 DAY);

    Hasilnya mirip dengan berikut ini:

    +--------------+
| user         |
+--------------+
| abc@xyz.com  |
+--------------+
| def@xyz.com  |
+--------------+