ClickHouse/docs/en/query_language/table_functions/url.md

20 lines
662 B
Markdown
Raw Normal View History

<a name="table_functions-url"></a>
# 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`.
2018-09-06 18:15:16 +00:00
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**
```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
```