Azure Cosmos DB for MongoDB (バージョン 3.6): サポートされる機能と構文

[アーティクル]
11/29/2022

適用対象: MongoDB

Azure Cosmos DB は、Microsoft のグローバルに分散されたマルチモデルデータベースサービスです。 Azure Cosmos DB for MongoDB との通信は、オープンソースで公開されている任意の MongoDB クライアントドライバーを使用して行うことができます。 Azure Cosmos DB for MongoDB では、MongoDB ワイヤープロトコルに従うことにより、既存のクライアントドライバーを利用できます。

Azure Cosmos DB for MongoDB を使用すれば、使い慣れた MongoDB API を活用できます。グローバル配信、自動シャーディング、可用性や待ち時間の保証、保存時の暗号化、バックアップを始めとする Azure Cosmos DB のエンタープライズ機能をすべて利用できます。

注意

バージョン 3.6 の Azure Cosmos DB for MongoDB には、現在、サポート終了 (EOL) の計画はありません。将来の EOL に関する通知は最低でも 3 年となります。

プロトコルのサポート

Azure Cosmos DB for MongoDB は、新しいアカウントでは、既定で MongoDB サーバーバージョン 3.6 と互換性があります。以下に、サポートされている演算子およびすべての制限事項や例外の一覧を示します。これらのプロトコルを認識するすべてのクライアントドライバーは、Azure Cosmos DB for MongoDB に接続できるはずです。 MongoDB 用 Azure Cosmos DB API アカウントを作成するとき、3.6 バージョンのアカウントのエンドポイントが *.mongo.cosmos.azure.com という形式であるのに対し、3.2 バージョンのアカウントのエンドポイントは *.documents.azure.com という形式です。

クエリ言語のサポート

Azure Cosmos DB for MongoDB では、MongoDB クエリ言語のコンストラクトが包括的にサポートされます。次のセクションでは、Azure Cosmos DB で現在サポートされているサーバー操作、演算子、ステージ、コマンド、およびオプションの詳細な一覧を示します。

Note

この記事では、サポートされているサーバーコマンドの一覧のみを示し、クライアント側のラッパー関数については除外しています。 deleteMany() や updateMany() などのクライアント側のラッパー関数は、内部では delete() や update() といったサーバーコマンドを利用しています。サポートされるサーバーコマンドを利用している関数は、Azure Cosmos DB for MongoDB と互換性があります。

データベースコマンド

Azure Cosmos DB for MongoDB では、次のデータベースコマンドがサポートされます。

クエリおよび書き込み操作コマンド

command	サポートされています
`change streams`	はい
`delete`	はい
`eval`	いいえ
`find`	はい
`findAndModify`	はい
`getLastError`	はい
`getMore`	はい
`getPrevError`	いいえ
`insert`	はい
`parallelCollectionScan`	いいえ
`resetError`	いいえ
`update`	はい

認証コマンド

command	サポートされています
`authenticate`	はい
`getnonce`	はい
`logout`	はい

管理コマンド

command	サポートされています
`cloneCollectionAsCapped`	いいえ
`collMod`	No
`connectionStatus`	No
`convertToCapped`	No
`copydb`	いいえ
`create`	はい
`createIndexes`	はい
`currentOp`	はい
`drop`	はい
`dropDatabase`	はい
`dropIndexes`	はい
`filemd5`	はい
`killCursors`	はい
`killOp`	いいえ
`listCollections`	はい
`listDatabases`	はい
`listIndexes`	はい
`reIndex`	はい
`renameCollection`	いいえ

診断コマンド

command	サポートされています
`buildInfo`	はい
`collStats`	はい
`connPoolStats`	いいえ
`connectionStatus`	No
`dataSize`	No
`dbHash`	いいえ
`dbStats`	はい
`explain`	はい
`features`	いいえ
`hostInfo`	はい
`listDatabases`	はい
`listCommands`	いいえ
`profiler`	No
`serverStatus`	No
`top`	いいえ
`whatsmyuri`	はい

集計パイプライン

集計コマンド

command	サポートされています
`aggregate`	はい
`count`	はい
`distinct`	はい
`mapReduce`	いいえ

集計ステージ

command	サポートされています
`addFields`	はい
`bucket`	いいえ
`bucketAuto`	いいえ
`changeStream`	はい
`collStats`	いいえ
`count`	はい
`currentOp`	いいえ
`facet`	はい
`geoNear`	はい
`graphLookup`	はい
`group`	はい
`indexStats`	いいえ
`limit`	はい
`listLocalSessions`	いいえ
`listSessions`	いいえ
`lookup`	Partial
`match`	はい
`out`	はい
`project`	はい
`redact`	はい
`replaceRoot`	はい
`replaceWith`	いいえ
`sample`	はい
`skip`	はい
`sort`	はい
`sortByCount`	はい
`unwind`	はい

注意

$lookup では、サーバーバージョン3.6 で導入された非相関サブクエリ機能をまだサポートしていません。 let および pipeline フィールドで $lookup 演算子を使用しようとすると、let is not supported という文字列を含むメッセージが表示されエラーが発生します。

