MongoDB 3.4 Release Notes 翻訳

Release Notes for MongoDB 3.4の翻訳です。原文はMongoDB Documentation Teamによるものです。ライセンスはCC BY-NC-SA 3.0となっています。

CONTRIBUTING.rst

MongoDB documentation is distributed under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported license.

脚注は、リリースノート以外の3.4のマニュアルも参考にして今回付け加えたものです。

---

MongoDB 3.4 リリースノート

MongoDB 3.4が2016年11月29日にリリースされました。
主要な機能としては、linearizable read concern、view、collationが含まれます。

OpsManager 3.4も入手可能です。詳細はOps Managerのドキュメント、およびリリースノートを参照してください。

シャードクラスタ

Membership Awareness

3.4から、シャードクラスタのコンポーネント（シャード、configサーバ、mongos）はシャードクラスタ内に所属していること、シャードクラスタ名、configサーバの場所を認識するようになりました。

このMembership Awarenessのために、2つの変更がなされています。

• shardsvr指定の必須化
  
  バージョン3.4のシャードクラスタでは、シャード用のmongodインスタンスは役割をshardsvrとして明確に指定しなければなりません。指定方法は、設定ファイル中のsharding.clusterRole、コマンドラインオプションの--shardsvrのいずれでも構いません。
  
  注意：
  
  shardsvrとして指定されたmongodインスタンスのデフォルトポートは27018となります。異なるポートを使うには、net.portの設定か、--portコマンドラインオプションを指定してください。
• 3.4のmongosは以前のバージョンのmongodと非互換
  
  バージョン3.4のmongosインスタンスは以前のバージョンのmongodに接続することはできません。

Balancerプロセスがconfigサーバのプライマリノード上に

balancerプロセスは、従来のmongosノード上から、configサーバレプリカセットのプライマリノード上に移動されました。これに伴い以下の点も変わっています。

• CSRS型のconfigサーバのプライマリノードは"balancer"ロックを保持します。この"balancer"ロックは、"ConfigServer"に指定されたプロセスのプロセスIDを使っており、解放されることはありません。
• MongoDB3.4では以下のコマンド、メソッド群が追加されています。
  • balancerStartコマンドおよび、このコマンドをラップしたmongo shellのsh.startBalancer()メソッド。3.2およびそれ以前のmongo shellメソッドsh.startBalancer()は、3.4のシャードクラスタとは非互換です。
  • balancerStopコマンドおよび、このコマンドをラップしたmongo shellのsh.stopBalancer()メソッド。3.2およびそれ以前のmongo shellメソッドsh.stopBalancer()は、3.4のシャードクラスタとは非互換です。
  • balancerStatusコマンド。
• 3.4では、mongo shellのsh.getBalancerHost()メソッドはdeprecated扱いとなりました。3.2およびそれ以前のmongo shellのsh.getBalancerHost()メソッドは、3.4のシャードクラスタとは非互換です。
• 3.4では、mongosの以下の設定オプションは削除されました。
  • sharding.chunkSize 設定ファイルでの指定、および、コマンドラインでの--chunkSizeの両方。
  • sharding.autoSplit 設定ファイルでの指定、および、コマンドラインでの--noAutoSplitの両方。

高速なバランシング

MongoDB 3.4から、以下のように変更されています。

• WiredTigerでは、すべてのチャンクマイグレーションに対して、secondaryThrottleのデフォルト値はfalseです。balancerプロセスはセカンダリへのレプリケーションを待つことはなく、次のドキュメントの処理を継続します。
• MongoDBはチャンクマイグレーションを並行処理できるようになりました。以前のバージョンと似たように、ある1つのシャードはある時点において最大1つまでのマイグレーションに参加可能です。この制約を考えると、n個のシャードからなるシャードクラスタでは、同時に、最大でn/2個（小数点以下切り捨て）のチャンクマイグレーションを実行可能ということになります。

SCCC型configサーバ構成の非サポート化

3.4のシャードクラスタは、configサーバとしてSCCC型のmongodインスタンスはサポートしません。SCCC型のconfigサーバは3.2リリースでdeprecated扱いとなっていました。代わりに、レプリカセットとしてconfigサーバを構築してください。（CSRS型）

シャードクラスタを3.4にアップグレードするには、configサーバがレプリカセットとして動作している必要があります。

既存のconfigサーバをSCCC型からCSRS型に変換する方法は、Upgrade Config Servers to Replica Setを参照してください。

Sharding Zones

MongoDB 3.4ではZoneの概念が導入されました。これは以前のバージョンでのtag-awareシャーディングを置き換えるものです。

