Cloud Databases: создайте первую управляемую базу данных

Cloud Databases — сервис, позволяющий работать с управляемыми базами данных.

Начните работу с сервисом Cloud Databases любым удобным способом:

• Воспользуйтесь инструкцией и создайте первую управляемую базу данных PostgreSQL, подключитесь к ней и выполните тестовые запросы.
• Посмотрите видео, в которых будут созданы управляемые базы данных MySQL, PostgreSQL и ClickHouse в конфигурации Single.
• Пройдите бесплатный обучающий курс. В теоретической части курса объясняется, что такое база данных и система управления базами данных, какие есть типы и конфигурации БД. В практической части курса вы создадите кластер PostgreSQL и БД MySQL, затем подключите созданную БД MySQL к приложению, установленному на виртуальной машине.

Пройдя все шаги этой инструкции, вы:

1. Создадите инстанс БД PostgreSQL в конфигурации Single.
2. Получите внешний IP-адрес созданного инстанса БД.
3. (Опционально) Посмотрите логи созданного инстанса БД.
4. Установите в инстанс БД расширение TimescaleDB.
5. Подключитесь к БД.
6. Создадите таблицы в БД.
7. Наполните таблицы данными.
8. Выполните тестовые запросы к БД.
9. (Опционально) Познакомитесь с данными мониторинга, собранными за время работы инстанса БД.

В качестве примера тестовых данных будет использован автоматически генерируемый набор данных, представляющий собой информацию от сенсоров интернета вещей (IoT): температуры и загрузки CPU. Подробнее про тестовый набор данных читайте в документации Timescale. Процедура генерации подобных наборов данных подробно рассматривается в блоге Timescale.

1. Перейдите в личный кабинет VK Cloud.

2. Выберите проект, в котором будет размещен инстанс БД.

3. Перейдите в раздел Базы данных → Инстансы баз данных.

4. Если в выбранном проекте нет ни одного инстанса БД, нажмите кнопку Создать базу данных.

   Иначе нажмите кнопку Добавить.

5. На шаге Конфигурация выберите:

   • Тип базы данных PostgreSQL и самую актуальную версию СУБД.
   • Конфигурацию Single.

6. Нажмите кнопку Следующий шаг.

7. На шаге Создание инстанса задайте:

   • Имя инстанса базы данных: например, vk-cloud-dbaas-quickstart.

   • Тип виртуальной машины: STD3-2-8.

   • Зону доступности: Москва (GZ1).

   • Тип диска: SSD.

   • Размер диска, GB: 10.

   • Включить автомасштабирование диска: убедитесь, что эта опция не выбрана.

   • Сеть: Создать новую сеть.

   • Адрес подсети: 10.0.1.0/24.

   • Назначить внешний IP: убедитесь, что эта опция выбрана.

   • Настройки Firewall: выберите ssh из выпадающего списка.

     Итоговый список групп безопасности должен иметь вид: default, ssh.

   • Создать реплику: убедитесь, что эта опция не выбрана.

   • Ключ для доступа по SSH: Создать новый ключ.

   • Резервное копирование: Отключено.

8. Нажмите кнопку Следующий шаг.

9. На шаге Инициализация задайте:

   • Тип создания: Новая база данных.

   • Имя базы данных для создания: tsdb1.

   • Имя пользователя: tsuser1.

   • Пароль пользователя: задайте пароль или сгенерируйте его.

10. Нажмите кнопку Создать базу данных.

    Дождитесь завершения создания инстанса БД, этот процесс может занять длительное время.

1. Перейдите в личный кабинет VK Cloud.

2. Выберите проект, где находится инстанс БД.

3. Перейдите в раздел Базы данных → Инстансы баз данных.

4. Нажмите на имя инстанса БД. Откроется страница с информацией.

5. Перейдите на вкладку Информация.

   В параметре Внешний IP-адрес будет указан нужный адрес.

