AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。

サーバーサイド JavaScript

重要

MongoDB 5.0 以降では map-Reduce は非推奨となります。

MongoDB には、JavaScript コードのサーバー側実行を実行する次の演算子が用意されています。

  • $where ドキュメントをクエリするために JavaScript 式または関数を評価する 演算子 。

  • $accumulatorと$functionの集計操作を使用し、ユーザーがカスタム集計式を定義できるようにします。

JavaScript( .js )ファイルをmongoshに指定すると、サーバー上でファイルを実行できます。 これは、バッチ管理作業を実行するのに適した手法です。 サーバー上でローカルホスト インターフェース経由で接続するmongoshを実行すると、接続は高速で低レイテンシになります。

mongod または mongos の JavaScript のサーバー側実行をすべて無効にするには、次のいずれかの操作を行います。

サーバー側のメソッドは JavaScript を使用しますが、MongoDB と交流する際は、ほとんどの場合 JavaScript は使用されず、交流するアプリケーションの言語で独自のドライバーが使用されます。

同時実行情報については、個々のメソッドまたは演算子のドキュメントを参照してください。 同時実行テーブルも参照してください。

MongoDB 6.0では、サーバーサイド JavaScript 、 $accumulator 、 $function 、 $where式に使用される内部 JavaScript エンジンが MozJS- 60から MozJS- 91にアップグレードされています。 MozJS- 60に存在した非推奨、非標準の配列関数と string 関数は、MozJS- 91で一部削除されました。

MongoDB 9.0 以降、サーバーサイド JavaScript は ppc64le アーキテクチャでは使用できません。ppc64le 用の mongod および mongos バイナリには、JavaScript エンジンは含まれていません。その結果、$where、$accumulator、$function、およびmap-reduce操作はそのアーキテクチャでは失敗します。ppc64leでサーバー側のJavaScriptを有効にするには、構成ファイルの設定やコマンドラインオプションを使用することはできません。

これらの操作を実行するには、JavaScriptエンジンを含むアーキテクチャ上の配置を使用します。サーバー側のJavaScriptを必要としない集計パイプラインステージと演算子を使用するように操作を書き換えることもできます。

MongoDB 9.0 以降、サーバー側の JavaScript は、mongod ホストのタイムゾーンに関係なく、ローカルの Date 操作を UTC で評価します。Date.prototype.getHours() などのローカルゲッター、ローカルコンストラクターとセッター、および日付を string に変換する操作はすべて UTC を使用します。保存 された BSON 日付値は変更されません。Date.prototype.getTime()、Date.prototype.toISOString()、および getUTC*() メソッドも同様です。

名前付きゾーンの日付を評価するには、$hour などの集計日付演算子を明示的な timezone 引数とともに使用します。JavaScript のローカル Date メソッドは避けてください。アップグレードのガイダンスについては、「MongoDB 9.0 の互換性の変更」を参照してください。

SELinux を使用している場合、サーバー側の JavaScript を必要とする MongoDB 操作ではセグメント違反エラーが発生します。サーバー側の JavaScript の実行を無効にするには、「サーバー側の JavaScript を無効にする」を参照してください。