Zoneをサポートするために、以下のコマンドとmongo shellのメソッドが追加されました。

Commands	mongo Shell Methods
addShardToZone	sh.addShardToZone()
removeShardFromZone	sh.removeShardFromZone()
updateZoneKeyRange	sh.updateZoneKeyRange() sh.removeRangeFromZone()

レプリカセット

majority write concernを指定した場合のジャーナリングのデフォルトの挙動

新しい設定項目 writeConcernMajorityJournalDefault により、write concernのwオプションに"majority"を指定していて、jオプションは省略している場合の、ジャーナリングのデフォルトの挙動を変えられるようになりました。
writeConcernMajorityJournalDefaultをtrueにすると、これらの書き込みリクエストに対し、過半数のメンバーが書き込みをディスク上のジャーナルに反映した後に応答を返すようになります¹。falseに設定すると、過半数のメンバーがメモリまで反映した段階で応答を返します。

新しく選出されたプライマリのキャッチアップ期間が調整可能に

新しい設定項目 settings.catchUpTimeoutMillis により、新しく選出されたプライマリが、他のレプリカセットメンバーから最新の書き込みを受け取って追いつき反映するまでのタイムアウト時間を設定できるようになりました²。

Linearizable Read Concern

MongoDB 3.4では"linearizable"というread concernレベルが導入されました。"linearizable"は、"majority"を指定されていて、かつ、read処理の開始よりも前に応答が返された、全ての正常なwrite処理を反映した結果を読むためのものです³。linearizable read concernによる保証は、read処理において単一のドキュメントを一意に特定するようなクエリフィルタが指定されている場合のみ受けることができます。

linearizable read concernは、全てのMongoDB ストレージエンジンにおいて利用可能です。

"majority" write concernと"linearizable" read concernを組み合わせると、複数スレッドが単一ドキュメントに対して読み書きをするときに、あたかもシングルスレッドであるかのように動作させることができます。つまり、これらの読み書き処理が実行されるスケジュールは、直線化可能と見なせるということです。

linearizable read concernが指定された読み込みは、majorityやlocalのread concernが指定された場合に比べて、非常に遅くなる可能性があります。linearizable read concernを使う場合は常にmaxTimeMSをともに指定し、過半数のメンバーが障害となっている場合に備えるべきです。例を以下に示します。

db.restaurants.find( { _id: 5 } ).readConcern("linearizable").maxTimeMS(10000)

db.runCommand( {
     find: "restaurants",
     filter: { _id: 5 },
     readConcern: { level: "linearizable" },
     maxTimeMS: 10000
} )

read concernについての詳細、read concernをサポートするコマンド等については、Read Concernを参照してください。

初期同期の改善

• MongoDB 3.4では、ドキュメントがコピーされたときにインデックスもビルドすることで、初期同期の性能が改善されています。
• MongoDB 3.4では、初期同期のリトライロジックが改善され、一時的なネットワーク障害があった場合でも最終的には同期できるようになりました。
• rs.status()の出力が変更され、初期同期のステータスや進捗状況が表示されるようになりました。

Decimal型

3.4では、decimal128フォーマットのdecimalデータ型がサポートされます。decimal128フォーマットは、34桁までの仮数および-6143から+6144までの指数の範囲をサポートします。

このフォーマットをサポートするため、mongo shellにNumberDecimalラッパーが追加されました。

db.inventory.insert( {_id: 1, item: "The Scream", price: NumberDecimal("9.99"), quantity: 4 } )

異なる数値型の間で比較を行うときには、共通の型に変換することなく、格納されているまさにその値を使って比較します。

近似値を格納しているにすぎないdouble型とは異なり、decimal型は正確な値を格納しています。たとえば、NumberDecimal("9.99")は正確に9.99ですが、double型の9.99は近似値として9.9900000000000002131628...のような値を格納しています。

decimal型を条件として指定するには、$type演算子と"decimal"、もしくは19⁴を指定してください。

db.inventory.find( { price: { $type: "decimal" } } )

decimal型をMongoDBのドライバーから使うには、decimal型をサポートしたバージョンのドライバーにアップグレードすることが必要です。

Aggregation

再帰的な検索のためのAggregationステージ

3.4ではAggregationパイプラインに再帰的な検索が可能となるようなステージが導入されました。

Stage	Description
$graphLookup	コレクションに対して再帰的に検索を行います。結果として出力される各ドキュメントに対し、そのドキュメントを再帰的に検索したトラバーサル結果の配列フィールドが付加されます。

複合検索のためのAggregationステージ

