Split URL directive

The SPLIT-URL directive splits a URL into protocol, authority, host, port, path, filename, and query.

Syntax

split-url :column

The column is a column containing the URL.

Usage Notes

The SPLIT-URL directive will parse the URL into its constituents. Upon splitting the URL, the directive creates seven new columns by appending to the original column name:

column_protocol
column_authority
column_host
column_port
column_path
column_filename
column_query

If the URL cannot be parsed correctly, an exception is throw. If the URL column does not exist, columns with a null value are added to the record.

Examples

Using this record as an example:

{ "url": "http://example.com:80/docs/books/tutorial/index.html?name=networking#DOWNLOADING" }

Applying this directive:

split-url :url

results in this record:

{  "url": "http://example.com:80/docs/books/tutorial/index.html?name=networking#DOWNLOADING",  "url_protocol": "http",  "url_authority": "example.com:80",  "url_host": "example.com",  "url_port": 80,  "url_path": "/docs/books/tutorial/index.html",  "url_filename": "/docs/books/tutorial/index.html?name=networking",  "url_query": "name=networking" }

When the URL field in the record is null:

{ "url": null }

the directive will generate:

{  "url": null,  "url_protocol": null,  "url_authority": null,  "url_host": null,  "url_port": null,  "url_path": null,  "url_filename": null,  "url_query": null }