Жылдам бастау

Жылдам бастау сізге PostgreSQL мысалында сервисті пайдалануды бастауға және оның мүмкіндіктерімен танысуға көмектеседі.

Жылдам бастау қадамдарының барлығын орындағаннан кейін, сіз:

1. Бір хосттан тұратын PostgreSQL БД инстансын жасайсыз.
2. Инстансқа TimescaleDB кеңейтімін орнатасыз.
3. Инстансқа логтарды қарау үшін де, SQL сұрауларын орындау үшін де қосылуды үйренесіз.
4. Кеңейтімнің жұмыс істейтінін тексеру үшін TimescaleDB үшін тестілік деректер мен сұраулар жасайсыз.
5. БД инстансының жұмыс істеуі барысында жиналған мониторинг деректерімен танысасыз.

Тестілік деректердің мысалы ретінде автоматты түрде жасалатын, заттар интернеті (IoT) сенсорларынан алынған ақпаратты: температура мен CPU жүктемесін білдіретін деректер жиыны пайдаланылады. Тестілік деректер жиыны туралы толығырақ Timescale құжаттамасынан оқыңыз. Осындай деректер жиындарын жасау процедурасы Timescale блогында егжей-тегжейлі қарастырылады.

1. psql утилитасы орнатылғанына көз жеткізіңіз. Ол үшін утилитаның нұсқасын қараңыз:

    
   psql --version

   Егер утилита орнатылған болса, оның нұсқасы көрсетіледі:

    
   psql (PostgreSQL) 14.7

   Егер утилита орнатылмаған болса, psql командасы табылмағаны туралы ақпарат көрсетіледі.

2. Егер 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. RedHat тектес Linux үшін PostgreSQL жүктеу бетінде сауалнаманы толтырыңыз:

         1. Select version: ең өзекті нұсқаны таңдаңыз.
         2. Select platform: операциялық жүйе дистрибутивін таңдаңыз.
         3. 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. PostgreSQL-дің ең өзекті нұсқасына арналған EDB орнатқышын жүктеп алыңыз.

   2. Орнатуды орындаңыз.

      Орнату кезінде:

      1. Installation Directory қадамында орнату орындалатын жолды жазып алыңыз.
      2. Select Components қадамында Command Line Tools компонентінен басқасының барлығынан таңдауды алып тастаңыз.

   3. PostgreSQL пәрмен жолы утилиталарының орындалатын файлдарына дейінгі жолды Path орта айнымалысына қосыңыз:

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

      2. Системные переменные тізімінде Path айнымалысының мәнін өзгертіп, оған PostgreSQL пәрмен жолы утилиталарының орындалатын файлдары орналасқан директорияға дейінгі жолды қосыңыз.

         Әдепкі параметрлермен орнатылғандағы жолдың мысалы:

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

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. RedHat тектес Linux үшін PostgreSQL жүктеу бетінде сауалнаманы толтырыңыз:

         • 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. PostgreSQL-дің ең өзекті нұсқасына арналған EDB орнатқышын жүктеп алыңыз.

   2. Орнатуды орындаңыз.

      Орнату кезінде:

      1. Installation Directory қадамында орнату орындалатын жолды жазып алыңыз.
      2. Select Components қадамында Command Line Tools компонентінен басқасының барлығынан таңдауды алып тастаңыз.

   3. PostgreSQL пәрмен жолы утилиталарының орындалатын файлдарына дейінгі жолды Path орта айнымалысына қосыңыз:

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

      2. Системные переменные тізімінде Path айнымалысының мәнін өзгертіп, оған 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 кестесін TimescaleDB гиперкестесіне (hypertable) түрлендіріңіз:

    
   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 мекенжайлары тарификацияланады.