Docs Menu

PyMongo を使い始める

PyMongo は、MongoDB に接続して通信するために使用できる Python パッケージです。 このガイドでは、PyMongo を使用して MongoDB Atlas でホストされている MongoDB クラスターに接続するアプリケーションを作成する方法について説明します。

Tip

MongoDB Atlas は、MongoDB 配置をホストする完全管理のクラウドデータベース サービスです。このガイドの手順に従い、独自の無料(クレジット カード不要)MongoDB Atlas 配置を作成できます。

このガイドに従って、サンプル Python アプリケーションを MongoDB Atlas 配置に接続します。別のドライバーまたはプログラミング言語を使用して MongoDB に接続する場合は、公式ドライバーのリストを参照してください。

注意

代替のインストール方法

以下の手順では、pip を使用してPyMongoをインストールする方法を示します。ソースからPyMongoをインストールするには、APIドキュメントの「ソースからのインストール」を参照してください。

1

開発環境に次の依存関係がインストールされていることを確認してください。

2

shell で次のコマンドを実行して、このプロジェクト用に pymongo-quickstart というディレクトリを作成します。

mkdir pymongo-quickstart

オペレーティング システムに対応するタブを選択し、次のコマンドを実行して、 pymongo-quickstartディレクトリにquickstart.pyアプリケーション ファイルを作成します。

cd pymongo-quickstart
touch quickstart.py
cd pymongo-quickstart
type nul > quickstart.py
3

オペレーティング システムに対応するタブを選択し、次のコマンドを実行して、ドライバーをインストールする仮想環境を作成およびアクティブ化します。

python3 -m venv venv
source venv/bin/activate
python3 -m venv venv
. venv\Scripts\activate

仮想環境がアクティブ化されている状態で、次のコマンドを実行して PyMongo の現在のバージョンをインストールします。

python3 -m pip install pymongo

これらの手順を完了すると、新しいプロジェクト ディレクトリとドライバーの依存関係がインストールされます。

MongoDB Atlasでは無料階層のMongoDBデプロイを作成して、データを保存および管理できます。 MongoDB Atlas は、クラウドでMongoDBデータベース をホストおよび管理します。

1

Atlas の使用開始ガイドを完了して、新しい Atlas アカウントを設定し、サンプル データを新しい無料階層 MongoDB 配置にロードします。

2

データベースユーザーを作成したら、そのユーザーのユーザー名とパスワードを安全な場所に保存して、後の手順で使用します。

これらの手順を完了すると、Atlas に新しい無料階層の MongoDB 配置、データベースユーザーの認証情報、データベースに サンプル データがロードされます 。

MongoDB配置に接続するには、 接続string とも呼ばれる 接続 URIMongoDB を提供します。これは、 配置に接続する方法と接続中の動作をドライバーに指示します。

接続stringには、配置のホスト名またはIPアドレスとポート、認証メカニズム、ユーザー認証情報(該当する場合)、および接続オプションが含まれます。

Atlas でホストされていないインスタンスまたは配置に接続するには、 「 接続ターゲットの選択 」を参照してください。

1

配置の接続文字列を取得するには、前のステップで作成した Atlas アカウントにログインして Database セクションに移動し、新しい配置の [Connectボタンをクリックします。

Connect your applicationセクションに進み、 Driver選択メニューから [Python] を選択し、 Version選択メニューからインストールしたバージョンに最適なバージョンを選択します。

Password (SCRAM)認証メカニズムを選択します。

接続stringを表示するには、Include full driver code example オプションの選択を解除します。

2

次のスクリーンショットに示すように、接続stringの右側にある ボタンをクリックして、クリップボードにコピーします。

3

この接続stringをテキストエディタのファイルに貼り付け、<username><password> のプレースホルダーをデータベースユーザーのユーザー名とパスワードに置き換えます。

このファイルを安全な場所に保存して、次の手順で使用します。

これらの手順を完了すると、データベースのユーザー名とパスワードを含む接続stringが作成されます。

1

次のコードをコピーして、アプリケーション内のquickstart.pyファイルに貼り付けます。

from pymongo import MongoClient
uri = "<connection string URI>"
client = MongoClient(uri)
try:
database = client.get_database("sample_mflix")
movies = database.get_collection("movies")
# Query for a movie that has the title 'Back to the Future'
query = { "title": "Back to the Future" }
movie = movies.find_one(query)
print(movie)
client.close()
except Exception as e:
raise Exception("Unable to find the document due to the following error: ", e)
2

<connection string URI> プレースホルダーを、このガイドの接続文字列の作成ステップからコピーした接続文字列に置き換えます。

3

このアプリケーションを起動するには、shell で次のコマンドを実行します。

python3 quickstart.py

出力には、検索された映画ドキュメントの詳細が含まれます。

{
_id: ...,
plot: 'A young man is accidentally sent 30 years into the past...',
genres: [ 'Adventure', 'Comedy', 'Sci-Fi' ],
...
title: 'Back to the Future',
...
}

Tip

エラーが発生した場合や出力が表示されない場合は、 適切な接続stringが指定されているかどうか、およびサンプル データがロードされているかどうかを確認してください。

これらの手順を完了すると、ドライバーを使用して MongoDB 配置に接続し、サンプル データに対してクエリを実行し、結果を出力する動作するアプリケーションが作成されます。

チュートリアルを完了しました。

このチュートリアルでは、MongoDB Atlas でホストされている MongoDB 配置に接続し、クエリに一致するドキュメントを検索する Python アプリケーションを作成しました。

次のリソースから PyMongo の詳細を学びます。

  • ドキュメントの挿入」セクションで、ドキュメントを挿入する方法を学びます。

  • クエリ セクションでドキュメントを検索する方法について学びます。

  • ドキュメントの更新方法については、「ドキュメントの更新」セクションを参照してください。

  • ドキュメントを削除する方法については、「ドキュメントの削除」セクションを参照してください。

注意

この手順で問題が発生した場合は、MongoDB Community フォーラムでサポートを依頼するか、このページの右側または右下にある Rate this page タブを使用してフィードバックを送信してください。