<budget_name>!ADD_TAG¶
사용자 지정 예산에 태그를 추가합니다. 태그는 참조 로 추가해야 합니다.
구문¶
<budget_name>!ADD_TAG(
    { '<tag_reference>' | <reference_statement> },
    '<tag_value>')
인자¶
- 'tag_reference'
- 태그로 확인되는 직렬화된 문자열 표현입니다. 이 문자열은 SYSTEM$REFERENCE 함수의 출력입니다. 
- reference_statement
- 예산에 추가할 태그에 대한 참조를 만드는 SYSTEM$REFERENCE 문입니다. 
- 'tag_value'
- 예산에 추가하는 태그의 값입니다. 
반환¶
태그가 예산에 성공적으로 추가되었는지 여부를 나타내는 VARCHAR 값을 반환합니다.
태그를 예산에 추가할 수 없는 경우 이 함수는 오류 메시지를 반환합니다.
액세스 제어 요구 사항¶
사용자 지정 예산에 대해 이 메서드를 호출하려면 다음 권한과 역할이 필요합니다.
- 예산 인스턴스에 대한 ADMIN 인스턴스 역할. 
- 예산 인스턴스가 포함된 데이터베이스와 스키마에 대한 USAGE 권한. 
- 태그가 포함된 데이터베이스 및 스키마에 대한 USAGE 권한. 
- 추가되는 태그에 대한 APPLYBUDGET 권한. 
자세한 내용은 예산 역할 및 권한 섹션을 참조하십시오.
사용법 노트¶
- *사용자 지정 예산*에만 태그를 추가할 수 있습니다. 
- 이 메서드를 호출해도 오브젝트는 반환되지 않습니다. 이로 인해, 메서드 연결을 사용하여 이 메서드의 반환값으로 다른 메서드를 호출할 수 없습니다. 대신, 별도의 SQL 문에서 각 메서드를 호출합니다. 
예¶
- 태그를 추가하기 위해 메서드를 호출하기 전에 태그 참조를 검색합니다.
- 다음 문은 - cost_center태그에 대한 참조를 만들고 반환합니다.- SELECT SYSTEM$REFERENCE( 'TAG', 'cost_mgmt_db.tags.cost_center', 'SESSION', 'APPLYBUDGET'); - 이 문은 출력의 참조를 반환합니다. - ENT_REF_TAG_10382726315710_8A8626AE765E29446C38A217CAD093FCC9A454C2- 다음 문은 이 참조에 대한 문자열 리터럴을 사용하여 - budget_db.budget_schema.my_budget예산에- cost_center = 'sales'태그/값 조합을 추가합니다.- CALL budget_db.budget_schema.my_budget!ADD_TAG( 'ENT_REF_TAG_10382726315710_8A8626AE765E29446C38A217CAD093FCC9A454C2', 'sales'); 
- 인자에 SYSTEM$REFERENCE 함수 직접 포함
- 다음 문을 실행한 후 예산은 태그/값 조합 - team_tag = 'finance'로 태그가 지정된 모든 오브젝트를 추적합니다.- CALL budget_db.budget_schema.my_budget!ADD_TAG( (SELECT SYSTEM$REFERENCE('TAG', 'cost_mgmt_db.tags.team_tag', 'SESSION', 'APPLYBUDGET')), 'finance');