ClickHouse/docs/en/sql-reference/table-functions/url.md

toc_priority	toc_title
41	url

url

url function creates a table from the URL with given format and structure.

url function can be used in SELECT and INSERT queries on data in URL tables.

Syntax

url(URL, format, structure)

Input parameters

• URL - HTTP or HTTPS server address, which can accept GET and/or POST requests. Type: String.
• format - Format of the data. Type: String.
• structure - Table structure in 'UserID UInt64, Name String' format. Determines column names and types. Type: String.

Returned value

A table with the specified format and structure and with data from the defined URL.

Examples

Getting the first 3 lines of a table that contains columns of String and UInt32 type from HTTP-server which answers in CSV format.

SELECT * FROM url('http://127.0.0.1:12345/', CSV, 'column1 String, column2 UInt32') LIMIT 3;

Inserting data from a URL into a table:

CREATE TABLE url_engine_table (column1 String, column2 UInt32) ENGINE=URL('http://127.0.0.1:12345/', CSV);
INSERT INTO url_engine_table FROM url('http://127.0.0.1:12345/', 'CSV', 'column1 String, column2 UInt32');
SELECT * FROM url_engine_table;

Original article