MongoDBのソースを表示

[[Category:データベース管理システム]]
[[en:MongoDB]]
[[zh-hans:MongoDB]]
MongoDB (由来は hu'''mongo'''us から) はオープンソースのドキュメント指向データベースです。[http://www.mongodb.com/ MongoDB Inc. (旧 10gen)] によって開発・サポートされています。MongoDB はデータベースシステムの NoSQL ファミリーの一員です。"古典的"なリレーショナルデータベースでそうあるように、データをテーブルに保存する代わりに、MongoDB は動的なスキーマ (MongoDB では [http://bsonspec.org/ BSON] と呼称されるフォーマット) によって JSON ライクなドキュメントとして構造的データを保存して、特定のタイプのアプリケーションでデータを簡単かつ高速に扱えるようにします。

== インストール ==

MongoDB は再ライセンス上の問題により[[公式リポジトリ]]から削除されました [https://lists.archlinux.org/pipermail/arch-dev-public/2019-January/029430.html]。

[[PKGBUILD]] が [[AUR]] で提供されています:

*{{AUR|mongodb}} - ソースコードからビルドします。180GB 以上のディスク空き領域が必要で、おそらくビルドに数時間かかります。(例: Intel i7 で6.5時間、ハイエンドの NVMe と 32 Xeon cores で1時間。)
*{{AUR|mongodb-bin}} - ビルド済みの MongoDB バイナリを[https://repo.mongodb.org/apt/ubuntu/ 公式 MongoDB Ubuntu リポジトリ]から抽出します。ビルドに使用されたコンパイラオプションは不明です。

選んだメインの [[PKGBUILD]] に対応する、[[AUR]] にある [[PKGBUILD]] を使ってツール({{ic|mongoimport}}、{{ic|mongoexport}}、{{ic|mongodump}}、{{ic|mongorestore}} など) を[[インストール]]してください:

* {{AUR|mongodb-tools}}
* {{AUR|mongodb-tools-bin}}
* {{AUR|mongosh-bin}}

== 使用方法 ==

{{ic|mongodb.service}} デーモンを[[systemd#ユニットを使う|起動・有効化]]します。

{{Note|mongodb サービスは初回起動時に大きいファイルを作成することにより[https://docs.mongodb.com/manual/faq/storage/#preallocated-data-files 領域を事前に確保します](ジャーナルや他のデータ用)。この処理には時間が掛かり、その間、MongoDB シェルは使用不能となります。}}

データベースシェルにアクセスするには、ターミナルに以下を入力:

 $ mongo

または、認証設定がなされている場合:

 $ mongo -u ''userName''

== Configuration ==

=== ファイルのフォーマット ===

MongoDB は 設定ファイルに YAML ベースのフォーマットを使用します。利用可能な設定オプションについては https://docs.mongodb.com/manual/reference/configuration-options/ を見てください。

{{hc|/etc/mongodb.conf|2=
systemLog:
   destination: file
   path: "/var/log/mongodb/mongod.log"
   logAppend: true
storage:
   journal:
      enabled: true
processManagement:
   fork: true
net:
   bindIp: 127.0.0.1
   port: 27017
setParameter:
   enableLocalhostAuthBypass: false
..
}}


=== 認証を要求する ===

{{warning|デフォルトでは MongoDB は認証を要求しません。MongoDB はデフォルトで localhost のインターフェイスのみをリッスンしますが、これでもローカルなユーザは認証せずに接続でき、データベースを晒すことになるかもしれません。望ましくないアクセスを防ぐためにアクセス制御を有効化することをおすすめします。}}

管理者のアクセス権を持つ MongoDB のユーザアカウントを作るには[https://docs.mongodb.com/manual/tutorial/enable-authentication/]:

{{hc|$ mongosh|
use admin
db.createUser(
  {
    user: "myUserAdmin",
    pwd: "abc123",
    roles: [ { role: "userAdminAnyDatabase", db: "admin" }, "readWriteAnyDatabase" ]
  }
)}}

以下を {{ic|/etc/mongodb.conf}} に[[追加]]してください:

{{hc|/etc/mongodb.conf|
security:
  authorization: "enabled"
}}

{{ic|mongodb.service}} を[[再起動]]してください。

=== NUMA ===

Running MongoDB with Non-Uniform Access Memory (NUMA) can significantly impact performance.  [https://docs.mongodb.com/manual/administration/production-notes/#mongodb-and-numa-hardware]

To see if your system uses NUMA:

 # dmesg | grep -i numa

Also, {{ic|/var/log/mongodb/mongod.log}} will show warnings if NUMA is in use and MongoDB is not started through {{ic|numactl}}.  (The {{ic|mongo}} shell will also show this, but only if you do not have authentication enabled.)

If your system uses NUMA, to improve performance, you should make MongoDB start through {{ic|numactl}}.

[[Edit]] {{ic|mongodb.service}} according to the package you installed.

If using {{aur|mongodb}}, change it from:

 ExecStart=/usr/bin/mongod $OPTIONS

To:

 ExecStart='''/usr/bin/numactl --interleave=all''' /usr/bin/mongod $OPTIONS

If using {{aur|mongodb-bin}}, change it from:

 ExecStart=/usr/bin/mongod --quiet --config /etc/mongodb.conf

To:

 ExecStart='''/usr/bin/numactl --interleave=all''' /usr/bin/mongod --quiet --config /etc/mongodb.conf

Zone claim also needs to be disabled, but on arch, {{ic|/proc/sys/vm/zone_reclaim_mode}} defaults to {{ic|0}}.

[[Reenable]] and [[Restart]] {{ic|mongodb.service}} as needed.

=== Clean Start and Stop ===

By default, [[systemd]] immediately kills anything after asking it to start or stop, if it has not finished doing so within 90 seconds.

{{aur|mongodb}} makes [[systemd]] wait as long as it takes for MongoDB to start, but {{aur|mongodb-bin}} does not.  Both packages allow [[systemd]] to kill MongoDB after it is asked to stop, if it has not finished within 90 seconds.

Large MongoDB databases can take a considerable amount of time to cleanly shut down, especially if swap is being used.  (An active 450GB database on a top of the line NVMe with 64GB RAM and 16GB swap can take an hour to shut down.)

By default, MongoDB uses journaling. [https://docs.mongodb.com/manual/reference/configuration-options/#storage-options]  With journaling, an unclean shutdown should not pose a risk of data loss.  But, if not shutdown cleanly, large MongoDB databases can take a considerable amount of time to start back up.  In this case, choosing whether to require a clean shutdown is a choice of a slower shutdown versus a slower startup. [https://groups.google.com/forum/?utm_medium=email&utm_source=footer#!msg/mongodb-user/KjBU_GcNcmw/gR2UxRIFAgAJ]

{{warning|If you disable journaling, failing to require a clean shutdown severely risks data loss, so you really need to require a clean shutdown. [https://docs.mongodb.com/manual/tutorial/recover-data-following-unexpected-shutdown/]}}

To prevent [[systemd]] from killing MongoDB after 90 seconds, [[edit]] {{ic|mongodb.service}}.

To allow MongoDB to cleanly shutdown, [[append]] to the {{ic|[Service]}} section: (On large databases, this may substantially slow down your system shutdown time, but speeds up your next MongoDB start time)

 TimeoutStopSec=infinity

If MongoDB needs a long time to start back up, it can be very problematic for [[systemd]] to keep killing and restarting it every 90 seconds [https://jira.mongodb.org/browse/SERVER-38086], so {{aur|mongodb}} prevents this.  If using {{aur|mongodb-bin}}, to make [[systemd]] wait as long as it takes for MongoDB to start, [[append]] to the {{ic|[Service]}} section:

 TimeoutStartSec=infinity

== トラブルシューティング ==

=== MongoDB が起動しない ===

データベースのパスが正しく設定されているか確認してください:

 $ cat /usr/lib/systemd/system/mongodb.service

"ExecStart" 行に "--dbpath /var/lib/mongodb" を追加してください:

 ExecStart=/usr/bin/numactl --interleave=all mongod --quiet --config /etc/mongodb.conf --dbpath /var/lib/mongodb

最低でも (ジャーナルファイル用の) 3GB の空き容量があることを確認してください。容量が足りない場合 MongoDB が起動できないことがあります (その場合ユーザーにメッセージは表示されません):

 $ df -h /var/lib/mongodb/

ロックファイルが存在しないかどうか確認:

 # ls -lisa /var/lib/mongodb

ロックファイルが存在する場合、{{ic|mongodb.service}} を停止してください。データベースのパスを指定してデータベースの修復を実行します (Arch Linux では {{ic|/var/lib/mongodb/}} がデフォルトの --dbpath です):

 # mongod --dbpath /var/lib/mongodb/ --repair

修復が完了すると、dbpath に修復されたデータファイルと空の mongod.lock ファイルが作られます。

{{Warning|ファイルを削除して、破損したファイルを使ってデータベースを起動して、データベースからデータの復旧を試みることもできます。ただし、データベースの状態を予想することはできません。詳しくは [https://docs.mongodb.com/manual/tutorial/recover-data-following-unexpected-shutdown/ 上流のドキュメント] を見てください。}}

root で修復を実行後、ファイルの所有者は root ユーザーになりますが、Arch Linux は別のユーザーで MongoDB を実行します。chown を使ってファイルの所有者を適切なユーザーに戻す必要があります (詳しくは [http://earlz.net/view/2011/03/11/0015/mongodb-and-arch-linux こちら] を参照):
 
 # chown -R mongodb: /var/{log,lib}/mongodb/

mongodb の [https://docs.mongodb.com/manual/reference/configuration-options/ ドキュメント] から設定ファイルをコピーした場合、以下の2行を削除して {{ic|mongodb.service}} を再起動してください:
{{hc|/etc/mongodb.conf|<nowiki>
processManagement:
   fork: true
</nowiki>}}

=== transparent_hugepage のカーネル設定について MongoDB がエラーを吐く ===

MongoDB の起動後、transparent_hugepage に関する警告が表示される場合、以下のファイルを編集することでシステム設定を永続的に無効化することができます ([https://www.freedesktop.org/software/systemd/man/tmpfiles.d.html FreeDesktop tmpfiles.d マニュアル] を参照):

{{hc|/etc/tmpfiles.d/local.conf|<nowiki>
w /sys/kernel/mm/transparent_hugepage/enabled - - - - never
w /sys/kernel/mm/transparent_hugepage/defrag - - - - never
</nowiki>}}

[[sysctl]] を使ったり以下のように echo コマンドを使うことで一時的に無効化することもできます:

 # echo never > /sys/kernel/mm/transparent_hugepage/enabled
 # echo never > /sys/kernel/mm/transparent_hugepage/defrag

=== Warning about Soft rlimits too low ===

If you are using systemd service, then edit the unit file by {{ic|systemctl edit mongodb.service}}:

 [Service]
 # Other directives omitted
 # (file size)
 LimitFSIZE=infinity
 # (cpu time)
 LimitCPU=infinity
 # (virtual memory size)
 LimitAS=infinity
 # (locked-in-memory size)
 LimitMEMLOCK=infinity
 # (open files)
 LimitNOFILE=64000
 # (processes/threads)
 LimitNPROC=64000

See following link for further details: [https://docs.mongodb.com/manual/reference/ulimit/#review-and-set-resource-limits Further reference]