| --- | |
| { | |
| "title": "PROTOCOL", | |
| "language": "en", | |
| "description": "The PROTOCOL function is mainly used to extract the protocol part from a URL string." | |
| } | |
| --- | |
| ## Description | |
| The PROTOCOL function is mainly used to extract the protocol part from a URL string. | |
| ## Syntax | |
| ```sql | |
| PROTOCOL( <url> ) | |
| ``` | |
| ## Parameters | |
| | Parameter | Description | | |
| |---------|------------| | |
| | `<url>` | The URL to be parsed | | |
| ## Return Value | |
| Returns the protocol part of the <url>. Special cases: | |
| - If any of the parameters is NULL, NULL is returned. | |
| ## Examples | |
| ```sql | |
| SELECT protocol('https://doris.apache.org/'); | |
| ``` | |
| ```text | |
| +---------------------------------------+ | |
| | protocol('https://doris.apache.org/') | | |
| +---------------------------------------+ | |
| | https | | |
| +---------------------------------------+ | |
| ``` | |
| ```sql | |
| SELECT protocol(null); | |
| ``` | |
| ```text | |
| +----------------+ | |
| | protocol(NULL) | | |
| +----------------+ | |
| | NULL | | |
| +----------------+ | |
| ``` | |
| ## See Also | |
| If you want to extract other parts of the URL, you can use [parse_url](./parse-url.md). |