diff --git a/docs/en/getting_started/example_datasets/index.md b/docs/en/getting_started/example_datasets/index.md new file mode 100644 index 00000000000..4542868d7f0 --- /dev/null +++ b/docs/en/getting_started/example_datasets/index.md @@ -0,0 +1,14 @@ +# Example Datasets + +This section describes how to obtain example datasets and import them into ClickHouse. +For some datasets example queries are also available. + +* [Anonymized Yandex.Metrica Dataset](metrica.md) +* [Star Schema Benchmark](star_schema.md) +* [WikiStat](wikistat.md) +* [Terabyte of Click Logs from Criteo](criteo.md) +* [AMPLab Big Data Benchmark](amplab_benchmark.md) +* [New York Taxi Data](nyc_taxi.md) +* [OnTime](ontime.md) + +[Original article](https://clickhouse.tech/docs/en/getting_started/example_datasets) diff --git a/docs/en/getting_started/playground.md b/docs/en/getting_started/playground.md new file mode 100644 index 00000000000..ee2a3f58235 --- /dev/null +++ b/docs/en/getting_started/playground.md @@ -0,0 +1,41 @@ +# ClickHouse Playground + +[ClickHouse Playground](https://play.clickhouse.tech?file=welcome) allows people to experiment with ClickHouse by running queries instantly, without setting up their own server or cluster. +Several example datasets are available in Playground as well as sample queries that show ClickHouse features. + +The queries are executed as read-only user. This 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) + +ClickHouse Playground gives the experience of m2.small +[Managed Service for ClickHouse](https://cloud.yandex.com/services/managed-clickhouse) +instance hosted in [Yandex.Cloud](https://cloud.yandex.com/). +More information about [cloud providers](../commercial/cloud.md). + +ClickHouse Playground web interface makes requests via ClickHouse [HTTP API](../interfaces/http.md). +Playground backend is just a ClickHouse cluster without any additional server-side application. +ClickHouse HTTPS endpoint is is also available as a part of Playground. + +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). + +| Parameter | Value | +|:----------|:-------------| +| Endpoint| https://play-api.clickhouse.tech:8443 | +| User | `playground` | +| Password | `clickhouse` | + +Note that this endpoint requires a secure connection. + +Example: + +```bash +curl "https://play-api.clickhouse.tech:8443/?query=SELECT+'Play+ClickHouse!';&user=playground&password=clickhouse&database=datasets" +``` diff --git a/docs/fa/getting_started/example_datasets/index.md b/docs/fa/getting_started/example_datasets/index.md new file mode 120000 index 00000000000..c891314f915 --- /dev/null +++ b/docs/fa/getting_started/example_datasets/index.md @@ -0,0 +1 @@ +../../../en/getting_started/example_datasets/index.md \ No newline at end of file diff --git a/docs/ja/getting_started/example_datasets/index.md b/docs/ja/getting_started/example_datasets/index.md new file mode 120000 index 00000000000..c891314f915 --- /dev/null +++ b/docs/ja/getting_started/example_datasets/index.md @@ -0,0 +1 @@ +../../../en/getting_started/example_datasets/index.md \ No newline at end of file diff --git a/docs/ru/getting_started/example_datasets/index.md b/docs/ru/getting_started/example_datasets/index.md new file mode 100644 index 00000000000..c01f73ddc4d --- /dev/null +++ b/docs/ru/getting_started/example_datasets/index.md @@ -0,0 +1,14 @@ +# Тестовые массивы данных + +Этот раздел описывает как получить тестовые массивы данных и загрузить их в ClickHouse. +Для некоторых тестовых массивов данных также доступны тестовые запросы. + +* [Анонимизированные данные Яндекс.Метрики](metrica.md) +* [Star Schema Benchmark](star_schema.md) +* [WikiStat](wikistat.md) +* [Терабайт логов кликов от Criteo](criteo.md) +* [AMPLab Big Data Benchmark](amplab_benchmark.md) +* [Данные о такси в Нью-Йорке](nyc_taxi.md) +* [OnTime](ontime.md) + +[Оригинальная статья](https://clickhouse.tech/docs/en/getting_started/example_datasets) diff --git a/docs/ru/getting_started/playground.md b/docs/ru/getting_started/playground.md new file mode 100644 index 00000000000..bcf8bb02cc9 --- /dev/null +++ b/docs/ru/getting_started/playground.md @@ -0,0 +1,38 @@ +# ClickHouse Playground + +ClickHouse Playground позволяет моментально выполнить запросы к ClickHouse из бразуера. +В Playground доступны несколько тестовых массивов данных и примеры запросов, которые показывают некоторые отличительные черты ClickHouse. + +Запросы выполняются под пользователем с правами `readonly` для которого есть следующие ограничения: +- запрещены DDL запросы +- запроещены INSERT запросы + +Также установлены следующие опции: +- [`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) + +ClickHouse Playground соответствует конфигурации m2.small хосту +[Managed Service for ClickHouse](https://cloud.yandex.com/services/managed-clickhouse) +запущеному в [Яндекс.Облаке](https://cloud.yandex.com/). +Больше информации про [облачных провайдерах](../commercial/cloud.md). + +Веб интерфейс ClickHouse Playground делает запросы через ClickHouse HTTP API. +Бекендом служит обычный кластер ClickHouse. +ClickHouse HTTP интерфейс также доступен как часть Playground. + +Запросы к Playground могут быть выполнены с помощью curl/wget, а также через соединеие JDBC/ODBC драйвера +Больше информации про приложения с поддержкой ClickHouse доступно в разделе [Интерфейсы](../interfaces/index.md). + +| Параметр | Значение | +|:----------|:-------------| +| Адрес| https://play-api.clickhouse.tech:8443 | +| Имя пользователя | `playground` | +| Пароль | `clickhouse` | + +Требуется SSL соединение. + +```bash +curl "https://play-api.clickhouse.tech:8443/?query=SELECT+'Play+ClickHouse!';&user=playground&password=clickhouse&database=datasets" +``` diff --git a/docs/toc_en.yml b/docs/toc_en.yml index 05ea0850f69..11500342aa2 100644 --- a/docs/toc_en.yml +++ b/docs/toc_en.yml @@ -13,6 +13,7 @@ nav: - 'Installation': 'getting_started/install.md' - 'Tutorial': 'getting_started/tutorial.md' - 'Example Datasets': + - 'Introduction': 'getting_started/example_datasets/index.md' - 'OnTime': 'getting_started/example_datasets/ontime.md' - 'New York Taxi Data': 'getting_started/example_datasets/nyc_taxi.md' - 'AMPLab Big Data Benchmark': 'getting_started/example_datasets/amplab_benchmark.md' @@ -20,6 +21,7 @@ nav: - 'Terabyte Click Logs from Criteo': 'getting_started/example_datasets/criteo.md' - 'Star Schema Benchmark': 'getting_started/example_datasets/star_schema.md' - 'Yandex.Metrica Data': 'getting_started/example_datasets/metrica.md' + - 'Playground': 'getting_started/playground.md' - 'Interfaces': - 'Introduction': 'interfaces/index.md' diff --git a/docs/toc_fa.yml b/docs/toc_fa.yml index 965f3dbf95c..8905a2ab041 100644 --- a/docs/toc_fa.yml +++ b/docs/toc_fa.yml @@ -13,6 +13,7 @@ nav: - 'ﯼﺯﺍﺪﻧﺍ ﻩﺍﺭ ﻭ ﺐﺼﻧ': 'getting_started/install.md' - 'ﺵﺯﻮﻣﺁ': 'getting_started/tutorial.md' - 'ﻪﻧﻮﻤﻧ ﯼﺎﻫ ﻩﺩﺍﺩ ﻪﻋﻮﻤﺠﻣ': + - 'Introduction': 'getting_started/example_datasets/index.md' - 'OnTime': 'getting_started/example_datasets/ontime.md' - ' داده های تاکسی New York': 'getting_started/example_datasets/nyc_taxi.md' - ' بنچمارک AMPLab Big Data': 'getting_started/example_datasets/amplab_benchmark.md' @@ -20,6 +21,7 @@ nav: - ' ترابایت از لاگ های کلیک از سرویس Criteo': 'getting_started/example_datasets/criteo.md' - ' بنچمارک Star Schema': 'getting_started/example_datasets/star_schema.md' - 'Yandex.Metrica Data': 'getting_started/example_datasets/metrica.md' + - 'Playground': 'getting_started/playground.md' - 'ﻂﺑﺍﺭ': - 'Interface ها': 'interfaces/index.md' diff --git a/docs/toc_ja.yml b/docs/toc_ja.yml index c385d08a581..ebf97f9bd08 100644 --- a/docs/toc_ja.yml +++ b/docs/toc_ja.yml @@ -13,6 +13,7 @@ nav: - 'Installation': 'getting_started/install.md' - 'Tutorial': 'getting_started/tutorial.md' - 'Example Datasets': + - 'Introduction': 'getting_started/example_datasets/index.md' - 'OnTime': 'getting_started/example_datasets/ontime.md' - 'New York Taxi Data': 'getting_started/example_datasets/nyc_taxi.md' - 'AMPLab Big Data Benchmark': 'getting_started/example_datasets/amplab_benchmark.md' @@ -20,6 +21,7 @@ nav: - 'Terabyte Click Logs from Criteo': 'getting_started/example_datasets/criteo.md' - 'Star Schema Benchmark': 'getting_started/example_datasets/star_schema.md' - 'Yandex.Metrica Data': 'getting_started/example_datasets/metrica.md' + - 'Playground': 'getting_started/playground.md' - 'Interfaces': - 'Introduction': 'interfaces/index.md' diff --git a/docs/toc_ru.yml b/docs/toc_ru.yml index 4f028a4463f..0df04f892cf 100644 --- a/docs/toc_ru.yml +++ b/docs/toc_ru.yml @@ -14,6 +14,7 @@ nav: - 'Установка': 'getting_started/install.md' - 'Руководство для начинающих': 'getting_started/tutorial.md' - 'Тестовые наборы данных': + - 'Введение': 'getting_started/example_datasets/index.md' - 'OnTime': 'getting_started/example_datasets/ontime.md' - 'Данные о такси в Нью-Йорке': 'getting_started/example_datasets/nyc_taxi.md' - 'AMPLab Big Data Benchmark': 'getting_started/example_datasets/amplab_benchmark.md' @@ -21,6 +22,7 @@ nav: - 'Терабайт логов кликов от Criteo': 'getting_started/example_datasets/criteo.md' - 'Схема «Звезда»': 'getting_started/example_datasets/star_schema.md' - 'Данные Яндекс.Метрики': 'getting_started/example_datasets/metrica.md' + - 'Playground': 'getting_started/playground.md' - 'Интерфейсы': - 'Введение': 'interfaces/index.md' diff --git a/docs/toc_zh.yml b/docs/toc_zh.yml index fd28d056a98..f4aa73d91da 100644 --- a/docs/toc_zh.yml +++ b/docs/toc_zh.yml @@ -13,6 +13,7 @@ nav: - '安装': 'getting_started/install.md' - '教程': 'getting_started/tutorial.md' - '示例数据集': + - '介绍': 'getting_started/example_datasets/index.md' - '航班飞行数据': 'getting_started/example_datasets/ontime.md' - '纽约市出租车数据': 'getting_started/example_datasets/nyc_taxi.md' - 'AMPLab大数据基准测试': 'getting_started/example_datasets/amplab_benchmark.md' @@ -20,6 +21,7 @@ nav: - 'Criteo TB级别点击日志': 'getting_started/example_datasets/criteo.md' - 'Star Schema基准测试': 'getting_started/example_datasets/star_schema.md' - 'Yandex.Metrica': 'getting_started/example_datasets/metrica.md' + - 'Playground': 'getting_started/playground.md' - '客户端': - '介绍': 'interfaces/index.md' diff --git a/docs/zh/getting_started/example_datasets/index.md b/docs/zh/getting_started/example_datasets/index.md new file mode 120000 index 00000000000..c891314f915 --- /dev/null +++ b/docs/zh/getting_started/example_datasets/index.md @@ -0,0 +1 @@ +../../../en/getting_started/example_datasets/index.md \ No newline at end of file