このページで説明するデータの追加とクエリの Core オペレーションは、Firestore Standard で使用できるものと同じです。Firestore Standard エディションに精通している場合は、Firestore Enterprise で同じ方法でデータを追加してクエリを実行できます。
Pipeline オペレーションをぜひお試しください。ただし、このプレビューでは、次の Core オペレーションに注意する必要があります。
- プレビュー中に コア 追加オペレーションを使用してデータを入力します。
- Standard エディションと同様に、リアルタイムとオフライン サポートに Core オペレーションを使用できます。パイプライン クエリには、リアルタイム機能とオフライン機能はまだありません。
Core オペレーションを使用して Firestore にデータを追加する
Core オペレーションは、データの追加とクエリをサポートしています。Pipeline オペレーションは、データのクエリにのみ使用されます。そのため、プレビュー アクティビティでは、Core オペレーションを使用して、新しい Pipelines 対応データベースにデータを入力します。
Core の更新として、データを書き込む主なメソッドは set() と add() の 2 つです。この違いを理解することは、ドキュメントの効果的な管理において重要です。
これらのオペレーションは次のように考えることができます。
set(): ドキュメントの ID を自分で指定する場合に使用します。その ID のドキュメントがすでに存在する場合、マージ オプションを使用しない限り、set()はそれを完全に上書きします。存在しない場合、set()によって作成されます。add(): Firestore で新しいドキュメントの一意の ID を自動的に生成する場合に使用します。これは、コレクションにドキュメントを追加するときや、使用する自然な識別子がない場合に便利です。
ネストされたオブジェクト、配列、サーバー タイムスタンプの処理方法など、ドキュメントの追加と更新に関する包括的なガイドについては、Cloud Firestore へのデータの追加に関する公式ドキュメントをご覧ください。
Core オペレーションを使用して Firestore からデータを読み取る
Core オペレーションを使用した Firestore からのデータの取得は、リアルタイム アップデートとオフライン機能のサポートを含め、Firestore Standard エディションとまったく同じです。
データを取得する方法はいくつかあります。
- ドキュメントを 1 回取得する: データを読み取る最も簡単な方法は、ドキュメントまたはクエリ結果を 1 回取得することです。
- リアルタイム更新をリッスンする: ドキュメントまたはクエリにリスナーを設定して、データが変更されたときにリアルタイムで更新を受け取ることができます。
- ソース オプション: オフライン機能を持つアプリの場合、サーバーからデータを取得するか、ローカル キャッシュからデータを取得するか、SDK に決定させるかを指定できます。
単純なクエリと複合クエリの実行、データの並べ替えと制限、カスタム オブジェクトの操作について詳しくは、Cloud Firestore でのデータの取得の詳細なドキュメントをご覧ください。