文字列内の置換に関する関数

overlay

文字列 input の一部を別の文字列 replace で置き換え、1から始まるインデックス offset から開始します。

構文

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

パラメーター

s: 文字列型 String。
replace: 文字列型 String。
offset: 整数型 Int (1から始まる)。offset が負の場合、文字列 s の末尾から数えます。
length: オプション。整数型 Int。length は入力文字列 s 内の置き換え対象の部分の長さを指定します。length が指定されていない場合、s から削除されるバイト数は replace の長さに等しくなります。それ以外の場合、length バイトが削除されます。

戻り値

String 型の値。

例

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

結果:

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

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

結果:

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

overlayUTF8

文字列 input の一部を別の文字列 replace で置き換え、1から始まるインデックス offset から開始します。

文字列が有効なUTF-8エンコードされたテキストを含むと仮定しています。この仮定が破られた場合、例外はスローされず、結果は未定義です。

構文

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

パラメーター

s: 文字列型 String。
replace: 文字列型 String。
offset: 整数型 Int (1から始まる)。offset が負の場合、入力文字列 s の末尾から数えます。
length: オプション。整数型 Int。length は入力文字列 s 内の置き換え対象の部分の長さを指定します。length が指定されていない場合、s から削除される文字数は replace の長さに等しくなります。それ以外の場合、length 文字が削除されます。

戻り値

String 型の値。

例

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

結果:

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

replaceOne

haystack 中の部分文字列 pattern の最初の出現を replacement 文字列で置き換えます。

構文

replaceOne(haystack, pattern, replacement)

replaceAll

haystack 中の部分文字列 pattern のすべての出現を replacement 文字列で置き換えます。

構文

replaceAll(haystack, pattern, replacement)

エイリアス: replace。

replaceRegexpOne

haystack 中の正規表現 pattern に一致する部分文字列の最初の出現を replacement 文字列で置き換えます。

replacement には置換 \0-\9 を含めることができます。置換 \1-\9 は1番目から9番目のキャプチャグループ（サブマッチ）に対応し、置換 \0 は全体の一致に対応します。

pattern または replacement 文字列内で文字 \ をそのまま使用したい場合は、エスケープとして \ を使用します。また、文字列リテラルは追加のエスケープが必要であることを覚えておいてください。

構文

replaceRegexpOne(haystack, pattern, replacement)

例

ISO形式の日付を米国形式に変換する:

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

結果:

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

文字列を10回コピーする:

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

結果:

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

replaceRegexpAll

replaceRegexpOneと同様ですが、パターンのすべての出現を置き換えます。

エイリアス: REGEXP_REPLACE。

例

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

結果:

┌─res────────────────────────┐
│ HHeelllloo,,  WWoorrlldd!! │
└────────────────────────────┘

例外として、正規表現が空の部分文字列で動作した場合、置き換えは一度だけ行われます。例えば:

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

結果:

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

regexpQuoteMeta

正規表現で特別な意味を持つこれらの文字の前にバックスラッシュを追加します： \0, \\, |, (, ), ^, $, ., [, ], ?, *, +, {, :, -。

この実装は re2::RE2::QuoteMeta とは多少異なります。ゼロバイトは \0 としてエスケープされ、必要な文字のみがエスケープされます。詳細については、RE2を参照してください。

構文

regexpQuoteMeta(s)

format

pattern 文字列を引数にリストされた値（文字列、整数など）でフォーマットします。これは Python でのフォーマットに似ています。パターン文字列には、中括弧 {} で囲まれた置換フィールドを含めることができます。中括弧内に含まれないものは、リテラルテキストとして扱われ、出力にそのままコピーされます。リテラルの中括弧文字は、二重中括弧でエスケープできます： {{ '{{' }} と {{ '}}' }}。フィールド名は数字（ゼロから始まる）または空であることができ（この場合、暗黙的に単調増加の数字が与えられます）。

構文

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

例

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

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

暗黙的な数字を用いた例:

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

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

translate

文字列 s 中の文字を from と to 文字列によって定義された1対1の文字マッピングを使用して置き換えます。 from と to は定数のASCII文字列でなければなりません。 from と to のサイズが等しい場合、s 中の最初の first の1文字目の出現は to の1文字目で置き換えられ、first の2文字目の出現は to の2文字目で置き換えられます。
from に to に対応する文字がない場合、from の末尾にあるすべての出現は s から削除されます。非ASCII文字は関数によって変更されません。

構文

translate(s, from, to)

例

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

結果:

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

from と to の引数の長さが異なる場合:

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

結果:

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

translateUTF8

translate と同様ですが、s、from、to がUTF-8エンコードされた文字列であると仮定します。

構文

translateUTF8(s, from, to)

パラメーター

s: 文字列型 String。
from: 文字列型 String。
to: 文字列型 String。

戻り値

String 型の値。

例

クエリ:

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

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

printf

printf 関数は、引数にリストされた値（文字列、整数、浮動小数点数など）で指定された文字列をフォーマットします。これは C++ の printf 関数に似ています。フォーマット文字列には % 文字で始まるフォーマット指定子を含めることができます。% とその後のフォーマット指定子に含まれないものは、リテラルテキストとして扱われ、出力にそのままコピーされます。リテラルの % 文字は %% でエスケープできます。

構文

printf(format, arg1, arg2, ...)

例

クエリ:

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

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

overlay​

overlayUTF8​

replaceOne​

replaceAll​

replaceRegexpOne​

replaceRegexpAll​

regexpQuoteMeta​

format​

translate​

translateUTF8​

printf​

overlay

overlayUTF8

replaceOne

replaceAll

replaceRegexpOne

replaceRegexpAll

regexpQuoteMeta

format

translate

translateUTF8

printf