Як підключитися та використовувати PostgreSQL у Python

Автор

Основні висновки

  • Спочатку завантажте та встановіть PostgreSQL, адаптовану до вашої операційної системи, а потім використайте бібліотеку psycopg2 для встановлення з’єднання між вашим кодом Python та базою даних PostgreSQL.
  • Застосуйте pgAdmin4 для отримання необхідних даних сервера, які знадобляться для підключення до вашої бази даних Postgres з Python.
  • Використовуйте SQL-запити, безпосередньо з вашого коду Python, для створення, перевірки стану або видалення баз даних PostgreSQL.

Якщо ви розробляєте додаток на Python, якому потрібен доступ до даних, що зберігаються в базі даних Postgres, вам необхідно навчитись встановлювати з’єднання з нею. З’єднання дозволить вам надсилати запити та отримувати або зберігати дані.

Завантаження та встановлення PostgreSQL

PostgreSQL є відмінним рішенням для різноманітних програмних проектів. Ви можете вибрати та завантажити потрібну версію PostgreSQL, яка відповідає вашій операційній системі. PostgreSQL доступна для завантаження на популярних платформах, таких як Windows, macOS та Linux (Ubuntu).

Процес інсталяції може відрізнятися залежно від операційної системи, тому важливо уважно дотримуватися інструкцій, щоб забезпечити успішне налаштування.

Інсталяція необхідної бібліотеки

Для зв’язку з базою даних PostgreSQL з Python вам знадобиться бібліотека psycopg2. Виконайте наступний код в інтерпретаторі Python для перевірки наявності цієї бібліотеки:

 import psycopg2

У випадку, якщо з’явиться повідомлення про помилку (наприклад, “Відсутній модуль з назвою ‘psycopg2′”), вам потрібно встановити бібліотеку, скориставшись цією командою:

 pip install psycopg2

PIP – це менеджер пакетів Python, доступний для встановлення на Windows, Mac або Linux. Він значно спрощує встановлення додаткових пакетів для Python.

Отримання облікових даних за допомогою pgAdmin4

Програма pgAdmin4 є зручним інструментом для керування базами даних Postgres через графічний інтерфейс. Якщо ви не встановили її разом із PostgreSQL, ви можете завантажити pgAdmin4 та інсталювати її окремо.

Ось покрокова інструкція для отримання необхідних даних сервера за допомогою pgAdmin4:

  • Запустіть pgAdmin4 з меню вашої програми.
  • Знайдіть і натисніть на розділ “Сервери” зліва у вікні програми.
  • Введіть пароль, який ви встановили для PostgreSQL під час початкового налаштування.
  • Після підключення до сервера, клікніть правою кнопкою миші на “PostgreSQL 16” і виберіть “Властивості”.
  • У діалоговому вікні “Властивості” виберіть “Підключення”.
  • Запишіть ім’я хоста, номер порту та ім’я користувача.

    • Встановлення з’єднання із сервером Postgres

    Маючи необхідні облікові дані, ви можете використовувати бібліотеку psycopg2 для створення з’єднання з сервером Postgres. Скористайтеся функцією connect() таким чином:

     conn = psycopg2.connect(host="localhost", port="5432", user="postgres", password='your password here')

    Далі потрібно створити об’єкт курсора, який дозволить вам виконувати команди Postgres у вашому коді Python:

     cur = conn.cursor()

    Нарешті, встановіть автоматичне підтвердження змін, щоб Python автоматично фіксував кожну виконану операцію. Це позбавить вас від необхідності викликати commit після кожного рядка коду:

     conn.set_session(autocommit = True)

    Виконавши ці інструкції, ви зможете успішно підключитися до вашого локального екземпляру сервера Postgres.

    Створення нової бази даних Postgres

    База даних Postgres є основою для зберігання колекцій взаємопов’язаних таблиць. Для створення нової бази даних використовуйте команду SQL CREATE DATABASE, яку потрібно передати методу execute() об’єкта курсора:

     try:
        cur.execute('''CREATE DATABASE DB_NAME''')
    except psycopg2.Error as e:
        print(e)

    Завжди варто обробляти винятки, які можуть виникнути. В даному прикладі будь-яка помилка просто виводиться на екран, але у реальному коді ви повинні вжити належних заходів.

    Перевірка створеної бази даних за допомогою pgAdmin4

    Після виконання вищенаведеного запиту, перевірте успішність створення нової бази даних за допомогою pgAdmin4. Оновіть перелік баз даних і знайдіть створену вами.

    Наприклад, якщо ви створювали зразкову базу даних з назвою “музика”, вона повинна з’явитися в списку баз даних у розділі Postgres16 > Бази даних.

    Видалення бази даних Postgres

    Якщо певна база даних вам більше не потрібна, ви можете видалити її (або “скинути”) за допомогою наступної команди:

     try:
        cur.execute('''DROP DATABASE MUSIC''')
    except psycopg2.Error as e:
        print(e)

    Замість команди create використовуйте команду drop. Після виконання цієї операції відповідна база даних буде видалена.