Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Visualização de CAPACITY_COMMITMENT_CHANGES
A visualização INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES contém uma lista quase
em tempo real de todas as alterações nos compromissos de capacidade no projeto de
administração. Cada linha representa uma única alteração em um único compromisso de capacidade.
Para mais informações sobre reserva, consulte Compromissos.
Permissão necessária
Para consultar a visualização INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES, é preciso ter a permissão bigquery.capacityCommitments.list Identity and Access Management (IAM) para o
projeto.
Cada um dos seguintes papéis predefinidos do IAM inclui a
permissão necessária:
A visualização INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES tem o seguinte esquema:
Nome da coluna
Tipo de dados
Valor
change_timestamp
TIMESTAMP
Horário em que a alteração ocorreu.
project_id
STRING
ID do projeto de administração.
project_number
INTEGER
Número do projeto de administração.
capacity_commitment_id
STRING
Código que identifica exclusivamente o compromisso de capacidade.
commitment_plan
STRING
Plano de compromisso do compromisso de capacidade.
state
STRING
Indique o compromisso de capacidade. Pode ser PENDING ou ACTIVE.
slot_count
INTEGER
Contagem de slots associada ao compromisso de capacidade.
action
STRING
Tipo de evento que ocorreu com o compromisso de capacidade. Pode ser CREATE, UPDATE ou DELETE.
user_email
STRING
Endereço de e-mail do usuário ou usuário da federação de identidade da força de trabalho que fez a alteração. google para alterações feitas pelo Google. NULL se o endereço de e-mail for desconhecido.
commitment_start_time
TIMESTAMP
O início do período de compromisso atual. Aplicável apenas a compromissos de capacidade ACTIVE. Caso contrário, será NULL.
commitment_end_time
TIMESTAMP
O fim do período de compromisso atual. Aplicável apenas a compromissos de capacidade ACTIVE. Caso contrário, será NULL.
failure_status
RECORD
Para um plano de compromisso FAILED, fornece o motivo da falha. Caso contrário, será NULL. RECORD consiste em code e message.
renewal_plan
STRING
O plano no qual esse compromisso de capacidade é convertido após o commitment_end_time passar. Depois que o plano é alterado, o período do compromisso é estendido de acordo com o respectivo plano. Aplicável apenas a compromissos ANNUAL e TRIAL. Caso contrário, será NULL.
Se o compromisso está associado ao modelo de capacidade de taxa fixa legado ou a uma edição. Se for FALSE, o compromisso atual será associado a uma edição. Se for TRUE, o compromisso será o modelo de capacidade de taxa fixa legado.
Retenção de dados
Essa visualização contém os compromissos de capacidade atuais e os compromissos de capacidade
excluídos que são mantidos por até 41 dias após o qual são removidos
da visualização.
Escopo e sintaxe
As consultas nessa visualização precisam incluir um
qualificador de região.
Se você não especificar um qualificador regional, os metadados serão recuperados de todas as
regiões. A tabela a seguir explica o escopo da região dessa visualização:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-17 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```"]]
