mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-11-07 16:14:52 +00:00
7170f3c534
* prefer relative links from root * wip * split aggregate function reference * split system tables
66 lines
3.5 KiB
Markdown
66 lines
3.5 KiB
Markdown
---
|
||
toc_priority: 14
|
||
toc_title: Playground
|
||
---
|
||
|
||
# ClickHouse Playground {#clickhouse-playground}
|
||
|
||
[ClickHouse Playground](https://play.clickhouse.tech) allows people to experiment with ClickHouse by running queries instantly, without setting up their server or cluster.
|
||
Several example datasets are available in the Playground as well as sample queries that show ClickHouse features. There’s also a selection of ClickHouse LTS releases to experiment with.
|
||
|
||
ClickHouse Playground gives the experience of m2.small [Managed Service for ClickHouse](https://cloud.yandex.com/services/managed-clickhouse) instance (4 vCPU, 32 GB RAM) hosted in [Yandex.Cloud](https://cloud.yandex.com/). More information about [cloud providers](../commercial/cloud.md).
|
||
|
||
You can make queries to playground using any HTTP client, for example [curl](https://curl.haxx.se) or [wget](https://www.gnu.org/software/wget/), or set up a connection using [JDBC](../interfaces/jdbc.md) or [ODBC](../interfaces/odbc.md) drivers. More information about software products that support ClickHouse is available [here](../interfaces/index.md).
|
||
|
||
## Credentials {#credentials}
|
||
|
||
| Parameter | Value |
|
||
|:--------------------|:----------------------------------------|
|
||
| HTTPS endpoint | `https://play-api.clickhouse.tech:8443` |
|
||
| Native TCP endpoint | `play-api.clickhouse.tech:9440` |
|
||
| User | `playground` |
|
||
| Password | `clickhouse` |
|
||
|
||
There are additional endpoints with specific ClickHouse releases to experiment with their differences (ports and user/password are the same as above):
|
||
|
||
- 20.3 LTS: `play-api-v20-3.clickhouse.tech`
|
||
- 19.14 LTS: `play-api-v19-14.clickhouse.tech`
|
||
|
||
!!! note "Note"
|
||
All these endpoints require a secure TLS connection.
|
||
|
||
## Limitations {#limitations}
|
||
|
||
The queries are executed as a read-only user. It implies some limitations:
|
||
|
||
- DDL queries are not allowed
|
||
- INSERT queries are not allowed
|
||
|
||
The following settings are also enforced:
|
||
- [max\_result\_bytes=10485760](../operations/settings/query_complexity/#max-result-bytes)
|
||
- [max\_result\_rows=2000](../operations/settings/query_complexity/#setting-max_result_rows)
|
||
- [result\_overflow\_mode=break](../operations/settings/query_complexity/#result-overflow-mode)
|
||
- [max\_execution\_time=60000](../operations/settings/query_complexity/#max-execution-time)
|
||
|
||
## Examples {#examples}
|
||
|
||
HTTPS endpoint example with `curl`:
|
||
|
||
``` bash
|
||
curl "https://play-api.clickhouse.tech:8443/?query=SELECT+'Play+ClickHouse!';&user=playground&password=clickhouse&database=datasets"
|
||
```
|
||
|
||
TCP endpoint example with [CLI](../interfaces/cli.md):
|
||
|
||
``` bash
|
||
clickhouse client --secure -h play-api.clickhouse.tech --port 9440 -u playground --password clickhouse -q "SELECT 'Play ClickHouse!'"
|
||
```
|
||
|
||
## Implementation Details {#implementation-details}
|
||
|
||
ClickHouse Playground web interface makes requests via ClickHouse [HTTP API](../interfaces/http.md).
|
||
The Playground backend is just a ClickHouse cluster without any additional server-side application. As mentioned above, ClickHouse HTTPS and TCP/TLS endpoints are also publicly available as a part of the Playground, both are proxied through [Cloudflare Spectrum](https://www.cloudflare.com/products/cloudflare-spectrum/) to add extra layer of protection and improved global connectivity.
|
||
|
||
!!! warning "Warning"
|
||
Exposing ClickHouse server to public internet in any other situation is **strongly not recommended**. Make sure it listens only on private network and is covered by properly configured firewall.
|