TEXTCONTAINS: função DAX com exemplos

Quando usar

Para filtrar linhas por palavras, frases ou termos com erro de digitação em colunas de texto livre (comentários, chamados, descrições de produto), quando a busca por fragmento do CONTAINSSTRING não basta. Para ordenar por relevância, use TEXTSIMILARITY.

Sintaxe

DAX

TEXTCONTAINS(<ColunaTexto>, <TextoPesquisa>[, <ModoCorrespondencia>])

Parâmetros

ColunaTexto: Coluna do tipo texto onde a busca é feita; precisa ter índice de texto completo. TextoPesquisa: Texto que define a condição de busca. ModoCorrespondencia (Opcional): TEXTMATCHING (padrão: qualquer um dos termos), FUZZYMATCHING (tolera erros de digitação) ou PHRASEMATCHING (termos lado a lado, na ordem informada).

Aplica-se a

SimColuna Calculada
SimTabela Calculada
SimMedida
SimCálculo Visual

Exemplo

DAX

// Medida: avaliações que citam entrega OU atraso (qualquer termo)
# Avaliações Entrega =
CALCULATE (
    COUNTROWS ( TabFatAvaliacao ),
    FILTER (
        TabFatAvaliacao,
        TEXTCONTAINS ( TabFatAvaliacao[Comentario], "entrega atraso" )
    )
)

// Medida: exigir os dois termos — combine chamadas com &&
# Avaliações Entrega e Atraso =
CALCULATE (
    COUNTROWS ( TabFatAvaliacao ),
    FILTER (
        TabFatAvaliacao,
        TEXTCONTAINS ( TabFatAvaliacao[Comentario], "entrega" )
            && TEXTCONTAINS ( TabFatAvaliacao[Comentario], "atraso" )
    )
)

// DAX Query View: tolerância a erro de digitação e busca por frase
EVALUATE
FILTER (
    TabDimProduto,
    TEXTCONTAINS ( TabDimProduto[DescricaoProduto], "fone", FUZZYMATCHING )
        || TEXTCONTAINS ( TabDimProduto[DescricaoProduto], "cancelamento de ruído", PHRASEMATCHING )
)

Observações

Exige índice de texto completo persistido na coluna (recurso em preview): defina fullTextIndexingBehavior: full (ou explicit) na coluna via TMDL view do Service ou XMLA, com o modelo em nível de compatibilidade 1708 ou superior, e atualize o modelo para criar o índice. No modo explicit, o índice só é criado por uma atualização do tipo indexes via XMLA. Funciona em Import, Dual e Direct Lake — outros modos retornam erro. Não diferencia maiúsculas, mas diferencia acentos: "café" não encontra "cafe". Aplica radical (stemming) e remove palavras irrelevantes conforme o idioma do modelo (Opções > Arquivo atual > Configurações regionais > Idioma do modelo), não o da coluna. Português é suportado; idiomas não suportados usam tokenização genérica sem stemming. Busca por termos (tokens), não por fragmento: para "contém o trecho" use CONTAINSSTRING. Avaliada linha a linha: teste o desempenho antes de usar em coluna calculada de tabela muito grande. Retorna booleano, sem ranking — para relevância use TEXTSIMILARITY.

Mais informações

Lançamento: 2026-Set
Referência: https://learn.microsoft.com/pt-br/dax/textcontains-function-dax