TEXTSIMILARITY: função DAX com exemplos

Quando usar

Para ranquear linhas de texto livre pela relevância em relação a uma pesquisa — ex.: as N avaliações mais ligadas a um tema. Combine com TEXTCONTAINS para primeiro filtrar e depois ordenar.

Sintaxe

DAX

TEXTSIMILARITY(<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: pontua qualquer termo), FUZZYMATCHING (tolera erros de digitação) ou PHRASEMATCHING (pontua termos lado a lado, na ordem informada).

Aplica-se a

SimColuna Calculada
SimTabela Calculada
SimMedida
SimCálculo Visual

Exemplo

DAX

// DAX Query View: as 5 avaliações mais relevantes para "entrega rápida"
EVALUATE
TOPN (
    5,
    TabFatAvaliacao,
    TEXTSIMILARITY ( TabFatAvaliacao[Comentario], "entrega rápida" ), DESC
)

// Filtrar primeiro, depois ranquear
EVALUATE
TOPN (
    5,
    FILTER (
        TabFatAvaliacao,
        TEXTCONTAINS ( TabFatAvaliacao[Comentario], "entrega" )
    ),
    TEXTSIMILARITY ( TabFatAvaliacao[Comentario], "entrega rápida" ), DESC
)

// Ver a pontuação ao lado de cada descrição
EVALUATE
ADDCOLUMNS (
    TabDimProduto,
    "Relevância", TEXTSIMILARITY ( TabDimProduto[DescricaoProduto], "sem fio bluetooth" )
)

Observações

A pontuação é um valor opaco de ranking — não é porcentagem, probabilidade nem similaridade normalizada. Compare apenas dentro da mesma consulta; não há garantia de estabilidade entre execuções, colunas, filtros, modos de armazenamento ou atualizações do índice. Filtrar com TEXTCONTAINS não muda o escopo do índice usado para calcular a pontuação. 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; stemming e palavras irrelevantes seguem o idioma do modelo (português suportado). Avaliada linha a linha: teste o desempenho em tabelas grandes.

Mais informações

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