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. Pembuatan partisi didasarkan pada waktu UTC dari stempel waktu ini.
`expiration_time`	`TIMESTAMP`	(Kolom partisi) Waktu habis masa berlaku sesi ini. Pembuatan partisi didasarkan pada waktu UTC dari 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. Pembuatan partisi didasarkan pada waktu UTC dari stempel waktu ini.
principal_subject	STRING	(Kolom pengelompokan) ID utama pengguna yang menjalankan tugas.
`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.

Catatan: Anda harus menentukan lokasi untuk membuat kueri tabel virtual INFORMATION_SCHEMA dan lokasi eksekusi kueri harus cocok dengan region tabel virtual INFORMATION_SCHEMA.

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 |
+-------------------------------------------------------------------------+