使用位置端點設定資料區域

本頁說明如何設定 Firestore (Datastore 模式) 用戶端程式庫，以使用區域端點。

使用 Datastore 模式的 Firestore 用戶端程式庫時，您可以選擇下列任一端點：

  • 全域端點：根據預設，Datastore 模式下的 Firestore 用戶端程式庫會將 API 要求傳送至名為 datastore.googleapis.com 的全域服務端點。全域服務端點會將要求轉送至資料庫。在路由期間，要求可能會通過與資料庫位置不同的位置中的位置服務端點。

  • 位置端點：位置端點會強制執行地區限制，確保資料儲存及處理作業在指定地區進行。 如要確保服務端點在與資料庫相同的區域中處理應用程式的 Firestore (Datastore 模式) 請求，請在用戶端程式庫中指定位置端點。

設定位置端點

以下範例說明如何初始化 Firestore (Datastore 模式) 用戶端時，設定位置端點。

Java

如要瞭解如何安裝及使用 Datastore 模式的用戶端程式庫，請參閱這篇文章。 詳情請參閱 Datastore 模式 Java API 參考說明文件。

如要驗證 Datastore 模式，請設定應用程式預設憑證。 詳情請參閱「為本機開發環境設定驗證」。


import com.google.cloud.datastore.Datastore;
import com.google.cloud.datastore.DatastoreOptions;

public class RegionalEndpoint {

  public Datastore createClient() throws Exception {
    // Instantiates a client
    DatastoreOptions options =
        DatastoreOptions.newBuilder().setHost("https://nam5-datastore.googleapis.com").build();
    Datastore datastore = options.getService();
    return datastore;
  }
}

Python

如要瞭解如何安裝及使用 Datastore 模式的用戶端程式庫，請參閱這篇文章。 詳情請參閱 Datastore 模式 Python API 參考說明文件。

如要驗證 Datastore 模式，請設定應用程式預設憑證。 詳情請參閱「為本機開發環境設定驗證」。

ENDPOINT = "https://eur3-datastore.googleapis.com"
client_options = ClientOptions(api_endpoint=ENDPOINT)
client = datastore.Client(client_options=client_options)

query = client.query(kind="Task")
results = list(query.fetch())
for r in results:
    print(r)

位置端點語意

Firestore (Datastore 模式) 支援區域和多區域位置的端點。

請使用下列格式定義地點端點：

Java

  https://REGION_NAME-firestore.googleapis.com:443

請務必使用完整的 https 網址，並定義端點和通訊埠編號。

Python

  https://REGION_NAME-firestore.googleapis.com

請務必將完整的 https 網址設為位置端點。

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

如需多區域和區域主機名稱的完整清單，請參閱「Firestore (Datastore 模式) 位置」。

後續步驟