mongosh
メソッド
項目一覧
注意
MongoDB の JavaScript
これらのメソッドは JavaScript を使用しますが、MongoDB とのほとんどのやり取りでは JavaScript は使用されず、やり取りするアプリケーションの言語の慣用的なドライバーが使用されます。
注意
構文や例など、特定のメソッドの詳細については、「メソッドの参照ページ」へのリンクをクリックしてください。
Atlas Search インデックス メソッド
Atlas Search インデックスを使用すると、Atlas Search 内のデータをクエリできます。Atlas Search インデックスは、検索タームを含むドキュメントにタームをマッピングすることで、テキスト検索クエリの効率を高めます。
次の方法を使用して、Atlas Search インデックスを管理します。
重要
次のメソッドは、MongoDB Atlas でホストされている配置でのみ実行でき、少なくとも M10 の Atlas クラスター階層が必要です。
名前 | 説明 |
---|---|
指定されたコレクションに Atlas Search インデックスを作成します。 | |
既存の Atlas Search インデックスを削除します。 | |
指定されたコレクションの既存の Atlas Search インデックスに関する情報を返します。 | |
既存の Atlas Search インデックスをアップデートします。 |
Atlas Stream Processing メソッド
Atlas Stream プロセッサを使用すると、保存データで使用するのと同じデータ モデルとクエリ API を使用して、連続データのストリームに対して集計操作を実行できます。
ストリームプロセッサを管理するには、次のメソッドを使用します。
重要
以下のメソッドは、MongoDB Atlas でホストされている配置でのみ実行できます。
名前 | 説明 |
---|---|
ストリーム プロセッサを作成します。 | |
現在のストリーム プロセシング インスタンスの接続レジストリにある既存の接続をすべて一覧表示します。 | |
現在のストリーム プロセシング インスタンスに存在するすべてのストリーム プロセッサを一覧表示します。 | |
エフェメラル ストリーム プロセッサを作成します。 | |
既存のストリーム プロセッサを削除します。 | |
現在実行中のストリーム プロセッサからサンプル結果の配列を返します。 | |
既存のストリーム プロセッサを起動します。 | |
既存のストリーム プロセッサを要約する統計を返します。 | |
現在実行中のストリーム プロセッサを停止します。 |
コレクション
名前 | 説明 |
---|---|
シャードキーを評価するためのメトリクスを計算します。 | |
集計パイプラインへのアクセス権を提供します。 | |
一括書き込み操作機能を提供します。 | |
成功または失敗のオブジェクトを返すには、 compactStructuredEncryptionData をラップします。 | |
コレクションのクエリ サンプリングを構成します。 | |
コレクションまたはビュー内のドキュメントの数を返すには、 count をラップします。 | |
コレクションにインデックスを構築します。 | |
コレクションに 1 つ以上のインデックスを構築します。 | |
コレクション内の 1 つのドキュメントを削除します。 | |
コレクション内の複数のドキュメントを削除します。 | |
指定されたフィールドに対して異なる値を持つドキュメントの範囲を返します。 | |
指定したコレクションをデータベースから排除します。 | |
コレクションの指定されたインデックスを削除します。 | |
コレクションのすべてのインデックスを削除します。 | |
削除されました。 db.collection.createIndex() を使用してください。 | |
コレクションまたはビュー内のドキュメントのおおよその数を返すには、 count をラップします。 | |
さまざまなメソッドのクエリ実行についての情報を返します。 | |
コレクションまたはビューに対してクエリを実行し、カーソル オブジェクトを返します。 | |
アトミックに修正して 1 つのドキュメントを返します。 | |
クエリを実行し、1 つのドキュメントを返します。 | |
1 つのドキュメントを検索して削除します。 | |
1 つのドキュメントを検索して置き換えます。 | |
1 つのドキュメントを検索してアップデートします。 | |
コレクションの既存のインデックスを記述するドキュメントの配列を返します。 | |
シャーディングされたクラスター内のコレクションの場合、 db.collection.getShardDistribution() はチャンク分散のデータを報告します。 | |
シャーディングされたクラスターの内部診断方法。 | |
クエリ プランナーでインデックスを非表示にします。 | |
コレクションに新しいドキュメントを挿入します。 | |
コレクションに複数の新しいドキュメントを挿入します。 | |
コレクションが 上限付きコレクションかどうかを報告します。 | |
コレクションのレイテンシ統計を返します。 | |
map-reduce スタイルのデータ集計を実行します。 | |
コレクションのすべての既存のインデックスを再構築します。 | |
コレクションからドキュメントを削除します。 | |
コレクションの名前を変更します。 | |
コレクションの 1 つのドキュメントを置き換えます。 | |
コレクションの状態を報告します。 collStats を囲むラッパーを提供します。 | |
コレクションで使用される合計サイズをバイト単位で報告します。 collStats 出力の storageSize フィールドを囲むラッパーを提供します。 | |
コレクションのインデックスによって使用される合計サイズを報告します。 collStats 出力の totalIndexSize フィールドを囲むラッパーを提供します。 | |
コレクション内のすべてのドキュメントとすべてのインデックスのサイズを含む、コレクションの合計サイズを報告します。 | |
クエリ プランナーからインデックスを再表示します。 | |
コレクションの 1 つのドキュメントを変更します。 | |
コレクションの複数のドキュメントを変更します。 | |
コレクションに変更ストリームを確立します。 | |
コレクションに対して診断操作を実行します。 |
Cursor
名前 | 説明 |
---|---|
クエリの動作を変更する特別なワイヤプロトコル フラグを追加します。 | |
MongoDB ではブロッキング ソート操作の処理中にディスクの一時ファイルを使用して 100 メガバイトのシステム メモリ制限を超えるデータを保存できるようになります。 | |
シャーディングされたコレクションに対する db.collection.find() 操作では、クエリされたシャードが 1 つ以上利用できない場合に、エラーではなく部分的な結果を返すことができます。 | |
MongoDB が単一のネットワーク メッセージでクライアントに返すドキュメントの数を制御します。 | |
カーソルを閉じて、関連付けられているサーバー リソースを解放します。 | |
カーソルが閉じている場合は true を返します。 | |
db.collection.find() によって返されるカーソルの照合を指定します。 | |
ログおよび system.profile コレクションのトレーサビリティを確保できるように、クエリにコメントを付けます。 | |
カーソルがドキュメントそのものではなく、結果セット内のドキュメント数を返すように変更します。 | |
カーソルのクエリ実行プランについて報告します。 | |
カーソル内のすべてのドキュメントに JavaScript 関数を適用します。 | |
カーソルにドキュメントがあり、反復処理できる場合は true を返します。 | |
MongoDB がクエリに特定のインデックスを使用するように強制します。 | |
カーソルが閉じており、かつ、バッチにオブジェクトが残っていない場合は true を返します。 | |
結果セットを取得して反復処理することにより、クライアント側のカーソルにあるドキュメントの総数を計算します。 | |
カーソルの結果セットのサイズを制限します。 | |
カーソル内の各ドキュメントに関数を適用し、戻り値を配列に収集します。 | |
カーソルに対して限定的な上位インデックスの限界を指定します。使用用途 cursor.hint() | |
カーソルに対する情報処理操作の累積時間制限をミリ秒単位で指定します。 | |
カーソルに対して限定しない下位インデックスの限界を指定します。使用用途 cursor.hint() | |
カーソル内の次のドキュメントを返します。 | |
非アクティブな状態が一定期間続いた後、カーソルを自動的に閉じないようサーバーへ指示します。 | |
現在のカーソル バッチに残っているドキュメントの数を返します。 | |
結果を読みやすい形式で表示するようカーソルを設定します。 | |
find() 操作の読み取り保証(read concern)を指定します。 | |
カーソルに読み込み設定(read preference)を指定して、クライアントがレプリカセットにクエリを送信する方法を制御します。 | |
カーソルを変更して、ドキュメントではなくインデックス キーを返します。 | |
カーソルによって返される各ドキュメントに内部 storage engine ID フィールドを追加します。 | |
一定数のドキュメントを渡したりスキップした後にのみ結果を返し始めるカーソルを返します。 | |
ソート指定に従って順序付けられた結果を返します。 | |
カーソルを末尾可能としてマークします。上限付きコレクションのカーソルに対してのみ有効です。 | |
カーソルによって返されたすべてのドキュメントを含む配列を返します。 |
Database
名前 | 説明 |
---|---|
admin データベースに対してコマンドを実行します。 | |
基礎のコレクションを必要としない管理および診断パイプラインを実行します。 | |
データベースコマンドのヘルプ情報を返します。 | |
新しいコレクションまたはビューを作成します。一般的に、上限付きコレクションを作成するために使用されます。 | |
ビューを作成します。 | |
現在進行中の操作を報告します。 | |
現在のデータベースを削除します。 | |
データベースをロックして書き込み操作を防ぎ、バックアップ操作を支援するには、ディスクへの書き込みをフラッシュします。 fsync をラップします。 | |
db.fsyncLock() でロックされたデータベースへの書き込みを続行できるようにします。 | |
コレクションまたはビュー オブジェクトを返します。 mongosh で有効でない名前を持つコレクションへのアクセスに使用されます。 | |
現在のデータベース内のすべてのコレクションとビューのコレクション情報を返します。 | |
現在のデータベース内のすべてのコレクションとビューを一覧表示します。 | |
ログ メッセージの冗長レベルを返します。 | |
現在の接続の Mongo() 接続オブジェクトを返します。 | |
現在のデータベースの名前を返します。 | |
現在のプロファイリング レベルとプロファイリングしきい値を反映するドキュメントを返します。 | |
レプリケーション統計を含むドキュメントを返します。 | |
指定されたデータベースへのアクセス権を提供します。 | |
レプリカセットの状態を報告するドキュメントを返します。 | |
一般的な db オブジェクトのメソッドの説明を表示します。 | |
MongoDB が動作するシステムについての情報をドキュメントで返します。ラップ hostInfo | |
指定された操作を終了します。 | |
一般的なデータベースコマンドの一覧を表示します。 | |
非推奨。認証されたセッションを終了します。 | |
すべてのコレクションから統計を出力します。 db.collection.stats() をラップします。 | |
プライマリから見たレプリカセットの状態のレポートを出力します。 | |
セカンダリから見たレプリカセットの状態を出力します。 | |
シャーディングの構成とチャンクの範囲のレポートを出力します。 | |
MongoDB 5.0 で削除されました。最後のエラー ステータスをリセットします。 | |
オンライン TLS 証明書ローテーションを実行します。 rotateCertificates をラップします。 | |
データベースコマンドを実行します。 | |
MongoDB インスタンスの起動に使用されたランタイムについての情報をドキュメントで返します。 getCmdLineOpts をラップします。 | |
データベース プロセスの状態の概要を示すドキュメントを返します。 | |
1 つのログ メッセージの冗長レベルを設定します。 | |
データベース プロファイリングの現在のレベルを変更します。 | |
現在のデータベースの状態を報告するドキュメントを返します。 | |
mongod インスタンスのバージョンを返します。 | |
クエリプラン キャッシュ
名前 | 説明 |
---|---|
コレクションのクエリ プラン キャッシュ オブジェクトと関連する PlanCache メソッドにアクセスするためのインターフェースを返します。 | |
コレクションのすべてのキャッシュされたクエリプランをクリアします。特定のコレクションのプラン キャッシュ オブジェクト( db.collection.getPlanCache().clear() )を通じてアクセスできます。 | |
指定されたクエリシェイプのキャッシュされたクエリプランをクリアします。特定のコレクションのプラン キャッシュ オブジェクトを通じてアクセスできます。 db.collection.getPlanCache().clearPlansByQuery() | |
コレクションのクエリプラン キャッシュに使用できるメソッドを表示します。特定のコレクションのプラン キャッシュ オブジェクト( db.collection.getPlanCache().help() )を通じてアクセスできます。 | |
コレクションのプラン キャッシュ情報を返します。特定のコレクションのプラン キャッシュ オブジェクト( db.collection.getPlanCache().list() )を通じてアクセスできます。 |
一括書き込み操作
名前 | 説明 |
---|---|
順序付けられた操作リストの Bulk() 操作ビルダを初期化します。 | |
順序付けられていない操作リストの Bulk() 操作ビルダを初期化します。 | |
一括操作ビルダ。 | |
操作リストを一括で実行します。 | |
アップデート操作または削除操作のクエリ条件を指定します。 | |
update 操作または updateOne 操作で更新する配列の要素を決定するフィルターを指定します。 | |
クエリ条件の照合を指定します。 | |
複数のドキュメントの削除操作を操作リストに追加します。 | |
1 つのドキュメントの削除操作を操作リストに追加します。 | |
更新操作または置換操作に使用するインデックスを指定します。 | |
Bulk.find.delete() のエイリアス。 | |
Bulk.find.deleteOne() のエイリアス。 | |
1 つのドキュメントの置換操作を操作リストに追加します。 | |
1 つのドキュメントのアップデート操作を操作リストに追加します。 | |
multi のアップデート操作を操作リストに追加します。 | |
アップデート操作の upsert: true を指定します。 | |
Bulk() 操作オブジェクトで実行された書き込み操作の配列を返します。 | |
挿入オペレーションを操作リストに追加します。 | |
Bulk() 操作オブジェクト内の操作およびバッチの数を含む JSON document を返します。 | |
Bulk.toJSON() 結果を文字列として返します。 |
ユーザー管理
名前 | 説明 |
---|---|
データベースに対してユーザーを認証します。 | |
既存のユーザーのパスワードを変更します。 | |
新規ユーザーを作成します。 | |
ユーザーを 1 人削除します。 | |
データベースに関連付けられているすべてのユーザーを削除します。 | |
指定されたユーザーに関する情報を返します。 | |
データベースに関連付けられているすべてのユーザーに関する情報を返します。 | |
ロールとその権限をユーザーに付与します。 | |
非推奨。データベースからユーザーを削除します。 | |
ユーザーからロールを削除します。 | |
ユーザー データをアップデートします。 | |
mongosh のさまざまなユーザー認証および管理方法でパスワードを直接指定する代わりに、パスワードの入力を要求します。 |
ロール マネジメント
名前 | 説明 |
---|---|
ロールを作成し、その権限を指定します。 | |
ユーザー定義のロールを削除します。 | |
データベースに関連付けられているすべてのユーザー定義のロールを削除します。 | |
指定されたロールの情報を返します。 | |
データベース内のすべてのユーザー定義のロールに関する情報を返します。 | |
ユーザー定義のロールに権限を割り当てます。 | |
指定した権限をユーザー定義ロールから排除します。 | |
ユーザー定義ロールが権限を継承するロールを指定します。 | |
継承されたロールをロールから削除します。 | |
ユーザー定義ロールを更新します。 |
複製
名前 | 説明 |
---|---|
レプリカセットにノードを追加します。 | |
アービタをレプリカセットに追加します。 | |
レプリカセット構成ドキュメントを返します。 | |
現在のノードは一定期間、プライマリとして選挙を目指すことができません。 | |
レプリカセット関数の基本的なヘルプ テキストを返します。 | |
新しいレプリカセットを初期化します。 | |
プライマリから見たレプリカセットの状態を形式化されたレポートで出力します。 | |
セカンダリから見たレプリカセットの状態を形式化されたレポートで出力します。 | |
新しいレプリカセット構成オブジェクトを適用して、レプリカセットを再構成します。 | |
レプリカセットからノードを削除します。 | |
レプリカセットの状態に関する情報をドキュメントで返します。 | |
このレプリカセット ノードが同期する元ノードを設定し、デフォルトの同期ターゲット選択ロジックをオーバーライドします。 |
シャーディング
名前 | 説明 |
---|---|
再シャーディング操作を中止します。 バージョン 5.0 で追加 | |
シャーディングされたクラスターにシャードを追加します。 | |
シャードをゾーンに関連付けます。シャーディングされたクラスター内のゾーンの設定をサポートします。 | |
シャーディングされたコレクションのチャンクが、バランスが取れているかどうかに関する情報を返します。 | |
再シャーディング操作を強制し、書込みをブロックして完了します。 バージョン 5.0 で追加 | |
シャーディングされたデータベース内の単一のコレクションのバランシングを無効にします。シャーディングされたクラスター内の他のコレクションのバランシングには影響しません。 | |
以前に sh.disableBalancing() を使用して無効にしていた場合、シャーディングされたコレクション バランサー プロセスを有効にします。 | |
シャーディングされたクラスターの自動分割を無効にします。 MongoDB 6.0.3以降、 自動チャンク分割は実行されません。 これはバランシング ポリシーの改善によるものです。 自動分割コマンドは引き続き存在しますが、操作は実行されません。 | |
シャーディングされたクラスターの自動分割を有効にします。 MongoDB 6.0.3以降、 自動チャンク分割は実行されません。 これはバランシング ポリシーの改善によるものです。 自動分割コマンドは引き続き存在しますが、操作は実行されません。 | |
データベースを作成します。 | |
バランサーが現在有効になっているかどうかを報告するブール値を返します。 | |
シャーディングされたコレクションのデータ配信情報を返します。 | |
シャードキーの範囲とゾーンの間の関連付けを削除します。シャーディングされたクラスター内のゾーンの設定をサポートします。 | |
sh メソッドのヘルプ テキストを返します。 | |
バランサーの状態を説明するドキュメントを返します。 | |
シャーディングされたクラスター内のチャンクを移行します。 | |
シャードとゾーンの間の関連付けを削除します。ゾーン シャーディングを管理するために使用します。 | |
コレクションのシャードキーを変更してデータの分散状況を変えるために、再シャーディング操作を開始します。 バージョン 5.0 で追加 | |
コレクションのシャーディングを有効にします。 | |
クエリに一致するドキュメントを含む既存のチャンクを、ほぼ等しい 2 つのチャンクに分割します。 | |
AutoMerger を有効にします。 バージョン 7.0 で追加。 | |
バランサーを有効にし、バランシングが開始されるのを待ちます。 | |
シャーディングされたクラスターの状態を db.printShardingStatus() として報告します。 | |
AutoMerger を無効にします。 バージョン 7.0 で追加。 | |
バランサーを無効にし、進行中のバランサー ラウンドが完了するのを待ちます。 | |
内部。バランサーの状態が変化するのを待ちます。 | |
内部。バランサーが動作を停止するまで待ちます。 | |
内部。シャーディングされたクラスター内のいずれかの mongos の ping 状態が変化するの待ちます。 | |
シャードキーの範囲をゾーンに関連付けます。シャーディングされたクラスター内のゾーンの設定をサポートします。 | |
入力のハッシュ値を返します。 |
コンストラクター
名前 | 説明 |
---|---|
base64 値からバイナリ オブジェクトを作成します。 | |
16 進値からバイナリ オブジェクトを作成します。 | |
バイナリ データ オブジェクトを返します。 | |
Bulk.execute() の結果セットを囲むラッパー。 | |
日付オブジェクトを作成します。デフォルトでは、現在の日付を含む日付オブジェクトが作成されます。 | |
バイナリ データ オブジェクトを返します。 | |
ObjectId を返します。 | |
base64 値から ObjectId を作成します。 | |
16 進値から ObjectId を作成します。 | |
ObjectId のタイムスタンプ部分を返します。 | |
ObjectId の文字列表現を表示します。 | |
32 バイトの 16 進文字列を UUID BSON サブタイプに変換します。 | |
書き込みメソッドからの結果セットを囲むラッパー。 | |
結果に WriteResult.writeError が含まれているかどうかを指定するブール値を返します。 | |
結果に WriteResult.writeConcernError が含まれているかどうかを指定するブール値を返します。 |
接続
名前 | 説明 |
---|---|
MongoDB インスタンスとそのインスタンス上の指定されたデータベースに接続します。 | |
新しい接続オブジェクトを作成します。 | |
データベース オブジェクトを返します。 | |
MongoDB 接続の現在の読み込み設定(read preference)モードを返します。 | |
MongoDB 接続の読み込み設定(read preference)タグセットを返します。 | |
接続オブジェクトの因果整合性を有効または無効にします。 | |
MongoDB 接続の読み込み設定(read preference)を設定します。 | |
接続オブジェクトでセッションを開始します。 | |
セッション オブジェクト。 | |
セッションのオプション オブジェクト。 |
クライアントサイドのフィールド レベル暗号化
注意
mongosh
クライアント側のフィールド レベル暗号化メソッドでは、クライアント側のフィールド レベル暗号化が有効になっているデータベース接続が必要です。現在のデータベース接続がクライアント側のフィールド レベル暗号化を有効にして開始されなかった場合、次のいずれかが発生します。
Mongo()
必要なクライアント側のフィールドレベル暗号化オプションとの接続を確立するには、mongosh
から コンストラクターを使用します。Mongo()
メソッドは、CMK(Customer Master Key)管理のために次のKMS ( KMS )プロバイダーをサポートしています。or
必要なオプションとの接続を確立するには、
mongosh
コマンドライン オプションを使用します。 コマンドライン オプションは、CMK 管理用のAmazon Web Services KMSプロバイダーのみをサポートしています。
名前 | 説明 |
---|---|
現在の MongoDB 接続のキーヴォールト オブジェクトを返します。 | |
KeyVault.createKey() のエイリアス。 | |
クライアント側のフィールドレベル暗号化で使用するデータ暗号化キーを作成します。 | |
指定されたデータ暗号化キーをキーヴォールトから削除します。 | |
指定されたデータ暗号化キーをキーヴォールトで検索します。 | |
キーヴォールト内のすべてのキーを検索します。 | |
指定されたデータ暗号化キーに、キーの別名を関連付けます。 | |
KeyVault.addKeyAlternateName() のエイリアス。 | |
指定されたデータ暗号化キーからキーの別名を削除します。 | |
指定されたキーの別名を持つキーを検索します。 | |
複数のデータキーを復号化し、再暗号化します。 | |
フィールドの明示的な暗号化および復号化をサポートするためのクライアント暗号化オブジェクトを返します。 | |
暗号化されたフィールドを持つコレクションを作成します。 | |
指定されたデータ暗号化キーと暗号化アルゴリズムを使ってフィールドを暗号化します。 | |
関連付けられたデータ暗号化キーと暗号化アルゴリズムを使ってフィールドを復号化します。 |