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

25 lines
775 B
Markdown
Raw Normal View History

2020-04-03 13:23:32 +00:00
---
toc_priority: 41
toc_title: url
---
2020-03-20 10:10:48 +00:00
# url {#url}
2018-09-06 18:15:16 +00:00
`url(URL, format, structure)` - returns a table created from the `URL` with given
`format` and `structure`.
URL - HTTP or HTTPS server address, which can accept `GET` and/or `POST` requests.
2018-09-06 18:15:16 +00:00
format - [format](../../interfaces/formats.md#formats) of the data.
2018-09-06 18:15:16 +00:00
structure - table structure in `'UserID UInt64, Name String'` format. Determines column names and types.
**Example**
2020-03-20 10:10:48 +00:00
``` sql
2018-09-06 18:15:16 +00:00
-- 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
```
2020-01-30 10:34:55 +00:00
[Original article](https://clickhouse.tech/docs/en/query_language/table_functions/url/) <!--hide-->