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 セッションに関する情報が 1 行ずつ表示されるクエリ結果が返されます。
INFORMATION_SCHEMA.SESSIONS_BY_*
ビューのスキーマは次のとおりです。
列名 | データ型 | 値 |
---|---|---|
creation_time |
TIMESTAMP |
(パーティショニング列)このジョブの作成時間。 パーティショニングは、このタイムスタンプの UTC 時間に基づきます。 |
expiration_time |
TIMESTAMP |
(パーティショニング列)このセッションの有効期限。 パーティショニングは、このタイムスタンプの UTC 時間に基づきます。 |
is_active |
BOOL |
セッションはまだアクティブの場合は TRUE 、それ以外の場合は FALSE 。
|
last_modified_time |
TIMESTAMP |
(パーティショニング列)セッションが最後に変更された時刻。 パーティショニングは、このタイムスタンプの UTC 時間に基づきます。 |
プリンシパルのサブジェクト | STRING | (クラスタリング列)ジョブを実行したユーザーのプリンシパル ID。 |
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 | +-------------------------------------------------------------------------+