Funções de substituição de strings - ClickHouse Documentation

Funções gerais de strings e funções de pesquisa em strings são descritas separadamente.

A documentação abaixo é gerada a partir da system table system.functions.

format

Introduzido em: v20.1.0 Formata a string pattern com os valores (strings, inteiros etc.) listados nos argumentos, de modo semelhante à formatação em Python. A string pattern pode conter campos de substituição entre chaves {}. Tudo o que não estiver entre chaves é considerado texto literal e copiado literalmente para a saída. Os caracteres de chave literais podem ser escapados com duas chaves: {{ e }}. Os nomes dos campos podem ser números (começando em zero) ou estar vazios (nesse caso, recebem implicitamente números crescentes). Sintaxe

format(pattern, s0[, s1, ...])

Argumentos

pattern — A string de formato que contém placeholders. String
s0[, s1, ...] — Um ou mais valores para substituir os placeholders no padrão. Any

Valor retornado Retorna uma string formatada. String Exemplos Placeholders numerados

Query

SELECT format('{1} {0} {1}', 'World', 'Hello')

Response

┌─format('{1} {0} {1}', 'World', 'Hello')─┐
│ Hello World Hello                       │
└─────────────────────────────────────────┘

Numeração implícita

Query

SELECT format('{} {}', 'Hello', 'World')

Response

┌─format('{} {}', 'Hello', 'World')─┐
│ Hello World                       │
└───────────────────────────────────┘

overlay

Introduzido na versão: v24.9.0 Substitui parte da string input por outra string replace, começando no índice offset, baseado em 1. Sintaxe

overlay(s, replace, offset[, length])

Argumentos

s — A string de entrada. String
replace — A string de substituição. const String
offset — Um inteiro do tipo Int (indexado a partir de 1). Se offset for negativo, ele será contado a partir do final da string s. Int
length — Opcional. Um inteiro do tipo Int. length especifica o comprimento do trecho dentro da string de entrada s que será substituído. Se length não for especificado, o número de bytes removidos de s será igual ao comprimento de replace; caso contrário, length bytes serão removidos. Int

Valor retornado Retorna uma string com o trecho substituído. String Exemplos Substituição básica

Query

SELECT overlay('My father is from Mexico.', 'mother', 4) AS res;

Response

┌─res──────────────────────┐
│ My mother is from Mexico.│
└──────────────────────────┘

Substituição com tamanho

Query

SELECT overlay('My father is from Mexico.', 'dad', 4, 6) AS res;

Response

┌─res───────────────────┐
│ My dad is from Mexico.│
└───────────────────────┘

overlayUTF8

Introduzido em: v24.9.0 Substitui parte da string s por outra string, replace, começando no índice offset, baseado em 1. Pressupõe que a string contenha texto válido codificado em UTF-8. Se essa suposição for violada, nenhuma exceção é lançada e o resultado é indefinido. Sintaxe

overlayUTF8(s, replace, offset[, length])

Argumentos

s — A string de entrada. String
replace — A string de substituição. const String
offset — Um inteiro Int (baseado em 1). Se offset for negativo, ele é contado a partir do fim da string de entrada s. (U)Int*
length — Opcional. Especifica o comprimento do trecho na string de entrada s que será substituído. Se length não for especificado, o número de caracteres removidos de s será igual ao comprimento de replace; caso contrário, serão removidos length caracteres. (U)Int*

Valor retornado Retorna uma string com o conteúdo substituído. String Exemplos Substituição UTF-8

Query

SELECT overlayUTF8('Mein Vater ist aus Österreich.', 'der Türkei', 20) AS res;

Response

┌─res───────────────────────────┐
│ Mein Vater ist aus der Türkei.│
└───────────────────────────────┘

printf

Introduzido em: v24.8.0 A função printf formata a string fornecida com os valores (strings, inteiros, números de ponto flutuante etc.) listados nos argumentos, de maneira semelhante à função printf em C++. A string de formato pode conter especificadores de formato iniciados pelo caractere %. Tudo o que não estiver contido em % e no especificador de formato seguinte é considerado texto literal e copiado literalmente para a saída. O caractere % literal pode ser escapado com %%. A string de formato pode ser uma constante ou uma expressão de coluna, permitindo diferentes padrões de formato por linha. Sintaxe