複合検索によりドキュメントをカテゴリごとに分類することを可能にします。たとえば、在庫を表すドキュメントのコレクションがあって、値段の範囲などある単一のカテゴリ、または、値段の範囲と部門など複数のカテゴリにしたがって分類したいと思うかも知れません。

3.4では、aggregationパイプラインに複合検索が可能となるようなステージが導入されました。

Stage	Description
$bucket	入力されたドキュメントを、ある範囲ごとのbucketに分類します。
$bucketAuto	入力されたドキュメントを、指定された数のある範囲ごとのbucketに分類します。bucketの境界はMongoDBが自動的に決定します。
$facet	入力されたドキュメントに対して複数のパイプライン処理を行い、これらのパイプラインの結果を含んだドキュメントを出力します。これらのパイプラインに $bucket、$bucketAuto、$sortByCount など複合検索に関わるステージを指定することで、$facet は複合検索を可能にします。
$sortByCount	入力されたドキュメントを、指定の式により数をカウントしてグループに分類します。出力ドキュメントはグループごとの数の降順に並べられます。

ドキュメントの整形を容易にするためのAggregationステージ

3.4ではaggregationパイプラインにドキュメントを置き換えたり、新しいフィールドを追加したりするのを、容易に実現するための新しいステージが導入されました。

Stage	Description
$addFields	ドキュメントにフィールドを追加します。このステージは、入力ドキュメントに含まれていた全てのフィールドと、追加されたフィールドの両方を含んだドキュメントを出力することになります。
$replaceRoot	指定された内容でドキュメントを置き換えます。入力ドキュメントの中の埋め込みドキュメントも指定することができ、そうすると埋め込みドキュメントをトップレベルに昇格させることが出来ます。

カウントのためのAggregationステージ

3.4では、ドキュメントをカウントするための新しいステージがaggregationパイプラインに導入されました。

Operator	Description
$count	そのステージに入力されたドキュメント数を含むドキュメントを返します。

Aggregationでの配列演算子

Stage	Description
$in	指定された値が配列に含まれているかどうか示すbooleanを返す。
$indexOfArray	配列の中に指定された値が含まれるかどうか検索し、最初に見つかった要素のインデックスを返します。インデックスは0ベースです。
$range	指定範囲の連続した数値からなる配列を返します。
$reverseArray	入力された配列を逆順にして返します。
$reduce	配列を入力として受け取り、各要素に対して処理を行い、結果を返します。
$zip	複数の配列を入力として受け取り、各入力配列の1番目の要素を並べた配列を1番目の要素、各入力配列の2番目の要素を並べた配列を2番目の要素・・・とした配列を返します。

AggregationでのString演算子

Operator	Description
$indexOfBytes	文字列の中に指定された部分文字列が含まれるかどうか検索し、最初に見つかったUTF-8のバイト単位のインデックスを返します。インデックスは0ベースです。
$indexOfCP	文字列の中に指定された部分文字列が含まれるかどうか検索し、最初に見つかったUTF-8のコードポイント単位のインデックスを返します。インデックスは0ベースです。
$split	文字列を指定のデリミタで分割し、分割後の文字列の要素を含む配列を返します。
$strLenBytes	指定された文字列の長さをUTF-8のバイトの長さで返します。
$strLenCP	指定された文字列の長さをUTF-8のコードポイントの長さで返します。
$substrBytes	文字列の中の部分文字列を返します。返される部分文字列は、第2引数indexで始まり、第3引数countの長さを持ちます。インデックスは0ベースで、UTF-8のバイト単位です。
$substrCP	文字列の中の部分文字列を返します。返される部分文字列は、第2引数indexで始まり、第3引数countの長さを持ちます。インデックスは0ベースで、UTF-8のコードポイント単位です。

Aggregationでのフロー制御式

Operator	Description
$switch	指定されたcase式を順に評価し、はじめにtrueとなったブランチにしたがって処理を継続します。

日付処理に関するAggregation演算子

Operator	Description
$isoDayOfWeek	ISO 8601にもとづいて週の日を表現する数値を返します。月曜日が1、日曜日が7となります。
$isoWeek	ISO 8601にもとづいて週を表現する1から53までの数値を返します。1年の最初の月曜日から日曜日までそろった週が、番号1となります。
$isoWeekYear	ISO 8601にもとづいて年の週を表現する数値を返します。1年は、番号1の週の月曜日から始まり、最終週の日曜日で終わることになります。

Aggregation元に対する統計監視

Operator	Description
$collStats	コレクションまたはビューに関する統計情報を返します。

型判別演算子

Operator	Description
$type	引数のBSON型を表す文字列を返します。

追加的な変更点

