MongoDBのバックアップを行うには、mongodumpを利用します。
この記事では、mongodumpについて解説をしています。
本記事の内容
- mongodumpとは？
- mongodumpのインストール
- mongodumpによるバックアップ
それでは、上記に沿って解説していきます。
mongodumpとは？
mongodumpとは、データベースの内容（データに限っていない）をエクスポートするユーティリティです。
つまり、mongodumpはMongoDBのバックアップツールになります。
そして、 mongodumpで保存したファイルはバイナリ形式です。
一般的には、テキスト形式と比較すると、以下の点でバイナリ形式が優位となります。
- バックアップ処理の実行速度
- バックアップファイルの圧縮率
以上、mongodumpの説明でした。
次は、mongodumpのインストールについて説明します。
mongodumpのインストール
mongodumpは、MongoDB Database Toolsに含まれています。
そして、MongoDB Database ToolsはMongoDB本体と一緒にインストールされます。
いわゆる、クライアントツールと言われるヤツですね。
そのため、MongoDBをインストール済みなら、何もする必要はありません。
MongoDB関連のインストール済みパッケージを確認します。
（インストール方法によって「-org」がつかないケースがあります）
$ dpkg -l | grep mongo ii mongodb-database-tools 100.3.1 amd64 mongodb-database-tools package provides tools for working with the MongoDB server: ii mongodb-org 4.4.6 amd64 MongoDB open source document-oriented database system (metapackage) ii mongodb-org-database-tools-extra 4.4.6 amd64 Extra MongoDB database tools ii mongodb-org-mongos 4.4.6 amd64 MongoDB sharded cluster query router ii mongodb-org-server 4.4.6 amd64 MongoDB database server ii mongodb-org-shell 4.4.6 amd64 MongoDB shell client ii mongodb-org-tools 4.4.6 amd64 MongoDB tools
mongodb-database-toolsとmongodb-org-toolsで似たような感じです。
しかし、それぞれ機能は異なります。
mongodumpは、mongodb-database-toolsに含まれています。
mongodb-database-toolsパッケージを確認します。
$ sudo apt show mongodb-database-tools
Package: mongodb-database-tools
Version: 100.3.1
Priority: optional
Section: database
Maintainer: MongoDB Connectors Team <database-tools-packaging@mongodb.com>
Installed-Size: 不明
Provides: mongodb-database-tools
Depends: libc6, libgssapi-krb5-2, libkrb5-3, libk5crypto3, libcomerr2, libkrb5support0, libkeyutils1
Conflicts: mongodb-database-tools
Breaks: mongodb-org-tools (<= 4.3.2), mongodb-org-tools-unstable (<= 4.3.2), mongodb-enterprise-tools (<= 4.3.2), mongodb-enterprise-tools-unstable (<= 4.3.2)
Replaces: mongodb-database-tools (<= 100.3.1), mongodb-org-tools (<= 4.3.2), mongodb-org-tools-unstable (<= 4.3.2), mongodb-enterprise-tools (<= 4.3.2), mongodb-enterprise-tools-unstable (<= 4.3.2)
Homepage: http://www.mongodb.com
Download-Size: 52.7 MB
APT-Manual-Installed: no
APT-Sources: https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/4.4/multiverse amd64 Packages
Description: mongodb-database-tools package provides tools for working with the MongoDB server:
*bsondump - display BSON files in a human-readable format
*mongoimport - Convert data from JSON, TSV or CSV and insert them into a collection
*mongoexport - Write an existing collection to CSV or JSON format
*mongodump/mongorestore - Dump MongoDB backups to disk in .BSON format,
or restore them to a live database
*mongostat - Monitor live MongoDB servers, replica sets, or sharded clusters
*mongofiles - Read, write, delete, or update files in GridFS
(see: http://docs.mongodb.org/manual/core/gridfs/)
*mongotop - Monitor read/write activity on a mongo server
mongodumpのキーワードが、含まれていることを確認できます。
他にも、いろいろな機能を持ったツールがありますね。
では、mongodumpのバージョンを確認しておきます。
$ mongodump --version mongodump version: 100.3.1 git version: 32632b931f9c41d8314b75ecc88e551b012b1e30 Go version: go1.15.8 os: linux arch: amd64 compiler: gc
確かに、mongodb-database-toolsのバージョンと同じです。
以上、mongodumpのインストールについて説明しました。
最後に、mongodumpによるバックアップを行います。
mongodumpによるバックアップ
mongodumpの公式ページ
https://docs.mongodb.com/database-tools/mongodump/
詳細は、上記ページを参考にしてください。
基本の使い方は、以下。
mongodump <options> <connection-string>
以下では、これさえ覚えれば何とかなるというコマンドを載せています。
全データベースのバックアップ
mongodump --host="localhost" --port=27017
「localhost」は、「192.168.11.1」などのIPアドレスでもOK。
指定したデータベースのみのバックアップ
mongodump --host="localhost" --port=27017 --db="test_database"
指定したコレクションのみのバックアップ
mongodump --host="localhost" --port=27017 --db="test_database" --collection="test_collection"
まとめ
とりあえず、上記のパターンでバックアップできれば問題ないでしょう。
実際にバックアップすると、同一ディレクトリ上に「dump」ディレクトリが作成されます。
「–out」オプションで指定すれば、バックアップファイルの保存先を指定できます。
「dump」以下のファイル・フォルダ構成は、次のようになります。
$ tree dump/
dump/
├── admin
│ ├── system.version.bson
│ └── system.version.metadata.json
└── test_database
├── test_collection.bson
└── test_collection.metadata.json
データベース名でディレクトリが作成されます。
そして、それらのディレクトリにコレクション名でファイルが作成されます。
bsonとmetadata.jsonでセットとなります。
以上、mongodumpによるバックアップについての説明でした。
