PyMongo を使い始める
項目一覧
Overview
PyMongo は、MongoDB に接続して通信するために使用できる Python パッケージです。 このガイドでは、PyMongo を使用して MongoDB Atlas でホストされている MongoDB クラスターに接続するアプリケーションを作成する方法について説明します。
Tip
MongoDB Atlas は、MongoDB 配置をホストする完全管理のクラウドデータベース サービスです。このガイドの手順に従い、独自の無料(クレジット カード不要)MongoDB Atlas 配置を作成できます。
このガイドに従って、サンプル Python アプリケーションを MongoDB Atlas 配置に接続します。別のドライバーまたはプログラミング言語を使用して MongoDB に接続する場合は、公式ドライバーのリストを参照してください。
ダウンロードとインストール
注意
代替のインストール方法
以下の手順では、pip を使用してPyMongoをインストールする方法を示します。ソースからPyMongoをインストールするには、APIドキュメントの「ソースからのインストール」を参照してください。
これらの手順を完了すると、新しいプロジェクト ディレクトリとドライバーの依存関係がインストールされます。
MongoDB 配置の作成
MongoDB Atlasでは無料階層のMongoDBデプロイを作成して、データを保存および管理できます。 MongoDB Atlas は、クラウドでMongoDBデータベース をホストおよび管理します。
Atlas で無料の MongoDB 配置を作成
Atlas の使用開始ガイドを完了して、新しい Atlas アカウントを設定し、サンプル データを新しい無料階層 MongoDB 配置にロードします。
これらの手順を完了すると、Atlas に新しい無料階層の MongoDB 配置、データベースユーザーの認証情報、データベースに サンプル データがロードされます 。
接続文字列の作成
MongoDB配置に接続するには、 接続string とも呼ばれる 接続 URIMongoDB を提供します。これは、 配置に接続する方法と接続中の動作をドライバーに指示します。
接続stringには、配置のホスト名またはIPアドレスとポート、認証メカニズム、ユーザー認証情報(該当する場合)、および接続オプションが含まれます。
Atlas でホストされていないインスタンスまたは配置に接続するには、 「 接続ターゲットの選択 」を参照してください。
MongoDB Atlas 接続文字列を見つける
配置の接続文字列を取得するには、前のステップで作成した Atlas アカウントにログインして Database セクションに移動し、新しい配置の [Connectボタンをクリックします。
Connect your applicationセクションに進み、 Driver選択メニューから [Python] を選択し、 Version選択メニューからインストールしたバージョンに最適なバージョンを選択します。
Password (SCRAM)認証メカニズムを選択します。
接続stringを表示するには、Include full driver code example オプションの選択を解除します。
これらの手順を完了すると、データベースのユーザー名とパスワードを含む接続stringが作成されます。
MongoDB に接続する
PyMongoアプリケーションの作成
次のコードをコピーして、アプリケーション内の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)
接続文字列の割り当て
<connection string URI>
プレースホルダーを、このガイドの接続文字列の作成ステップからコピーした接続文字列に置き換えます。
アプリケーションを実行してください
このアプリケーションを起動するには、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 タブを使用してフィードバックを送信してください。