はじめに
公式 MongoDB Swift ドライバーのドキュメント サイトへようこそ。 Swift ではアプリケーションにドライバーを追加して、MongoDB と連携できます。 Swift パッケージ マネージャー を使用してダウンロードします または 、使用ガイドの例えを使って実行可能なプロジェクトをセットアップする
重要
Swift ドライバーは 2022 年現在、アクティブな開発環境はありません。
インストール
MongoDB Atlas への接続
MongoDB Atlasクラスターに接続するには、クラスターのAtlas接続stringを使用します。
import MongoSwiftSync defer { // free driver resources cleanupMongoSwift() } // replace the following string with your connection uri let uri = "mongodb+srv://<db_username>:<db_password>@<cluster-address>/test?w=majority" let client = try MongoClient(uri) // print a list of database names print (try client.listDatabaseNames()) // your application logic
import MongoSwift import NIO let elg = MultiThreadedEventLoopGroup(numberOfThreads: 4) // replace the following string with your connection uri let uri = "mongodb+srv://<db_username>:<db_password>@<cluster-address>/test?w=majority" let client = try MongoClient( uri, using: elg ) defer { // clean up driver resources try? client.syncClose() cleanupMongoSwift() // shut down EventLoopGroup try? elg.syncShutdownGracefully() } // print a list of database names print(try client.listDatabaseNames().wait()) // your application logic
注意
Atlas Serverless への接続の詳細については、必要な最小ドライバー バージョンの サーバーレスインスタンスの制限 ページを参照してください。
ローカルマシン上の MongoDB Server への接続
Atlas クラスターを使用する代わりに、開発目的でローカル コンピューター上で MongoDB Server を実行する必要がある場合は、次の手順を完了する必要があります。
MongoDB Server の Communityバージョン または Enterprise バージョンをダウンロードします。
MongoDB Serverをインストールして構成します。
サーバーを起動します。
重要
MongoDB サーバーを悪意のある攻撃から常に保護します。セキュリティ推奨事項のリストについては、「セキュリティ チェックリスト」を参照してください。
MongoDB Serverを正常に開始したら、ドライバー接続コードで接続文字列を指定します。
MongoDB Serverがローカルで実行されている場合は、接続string"mongodb://localhost:<port>"
{0<port>
を使用できます。ここで、 は、着信接続をリッスンするようにサーバーに設定したポート番号です。
別のホスト名または IP アドレスを指定する必要がある場合は、接続文字列に関するサーバー マニュアルのエントリを参照してください。
サーバーに接続できるかどうかをテストするには、MongoDB Atlas への接続に記載のコード例の接続文字列を置き換えて実行します。
互換性
MongoDB の互換性
このセクションの互換性テーブルは、特定のバージョンの MongoDB で使用するための MongoDB Swift ドライバーの推奨バージョンを示しています。
最初の列は、ドライバーのバージョンの一覧です。
重要
MongoDB は、MongoDB Server のバージョンのサポート終了(EOL)日から 3 年間、MongoDB Server とドライバー間の互換性を保証します。 MongoDB のリリースと EOL の日付の詳細については、「 MongoDB ソフトウェアライフサイクルの予定 」を参照してください。
互換性テーブルの凡例
Icon | 説明 |
---|---|
✓ | すべての機能がサポートされています。 |
⊛ | ドライバー バージョンは MongoDB バージョンで動作しますが、すべての新しい MongoDB 機能がサポートされているわけではありません。 |
✗ | ドライバー バージョンは MongoDB バージョンでは動作しません。MongoDB バージョンに接続しようとすると、エラーが発生します。 |
マークなし | ドライバー バージョンは MongoDB バージョンではテストされていません。 |
Swift ドライバーのバージョン | MongoDB 7.0 | MongoDB 6.0 | MongoDB 5.0 | MongoDB 4.4 | MongoDB 4.2 | MongoDB 4.0 | MongoDB 3.6 |
---|---|---|---|---|---|---|---|
1.3.0 [1] | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | |
1.2.0 [1] | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | |
1.1.0 [2] | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | |
1.0.0 [2] | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ |
Swift ドライバーの開発はアクティブではないため、MongoDB Server バージョン 7.0 以降ではテストされていません。
Swift ドライバーは 3.6 より前の MongoDB サーバーと互換性がありません。
[1] | ( 1 、 2 )バージョン 1.2 および 1.3 には、クライアント側フィールドレベル暗号化、 GridFS 、およびAmazon Web Services IAM ロールを使用した認証のサポートが含まれて いません 。 |
[2] | ( 1 、 2 )バージョン 1.0 および 1.1 には、 OCSP 、クライアント側フィールドレベル暗号化、 GridFS 、 Amazon Web Services IAM ロールを使用した認証 のサポートは含まれて いません 。 |
言語互換性
MongoDB Swift ドライバーにはSwift 5.1以降が必要です。
互換性テーブルの読み方の詳細については、「 MongoDB 互換性テーブル に関するガイドを参照してください。
ヘルプを受けるには
SUIFT を参照してください 問題を発生させたり機能をリクエストしたりするための JIRA プロジェクト。