<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');

Copy

이 문은 출력의 참조를 반환합니다.

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');

Copy

인자에 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');

Copy