AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。
See how MongoDB 9.0 delivers up to 2x higher throughput.
MongoDB Branding Shape
Register now >
Docs Menu

MongoDB Swift ドライバー

公式MongoDB Swiftドライバーのドキュメント サイトへようこそ。Swiftではアプリケーションにドライバーを追加して、 MongoDBと連携できます。Swiftパッケージ マネージャーを使用してダウンロードするか、使用ガイドの例を使用して実行可能なプロジェクトをセットアップしてください。

重要

Swift ドライバーは 2022 年現在、アクティブな開発環境はありません。

「 インストール 」を参照してください。

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 クラスターを使用する代わりに、開発目的でローカル コンピューター上で MongoDB Server を実行する必要がある場合は、次の手順を完了する必要があります。

  1. MongoDB Server の Communityバージョン または Enterprise バージョンをダウンロードします。

  2. MongoDB Serverをインストールして構成します。

  3. サーバーを起動します。

重要

MongoDB サーバーを悪意のある攻撃から常に保護します。セキュリティ推奨事項のリストについては、「セキュリティ チェックリスト」を参照してください。

MongoDB Serverを正常に開始したら、ドライバー接続コードで接続文字列を指定します。

MongoDB Server がローカルで実行されている場合は、接続文字列 "mongodb://localhost:<port>" を使用できます。ここで、<port> は、着信接続をリッスンするようにサーバーに設定したポート番号です。

別のホスト名または IP アドレスを指定する必要がある場合は、接続文字列に関するサーバー マニュアルのエントリを参照してください。

サーバーに接続できるかどうかをテストするには、MongoDB Atlas への接続に記載のコード例の接続文字列を置き換えて実行します。

このセクションの互換性テーブルは、特定のバージョンの 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以降が必要です。