thevar1able/ClickHouse
1
0
Fork 0
mirror of https://github.com/ClickHouse/ClickHouse.git synced 2024-11-20 14:42:02 +00:00
Code Issues Packages Projects Releases Wiki Activity
34470ab6ca
ClickHouse/docs/ru/getting_started/index.md

145 lines
5.6 KiB
Markdown
Raw Normal View History

Headers markup is unified through the document.
2017-12-11 12:07:26 +00:00
# Начало работы
Added a note about testing versions [#CLICKHOUSE-2].
2017-07-04 12:53:50 +00:00
Headers markup is unified through the document.
2017-12-11 12:07:26 +00:00
## Системные требования
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
Система некроссплатформенная. Требуется ОС Linux Ubuntu не более старая, чем Precise (12.04); архитектура x86_64 с поддержкой набора инструкций SSE 4.2.
Для проверки наличия SSE 4.2, выполните:
Fixed some ERRORS and WARNINGS during RU docs build. (#772) * Initial commit if EN docs * Part of EN documentation * Full queries section * External data * Table engines * System tables * Table functions * Formats * Data types * Operators * Functions * Dictionaries * Settings * Configuration files * Access rights * Quotas * Fixed few formatting errors * Fixed few formatting errors * Fixed few formatting errors * FIX: "WARNING: Title underline too short." during build RU docs. * FIX: "WARNING: Title underline too short." during build RU docs.
2017-05-08 05:06:04 +00:00
Replacing 'RestructuredText' sources with the 'Markdown' ones.
2017-10-25 05:27:09 +00:00
```bash
grep -q sse4_2 /proc/cpuinfo && echo "SSE 4.2 supported" || echo "SSE 4.2 not supported"
```
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
Рекомендуется использовать Ubuntu Trusty или Ubuntu Xenial или Ubuntu Precise.
Терминал должен работать в кодировке UTF-8 (как по умолчанию в Ubuntu).
Headers markup is unified through the document.
2017-12-11 12:07:26 +00:00
## Установка
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
В целях тестирования и разработки, система может быть установлена на один сервер или на рабочий компьютер.
Replacing 'RestructuredText' sources with the 'Markdown' ones.
2017-10-25 05:27:09 +00:00
### Установка из пакетов
Fixed newlines in .rst files before code blocks [#CLICKHOUSE-2]. for i in $(find . -name '*.rst'); do grep -F -q '.. code-block:: ' $i && cat $i | sed -r -e 's/$/<NEWLINE>/' | tr -d '\n' | sed -r -e 's/([^>])<NEWLINE>.. code-block::/\1<NEWLINE><NEWLINE>.. code-block::/g' | sed -r -e 's/<NEWLINE>/\n/g' > ${i}.tmp && mv ${i}.tmp ${i}; done
2017-06-13 20:35:07 +00:00
Replacing 'RestructuredText' sources with the 'Markdown' ones.
2017-10-25 05:27:09 +00:00
Пропишите в `/etc/apt/sources.list` (или в отдельный файл `/etc/apt/sources.list.d/clickhouse.list`) репозитории:
Fixed some ERRORS and WARNINGS during RU docs build. (#772) * Initial commit if EN docs * Part of EN documentation * Full queries section * External data * Table engines * System tables * Table functions * Formats * Data types * Operators * Functions * Dictionaries * Settings * Configuration files * Access rights * Quotas * Fixed few formatting errors * Fixed few formatting errors * Fixed few formatting errors * FIX: "WARNING: Title underline too short." during build RU docs. * FIX: "WARNING: Title underline too short." during build RU docs.
2017-05-08 05:06:04 +00:00
Replacing 'RestructuredText' sources with the 'Markdown' ones.
2017-10-25 05:27:09 +00:00
```text
deb http://repo.yandex.ru/clickhouse/trusty stable main
```
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
Replacing 'RestructuredText' sources with the 'Markdown' ones.
2017-10-25 05:27:09 +00:00
На других версиях Ubuntu, замените `trusty` на `xenial` или `precise`.
Added a note about testing versions [#CLICKHOUSE-2].
2017-07-04 12:53:50 +00:00
Если вы хотите использовать наиболее свежую тестовую версию, замените stable на testing.
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
Затем выполните:
Fixed newlines in .rst files before code blocks [#CLICKHOUSE-2]. for i in $(find . -name '*.rst'); do grep -F -q '.. code-block:: ' $i && cat $i | sed -r -e 's/$/<NEWLINE>/' | tr -d '\n' | sed -r -e 's/([^>])<NEWLINE>.. code-block::/\1<NEWLINE><NEWLINE>.. code-block::/g' | sed -r -e 's/<NEWLINE>/\n/g' > ${i}.tmp && mv ${i}.tmp ${i}; done
2017-06-13 20:35:07 +00:00
Replacing 'RestructuredText' sources with the 'Markdown' ones.
2017-10-25 05:27:09 +00:00
```bash
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv E0C56BD4 # optional
sudo apt-get update
sudo apt-get install clickhouse-client clickhouse-server-common
```
Added a note about testing versions [#CLICKHOUSE-2].
2017-07-04 12:53:50 +00:00
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
Также можно скачать и установить пакеты вручную, отсюда:
Replacing 'RestructuredText' sources with the 'Markdown' ones.
2017-10-25 05:27:09 +00:00
<http://repo.yandex.ru/clickhouse/trusty/pool/main/c/clickhouse/>,
<http://repo.yandex.ru/clickhouse/xenial/pool/main/c/clickhouse/>,
<http://repo.yandex.ru/clickhouse/precise/pool/main/c/clickhouse/>.
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
ClickHouse содержит настройки ограничения доступа. Они расположены в файле users.xml (рядом с config.xml).
По умолчанию, разрешён доступ отовсюду для пользователя default без пароля. См. секцию users/default/networks.
Подробнее смотрите в разделе "конфигурационные файлы".
Replacing 'RestructuredText' sources with the 'Markdown' ones.
2017-10-25 05:27:09 +00:00
### Установка из исходников
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
Для сборки воспользуйтесь инструкцией: build.md
Вы можете собрать пакеты и установить их.
Также вы можете использовать программы без установки пакетов.
Fixed newlines in .rst files before code blocks [#CLICKHOUSE-2]. for i in $(find . -name '*.rst'); do grep -F -q '.. code-block:: ' $i && cat $i | sed -r -e 's/$/<NEWLINE>/' | tr -d '\n' | sed -r -e 's/([^>])<NEWLINE>.. code-block::/\1<NEWLINE><NEWLINE>.. code-block::/g' | sed -r -e 's/<NEWLINE>/\n/g' > ${i}.tmp && mv ${i}.tmp ${i}; done
2017-06-13 20:35:07 +00:00
Replacing 'RestructuredText' sources with the 'Markdown' ones.
2017-10-25 05:27:09 +00:00
```text
Клиент: dbms/src/Client/
Сервер: dbms/src/Server/
```
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
Для сервера создаёте директории с данными, например:
Fixed newlines in .rst files before code blocks [#CLICKHOUSE-2]. for i in $(find . -name '*.rst'); do grep -F -q '.. code-block:: ' $i && cat $i | sed -r -e 's/$/<NEWLINE>/' | tr -d '\n' | sed -r -e 's/([^>])<NEWLINE>.. code-block::/\1<NEWLINE><NEWLINE>.. code-block::/g' | sed -r -e 's/<NEWLINE>/\n/g' > ${i}.tmp && mv ${i}.tmp ${i}; done
2017-06-13 20:35:07 +00:00
Replacing 'RestructuredText' sources with the 'Markdown' ones.
2017-10-25 05:27:09 +00:00
```text
/opt/clickhouse/data/default/
/opt/clickhouse/metadata/default/
```
Added a note about testing versions [#CLICKHOUSE-2].
2017-07-04 12:53:50 +00:00
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
(Настраивается в конфиге сервера.)
Сделайте chown под нужного пользователя.
Обратите внимание на путь к логам в конфиге сервера (src/dbms/src/Server/config.xml).
Replacing 'RestructuredText' sources with the 'Markdown' ones.
2017-10-25 05:27:09 +00:00
### Другие методы установки
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
Replacing 'RestructuredText' sources with the 'Markdown' ones.
2017-10-25 05:27:09 +00:00
Docker образ: <https://hub.docker.com/r/yandex/clickhouse-server/>
Added link to RPM packages in documentation [#CLICKHOUSE-3].
2017-09-12 19:43:30 +00:00
Replacing 'RestructuredText' sources with the 'Markdown' ones.
2017-10-25 05:27:09 +00:00
RPM пакеты для CentOS, RHEL: <https://github.com/Altinity/clickhouse-rpm-install>
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
Replacing 'RestructuredText' sources with the 'Markdown' ones.
2017-10-25 05:27:09 +00:00
Gentoo overlay: <https://github.com/kmeaw/clickhouse-overlay>
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
Headers markup is unified through the document.
2017-12-11 12:07:26 +00:00
## Запуск
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
Для запуска сервера (в качестве демона), выполните:
Fixed some ERRORS and WARNINGS during RU docs build. (#772) * Initial commit if EN docs * Part of EN documentation * Full queries section * External data * Table engines * System tables * Table functions * Formats * Data types * Operators * Functions * Dictionaries * Settings * Configuration files * Access rights * Quotas * Fixed few formatting errors * Fixed few formatting errors * Fixed few formatting errors * FIX: "WARNING: Title underline too short." during build RU docs. * FIX: "WARNING: Title underline too short." during build RU docs.
2017-05-08 05:06:04 +00:00
Replacing 'RestructuredText' sources with the 'Markdown' ones.
2017-10-25 05:27:09 +00:00
```bash
sudo service clickhouse-server start
```
Fixed some ERRORS and WARNINGS during RU docs build. (#772) * Initial commit if EN docs * Part of EN documentation * Full queries section * External data * Table engines * System tables * Table functions * Formats * Data types * Operators * Functions * Dictionaries * Settings * Configuration files * Access rights * Quotas * Fixed few formatting errors * Fixed few formatting errors * Fixed few formatting errors * FIX: "WARNING: Title underline too short." during build RU docs. * FIX: "WARNING: Title underline too short." during build RU docs.
2017-05-08 05:06:04 +00:00
Replacing 'RestructuredText' sources with the 'Markdown' ones.
2017-10-25 05:27:09 +00:00
Смотрите логи в директории `/var/log/clickhouse-server/`
Added a note about testing versions [#CLICKHOUSE-2].
2017-07-04 12:53:50 +00:00
Replacing 'RestructuredText' sources with the 'Markdown' ones.
2017-10-25 05:27:09 +00:00
Если сервер не стартует - проверьте правильность конфигурации в файле `/etc/clickhouse-server/config.xml`
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
Также можно запустить сервер из консоли:
Fixed some ERRORS and WARNINGS during RU docs build. (#772) * Initial commit if EN docs * Part of EN documentation * Full queries section * External data * Table engines * System tables * Table functions * Formats * Data types * Operators * Functions * Dictionaries * Settings * Configuration files * Access rights * Quotas * Fixed few formatting errors * Fixed few formatting errors * Fixed few formatting errors * FIX: "WARNING: Title underline too short." during build RU docs. * FIX: "WARNING: Title underline too short." during build RU docs.
2017-05-08 05:06:04 +00:00
Replacing 'RestructuredText' sources with the 'Markdown' ones.
2017-10-25 05:27:09 +00:00
```bash
clickhouse-server --config-file=/etc/clickhouse-server/config.xml
```
Added a note about testing versions [#CLICKHOUSE-2].
2017-07-04 12:53:50 +00:00
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
При этом, лог будет выводиться в консоль - удобно для разработки.
Если конфигурационный файл лежит в текущей директории, то указывать параметр --config-file не требуется - по умолчанию будет использован файл ./config.xml
Соединиться с сервером можно с помощью клиента командной строки:
Fixed some ERRORS and WARNINGS during RU docs build. (#772) * Initial commit if EN docs * Part of EN documentation * Full queries section * External data * Table engines * System tables * Table functions * Formats * Data types * Operators * Functions * Dictionaries * Settings * Configuration files * Access rights * Quotas * Fixed few formatting errors * Fixed few formatting errors * Fixed few formatting errors * FIX: "WARNING: Title underline too short." during build RU docs. * FIX: "WARNING: Title underline too short." during build RU docs.
2017-05-08 05:06:04 +00:00
Replacing 'RestructuredText' sources with the 'Markdown' ones.
2017-10-25 05:27:09 +00:00
```bash
clickhouse-client
```
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
Параметры по умолчанию обозначают - соединяться с localhost:9000, от имени пользователя default без пароля.
Клиент может быть использован для соединения с удалённым сервером. Пример:
Fixed some ERRORS and WARNINGS during RU docs build. (#772) * Initial commit if EN docs * Part of EN documentation * Full queries section * External data * Table engines * System tables * Table functions * Formats * Data types * Operators * Functions * Dictionaries * Settings * Configuration files * Access rights * Quotas * Fixed few formatting errors * Fixed few formatting errors * Fixed few formatting errors * FIX: "WARNING: Title underline too short." during build RU docs. * FIX: "WARNING: Title underline too short." during build RU docs.
2017-05-08 05:06:04 +00:00
Replacing 'RestructuredText' sources with the 'Markdown' ones.
2017-10-25 05:27:09 +00:00
```bash
clickhouse-client --host=example.com
```
Added a note about testing versions [#CLICKHOUSE-2].
2017-07-04 12:53:50 +00:00
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
Подробнее смотри раздел "Клиент командной строки".
Проверим работоспособность системы:
Fixed some ERRORS and WARNINGS during RU docs build. (#772) * Initial commit if EN docs * Part of EN documentation * Full queries section * External data * Table engines * System tables * Table functions * Formats * Data types * Operators * Functions * Dictionaries * Settings * Configuration files * Access rights * Quotas * Fixed few formatting errors * Fixed few formatting errors * Fixed few formatting errors * FIX: "WARNING: Title underline too short." during build RU docs. * FIX: "WARNING: Title underline too short." during build RU docs.
2017-05-08 05:06:04 +00:00
Replacing 'RestructuredText' sources with the 'Markdown' ones.
2017-10-25 05:27:09 +00:00
```bash
milovidov@hostname:~/work/metrica/src/dbms/src/Client$ ./clickhouse-client
ClickHouse client version 0.0.18749.
Connecting to localhost:9000.
Connected to ClickHouse server version 0.0.18749.
Added a note about testing versions [#CLICKHOUSE-2].
2017-07-04 12:53:50 +00:00
Replacing 'RestructuredText' sources with the 'Markdown' ones.
2017-10-25 05:27:09 +00:00
:) SELECT 1
Added a note about testing versions [#CLICKHOUSE-2].
2017-07-04 12:53:50 +00:00
Replacing 'RestructuredText' sources with the 'Markdown' ones.
2017-10-25 05:27:09 +00:00
SELECT 1
Added a note about testing versions [#CLICKHOUSE-2].
2017-07-04 12:53:50 +00:00
Replacing 'RestructuredText' sources with the 'Markdown' ones.
2017-10-25 05:27:09 +00:00
┌─1─┐
│ 1 │
└───┘
Added a note about testing versions [#CLICKHOUSE-2].
2017-07-04 12:53:50 +00:00
Replacing 'RestructuredText' sources with the 'Markdown' ones.
2017-10-25 05:27:09 +00:00
1 rows in set. Elapsed: 0.003 sec.
Added a note about testing versions [#CLICKHOUSE-2].
2017-07-04 12:53:50 +00:00
Replacing 'RestructuredText' sources with the 'Markdown' ones.
2017-10-25 05:27:09 +00:00
:)
```
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
CLICKHOUSE-2720: progress on website and reference (#886) * update presentations * CLICKHOUSE-2936: redirect from clickhouse.yandex.ru and clickhouse.yandex.com * update submodule * lost files * CLICKHOUSE-2981: prefer sphinx docs over original reference * CLICKHOUSE-2981: docs styles more similar to main website + add flags to switch language links * update presentations * Less confusing directory structure (docs -> doc/reference/) * Minify sphinx docs too * Website release script: fail fast + pass docker hash on deploy * Do not underline links in docs * shorter * cleanup docker images * tune nginx config * CLICKHOUSE-3043: get rid of habrastorage links * Lost translation * CLICKHOUSE-2936: temporary client-side redirect * behaves weird in test * put redirect back * CLICKHOUSE-3047: copy docs txts to public too * move to proper file * remove old pages to avoid confusion * Remove reference redirect warning for now * Refresh README.md * Yellow buttons in docs * Use svg flags instead of unicode ones in docs * fix test website instance * Put flags to separate files * wrong flag * Copy Yandex.Metrica introduction from main page to docs * Yet another home page structure change, couple new blocks (CLICKHOUSE-3045) * Update Contacts section * CLICKHOUSE-2849: more detailed legal information * CLICKHOUSE-2978 preparation - split by files * More changes in Contacts block * Tune texts on index page * update presentations * One more benchmark * Add usage sections to index page, adapted from slides * Get the roadmap started, based on slides from last ClickHouse Meetup * CLICKHOUSE-2977: some rendering tuning * Get rid of excessive section in the end of getting started * Make headers linkable * CLICKHOUSE-2981: links to editing reference - https://github.com/yandex/ClickHouse/issues/849 * CLICKHOUSE-2981: fix mobile styles in docs * Ban crawling of duplicating docs * Open some external links in new tab * Ban old docs too * Lots of trivial fixes in english docs * Lots of trivial fixes in russian docs * Remove getting started copies in markdown * Add Yandex.Webmaster * Fix some sphinx warnings * More warnings fixed in english docs * More sphinx warnings fixed * Add code-block:: text * More code-block:: text * These headers look not that well * Better switch between documentation languages * merge use_case.rst into ya_metrika_task.rst * Edit the agg_functions.rst texts * Add lost empty lines * Lost blank lines * Add new logo sizes * update presentations * Next step in migrating to new documentation * Fix all warnings in en reference * Fix all warnings in ru reference * Re-arrange existing reference * Move operation tips to main reference * Fix typos noticed by milovidov@ * Get rid of zookeeper.md * Looks like duplicate of tutorial.html * Fix some mess with html tags in tutorial * No idea why nobody noticed this before, but it was completely not clear whet to get the data * Match code block styling between main and tutorial pages (in favor of the latter) * Get rid of some copypaste in tutorial * Normalize header styles * Move example_datasets to sphinx * Move presentations submodule to website * Move and update README.md * No point in duplicating articles from habrahabr here * Move development-related docs as is for now * doc/reference/ -> docs/ (to match the URL on website) * Adapt links to match the previous commit * Adapt development docs to rst (still lacks translation and strikethrough support) * clean on release * blacklist presentations in gulp * strikethrough support in sphinx * just copy development folder for now * fix weird introduction in style article * Style guide translation (WIP) * Finish style guide translation to English * gulp clean separately * Update year in LICENSE * Initial CONTRIBUTING.md * Fix remaining links to old docs in tutorial * Some tutorial fixes * Typo * Another typo * Update list of authors from yandex-team accoding to git log
2017-06-20 14:19:03 +00:00
**Поздравляем, система работает!**
Для дальнейших экспериментов можно попробовать загрузить из тестовых наборов данных:
Replacing 'RestructuredText' sources with the 'Markdown' ones.
2017-10-25 05:27:09 +00:00
```eval_rst
CLICKHOUSE-2720: progress on website and reference (#886) * update presentations * CLICKHOUSE-2936: redirect from clickhouse.yandex.ru and clickhouse.yandex.com * update submodule * lost files * CLICKHOUSE-2981: prefer sphinx docs over original reference * CLICKHOUSE-2981: docs styles more similar to main website + add flags to switch language links * update presentations * Less confusing directory structure (docs -> doc/reference/) * Minify sphinx docs too * Website release script: fail fast + pass docker hash on deploy * Do not underline links in docs * shorter * cleanup docker images * tune nginx config * CLICKHOUSE-3043: get rid of habrastorage links * Lost translation * CLICKHOUSE-2936: temporary client-side redirect * behaves weird in test * put redirect back * CLICKHOUSE-3047: copy docs txts to public too * move to proper file * remove old pages to avoid confusion * Remove reference redirect warning for now * Refresh README.md * Yellow buttons in docs * Use svg flags instead of unicode ones in docs * fix test website instance * Put flags to separate files * wrong flag * Copy Yandex.Metrica introduction from main page to docs * Yet another home page structure change, couple new blocks (CLICKHOUSE-3045) * Update Contacts section * CLICKHOUSE-2849: more detailed legal information * CLICKHOUSE-2978 preparation - split by files * More changes in Contacts block * Tune texts on index page * update presentations * One more benchmark * Add usage sections to index page, adapted from slides * Get the roadmap started, based on slides from last ClickHouse Meetup * CLICKHOUSE-2977: some rendering tuning * Get rid of excessive section in the end of getting started * Make headers linkable * CLICKHOUSE-2981: links to editing reference - https://github.com/yandex/ClickHouse/issues/849 * CLICKHOUSE-2981: fix mobile styles in docs * Ban crawling of duplicating docs * Open some external links in new tab * Ban old docs too * Lots of trivial fixes in english docs * Lots of trivial fixes in russian docs * Remove getting started copies in markdown * Add Yandex.Webmaster * Fix some sphinx warnings * More warnings fixed in english docs * More sphinx warnings fixed * Add code-block:: text * More code-block:: text * These headers look not that well * Better switch between documentation languages * merge use_case.rst into ya_metrika_task.rst * Edit the agg_functions.rst texts * Add lost empty lines * Lost blank lines * Add new logo sizes * update presentations * Next step in migrating to new documentation * Fix all warnings in en reference * Fix all warnings in ru reference * Re-arrange existing reference * Move operation tips to main reference * Fix typos noticed by milovidov@ * Get rid of zookeeper.md * Looks like duplicate of tutorial.html * Fix some mess with html tags in tutorial * No idea why nobody noticed this before, but it was completely not clear whet to get the data * Match code block styling between main and tutorial pages (in favor of the latter) * Get rid of some copypaste in tutorial * Normalize header styles * Move example_datasets to sphinx * Move presentations submodule to website * Move and update README.md * No point in duplicating articles from habrahabr here * Move development-related docs as is for now * doc/reference/ -> docs/ (to match the URL on website) * Adapt links to match the previous commit * Adapt development docs to rst (still lacks translation and strikethrough support) * clean on release * blacklist presentations in gulp * strikethrough support in sphinx * just copy development folder for now * fix weird introduction in style article * Style guide translation (WIP) * Finish style guide translation to English * gulp clean separately * Update year in LICENSE * Initial CONTRIBUTING.md * Fix remaining links to old docs in tutorial * Some tutorial fixes * Typo * Another typo * Update list of authors from yandex-team accoding to git log
2017-06-20 14:19:03 +00:00
.. toctree::
:glob:
example_datasets/*
Replacing 'RestructuredText' sources with the 'Markdown' ones.
2017-10-25 05:27:09 +00:00
```
Reference in New Issue Copy Permalink