INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES 뷰에는 관리 프로젝트 내 용량 약정의 모든 변경사항에 대한 거의 실시간 목록이 포함됩니다. 각 행은 단일 용량 약정에 대한 단일 변경사항을 나타냅니다.
예약에 대한 자세한 내용은 약정을 참조하세요.
필요한 권한
INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES 뷰를 쿼리하려면 프로젝트에 대한 bigquery.capacityCommitments.list Identity and Access Management(IAM) 권한이 필요합니다.
사전 정의된 다음 IAM 역할에는 각각 필수 권한이 포함되어 있습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-26(UTC)"],[[["\u003cp\u003eThe \u003ccode\u003eINFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES\u003c/code\u003e view provides a real-time record of all changes made to capacity commitments within an administration project, with each row detailing a single change.\u003c/p\u003e\n"],["\u003cp\u003eQuerying this view requires the \u003ccode\u003ebigquery.capacityCommitments.list\u003c/code\u003e IAM permission, which is included in roles such as \u003ccode\u003eroles/bigquery.resourceAdmin\u003c/code\u003e, \u003ccode\u003eroles/bigquery.resourceEditor\u003c/code\u003e, \u003ccode\u003eroles/bigquery.resourceViewer\u003c/code\u003e, \u003ccode\u003eroles/bigquery.user\u003c/code\u003e, and \u003ccode\u003eroles/bigquery.admin\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eEach entry in the view includes details like the \u003ccode\u003echange_timestamp\u003c/code\u003e, \u003ccode\u003eproject_id\u003c/code\u003e, \u003ccode\u003ecapacity_commitment_id\u003c/code\u003e, \u003ccode\u003ecommitment_plan\u003c/code\u003e, \u003ccode\u003estate\u003c/code\u003e, \u003ccode\u003eslot_count\u003c/code\u003e, \u003ccode\u003eaction\u003c/code\u003e, and the \u003ccode\u003euser_email\u003c/code\u003e that initiated the change.\u003c/p\u003e\n"],["\u003cp\u003eThe data in this view is retained for a maximum of 41 days after a capacity commitment is deleted, after which it is permanently removed from the view.\u003c/p\u003e\n"],["\u003cp\u003eQueries against this view must include a region qualifier, and the location of the query execution must match the region of the \u003ccode\u003eINFORMATION_SCHEMA\u003c/code\u003e view.\u003c/p\u003e\n"]]],[],null,["# CAPACITY_COMMITMENT_CHANGES view\n================================\n\nThe `INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES` view contains a near\nreal-time list of all changes to capacity commitments within the administration\nproject. Each row represents a single change to a single capacity commitment.\nFor more information, see [Slot commitments](/bigquery/docs/reservations-workload-management#slot_commitments).\n\nRequired permission\n-------------------\n\nTo query the `INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES` view,\nyou need the `bigquery.capacityCommitments.list` Identity and Access Management (IAM)\npermission for the project.\nEach of the following predefined IAM roles includes the required\npermission:\n\n- `roles/bigquery.resourceAdmin`\n- `roles/bigquery.resourceEditor`\n- `roles/bigquery.resourceViewer`\n- `roles/bigquery.user`\n- `roles/bigquery.admin`\n\nFor more information about BigQuery permissions, see\n[Access control with IAM](/bigquery/docs/access-control).\n\nSchema\n------\n\nThe `INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES` view has the\nfollowing schema:\n\nData retention\n--------------\n\nThis view contains current capacity commitments and the deleted capacity\ncommitments that are kept for a maximum of 41 days after which they are removed\nfrom the view.\n\nScope and syntax\n----------------\n\nQueries against this view must include a [region qualifier](/bigquery/docs/information-schema-intro#syntax).\nIf you do not specify a regional qualifier, metadata is retrieved from all\nregions. The following table explains the region scope for this view:\n\nReplace the following:\n\n- Optional: \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: the ID of your Google Cloud project. If not specified, the default project is used.\n- \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e: any [dataset region name](/bigquery/docs/locations). For example, ```region-us```.\n\n \u003cbr /\u003e\n\n \u003cbr /\u003e\n\n | **Note:** You must use [a region qualifier](/bigquery/docs/information-schema-intro#region_qualifier) to query `INFORMATION_SCHEMA` views. The location of the query execution must match the region of the `INFORMATION_SCHEMA` view.\n\n\u003cbr /\u003e\n\nExample\n-------\n\nThe following query displays the user who has made the latest capacity commitment\nupdate to the current project within the specified date. \n\n```googlesql\nSELECT\n user_email,\n change_timestamp\nFROM\n `region-us`.INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES\nWHERE\n change_timestamp BETWEEN '2021-09-30' AND '2021-10-01'\nORDER BY\n change_timestamp DESC\nLIMIT 1;\n```\n\nThe result is similar to the following: \n\n```\n+--------------------------------+-------------------------+\n| user_email | change_timestamp |\n+--------------------------------+-------------------------+\n| 222larabrown@gmail.com | 2021-09-30 09:30:00 UTC |\n+--------------------------------+-------------------------+\n\n```"]]
