SESSIONS_BY_USER 檢視畫面

INFORMATION_SCHEMA.SESSIONS_BY_USER 檢視畫面包含 BigQuery 工作階段的即時中繼資料，這些工作階段是由目前使用者在目前專案中建立。

所需權限

如要查詢 INFORMATION_SCHEMA.SESSIONS_BY_USER 檢視畫面，您必須具備專案的 bigquery.jobs.list 身分與存取權管理 (IAM) 權限。以下每個預先定義的 IAM 角色都包含必要權限：

  • 專案檢視者
  • BigQuery 使用者

如要進一步瞭解 BigQuery 權限，請參閱「使用身分與存取權管理功能控管存取權」。

結構定義

查詢 INFORMATION_SCHEMA.SESSIONS_BY_* 檢視表時，查詢結果會針對每個 BigQuery 工作階段列出一個資料列。

INFORMATION_SCHEMA.SESSIONS_BY_* 檢視表具有下列結構定義：

資料欄名稱 資料類型 值
creation_time TIMESTAMP (分區欄) 這個工作階段的建立時間。分區作業會以這個時間戳記的世界標準時間為準。
expiration_time TIMESTAMP (分區欄) 這個工作階段的到期時間。分區作業會以此時間戳記的世界標準時間為準。
is_active BOOL 工作階段是否仍在運作？如果是，則為 TRUE，否則為 FALSE。
last_modified_time TIMESTAMP (分割欄) 工作階段上次修改的時間。 分區作業會以這個時間戳記的世界標準時間為準。
project_id STRING 專案 ID (叢集欄)。
project_number INTEGER 專案編號。
session_id STRING 工作階段 ID。例如 bquxsession_1234。
user_email STRING (叢集資料欄) 執行工作階段的使用者電子郵件地址或服務帳戶。

資料保留

這個檢視畫面包含目前執行中的工作階段，以及過去 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 |
+-------------------------------------------------------------------------+