SESSIONS_BY_USER 檢視表
INFORMATION_SCHEMA.SESSIONS_BY_USER 檢視表包含目前使用者在目前專案中建立的 BigQuery 工作階段即時中繼資料。
所需權限
如要查詢 INFORMATION_SCHEMA.SESSIONS_BY_USER 檢視表,您必須具備專案的 bigquery.jobs.list Identity and Access Management (IAM) 權限。下列各項預先定義的 IAM 角色都包含必要權限:
- 專案檢視者
- BigQuery 使用者
如要進一步瞭解 BigQuery 權限,請參閱「使用 IAM 控管存取權」。
結構定義
查詢 INFORMATION_SCHEMA.SESSIONS_BY_* 檢視表時,查詢結果會為每個 BigQuery 工作階段顯示一列。
INFORMATION_SCHEMA.SESSIONS_BY_* 檢視表具有下列結構定義:
| 資料欄名稱 | 資料類型 | 值 |
|---|---|---|
creation_time |
TIMESTAMP |
(分區資料欄) 這個工作階段的建立時間。 分區依據為這個時間戳記的世界標準時間。 |
expiration_time |
TIMESTAMP |
(分區資料欄) 這個工作階段的到期時間。 分區依據為這個時間戳記的世界標準時間。 |
folder_numbers |
ARRAY<INT64> |
階層中包含專案的資料夾 ID,依階層由低到高排序。 |
is_active |
BOOL |
工作階段是否仍在進行中?如果是,則為 TRUE,否則為 FALSE。
|
last_modified_time |
TIMESTAMP |
(分區欄) 工作階段上次修改的時間。 分區依據為這個時間戳記的世界標準時間。 |
principal_subject |
STRING |
執行工作階段的主體 ID。格式如下:Google 帳戶使用者為 user:USER_EMAIL、服務帳戶為 serviceAccount:SA_EMAIL,或員工身分聯盟和 Workload Identity Federation 主體為開頭是 principal:// 的主體 ID。 |
project_id |
STRING |
(分群欄) 專案 ID。 |
project_number |
INTEGER |
專案編號。 |
session_id |
STRING |
工作階段 ID。例如 bquxsession_1234。 |
user_email |
STRING |
(分群欄) 執行工作階段的使用者電子郵件地址或服務帳戶。 |
為確保穩定性,建議您在資訊結構定義查詢中明確列出資料欄,而非使用萬用字元 (SELECT *)。明確列出資料欄可避免查詢在基礎結構定義變更時中斷。
資料保留
這個檢視畫面會顯示目前執行中的工作階段,以及過去 180 天內完成的工作階段記錄。
範圍和語法
對這個檢視表執行的查詢必須包含區域限定詞。如未指定區域限定詞,系統會從所有區域擷取中繼資料。下表說明這個檢視畫面的區域範圍:
| 檢視表名稱 | 資源範圍 | 區域範圍 |
|---|---|---|
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SESSIONS_BY_USER |
目前使用者在指定專案中建立的工作階段。 | REGION |
-
選用:
PROJECT_ID: Google Cloud 專案的 ID。如未指定,則會使用預設專案。 -
REGION:任何資料集區域名稱。例如:`region-us`。
範例
如要對預設專案以外的專案執行查詢,請按照下列格式新增專案 ID:
`PROJECT_ID`.`region-REGION_NAME`.INFORMATION_SCHEMA.SESSIONS_BY_USER
`myproject`.`region-us`.INFORMATION_SCHEMA.SESSIONS_BY_USER。
以下範例列出目前使用者建立的工作階段:
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;
結果應如下所示:
+-------------------------------------------------------------------------+ | session_id | creation_time | +-------------------------------------------------------------------------+ | CgwKCmZhbGl1LXRlc3QQARokMGQ5YWWYzZmE0YjhkMDBm | 2021-06-01 08:04:26 | | CgwKCmZhbGl1LXRlc3QQARokMDAzYjI0OWQtZTczwZjA1NDc2 | 2021-05-31 22:43:02 | +-------------------------------------------------------------------------+