Help us understand the problem. What is going on with this article?

Herokuでデータベースのバックアップを行いたい

More than 3 years have passed since last update.

はじめに

Heroku Postgresを使っていれば、他のアドオンを追加することなしにバックアップを利用することができます。この記事ではHeroku Postgresのデータベースのバックアップの取得方法、リストア方法、運用方法をまとめていきたいと思います。

やりたいこと

  • データベースのバックアップを取りたい
    • 手動バックアップを取りたい
    • 定期バックアップを取りたい
  • リストアをしたい
  • ステージング環境に本番データを投入したい
  • バックアップデータをローカル環境に落としておきたい

データベースのバックアップを取りたい

手動バックアップを取りたい

Webの管理画面からバックアップを行う

Heroku Postgresの管理画面からバックアップを取得できます。"PG Backups"の画面でバックアップやリストアの操作ができます。わりと直感的に操作ができると思いますので、操作方法の説明は省かせていただきます。

Herokuコマンドからバックアップを行う

Creating a backup

heroku pg:backupsコマンドでバックアップ操作を行えます。手動バックアップはcaptureサブコマンドで取得できます。以下のコマンドで--appで指定したアプリケーションで使っているデータベースのバックアップを取ります。
$ heroku pg:backups capture --app your-app-name

実行例

$ heroku pg:backups capture --app some-application

Use Ctrl-C at any time to stop monitoring progress; the backup
will continue running. Use heroku pg:backups info to check progress.
Stop a running backup with heroku pg:backups cancel.

DATABASE ---backup---> b007

Backup completed

$ # 一覧表示: b007というバックアップができていることがわかる
$ heroku pg:backups --app some-application 
=== Backups
ID    Backup Time                Status                              Size    Database
----  -------------------------  ----------------------------------  ------  --------
b007  2015-07-31 14:38:43 +0000  Finished 2015-07-31 14:38:46 +0000  14.9kB  DATABASE
b006  2015-07-31 14:11:45 +0000  Finished 2015-07-31 14:11:46 +0000  14.9kB  DATABASE

=== Restores
No restores found. Use `heroku pg:backups restore` to restore a backup

=== Copies
No copies found. Use `heroku pg:copy` to copy a database to another

定期バックアップを取りたい

Scheduling backups

定期バックアップを取るには、scheduleサブコマンドを使います。
例として、AM 2:00にバックアップを取得する設定をします。時刻の後ろにはタイムゾーンを指定します。ここではAsia/Tokyoとしています。
$ heroku pg:backups schedule DATABASE_URL --at '02:00 Asia/Tokyo' --app your-app-name

実行例

$ heroku pg:backups schedule DATABASE_URL --at '02:00 Asia/Tokyo' --app some-application
Scheduled automatic daily backups at 02:00 Asia/Tokyo for DATABASE

設定した定期バックアップのスケジュール確認はschedulesサブコマンドを使います。
$ heroku pg:backups schedules --app your-app-name

定期バックアップを削除するにはunscheduleサブコマンドを使います。
$ heroku pg:backups unschedule DATABASE_URL --app your-app-name

リストアをしたい

Restoring backups

リストアをするにはrestoreサブコマンドを使います。b100には対象のバックアップIDを入力します。
$ heroku pg:backups restore b100 DATABASE_URL --app your-app-name

このままコマンドを打つと以下の警告が出ます。投入先のアプリケーション名が正しいことを確認後、アプリケーション名を入力するとリストアが始まります。

 !    WARNING: Destructive Action
 !    This command will affect the app: your-app-name
 !    To proceed, type "your-app-name" or re-run this command with --confirm your-app-name

ステージング環境に本番データを投入したい

ステージング環境の作り方は次の記事を参考にしてください。
Herokuでステージング環境を作成する

上記の方法でステージング環境を作ればその時点での本番データをステージング環境に投入されていますが、環境の作成から時間が経過した場合など、再度同期したいタイミングが出てくると思います。リストア時にステージング環境のアプリケーションを指定すれば、本番データの投入が可能になります。

your-app-nameには本番のアプリケーション名、b101には本番データのバックアップID、your-app-name-stにはステージングのアプリケーション名を指定します。

$ heroku pg:backups restore your-app-name::b101 DATABASE_URL --app your-app-name-st --confirm your-app-name-st

--confirmオプションをつけると確認ダイアログをパスできます。

バックアップデータをローカル環境に落としておきたい

Downloading your backups

Heroku Postgresの管理画面からもバックアップデータをダウンロードすることができますが、コマンドラインでももちろん可能です。
バックアップデータはAWSのS3上に置かれているのですが、heroku pg:backups public-urlコマンドで公開URLを取得し、curlなどでダウンロードをします。

$ curl -o latest.dump `heroku pg:backups public-url -a your-app-name`

なお、このデータはPostgreSQLのダンプデータですので、ローカル環境にインストールしたPostgreSQL上に復元することもできます。

【補足】バックアップの世代について

契約しているデータベースプランによってバックアップを保持できる世代数や保持期間が変わるので注意が必要です。例えば、手動バックアップの保持できる世代数は無料のHobby-Devであれば2世代、有料のStandardであれば25世代となっています。また、定期バックアップの保持期間は無料のHobby-Devであれば1週間、有料のStandardであれば4週間となっています。

詳細は以下の資料を確認してください。

参考資料

この記事を書くために以下の公式資料を参考にしました。
Heroku PGBackups

以上です。

Why not register and get more from Qiita?
  1. We will deliver articles that match you
    By following users and tags, you can catch up information on technical fields that you are interested in as a whole
  2. you can read useful information later efficiently
    By "stocking" the articles you like, you can search right away
Comments
No comments
Sign up for free and join this conversation.
If you already have a Qiita account
Why do not you register as a user and use Qiita more conveniently?
You need to log in to use this function. Qiita can be used more conveniently after logging in.
You seem to be reading articles frequently this month. Qiita can be used more conveniently after logging in.
  1. We will deliver articles that match you
    By following users and tags, you can catch up information on technical fields that you are interested in as a whole
  2. you can read useful information later efficiently
    By "stocking" the articles you like, you can search right away
ユーザーは見つかりませんでした