TEXTCONTAINS

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

Retorna TRUE se o texto numa coluna coincidir com uma cadeia de pesquisa de acordo com o modo de pesquisa de texto completo especificado. Caso contrário, ele retorna FALSE.

Syntax

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

Parameters

Term Definition
within_text_column Uma coluna que contém os valores de texto a pesquisar. A coluna deve ter o tipo de dado String.
search_text Uma cadeia de texto que define a condição de pesquisa.
match_mode (Opcional) O comportamento de correspondência a usar. Os valores suportados são TEXTMATCHING, FUZZYMATCHINGe PHRASEMATCHING. A predefinição é TEXTMATCHING.

Valor de retorno

TRUE se o texto em within_text_column corresponder search_text a match_mode; caso contrário, FALSE.

Modos de correspondência

Mode Comportamento
TEXTMATCHING Tokeniza search_text e corresponde ao texto que contenha qualquer um dos termos de pesquisa.
FUZZYMATCHING Corresponde a tokens semelhantes a tokens de pesquisa dentro de uma pequena distância de edição, o que suporta correspondência tolerante a erros tipográficos.
PHRASEMATCHING As correspondências analisavam fichas que apareciam lado a lado e na ordem especificada. A pontuação não afeta a sequência de tokens.

Remarks

  • A pesquisa não diferencia maiúsculas de minúsculas.
  • A função aplica stemming específico da língua e remoção de palavras paradas com base na cultura modelo. Por exemplo, o stemming permite que uma pesquisa por run corresponda runninga , runs, e runner. A remoção de palavras finais ignora palavras de enchimento comuns como the, and, of, e in.
  • A colação por coluna não controla a linguagem do analisador. A cultura do modelo controla-o. No Power BI Desktop, selecioneOpções e Opçõesde Ficheiro>>Opções>de Ficheiro Atual>Configuração> RegionalLinguagem do Modelo para definir a linguagem do modelo. Para obter mais informações, veja FORMAT.
  • As culturas modelo suportadas 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)
    • Neerlandês (nl)
    • Finlandês (fi)
    • Grego (el)
    • Húngaro (hu)
    • Italiano (it)
    • Norueguês (no, nb, e nn)
    • Romeno (ro)
    • Sueco (sv)
    • Tâmil (ta)
  • Para culturas não suportadas, TEXTCONTAINS usa um tokenizador genérico em minúsculas sem remoção de stemming ou palavra de parada.
  • A dobra de destaque não é suportada. Por exemplo, café não corresponde a cafe.
  • A função requer um índice de texto completo persistente em within_text_column. É suportado para os modos de armazenamento Importação, Dual e Direct Lake. Outros modos de armazenamento devolvem um erro.
  • A função é avaliada linha a linha. Antes de o usar numa coluna calculada sobre uma tabela muito grande, teste o desempenho com uma carga de trabalho representativa.
  • TEXTCONTAINS devolve um valor booleano 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 seguinte devolve produtos cujas descrições contêm um token que corresponde a ou wirelessbluetooth:

EVALUATE
FILTER (
    Products,
    TEXTCONTAINS ( Products[Description], "wireless bluetooth" )
)
Texto de 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 de exemplo Result
Battery life is amazing TRUE
Good life from this battery TRUE
Battery charges fast FALSE

Encontre uma correspondência difusa

A consulta seguinte utiliza correspondência tolerante a erros tipográficos para encontrar comentários que contenham um token semelhante a headphone:

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

Encontre uma correspondência de frases

A consulta seguinte encontra descrições em que noise e cancel aparecem lado a lado e por essa ordem:

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

Conteúdo relacionado

  • Last updated on