ブール式

command	サポートされています
`and`	はい
`not`	はい
`or`	はい

設定式

command	サポートされています
`setEquals`	はい
`setIntersection`	はい
`setUnion`	はい
`setDifference`	はい
`setIsSubset`	はい
`anyElementTrue`	はい
`allElementsTrue`	はい

比較式

注意

MongoDB 用 API では、クエリ内で配列リテラルを使用した比較式はサポートされていません。

command	サポートされています
`cmp`	はい
`eq`	はい
`gt`	はい
`gte`	はい
`lt`	はい
`lte`	はい
`ne`	はい
`in`	はい
`nin`	はい

算術式

command	サポートされています
`abs`	はい
`add`	はい
`ceil`	はい
`divide`	はい
`exp`	はい
`floor`	はい
`ln`	はい
`log`	はい
`log10`	はい
`mod`	はい
`multiply`	はい
`pow`	はい
`sqrt`	はい
`subtract`	はい
`trunc`	はい

文字列式

command	サポートされています
`concat`	はい
`indexOfBytes`	はい
`indexOfCP`	はい
`split`	はい
`strLenBytes`	はい
`strLenCP`	はい
`strcasecmp`	はい
`substr`	はい
`substrBytes`	はい
`substrCP`	はい
`toLower`	はい
`toUpper`	はい

テキスト検索演算子

command	サポートされています
`meta`	いいえ

配列式

command	サポートされています
`arrayElemAt`	はい
`arrayToObject`	はい
`concatArrays`	はい
`filter`	はい
`indexOfArray`	はい
`isArray`	はい
`objectToArray`	はい
`range`	はい
`reverseArray`	はい
`reduce`	はい
`size`	はい
`slice`	はい
`zip`	はい
`in`	はい

変数演算子

command	サポートされています
`map`	はい
`let`	はい

システム変数

command	サポートされています
`$$CURRENT`	はい
`$$DESCEND`	はい
`$$KEEP`	はい
`$$PRUNE`	はい
`$$REMOVE`	はい
`$$ROOT`	はい

リテラル演算子

command	サポートされています
`literal`	はい

日付式

command	サポートされています
`dayOfYear`	はい
`dayOfMonth`	はい
`dayOfWeek`	はい
`year`	はい
`month`	はい
`week`	はい
`hour`	はい
`minute`	はい
`second`	はい
`millisecond`	はい
`dateToString`	はい
`isoDayOfWeek`	はい
`isoWeek`	はい
`dateFromParts`	はい
`dateToParts`	はい
`dateFromString`	はい
`isoWeekYear`	はい

条件式

command	サポートされています
`cond`	はい
`ifNull`	はい
`switch`	はい

データ型演算子

command	サポートされています
`type`	はい

アキュムレータ式

command	サポートされています
`sum`	はい
`avg`	はい
`first`	はい
`last`	はい
`max`	はい
`min`	はい
`push`	はい
`addToSet`	はい
`stdDevPop`	はい
`stdDevSamp`	はい

マージ演算子

command	サポートされています
`mergeObjects`	はい

データ型

command	サポートされています
`Double`	はい
`String`	はい
`Object`	はい
`Array`	はい
`Binary Data`	はい
`ObjectId`	はい
`Boolean`	はい
`Date`	はい
`Null`	はい
`32-bit Integer (int)`	はい
`Timestamp`	はい
`64-bit Integer (long)`	はい
`MinKey`	はい
`MaxKey`	はい
`Decimal128`	はい
`Regular Expression`	はい
`JavaScript`	はい
`JavaScript (with scope)`	はい
`Undefined`	はい

インデックスとそのプロパティ

インデックス

command	サポートされています
`Single Field Index`	はい
`Compound Index`	はい
`Multikey Index`	はい
`Text Index`	いいえ
`2dsphere`	はい
`2d Index`	いいえ
`Hashed Index`	はい

インデックスのプロパティ

command	サポートされています
`TTL`	はい
`Unique`	はい
`Partial`	いいえ
`Case Insensitive`	No
`Sparse`	いいえ
`Background`	はい

オペレーター

論理演算子

command	サポートされています
`or`	はい
`and`	はい
`not`	はい
`nor`	はい

要素演算子

command	サポートされています
`exists`	はい
`type`	はい

評価クエリ演算子

command	サポートされています
`expr`	はい
`jsonSchema`	いいえ
`mod`	はい
`regex`	はい
`text`	いいえ (サポートされていません。$regex を使用してください)
`where`	いいえ

$regex クエリでは、左固定の式でインデックス検索が可能です。ただし、'i' 修飾子 (大文字と小文字の区別なし) や 'm' 修飾子 (複数行) を使用すると、すべての式でコレクションスキャンが発生します。

