Todos os produtos
Search
Central de documentação

Quick BI:Funções de texto

Última atualização: Jun 27, 2026

As funções de texto processam strings em análises de dados. Use-as para extrair substrings, concatenar strings e alterar a caixa dos caracteres.

BI_CONCAT

BI_CONCAT une várias strings em uma única string.

Sintaxe

BI_CONCAT(string1, string2, …)

Descrição dos parâmetros

string1, string2, ...: Strings a unir.

Definição

Une múltiplas strings em uma única string.

Saída

String

Exemplo

BI_CONCAT('a', '-', 'b') = 'a-b'

BI_CONTAINS

BI_CONTAINS verifica se uma string contém uma substring específica.

Sintaxe

BI_CONTAINS(string, substring)

Descrição dos parâmetros

  • string: String de entrada.

  • substring: Substring a localizar.

Definição

Retorna "true" se a string contiver a substring; caso contrário, retorna "false".

Saída

String

Exemplo

BI_CONTAINS("Hello World", " ") = "true"

BI_ENDWITH

BI_ENDWITH verifica se uma string termina com uma substring especificada.

Sintaxe

BI_ENDWITH(string, substring)

Descrição dos parâmetros

  • string: String a verificar.

  • substring: Substring a localizar.

Definição

Retorna "true" se <string> terminar com <substring>; caso contrário, retorna "false". Espaços à direita são ignorados.

Saída

String

Exemplo

BI_ENDWITH("Hello World", "World") = "true"

BI_FIND

BI_FIND retorna a posição de uma substring.

Sintaxe

BI_FIND(substring, string, [start])

Descrição dos parâmetros

  • substring: String a encontrar.

  • string: String onde buscar.

  • [start]: Posição do índice para iniciar a busca.

Definição

Retorna a posição da substring na string, começando em <start> (opcional). Retorna 0 se não for encontrada. O índice de posição começa em 1.

Saída

Number

Exemplo

BI_FIND('World', 'Hello World') =7

BI_FIND('Computer', 'Hello World') = 0

BI_LEFT

BI_LEFT retorna um número específico de caracteres do início de uma string.

Sintaxe

BI_LEFT(string, number)

Descrição dos parâmetros

  • string: String da qual extrair caracteres.

  • number: Quantidade de caracteres a retornar.

Definição

Retorna os primeiros <number> caracteres da string.

Saída

String

Exemplo

BI_LEFT('Hello World', 5) = 'Hello'

BI_LEN

BI_LEN retorna o comprimento de uma string.

Sintaxe

BI_LEN(string)

Descrição dos parâmetros

string: String de entrada.

Definição

Retorna o comprimento da string.

Saída

Number

Exemplo

BI_LEN('Hello World') = 11

BI_LOWER

BI_LOWER converte todos os caracteres de uma string para minúsculas.

Sintaxe

BI_LOWER(string)

Descrição dos parâmetros

string: String a converter para minúsculas.

Definição

Retorna <string> com todos os caracteres em minúsculas.

Saída

String

Exemplo

BI_UPPER('Hello World') retorna 'hello world'.

BI_LTRIM

BI_LTRIM remove espaços à esquerda de uma string.

Sintaxe

BI_LTRIM(string)

Descrição dos parâmetros

string: String de entrada.

Definição

Remove todos os espaços à esquerda de <string>.

Saída

String

Exemplo

BI_LTRIM(' Hello World ') = 'Hello World '

Limites

Não compatível com fontes de dados Lindorm (LindormTSDB).

BI_MID

BI_MID extrai uma substring a partir de uma posição especificada.

Sintaxe

BI_MID(string, start, [length])

Descrição dos parâmetros

  • string: String da qual extrair caracteres.

  • start: Posição inicial (índice baseado em 1).

  • [length]: Quantidade de caracteres a retornar.

Definição

Retorna uma substring de <string> começando na posição <start> (índice baseado em 1).

Se <length> for especificado, retorna apenas essa quantidade de caracteres.

Saída

String

Exemplo

BI_MID('Hello World', 2) = 'ello World'

BI_MID('Hello World', 2, 4) ='ello'

Limites

Não compatível com fontes de dados TiDB.

BI_REPLACE

BI_REPLACE substitui caracteres em uma posição determinada.

Sintaxe

BI_REPLACE(string, substring, replacement)

Descrição dos parâmetros

  • string: String de source.

  • substring: Substring especificada.

  • replacement: String de substituição.

Definição

Substitui <substring> em <string> por <replacement>. Retorna a string original se <substring> não for encontrada.

Saída

String

Exemplo

BI_REPLACE('Hello World', ' ', '-') = 'Hello-World'

BI_RIGHT

BI_RIGHT retorna um número definido de caracteres do final de uma string.

Sintaxe

BI_RIGHT(string, number)

Descrição dos parâmetros

  • string: String da qual extrair caracteres.

  • number: Quantidade de caracteres a retornar.

Definição

Retorna os últimos <number> caracteres da string.

Saída

String

Exemplo

BI_RIGHT('Hello World', 5) = 'World'

BI_RTRIM

BI_RTRIM remove espaços à direita de uma string.

Sintaxe

BI_RTRIM(string)

Descrição dos parâmetros

string: String de entrada.

Definição

Remove todos os espaços à direita de <string>.

Saída

String

Exemplo

BI_RTRIM(' Hello World ') = ' Hello World'

Limites

Não compatível com fontes de dados Lindorm (LindormTSDB).

BI_SPLIT

BI_SPLIT divide uma string por um delimitador e retorna um token específico.

Sintaxe

BI_SPLIT(string, delimiter, token number)

Descrição dos parâmetros

  • string: String a dividir.

  • delimiter: Separador.

  • token number: Enésimo token a retornar. Valores positivos contam da esquerda (1 = primeiro). Valores negativos contam da direita (-1 = último).

Definição

Divide <string> pelo delimitador e retorna o token na posição especificada.

Saída

String

Exemplo

BI_SPLIT ('a-b-c-d', '-', 2) = 'b'

BI_SPLIT ('a|b|c|d', '|', -2) = 'c'

Limites

  • Não compatível com fontes de dados SQL Server, Lindorm, Elasticsearch, IBM DB2 LUW ou SAP IQ (Sybase IQ).

  • Números negativos não são compatíveis com fontes de dados HANA.

BI_STARTWITH

BI_STARTWITH verifica se uma string começa com uma substring específica.

Sintaxe

BI_STARTWITH(string, substring)

Descrição dos parâmetros

  • string: String de entrada.

  • substring: Substring a localizar.

Definição

Retorna "true" se <string> começar com <substring>; caso contrário, retorna "false". Espaços à esquerda são ignorados.

Saída

String

Exemplo

BI_STARTWITH("Hello World", "Hello") = "true"

BI_TRIM

BI_TRIM remove espaços à esquerda e à direita de uma string.

Sintaxe

BI_TRIM(string)

Descrição dos parâmetros

string: String de entrada.

Definição

Remove todos os espaços à esquerda e à direita de <string>.

Saída

String

Exemplo

BI_TRIM(' Hello World ') = 'Hello World'

BI_UPPER

BI_UPPER converte todos os caracteres de uma string para maiúsculas.

Sintaxe

BI_UPPER(string)

Descrição dos parâmetros

string: String a converter para maiúsculas.

Definição

Retorna <string> com todos os caracteres em maiúsculas.

Saída

String

Exemplo

BI_UPPER('Hello World') = 'HELLO WORLD'