개요
이 섹션에 언급된 함수는 최대 성능을 위해 최적화되어 있으며, 대부분 RFC-3986 표준을 따르지 않습니다.
RFC-3986을 구현하는 함수는 함수 이름 끝에
RFC가 붙으며, 일반적으로 더 느립니다.@ 기호가 포함되지 않았다면 일반적으로 non-RFC 함수 변형을 사용할 수 있습니다.
아래 표는 URL에서 각 RFC 및 non-RFC 변형이 어떤 기호를 파싱할 수 있는지(✔), 또는 파싱할 수 없는지(✗)를 보여줍니다.
*로 표시된 기호는 RFC 3986의 하위 구분 기호(sub-delimiters)이며, @ 기호 뒤의 사용자 정보에 허용됩니다.
URL 함수에는 두 가지 타입이 있습니다.
- URL의 일부를 추출하는 함수입니다. URL에 해당 부분이 없으면 빈 문자열을 반환합니다.
- URL의 일부를 제거하는 함수입니다. URL에 해당하는 부분이 없으면 URL은 변경되지 않습니다.
아래 함수는
system.functions 시스템 테이블(system table)에서 생성됩니다.URLHierarchy
도입 버전: v1.1.0 경로와 쿼리 문자열에서/, ?, # 기호를 기준으로 URL의 끝부분을 잘라낸 값들을 담은 배열을 반환합니다. 연속된 구분자 문자는 하나로 간주됩니다. 결과의 첫 번째 요소에는 프로토콜과 호스트가 포함되며, 이후에는 점차 길어지는 경로가 계층 구조를 이룹니다.
구문
url— 처리할 URL입니다.String
Array(String)
예시
기본 사용법
Query
Response
URLPathHierarchy
도입 버전: v1.1.0 URL의 경로 구성 요소를 담은 배열을 반환하며, 끝부분에서/, ?, # 기호를 기준으로 잘라냅니다. URLHierarchy와 달리 결과에는 프로토콜과 호스트가 포함되지 않으며, 경로부터 시작합니다. 연속된 구분자 문자는 하나로 간주됩니다.
구문
url— 처리할 URL입니다.String
Array(String)
예시
기본 사용법
Query
Response
cutFragment
도입 버전: v1.1.0 URL에서 # 기호를 포함한 프래그먼트 식별자를 제거합니다. 구문url— URL.String
String
예시
사용 예시
Query
Response
cutQueryString
도입 버전: v1.1.0 URL에서 물음표를 포함한 쿼리 문자열을 제거합니다. 구문url— URL.String
String
예시
사용 예시
Query
Response
cutQueryStringAndFragment
도입 버전: v1.1.0 URL에서 물음표(?)와 # 기호를 포함한 쿼리 문자열과 프래그먼트 식별자를 제거합니다. 구문url— URL.String
String
예시
사용 예시
Query
Response
cutToFirstSignificantSubdomain
도입 버전: v1.1.0 도메인에서 첫 번째 유의미한 하위 도메인까지의 최상위 하위 도메인을 포함하는 부분을 반환합니다. 구문url— 처리할 URL 또는 도메인 문자열입니다.String
String
예시
사용 예시
Query
Response
cutToFirstSignificantSubdomainCustom
도입 버전: v21.1.0 최상위 하위 도메인부터 첫 번째 유의미한 하위 도메인까지를 포함하는 도메인 부분을 반환합니다. 사용자 지정 TLD 목록 이름을 인수로 받습니다. 이 함수는 최신 TLD 목록이 필요하거나 사용자 지정 목록을 사용하는 경우 유용합니다. 구성 예시url— 처리할 URL 또는 도메인 문자열입니다.Stringtld_list_name— ClickHouse에 구성된 사용자 지정 TLD 목록의 이름입니다.const String
String
예시
비표준 도메인에 사용자 지정 TLD 목록 적용
Query
Response
cutToFirstSignificantSubdomainCustomRFC
도입 버전: v22.10.0 최상위 하위 도메인부터 첫 번째 유의미한 하위 도메인까지 포함하는 도메인 부분을 반환합니다. 사용자 지정 TLD 목록 이름을 인수로 받습니다. 최신 TLD 목록이 필요하거나 사용자 지정 목록이 있는 경우 이 함수가 유용할 수 있습니다. cutToFirstSignificantSubdomainCustom와 유사하지만 RFC 3986을 준수합니다. 구성 예시url— RFC 3986에 따라 처리할 URL 또는 도메인 문자열입니다. -tld_list_name— ClickHouse에 구성된 사용자 지정 TLD 목록의 이름입니다.
String
예시
사용 예시
Query
Response
cutToFirstSignificantSubdomainCustomWithWWW
도입 버전: v21.1.0www를 제거하지 않고, 최상위 하위 도메인부터 첫 번째 유의미한 하위 도메인까지 포함하는 도메인 부분을 반환합니다. 사용자 지정 TLD 목록 이름을 받습니다. 최신 TLD 목록이 필요하거나 사용자 지정 목록을 사용하는 경우 유용할 수 있습니다.
구성 예시
url— 처리할 URL 또는 도메인 문자열입니다. -tld_list_name— ClickHouse에 구성된 사용자 지정 TLD 목록의 이름입니다.
www를 제거하지 않고, 첫 번째 유의미한 하위 도메인까지의 최상위 하위 도메인을 포함한 도메인 부분입니다. String
예시
사용 예시
Query
Response
cutToFirstSignificantSubdomainCustomWithWWWRFC
도입 버전: v22.10.0www를 제거하지 않은 채, 최상위 하위 도메인부터 첫 번째 유의미한 하위 도메인까지 포함하는 도메인 부분을 반환합니다.
사용자 지정 TLD 목록 이름을 인자로 받습니다.
최신 TLD 목록이 필요하거나 사용자 지정 목록을 사용하는 경우 유용합니다.
cutToFirstSignificantSubdomainCustomWithWWW와 유사하지만, RFC 3986를 준수합니다.
구성 예시
url— RFC 3986에 따라 처리할 URL 또는 도메인 문자열입니다. -tld_list_name— ClickHouse에 구성된 사용자 지정 TLD 목록의 이름입니다.
www를 제거하지 않고, 최상위 하위 도메인부터 첫 번째 유의미한 하위 도메인까지 포함한 도메인 부분을 반환합니다. String
예시
사용자 지정 TLD 목록을 사용해 www를 유지한 채 RFC 3986을 파싱하는 예시
Query
Response
cutToFirstSignificantSubdomainRFC
도입 버전: v22.10.0 “첫 번째 유의미한 하위 도메인”까지의 최상위 하위 도메인을 포함하는 도메인 부분을 반환합니다.cutToFirstSignificantSubdomain와 유사하지만 RFC 3986을 준수합니다.
구문
url— RFC 3986에 따라 처리할 URL 또는 도메인 문자열입니다.String
String
예시
사용 예시
Query
Response
cutToFirstSignificantSubdomainWithWWW
도입 버전: v20.12.0www.를 제거하지 않고, 도메인에서 “유의미한 하위 도메인”까지의 최상위 하위 도메인을 포함한 부분을 반환합니다.
cutToFirstSignificantSubdomain과 유사하지만, www. 접두사가 있으면 그대로 유지합니다.
구문
url— 처리할 URL 또는 도메인 문자열입니다.String
www 포함)의 도메인 부분을 반환하며, 그렇지 않으면 빈 문자열을 반환합니다. String
예시
사용 예시
Query
Response
cutToFirstSignificantSubdomainWithWWWRFC
도입 버전: v22.10.0 도메인에서www를 제거하지 않고, 「첫 번째 유의미한 하위 도메인」까지의 최상위 하위 도메인을 포함하는 부분을 반환합니다. cutToFirstSignificantSubdomainWithWWW와 유사하지만 RFC 3986을 준수합니다.
구문
url— RFC 3986에 따라 처리할 URL 또는 도메인 문자열입니다.
www 포함)까지의 도메인 부분을 반환하고, 그렇지 않으면 빈 문자열 String을 반환합니다.
예시
사용 예시
Query
Response
cutURLParameter
도입 버전: v1.1.0 URL에서 요청된 각 매개변수의 첫 번째name=value 항목을 제거합니다.
name= 형식으로 표기된 매개변수만 일치하므로 값이 없는 플래그 매개변수는 그대로 유지됩니다. 예를 들어 cutURLParameter('http://bigmir.net/?a&c=d', 'a')는 URL을 변경하지 않고 반환합니다.
이 함수는 매개변수 이름의 문자를 인코딩하거나 디코딩하지 않으므로, 예를 들어 Client ID와 Client%20ID는 서로 다른 매개변수 이름으로 간주됩니다.
구문
url— URL.Stringname— URL 매개변수의 이름.String또는Array(String)
name=value가 제거된 URL입니다. String
예시
사용 예시
Query
Response
cutWWW
도입 버전: v1.1.0 URL의 도메인에www. 접두사가 있으면 제거합니다.
구문
url— URL.String
www.를 제거한 URL을 반환합니다. String
예시
사용 예시
Query
Response
decodeURLComponent
도입 버전: v1.1.0 URL로 인코딩된 문자열을 입력으로 받아 원래의 읽을 수 있는 형태로 디코딩합니다. 구문url— URL.String
String
예시
사용 예시
Query
Response
decodeURLFormComponent
도입 버전: v1.1.0+ 기호를 공백으로 변환하고 퍼센트 인코딩된 문자를 디코딩하는 폼 인코딩 규칙(RFC-1866)에 따라 URL 인코딩된 문자열을 디코딩합니다.
구문
url_decode
인수
url— URL입니다.String
String
예시
사용 예시
Query
Response
domain
도입 버전: v1.1.0 URL에서 호스트명을 추출합니다. URL은 프로토콜 포함 여부와 관계없이 지정할 수 있습니다. 구문url— URL.String
String
예시
사용 예시
Query
Response
domainRFC
도입 버전: v22.10.0 URL에서 호스트명을 추출합니다.domain과 유사하지만 RFC 3986을 준수합니다.
구문
url_extract_host
인수
url— URL.String
String
예시
사용 예시
Query
Response
domainWithoutWWW
도입 버전: v1.1.0 URL에 앞부분의www.가 있으면 이를 제거한 도메인을 반환합니다.
구문
url— URL.String
www. 제외)을 반환하고, 그렇지 않으면 빈 문자열을 반환합니다. String
예시
사용 예시
Query
Response
domainWithoutWWWRFC
도입 버전: v1.1.0 앞에www.가 있으면 이를 제거한 도메인을 반환합니다. domainWithoutWWW와 유사하지만 RFC 3986을 준수합니다.
구문
url— URL.String
www. 제외)을 반환하고, 그렇지 않으면 빈 문자열을 반환합니다. String
예시
사용 예시
Query
Response
encodeURLComponent
도입된 버전: v22.3.0 일반 문자열을 받아 URL 인코딩(퍼센트 인코딩) 포맷으로 변환하며, 이 과정에서 특수 문자는 해당 퍼센트 인코딩 값으로 대체됩니다. 구문url— URL입니다.String
String
예시
사용 예시
Query
Response
encodeURLFormComponent
도입 버전: v22.3.0 문자열을 form 인코딩 규칙(RFC-1866)에 따라 인코딩합니다. 이 규칙에서는 공백이 + 기호로 변환되고 특수 문자는 퍼센트 인코딩됩니다. 구문url_encode
인수
url— URL.String
String
예시
사용 예시
Query
Response
extractURLParameter
도입 버전: v1.1.0 URL에name 매개변수가 있으면 해당 값을 반환하고, 없으면 빈 문자열을 반환합니다.
같은 이름의 매개변수가 여러 개 있으면 첫 번째 값을 반환합니다.
이 함수는 url 매개변수에 포함된 매개변수가 name 인수와 동일한 방식으로 인코딩되어 있다고 가정합니다.
구문
String
예시
사용 예시
Query
Response
extractURLParameterNames
도입 버전: v1.1.0 URL 매개변수 이름에 해당하는 문자열 배열을 반환합니다. 값은 디코딩되지 않습니다. 구문url— URL.String
Array(String)
예시
사용 예시
Query
Response
extractURLParameters
도입 버전: v1.1.0 URL 매개변수에 해당하는name=value 형식의 문자열 배열을 반환합니다.
값은 디코딩되지 않습니다.
구문
url— URL.String
name=value 문자열의 배열을 반환합니다. Array(String)
예시
사용 예시
Query
Response
firstSignificantSubdomain
도입 버전: v1.1.0 “유의미한 하위 도메인”을 반환합니다. 유의미한 하위 도메인은 ‘com’, ‘net’, ‘org’ 또는 ‘co’인 경우 2단계 도메인입니다. 그렇지 않으면 3단계 도메인입니다. 예를 들어, firstSignificantSubdomain(‘https://news.clickhouse.com/') = ‘clickhouse’이고, firstSignificantSubdomain (‘https://news.clickhouse.com.tr/') = ‘clickhouse’입니다. “중요하지 않은” 2단계 도메인 목록과 기타 구현 세부 사항은 향후 변경될 수 있습니다. 구문- None.
Query
Response
firstSignificantSubdomainCustom
도입 버전: v21.1.0 사용자 지정 TLD(최상위 도메인) 목록을 사용해 URL의 첫 번째 유의미한 하위 도메인을 반환합니다. 사용자 지정 TLD 목록 이름은 어떤 도메인 접미사를 최상위 도메인으로 처리할지 정의하는 구성(configuration)을 가리킵니다. 이는 비표준 TLD 계층 구조를 다룰 때 유용합니다. 이 함수는 프로토콜과 그 뒤의 모든 내용이 제거되었다고 가정하는 단순화된 URL 파싱 알고리즘을 사용합니다. 구문String
예시
기본 사용법
Query
Response
firstSignificantSubdomainCustomRFC
도입 버전: v22.10.0firstSignificantSubdomainCustom와 유사하지만, 단순화된 알고리즘 대신 RFC 3986을 준수하는 URL 파싱을 사용합니다.
구문
String
예시
기본 사용법
Query
Response
firstSignificantSubdomainRFC
도입 버전: v22.10.0 RFC 1034에 따라 “첫 번째 의미 있는 하위 도메인”을 반환합니다. 구문- 없음.
fragment
도입 버전: v1.1.0 맨 앞의 해시 기호를 제외한 프래그먼트 식별자를 반환합니다. 구문url— URL.String
String
예시
사용 예시
Query
Response
netloc
도입 버전: v20.5.0 URL에서 네트워크 위치 정보(username:password@host:port)를 추출합니다.
구문
url— URL.String
username:password@host:port를 반환합니다. String
예시
사용 예시
Query
Response
path
지원 시작 버전: v1.1.0 URL에서 쿼리 문자열을 제외한 경로를 반환합니다. 구문url— URL.String
String
예시
사용 예시
Query
Response
pathFull
지원 시작 버전: v1.1.0path와 동일하지만 URL의 쿼리 문자열과 프래그먼트도 포함합니다.
구문
url— URL.String
String
예시
사용 예시
Query
Response
port
도입 버전: v20.5.0 URL의 포트를 반환합니다. URL에 포트가 없거나 파싱할 수 없는 경우default_port를 반환합니다.
구문
UInt16
예시
사용 예시
Query
Response
portRFC
도입 버전: v22.10.0 URL에 포트가 없거나 파싱할 수 없으면default_port를, 그렇지 않으면 포트를 반환합니다.
port와 유사하지만 RFC 3986을 준수합니다.
구문
UInt16
예시
사용 예시
Query
Response
protocol
도입 버전: v1.1.0 URL에서 프로토콜을 추출합니다. 일반적인 반환 값 예시: http, https, ftp, mailto, tel, magnet. 구문url_extract_protocol
인수
url— URL.String
String
예시
사용 예시
Query
Response
queryString
도입 버전: v1.1.0 URL의 쿼리 문자열에서 맨 앞의 물음표와# 및 그 뒤의 모든 내용을 제외한 값을 반환합니다.
구문
url— URL.String
String
예시
사용 예시
Query
Response
queryStringAndFragment
도입 버전: v1.1.0 URL의 쿼리 문자열과 프래그먼트 식별자를 반환합니다. 구문url— URL.String
String
예시
사용 예시
Query
Response
topLevelDomain
도입 버전: v1.1.0 URL에서 최상위 도메인을 추출합니다.URL은 프로토콜이 있거나 없어도 지정할 수 있습니다.
예를 들면 다음과 같습니다:
url— URL.String
String
예시
사용 예시
Query
Response
topLevelDomainRFC
도입 버전: v22.10.0 URL에서 최상위 도메인을 추출합니다.topLevelDomain와 비슷하지만, RFC 3986을 준수합니다.
구문
url— URL.String
String
예시
사용 예시
Query
Response