SYSTEM$TAG_VALUE_CONTAINS

SYSTEM$TAG_VALUE_CONTAINS

태그에 여러 값이 붙을 수 있을 때, 지정한 객체나 컬럼의 태그가 특정 문자열 값을 포함하는지 확인하는 시스템 함수예요. 값이 있으면 TRUE, 없거나 태그가 할당되지 않았으면 FALSE를 돌려줘요.

출처: 공식 문서

본문

지정된 태그(tag)가 지정된 객체나 컬럼에 있고 그 태그가 지정된 문자열 값을 포함하면 TRUE를 반환합니다. 값이 없거나 태그가 객체에 할당되지 않았다면 FALSE를 반환합니다.

태그가 두 개 이상의 값을 가질 수 있을 때 이 함수를 사용하세요. SYSTEM$GET_TAG는 값이 여러 개면 오류를 반환합니다. 자세한 내용은 Multi-value tags를 참고하세요.

참고 (See also): SYSTEM$GET_TAG , Multi-value tags

구문 (Syntax)

SYSTEM$TAG_VALUE_CONTAINS( '<tag_name>' , '<object_name>' , '<object_domain>' , '<value>' )

인자 (Arguments)

'tag_name'

태그의 이름을 문자열로 지정합니다 (키-값 쌍에서의 키).

'object_name'

객체의 이름을 문자열로 지정합니다. 컬럼의 경우에는 .을 사용합니다.

'object_domain'

SYSTEM$GET_TAG에서와 같은 의미로 객체 도메인을 식별하는 문자열입니다. Multi-value 태그는 테이블, 뷰, 컬럼에 적용되므로, 일반적으로 다음 값 중 하나를 전달할 수 있습니다:

  • 태그가 테이블이나 뷰에 있을 때: TABLE
  • 태그가 컬럼에 있을 때: COLUMN (이 경우 object_name에 .을 사용)

API가 받아들이는 모든 도메인 문자열은 SYSTEM$GET_TAG의 object_domain 인자를 참고하세요.

'value'

확인하려는 태그 값을 문자열로 지정합니다.

반환값 (Returns)

BOOLEAN을 반환합니다: 객체의 태그에 값이 할당되어 있으면 TRUE, 그렇지 않으면 FALSE.

사용 참고 (Usage notes)