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

ドキュメントの作成、表示、アップデート、削除

Atlas UI を使用してコレクション内のドキュメントを管理できます。ドキュメントは MongoDB コレクション内の個々のレコードであり、MongoDB のデータの基本単位です。

Atlas UI でドキュメントとコレクションを表示すると、データベース スキーマの概要を把握できます。Atlas UI を使用すると、埋め込みドキュメントと配列の利用など、MongoDB データ モデリングの主要概念に確実に従うことができます。

ユーザーがドキュメントを挿入、編集、または削除するには、次のいずれかのロールを通じてアクセス権を取得済みである必要があります。

Atlas UI を通じてコレクションに 1 つ以上のドキュメントを追加するには、新規に挿入するドキュメントを指定するか、既存のドキュメントを複製して、必要に応じてそのフィールドと値を変更します。

コレクションにドキュメントを挿入するには 、Atlas で次のいずれかの方法を使用します。

  • シェルシンタックスモード: MongoDB シェル構文でドキュメントを作成または貼り付けます。これにより、ObjectId() や などの引用符ではないフィールド名とタイプISODate() コンストラクタが可能になります。このモードを使用して、配列として複数のドキュメントを一度に挿入します。

  • フィールド単位エディタ:挿入された各ドキュメントに対して、個別のフィールド値とタイプを選択します。この方法を使用すると、一度に1つのドキュメントしか挿入できません。

  • JSONモード: 拡張JSON形式でドキュメントを書き込みまたは貼り付けます。この場合、引用符で囲まれたフィールド名が必要で、 BSON types を{"$oid": "..."} などのラッパーとして表します。このモードを使用して、配列として複数のドキュメントを一度に挿入します。

1
  1. まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー

  2. まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。

  3. サイドバーで、 Database見出しの下のClustersをクリックします。

[ Clusters (クラスター) ] ページが表示されます。

2
  1. まだ表示されていない場合は、プロジェクトを含む組織をナビゲーション バーの Organizations メニューで選択します。

  2. まだ表示されていない場合は、ナビゲーション バーの Projects メニューからプロジェクトを選択します。

  3. サイドバーで、 Database見出しの下のData Explorerをクリックします。

    Data Explorer が表示されます。

重要: クラスターの名前をクリックしてCluster サイドバーを開き、Data Explorer 見出しの下のShortcuts をクリックすることもできます。

3

ドロップダウン メニューで、[ Insert Document] をクリックします。

または、クエリ バーまたはその周囲の空白を右クリックし、ドロップダウン メニューから Insert document... を選択することもできます。

4

In the Insert Document modal, click the icon to use Shell Syntax mode to insert documents into your collection.

Shell Syntax モードはデフォルトのビューです。

5

MongoDB shell 構文で、コレクションに挿入するドキュメントを入力する、または貼り付けます。複数のドキュメントを挿入するには、ドキュメントをカンマで区切った配列で入力します。

例

次の例では、コレクションに単一のドキュメントを挿入します。フィールド名は引用符されず、_id、copies、lastCheckedOut の値では、拡張JSON型ラッパーの代わりに ObjectId()、NumberInt()、ISODate() 型コンストラクタが使用されます。

{
_id: ObjectId('507f1f77bcf86cd799439011'),
title: 'The Odyssey',
author: 'Homer',
copies: NumberInt('10'),
lastCheckedOut: ISODate('2025-03-14T09:30:00Z')
}

注意

_idドキュメントに 値を指定しない場合、Atlas は フィールドの ObjectId_id を自動的に生成します。

6

コレクション内の既存のドキュメントのスキーマと値を複製することで、新しいドキュメントを挿入できます。

ドキュメントを複製するには、目的のドキュメントにカーソルを合わせ、 Cloneボタンをクリックします。

複製ボタン
クリックして拡大します

Cloneボタンをクリックすると、Atlas はクローンされたドキュメントと同じスキーマと値でドキュメント挿入ダイアログを開きます。新しいドキュメントを挿入する前に、これらのフィールドと値を編集できます。

