Быстрый старт CloudTable

Перед началом работы

1. Зарегистрируйтесь в личном кабинете Cloud.ru.

   Если вы уже зарегистрированы, войдите в консоль управления Advanced через личный кабинет Cloud.ru или как IAM-пользователь.

2. Создайте проект Enterprise Project Service (EPS). Так вы разграничите ресурсы, которые используете для ознакомления с сервисом.

3. Создайте сеть Virtual Private Cloud (VPC) с подсетью. В ней вы разместите кластер ClickHouse и виртуальную машину ECS.

4. Создайте группу безопасности и добавьте правила входящего и исходящего трафика, указанные ниже:

   ---

   Outbound Rules

   Inbound Rules

   Action	Protocol & Port	Type	Destination
   Allow	All	IPv4/IPv6	IP address 0.0.0.0/0

5. Создайте виртуальную машину ECS, через которую будете подключаться к кластеру ClickHouse.

   При создании укажите:

   • операционную систему семейства Linux;

   • сеть VPC, которую создали;

   • группу безопасности, которую создали;

   • привязку публичного IP-адреса (EIP).

Шаг 1. Создайте кластер ClickHouse

1. В списке сервисов выберите CloudTable.

2. На странице Cluster Management в правом верхнем углу нажмите Create Cluster.

3. Заполните параметры кластера:

   • Name — задайте название кластера.

   • VPC — выберите сеть VPC, которую создали.

   • Subnet — подсеть заполнится автоматически после указания сети VPC.

   • Security Group — выберите группу безопасности, которую создали.

   • Database Engine — выберите ClickHouse.

   • Cluster HA — выключите высокую доступность кластера.

   • Compute — выберите конфигурацию 8U16G.

   • Storage — выберите диск High I/O размером 500 GB.

   • Password и Confirm Password — задайте пароль пользователя admin для доступа к кластеру.

   • Enable Channel Encryption — выключите шифрование подключения к кластеру.

   • Enterprise Project — выберите EPS-проект, который создали.

   Остальные параметры могут быть по умолчанию.

4. Нажмите Next.

5. Проверьте параметры кластера и нажмите Submit.

6. Чтобы проследить за статусом создания кластера, нажмите Back to Cluster List.

   Когда статус кластера сменится на «In service», кластер готов к использованию.

Шаг 2. Установите клиент ClickHouse

1. Скачайте установочные файлы клиента ClickHouse на локальную машину:

   1. В консоли управления CloudTable на панели слева нажмите Help.

   2. Справа в блоке Helpful Links нажмите:

      • Download the ClickHouse Client, чтобы скачать пакет установки клиента ClickHouse;

      • Download the Client Verification File, чтобы скачать файл верификации клиента.

2. Загрузите скачанные файлы на виртуальную машину ECS:

   1. Подключитесь к виртуальной машине ECS.

   2. В терминале виртуальной машины cоздайте каталог, в который скопируете файлы. Например:

      mkdir clickhouse-client
      
      

   3. На вашей локальной машине откройте еще одно окно терминала и скопируйте пакет установки клиента ClickHouse_Client_<версия>.tar.gz в созданный каталог. Например:

      scp Downloads/ClickHouse_Client_New_Version_23.3.tar.gz root@EIP:~/clickhouse-client/
      
      

      Где EIP — внешний IP-адрес виртуальной машины.

      Пути к каталогам и версию клиента в примере замените на свои.

      Подсказка

      На машине с операционной системой Windows используйте терминал Windows PowerShell.

      После ввода пароля пользователя начнется загрузка файла.

   4. Повторите команду копирования для пакета с файлом верификации Client_sha256.tar.gz, например:

      scp Downloads/Client_sha256.tar.gz root@EIP:~/clickhouse-client/
      
      

3. Разархивируйте файлы и проверьте их подлинность:

   1. В терминале виртуальной машины перейдите в каталог, в который скопировали файлы, и разархивируйте пакет с клиентом. Например:

      cd clickhouse-client/
      tar -zxf ClickHouse_Client_New_Version_23.3.tar.gz
      
      

   2. Разархивируйте пакет с файлом верификации:

      tar xzvf Client_sha256.tar.gz
      
      

   3. Получите код верификации клиента:

      sha256sum ClickHouse_Client_<версия>.tar.gz
      
      

      В результате выполнения команды появится код, который потребуется сравнить.

   4. Откройте файл ClickHouse_Client_<версия>.tar.gz.sha256 с кодом верификации:

      less ClickHouse_Client_<версия>.tar.gz.sha256
      
      

      Сравните этот код с кодом из предыдущего шага — если они не совпадают, файл клиента мог быть подменен.

   5. Чтобы выйти из режима просмотра файла, нажмите q.

4. Установите клиент:

   1. Перейдите в разархивированный каталог clickhouse:

      cd clickhouse/
      
      

   2. Запустите файл установки клиента install.sh:

      ./install.sh
      
      

Шаг 3. Подключитесь к кластеру

1. Перейдите в каталог bin и задайте разрешение 700 для каталога clickhouse:

   cd bin/
   chmod 700 clickhouse
   
   

2. Подключитесь к кластеру ClickHouse:

   ./clickhouse client --host <адрес кластера> --port 9000 --user admin --password <пароль>
   
   

   Где:

   • <пароль> — пароль пользователя admin, который вы задали во время создания кластера;

   • <адрес кластера> — адрес доступа к кластеру ClickHouse вида clickhous-server-...cloudtable.hc.sberclouds.ru.

     Как узнать адрес кластера

Шаг 4. Создайте базу данных с таблицей и выполните запрос

1. Создайте базу данных и перейдите в нее:

   CREATE DATABASE demo_db;
   
   USE demo_db;
   
   

2. Создайте таблицу:

   CREATE TABLE demo_table
   (
       id UInt32,
       name String,
       age UInt8,
       score Float32,
       event_date Date
   )
   ENGINE = MergeTree()
   ORDER BY id;
   
   

3. Вставьте данные в таблицу:

   INSERT INTO demo_table (id, name, age, score, event_date) VALUES
   (1, 'Alice', 23, 88.7, '2024-06-01'),
   (2, 'Bob', 31, 92.1, '2024-06-02'),
   (3, 'Charlie', 27, 75.2, '2024-06-03'),
   (4, 'Diana', 29, 82.9, '2024-06-04'),
   (5, 'Eve', 35, 89.5, '2024-06-05'),
   (6, 'Frank', 41, 78.0, '2024-06-06');
   
   

4. Выполните SQL-запрос к таблице:

   SELECT * FROM demo_table;
   
   

   Пример ответа на запрос:

   SELECT *
   FROM demo_table
   
   Query id: 9b103860-e155-4503-8201-2b695b1a8e75
   
   ┌─id─┬─name────┬─age─┬─score─┬─event_date─┐
   │  1 │ Alice   │  23 │  88.7 │ 2024-06-01 │
   │  2 │ Bob     │  31 │  92.1 │ 2024-06-02 │
   │  3 │ Charlie │  27 │  75.2 │ 2024-06-03 │
   │  4 │ Diana   │  29 │  82.9 │ 2024-06-04 │
   │  5 │ Eve     │  35 │  89.5 │ 2024-06-05 │
   │  6 │ Frank   │  41 │    78 │ 2024-06-06 │
   └────┴─────────┴─────┴───────┴────────────┘
   
   6 rows in set. Elapsed: 0.003 sec.
   
   

Что дальше