Как получить текстовый дамп базы данных Postgres в Heroku

Быстрый ответ

Для создания дампа базы данных PostgreSQL в текстовом формате на Heroku выполните два действия:

1. Создайте и загрузите резервную копию:

   Bash

   Скопировать код

   heroku pg:backups:capture && heroku pg:backups:download

   Запустить код

2. Преобразуйте загруженный файл в SQL-формат с помощью pg_restore:

   Bash

   Скопировать код

   pg_restore -f mydb.sql latest.dump

   Запустить код

Здесь mydb.sql — это конечный файл с вашими данными. До начала работы убедитесь, что у вас установлен Postgres для использования команды pg_restore.

Извлечение данных из PostgreSQL на Heroku

Доступ к базе данных на Heroku часто необходим для получения важной информации. Sледуйте представленным шагам для эффективного извлечения данных из вашей базы данных PostgreSQL:

Настройка параметров подключения

Сначала установите Heroku CLI и войдите в аккаунт:

heroku login

После этого получите URL вашей базы данных Heroku PostgreSQL:

heroku config:get DATABASE_URL -a your-app-name

Следующая команда предоставит вам строку подключения и вернёт URL базы данных в формате postgres://<username>:<password>@<host_name>:<port>/<dbname>.

Подробнее об этом расскажет наш спикер на видео

Создание бэкапа с помощью команды pg_dump

Для создания полного бэкапа вашей базы данных используйте pg_dump:

pg_dump -F p -c --no-acl --no-owner -h <host_name> -U <username> -d <dbname> -f mydb_dump.sql

Эту операцию следует подтвердить вводом пароля.

Подключение дампа к локальной базе данных через psql

Имея файл mydb_dump.sql на руках, вы можете переместить данные в вашу локальную базу данных с использованием psql:

psql -d my_local_database -f mydb_dump.sql

Важно: ключ -d указывает вашу локальную базу данных, а -f служит для чтения из указанного файла.

Простое извлечение данных с помощью встроенных команд Heroku

Для упрощения процесса можно использовать встроенные команды Heroku:

heroku pg:backups:capture
heroku pg:backups:download
pg_restore -f mydb.sql latest.dump

В случае ошибки 'literal carriage return found in data' вам потребуется заменить соответствующую часть данных на "шестнадцатеричную последовательность байтов".

Клонирование базы данных с помощью команды heroku pg:pull

С помощью команды heroku pg:pull можно клонировать базу данных с Heroku прямо в ваше локальное окружение:

heroku pg:pull DATABASE_URL <DEV_DB_NAME> -a your-app-name

<DEV_DB_NAME> здесь — это имя вашей локальной базы данных.

Визуализация

Создание текстового дампа базы данных PostgreSQL на Heroku можно сравнить с приготовлением блюда по секретному рецепту:

1. Открываете кулинарную книгу (Heroku CLI): `heroku pg:backups:capture`
2. Находите и загружаете секретный рецепт (дамп базы данных): `heroku pg:backups:download`

╔═══════════════╗
║ 📚 КУЛИНАРНАЯ ║
║  КНИГА 🔐     ║═════🔓➤ 📄 Секретный Рецепт (PostgreSQL 🥧)
╚═══════════════╝

Основные ингредиенты:

- Вход на Heroku: `heroku login`
- Необходимые инструменты: `pg_restore`, `pg_dump`
- И, конечно же, файл `.sql` — главный компонент рецепта!

Завершение

В завершение приведем несколько рекомендаций по обеспечению безопасности ваших операций с базой данных:

Параметры pg_dump для упрощения процесса восстановления данных

Использование параметров -xO при работе с pg_dump облегчает процесс восстановления данных в другую базу данных:

pg_dump -xO -F p -h <host_name> -U <username> -d <dbname> > mydb_dump.sql

Анализ возникающих ошибок

Важно внимательно относиться к ошибкам, особенно к таким как 'literal carriage return found in data', и изучать документацию PostgreSQL для предотвращения возможных проблем. Не забывайте указывать -a your-app-name и проверять корректность всех путей.

Полезные материалы

1. Heroku PGBackups | Heroku Dev Center — подробная информация о работе с базами данных на Heroku.
2. PostgreSQL: Documentation: 16: pg_dump — документация по использованию pg_dump.
3. Heroku CLI Commands | Heroku Dev Center — руководство по работе с командами Heroku CLI.
4. Импорт и экспорт баз данных Heroku Postgres | Heroku Dev Center — описание процесса импорта и экспорта баз данных.
5. GitHub – heroku/heroku-pg: this code is now at https://github.com/heroku/cli — репозиторий на GitHub, посвященный работе с Postgres CLI на Heroku.