クライアントアプリから Atlas をクエリする

項目一覧

Atlas Device Sync、Atlas Edge Server、Data API、HTTPS endpoints は非推奨です。詳細については、の廃止ページを参照してください。

Realm SDK のMongoDB Data Accessで標準の MongoDB 問い合わせ言語（MQL）構文を使用して、クライアントアプリケーションからリンクされた MongoDB Atlas クラスター内のデータをクエリできます。

MongoDB Data Access は、アプリのロールベースのアクセス権限、クエリフィルター、ドキュメントスキーマを強制することでデータを保護します。これらの機能を使用すると、サーバー上でデータを安全に維持しながら、MQL を使用して複雑なクライアント側クエリを作成できます。

MongoDB データアクセスの用途

次の場合には、アプリケーションで MongoDB Data Access を使用する必要があります。

このようなシナリオのアプリケーションでは、 Atlas Device Sync ではなく MongoDB Data Access を使用することをお勧めします。

クライアント側のシナリオで MongoDB Data Access の代わりに、 Atlas Data API を使用できます。

また、言語に HTTPS クライアントがある限り、Realm SDK なしでこれらの API を使用することもできます。ただし、これらの API は Realm SDK の MongoDB Data Access と同じ型セーフな MQL 構文を機能していません。

サーバー側のシナリオでは MongoDB Data Access の代わりに、次のものを使用できます。

MongoDB ドライバー。 MongoDB ドライバーを使用して Atlas に接続する方法は、App Services 経由で接続するよりもパフォーマンスと柔軟であるため、サーバー側のアプローチとして一般的に推奨されます。ドライバー操作に App Services ルールを適用する場合は、 App Services ワイヤプロトコルを使用できます。
Atlas Data API

Realm SDK から MongoDB Data Access を使用するには、次のセットアップを実行する必要があります。

App Services AppリンクされたMongoDB データソースを使用してを作成します。

アプリに少なくとも 1 つの認証プロバイダを追加します。すべての MongoDB Data Access クエリは認証済みユーザーのコンテキストで実行されます。ユーザー認証を有効にする方法の詳細については、「認証プロバイダ」を参照してください。

クライアント側のクエリを保護するには、MongoDB Data Access で使用するすべてのコレクションに App Services ルールを追加する必要があります。コレクションにルールを追加する方法については、「ロールと権限の定義」を参照してください。

コレクションにルールを追加しない場合、クライアントからそのコレクションへのすべてのリクエストは失敗します。

ルールに加えて、MongoDB Data Access でクエリするコレクションにスキーマとフィルターを追加することもできます。

スキーマはアプリのデータモデルを定義し、そのモデルに対してドキュメントを検証します。フィルターを使用して、クライアントがデータベースに一致するデータのみを書込むようにします。

フィルターは MongoDB クエリをデータベースに送信する前に変更し、クエリでは結果のサブセットのみが返されるようになります。例えば、クエリを変更するフィルターを定義して、ユーザーは自分が書き込んだデータにのみアクセスできるようにすることができます。

MongoDB Data Access を使用するためにスキーマとフィルターは必要ありませんが、ほとんどの本番環境のユースケースに追加する必要があります。

Realm SDK から MongoDB をクエリする方法については、次の Realm MongoDB Data Access ドキュメントを参照してください。

MongoDB Data Accessは、これらの Realm SDK ではサポートされていません。

戻る

CRUD および集計 API

読み込み設定 (read preference)