PESQUISA

Aplica-se a:Colunacalculada Tabelacalculada MedidaCálculo visual

Retorna o número do caractere no qual um caractere específico ou cadeia de caracteres de texto é encontrado pela primeira vez, lendo da esquerda para a direita. A pesquisa não diferencia maiúsculas de minúsculas e acentua.

Sintaxe

SEARCH(<find_text>, <within_text>[, [<start_num>][, <NotFoundValue>]])  

Parâmetros

Termo	Definição
find_text	O texto que pretende encontrar. Você pode usar caracteres curinga — o ponto de interrogação (?) e o asterisco (*) — no find_text. Um ponto de interrogação corresponde a qualquer caractere único; um asterisco corresponde a qualquer sequência de caracteres. Se você quiser encontrar um ponto de interrogação ou asterisco real, digite um til (~) antes do caractere.
within_text	O texto no qual você deseja pesquisar find_text ou uma coluna que contém texto.
start_num	(facultativo) A posição do caractere em within_text na qual você deseja começar a pesquisar. Se omitido, 1.
NotFoundValue	(opcional, mas fortemente recomendado) O valor que deve ser retornado quando a operação não encontrar uma substring correspondente, normalmente 0, -1 ou BLANK(). Se não for especificado, um erro será retornado.

Valor devolvido

O número da posição inicial da primeira cadeia de texto a partir do primeiro caractere da segunda cadeia de texto.

Observações

• A função de pesquisa não diferencia maiúsculas de minúsculas. Pesquisando por "N" encontrará a primeira ocorrência de "N" ou "n".

• A função de pesquisa é sensível ao sotaque. Pesquisando por "á" encontrará a primeira ocorrência de 'á', mas nenhuma ocorrência de 'a', 'à', ou as versões maiúsculas 'A', 'Á'.

• Você pode usar a função PROCURAR para determinar o local de um caractere ou cadeia de caracteres de texto dentro de outra cadeia de texto e, em seguida, usar a função MID para retornar o texto ou usar a função SUBSTITUIR para alterar o texto.

• Se o find_text não puder ser encontrado no within_text, a fórmula retornará um erro. Esse comportamento é como o Excel, que retorna #VALUE se a substring não for encontrada. Nulos em within_text serão interpretados como uma cadeia de caracteres vazia neste contexto.

• Esta função não é suportada para utilização no modo DirectQuery quando utilizada em colunas calculadas ou regras de segurança ao nível da linha (RLS).

Exemplo

A consulta DAX a seguir localiza a posição da primeira letra de "ciclo", na cadeia de caracteres que contém o nome do revendedor. Se não for encontrado, Blank será retornado.

SEARCH não diferencia maiúsculas de minúsculas. Neste exemplo, se "ciclo" ou "Ciclo" for usado no argumento find_text>, os resultados serão retornados para ambos os <casos. Use FIND para diferenciar maiúsculas de minúsculas.

Exemplos neste artigo podem ser usados com o modelo de exemplo do Power BI Desktop do Adventure Works DW 2020. Para obter o modelo, consulte Modelo de exemplo DAX.

EVALUATE
CALCULATETABLE (
    ADDCOLUMNS (
        TOPN ( 10, SUMMARIZE('Reseller', [Reseller], [Business Type])),
        "Position of cycle", SEARCH ( "cycle", 'Reseller'[Reseller], 1, BLANK () )
    ),
    'Reseller'[Business Type] IN { "Specialty Bike Shop", "Value Added Reseller", "Warehouse"}
)

Devoluções,

Reseller	Business Type	Posição do ciclo
Volume Bike Sellers	Armazém
Bicicletas de Mercado de Massa	Value Added Reseller
Ciclos duplos	Value Added Reseller	6
Loja de Departamentos Rich	Armazém
Galeria de Aluguer	Specialty Bike Shop
Loja de brinquedos de orçamento	Armazém
Outlet Esportivo Global	Armazém
Catálogo Online de Bicicletas	Armazém
Capacetes e Bicicletas	Value Added Reseller	13
Jumbo Bicicletas	Specialty Bike Shop

Conteúdos relacionados

ENCONTRAR
SUBSTITUIR
Funções de texto