카테고리:

문자열 및 이진 함수 (일치/비교)

CONTAINS

expr1expr2 가 포함되어 있는 경우 true를 반환합니다. 두 식 모두 텍스트 또는 이진 식이어야 합니다.

검색 최적화 서비스를 사용하여 이 함수를 호출하는 쿼리의 성능을 향상할 수 있습니다. 자세한 내용은 검색 최적화 서비스 섹션을 참조하십시오.

구문

CONTAINS( <expr1> , <expr2> )
Copy

인자

expr1

검색 위치인 문자열입니다.

expr2

검색 대상인 문자열입니다.

반환

BOOLEAN 을 반환합니다. expr2 내부에서 expr1 이 발견된 경우, 값은 True입니다. 두 입력 식 중 하나가 NULL인 경우, NULL을 반환합니다. 그렇지 않은 경우, False를 반환합니다.

데이터 정렬 세부 정보

The collation specifications of all input arguments must be compatible.

이 함수는 다음 데이터 정렬 사양을 지원하지 않습니다.

  • pi (구두점 구분 안 함).

  • cs-ai (대/소문자 구분, 악센트 구분 안 함).

참고

upper 또는 lower 데이터 정렬 지정자가 있는 열에 이 함수를 사용하려면 계정에서 2024_02 동작 변경 번들을 활성화 해야 합니다.

계정에서 이 번들을 활성화하려면 다음 문을 실행하십시오.

SELECT SYSTEM$ENABLE_BEHAVIOR_CHANGE_BUNDLE('2024_02');
Copy

SELECT * from strings;

---------+
    S    |
---------+
 coffee  |
 ice tea |
 latte   |
 tea     |
 [NULL]  |
---------+

SELECT * FROM strings WHERE CONTAINS(s, 'te');

---------+
    S    |
---------+
 ice tea |
 latte   |
 tea     |
---------+
Copy

다음 예는 데이터 정렬과 함께 CONTAINS 를 사용합니다.

-- Should return True.
SELECT CONTAINS(COLLATE('ñn', 'sp'), COLLATE('n', 'sp'));
+---------------------------------------------------+
| CONTAINS(COLLATE('ÑN', 'SP'), COLLATE('N', 'SP')) |
|---------------------------------------------------|
| True                                              |
+---------------------------------------------------+
SELECT CONTAINS(COLLATE('ñn', 'sp'), 'n');
+------------------------------------+
| CONTAINS(COLLATE('ÑN', 'SP'), 'N') |
|------------------------------------|
| True                               |
+------------------------------------+
Copy