<budget_name>!GET_BUDGET_SCOPE

:doc:`사용자 지정 예산 </user-guide/budgets>`에 추가된 리소스와 태그를 반환합니다. 예산에서 추적하는 리소스 사용량을 결정하는 데 도움이 됩니다.

목록에는 다음이 포함되지 않습니다.

  • 자동으로 추가된 오브젝트(예: |native-app|이 생성하고 소유한 컴퓨팅 풀 및 웨어하우스).

  • 태그가 예산에 추가될 때 추가된 오브젝트.

구문

<budget_name>!GET_BUDGET_SCOPE()

반환

이 메서드는 다음 키가 있는 JSON 오브젝트를 반환합니다.

resource_tags

예산에 추가된 리소스 태그입니다. 이러한 태그가 지정된 리소스는 예산에 속합니다. 다음 필드를 포함합니다.

operator

리소스 태그에 사용되는 일치 논리입니다. 다음 값 중 하나일 수 있습니다.

  • UNION: tags 배열에 있는 태그-값 페어 중 *하나*에 태그가 지정된 리소스는 예산에 포함됩니다.

  • INTERSECTION: 리소스가 예산에 포함되려면 tags 배열에 있는 모든 태그-값 페어에 태그가 지정되어야 합니다.

tags

각각 다음 필드가 있는 태그 오브젝트의 배열입니다.

tagId

태그의 내부 식별자입니다.

tagDatabase

태그가 포함된 데이터베이스입니다.

tagSchema

태그가 포함된 스키마입니다.

tagName

태그의 이름입니다.

tagValues

태그와 연결된 태그 값의 배열입니다.

resources

예산에 직접 추가된 리소스의 배열입니다. 각 오브젝트에 포함된 필드는 다음과 같습니다.

resourceId

리소스의 내부 식별자입니다.

resourceName

리소스의 이름입니다.

resourceDomain

리소스의 도메인(예: WAREHOUSE, DATABASE, TABLE)입니다.

schemaName

리소스가 포함된 스키마입니다.

databaseName

리소스가 포함된 데이터베이스입니다.

액세스 제어 요구 사항

사용자 지정 예산 결과를 보려면 다음과 같은 최소 권한과 역할이 필요합니다.

  • 예산 인스턴스에 대한 ADMIN 인스턴스 역할.

  • 예산 인스턴스가 포함된 데이터베이스와 스키마에 대한 USAGE 권한이 부여된 역할.

자세한 내용은 예산 역할 및 권한 섹션을 참조하십시오.

사용법 노트

  • 이 메서드는 사용자 지정 예산 인스턴스에서만 호출할 수 있습니다.

  • 이 메서드를 호출해도 오브젝트는 반환되지 않습니다. 이로 인해, 메서드 연결을 사용하여 이 메서드의 반환값으로 다른 메서드를 호출할 수 없습니다. 대신, 별도의 SQL 문에서 각 메서드를 호출합니다.

예

budget_db.budget_schema.my_budget 예산에 추가된 모든 리소스와 태그를 가져옵니다.

CALL budget_db.budget_schema.my_budget!GET_BUDGET_SCOPE();