$ または | を含める必要がある場合、2 つ (以上) の正規表現クエリを作成することをお勧めします。たとえば、元のクエリとして find({x:{$regex: /^abc$/}) がある場合、次のように変更する必要があります:

find({x:{$regex: /^abc/, x:{$regex:/^abc$/}})

最初の部分では、インデックスを使用して検索を ^abc で始まるドキュメントに制限し、2 番目の部分で入力そのものを照合します。バー演算子 | は "or" 関数として機能します。そのためクエリ find({x:{$regex: /^abc |^def/}) は、フィールド x の値が "abc" または "def" で始まるドキュメントに一致します。インデックスを利用するには、find( {$or : [{x: $regex: /^abc/}, {$regex: /^def/}] }) のように、クエリを 2 つの異なるクエリに分割し、$or 演算子で結合することをお勧めします。

配列演算子

command	サポートされています
`all`	はい
`elemMatch`	はい
`size`	はい

コメント演算子

command	サポートされています
`comment`	はい

射影演算子

command	サポートされています
`elemMatch`	はい
`meta`	いいえ
`slice`	はい

更新演算子

フィールド更新演算子

command	サポートされています
`inc`	はい
`mul`	はい
`rename`	はい
`setOnInsert`	はい
`set`	はい
`unset`	はい
`min`	はい
`max`	はい
`currentDate`	はい

配列更新演算子

command	サポートされています
`$`	はい
`$[]`	はい
`$[\<identifier\>]`	はい
`addToSet`	はい
`pop`	はい
`pullAll`	はい
`pull`	はい
`push`	はい
`pushAll`	はい

更新修飾子

command	サポートされています
`each`	はい
`slice`	はい
`sort`	はい
`position`	はい

ビット単位更新演算子

command	サポートされています
`bit`	はい
`bitsAllSet`	いいえ
`bitsAnySet`	No
`bitsAllClear`	No
`bitsAnyClear`	いいえ

地理空間演算子

演算子	サポートされています
`$geoWithin`	はい
`$geoIntersects`	はい
`$near`	はい
`$nearSphere`	はい
`$geometry`	はい
`$minDistance`	はい
`$maxDistance`	はい
`$center`	いいえ
`$centerSphere`	No
`$box`	No
`$polygon`	いいえ

並べ替え操作

findOneAndUpdate 操作を使用する場合、単一フィールドに対する並べ替え操作はサポートされていますが、複数フィールドに対する並べ替え操作はサポートされていません。

インデックス作成

MongoDB 用 API では、複数のフィールドでの並べ替えを有効にし、クエリのパフォーマンスを向上させ、一意性を適用するため、さまざまなインデックスがサポートされています。

GridFS

Azure Cosmos DB では、GridFS と互換性のある MongoDB ドライバーを通じて GridFS がサポートされています。

レプリケーション

Cosmos azure DB では、最下位のレイヤーで、自動のネイティブレプリケーションがサポートされています。このロジックは、低待機時間のグローバルなレプリケーションも実現するために拡張されています。 Azure Cosmos DB では、手動のレプリケーションコマンドはサポートされていません。

再試行可能書き込み

Azure Cosmos DB では、再試行可能書き込みはまだサポートされていません。クライアントのドライバーでは、接続文字列に retryWrites=false を追加する必要があります。

シャーディング

Azure Cosmos DB は、自動のサーバー側シャーディングをサポートしています。シャードの作成、配置、バランシングが自動的に管理されます。 Azure Cosmos DB では、手動のシャーディングコマンドはサポートされていません。つまり、addShard、balancerStart、moveChunk などのコマンドを呼び出す必要はありません。必要なのは、コンテナーの作成時やデータの照会時にシャードキーを指定することだけです。

セッション

Azure Cosmos DB では、サーバー側のセッションコマンドはまだサポートされていません。

Time-to-live (TTL)

Azure Cosmos DB では、ドキュメントのタイムスタンプに基づく Time-to-live (TTL) がサポートされます。コレクションに対して TTL を有効にするには、Azure portal を使用します。

ユーザーとロールの管理

Azure Cosmos DB では、ユーザーとロールはまだサポートされていません。ただし、Azure ロールベースアクセス制御 (Azure RBAC) と、Azure portal ([接続文字列] ペイン) から取得できる読み取り/書き込みおよび読み取り専用のパスワードまたはキーがサポートされています。

書き込み確認

一部のアプリケーションでは、書き込み操作中に必要な応答数を指定する書き込み確認が利用されています。 Azure Cosmos DB でレプリケーションが処理される方法のため、厳密な整合性を使用する場合、すべての書き込みが既定で自動的にマジョリティクォーラムになります。クライアントコードによって指定される書き込み確認はすべて無視されます。詳細については、整合性レベルを使用した可用性とパフォーマンスの最大化に関する記事を参照してください。

次のステップ

詳細については、Mongo 3.6 バージョンの機能を参照してください。
Azure Cosmos DB for MongoDB と共に Studio 3T を使用する方法を学習します。
Azure Cosmos DB for MongoDB と共に Robo 3T を使用する方法を学習します。
Azure Cosmos DB for MongoDB を使用した MongoDB のサンプルを確認します。