커스텀 쿼리 할당량 만들기

이 문서에서는 비용을 관리하기 위해 커스텀 쿼리 할당량을 설정 또는 수정하는 방법을 설명합니다. BigQuery 분석가가 비용을 추정하고 관리하는 방법을 알아보려면 비용 추정 및 관리를 참조하세요.

BigQuery 프로젝트와 사용자의 수가 많은 경우에는 커스텀 할당량을 요청하여 하루에 처리되는 데이터 처리 양의 한도를 지정하여 비용을 관리할 수 있습니다. 일일 할당량은 태평양 표준시 자정에 재설정됩니다.

커스텀 할당량은 사전에 적용되므로 할당량이 10TB인 경우 11TB 쿼리를 실행할 수 없습니다. 처리된 데이터에 커스텀 할당량을 만들면 프로젝트 수준이나 사용자 수준에서 비용을 관리할 수 있습니다.

맞춤 비용 관리를 설정하려면 다음 쿼리 할당량 중 하나 또는 둘 다를 업데이트하면 됩니다.

  • QueryUsagePerDay: 프로젝트 수준의 커스텀 할당량은 해당 프로젝트에서 모든 사용자의 총 사용량을 제한합니다.

  • QueryUsagePerUserPerDay: 사용자 수준의 커스텀 할당량은 프로젝트 내의 모든 사용자와 서비스 계정에 별도로 적용됩니다. 사용자별 한도와 관계없이 프로젝트의 모든 사용자의 총 사용량은 일일 쿼리 사용량 한도를 초과할 수 없습니다.

QueryUsagePerDay 할당량의 기본 한도는 프로젝트당 하루에 처리되는 데이터 200테비바이트 (TiB)입니다. QueryUsagePerUserPerDay의 기본 한도는 무제한입니다. 현재 한도를 확인하려면 할당량 페이지를 참조하세요. 언제든지 한도를 변경할 수 있습니다. 맞춤 재정의가 기본 한도를 대체합니다.

쿼리 사용량 할당량은 주문형 쿼리 가격 책정 모델에만 적용됩니다.

설정할 수 있는 BigQuery 할당량에 대한 자세한 내용은 할당량 및 한도를 참고하세요.

필요한 역할

할당량을 변경하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트의 할당량 관리자 (role/servicemanagement.quotaAdmin) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 상세 설명은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 할당량을 변경하는 데 필요한 serviceusage.quotas.update 권한이 포함되어 있습니다.

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

커스텀 할당량 설정 또는 수정

Google Cloud 콘솔의 할당량 및 시스템 한도 페이지에 표시된 모든 할당량에 대해 커스텀 할당량을 설정하거나 기존 커스텀 할당량을 수정할 수 있습니다. 더 낮은 할당량을 요청하면 변경사항이 몇 분 이내에 적용됩니다. 할당량 상향 조정을 요청하면 승인 프로세스를 거치게 되며, 시간이 더 걸릴 수 있습니다. 자세한 내용은 할당량 조정 요청을 참조하세요.

매일 처리할 수 있는 BigQuery 데이터 양을 제한하는 등 맞춤 비용 관리를 설정하거나 업데이트하려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔에서 IAM 및 관리자 > 할당량 및 시스템 한도 페이지를 엽니다.

    할당량 및 시스템 한도로 이동

  2. 필터 검색창에서 서비스 필터를 사용하여 BigQuery API를 필터링합니다.

  3. 조정하려는 할당량을 선택합니다. 예를 들어 프로젝트 수준과 사용자 수준 모두에서 하루에 쿼리할 수 있는 데이터 양을 제한하려면 일일 쿼리 사용량과 사용자당 일일 쿼리 사용량을 선택합니다. 목록을 페이지로 나누어 찾아야 할 수도 있습니다. 할당량을 선택하면 툴바가 표시됩니다.

  4. 툴바에서 수정을 클릭합니다. 할당량 변경사항 대화상자가 열립니다.

  5. 무제한이 선택되어 있으면 선택 해제합니다.

  6. 새 값 필드에 원하는 할당량 값을 TiB 단위로 입력합니다.

  7. 완료를 클릭합니다.

  8. 요청 제출을 클릭합니다.

할당량 보기 및 관리에 관한 자세한 내용은 할당량 보기 및 관리를 참조하세요.

반환된 오류 메시지

커스텀 할당량을 설정한 후에 할당량을 초과하면 BigQuery가 quotaExceeded 오류를 반환합니다. 메시지에는 초과한 할당량의 이름이 표시됩니다. 프로젝트 수준 커스텀 할당량의 경우 QueryUsagePerDay, 사용자 수준 커스텀 할당량의 경우 QueryUsagePerUserPerDay입니다.

  • Custom quota exceeded: Your usage exceeded the custom quota for QueryUsagePerDay, which is set by your administrator.
  • Custom quota exceeded: Your usage exceeded the custom quota for QueryUsagePerUserPerDay, which is set by your administrator.

이러한 오류를 진단하고 해결하려면 커스텀 일일 쿼리 할당량 오류 문제 해결을 참조하세요.

예

사용자가 10명이며 그 중 하나가 서비스 계정인 프로젝트에 다음 커스텀 할당량을 설정한다고 가정해 보겠습니다.

  • 프로젝트 수준: 일일 50TB
  • 사용자 수준: 일일 10TB

프로젝트 수준의 커스텀 할당량은 해당 프로젝트에서 모든 사용자의 총 사용량을 제한합니다. 사용자 수준의 커스텀 할당량은 프로젝트 내의 각 사용자나 서비스 계정에 개별적으로 적용됩니다.

다음 표에서는 사용자 10명이 하루 동안 쿼리를 실행할 때 남아 있는 할당량을 설명합니다.

사용량 남아 있는 할당량
사용자 10명이 각각 4TB씩 쿼리 프로젝트 수준: 10TB가 남아 있습니다.
사용자 수준: 사용자당 6TB가 남아 있지만 남아 있는 할당량의 합계는 최대 10TB뿐입니다.
서비스 계정에서 6TB를 더 쿼리 프로젝트 수준: 4TB가 남아 있습니다.
사용자 수준: 서비스 계정에서 더 이상 BigQuery를 사용할 수 없습니다. 다른 사용자는 사용자당 6TB가 남아 있지만 남아 있는 할당량의 합계는 최대 4TB뿐입니다.
다른 사용자 1명이 4TB를 더 쿼리 프로젝트 수준: 0TB가 남아 있습니다.
사용자 수준: 사용자별로 다양한 크기가 남아 있지만 프로젝트 수준의 할당량을 초과했으므로 아무도 BigQuery를 사용할 수 없습니다.

남아 있는 할당량이 없으면 해당 프로젝트의 모든 사용자가 BigQuery를 사용할 수 없습니다.

다음 단계