このページでは、Datastore モードの Firestore クライアント ライブラリを構成して、ロケーション エンドポイントを使用する方法について説明します。
Datastore モードの Firestore クライアント ライブラリを使用する場合、次のいずれかのエンドポイントを使用できます。
グローバル エンドポイント: デフォルトでは、Datastore モードの Firestore のクライアント ライブラリは、
datastore.googleapis.com
という名前のグローバル サービス エンドポイントに API リクエストを送信します。グローバル サービス エンドポイントがリクエストをデータベースにルーティングします。ルーティング中に、リクエストがデータベースのロケーションとは異なるロケーションのロケーション サービス エンドポイントを経由する可能性があります。ロケーション エンドポイント: ロケーション エンドポイントにはリージョンの制約が適用されます。これにより、データが指定されたリージョンに保存され、処理されることが保証されます。サービス エンドポイントがデータベースと同じリージョンの Datastore モードの アプリの Firestore リクエストを処理するには、クライアント ライブラリでロケーション エンドポイントを指定します。
ロケーション エンドポイントを設定する
次の例は、Datastore モードの Firestore クライアントを初期化するときにロケーション エンドポイントを設定する方法を示しています。
Java
Datastore モードのクライアント ライブラリをインストールして使用する方法については、Datastore モードのクライアント ライブラリをご覧ください。 詳細については、Datastore モードの Java API のリファレンス ドキュメントをご覧ください。
Datastore モードへの認証を行うには、アプリケーションのデフォルト認証情報を設定します。 詳細については、ローカル開発環境の認証を設定するをご覧ください。
Python
Datastore モードのクライアント ライブラリをインストールして使用する方法については、Datastore モードのクライアント ライブラリをご覧ください。 詳細については、Datastore モードの Python API のリファレンス ドキュメントをご覧ください。
Datastore モードへの認証を行うには、アプリケーションのデフォルト認証情報を設定します。 詳細については、ローカル開発環境の認証を設定するをご覧ください。
ロケーション エンドポイントのセマンティクス
Datastore モードの Firestore は、リージョンとマルチリージョン ロケーションの両方のロケーション エンドポイントをサポートしています。
次の形式を使用して、位置情報エンドポイントを定義します。
Java
https://REGION_NAME-firestore.googleapis.com:443
完全な https
URL が使用され、エンドポイントとともにポート番号が定義されていることを確認します。
Python
https://REGION_NAME-firestore.googleapis.com
ロケーション エンドポイントとして、完全な https
URL が設定されていることを確認します。
Go
REGION_NAME-firestore.googleapis.com:443
エンドポイントとともにポート番号が定義されていることを確認します。
REGION_NAME は、リージョンまたはマルチリージョンのホスト名に置き換えます。
ホスト名の例を次に示します。
eur3-datastore.googleapis.com
nam5-datastore.googleapis.com
europe-west6-datastore.googleapis.com
asia-northeast2-datastore.googleapis.com
マルチリージョンとリージョンのホスト名の完全なリストについては、Datastore モードの Firestore のロケーションをご覧ください。
次のステップ
- Datastore モードの Firestore のデータモデルについて学習する。エンティティ、プロパティ、キーをご覧ください。
- Datastore モードの Firestore 用のベスト プラクティスを確認する。