ASSIGNMENT_CHANGES ビュー
INFORMATION_SCHEMA.ASSIGNMENT_CHANGES
ビューには、管理プロジェクト内の割り当てに対するすべての変更を準リアルタイムで示すリストが含まれます。各行は 1 つの割り当てに対する 1 つの変更を表します。予約の詳細については、予約の概要をご覧ください。
必要な権限
INFORMATION_SCHEMA.ASSIGNMENT_CHANGES
ビューをクエリするには、プロジェクトの bigquery.reservationAssignments.list
Identity and Access Management(IAM)権限が必要です。次に示す各 IAM の事前定義ロールには、必要な権限が含まれています。
roles/bigquery.resourceAdmin
roles/bigquery.resourceEditor
roles/bigquery.resourceViewer
roles/bigquery.user
roles/bigquery.admin
BigQuery の権限の詳細については、IAM でのアクセス制御をご覧ください。
スキーマ
INFORMATION_SCHEMA.ASSIGNMENT_CHANGES
ビューのスキーマは次のとおりです。
列名 | データ型 | 値 |
---|---|---|
change_timestamp |
TIMESTAMP |
変更が発生した時刻。 |
project_id |
STRING |
管理プロジェクトの ID。 |
project_number |
INTEGER |
管理プロジェクトの番号。 |
assignment_id |
STRING |
割り当てを一意に識別する ID。 |
reservation_name |
STRING |
割り当てが使用する予約の名前。 |
job_type |
STRING |
予約に使用できるジョブの種類。PIPELINE または QUERY のいずれかです。 |
assignee_id |
STRING |
割り当て先リソースを一意に識別する ID。 |
assignee_number |
INTEGER |
割り当て先リソースを一意に識別する番号。 |
assignee_type |
STRING |
割り当て先リソースの種類。organization 、folder 、project のいずれかです。 |
action |
STRING |
割り当てで発生したイベントの種類。CREATE 、UPDATE 、または DELETE のいずれかです。 |
user_email |
STRING |
変更を行ったユーザーまたは Workforce Identity 連携のサブジェクトのメールアドレス。Google による変更の場合は google 。メールアドレスが不明な場合は NULL 。 |
state |
STRING |
割り当てのステータス。PENDING または ACTIVE のいずれかです。 |
データの保持
このビューには、現在の割り当てと、削除された割り当てが最大 41 日間保持された後、ビューから削除されます。
スコープと構文
このビューに対するクエリでは、リージョン修飾子を指定する必要があります。リージョン修飾子を指定しない場合、メタデータはすべてのリージョンで取得されます。次の表で、このビューのリージョン スコープを説明します。
ビュー名 | リソース スコープ | リージョン スコープ |
---|---|---|
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.ASSIGNMENT_CHANGES[_BY_PROJECT] |
プロジェクト レベル | REGION |
- 省略可:
PROJECT_ID
: Google Cloud プロジェクトの ID。指定しない場合は、デフォルトのプロジェクトが使用されます。
REGION
: 任意のデータセット リージョン名。
例: region-us
。
例
次の例では、特定の割り当てに対して指定された日付までに最新の割り当て更新を行ったユーザーを表示します。
SELECT user_email, change_timestamp, reservation_name, assignment_id FROM `region-us`.INFORMATION_SCHEMA.ASSIGNMENT_CHANGES WHERE change_timestamp BETWEEN '2021-09-30' AND '2021-10-01' AND assignment_id = 'assignment_01' ORDER BY change_timestamp DESC LIMIT 1;
次のような結果になります。
+--------------------------------+-----------------------+--------------------+-----------------+ | user_email | change_timestamp | reservation_name | assignment_id | +--------------------------------+-----------------------+--------------------+-----------------+ | cloudysanfrancisco@gmail.com |2021-09-30 09:30:00 UTC| my_reservation | assignment_01 | +--------------------------------+-----------------------+--------------------+-----------------+