설정할 수 있는 BigQuery 할당량에 대한 자세한 내용은 할당량 및 한도를 참고하세요.
필요한 역할
할당량을 변경하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트의 할당량 관리자(role/servicemanagement.quotaAdmin) IAM 역할을 부여해 달라고 요청하세요.
역할 부여에 대한 상세 설명은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
이 사전 정의된 역할에는 할당량을 변경하는 데 필요한 serviceusage.quotas.update 권한이 포함되어 있습니다.
Google Cloud 콘솔의 할당량 및 시스템 한도 페이지에 표시된 모든 할당량에 대해 커스텀 할당량을 설정하거나 기존 커스텀 할당량을 수정할 수 있습니다. 더 낮은 할당량을 요청하면 변경사항이 몇 분 이내에 적용됩니다. 할당량 상향 조정을 요청하면 승인 프로세스를 거치게 되며, 시간이 더 걸릴 수 있습니다. 자세한 내용은 할당량 조정 요청을 참조하세요.
매일 처리할 수 있는 BigQuery 데이터 양을 제한하는 등 맞춤 비용 관리를 설정하거나 업데이트하려면 다음 단계를 따르세요.
Google Cloud 콘솔에서 IAM 및 관리자>할당량 및 시스템 한도 페이지를 엽니다.
조정하려는 할당량을 선택합니다. 예를 들어 프로젝트 수준과 사용자 수준 모두에서 하루에 쿼리할 수 있는 데이터 양을 제한하려면 일일 쿼리 사용량과 사용자당 일일 쿼리 사용량을 선택합니다. 목록을 페이지로 나누어 찾아야 할 수도 있습니다. 할당량을 선택하면 툴바가 표시됩니다.
Custom quota exceeded: Your usage exceeded the custom quota for
QueryUsagePerDay, which is set by your administrator. For more information,
see https://cloud.google.com/bigquery/cost-controls
사용자가 사용자 수준의 커스텀 할당량을 초과하면 BigQuery가 다른 오류 메시지와 함께 usageQuotaExceeded 오류를 반환합니다.
Custom quota exceeded: Your usage exceeded the custom quota for
QueryUsagePerUserPerDay, which is set by your administrator. For more
information, see https://cloud.google.com/bigquery/cost-controls
데이터 세트 액세스 권한이 있다면 커스텀 할당량이 없거나 아직 할당량을 초과하지 않은 다른 프로젝트에서 쿼리를 실행할 수 있습니다.
예
사용자가 10명이며 그 중 하나가 서비스 계정인 프로젝트에 다음 커스텀 할당량을 설정한다고 가정해 보겠습니다.
프로젝트 수준: 일일 50TB
사용자 수준: 일일 10TB
프로젝트 수준의 커스텀 할당량은 해당 프로젝트에서 모든 사용자의 총 사용량을 제한합니다. 사용자 수준의 커스텀 할당량은 프로젝트 내의 각 사용자나 서비스 계정에 개별적으로 적용됩니다.
다음 표에서는 사용자 10명이 하루 동안 쿼리를 실행할 때 남아 있는 할당량을 설명합니다.
사용
남아 있는 할당량
사용자 10명이 각각 4TB씩 쿼리
프로젝트 수준: 10TB가 남아 있습니다. 사용자 수준: 사용자당 6TB가 남아 있지만 남아 있는 할당량의 합계는 최대 10TB뿐입니다.
서비스 계정에서 6TB를 더 쿼리
프로젝트 수준: 4TB가 남아 있습니다. 사용자 수준: 서비스 계정에서 더 이상 BigQuery를 사용할 수 없습니다. 다른 사용자는 사용자당 6TB가 남아 있지만 남아 있는 할당량의 합계는 최대 4TB뿐입니다.
다른 사용자 1명이 4TB를 더 쿼리
프로젝트 수준: 0TB가 남아 있습니다. 사용자 수준: 사용자별로 다양한 크기가 남아 있지만 프로젝트 수준의 할당량을 초과했으므로 아무도 BigQuery를 사용할 수 없습니다.
남아 있는 할당량이 없으면 해당 프로젝트의 모든 사용자가 BigQuery를 사용할 수 없습니다.
[[["이해하기 쉬움","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-19(UTC)"],[[["\u003cp\u003eCustom query quotas in BigQuery allow you to manage costs by setting limits on the amount of data processed daily, either at the project level (\u003ccode\u003eQueryUsagePerDay\u003c/code\u003e) or at the user level (\u003ccode\u003eQueryUsagePerUserPerDay\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eProject-level quotas limit the aggregate usage of all users within a project, while user-level quotas apply separately to each user and service account.\u003c/p\u003e\n"],["\u003cp\u003eSetting a custom quota is proactive, meaning that exceeding the limit will halt queries and return an error, preventing further processing.\u003c/p\u003e\n"],["\u003cp\u003eTo modify quotas, users need the \u003ccode\u003eQuota Administrator\u003c/code\u003e IAM role, which includes the \u003ccode\u003eserviceusage.quotas.update\u003c/code\u003e permission.\u003c/p\u003e\n"],["\u003cp\u003eCustom quotas are approximate and are not intended as strict limits; they can be viewed and managed on the Google Cloud console's Quotas page.\u003c/p\u003e\n"]]],[],null,["# Create custom query quotas\n==========================\n\nThis document describes how to set or modify custom query quotas to control costs.\nTo learn how BigQuery analysts can estimate and control costs,\nsee [Estimate and control costs](/bigquery/docs/best-practices-costs).\n\nIf you have multiple BigQuery projects and users, you can\nmanage costs by requesting a custom quota that specifies a limit on the amount\nof data processed per day. Daily quotas are reset at midnight Pacific Time.\n\nCustom quota is proactive, so you can't run an 11 TB query\nif you have a 10 TB quota. Creating a custom quota on processed data lets you\ncontrol costs at the project level or at the user level.\n\nTo set custom cost controls, you can update one or both of the following\nquery quotas:\n\n- `QueryUsagePerDay`: Project-level custom quotas limit the aggregate usage of all users in that\n project.\n\n- `QueryUsagePerUserPerDay`: User-level custom quota is separately applied to all users and\n [service accounts](/docs/authentication#user_accounts_and_service_accounts)\n within a project.\n\n| **Note:** You can't assign a custom quota to an individual user or service account.\n| **Important:** Starting September 1, 2025, the default limit for the `QueryUsagePerDay` quota will change from unlimited to 200 Tebibytes (TiB) of data processed per project per day. The default limit for the `QueryUsagePerUserPerDay` is and will remain unlimited. You can [change the limits](#set-custom-quotas) anytime - custom overrides supersede the default limits.\n\nQuery usage quotas apply only to the\n[on-demand query pricing model](/bigquery/pricing#on_demand_pricing).\n\nFor more information about BigQuery quotas that you can set, see\n[Quotas and limits](/bigquery/quotas).\n\nRequired role\n-------------\n\n\nTo get the permission that\nyou need to change your quota,\n\nask your administrator to grant you the\n\n\nQuota Administrator (`role/servicemanagement.quotaAdmin`)\nIAM role on your project.\n\n\nFor more information about granting roles, see [Manage access to projects, folders, and organizations](/iam/docs/granting-changing-revoking-access).\n\n\nThis predefined role contains the\n` serviceusage.quotas.update`\npermission,\nwhich is required to\nchange your quota.\n\n\nYou might also be able to get\nthis permission\nwith [custom roles](/iam/docs/creating-custom-roles) or\nother [predefined roles](/iam/docs/roles-overview#predefined).\n\nSet or modify custom quotas\n---------------------------\n\nYou can set a custom quota or modify an existing custom quota for any quota\ndisplayed on the **Quotas \\& System Limits** page of the Google Cloud console. When\nyou request a lower quota, the change takes effect within a few minutes. If you\nrequest a higher quota, your request goes through an approval process, which can\ntake more time. For more information, see [Request a quota\nadjustment](/docs/quotas/help/request_increase).\n| **Note:** Custom quotas are approximate. The custom quotas feature provides an additional safeguard against excessive spending, but is not designed to strictly limit bytes processed. BigQuery might occasionally run a query that exceeds a quota. For greater price consistency, consider a [reservation](/bigquery/docs/reservations-intro).\n\nTo set or update a custom cost control, such as limiting the amount of\nBigQuery data that can be processed each day, do the following:\n\n1. In the Google Cloud console, open the\n **IAM \\& Admin** \\\u003e **Quotas \\& System Limits** page:\n\n [Go to Quotas \\& System Limits](https://console.cloud.google.com/iam-admin/quotas)\n2. Use the **Service** filter in the **Filter** search box to filter for the\n BigQuery API.\n\n3. Select the quotas that you want to adjust. For example, to limit the\n amount of data that be queried per day at both the project level and\n user level, select **Query usage per day** and **Query usage per day\n per user**. You might need to page through the list to find them. After\n you select a quota, a toolbar appears.\n\n4. In the toolbar, click edit **Edit** .\n The **Quota changes** dialog opens.\n\n5. If **Unlimited** is selected, deselect it.\n\n6. Enter the quota value in TiB that you want in the **New value** field.\n\n7. Click **Done**.\n\n8. Click **Submit request**.\n\nFor more information about viewing and managing quotas, see\n[View and manage quotas](/docs/quotas/view-manage).\n\nReturned error messages\n-----------------------\n\nAfter you set a custom quota, BigQuery returns an error when you\nexceed it:\n\n- If you exceed a project-level custom quota, BigQuery returns\n the [`usageQuotaExceeded`](/bigquery/troubleshooting-errors#quotaExceeded)\n error:\n\n ```\n Custom quota exceeded: Your usage exceeded the custom quota for\n QueryUsagePerDay, which is set by your administrator. For more information,\n see https://cloud.google.com/bigquery/cost-controls\n ```\n- If the user exceeds a user-level custom quota, BigQuery returns\n a [`usageQuotaExceeded`](/bigquery/troubleshooting-errors#quotaExceeded)\n error with a different error message:\n\n ```\n Custom quota exceeded: Your usage exceeded the custom quota for\n QueryUsagePerUserPerDay, which is set by your administrator. For more\n information, see https://cloud.google.com/bigquery/cost-controls\n ```\n\nYou can run your query from another project that has access to your datasets\nand that doesn't have a custom quota or hasn't yet exceeded it.\n\nExample\n-------\n\nSuppose you set the following custom quotas for a project with 10 users,\none of which is a service account:\n\n- Project level: 50 TB per day\n- User level: 10 TB per day\n\nProject-level custom quotas limit the aggregate usage of all users in that\nproject. User-level custom quotas are separately applied to each user or\n[service account](/docs/authentication#user_accounts_and_service_accounts)\nwithin a project.\n\nThe following table describes the remaining quota as the 10 users\nrun queries throughout the day.\n\nWith no remaining quota, BigQuery stops working for everyone in\nthat project.\n| **Note:** Custom quotas are **not** enabled by default. To set custom quotas, see [Set or modify custom quotas](#set-custom-quotas).\n\nWhat's next\n-----------\n\n- Learn about [BigQuery pricing](/bigquery/pricing).\n- Learn how to [estimate and control costs](/bigquery/docs/best-practices-costs).\n- Learn how to analyze [BigQuery audit logs](/bigquery/docs/introduction-audit-workloads) to monitor query costs and BigQuery usage.\n- To learn about billing, alerts, and visualizing data, see the following topics:\n\n - [Create, edit, or delete budgets and budget alerts](/billing/docs/how-to/budgets)\n - [Export Cloud Billing data to BigQuery](/billing/docs/how-to/export-data-bigquery)\n - [Visualize your costs with Looker Studio](/billing/docs/how-to/visualize-data)"]]
