INFORMATION_SCHEMA.CAPACITY_COMMITMENTS 뷰에는 관리 프로젝트 내에 있는 모든 현재 용량 약정에 대한 거의 실시간에 가까운 목록이 포함됩니다. 각 행은 단일 현재 용량 약정을 나타냅니다. 현재 용량 약정이 대기 중이거나 활성 상태이며 삭제되지 않았습니다. 예약에 대한 자세한 내용은 약정을 참고하세요.
필요한 권한
INFORMATION_SCHEMA.CAPACITY_COMMITMENTS 뷰를 쿼리하려면 프로젝트에 대한 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_COMMITMENTS\u003c/code\u003e view provides a real-time list of all current, pending, or active capacity commitments within a specified administration project.\u003c/p\u003e\n"],["\u003cp\u003eQuerying this view requires \u003ccode\u003ebigquery.capacityCommitments.list\u003c/code\u003e IAM permission, which is included in several predefined roles like \u003ccode\u003eroles/bigquery.resourceAdmin\u003c/code\u003e and \u003ccode\u003eroles/bigquery.user\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eEach row in the view represents a single capacity commitment, including details such as its ID, commitment plan, current state (\u003ccode\u003ePENDING\u003c/code\u003e or \u003ccode\u003eACTIVE\u003c/code\u003e), slot count, and associated edition.\u003c/p\u003e\n"],["\u003cp\u003eQueries against the \u003ccode\u003eINFORMATION_SCHEMA.CAPACITY_COMMITMENTS\u003c/code\u003e view must include a region qualifier specifying the dataset region, for example, \u003ccode\u003eregion-us\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eis_flat_rate\u003c/code\u003e column indicates whether the commitment is associated with the legacy flat-rate capacity model (\u003ccode\u003eTRUE\u003c/code\u003e) or an edition (\u003ccode\u003eFALSE\u003c/code\u003e).\u003c/p\u003e\n"]]],[],null,["# CAPACITY_COMMITMENTS view\n=========================\n\nThe `INFORMATION_SCHEMA.CAPACITY_COMMITMENTS` view contains a near real-time\nlist of all current capacity commitments within the administration project. Each\nrow represents a single, current capacity commitment. A current capacity\ncommitment is either pending or active and has not been deleted. For more\ninformation about reservation, see [Slot commitments](/bigquery/docs/reservations-workload-management#slot_commitments).\n\nRequired permission\n-------------------\n\nTo query the `INFORMATION_SCHEMA.CAPACITY_COMMITMENTS` 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_COMMITMENTS` view has the\nfollowing schema:\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 example returns a list of active capacity commitments for the\ncurrent project: \n\n```googlesql\nSELECT\n capacity_commitment_id,\n slot_count\nFROM\n `region-us`.INFORMATION_SCHEMA.CAPACITY_COMMITMENTS\nWHERE\n state = 'ACTIVE';\n```\n\nThe result is similar to the following: \n\n```\n+------------------------+------------+\n| capacity_commitment_id | slot_count |\n+------------------------+------------+\n| my_commitment_05 | 1000 |\n| my_commitment_06 | 1000 |\n| my_commitment_07 | 1500 |\n| my_commitment_08 | 2000 |\n+------------------------+------------+\n```"]]
