mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-11-06 15:42:39 +00:00
67 lines
3.5 KiB
Markdown
67 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 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 an extra layer of protection and improved global connectivity.
|
||
|
||
!!! warning "Warning"
|
||
Exposing the ClickHouse server to the public internet in any other situation is **strongly not recommended**. Make sure it listens only on a private network and is covered by a properly configured firewall.
|