ドキュメントを表示および管理するには、 Documentsタブで次のいずれかのビューを使用できます。

  • リスト ビュー: デフォルトのドキュメントビューです。Atlas はドキュメントをリストで表示します。このビューでは、埋め込みオブジェクトと配列を展開できます。

  • JSONビュー: Atlas はドキュメントを適切にフォーマットされたJSONオブジェクトとして表示します。 Atlas は拡張JSONを使用して、各フィールドのデータ型を表示します。

  • テーブル ビュー:Atlas はドキュメントをテーブルの行として表示し、ドキュメントのフィールドをテーブルの列に表示します。このビューでは、特定のフィールド値が含まれているドキュメントを確認できます。

埋め込みオブジェクトと配列要素を展開するには、ドキュメントにカーソルを合わせ、左上の矢印をクリックします。

埋め込みオブジェクトリストを展開する
クリックして拡大します

ドキュメントをクリップボードにコピーするには、カーソルをドキュメントに合わせてコピー Copy アイコンをクリックします。

リストビューからドキュメントをコピーする
クリックして拡大します

Atlas UI では、1 ページの表示ドキュメントの合計バイトサイズが制限されています。その結果、1 ページあたりのドキュメント数はばらつく可能性があり、ドキュメントのサイズが大幅に異なる場合はその傾向が特に顕著です。

リスト ビューまたはテーブル ビューでドキュメントを編集する場合、Atlas では findOneAndUpdate操作が実行され、変更したフィールドのみがアップデートされます。

JSONビューでドキュメントを編集する場合は、Atlas で findOneAndReplace 操作が実行され、ドキュメントが に置き換えられます。

ドキュメントを修正するには、ドキュメントにカーソルを合わせ、鉛筆アイコンをクリックします。

ドキュメント編集の選択
クリックして拡大します

鉛筆アイコンをクリックすると、ドキュメントは編集モードになります。フィールド、値、または値のデータ型を変更できるようになりました。

ドキュメントからフィールドを削除するには、次のようにフィールドの左側にあるアイコンをクリックします。

文書の削除
クリックして拡大します

選択したフィールドは削除対象としてマークされ、赤色で強調表示されます。フィールドを削除してドキュメントを更新してよいか確認を求める、Atlas のメッセージが表示されます。

ドキュメント内の既存のフィールドの後に新しいフィールドを追加するには、ダイアログの行番号にカーソルを合わせ、プラス記号をクリックします。行番号はドキュメントの一部ではなく、ダイアログ表示の一部です。

ドキュメントにフィールドを追加する
クリックして拡大します

テキストカーソルが最後の文書フィールドの値にあるときに Tab キーを押して、文書の末尾に新しいフィールドを追加することもできます。

ドキュメントを修正するには、既存のフィールド名または値をクリックして変更します。この例では、borough が Manhattan から Queens に変更されました。変更されたフィールドは黄色で強調表示されます。

ドキュメントアップデートビュー
クリックして拡大します

リスト ビューまたはテーブル ビューでドキュメントを編集する場合、Atlas では findOneAndUpdate操作が実行され、変更したフィールドのみがアップデートされます。

Atlas は、Atlas 外で行われたフィールドの変更を検出して通知し、その変更によるフィールドの上書きを防ぎます。 Replace をクリックすることで、ドキュメントの上書きを続行するか、変更をキャンセルするかを選択できます。

ドキュメントの編集が完了したら、[Update] ボタンをクリックして変更を確定します。

ドキュメントの変更を元に戻すには、編集したフィールドにカーソルを合わせ、フィールドの行番号の左に表示される [revert icon] をクリックします。

リストビューでのドキュメントの反転

一括更新操作ワークフローを使用して、Atlas 内の複数のドキュメントを更新できます。詳しくは、複数のドキュメントの編集を参照してください。

Atlas UI を使用してコレクションからドキュメントを削除するには、以下の手順に従います。

ドキュメントを削除するには、ドキュメントにカーソルを合わせ、アイコンをクリックします。

リスト表示の削除ボタン
クリックして拡大します

削除ボタンをクリックすると、ドキュメントに削除フラグが付けられます。Atlas はドキュメントを削除するかどうかの確認を求めます。

確認すると、Atlas はコレクションからドキュメントを削除します。