문자열을 검색하는 함수와 문자열을 치환하는 함수는 별도로 설명합니다.
아래 문서는 system.functions 시스템 테이블에서 생성되었습니다.
0xffffffff(zlib 구현)를 사용해 문자열의 CRC32 체크섬을 계산합니다.
구문
인수
s — CRC32를 계산할 대상 문자열입니다. String
반환 값
문자열의 CRC32 체크섬을 반환합니다. UInt32
예시
사용 예시
SELECT CRC32('ClickHouse')
┌─CRC32('ClickHouse')─┐
│ 1538217360 │
└─────────────────────┘
s — CRC32를 계산할 대상 문자열입니다. String
반환 값
문자열의 CRC32 체크섬을 반환합니다. UInt32
예시
사용 예시
SELECT CRC32IEEE('ClickHouse');
┌─CRC32IEEE('ClickHouse')─┐
│ 3089448422 │
└─────────────────────────┘
s — CRC64를 계산할 대상 문자열입니다. String
반환 값
문자열의 CRC64 체크섬을 반환합니다. UInt64
예시
사용 예시
SELECT CRC64('ClickHouse');
┌──CRC64('ClickHouse')─┐
│ 12126588151325169346 │
└──────────────────────┘
appendTrailingCharIfAbsent
s가 비어 있지 않고 문자 c로 끝나지 않으면 문자열 s의 끝에 문자 c를 추가합니다.
구문
appendTrailingCharIfAbsent(s, c)
s가 c로 끝나지 않으면 끝에 문자 c를 덧붙인 문자열 s를 반환합니다. String
예시
사용 예시
SELECT appendTrailingCharIfAbsent('https://example.com', '/');
┌─appendTraili⋯.com', '/')─┐
│ https://example.com/ │
└──────────────────────────┘
s의 첫 번째 문자의 ASCII 코드 포인트를 Int32로 반환합니다.
구문
인수
반환 값
첫 번째 문자의 ASCII 코드 포인트를 반환합니다. s가 비어 있으면 결과는 0입니다. 첫 번째 문자가 ASCII 문자가 아니거나 UTF-16의 Latin-1 Supplement 범위에 속하지 않으면 결과는 정의되지 않습니다. Int32
예시
사용 예시
┌─ascii('234')─┐
│ 50 │
└──────────────┘
encoded — String 컬럼 또는 상수. String
반환 값
인수를 디코딩한 값을 담은 문자열을 반환합니다. String
예시
사용 예시
SELECT base32Decode('IVXGG33EMVSA====');
┌─base32Decode('IVXGG33EMVSA====')─┐
│ Encoded │
└──────────────────────────────────┘
plaintext — 인코딩할 평문입니다. String
반환 값
인수의 인코딩된 값을 담은 문자열을 반환합니다. String 또는 FixedString
예시
사용 예시
SELECT base32Encode('Encoded')
┌─base32Encode('Encoded')─┐
│ IVXGG33EMVSA==== │
└─────────────────────────┘
expected_size를 지정하면 최적화된 고정 크기 디코더를 사용할 수 있습니다.
현재 지원되는 값은 32와 64입니다. 그 밖의 값에는 범용 디코더가 사용됩니다.
최적화된 디코더를 선택했지만 입력을 정확히 해당 바이트 수로 디코딩할 수 없는 경우,
함수는 예외를 발생시킵니다(tryBase58Decode는 빈 문자열을 반환).
구문
base58Decode(encoded[, expected_size])
String
예시
사용 예시
SELECT base58Decode('JxF12TrwUP45BMd');
┌─base58Decode⋯rwUP45BMd')─┐
│ Hello World │
└──────────────────────────┘
plaintext — 인코딩할 평문입니다. String
반환 값
인수의 인코딩 결과를 담은 문자열을 반환합니다. String
예시
사용 예시
SELECT base58Encode('ClickHouse');
┌─base58Encode('ClickHouse')─┐
│ 4nhk8K7GHXf6zx │
└────────────────────────────┘
FROM_BASE64
인수
encoded — 디코딩할 String 컬럼 또는 상수입니다. 문자열이 올바른 Base64 인코딩 형식이 아니면 예외가 발생합니다. String
반환 값
디코딩된 문자열을 반환합니다. String
예시
사용 예시
SELECT base64Decode('Y2xpY2tob3VzZQ==')
┌─base64Decode('Y2xpY2tob3VzZQ==')─┐
│ clickhouse │
└──────────────────────────────────┘
TO_BASE64
인수
plaintext — 디코딩할 평문 컬럼 또는 상수입니다. String
반환 값
인수의 인코딩된 값을 담은 문자열을 반환합니다. String
예시
사용 예시
SELECT base64Encode('clickhouse')
┌─base64Encode('clickhouse')─┐
│ Y2xpY2tob3VzZQ== │
└────────────────────────────┘
encoded — 인코딩할 String 컬럼 또는 상수입니다. 문자열이 유효한 Base64로 인코딩되어 있지 않으면 예외가 발생합니다. String
반환 값
인수의 디코딩된 값을 담은 문자열을 반환합니다. String
예시
사용 예시
SELECT base64URLDecode('aHR0cHM6Ly9jbGlja2hvdXNlLmNvbQ')
┌─base64URLDecode('aHR0cHM6Ly9jbGlja2hvdXNlLmNvbQ')─┐
│ https://clickhouse.com │
└───────────────────────────────────────────────────┘
base64URLEncode(plaintext)
plaintext — 인코딩할 평문 컬럼 또는 상수입니다. String
반환 값
인수의 인코딩된 값을 담은 문자열을 반환합니다. String
예시
사용 예시
SELECT base64URLEncode('https://clickhouse.com')
┌─base64URLEncode('https://clickhouse.com')─┐
│ aHR0cHM6Ly9jbGlja2hvdXNlLmNvbQ │
└───────────────────────────────────────────┘
expr — 문자열 표현식입니다. 백슬래시는 이스케이프해야 합니다. String
반환 값
입력 문자열에서 마지막 슬래시 또는 백슬래시 뒤의 부분을 반환합니다. 입력 문자열이 슬래시 또는 백슬래시로 끝나면 함수는 빈 문자열을 반환합니다. 슬래시나 백슬래시가 없으면 원래 문자열을 반환합니다. String
예시
Unix 경로에서 파일 이름 추출
SELECT 'some/long/path/to/file' AS a, basename(a)
┌─a──────────────────────┬─basename('some/long/path/to/file')─┐
│ some/long/path/to/file │ file │
└────────────────────────┴────────────────────────────────────┘
SELECT 'some\\long\\path\\to\\file' AS a, basename(a)
┌─a──────────────────────┬─basename('some\\long\\path\\to\\file')─┐
│ some\long\path\to\file │ file │
└────────────────────────┴────────────────────────────────────────┘
SELECT 'some-file-name' AS a, basename(a)
┌─a──────────────┬─basename('some-file-name')─┐
│ some-file-name │ some-file-name │
└────────────────┴────────────────────────────┘
byteHammingDistance(s1, s2)
mismatches
인수
반환 값
두 문자열 간의 해밍 거리를 반환합니다. UInt64
예시
사용 예시
SELECT byteHammingDistance('karolin', 'kathrin')
┌─byteHammingDistance('karolin', 'kathrin')─┐
│ 3 │
└───────────────────────────────────────────┘
ffi 같은 일부 합자는 유니코드 대소문자 접기 자체에서 확장되므로 여전히 분해됩니다.
구문
인수
str — UTF-8로 인코딩된 입력 문자열입니다. String
반환 값
케이스 폴딩된 UTF-8 문자열입니다. String
예시
기본 케이스 폴딩
SELECT caseFoldUTF8('Straße')
┌─caseFoldUTF8('Straße')─┐
│ strasse │
└─────────────────────────┘
compareSubstrings(s1, s2, s1_offset, s2_offset, num_bytes)
s1 — 비교할 첫 번째 문자열입니다. Strings2 — 비교할 두 번째 문자열입니다. Strings1_offset — 비교를 시작할 s1 내 위치(0부터 시작)입니다. UInt*s2_offset — 비교를 시작할 s2 내 위치(0부터 시작하는 인덱스)입니다. UInt*num_bytes — 두 문자열에서 비교할 최대 바이트 수입니다. s1_offset(또는 s2_offset) + num_bytes가 입력 문자열의 끝을 넘으면 num_bytes는 그에 맞게 줄어듭니다. UInt*
반환 값
반환 값:
s1[s1_offset : s1_offset + num_bytes] < s2[s2_offset : s2_offset + num_bytes]이면 -1을 반환합니다.s1[s1_offset : s1_offset + num_bytes] = s2[s2_offset : s2_offset + num_bytes]이면 0을 반환합니다.s1[s1_offset : s1_offset + num_bytes] > s2[s2_offset : s2_offset + num_bytes]이면 1을 반환합니다.
Int8
예시
사용 예시
SELECT compareSubstrings('Saxony', 'Anglo-Saxon', 0, 6, 5) AS result
┌─result─┐
│ 0 │
└────────┘
String 또는 FixedString 타입이 아닌 인수는 기본 직렬화를 사용해 문자열로 변환됩니다.
이 경우 성능이 저하되므로 String/FixedString이 아닌 인수는 사용하지 않는 것이 좋습니다.
구문
인수
s1, s2, ... — 개수 제한이 없는 임의의 타입의 값입니다. Any
반환 값
인수를 이어 붙여 생성한 String을 반환합니다. 인수 중 하나라도 NULL이면 함수는 NULL을 반환합니다. 인수가 없으면 빈 문자열을 반환합니다. Nullable(String)
예시
문자열 연결
SELECT concat('Hello, ', 'World!')
┌─concat('Hello, ', 'World!')─┐
│ Hello, World! │
└─────────────────────────────┘
┌─concat(42, 144)─┐
│ 42144 │
└─────────────────┘
concat과 비슷하지만 concat(s1, s2, ...) → sn이 단사적이라고 가정합니다.
즉, 서로 다른 인수에 대해서는 서로 다른 결과를 반환합니다.
GROUP BY를 최적화하는 데 사용할 수 있습니다.
구문
concatAssumeInjective([s1, s2, ...])
NULL이면 함수는 NULL을 반환합니다. 인수가 전달되지 않으면 빈 문자열을 반환합니다. String
예시
GROUP BY 최적화
SELECT concat(key1, key2), sum(value) FROM key_val GROUP BY concatAssumeInjective(key1, key2)
┌─concat(key1, key2)─┬─sum(value)─┐
│ Hello, World! │ 3 │
│ Hello, World! │ 2 │
│ Hello, World │ 3 │
└────────────────────┴────────────┘
concatWithSeparator(sep[, exp1, exp2, ...])
concat_ws
인수
sep — 사용할 구분자입니다. const String 또는 const FixedStringexp1, exp2, ... — 연결할 표현식입니다. String 또는 FixedString 타입이 아닌 인수는 기본 직렬화(serialization)를 사용해 문자열로 변환됩니다. 이 경우 성능이 저하되므로 String/FixedString이 아닌 인수는 사용하지 않는 것이 좋습니다. Any
반환 값
인수를 연결해 생성된 String을 반환합니다. 인수 값 중 하나라도 NULL이면 함수는 NULL을 반환합니다. String
예시
사용 예시
SELECT concatWithSeparator('a', '1', '2', '3', '4')
┌─concatWithSeparator('a', '1', '2', '3', '4')─┐
│ 1a2a3a4 │
└──────────────────────────────────────────────┘
concatWithSeparatorAssumeInjective
concatWithSeparator와 비슷하지만, concatWithSeparator(sep[,exp1, exp2, ... ]) → result가 단사적이라고 가정합니다.
함수는 서로 다른 인수에 대해 서로 다른 결과를 반환할 때 단사적이라고 합니다.
GROUP BY 최적화에 사용할 수 있습니다.
구문
concatWithSeparatorAssumeInjective(sep[, exp1, exp2, ... ])
sep — 사용할 구분자입니다. const String 또는 const FixedStringexp1, exp2, ... — 연결할 표현식입니다. String 또는 FixedString 타입이 아닌 인수는 기본 직렬화(serialization)를 사용해 문자열로 변환됩니다. 이로 인해 성능이 저하되므로 String/FixedString이 아닌 인수는 사용하지 않는 것이 좋습니다. String 또는 FixedString
반환 값
인수를 연결해 생성한 String을 반환합니다. 인수 값 중 하나라도 NULL이면 함수는 NULL을 반환합니다. String
예시
사용 예시
CREATE TABLE user_data (
user_id UInt32,
first_name String,
last_name String,
score UInt32
)
ENGINE = MergeTree
ORDER BY tuple();
INSERT INTO user_data VALUES
(1, 'John', 'Doe', 100),
(2, 'Jane', 'Smith', 150),
(3, 'John', 'Wilson', 120),
(4, 'Jane', 'Smith', 90);
SELECT
concatWithSeparatorAssumeInjective('-', first_name, last_name) as full_name,
sum(score) as total_score
FROM user_data
GROUP BY concatWithSeparatorAssumeInjective('-', first_name, last_name);
┌─full_name───┬─total_score─┐
│ Jane-Smith │ 240 │
│ John-Doe │ 100 │
│ John-Wilson │ 120 │
└─────────────┴─────────────┘
conv(number, from_base, to_base)
number — 변환할 숫자입니다. 문자열 또는 숫자형일 수 있습니다. - from_base — 원래 진법(2-36)입니다. 정수여야 합니다. - to_base — 대상 진법(2-36)입니다. 정수여야 합니다.
반환 값
대상 진법으로 나타낸 숫자의 문자열 형식입니다.
예시
10진수를 2진수로 변환
16진수를 10진수로 변환
SELECT conv('FF', 16, 10)
SELECT conv('-1', 10, 16)
SELECT conv('1010', 2, 8)
s를 인코딩 from에서 인코딩 to로 변환해 반환합니다.
구문
convertCharset(s, from, to)
s를 인코딩 from에서 인코딩 to로 변환한 값을 반환합니다. String
예시
사용 예시
SELECT convertCharset('Café', 'UTF-8', 'ISO-8859-1');
┌─convertChars⋯SO-8859-1')─┐
│ Caf� │
└──────────────────────────┘
damerauLevenshteinDistance
damerauLevenshteinDistance(s1, s2)
UInt64
예시
사용 예시
SELECT damerauLevenshteinDistance('clickhouse', 'mouse')
┌─damerauLevenshteinDistance('clickhouse', 'mouse')─┐
│ 6 │
└───────────────────────────────────────────────────┘
s — 디코딩할 HTML 엔터티가 포함된 String입니다. String
반환 값
HTML 엔터티가 디코딩된 문자열을 반환합니다. String
예시
사용 예시
SELECT decodeHTMLComponent('<div>Hello & "World"</div>')
┌─decodeHTMLComponent('<div>Hello & "World"</div>')─┐
│ <div>Hello & "World"</div> │
└─────────────────────────────────────────────────────────────────────────────┘
s — 디코딩할 XML 엔터티가 포함된 String입니다. String
반환 값
제공된 문자열에서 XML 엔터티를 디코딩한 String을 반환합니다. String
예시
사용 예시
SELECT decodeXMLComponent('<tag>Hello & World</tag>')
┌─decodeXMLCom⋯;/tag>')─┐
│ <tag>Hello & World</tag> │
└──────────────────────────┘
levenshteinDistance
인수
반환 값
두 문자열 간의 편집 거리를 반환합니다. UInt64
예시
사용 예시
SELECT editDistance('clickhouse', 'mouse')
┌─editDistance('clickhouse', 'mouse')─┐
│ 6 │
└─────────────────────────────────────┘
levenshteinDistanceUTF8
인수
반환 값
두 UTF8 문자열 간의 편집 거리를 반환합니다. UInt64
예시
사용 예시
SELECT editDistanceUTF8('我是谁', '我是我')
┌─editDistanceUTF8('我是谁', '我是我')──┐
│ 1 │
└─────────────────────────────────────┘
String
예시
사용 예시
SELECT
'<tag>Hello & "World"</tag>' AS original,
encodeXMLComponent('<tag>Hello & "World"</tag>') AS xml_encoded;
┌─original───────────────────┬─xml_encoded──────────────────────────────────────────┐
│ <tag>Hello & "World"</tag> │ <tag>Hello & "World"</tag> │
└────────────────────────────┴──────────────────────────────────────────────────────┘
s가 suffix로 끝나면 1을 반환하고, 그렇지 않으면 0을 반환합니다. UInt8
예시
사용 예시
SELECT endsWith('ClickHouse', 'House');
┌─endsWith('Cl⋯', 'House')─┐
│ 1 │
└──────────────────────────┘
endsWithCaseInsensitive(s, suffix)
s — 검사할 문자열입니다. Stringsuffix — 대소문자를 구분하지 않고 검사할 접미사입니다. String
반환 값
s가 대소문자를 구분하지 않는 suffix로 끝나면 1을, 그렇지 않으면 0을 반환합니다. UInt8
예시
사용 예시
SELECT endsWithCaseInsensitive('ClickHouse', 'HOUSE');
┌─endsWithCaseInsensitive('Cl⋯', 'HOUSE')─┐
│ 1 │
└─────────────────────────────────────────┘
endsWithCaseInsensitiveUTF8
s가 대소문자를 구분하지 않는 suffix로 끝나는지 여부를 반환합니다.
문자열에 유효한 UTF-8로 인코딩된 텍스트가 포함되어 있다고 가정합니다.
이 가정이 충족되지 않아도 예외는 발생하지 않으며, 결과는 정의되지 않습니다.
구문
endsWithCaseInsensitiveUTF8(s, suffix)
s — 확인할 문자열입니다. Stringsuffix — 확인할, 대소문자를 구분하지 않는 접미사입니다. String
반환 값
s가 대소문자를 구분하지 않는 suffix로 끝나면 1을 반환하고, 그렇지 않으면 0을 반환합니다. UInt8
예시
사용 예시
SELECT endsWithCaseInsensitiveUTF8('данных', 'ых');
┌─endsWithCaseInsensitiveUTF8('данных', 'ых')─┐
│ 1 │
└─────────────────────────────────────────────┘
s가 suffix로 끝나는지 여부를 반환합니다.
문자열이 유효한 UTF-8로 인코딩된 텍스트라고 가정합니다.
이 가정이 충족되지 않아도 예외가 발생하지 않으며, 결과는 정의되지 않습니다.
구문
인수
반환 값
s가 suffix로 끝나면 1을 반환하고, 그렇지 않으면 0을 반환합니다. UInt8
예시
사용 예시
SELECT endsWithUTF8('данных', 'ых');
┌─endsWithUTF8('данных', 'ых')─┐
│ 1 │
└──────────────────────────────┘
- 모든 HTML/XML 태그 제거
- 주석 제거 (
{/* */})
- script 및 style 요소와 해당 콘텐츠 제거
- CDATA 섹션 처리(원문 그대로 복사)
- 공백의 적절한 처리 및 정규화
참고: HTML 엔터티는 디코딩되지 않으므로, 필요한 경우 별도의 함수로 처리해야 합니다.
구문
extractTextFromHTML(html)
html — 텍스트를 추출할 HTML 콘텐츠를 포함하는 String입니다. String
반환 값
정규화된 공백이 적용된 텍스트 콘텐츠를 반환합니다. String
예시
사용 예시
SELECT extractTextFromHTML('
<html>
<head><title>Page Title</title></head>
<body>
<p>Hello <b>World</b>!</p>
<script>alert("test");</script>
<!-- comment -->
</body>
</html>
');
┌─extractTextFromHTML('<html><head>...')─┐
│ Page Title Hello World! │
└────────────────────────────────────────┘
String
예시
사용 예시
SELECT firstLine('foo\\nbar\\nbaz')
┌─firstLine('foo\nbar\nbaz')─┐
│ foo │
└────────────────────────────┘
idnaEncode()와 idnaDecode()를 반복 적용해도 원래 문자열이 반환된다고 보장되지는 않습니다.
구문
인수
반환 값
입력 값에 적용되는 IDNA 메커니즘에 따라 입력 문자열의 유니코드(UTF-8) 표현을 반환합니다. String
예시
사용 예시
SELECT idnaDecode('xn--strae-oqa.xn--mnchen-3ya.de')
┌─idnaDecode('xn--strae-oqa.xn--mnchen-3ya.de')─┐
│ straße.münchen.de │
└───────────────────────────────────────────────┘
퍼센트 디코딩이나 탭, 공백 또는 제어 문자의 제거는 수행되지 않습니다.
String
예시
사용 예시
SELECT idnaEncode('straße.münchen.de')
┌─idnaEncode('straße.münchen.de')─────┐
│ xn--strae-oqa.xn--mnchen-3ya.de │
└─────────────────────────────────────┘
initcap는 각 단어의 첫 글자만 대문자로 변환하므로 아포스트로피나 대문자가 포함된 단어에서는 예상하지 못한 동작이 발생할 수 있습니다.
이는 알려진 동작이며 현재로서는 수정할 계획이 없습니다.
s를 반환합니다. String
예시
사용 예시
SELECT initcap('building for fast')
┌─initcap('building for fast')─┐
│ Building For Fast │
└──────────────────────────────┘
SELECT initcap('John''s cat won''t eat.');
┌─initcap('Joh⋯n\'t eat.')─┐
│ John'S Cat Won'T Eat. │
└──────────────────────────┘
initcap와 마찬가지로 initcapUTF8은 각 단어의 첫 글자를 대문자로, 나머지 글자를 소문자로 변환합니다.
문자열이 유효한 UTF-8로 인코딩된 텍스트를 포함한다고 가정합니다.
이 가정이 충족되지 않아도 예외는 발생하지 않으며 결과는 정의되지 않습니다.
이 함수는 언어를 감지하지 않습니다. 예를 들어 터키어에서는 결과가 완전히 정확하지 않을 수 있습니다(i/İ 대 i/I).
코드 포인트의 대문자와 소문자에서 UTF-8 바이트 시퀀스 길이가 서로 다르면 해당 코드 포인트의 결과가 올바르지 않을 수 있습니다.
s를 반환합니다. String
예시
사용 예시
SELECT initcapUTF8('не тормозит')
┌─initcapUTF8('не тормозит')─┐
│ Не Тормозит │
└────────────────────────────┘
isASCII
인수
반환 값
예시
isValidASCII
SELECT isValidASCII('hello') AS is_ascii, isValidASCII('你好') AS is_not_ascii
s — UTF-8로 인코딩된 문자열이 유효한지 검사할 문자열입니다. String
반환 값
바이트 집합이 유효한 UTF-8 인코딩 텍스트를 구성하면 1을, 그렇지 않으면 0을 반환합니다. UInt8
예시
사용 예시
SELECT isValidUTF8('\\xc3\\xb1') AS valid, isValidUTF8('\\xc3\\x28') AS invalid
┌─valid─┬─invalid─┐
│ 1 │ 0 │
└───────┴─────────┘
Float64
예시
사용 예시
SELECT jaroSimilarity('clickhouse', 'click')
┌─jaroSimilarity('clickhouse', 'click')─┐
│ 0.8333333333333333 │
└───────────────────────────────────────┘
jaroWinklerSimilarity(s1, s2)
Float64
예시
사용 예시
SELECT jaroWinklerSimilarity('clickhouse', 'click')
┌─jaroWinklerSimilarity('clickhouse', 'click')─┐
│ 0.8999999999999999 │
└──────────────────────────────────────────────┘
s에서 왼쪽부터 지정한 offset 위치에서 시작하는 부분 문자열을 반환합니다.
구문
인수
반환 값
다음을 반환합니다.
offset이 양수이면, 문자열의 왼쪽에서 시작하는 offset바이트 길이의 s 부분 문자열입니다.offset이 음수이면, 문자열의 왼쪽에서 시작하는 length(s) - |offset|바이트 길이의 s 부분 문자열입니다.length가 0이면 빈 문자열을 반환합니다.
String
예시
양수 오프셋
SELECT left('Hello World', 5)
SELECT left('Hello World', -6)
length에 도달할 때까지 문자열 왼쪽을 공백 또는 지정된 문자열로(필요한 경우 여러 번) 채웁니다.
구문
leftPad(string, length[, pad_string])
lpad
인수
string — 패딩할 입력 문자열입니다. Stringlength — 결과 문자열의 길이입니다. 값이 입력 문자열의 길이보다 작으면 입력 문자열은 length개의 문자로 잘립니다. (U)Int*pad_string — 선택 사항입니다. 입력 문자열을 패딩하는 데 사용할 문자열입니다. 지정하지 않으면 입력 문자열은 공백으로 패딩됩니다. String
반환 값
지정한 길이가 되도록 왼쪽이 패딩된 문자열을 반환합니다. String
예시
사용 예시
SELECT leftPad('abc', 7, '*'), leftPad('def', 7)
┌─leftPad('abc', 7, '*')─┬─leftPad('def', 7)─┐
│ ****abc │ def │
└────────────────────────┴───────────────────┘
leftPad와 달리, 이 함수는 문자열 길이를 코드 포인트 단위로 측정합니다.
구문
leftPadUTF8(string, length[, pad_string])
string — 패딩할 입력 문자열입니다. Stringlength — 결과 문자열의 길이입니다. 값이 입력 문자열의 길이보다 작으면 입력 문자열은 length자로 잘립니다. (U)Int*pad_string — 선택 사항입니다. 입력 문자열을 채울 때 사용할 문자열입니다. 지정하지 않으면 입력 문자열은 공백으로 채워집니다. String
반환 값
지정된 길이가 되도록 왼쪽이 채워진 문자열을 반환합니다. String
예시
사용 예시
SELECT leftPadUTF8('абвг', 7, '*'), leftPadUTF8('дежз', 7)
┌─leftPadUTF8('абвг', 7, '*')─┬─leftPadUTF8('дежз', 7)─┐
│ ***абвг │ дежз │
└─────────────────────────────┴────────────────────────┘
s에서 왼쪽을 기준으로 지정된 offset부터 부분 문자열을 반환합니다.
구문
인수
반환 값
반환 값:
offset이 양수이면 문자열의 왼쪽부터 시작해 offset바이트인 s의 부분 문자열을 반환합니다.\n”offset이 음수이면 문자열의 왼쪽부터 시작해 length(s) - |offset|바이트인 s의 부분 문자열을 반환합니다.\n”length가 0이면 빈 문자열을 반환합니다.
String
예시
양수 offset
SELECT leftUTF8('Привет', 4)
SELECT leftUTF8('Привет', -4)
CHARACTER_LENGTH, CHAR_LENGTH
인수
s — 유효한 UTF-8로 인코딩된 텍스트를 포함하는 String. String
반환 값
문자열 s의 길이를 유니코드 코드 포인트 기준으로 반환합니다. UInt64
예시
사용 예시
SELECT lengthUTF8('Здравствуй, мир!')
┌─lengthUTF8('Здравствуй, мир!')─┐
│ 16 │
└────────────────────────────────┘
lcase
인수
반환 값
s를 소문자로 변환한 문자열을 반환합니다. String
예시
사용 예시
SELECT lower('CLICKHOUSE')
┌─lower('CLICKHOUSE')─┐
│ clickhouse │
└─────────────────────┘
input — 소문자로 변환할 입력 문자열입니다. String
반환 값
소문자 문자열을 반환합니다. String
예시
첫 번째
SELECT lowerUTF8('München') as Lowerutf8;
NATURAL_SORT_KEY
인수
s — 자연 정렬 키 문자열로 변환할 문자열입니다. String
반환 값
s에서 생성된 자연 정렬 키 문자열을 반환합니다. String
예시
사용 예시
SELECT s FROM t ORDER BY naturalSortKey(s)
┌─s───┐
│ a1 │
| a02 │
└─────┘
str — UTF-8로 인코딩된 입력 문자열입니다. String
반환 값
UTF-8 문자열의 NFC 정규화된 형태를 반환합니다. String
예시
사용 예시
SELECT
'é' AS original, -- e + 결합 악센트 부호 (U+0065 + U+0301)
length(original),
normalizeUTF8NFC('é') AS nfc_normalized, -- é (U+00E9)
length(nfc_normalized);
┌─original─┬─length(original)─┬─nfc_normalized─┬─length(nfc_normalized)─┐
│ é │ 2 │ é │ 2 │
└──────────┴──────────────────┴────────────────┴────────────────────────┘
str — UTF-8로 인코딩된 입력 문자열입니다. String
반환 값
UTF-8 문자열의 NFD로 정규화된 형태를 반환합니다. String
예시
사용 예시
SELECT
'é' AS original, -- é (U+00E9)
length(original),
normalizeUTF8NFD('é') AS nfd_normalized, -- e + 결합 악센트 (U+0065 + U+0301)
length(nfd_normalized);
┌─original─┬─length(original)─┬─nfd_normalized─┬─length(nfd_normalized)─┐
│ é │ 2 │ é │ 3 │
└──────────┴──────────────────┴────────────────┴────────────────────────┘
str — UTF-8로 인코딩된 입력 문자열입니다. String
반환 값
UTF-8 문자열을 NFKC로 정규화한 값을 반환합니다. String
예시
사용 예시
SELECT
'① ② ③' AS original, -- 원형 숫자 문자
normalizeUTF8NFKC('① ② ③') AS nfkc_normalized; -- 1 2 3으로 변환
┌─original─┬─nfkc_normalized─┐
│ ① ② ③ │ 1 2 3 │
└──────────┴─────────────────┘
normalizeUTF8NFKCCasefold
normalizeUTF8NFKCCasefold(str)
str — UTF-8로 인코딩된 입력 문자열입니다. String
반환 값
UTF-8 문자열의 NFKC_Casefold 정규화 형태를 반환합니다. String
예시
사용 예시
SELECT
'Ä ① Hello' AS original,
normalizeUTF8NFKCCasefold('Ä ① Hello') AS nfkc_cf_normalized;
┌─original───┬─nfkc_cf_normalized─┐
│ Ä ① Hello │ ä 1 hello │
└────────────┴────────────────────┘
str — UTF-8로 인코딩된 입력 문자열입니다. String
반환 값
UTF-8 문자열의 NFKD 정규화된 형식을 반환합니다. String
예시
사용 예시
SELECT
'H₂O²' AS original, -- H + 아래 첨자 2 + O + 위 첨자 2
normalizeUTF8NFKD('H₂O²') AS nfkd_normalized; -- H 2 O 2로 변환
┌─original─┬─nfkd_normalized─┐
│ H₂O² │ H2O2 │
└──────────┴─────────────────┘
s — Punycode로 인코딩된 문자열입니다. String
반환 값
입력값의 평문을 반환합니다. String
예시
사용 예시
SELECT punycodeDecode('Mnchen-3ya')
┌─punycodeDecode('Mnchen-3ya')─┐
│ München │
└──────────────────────────────┘
String
예시
사용 예시
SELECT punycodeEncode('München')
┌─punycodeEncode('München')─┐
│ Mnchen-3ya │
└───────────────────────────┘
haystack의 첫 번째 문자열을 추출합니다.
구문
regexpExtract(haystack, pattern[, index])
REGEXP_EXTRACT
인수
haystack — 정규식 패턴을 일치시킬 String입니다. Stringpattern — String, 정규식 표현식입니다. pattern에는 여러 개의 정규식 그룹이 포함될 수 있으며, index는 추출할 정규식 그룹을 나타냅니다. 인덱스가 0이면 정규식 전체와 일치하는 값을 의미합니다. const Stringindex — 선택 사항입니다. 기본값은 1이며 0 이상인 정수입니다. 추출할 정규식 그룹을 나타냅니다. (U)Int*
반환 값
일치한 문자열을 반환합니다. String
예시
사용 예시
SELECT
regexpExtract('100-200', '(\\d+)-(\\d+)', 1),
regexpExtract('100-200', '(\\d+)-(\\d+)', 2),
regexpExtract('100-200', '(\\d+)-(\\d+)', 0),
regexpExtract('100-200', '(\\d+)-(\\d+)');
┌─regexpExtract('100-200', '(\\d+)-(\\d+)', 1)─┬─regexpExtract('100-200', '(\\d+)-(\\d+)', 2)─┬─regexpExtract('100-200', '(\\d+)-(\\d+)', 0)─┬─regexpExtract('100-200', '(\\d+)-(\\d+)')─┐
│ 100 │ 200 │ 100-200 │ 100 │
└──────────────────────────────────────────────┴──────────────────────────────────────────────┴──────────────────────────────────────────────┴───────────────────────────────────────────┘
position에서 검색을 시작해, haystack에서 pattern이 occurrence번째로 일치하는 바이트 위치(1부터 시작)를 반환합니다.
return_option이 0(기본값)이면 일치 항목의 첫 번째 바이트 위치를 반환합니다. 1이면 일치 항목 직후 첫 번째 바이트의 위치를 반환합니다.
subexpression이 0보다 크면 전체 일치 항목이 아니라 해당 캡처 그룹의 위치를 반환합니다.
일치 항목을 찾지 못했거나 요청한 캡처 그룹이 일치에 포함되지 않은 경우 0을 반환합니다.
PostgreSQL의 regexp_instr와의 호환성을 위해 제공되며(해당 alias로도 노출됨), 위치는 바이트 기준이라는 점에 유의하십시오. 이는 다른 ClickHouse 정규식 함수와 일관되며 PostgreSQL의 regexp_instr는 문자 기준입니다.
구문
regexpPosition(haystack, pattern[, position[, occurrence[, return_option[, flags[, subexpression]]]]])
regexpInstr, regexp_instr
인수
haystack — 검색할 문자열입니다. Stringpattern — 정규식 패턴입니다. const Stringposition — 선택 사항입니다. 검색을 시작할 1부터 시작하는 바이트 위치입니다. 기본값: 1. (U)Int*occurrence — 선택 사항입니다. 반환할 일치 항목의 순서입니다. 기본값: 1. (U)Int*return_option — 선택 사항입니다. 0은 일치 시작 위치를 반환하고, 1은 일치 바로 뒤의 위치를 반환합니다. 기본값: 0. (U)Int*flags — 선택 사항입니다. 정규식 플래그입니다. 지원 항목: i (대소문자 구분 안 함), c (대소문자 구분), m/n (여러 줄 앵커), s (점이 줄바꿈과 일치). 기본값: 빈 문자열. const Stringsubexpression — 선택 사항입니다. 위치를 반환할 캡처 그룹의 인덱스입니다. 0은 전체 일치를 의미합니다. 기본값: 0. (U)Int*
반환 값
일치하는 항목의 바이트 위치를 반환하며, 찾지 못한 경우 0을 반환합니다. UInt64
예시
기본 사용법
SELECT
regexpPosition('hello world', 'world'),
regexpPosition('aXbXcXd', 'X', 1, 2),
regexpPosition('aXbXcXd', 'X', 1, 2, 1),
regexpPosition('Hello WORLD', 'world', 1, 1, 0, 'i'),
regexpPosition('foo123bar456', '([a-z]+)([0-9]+)', 1, 2, 0, '', 2);
┌─...─┬─...─┬─...─┬─...─┬─...─┐
│ 7 │ 4 │ 5 │ 7 │ 10 │
└─────┴─────┴─────┴─────┴─────┘
removeDiacriticsUTF8(str)
removeAccentsUTF8
인수
str — UTF-8로 인코딩된 입력 문자열입니다. String
반환 값
발음 구별 부호가 제거된 UTF-8 문자열입니다. String
예시
기본 발음 구별 부호 제거
SELECT removeDiacriticsUTF8('café résumé naïve')
┌─removeDiacriticsUTF8('café résumé naïve')─┐
│ cafe resume naive │
└────────────────────────────────────────────┘
s를 n회 반복한 문자열입니다. n이 음수이면 빈 문자열을 반환합니다. String
예시
사용 예시
┌─repeat('abc', 10)──────────────┐
│ abcabcabcabcabcabcabcabcabcabc │
└────────────────────────────────┘
s — 유효한 UTF-8 인코딩 텍스트를 포함하는 String입니다. String
반환 값
유니코드 코드 포인트 시퀀스를 역순으로 뒤집은 문자열을 반환합니다. String
예시
사용 예시
SELECT reverseUTF8('ClickHouse')
s의 오른쪽부터 지정한 offset 위치에서 시작하는 부분 문자열을 반환합니다.
구문
인수
반환 값
다음을 반환합니다:
offset이 양수이면 문자열의 오른쪽에서 시작해 offset바이트 길이의 s 부분 문자열을 반환합니다.offset이 음수이면 문자열의 오른쪽에서 시작해 length(s) - |offset|바이트 길이의 s 부분 문자열을 반환합니다.length가 0이면 빈 문자열을 반환합니다.
String
예시
양수 offset
음수 오프셋
SELECT right('Hello', -3)
length에 도달할 때까지 문자열 오른쪽을 공백 또는 지정된 문자열로(필요한 경우 여러 번) 채웁니다.
구문
rightPad(string, length[, pad_string])
rpad
인수
string — 패딩할 입력 문자열입니다. Stringlength — 결과 문자열의 길이입니다. 값이 입력 문자열의 길이보다 작으면 입력 문자열은 length개의 문자로 잘립니다. (U)Int*pad_string — 선택 사항입니다. 입력 문자열을 채우는 데 사용할 문자열입니다. 지정하지 않으면 입력 문자열은 공백으로 채워집니다. String
반환 값
지정된 길이가 되도록 오른쪽이 채워진 문자열을 반환합니다. String
예시
사용 예시
SELECT rightPad('abc', 7, '*'), rightPad('abc', 7)
┌─rightPad('abc', 7, '*')─┬─rightPad('abc', 7)─┐
│ abc**** │ abc │
└─────────────────────────┴────────────────────┘
rightPad와 달리, 이 함수는 문자열 길이를 코드 포인트 단위로 측정합니다.
구문
rightPadUTF8(string, length[, pad_string])
string — 패딩할 입력 문자열입니다. Stringlength — 결과 문자열의 길이입니다. 값이 입력 문자열의 길이보다 작으면 입력 문자열은 length개의 문자로 잘립니다. (U)Int*pad_string — 선택 사항입니다. 입력 문자열을 패딩할 때 사용할 문자열입니다. 지정하지 않으면 입력 문자열은 공백으로 패딩됩니다. String
반환 값
지정된 길이가 되도록 오른쪽에 패딩된 문자열을 반환합니다. String
예시
사용 예시
SELECT rightPadUTF8('абвг', 7, '*'), rightPadUTF8('абвг', 7)
┌─rightPadUTF8('абвг', 7, '*')─┬─rightPadUTF8('абвг', 7)─┐
│ абвг*** │ абвг │
└──────────────────────────────┴─────────────────────────┘
s의 오른쪽에서부터 지정한 offset 위치에서 시작하는 부분 문자열을 반환합니다.
구문
인수
반환 값
다음을 반환합니다.
offset이 양수이면, 문자열의 오른쪽에서 시작해 offset바이트 길이의 s 부분 문자열을 반환합니다.offset이 음수이면, 문자열의 오른쪽에서 시작해 length(s) - |offset|바이트 길이의 s 부분 문자열을 반환합니다.length가 0이면 빈 문자열을 반환합니다.
String
예시
양수 오프셋
SELECT rightUTF8('Привет', 4)
SELECT rightUTF8('Привет', -4)
String
예시
사용 예시
┌─soundex('aksel')─┐
│ A240 │
└──────────────────┘
)을 지정한 횟수만큼 반복해 연결합니다.
구문
인수
반환 값
공백이 n번 반복된 문자열을 반환합니다. n <= 0이면 빈 문자열을 반환합니다. String
예시
사용 예시
SELECT space(3) AS res, length(res);
┌─res─┬─length(res)─┐
│ │ 3 │
└─────┴─────────────┘
n인 모든 부분 문자열을 찾습니다.
이때 부분 문자열의 양쪽 경계에 있는 (n-1)-gram의 해시는
부분 문자열 내부의 어떤 (n-1)-gram의 해시보다도 반드시 커야 합니다.
해시 함수로 CRC32를 사용합니다.
구문
sparseGrams(s[, min_ngram_length[, max_ngram_length[, min_cutoff_length]]])
s — 입력 문자열입니다. Stringmin_ngram_length — 선택 사항입니다. 추출할 n-그램의 최소 길이입니다. 기본값이자 최소값은 3입니다. UInt*max_ngram_length — 선택 사항입니다. 추출할 n-그램의 최대 길이입니다. 기본값은 100입니다. min_ngram_length보다 작으면 안 됩니다. UInt*min_cutoff_length — 선택 사항입니다. 지정하면 길이가 min_cutoff_length 이상인 n-그램만 반환됩니다. 기본값은 min_ngram_length와 같습니다. min_ngram_length보다 작으면 안 되며 max_ngram_length보다 크면 안 됩니다. UInt*
반환 값
선택된 부분 문자열의 배열을 반환합니다. Array(String)
예시
사용 예시
SELECT sparseGrams('alice', 3)
┌─sparseGrams('alice', 3)────────────┐
│ ['ali','lic','lice','ice'] │
└────────────────────────────────────┘
n인 모든 부분 문자열의 해시를 찾습니다.
이때 부분 문자열 경계에 있는 (n-1)-gram의 해시는
부분 문자열 내부의 어떤 (n-1)-gram의 해시보다도 반드시 커야 합니다.
해시 함수로 CRC32를 사용합니다.
구문
sparseGramsHashes(s[, min_ngram_length, max_ngram_length])
s — 입력 문자열입니다. Stringmin_ngram_length — 선택 사항입니다. 추출할 n-그램의 최소 길이입니다. 기본값이자 최솟값은 3입니다. UInt*max_ngram_length — 선택 사항입니다. 추출할 n-그램의 최대 길이입니다. 기본값은 100입니다. min_ngram_length보다 작아서는 안 됩니다. UInt*min_cutoff_length — 선택 사항입니다. 지정하면 길이가 min_cutoff_length 이상인 n-그램만 반환됩니다. 기본값은 min_ngram_length와 같습니다. min_ngram_length보다 작아서는 안 되며 max_ngram_length보다 커서도 안 됩니다. UInt*
반환 값
선택된 부분 문자열의 CRC32 해시로 구성된 배열을 반환합니다. Array(UInt32)
예시
사용 예시
SELECT sparseGramsHashes('alice', 3)
┌─sparseGramsHashes('alice', 3)──────────────────────┐
│ [1481062250,2450405249,4012725991,1918774096] │
└────────────────────────────────────────────────────┘
n인 모든 부분 문자열의 해시를 찾습니다. 이때 부분 문자열 경계에 있는 (n-1)-gram의 해시는 부분 문자열 내부의 어떤 (n-1)-gram의 해시보다도 반드시 커야 합니다.
UTF-8 문자열을 입력으로 받으며, UTF-8 시퀀스가 올바르지 않으면 예외를 발생시킵니다.
해시 함수로 CRC32를 사용합니다.
구문
sparseGramsHashesUTF8(s[, min_ngram_length, max_ngram_length])
s — 입력 문자열입니다. Stringmin_ngram_length — 선택 사항입니다. 추출할 n-그램의 최소 길이입니다. 기본값이자 최소값은 3입니다. UInt*max_ngram_length — 선택 사항입니다. 추출할 n-그램의 최대 길이입니다. 기본값은 100입니다. min_ngram_length보다 작아서는 안 됩니다. UInt*min_cutoff_length — 선택 사항입니다. 지정하면 길이가 min_cutoff_length 이상인 n-그램만 반환됩니다. 기본값은 min_ngram_length와 같습니다. min_ngram_length보다 작아서는 안 되며 max_ngram_length보다 커서도 안 됩니다. UInt*
반환 값
선택된 UTF-8 부분 문자열의 CRC32 해시로 이루어진 배열을 반환합니다. Array(UInt32)
예시
사용 예시
SELECT sparseGramsHashesUTF8('алиса', 3)
┌─sparseGramsHashesUTF8('алиса', 3)─┐
│ [4178533925,3855635300,561830861] │
└───────────────────────────────────┘
n인 모든 부분 문자열을 찾습니다. 이때 부분 문자열의 경계에 있는 (n-1)-gram의 해시 값은 부분 문자열 내부의 어떤 (n-1)-gram의 해시보다 반드시 커야 합니다.
입력으로 UTF-8 문자열을 받으며, UTF-8 시퀀스가 잘못된 경우 예외를 발생시킵니다.
해시 함수로 CRC32를 사용합니다.
구문
sparseGramsUTF8(s[, min_ngram_length[, max_ngram_length[, min_cutoff_length]]])
s — 입력 문자열입니다. Stringmin_ngram_length — 선택 사항입니다. 추출할 n-그램의 최소 길이입니다. 기본값이자 최소값은 3입니다. UInt*max_ngram_length — 선택 사항입니다. 추출할 n-그램의 최대 길이입니다. 기본값은 100입니다. min_ngram_length보다 작아서는 안 됩니다. UInt*min_cutoff_length — 선택 사항입니다. 지정하면 길이가 min_cutoff_length 이상인 n-그램만 반환됩니다. 기본값은 min_ngram_length와 같습니다. min_ngram_length보다 작아서는 안 되며 max_ngram_length보다 커서도 안 됩니다. UInt*
반환 값
선택된 UTF-8 부분 문자열의 배열을 반환합니다. Array(String)
예시
사용 예시
SELECT sparseGramsUTF8('алиса', 3)
┌─sparseGramsUTF8('алиса', 3)─┐
│ ['али','лис','иса'] │
└─────────────────────────────┘
s가 prefix로 시작하면 1을, 그렇지 않으면 0을 반환합니다. UInt8
예시
사용 예시
SELECT startsWith('ClickHouse', 'Click');
┌─startsWith('⋯', 'Click')─┐
│ 1 │
└──────────────────────────┘
startsWithCaseInsensitive
startsWithCaseInsensitive(s, prefix)
s — 확인할 문자열입니다. Stringprefix — 확인할 대소문자를 구분하지 않는 접두사입니다. String
반환 값
s가 대소문자를 구분하지 않는 prefix로 시작하면 1을 반환하고, 그렇지 않으면 0을 반환합니다. UInt8
예시
사용 예시
SELECT startsWithCaseInsensitive('ClickHouse', 'CLICK');
┌─startsWithCaseInsensitive('⋯', 'CLICK')─┐
│ 1 │
└─────────────────────────────────────────┘
startsWithCaseInsensitiveUTF8
startsWithCaseInsensitiveUTF8(s, prefix)
s — 확인할 문자열입니다. Stringprefix — 대소문자를 구분하지 않는 확인할 접두사입니다. String
반환 값
s가 대소문자를 구분하지 않는 prefix로 시작하면 1을 반환하고, 그렇지 않으면 0을 반환합니다. UInt8
예시
사용 예시
SELECT startsWithCaseInsensitiveUTF8('приставка', 'при')
┌─startsWithUT⋯ка', 'при')─┐
│ 1 │
└──────────────────────────┘
startsWithUTF8(s, prefix)
s가 prefix로 시작하면 1을, 그렇지 않으면 0을 반환합니다. UInt8
예시
사용 예시
SELECT startsWithUTF8('приставка', 'при')
┌─startsWithUT⋯ка', 'при')─┐
│ 1 │
└──────────────────────────┘
Float64
예시
사용 예시
SELECT stringBytesEntropy('Hello, world!')
┌─stringBytesEntropy('Hello, world!')─┐
│ 3.07049960 │
└─────────────────────────────────────┘
UInt16
예시
사용 예시
SELECT stringBytesUniq('Hello')
┌─stringBytesUniq('Hello')─┐
│ 4 │
└──────────────────────────┘
stringJaccardIndex(s1, s2)
Float64
예시
사용 예시
SELECT stringJaccardIndex('clickhouse', 'mouse')
┌─stringJaccardIndex('clickhouse', 'mouse')─┐
│ 0.4 │
└───────────────────────────────────────────┘
stringJaccardIndex입니다.
구문
stringJaccardIndexUTF8(s1, s2)
s1 — 첫 번째 UTF8 입력 문자열입니다. Strings2 — 두 번째 UTF8 입력 문자열입니다. String
반환 값
두 UTF8 문자열 사이의 자카드 유사도 지수를 반환합니다. Float64
예시
사용 예시
SELECT stringJaccardIndexUTF8('我爱你', '我也爱你')
┌─stringJaccardIndexUTF8('我爱你', '我也爱你')─┐
│ 0.75 │
└─────────────────────────────────────────────┘
offset에서 시작하는 문자열 s의 부분 문자열을 반환합니다.
바이트 수는 다음 규칙에 따라 1부터 계산됩니다.
offset이 0이면 빈 문자열이 반환됩니다.offset이 음수이면 부분 문자열은 문자열의 시작이 아니라 끝에서 offset 문자만큼 떨어진 위치에서 시작합니다.
선택적 인수 length는 반환되는 부분 문자열이 가질 수 있는 최대 바이트 수를 지정합니다.
구문
substring(s, offset[, length])
byteSlice, mid, substr
인수
반환 값
인덱스 offset에서 시작하는 s의 부분 문자열을 length바이트 길이로 반환합니다. String
예시
기본 사용법
SELECT 'database' AS db, substr(db, 5), substr(db, 5, 1)
┌─db───────┬─substring('database', 5)─┬─substring('database', 5, 1)─┐
│ database │ base │ b │
└──────────┴──────────────────────────┴─────────────────────────────┘
delim이 count번 나타나기 전까지의 s 부분 문자열을 반환합니다.
구문
substringIndex(s, delim, count)
SUBSTRING_INDEX
인수
s — 부분 문자열을 추출할 문자열입니다. Stringdelim — 분리 기준이 되는 문자입니다. Stringcount — 부분 문자열을 추출하기 전에 셀 구분자의 출현 횟수입니다. count가 양수이면 마지막 구분자의 왼쪽에 있는 모든 내용(왼쪽부터 셈)이 반환됩니다. count가 음수이면 마지막 구분자의 오른쪽에 있는 모든 내용(오른쪽부터 셈)이 반환됩니다. UInt 또는 Int
반환 값
s에서 delim이 count번 나타나기 전까지의 부분 문자열을 반환합니다. String
예시
사용 예시
SELECT substringIndex('www.clickhouse.com', '.', 2)
┌─substringIndex('www.clickhouse.com', '.', 2)─┐
│ www.clickhouse │
└──────────────────────────────────────────────┘
delim 구분자가 count번 나타나기 전까지의 s 부분 문자열을 반환합니다.
문자열에 유효한 UTF-8로 인코딩된 텍스트가 들어 있다고 가정합니다.
이 가정이 깨져도 예외는 발생하지 않으며 결과는 정의되지 않습니다.
구문
substringIndexUTF8(s, delim, count)
s — 부분 문자열을 추출할 문자열입니다. Stringdelim — 분리 기준이 되는 문자입니다. Stringcount — 부분 문자열을 추출하기 전에 셀 구분자의 출현 횟수입니다. count가 양수이면 마지막 구분자(왼쪽부터 계산)의 왼쪽에 있는 모든 내용이 반환됩니다. count가 음수이면 마지막 구분자(오른쪽부터 계산)의 오른쪽에 있는 모든 내용이 반환됩니다. UInt 또는 Int
반환 값
s에서 delim이 count번 나타나기 전까지의 부분 문자열을 반환합니다. String
예시
UTF8 예시
SELECT substringIndexUTF8('www.straßen-in-europa.de', '.', 2)
offset에서 시작하는 문자열 s의 부분 문자열을 반환합니다.
코드 포인트는 다음 규칙에 따라 1부터 계산합니다.
offset이 0이면 빈 문자열을 반환합니다.offset이 음수이면 부분 문자열은 문자열의 시작이 아니라 끝에서부터 offset 코드 포인트 떨어진 위치에서 시작합니다.
선택적 인수 length는 반환되는 부분 문자열의 최대 코드 포인트 수를 지정합니다.
이 함수는 문자열에 유효한 UTF-8로 인코딩된 텍스트가 들어 있다고 가정합니다.
이 가정이 충족되지 않아도 예외가 발생하지 않으며 결과는 정의되지 않습니다.
substringUTF8(s, offset[, length])
offset에서 시작하는, length개의 코드 포인트 길이를 갖는 s의 부분 문자열을 반환합니다. String
예시
사용 예시
SELECT 'Täglich grüßt das Murmeltier.' AS str, substringUTF8(str, 9), substringUTF8(str, 9, 5)
Täglich grüßt das Murmeltier. grüßt das Murmeltier. grüßt
�(U+FFFD)로 바꾸어 문자열을 올바른 UTF-8 인코딩으로 변환합니다.
유효하지 않은 문자가 여러 개 연속으로 발견되면 하나의 대체 문자로 합쳐집니다.
구문
인수
s — String 데이터 타입 객체로 표현된 임의의 바이트 시퀀스입니다. String
반환 값
유효한 UTF-8 문자열을 반환합니다. String
예시
사용 예시
SELECT toValidUTF8('\\x61\\xF0\\x80\\x80\\x80b')
c
┌─toValidUTF8('a����b')─┐
│ a�b │
└───────────────────────┘
trimBoth(s[, trim_characters])
trim
인수
s — 양끝 문자를 제거할 String입니다. Stringtrim_characters — 선택 사항입니다. 제거할 문자입니다. 지정하지 않으면 일반적인 공백 문자가 제거됩니다. String
반환 값
양쪽 끝에서 지정된 문자가 제거된 문자열을 반환합니다. String
예시
사용 예시
SELECT trimBoth('$$ClickHouse$$', '$')
┌─trimBoth('$$⋯se$$', '$')─┐
│ ClickHouse │
└──────────────────────────┘
trimLeft(input[, trim_characters])
ltrim
인수
input — 트리밍할 문자열입니다. Stringtrim_characters — 선택 사항입니다. 트리밍할 문자입니다. 지정하지 않으면 일반적인 공백 문자가 제거됩니다. String
반환 값
왼쪽에서 지정된 문자가 제거된 문자열을 반환합니다. String
예시
사용 예시
SELECT trimLeft('ClickHouse', 'Click');
┌─trimLeft('Cl⋯', 'Click')─┐
│ House │
└──────────────────────────┘
trimRight(s[, trim_characters])
rtrim
인수
s — 잘라낼 문자열입니다. Stringtrim_characters — 선택적으로 잘라낼 문자입니다. 지정하지 않으면 일반적인 공백 문자가 제거됩니다. String
반환 값
오른쪽 끝에서 지정된 문자가 제거된 문자열을 반환합니다. String
예시
사용 예시
SELECT trimRight('ClickHouse','House');
┌─trimRight('C⋯', 'House')─┐
│ Click │
└──────────────────────────┘
encoded — 디코드할 String 컬럼 또는 상수입니다. 문자열이 유효한 Base32 인코딩이 아니면 오류 발생 시 빈 문자열을 반환합니다. String
반환 값
인수의 디코드된 값을 담은 문자열을 반환합니다. String
예시
사용 예시
SELECT tryBase32Decode('IVXGG33EMVSA====');
┌─tryBase32Decode('IVXGG33EMVSA====')─┐
│ Encoded │
└─────────────────────────────────────┘
base58Decode와 유사하지만, 오류가 발생하면 빈 문자열을 반환합니다.
구문
tryBase58Decode(encoded[, expected_size])
encoded — String 컬럼 또는 상수입니다. 문자열이 유효한 Base58 인코딩이 아니면, 오류 발생 시 빈 문자열을 반환합니다. Stringexpected_size — 선택 사항입니다. 바이트 단위의 예상 디코딩 크기입니다. 32 또는 64이면 최적화된 디코더를 사용하고, 그 밖의 값이면 일반 디코더를 사용합니다. UInt8, UInt16, UInt32, or UInt64
반환 값
인수의 디코딩된 값을 담은 문자열을 반환합니다. String
예시
사용 예시
SELECT tryBase58Decode('3dc8KtHrwM') AS res, tryBase58Decode('invalid') AS res_invalid;
┌─res─────┬─res_invalid─┐
│ Encoded │ │
└─────────┴─────────────┘
base64Decode와 유사하지만, 오류가 발생한 경우 빈 문자열을 반환합니다.
구문
인수
encoded — 디코딩할 String 컬럼 또는 상수입니다. 문자열이 유효한 Base64 인코딩이 아니면 오류 발생 시 빈 문자열을 반환합니다. String
반환 값
인수에서 디코딩된 값을 포함하는 문자열을 반환합니다. String
예시
사용 예시
SELECT tryBase64Decode('Y2xpY2tob3VzZQ==')
┌─tryBase64Decode('Y2xpY2tob3VzZQ==')─┐
│ clickhouse │
└─────────────────────────────────────┘
base64URLDecode와 동일하지만, 오류가 발생한 경우에는 빈 문자열을 반환합니다.
구문
tryBase64URLDecode(encoded)
encoded — 디코딩할 String 타입의 컬럼 또는 상수입니다. 문자열이 유효한 Base64 인코딩이 아니면 오류 발생 시 빈 문자열을 반환합니다. String
반환 값
인수에서 디코딩된 값을 담은 문자열을 반환합니다. String
예시
사용 예시
SELECT tryBase64URLDecode('aHR0cHM6Ly9jbGlja2hvdXNlLmNvbQ')
┌─tryBase64URLDecode('aHR0cHM6Ly9jbGlja2hvdXNlLmNvbQ')─┐
│ https://clickhouse.com │
└──────────────────────────────────────────────────────┘
String
예시
사용 예시
SELECT tryIdnaEncode('straße.münchen.de')
┌─tryIdnaEncode('straße.münchen.de')──┐
│ xn--strae-oqa.xn--mnchen-3ya.de │
└─────────────────────────────────────┘
punycodeDecode와 유사하지만, 유효한 Punycode 인코딩 문자열이 제공되지 않으면 빈 문자열을 반환합니다.
구문
인수
s — Punycode로 인코딩된 문자열입니다. String
반환 값
입력 값의 평문을 반환하며, 입력이 유효하지 않으면 빈 문자열을 반환합니다. String
예시
사용 예시
SELECT tryPunycodeDecode('Mnchen-3ya')
┌─tryPunycodeDecode('Mnchen-3ya')─┐
│ München │
└─────────────────────────────────┘
ucase
인수
반환 값
s를 모두 대문자로 변환한 문자열을 반환합니다. String
예시
사용 예시
SELECT upper('clickhouse')
┌─upper('clickhouse')─┐
│ CLICKHOUSE │
└─────────────────────┘
이 함수는 언어를 감지하지 않습니다. 예를 들어 터키어에서는 결과가 정확히 올바르지 않을 수 있습니다(i/İ 대 i/I).
코드 포인트의 대문자와 소문자에서 UTF-8 바이트 시퀀스의 길이가 다른 경우(ẞ 및 ß 등), 해당 코드 포인트에 대한 결과가 올바르지 않을 수 있습니다.
String
예시
사용 예시
SELECT upperUTF8('München') AS Upperutf8
┌─Upperutf8─┐
│ MÜNCHEN │
└───────────┘
