카테고리:

문자열 및 이진 함수 (일반)

PARSE_URL

유효한 입력 URL/URI의 모든 구성 요소(조각, 호스트, 경로, 포트, 쿼리, 체계)로 구성된 JSON 오브젝트를 반환합니다.

구문

PARSE_URL(<string>, [<permissive>])

인자

필수:

string

구문 분석할 문자열입니다.

선택 사항:

permissive

구문 분석 오류가 처리되는 방법을 결정하는 플래그:

  • 0으로 설정하는 경우, 구문 분석 오류로 인해 함수가 실패합니다.

  • 1로 설정하면 구문 분석 오류의 결과, error 필드가 해당 오류 메시지로 설정된 오브젝트가 생성됩니다(다른 필드는 설정되지 않음).

기본값은 0입니다.

반환

반환된 값의 데이터 타입은 OBJECT 입니다. 오브젝트에는 JSON이 포함됩니다.

간단한 URL을 구문 분석합니다.

SELECT PARSE_URL('https://www.snowflake.com/');
+-----------------------------------------+
| PARSE_URL('HTTPS://WWW.SNOWFLAKE.COM/') |
|-----------------------------------------|
| {                                       |
|   "fragment": null,                     |
|   "host": "www.snowflake.com",          |
|   "parameters": null,                   |
|   "path": "",                           |
|   "port": null,                         |
|   "query": null,                        |
|   "scheme": "https"                     |
| }                                       |
+-----------------------------------------+

경로와 포트 번호가 포함된 URL을 구문 분석합니다.

SELECT PARSE_URL('HTTP://USER:PASS@EXAMPLE.INT:4345/HELLO.PHP?USER=1');
+-----------------------------------------------------------------+
| PARSE_URL('HTTP://USER:PASS@EXAMPLE.INT:4345/HELLO.PHP?USER=1') |
|-----------------------------------------------------------------|
| {                                                               |
|   "fragment": null,                                             |
|   "host": "USER:PASS@EXAMPLE.INT",                              |
|   "parameters": {                                               |
|     "USER": "1"                                                 |
|   },                                                            |
|   "path": "HELLO.PHP",                                          |
|   "port": "4345",                                               |
|   "query": "USER=1",                                            |
|   "scheme": "HTTP"                                              |
| }                                                               |
+-----------------------------------------------------------------+

이메일 URL을 구문 분석합니다.

SELECT PARSE_URL('mailto:abc@xyz.com');
+---------------------------------+
| PARSE_URL('MAILTO:ABC@XYZ.COM') |
|---------------------------------|
| {                               |
|   "fragment": null,             |
|   "host": null,                 |
|   "parameters": null,           |
|   "path": "abc@xyz.com",        |
|   "port": null,                 |
|   "query": null,                |
|   "scheme": "mailto"            |
| }                               |
+---------------------------------+

스키마가 누락된 잘못된 URL을 구문 분석합니다. 입력이 유효하지 않은 경우 함수가 실패해야 함을 나타내기 위해 permissive 매개 변수를 0으로 설정합니다.

SELECT PARSE_URL('example.int/hello.php?user=12#nofragment', 0);
100139 (22000): Error parsing URL: scheme not specified

함수가 JSON 형식의 오류 메시지가 포함된 오브젝트를 반환해야 함을 나타내기 위해 permissive 매개 변수를 1로 설정하여 잘못된 URL을 구문 분석합니다.

SELECT PARSE_URL('example.int/hello.php?user=12#nofragment', 1);
+----------------------------------------------------------+
| PARSE_URL('EXAMPLE.INT/HELLO.PHP?USER=12#NOFRAGMENT', 1) |
|----------------------------------------------------------|
| {                                                        |
|   "error": "scheme not specified"                        |
| }                                                        |
+----------------------------------------------------------+
맨 위로 이동