TEXTCONTAINS

Si applica a:colonna calcolatatabella calcolata calcolo visivomisura

Restituisce TRUE se il testo in una colonna corrisponde a una stringa di ricerca in base alla modalità di ricerca full-text specificata. In caso contrario, restituisce FALSE.

Syntax

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

Parameters

Termine Definizione
within_text_column Colonna contenente i valori di testo da cercare. La colonna deve avere il tipo di dati String.
search_text Stringa di testo che definisce la condizione di ricerca.
match_mode (Facoltativo) Comportamento di corrispondenza da usare. I valori supportati sono TEXTMATCHING, FUZZYMATCHINGe PHRASEMATCHING. Il valore predefinito è TEXTMATCHING.

Valore restituito

TRUE se il testo in within_text_column corrisponde search_text in base a match_mode; in caso contrario, FALSE.

Modalità di corrispondenza

Mode Behavior
TEXTMATCHING Tokenzza search_text e corrisponde al testo che contiene uno dei termini di ricerca.
FUZZYMATCHING Corrisponde ai token simili ai token di ricerca all'interno di una piccola distanza di modifica, che supporta la corrispondenza a tolleranza di digitazioni.
PHRASEMATCHING Corrisponde ai token analizzati visualizzati uno accanto all'altro e nell'ordine specificato. La punteggiatura non influisce sulla sequenza di token.

Osservazioni:

  • La ricerca non fa distinzione tra maiuscole e minuscole.
  • La funzione applica stemming e rimozione di parole non significative specifiche della lingua in base alle impostazioni cultura del modello. Ad esempio, lo stemming consente a una ricerca di trovare run la corrispondenza con running, runse runner. La rimozione di parole non significative ignora parole di riempimento comuni, ad esempio the, andof, e in.
  • Le regole di confronto per colonna non controllano il linguaggio dell'analizzatore. Le impostazioni cultura del modello lo controllano. In Power BI Desktop selezionare Opzioni file>e impostazioniOpzioni> Impostazionicorrenti >Lingua impostazioni internazionali delfile>> per impostare la lingua del modello. Per altre informazioni, vedere FORMAT.
  • Le impostazioni cultura del modello supportate sono:
    • Inglese (en)
    • Francese (fr)
    • Tedesco (de)
    • Spagnolo (es)
    • Portoghese (pt)
    • Russo (ru)
    • Arabo (ar)
    • Turco (tr)
    • Danese (da)
    • Olandese (nl)
    • Finlandese (fi)
    • Greco (el)
    • Ungherese (hu)
    • Italiano (it)
    • Norvegese (no, nbe nn)
    • Romeno (ro)
    • Svedese (sv)
    • Tamil (ta)
  • Per le impostazioni cultura non supportate, TEXTCONTAINS usa un tokenizzatore generico in minuscolo senza stemming o rimozione di parole non significative.
  • La riduzione dell'accento non è supportata. Ad esempio, café non corrisponde a cafe.
  • La funzione richiede un indice full-text persistente in within_text_column. È supportato per le modalità di importazione, duale e archiviazione Direct Lake. Altre modalità di archiviazione restituiscono un errore.
  • La funzione viene valutata riga per riga. Prima di usarlo in una colonna calcolata su una tabella molto grande, testare le prestazioni con un carico di lavoro rappresentativo.
  • TEXTCONTAINS restituisce un valore booleano e non è destinato alla classificazione della pertinenza. Usare TEXTSIMILARITY per classificare le corrispondenze.

Esempi

Trova la corrispondenza con qualsiasi termine di ricerca

La query seguente restituisce prodotti le cui descrizioni contengono un token che corrisponde wireless a o bluetooth:

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

Trova la corrispondenza con tutti i termini di ricerca

Combinare chiamate separate con l'operatore && per richiedere tutti i termini:

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

Trovare una corrispondenza fuzzy

La query seguente usa la corrispondenza a tolleranza di digitatura per trovare commenti che contengono un token simile a headphone:

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

Trovare una corrispondenza di frase

La query seguente trova le descrizioni in cui noise e cancel vengono visualizzate l'una accanto all'altra e in tale ordine:

EVALUATE
FILTER (
    Products,
    TEXTCONTAINS ( Products[Description], "noise cancel", PHRASEMATCHING )
)
Testo di esempio Result
Noise cancel headphones pro TRUE
Cancel noise adapter FALSE

Contenuti correlati

  • Ultimo aggiornamento: