Ler em inglês

Partilhar via


PESQUISA

Aplica-se a: Coluna calculada Tabela calculada Medida Cá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

ENCONTRAR
SUBSTITUIR
Funções de texto