TRUE 열의 텍스트가 지정된 전체 텍스트 검색 모드에 따라 검색 문자열과 일치하는지 반환합니다. 그 외의 경우 FALSE를 반환합니다.
Syntax
TEXTCONTAINS(<within_text_column>, <search_text>[, <match_mode>])
Parameters
| 기간 | Definition |
|---|---|
within_text_column |
검색할 텍스트 값이 들어 있는 열입니다. 열에는 문자열 데이터 형식이 있어야 합니다. |
search_text |
검색 조건을 정의하는 텍스트 문자열입니다. |
match_mode |
(선택 사항) 사용할 일치 동작입니다. 지원되는 값은 TEXTMATCHING, FUZZYMATCHING및 PHRASEMATCHING. 기본값은 TEXTMATCHING입니다. |
반환 값
TRUE 의 텍스트 within_text_column 가 일치하면 search_text 이고 match_mode, FALSE그렇지 않으면 .
일치 모드
| 모드 | 작동 방식 |
|---|---|
TEXTMATCHING |
검색어를 포함하는 텍스트를 토큰화 search_text 하고 일치합니다. |
FUZZYMATCHING |
오타 내성 일치를 지원하는 작은 편집 거리 내의 검색 토큰과 유사한 토큰과 일치합니다. |
PHRASEMATCHING |
서로 옆에 지정된 순서로 표시되는 분석된 토큰과 일치합니다. 문장 부호는 토큰 시퀀스에 영향을 주지 않습니다. |
비고
- 검색은 대/소문자를 구분하지 않습니다.
- 이 함수는 모델 문화권에 따라 언어별 형태소 분석 및 중지 단어 제거를 적용합니다. 예를 들어 형태소 분석에서는 검색
run을 통해 일치running,runs및runner. 중지 단어 제거는 ,andof, 및in. 같은the일반적인 필러 단어를 무시합니다. - 열별 데이터 정렬은 분석기 언어를 제어하지 않습니다. 모델 문화권이 이를 제어합니다. Power BI Desktop에서 파일>옵션 및 설정>옵션>현재 파일>국가별 설정>모델 언어를 선택하여 모델 언어를 설정합니다. 자세한 내용은 FORMAT를 참조하세요.
- 지원되는 모델 문화권은 다음과 같습니다.
- 영어(
en) - 프랑스어(
fr) - 독일어(
de) - 스페인어(
es) - 포르투갈어(
pt) - 러시아어(
ru) - 아랍어(
ar) - 터키어(
tr) - 덴마크어(
da) - 네덜란드어(
nl) - 핀란드어(
fi) - 그리스어(
el) - 헝가리어(
hu) - 이탈리아어(
it) - 노르웨이어(
no,nb및nn) - 루마니아어(
ro) - 스웨덴어(
sv) - 타밀어(
ta)
- 영어(
- 지원되지 않는 문화권
TEXTCONTAINS의 경우 형태소 분석 또는 중지 단어 제거 없이 일반 소문자 토큰 변환기를 사용합니다. - 강조 접는 기능은 지원되지 않습니다. 예를 들어
café는cafe과 같지 않습니다. - 이 함수에는 .에 대한 지속형 전체 텍스트 인덱스가
within_text_column필요합니다. 가져오기, 이중 및 Direct Lake 스토리지 모드에 대해 지원됩니다. 다른 스토리지 모드는 오류를 반환합니다. - 함수는 행별로 계산됩니다. 매우 큰 테이블의 계산 열에서 사용하기 전에 대표적인 워크로드를 사용하여 성능을 테스트합니다.
-
TEXTCONTAINS는 부울 값을 반환하며 관련성 순위를 위한 것이 아닙니다. TEXTSIMILARITY를 사용하여 일치 항목의 순위를 지정합니다.
예제
검색어 일치
다음 쿼리는 설명에 일치하는 wireless 토큰이 포함된 제품을 반환합니다 bluetooth.
EVALUATE
FILTER (
Products,
TEXTCONTAINS ( Products[Description], "wireless bluetooth" )
)
| 예시 텍스트 | Result |
|---|---|
Wireless headphones with Bluetooth 5.0 |
TRUE |
Wireless noise-cancelling headphones |
TRUE |
Wired headphones |
FALSE |
모든 검색어 일치
별도의 호출을 && 운영자와 결합하여 모든 용어를 요구합니다.
EVALUATE
FILTER (
Reviews,
TEXTCONTAINS ( Reviews[Comment], "battery" )
&& TEXTCONTAINS ( Reviews[Comment], "life" )
)
| 예시 텍스트 | Result |
|---|---|
Battery life is amazing |
TRUE |
Good life from this battery |
TRUE |
Battery charges fast |
FALSE |
유사 항목 일치 찾기
다음 쿼리는 오타 내성 일치를 사용하여 다음과 유사한 headphone토큰이 포함된 주석을 찾습니다.
EVALUATE
FILTER (
Reviews,
TEXTCONTAINS ( Reviews[Comment], "headphone", FUZZYMATCHING )
)
| 예시 텍스트 | Result |
|---|---|
These headphones are great |
TRUE |
Best headfone I own |
TRUE |
Excellent earbuds |
FALSE |
일치하는 구 찾기
다음 쿼리는 그 순서대로 noisecancel 서로 옆에 나타나는 설명을 찾습니다.
EVALUATE
FILTER (
Products,
TEXTCONTAINS ( Products[Description], "noise cancel", PHRASEMATCHING )
)
| 예시 텍스트 | Result |
|---|---|
Noise cancel headphones pro |
TRUE |
Cancel noise adapter |
FALSE |