1. Подключитесь к инстансу БД по SSH, используя приватный SSH-ключ, полученный при создании инстанса БД:

   Linux/macOS

   Windows

    
   chmod 0600 <путь/к/ключу/ключ.pem>ssh -i <путь/к/ключу/ключ.pem> admin@<внешний IP-адрес инстанса БД>

    
   ssh -i <путь/к/ключу/ключ.pem> admin@<внешний IP-адрес инстанса БД>

2. Посмотрите логи инстанса:

    
   journalctl -u postgresql

   Пример фрагмента вывода

   По приведенному фрагменту вывода можно заключить, что PostgreSQL запущен, работает и готов принимать входящие соединения.

1. Перейдите в личный кабинет VK Cloud.

2. Выберите проект, где находится инстанс БД.

3. Перейдите в раздел Базы данных → Инстансы баз данных.

4. Нажмите на имя инстанса БД. Откроется страница с информацией.

5. Перейдите на вкладку Расширения.

6. Нажмите кнопку Добавить.

7. В выпадающем списке Доступные расширения выберите Расширение с открытым исходным кодом для хранения данных временного ряда (timescaledb).

8. Нажмите кнопку Добавить.

   Дождитесь завершения установки расширения: оно должно перейти из состояния Создается в состояние Активное.

1. Установите утилиту psql:

   Linux (APT)

   Linux (RPM)

   macOS (Homebrew)

   Windows

   1. Подключите репозиторий PostgreSQL:

       
      sudo apt install curl ca-certificates gnupgcurl https://www.postgresql.org/media/keys/ACCC4CF8.asc | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/apt.postgresql.org.gpg > /dev/nullsudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'sudo apt update

   2. Установите утилиту psql:

       
      sudo apt install -y postgresql-client

   1. Подключите репозиторий PostgreSQL:

      1. Заполните опросник на странице загрузки PostgreSQL для Linux семейства RedHat:

         • Select version: выберите самую актуальную версию.
         • Select platform: выберите дистрибутив операционной системы.
         • Select architecture: выберите архитектуру. Если вы не знаете, какую архитектуру выбрать, выберите x86_64.

         Появится текст установочного скрипта.

      2. Скопируйте команду из скрипта под комментарием Install the repository RPM. Ее вид зависит от выбранного дистрибутива:

         yum

         dnf

          
         sudo yum install -y https://download.postgresql.org/pub/repos/yum/...

          
         sudo dnf install -y https://download.postgresql.org/pub/repos/yum/...

      3. Выполните скопированную команду.

      4. Если использовалась команда вида sudo dnf..., отключите встроенный модуль PostgreSQL:

          
         sudo dnf -qy module disable postgresql

   2. Установите утилиту psql:

      yum

      dnf

       
      sudo yum install -y postgresql

       
      sudo dnf install -y postgresql

   1. Установите утилиту psql:

       
      brew install libpq

   2. Создайте символические ссылки на исполняемые файлы libpq:

       
      brew link --force libpq

      Это необходимо, чтобы запускать утилиту psql, не указывая полный путь к ее исполняемому файлу.

   1. Загрузите инсталлятор от EDB для самой актуальной версии PostgreSQL.

   2. Выполните установку.

      При установке:

      1. На шаге Installation Directory запишите путь, куда будет выполнена установка.
      2. На шаге Select Components снимите выбор со всех компонентов, кроме Command Line Tools.

   3. Добавьте путь к исполняемым файлам утилит командной строки PostgreSQL в переменную среды окружения Path:

      1. Откройте Пуск → Этот компьютер → Свойства → Дополнительные параметры системы → Переменные среды.

      2. В списке Системные переменные измените значение переменной Path, добавив к существующему значению путь к директории с исполняемыми файлами утилит командной строки PostgreSQL.

         Пример пути при установке PostgreSQL с параметрами по умолчанию:

          
         C:\Program Files\PostgreSQL\15\bin\

2. Подключитесь к базе данных tsdb1 с помощью утилиты psql:

   1. Выполните команду:

       
      psql -h <внешний IP-адрес инстанса БД> -d tsdb1 -U tsuser1

   2. Введите пароль пользователя tsuser1, заданный при создании инстанса БД.

   При успешном подключении должно отобразиться приглашение:

    
   tsdb1=>