printf(format[, sub1, sub2, ...])

Argumentos

format — A string de formato com especificadores %. String
sub1, sub2, ... — Opcional. Zero ou mais valores a serem substituídos na string de formato. Any

Valor retornado Retorna uma string formatada. String Exemplos Formatação no estilo C++

Query

SELECT printf('%%%s %s %d', 'Hello', 'World', 2024);

Response

┌─printf('%%%s %s %d', 'Hello', 'World', 2024)─┐
│ %Hello World 2024                            │
└──────────────────────────────────────────────┘

regexpQuoteMeta

Introduzido em: v20.1.0 Adiciona uma barra invertida antes destes caracteres com significado especial em expressões regulares: \0, \\, |, (, ), ^, $, ., [, ], ?, *, +, {, :, -. Esta implementação difere ligeiramente de re2::RE2::QuoteMeta. Ela escapa o byte zero como \0 em vez de \x00 e escapa apenas os caracteres necessários. Sintaxe

regexpQuoteMeta(s)

Argumentos

s — A string de entrada que contém caracteres que devem ser escapados em regex. String

Valor retornado Retorna uma string com os caracteres especiais de regex escapados. String Exemplos Escapar caracteres especiais de regex

Query

SELECT regexpQuoteMeta('Hello. [World]? (Yes)*') AS res

Response

┌─res───────────────────────────┐
│ Hello\. \[World\]\? \(Yes\)\* │
└───────────────────────────────┘

replaceAll

Introduzido em: v1.1.0 Substitui todas as ocorrências da substring pattern em haystack pela string replacement. Sintaxe

replaceAll(haystack, pattern, replacement)

Aliases: replace Argumentos

haystack — A string de entrada na qual buscar. String
pattern — A substring a ser encontrada e substituída. const String
replacement — A string que substituirá o padrão. const String

Valor retornado Retorna uma string com todas as ocorrências do padrão substituídas. String Exemplos Substituir todas as ocorrências

Query

SELECT replaceAll('Hello, Hello world', 'Hello', 'Hi') AS res;

Response

┌─res──────────┐
│ Hi, Hi world │
└──────────────┘

replaceOne

Introduzido em: v1.1.0 Substitui a primeira ocorrência da substring pattern em haystack pela string replacement. Sintaxe

replaceOne(haystack, pattern, replacement)

Argumentos

haystack — A string de entrada na qual a busca será feita. String
pattern — A substring a ser encontrada e substituída. const String
replacement — A string usada para substituir a substring. const String

Valor retornado Retorna uma string com a primeira ocorrência da substring substituída. String Exemplos Substituir a primeira ocorrência

Query

SELECT replaceOne('Hello, Hello world', 'Hello', 'Hi') AS res;

Response

┌─res─────────────┐
│ Hi, Hello world │
└─────────────────┘

replaceRegexpAll

Introduzido em: v1.1.0 Semelhante a replaceRegexpOne, mas substitui todas as ocorrências do padrão. Como exceção, se uma expressão regular corresponder a uma substring vazia, a substituição não será feita mais de uma vez. Sintaxe

replaceRegexpAll(haystack, pattern, replacement)

Aliases: REGEXP_REPLACE Argumentos

haystack — A string de entrada na qual a busca será feita. String
pattern — O padrão de expressão regular a ser encontrado. const String
replacement — A string que substituirá o padrão; pode conter substituições. const String

Valor retornado Retorna uma string com todas as correspondências da expressão regular substituídas. String Exemplos Substituir todos os caracteres pela versão duplicada

Query

SELECT replaceRegexpAll('Hello123', '.', '\\\\0\\\\0') AS res

Response

┌─res──────────────────┐
│ HHeelllloo112233     │
└──────────────────────┘

Exemplo de substituição de substring vazia

Query

SELECT replaceRegexpAll('Hello, World!', '^', 'here: ') AS res

Response

┌─res─────────────────┐
│ here: Hello, World! │
└─────────────────────┘

replaceRegexpOne

Introduzido em: v1.1.0 Substitui a primeira ocorrência da substring que corresponde à expressão regular pattern (na sintaxe do re2) em haystack pela string replacement. replacement pode conter substituições \0-\9. As substituições \1-\9 correspondem aos grupos de captura de 1 a 9 (submatches), e a substituição \0 corresponde à correspondência inteira. Para usar o caractere literal \ nas strings pattern ou replacement, escape-o com \. Lembre-se também de que literais de string exigem escape adicional. Sintaxe

replaceRegexpOne(haystack, pattern, replacement)

Argumentos

haystack — A string de entrada na qual será feita a pesquisa. String
pattern — O padrão de expressão regular a ser encontrado. const String
replacement — A string que substituirá o padrão; pode conter substituições. const String

Valor retornado Retorna uma string com a primeira correspondência da expressão regular substituída. String Exemplos Convertendo datas ISO para o formato americano

Query

SELECT DISTINCT
    EventDate,
    replaceRegexpOne(toString(EventDate), '(\\d{4})-(\\d{2})-(\\d{2})', '\\2/\\3/\\1') AS res
FROM test.hits
LIMIT 7
FORMAT TabSeparated

Response

2014-03-17      03/17/2014
2014-03-18      03/18/2014
2014-03-19      03/19/2014
2014-03-20      03/20/2014
2014-03-21      03/21/2014
2014-03-22      03/22/2014
2014-03-23      03/23/2014

Copiando uma string dez vezes

Query

SELECT replaceRegexpOne('Hello, World!', '.*', '\\\\0\\\\0\\\\0\\\\0\\\\0\\\\0\\\\0\\\\0\\\\0\\\\0') AS res

Response

┌─res────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ Hello, World!Hello, World!Hello, World!Hello, World!Hello, World!Hello, World!Hello, World!Hello, World!Hello, World!Hello, World! │
└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

translate

Introduzido na versão: v22.7.0 Substitui caracteres na string s usando um mapeamento de caracteres um para um definido pelas strings from e to. from e to devem ser strings ASCII constantes. Se from e to tiverem o mesmo tamanho, cada ocorrência do primeiro caractere de from em s será substituída pelo primeiro caractere de to, a segunda ocorrência de from em s será substituída pelo segundo caractere de to e assim por diante. Se from contiver mais caracteres do que to, todas as ocorrências dos caracteres no final de from que não tiverem caractere correspondente em to serão removidas de s. Caracteres não ASCII em s não são modificados pela função. Sintaxe

translate(s, from, to)

Argumentos

s — A string de entrada a ser convertida. String
from — Uma string ASCII constante que contém os caracteres a serem substituídos. const String
to — Uma string ASCII constante que contém os caracteres de substituição. const String

Valor retornado Retorna uma string com as substituições de caracteres aplicadas. String Exemplos Mapeamento de caracteres

Query

SELECT translate('Hello, World!', 'delor', 'DELOR') AS res

Response

┌─res───────────┐
│ HELLO, WORLD! │
└───────────────┘

Comprimentos distintos

Query

SELECT translate('clickhouse', 'clickhouse', 'CLICK') AS res

Response

┌─res───┐
│ CLICK │
└───────┘

translateUTF8

Introduzido em: v22.7.0 Como translate, mas pressupõe que s, from e to sejam strings codificadas em UTF-8. Sintaxe

translateUTF8(s, from, to)

Argumentos

s — string UTF-8 de entrada a ser convertida. String
from — uma string UTF-8 constante que contém os caracteres a serem substituídos. const String
to — uma string UTF-8 constante que contém os caracteres de substituição. const String

Valor retornado Retorna um valor do tipo de dado String. String Exemplos Conversão de caracteres UTF-8

Query

SELECT translateUTF8('Münchener Straße', 'üß', 'us') AS res;

Response

┌─res──────────────┐
│ Munchener Strase │
└──────────────────┘

​format

​overlay

​overlayUTF8

​printf

​regexpQuoteMeta

​replaceAll

​replaceOne

​replaceRegexpAll

​replaceRegexpOne

​translate

​translateUTF8

format

overlay

overlayUTF8

printf

regexpQuoteMeta

replaceAll

replaceOne

replaceRegexpAll

replaceRegexpOne

translate

translateUTF8