Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O Spanner Data Boost está sujeito a cotas que limitam o número de execuções simultâneas de chamadas
ExecuteStreamingSQL e StreamingRead por projeto e por
região. Quando o número de solicitações simultâneas excede a cota, as solicitações falham
com erros RESOURCE EXHAUSTED.
Verificar sua cota
Para verificar a cota de simultaneidade no seu projeto, siga estas etapas:
Se o Metrics Explorer aparecer no menu de navegação, selecione-o.
Caso contrário, clique em Recursos e selecione Metrics Explorer.
Na parte de cima da página, selecione um intervalo de tempo.
Na lista suspensa Métrica, no campo Filtrar por nome de recurso ou métrica, digite consumer e pressione Enter para restringir a pesquisa.
Na lista, selecione Cota do consumidor > Cota > Uso de cota simultânea
e clique em Aplicar.
Clique em + ADICIONAR FILTRO para criar um filtro.
Na lista suspensa Rótulo 1, selecione quota_metric.
No campo de texto Valor 1, digite ou selecione
spanner.googleapis.com/data_boost_quota.
O Metrics Explorer mostra um gráfico de linhas do uso da cota por região.
Opcional: em Exibição, para Tipo de widget, selecione Gráfico de barras empilhadas.
Monitorar erros de cota
Para monitorar erros de cota, siga estas etapas:
No Metrics Explorer, selecione a métrica
Consumer Quota > Quota > Quota exceeded error.
Adicione um filtro para quota_metric igual a spanner.googleapis.com/data_boost_quota.
Definir um alerta para o uso do Data Boost
É possível criar uma política de alerta que notifica você quando o número de consultas particionadas simultâneas que solicitam o Data Boost (chamadas simultâneas de ExecuteStreamingSQL e StreamingRead) por projeto e região excede um determinado limite. Para fazer isso,
siga estas etapas:
Na lista suspensa Selecione uma métrica, no campo Filtrar por nome de recurso ou métrica, digite data_boost e pressione Enter para restringir a pesquisa.
Na lista Selecionar uma métrica, selecione
Instância do Cloud Spanner > Instância > Unidade de processamento por segundo e clique em
Aplicar.
Continue criando uma política de alertas e defina o limite para uma
porcentagem da cota.
Por exemplo, se a cota padrão for 200 e você quiser receber uma notificação quando o número de solicitações simultâneas atingir 80% do máximo, insira 160 no campo Valor do limite.
Processar erros de cota
Se a taxa de erros de cota excedida for alta, ao usar o Dataflow com o Data Boost, recomendamos ajustar o número máximo de workers no job do Dataflow para evitar exceder a cota do Data Boost. Você também pode solicitar uma cota maior.
Impedir que um principal consuma recursos do Data Boost
Se um titular estiver excedendo consistentemente a quantidade de recursos do Data Boost que pode ser razoavelmente esperada, você poderá bloquear o uso de recursos do Data Boost revogando a permissão de gerenciamento de identidade e acesso (IAM) spanner.databases.useDataBoost do titular. É possível automatizar a revogação
da permissão configurando o canal de notificação de um alerta como um webhook que
invoque uma função do Cloud. Para mais informações, consulte os tópicos a seguir:
[[["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-11 UTC."],[],[],null,["# Monitor and manage Data Boost quota usage\n\n\u003cbr /\u003e\n\nSpanner Data Boost is subject to quotas that limit the number of concurrent\n`ExecuteStreamingSQL` and `StreamingRead` calls executing per project and per\nregion. When the number of concurrent requests exceeds the quota, requests fail\nwith `RESOURCE EXHAUSTED` errors.\n\nCheck your quota\n----------------\n\nTo check the concurrency quota in your project, follow these steps:\n\n1. Go to the Quotas page in the Google Cloud console.\n\n [Go to Quotas](https://console.cloud.google.com/iam-admin/quotas)\n2. In the **Filter** field, enter `databoost`. Then, in the list, select\n **DataBoostQuotaPerProjectPerRegion**.\n\n3. In the resulting table, locate your region and view the limit for that\n region.\n\n| **Note:** To check the default quota for regions, select **DataBoost Operations per\n| region (default)** instead.\n\nMonitor quota usage\n-------------------\n\nTo monitor your quota usage, follow these steps:\n\n1. In the Google Cloud console, go to **Monitoring** . \n [Go to Monitoring](https://console.cloud.google.com/monitoring)\n2. If **Metrics Explorer** is shown in the navigation menu, select it. Otherwise, click **Resources** , and then select **Metrics Explorer**.\n3. At the top of the page, select a time interval.\n4. In the **Metric** dropdown list, in the **Filter by resource or metric\n name** field, enter `consumer` and press `Enter` to narrow the search.\n5. In the list, select **Consumer Quota \\\u003e Quota \\\u003e Concurrent Quota usage** , and then click **Apply**.\n6. Click **+ ADD FILTER** to create a filter.\n7. In the **Label 1** dropdown list, select **quota_metric**.\n8. In the **Value 1** text field, enter or select\n **spanner.googleapis.com/data_boost_quota**.\n\n Metrics explorer shows a line chart of quota usage by region.\n9. Optional: Under **Display** , for **Widget type** , select **Stacked bar chart**.\n\nMonitor quota errors\n--------------------\n\nTo monitor quota errors, follow these steps:\n\n1. In Metrics explorer, select the metric\n **Consumer Quota \\\u003e Quota \\\u003e Quota exceeded error**.\n\n2. Add a filter for **quota_metric** equals\n **spanner.googleapis.com/data_boost_quota**.\n\nSet an alert for Data Boost usage\n---------------------------------\n\nYou can create an alert policy that notifies you when the number of concurrent\n[partitioned queries](/spanner/docs/reads#read_data_in_parallel) that request\nData Boost (concurrent `ExecuteStreamingSQL` and `StreamingRead`\ncalls) per project and per region exceeds a particular threshold. To do so,\nfollow these steps:\n\n1. Follow the instructions in [Create metric-threshold alerting policies](https://cloud.google.com/monitoring/alerts/using-alerting-ui).\n2. In the **Select a metric** dropdown list, in the **Filter by resource or\n metric name** field, enter `data_boost` and press `Enter` to narrow the search.\n3. In the **Select a metric** list, select **Cloud Spanner Instance \\\u003e Instance \\\u003e Processing Unit Second** , and then click **Apply**.\n4. Continue with creating an alert policy and set the threshold to some\n percentage of the quota.\n\n For example if the default quota is 200 and you want to be notified when the\n number of concurrent requests reaches 80% of maximum, enter 160 in the\n **Threshold value** field.\n\nHandle quota errors\n-------------------\n\nIf the rate of quota-exceeded errors is high, when using Dataflow with\nData Boost, we recommend that you adjust the maximum number of\nworkers in your Dataflow job to avoid exceeding the\nData Boost quota. You can also apply for a higher quota.\n\nBlock a principal from consuming Data Boost resources\n-----------------------------------------------------\n\nIf one principal is consistently exceeding the amount of\nData Boost resources that they can be reasonably expected to\nconsume, you can block the principal from using Data Boost\nresources by revoking the `spanner.databases.useDataBoost` Identity and Access Management\n(IAM) permission from the principal. You can automate revoking\nthe permission by configuring an alert's notification channel as a webhook that\ninvokes a Cloud Function. For more information, see the following topics:\n\n- [Create a notification channel](https://cloud.google.com/monitoring/support/notification-options#creating_channels)\n- [Cloud Functions](https://cloud.google.com/functions)\n- [Remove database-level permissions](https://cloud.google.com/spanner/docs/grant-permissions#remove-iam-db-role)\n- [Modify the allow policy](https://cloud.google.com/iam/docs/granting-changing-revoking-access#modifying-policy)\n for sample code that revokes a role.\n\n | **Note:** A best practice is to add the `spanner.databases.useDataBoost` permission to a custom IAM role.\n\nWhat's next\n-----------\n\n- Learn about Data Boost in [Data Boost overview](/spanner/docs/databoost/databoost-overview)."]]