$project ステージは、出力ドキュメントで特定のフィールドの除外できるようになりました。以前は、_idフィールドのみ除外可能でした。フィールドの除外を指定するときは、

• 出力ドキュメントには、それ以外の全てのフィールドが含まれた形で返却されます。
• 新しいフィールドを指定したり、他のフィールドを含めるように指定することはできません。

Collation（照合順序）およびCase-Insensitiveインデックス

言語に特有のルールにもとづいて文字列の比較が行えるようにするため、MongoDB 3.4ではクエリおよびインデックスに対してcollation（照合順序）が導入されました。

以下のコマンドとメソッドがcollation（照合順序）をサポートしています。

Commands	mongo Shell Methods
create	db.createCollection() db.createView()
createIndexes	db.collection.createIndex()
create	db.createCollection() db.createView()
aggregate	db.collection.aggregate()
distinct	db.collection.distinct()
findAndModify	db.collection.findAndModify() db.collection.findOneAndDelete() db.collection.findOneAndReplace() db.collection.findOneAndUpdate()
find	db.collection.find()でのcollationを設定するためにはcursor.collation()を使います。
mapReduce	db.collection.mapReduce()
delete	db.collection.deleteOne() db.collection.deleteMany() db.collection.remove()
update	db.collection.update() db.collection.updateOne() db.collection.updateMany() db.collection.replaceOne()
shardCollection	sh.shardCollection()
	db.collection.bulkWrite()の中の個別のupdate、replace、deleteに対しても指定可能です。

詳細は、Collationを参照してください。

ビュー

MongoDB 3.4では、既存のコレクション（または他のビュー）をもとに、ビューを作成することができるようになりました。ビューは読み込み専用となります。ビューを定義するためにMongoDB 3.4では以下の機能が導入されています。

• 既存のcreateコマンドに対する、viewOnおよびpipelineオプションの追加

db.runCommand( { create: <view>, viewOn: <source>, pipeline: <pipeline> } )

ビューに対してデフォルトのcollation（照合順序）も指定する場合は

db.runCommand( { create: <view>, viewOn: <source>, pipeline: <pipeline>, collation: <collation> } )

• そしてそれに紐付く、mongo shellのdb.createView()メソッド

db.createView(<view>, <source>, <pipeline>, <collation>)

ビューの作成に関する詳細はRead-only Viewsを参照してください。

セキュリティの強化

クラスタ内部認証を有効化する場合の移行支援機能

MongoDB 3.4では、レプリカセットやシャードクラスタにおいて、無停止でクラスタ内部認証を有効化するための移行支援機能が追加されました。詳細については、security.transitionToAuthの設定、またはmongodやmongosの--transitionToAuthコマンドラインオプションの説明を参照してください。

参照：
Enforce Keyfile Access Control in a Replica Set without Downtime

MongoDBツール群

mongoreplay

mongoreplayというツールが導入されました。mongoreplayは、作業手順をキャプチャして解析するツールで、mongosniffを置き換えるものです。mongoreplayを使うことで、MongoDBインスタンスに送られたコマンドを調査したり記録したりすることができ、さらに、後で他のホストでコマンドをリプレイすることもできます。

一般的な改善

MongoDB 3.4では以下のような改善が含まれています。

• systemdのサポートが追加されました。

• diagnosticDataCollectionDirectorySizeMBのデフォルト値が100MBから200MBに増やされました。

• WiredTigerのキャッシュサイズの下限およびデフォルト値が下げられました。WiredTigerのキャッシュサイズ、および、インメモリストレージエンジンの最大メモリサイズに、浮動小数を指定できるようになりました。

• find()、aggregate()、listIndexes、listCollectionsが返すbatchあたりの最大サイズは16MBになりました。

• db.currentOp()とデータベースプロファイラは、すべてのCRUDオペレーションに対して、下記の情報を含む、同様の基礎的な診断情報を報告します。
  

• aggregate

• count

• delete

• distinct

• find (OP_QUERY および command)

• findAndModify

• geoNear

• getMore (OP_GET_MORE および command)

• group

• insert

• mapReduce

• update

これらのオペレーションはスロークエリログにも含まれます。スロークエリログの詳細はslowOpThresholdMsを参照してください。

• BSONのjavascript型およびjavascriptwithscope型の要素を、JavaScriptのファンクションとして実行する機能の有効/無効を切り替える機能がmongoシェルに追加されました。--disableJavaScriptProtectionを参照してください。
• システム証明書のサポートが追加されました。mongodインスタンスが、オペレーティングシステムによって信頼済みのCAによって署名された証明書を提示した場合、mongoシェルはエラー無しで接続します。以前は、mongoシェルは証明書を検証できないというエラーを出力してexitしていました。

