TEXTCONTAINS

aplica-se a:coluna calculadatabela calculadamedidacálculo visual

Retorna TRUE se o texto em uma coluna corresponder a uma cadeia de caracteres de pesquisa de acordo com o modo de pesquisa de texto completo especificado. Caso contrário, ele retornará FALSE.

Syntax

TEXTCONTAINS(<within_text_column>, <search_text>[, <match_mode>])

Parameters

Prazo Definition
within_text_column Uma coluna que contém os valores de texto a serem pesquisados. A coluna deve ter o tipo de dados String.
search_text Uma cadeia de caracteres de texto que define a condição de pesquisa.
match_mode (Opcional) O comportamento de correspondência a ser usado. Os valores com suporte são TEXTMATCHING, FUZZYMATCHINGe PHRASEMATCHING. O padrão é TEXTMATCHING.

Valor de devolução

TRUE se o texto em within_text_column correspondências search_text de acordo match_modecom ; caso contrário, FALSE.

Modos de partida

Modo Behavior
TEXTMATCHING Tokeniza search_text e corresponde ao texto que contém qualquer um dos termos de pesquisa.
FUZZYMATCHING Corresponde a tokens semelhantes aos tokens de pesquisa em uma pequena distância de edição, que dá suporte à correspondência tolerante a erros de digitação.
PHRASEMATCHING Corresponde aos tokens analisados que aparecem um ao lado do outro e na ordem especificada. A pontuação não afeta a sequência de tokens.

Observações

  • A pesquisa diferencia maiúsculas de minúsculas.
  • A função aplica a remoção de palavras irrelevantes e específicas do idioma com base na cultura do modelo. Por exemplo, o lematização permite que uma pesquisa run corresponda runningrunnere runs. A remoção de palavras irrelevantes ignora palavras de preenchimento comuns, como the, ande ofin.
  • A ordenação por coluna não controla a linguagem do analisador. A cultura do modelo controla-o. No Power BI Desktop, selecione Opções de Arquivo>e configurações Opções>> Dearquivo atual,idioma de modelode configurações> regionais do arquivo > para definir o idioma do modelo. Para obter mais informações, consulte FORMAT.
  • As culturas de modelo com suporte são:
    • Inglês (en)
    • Francês (fr)
    • Alemão (de)
    • Espanhol (es)
    • Português (pt)
    • Russo (ru)
    • Árabe (ar)
    • Turco (tr)
    • Dinamarquês (da)
    • Holandês (nl)
    • Finlandês (fi)
    • Grego (el)
    • Húngaro (hu)
    • Italiano (it)
    • Norueguês (noenbnn)
    • Romeno (ro)
    • Sueco (sv)
    • Tâmil (ta)
  • Para culturas sem suporte, TEXTCONTAINS usa um tokenizador minúsculo genérico sem interrupção ou remoção de palavras irrelevantes.
  • Não há suporte para dobragem de ênfase. Por exemplo, café não corresponde a cafe.
  • A função requer um índice de texto completo persistente em within_text_column. Há suporte para os modos de armazenamento Importar, Dual e Direct Lake. Outros modos de armazenamento retornam um erro.
  • A função é avaliada linha por linha. Antes de usá-lo em uma coluna calculada em uma tabela muito grande, teste o desempenho com uma carga de trabalho representativa.
  • TEXTCONTAINS retorna um valor booliano e não se destina à classificação de relevância. Use TEXTSIMILARITY para classificar correspondências.

Examples

Corresponder a qualquer termo de pesquisa

A consulta a seguir retorna produtos cujas descrições contêm um token que corresponde a um wireless ou bluetooth:

EVALUATE
FILTER (
    Products,
    TEXTCONTAINS ( Products[Description], "wireless bluetooth" )
)
Texto do exemplo Result
Wireless headphones with Bluetooth 5.0 TRUE
Wireless noise-cancelling headphones TRUE
Wired headphones FALSE

Corresponder a todos os termos de pesquisa

Combine chamadas separadas com o && operador para exigir todos os termos:

EVALUATE
FILTER (
    Reviews,
    TEXTCONTAINS ( Reviews[Comment], "battery" )
        && TEXTCONTAINS ( Reviews[Comment], "life" )
)
Texto do exemplo Result
Battery life is amazing TRUE
Good life from this battery TRUE
Battery charges fast FALSE

Localizar uma correspondência difusa

A consulta a seguir usa correspondência tolerante a erros de digitação para localizar comentários que contêm um token semelhante a headphone:

EVALUATE
FILTER (
    Reviews,
    TEXTCONTAINS ( Reviews[Comment], "headphone", FUZZYMATCHING )
)
Texto do exemplo Result
These headphones are great TRUE
Best headfone I own TRUE
Excellent earbuds FALSE

Localizar uma correspondência de frase

A consulta a seguir encontra descrições nas quais noise e cancel aparecem ao lado umas das outras e nessa ordem:

EVALUATE
FILTER (
    Products,
    TEXTCONTAINS ( Products[Description], "noise cancel", PHRASEMATCHING )
)
Texto do exemplo Result
Noise cancel headphones pro TRUE
Cancel noise adapter FALSE

Conteúdo relacionado

  • Last updated on