通过区域端点配置数据本地化

本页面介绍了如何配置 Datastore 模式 Firestore 客户端库以使用区域或多区域端点。

使用 Datastore 模式 Firestore 客户端库时，您可以使用以下任一端点：

• 全局端点：默认情况下，Datastore 模式的 Firestore 客户端库会将 API 请求发送到名为 datastore.googleapis.com 的全局服务端点。全球服务端点会将请求路由到您的数据库。在路由过程中，请求可能会通过与数据库位置不同的位置中的服务器。

• 区域性端点：区域性端点会强制实施限制，以确保在指定 Google Cloud 区域传输、存储和处理数据。为确保服务端点在与数据库相同的区域中处理应用的 Datastore 模式 Firestore 请求，请在客户端库中指定区域端点。

• 多区域端点：多区域端点会实施限制，以确保在指定的 Google Cloud 多区域中传输、存储和处理数据。为确保服务端点在与数据库相同的多区域中处理应用的 Datastore 模式 Firestore 请求，请在客户端库中指定多区域端点。

设置区域级或多区域级端点

配置区域级或多区域级端点的方法相同：在初始化客户端库时提供端点字符串。以下示例展示了如何使用区域端点 (datastore.us-central1.rep.googleapis.com) 设置端点字符串。如需使用多区域端点，请提供与数据库位置对应的多区域端点字符串（例如，nam5 的端点字符串为 datastore.us.rep.googleapis.com）。

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://datastore.us-central1.rep.googleapis.com").build();
    Datastore datastore = options.getService();
    return datastore;
  }
}

from google.cloud import datastore
from google.api_core.client_options import ClientOptions

ENDPOINT = "https://datastore.africa-south1.rep.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)

区域性端点和多区域端点语义

区域端点 (REP)：

Datastore 模式的 Firestore 支持此处列出的单区域位置的单区域端点：Datastore 模式的 Firestore 位置。

请使用以下格式定义区域级端点：

    datastore.REGION_NAME.rep.googleapis.com:443

    datastore.REGION_NAME.rep.googleapis.com

    datastore.REGION_NAME.rep.googleapis.com:443

将 REGION_NAME 替换为区域主机名的名称。

以下是一些主机名示例：

• datastore.us-central1.rep.googleapis.com
• datastore.europe-west1.rep.googleapis.com

多区域端点 (MREP)

对于多区域端点，请使用 us 表示位置 nam5 和 nam7，使用 eu 表示位置 eur3（请参阅多区域位置）。

    datastore.us.rep.googleapis.com:443
    datastore.eu.rep.googleapis.com:443

    datastore.us.rep.googleapis.com
    datastore.eu.rep.googleapis.com

    datastore.us.rep.googleapis.com:443
    datastore.eu.rep.googleapis.com:443

位置端点（已弃用）

位置端点现已弃用。请改用区域级或多区域级端点。

Datastore 模式 Firestore 之前支持以下格式的位置端点：

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

  https://REGION_NAME-datastore.googleapis.com

  REGION_NAME-datastore.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 位置。

限制全球 API 端点用量

为了帮助强制使用区域端点和多区域端点，请使用 constraints/gcp.restrictEndpointUsage 组织政策限制条件来阻止对全球 API 端点的请求。如需了解详情，请参阅限制端点用量。

后续步骤

• 了解 Datastore 模式下的 Firestore 数据模型。请参阅实体、属性和键。
• 请参阅 Datastore 模式 Firestore 的最佳实践。