Tampilan SESSIONS_BY_USER

Tampilan INFORMATION_SCHEMA.SESSIONS_BY_USER berisi metadata real-time tentang sesi BigQuery yang dibuat oleh pengguna saat ini dalam project saat ini.

Izin yang diperlukan

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

  • Project Viewer
  • BigQuery User

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_USER Sesi yang dibuat oleh pengguna saat ini dalam project yang ditentukan. 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_USER
     Misalnya, `myproject`.`region-us`.INFORMATION_SCHEMA.SESSIONS_BY_USER.

    Contoh berikut mencantumkan sesi yang dibuat oleh pengguna saat ini:

    SELECT
  session_id,
  creation_time
FROM
  `region-us`.INFORMATION_SCHEMA.SESSIONS_BY_USER
WHERE
  creation_time >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 1 DAY)
ORDER BY
  creation_time DESC;

    Hasilnya akan terlihat seperti berikut:

    +-------------------------------------------------------------------------+
| session_id                                        | creation_time       |
+-------------------------------------------------------------------------+
| CgwKCmZhbGl1LXRlc3QQARokMGQ5YWWYzZmE0YjhkMDBm     | 2021-06-01 08:04:26 |
| CgwKCmZhbGl1LXRlc3QQARokMDAzYjI0OWQtZTczwZjA1NDc2 | 2021-05-31 22:43:02 |
+-------------------------------------------------------------------------+