プラットフォーム サポート

• MongoDB 3.4では、ARM64、PPC64LE、s390xアーキテクチャーがサポート対象に追加されました。完全なプラットフォーム サポートの一覧はSupported Platformsを参照してください。
• 警告：
  
  3.4のIBM Power Systems上のUbuntu 16.04 での非互換
  
  glibcでのロックの脱落のバグのため、IBM Power Systems上のUbuntu 16.04を使っている場合、glibcの修正バージョンが出るまでは、MongoDB 3.4をプロダクションで使うべきではありません。

MongoDB Enterprise版の機能

ログの編集（マスキング）

MongoDB 3.4 Enterpriseでは、ログの編集機能が追加されました。これは暗号化ストレージエンジンとともに使うためのものです。ログの編集機能は潜在的に機密性の高い情報が診断ログに出力されてしまうのを防ぐものです。ただし、編集済みのログを使った診断は、イベントに関する情報が欠落している可能性があるため、困難になる可能性があります。

ログの編集機能を有効にするには、security.redactClientLogDataの設定、および、mongodの--redactClientLogDataオプションを参照してください。

LDAPの改善

LDAPによる認可

MongoDB 3.4 Enterpriseでは、以下のいずれかの機構により認証されたユーザに対して、Lightweight Directory Access Protocol （LDAP） を使って認可（つまりアクセス許可）を行うことができるようになりました。

• LDAP Proxy認証。LDAP認証と認可の両方を使うチュートリアルは、Authenticate and Authorize Users Using Active Directory via Native LDAPを参照してください。
• Kerberos認証。Kerberos認証とActive Directoryを使うチュートリアルは、Configure MongoDB with Kerberos Authentication and Active Directory Authorizationを参照してください。
• x.509

詳細は、LDAP Authorizationを参照してください。

mongoldap

MongoDB 3.4 Enterpriseでは、mongoldapという新しいツールが提供されます。これはMongoDBのLDAP関連の設定を、稼働しているLDAPサーバ群に対してテストするためのものです。LDAP認証に関する設定をするときには、mongoldapを使って、意図通りに設定できているか確認することができます。

OSのライブラリを使ったバインド

MongoDB 3.4 Enterpriseでは、オペレーティングシステムのライブラリを使ったLDAPサーバーとのバインドがサポートされました。これによりLinuxおよびWindowsにおいてMongoDB 3.4はLDAPサーバーを認証のために使うことができるようになりました。

Linux環境では、引き続きsaslauthdを使ったバインドもサポートされます。

互換性への影響

いくつかの変更点は互換性に影響する可能性があり、ユーザーの対応が必要になるかもしれません。詳細な一覧はMongoDB 3.4での互換性の変更点を参照してください。

アップグレードの手順

• スタンドアロン構成のサーバを3.4にアップグレードする
• レプリカセットを3.4にアップグレードする
• シャードクラスタを3.4にアップグレードする

3.4へのアップグレードで支援が必要な場合は、MongoDB社はメジャーバージョンアップグレードサービスを提供しています。これは、あなたのアプリケーションを停止させることなく円滑な移行ができるように支援するものです。

3.4.0での既知のバグ

3.4.0での既知のバグは以下のものがあります。

• SERVER-27124 : protocolVersion: 0 が"majority" read concernを適切にサポートできていない。
• SERVER-27195 : BSONのSymbol型を含んでいるドキュメントでのcollationの使用はサポートされておらず、未定義の動作となる。Symbol型はdeprecated。
• SERVER-27207 : mongos経由のアクセスで、viewに対して、sort付きでfindすると、不正に空の結果が返却されることがある。

---

1. writeConcernMajorityJournalDefaultをtrueにするときは、レプリカセット中の全メンバーでジャーナリングを有効にする必要があります。writeConcernMajorityJournalDefault ↩

2. キャッチアップ期間中は、新プライマリは書き込みを受け付けません。この期間中に新プライマリに反映できなかった書き込みは、他メンバー（セカンダリ）側でロールバックとなります。settings.catchUpTimeoutMillis ↩

3. writeConcernMajorityJournalDefaultをtrueにしている環境では、linearizable read concern指定の読み込みは、ロールバックされないデータを返却することが保証されます。一方、writeConcernMajorityJournalDefaultをfalseにしている場合は、wオプションにmajorityを指定した書き込みであってもMongoDBはそれが永続化されるのを待たずに応答を返すため、障害発生時にはロールバックされる可能性があります。また、linearizable read concernを指定できるのは、プライマリに対する読み込みのみです。linearizable ↩

4. 19はdecimal型を意味する定数。Available Types ↩