TEXTCONTAINS

적용 대상:계산 열계산 테이블측정값시각적 계산

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