1. Активируйте расширение TimescaleDB:

    
   CREATE EXTENSION timescaledb;

   Дождитесь появления приглашения tsdb1=>.

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

    
   CREATE TABLE sensors(  id SERIAL PRIMARY KEY,  type VARCHAR(50),  location VARCHAR(50));

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

    
   CREATE TABLE sensor_data (  time TIMESTAMPTZ NOT NULL,  sensor_id INTEGER,  temperature DOUBLE PRECISION,  cpu DOUBLE PRECISION,  FOREIGN KEY (sensor_id) REFERENCES sensors (id));

4. Убедитесь, что таблицы были успешно созданы:

    
   SELECT tablenameFROM pg_catalog.pg_tablesWHERE tablename LIKE 'sensor%';

   Результат запроса

5. Конвертируйте таблицу PostgreSQL sensor_data в гипертаблицу (hypertable) TimescaleDB:

    
   SELECT create_hypertable('sensor_data', 'time');

6. Убедитесь, что гипертаблица sensor_data была успешно создана:

    
   SELECT hypertable_nameFROM timescaledb_information.hypertables;

   Результат запроса

1. Наполните таблицу sensors данными:

    
   INSERT INTO sensors (type, location) VALUES('a','floor'),('a', 'ceiling'),('b','floor'),('b', 'ceiling');

2. Убедитесь, что данные были успешно вставлены в таблицу:

    
   SELECT * FROM sensors;

   Результат запроса

3. Наполните таблицу sensor_data случайно сгенерированными данными:

    
   INSERT INTO sensor_data (time, sensor_id, cpu, temperature)SELECT  time,  sensor_id,  random() AS cpu,  random()*100 AS temperatureFROM generate_series(now() - interval '24 hour', now(), interval '5 minute') AS g1(time), generate_series(1,4,1) AS g2(sensor_id);

4. Убедитесь, что данные были успешно вставлены в таблицу, выведя первые несколько строк таблицы:

    
   SELECT * FROM sensor_data ORDER BY time LIMIT 8;

   Пример результата запроса

1. Выведите средние значения температуры и загрузки CPU за тридцатиминутные интервалы:

    
   SELECT  time_bucket('30 minutes', time) AS period,  AVG(temperature) AS avg_temp,  AVG(cpu) AS avg_cpuFROM sensor_dataGROUP BY periodORDER BY period;

   Пример части результата запроса

2. Выведите средние значения температуры и загрузки CPU за тридцатиминутные интервалы, а также последнее зафиксированное за интервал значение температуры:

    
   SELECT  time_bucket('30 minutes', time) AS period,  AVG(temperature) AS avg_temp,  last(temperature, time) AS last_temp,  AVG(cpu) AS avg_cpuFROM sensor_dataGROUP BY periodORDER BY period;

   Пример части результата запроса

Вывод результатов запросов, похожих на приведенные, свидетельствует о корректной работе PostgreSQL и расширения TimescaleDB.

Для PostgreSQL доступен мониторинг. Познакомьтесь с собранными данными мониторинга:

1. Перейдите в личный кабинет VK Cloud.
2. Выберите проект, где находится инстанс БД.
3. Перейдите в раздел Базы данных → Инстансы баз данных.
4. Нажмите на имя инстанса БД. Откроется страница с информацией.
5. Перейдите на вкладку Мониторинг.
6. Выберите нужный временной интервал и посмотрите собранные данные.

Инстанс БД тарифицируется и потребляет вычислительные ресурсы. Если он вам больше не нужен:

1. Удалите инстанс БД.
2. При необходимости удалите Floating IP-адрес, назначенный инстансу БД. Присутствующие в проекте Floating IP-адреса тарифицируются.

Пройдите бесплатный обучающий курс.

В теоретической части курса объясняется, что такое база данных и система управления базами данных, какие есть типы и конфигурации БД. В практической части курса вы создадите кластер PostgreSQL и БД MySQL, затем подключите созданную БД MySQL к приложению, установленному на виртуальной машине.