メソッド
項目一覧
次のドキュメントは、MongoDB Shell で利用可能なメソッドを示しています。 メソッドをクリックすると、構文や例えなどのドキュメントが MongoDB マニュアルで表示されます。
重要
shelltriggerのサーバーへの接続をリセットするメソッドは、開いているすべての サーバー セッション の終了を します。セッションが終了すると、進行中のすべての操作も終了されます。その場合、認証が有効になっている場合はクライアントは再認証を行う必要があります。
次のメソッドは shell の接続をリセットします。
db.auth
Mongo.setReadPref
Mongo.setReadConcern
管理メソッド
方式 | 説明 |
---|---|
| |
現在進行中の操作を報告します。 | |
指定された操作を終了します。 | |
データベースをロックして書き込み操作を防ぎ、バックアップ操作を支援するには、ディスクへの書き込みをフラッシュします。 | |
Atlas Search インデックス メソッド
Atlas Search インデックスを使用すると、Atlas Search 内のデータをクエリできます。Atlas Search インデックスは、検索タームを含むドキュメントにタームをマッピングすることで、テキスト検索クエリの効率を高めます。
次の方法を使用して、Atlas Search インデックスを管理します。
重要
以下のメソッドは、MongoDB Atlas でホストされている配置でのみ実行できます。
名前 | 説明 |
---|---|
指定されたコレクションに 1 つ以上の Atlas Search インデックスを作成します。 | |
既存の Atlas Search インデックスを削除します。 | |
指定されたコレクションの既存の Atlas Search インデックスに関する情報を返します。 | |
既存の Atlas Search インデックスをアップデートします。 |
一括操作メソッド
方式 | 説明 |
---|---|
コレクションの新しい | |
コレクションの新しい | |
単一のコレクションに対して一括して実行する書込み (write) 操作のリストを作成するために使われる一括操作ビルダを作成します。 ビルダをインスタンス化するには、 | |
| |
アップデート操作または削除操作のクエリ条件を指定します。 | |
一括操作をサポートするインデックスを指定するヒントオプションを設定します。 | |
一括操作リストに 削除操作を追加します。 | |
一括操作リストに 1 つのドキュメントの削除操作を追加します。 | |
一括操作リストに 1 つのドキュメント置換操作を追加します。 | |
一括操作リストに 1 つのドキュメントのアップデート操作を追加します。 | |
一括操作リストにマルチアップデート操作 を追加します。 このメソッドは、既存のドキュメントの特定のフィールドをアップデートします。 | |
更新操作または置換操作でアップサートオプションを | |
一括操作リストに 挿入操作 を追加します。 | |
| |
|
コレクション メソッド
方式 | 説明 |
---|---|
一括書き込み操作機能を提供します。 | |
| |
collectionまたはビュー内のドキュメントのおおよその数を返します。 | |
コレクションにインデックスを構築します。 | |
コレクションに 1 つ以上のインデックスを構築します。 | |
コレクションのサイズを返します。 の出力で | |
コレクション内の 1 つのドキュメントを削除します。 | |
コレクション内の複数のドキュメントを削除します。 | |
指定されたフィールドに対して異なる値を持つドキュメントの範囲を返します。 | |
指定したコレクションをデータベースから排除します。 | |
コレクションの指定されたインデックスを削除します。 | |
コレクションのすべてのインデックスを削除します。 | |
さまざまなメソッドのクエリ実行についての情報を返します。 | |
コレクションまたはビューに対してクエリを実行し、カーソル オブジェクトを返します。 | |
アトミックに修正して 1 つのドキュメントを返します。 | |
クエリを実行し、1 つのドキュメントを返します。 | |
1 つのドキュメントを検索して削除します。 | |
1 つのドキュメントを検索して置き換えます。 | |
1 つのドキュメントを検索してアップデートします。 | |
コレクションの既存のインデックスを記述するドキュメントの配列を返します。 | |
シャーディングされたコレクションのデータ配信統計を出力します。 | |
シャーディングされたクラスター内のデータの状態に関する情報を返します。 | |
コレクションに新しいドキュメントを挿入します。 | |
コレクションに複数の新しいドキュメントを挿入します。 | |
コレクションがCapped コレクション かどうかを報告します。 | |
コレクションに対してmap-reduce集計操作を実行します。 | |
コレクションのすべての既存のインデックスを再構築します。 | |
コレクションの名前を変更します。 | |
コレクションの 1 つのドキュメントを置き換えます。 | |
コレクションの状態を報告します。 | |
コレクションで使用される合計サイズをバイト単位で報告します。 | |
コレクションのインデックスによって使用される合計サイズを報告します。 | |
コレクション内のすべてのドキュメントとすべてのインデックスのサイズを含む、コレクションの合計サイズを報告します。 | |
コレクションの 1 つのドキュメントを変更します。 | |
コレクションの複数のドキュメントを変更します。 | |
コレクションを検証します。 | |
コレクション上で変更ストリーム カーソルを開きます。 |
接続方法
方式 | 説明 | |||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
データベース オブジェクトを返します。 | ||||||||||
MongoDB 接続の 読み込み設定( read preference ) を設定します。 | ||||||||||
レプリカセットまたはシャーディングされたクラスターの変更ストリーム カーソルを開き、 |
カーソル メソッド
方式 | 説明 | |
---|---|---|
クエリの動作を変更する特別なワイヤプロトコル フラグを追加します。 | ||
シャーディングされたコレクションに対する | ||
MongoDB が単一のネットワーク メッセージでクライアントに返すドキュメントの数を制御します。 次のクエリの例では、100 のバッチが返されます。
| ||
カーソルを閉じて、関連付けられているサーバー リソースを解放します。 | ||
ログおよび system.profile コレクションのトレーサビリティを確保できるように、クエリにコメントを付けます。 | ||
カーソルがドキュメントそのものではなく、結果セット内のドキュメント数を返すように変更します。 | ||
カーソルのクエリ実行プランについて報告します。 | ||
カーソル内のすべてのドキュメントに JavaScript 関数を適用します。 | ||
カーソルにドキュメントがあり、反復処理できる場合は | ||
MongoDB がクエリに特定のインデックスを使用するように強制します。 | ||
カーソルが閉じている場合は | ||
カーソルが閉じており、かつ、バッチにオブジェクトが残っていない場合は | ||
結果セットを取得して反復処理することにより、クライアント側のカーソルにあるドキュメントの総数を計算します。 | ||
カーソルの結果セットのサイズを制限します。 | ||
カーソル内の各ドキュメントに関数を適用し、戻り値を配列に収集します。 | ||
カーソルに対して限定的な上位インデックスの限界を指定します。使用用途 | ||
カーソルに対する情報処理操作の累積時間制限をミリ秒単位で指定します。 | ||
カーソルに対して限定しない下位インデックスの限界を指定します。使用用途 | ||
カーソル内の次のドキュメントを返します。 | ||
非アクティブな状態が一定期間続いた後、カーソルを自動的に閉じないようサーバーへ指示します。 | ||
現在のカーソル バッチに残っているドキュメントの数を返します。 | ||
操作の | ||
カーソルに 読み込み設定( read preference)を指定して、クライアントがレプリカセット にクエリを送信する方法を制御します。 | ||
カーソルを変更して、ドキュメントではなくインデックス キーを返します。 | ||
カーソルによって返される各ドキュメントに内部 storage engine ID フィールドを追加します。 | ||
一定数のドキュメントを渡したりスキップした後にのみ結果を返し始めるカーソルを返します。 | ||
ソート指定に従って順序付けられた結果を返します。 | ||
カーソルを末尾可能としてマークします。上限付きコレクションのカーソルに対してのみ有効です。 | ||
カーソルによって返されたすべてのドキュメントを含む配列を返します。 |
データベース メソッド
方式 | 説明 |
---|---|
基礎のコレクションを必要としない管理および診断パイプラインを実行します。 | |
新しいコレクションまたはビューを作成します。 | |
指定された 集計パイプライン をソース コレクションまたはビューに適用して ビュー を作成します。 | |
指定されたデータベースコマンドのヘルプ テキストを表示します。 | |
現在のデータベースを削除します。 | |
コレクションまたはビュー オブジェクトを返します。 | |
現在のデータベース内のすべてのコレクションとビューのコレクション情報を返します。 | |
現在のデータベース内のすべてのコレクションとビューを一覧表示します。 | |
現在のデータベース接続を返します。 | |
現在のログの冗長設定を返します。 | |
現在のデータベースの名前を返します。 | |
現在のプロファイル レベル、 slowOpThresholdMs設定、 slowOpSampleRate設定を返します。 | |
指定されたデータベースへのアクセス権を提供します。 | |
すべてのデータベースコマンドの一覧を提供します。 | |
認証されたセッションを終了します。 | |
シャーディング構成のフォーマットされたレポートと、シャーディングされたクラスター内の既存のチャンクに関する情報を出力します。 | |
データベースプロファイラー レベル、 slowms 、 sampleRate を構成します。 | |
データベースの変更ストリーム カーソルを開き、すべての非システム コレクションについてレポートします。 |
使用中の暗号化メソッド
注意
制限
自動暗号化は、
mongosh
が Atlas クラスターまたは MongoDB Enterprise Server に接続されている場合にのみ使用できます。 詳細については、 「クライアント側フィールドレベルの自動暗号化」 を参照してください。 このセクションにリストされているメソッドは手動暗号化に使用され、非エンタープライズ サーバーでサポートされています。mongosh
の Homebrew インストールでは自動暗号化は利用できません。フィールドレベルの暗号化は
mongosh
バイナリでのみ使用可能であり、埋め込み Compass shell では使用できません。
方式 | 説明 |
---|---|
暗号化されたフィールドを持つコレクションを作成します。 | |
| |
指定された | |
現在のデータベース コレクションの | |
現在のデータベース接続の | |
指定された UUID を持つデータ暗号化キーの | |
データベース接続に関連付けられたキーヴォールトにデータ暗号化キーを追加します。 | |
指定された UUID を持つデータ暗号化キーを、データベース接続に関連付けられたキーヴォールトから削除します。 | |
指定された UUID を持つデータ暗号化キーを取得します。 データ暗号化キーは、データベース接続に関連付けられたキーヴォールトに存在する必要があります。 | |
指定された | |
データベース接続に関連付けられたキーヴォールトに保存されているすべてのデータ暗号化キーを返します。 | |
指定された UUID を持つデータ暗号化キーから、指定された |
ネイティブ メソッド
方式 | 説明 | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| |||||||||||||||||||
| 現在の作業ディレクトリを指定されたパスに変更します。 | |||||||||||||||||||
| mongosh が対話モードまたはスクリプト モードのどちらで実行されているかを示すブール値を返します。 | |||||||||||||||||||
| shell に JavaScript ファイルをロードして実行します。
レガシーの | |||||||||||||||||||
| 指定されたテキストまたは変数を出力します。
| |||||||||||||||||||
| アクティブな shell セッションの現在の作業ディレクトリを返します。 | |||||||||||||||||||
| 現在の shell セッションを終了します。 | |||||||||||||||||||
| 特定の期間、 | |||||||||||||||||||
|
|
クエリプラン キャッシュ メソッド
方式 | 説明 |
---|---|
コレクションのクエリプラン キャッシュ オブジェクトと関連する | |
コレクションのすべてのキャッシュされたクエリプランを削除します。 | |
コレクションのクエリプラン キャッシュを表示および変更するために使用できるメソッドを一覧表示します。 | |
コレクションのプラン キャッシュ エントリの配列を返します。 |
レプリケーション メソッド
方式 | 説明 | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
レプリカセットにメンバーを追加します。 このメソッドを実行するには、レプリカセットのプライマリに接続する必要があります。 | ||||||||||||
既存のレプリカセットに アービタ を追加します。 | ||||||||||||
現在のレプリカセットの構成を含むドキュメントを返します。 | ||||||||||||
| ||||||||||||
oplog データからレプリカセットのステータスを返します。 | ||||||||||||
新しいレプリカセットを初期化します。 | ||||||||||||
| ||||||||||||
| ||||||||||||
| レプリカセットの セカンダリ メンバーのステータスを返します。 これは 以下は、2 つのセカンダリ ノードがあるレプリカセットで発行された
| |||||||||||
| レプリカセットの セカンダリ メンバーのステータスを返します。 これは 以下は、2 つのセカンダリ ノードがあるレプリカセットで発行された
| |||||||||||
既存のレプリカセットの構成を変更します。 | ||||||||||||
ホスト名で指定されたノードをレプリカセットから削除します。 | ||||||||||||
| ||||||||||||
レプリカセットのプライマリをセカンダリにします。 このメソッドを実行するには、プライマリに接続する必要があります。 | ||||||||||||
|
ロール マネジメント メソッド
方式 | 説明 |
---|---|
ロールを作成し、その権限を指定します。 | |
ユーザー定義のロールを削除します。 | |
データベースに関連付けられているすべてのユーザー定義のロールを削除します。 | |
指定されたロールの情報を返します。 | |
データベース内のすべてのユーザー定義のロールに関する情報を返します。 | |
ユーザー定義のロールに権限を割り当てます。 | |
指定した権限をユーザー定義ロールから排除します。 | |
ユーザー定義ロールが権限を継承するロールを指定します。 | |
継承されたロールをロールから削除します。 | |
ユーザー定義ロールを更新します。 |
セッション オブジェクト メソッド
方式 | 説明 |
---|---|
接続のセッションを開始します。 | |
optimeを更新します。 | |
セッションを終了します。 | |
セッションで確認された最新のクラスター時間を返します。 | |
shell のセッションから指定されたデータベースにアクセスします。 | |
セッションの最後に確認された操作のタイムスタンプを返します。 | |
セッションのオプションを返します。 | |
セッションが終了したかどうかを指定するブール値を返します。 | |
shell 内のセッションのオプション。 |
サーバー ステータス メソッド
シャーディング メソッド
方式 | 説明 |
---|---|
シャーディングされたクラスターにシャードを追加します。 | |
シャードをゾーンに関連付けます。シャーディングされたクラスター内のゾーンの構成をサポートします。 | |
シャーディングされたコレクションのチャンクが、バランスが取れているかどうかに関する情報を返します。 バージョン 4.4 で追加。 | |
名前空間のチャンクの自動マージを無効にします。 バージョン 7.0 で追加。 | |
シャーディングされたクラスターの自動分割を無効にします。 | |
Disables balancing on a single collection in a sharded database. シャーディングされたクラスター内の他のコレクションのバランシングには影響しません。 | |
名前空間のチャンクの自動マージを有効にします。 バージョン 7.0 で追加。 | |
シャーディングされたクラスターの自動分割を有効にします。 | |
特定のデータベースのシャーディングを有効にします。 | |
バランサーが現在有効になっているかどうかを報告するブール値を返します。 | |
シャーディングされたコレクションのデータ配信情報を返します。 | |
バランサープロセスが現在チャンクを移行しているかどうかを報告するブール値を返します。 | |
シャーディングされた クラスター内 の チャンク を移行します。 | |
シャードキー値の範囲とゾーンの間の関連付けを削除します。 | |
シャードとゾーンの間の関連付けを削除します。 | |
タグとシャードの間の関連付けを削除します。 | |
| |
シャード 間で チャンク を移行する バランサー を有効または無効にします。 | |
コレクションのシャーディングを有効にします。 | |
クエリに一致するドキュメントを含む既存のチャンクを、ほぼ等しい 2 つのチャンクに分割します。 | |
AutoMerger を有効にします。 バージョン 7.0 で追加。 | |
シャーディングされたクラスターの状態を報告します。 | |
AutoMerger を無効にします。 バージョン 7.0 で追加。 | |
バランサーを無効にします。 この操作は、バランサーが進行中の操作を完了するのを待たずに、進行中の操作を終了する可能性があります。 | |
シャードキーの範囲をゾーンに関連付けます。 シャーディングされたクラスター内の ゾーン の設定をサポートします。 |
テレメトリー メソッド
これらのメソッドは、 mongosh
が匿名のテレメトリ データを追跡するかどうかを構成します。 テレメトリはデフォルトで有効になっています。
mongosh
がテレメトリで追跡するデータの詳細については、「テレメトリ オプションの構成 」を参照してください。
方式 | 説明 |
---|---|
| |
|
トランザクション メソッド
方式 | 説明 |
---|---|
マルチドキュメントトランザクションを終了し、トランザクション内の操作によって行われたデータ変更をロールバックします。 | |
マルチドキュメントトランザクションの操作によって行われた変更を保存し、トランザクションを終了します。 | |
セッションに関連するマルチドキュメントトランザクションを開始します。 |
ユーザー管理メソッド
重要
passwordPrompt()
メソッドは現在、 mongosh
ではサポートされていません。 そのため、次のメソッドを使用する場合は、パラメーターとしてパスワードを指定する必要があります。
方式 | 説明 |
---|---|
データベースに対してユーザーを認証します。 | |
既存のユーザーのパスワードを変更します。 | |
新規ユーザーを作成します。 | |
データベースに関連付けられているすべてのユーザーを削除します。 | |
ユーザーを 1 人削除します。 | |
指定されたユーザーに関する情報を返します。 | |
データベースに関連付けられているすべてのユーザーに関する情報を返します。 | |
指定されたユーザーのデータを更新します。 | |
ロールとその権限をユーザーに付与します。 | |
ユーザーからロールを削除します。 |