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