Docs Menu
Docs Home
/
MongoDB ドライバー

MongoDB Swift ドライバー

項目一覧

  • はじめに
  • インストール
  • MongoDB Atlas への接続
  • ローカルマシン上の MongoDB Server への接続
  • 互換性

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

重要

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

Tip

MongoDB Realmで Swift を使用する方法について詳しくは、 MongoDB Realm iOS SDK ドキュメント を参照してください。

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

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 への接続の詳細については、必要な最小ドライバー バージョンの サーバーレスインスタンスの制限 ページを参照してください。

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

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

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

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

重要

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

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

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

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

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

このセクションの互換性テーブルは、特定のバージョンの MongoDB で使用するための MongoDB Swift ドライバーの推奨バージョンを示しています。

最初の列は、ドライバーのバージョンの一覧です。

重要

MongoDB は、MongoDB Server のバージョンのサポート終了(EOL)日から 3 年間、MongoDB Server とドライバー間の互換性を保証します。 MongoDB のリリースと EOL の日付の詳細については、「 MongoDB ソフトウェアライフサイクルの予定 」を参照してください。

Icon
説明
すべての機能がサポートされています。
ドライバー バージョンは 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]12バージョン 1.2 および 1.3 には、クライアント側フィールドレベル暗号化GridFS 、およびAmazon Web Services IAM ロールを使用した認証のサポートが含まれて いません 。
[2]12バージョン 1.0 および 1.1 には、 OCSPクライアント側フィールドレベル暗号化GridFS 、 Amazon Web Services IAM ロールを使用した認証 のサポートは含まれて いません 。

MongoDB Swift ドライバーにはSwift 5.1以降が必要です。

互換性テーブルの読み方の詳細については、「 MongoDB 互換性テーブル に関するガイドを参照してください。

戻る

Ruby ドライバー