了解项目中的产品和资源的位置

需要设置位置信息的产品或资源

多个产品或资源需要设置位置信息。

产品 默认位置 其他信息
Google Analytics 没有默认位置。
您必须设置此位置。
此位置是 Analytics 报告位置2,代表您组织所在的国家/地区。Analytics 报告位置会决定收入报告所采用的币种。
Firebase App Hosting 没有默认位置。
您必须为每个后端设置此位置。
此位置是 App Hosting 部署创建每个后端资源的位置。
每个后端都可以位于不同的位置。
Data Connect 没有默认位置。
您必须为每个实例设置位置。
每个实例都可以位于不同的位置。
Cloud Firestore 1 没有默认位置。
您必须为每个实例设置位置。
每个实例都可以位于不同的位置。
Realtime Database 没有默认位置。
您必须为每个实例设置位置。
每个实例都可以位于不同的位置。
Cloud Storage for Firebase 1 没有默认位置。
您必须为每个存储桶设置位置。
每个存储桶都可以位于不同的位置。
Cloud Functions for Firebase 1 如果未设置位置,则默认区域为 us-central1 每个函数都可以位于不同的位置。
Vertex AI in Firebase 如果未设置位置,则默认区域为 us-central1 此位置是运行 Vertex AI 服务以及您访问模型的位置。

1 这些产品之间可能存在位置依赖项,具体取决于您在项目中首次开始使用这些产品的时间。您可能会看到此依赖项被称为“默认 Google Cloud 资源的位置”。详细了解此位置依赖项

2 您的 Analytics 报告位置不会影响 Google 处理及存储 Firebase 客户数据的位置,

为产品或其资源设置位置

对于某些产品,您可以在产品级别设置位置。不过,对于大多数产品,您需要在资源级别设置位置(例如,为每个 Cloud Storage 存储桶或每个函数设置位置)。

产品 何时以及如何设置位置 可用位置
Google Analytics 如果通过 Firebase 控制台为 Firebase 项目启用 Google Analytics,系统会提示您选择 Analytics 报告位置。您应选择代表您组织所在位置的国家/地区。

如果您的角色为项目 Owner 或 Editor,则可以修改 Analytics 报告位置的时区和币种;前往您的 Google Analytics 设置,然后前往“报告”窗格。

请参阅 Google Analytics 设置 > 报告窗格中的列表。
App Hosting 创建 App Hosting 后端时,系统会提示您选择一个位置。您可以使用 Firebase 控制台、REST API 或 Firebase CLI 创建后端。 App Hosting 位置
Data Connect 预配 Data Connect 服务实例时,您需要设置其位置。您还需要设置关联 Google Cloud SQL 实例的位置。
您可以使用 Firebase 控制台或 Firebase CLI 来预配实例。
Data Connect 服务和 Cloud SQL 实例位置
Cloud Firestore 1 预配 Cloud Firestore 数据库实例时,您需要设置其位置。您可以使用 Firebase 控制台、REST API、Firebase CLI 或 Terraform 来预配实例。 Cloud Firestore 位置
Realtime Database 预配 Realtime Database 实例时,您需要设置其位置。
您可以使用 Firebase 控制台、REST API、Firebase CLI 或 Terraform 来预配实例。
Realtime Database 位置
Cloud Storage for Firebase 1 预配 Cloud Storage 存储桶时,您需要设置其位置。
您可以使用 Firebase 控制台、REST API 或 Terraform 来配置存储桶。
Cloud Storage for Firebase 位置
Cloud Functions for Firebase 1 编写函数时,您可以选择设置其区域。

如果您未指定位置,则默认区域为 us-central1

Cloud Functions for Firebase 位置
Vertex AI in Firebase 在代码库中初始化 Vertex AI 服务和生成模型时,您可以选择指定位置。

如果您未指定位置,则默认区域为 us-central1

Vertex AI in Firebase 位置

1 这些产品之间可能存在位置依赖项,具体取决于您在项目中首次开始使用这些产品的时间。您可能会看到此依赖项被称为“默认 Google Cloud 资源的位置”。详细了解此位置依赖项

查看位置信息设置

产品 在哪里查看位置信息设置
Google Analytics Firebase 控制台中,前往“设置”“项目设置”>“集成”>Google Analytics。点击账号以打开您的 Google Analytics 账号,然后前往管理面板,查找您的账号的位置信息。
Data Connect Firebase 控制台中,前往 Data Connect 页面,查看数据库实例及其位置的列表。
App Hosting
  • Firebase 控制台中,前往 App Hosting 页面,查看后端及其位置的列表。
  • 如需查看特定后端的位置,您可以使用 Firebase CLI 命令 firebase apphosting:backends:get --project PROJECT_ID BACKEND_ID
Cloud Firestore Firebase 控制台中,前往 Cloud Firestore“数据”标签页,查看数据库实例及其位置的列表。
Realtime Database Firebase 控制台中,前往 Realtime Database“数据”标签页,查看数据库实例及其位置的列表。
Cloud Storage for Firebase Firebase 控制台中,转到Cloud Storage“文件”标签页,查看存储桶及其位置的列表。
Cloud Functions for Firebase
  • Google Cloud预定函数 - 在 Cloud Scheduler 控制台中,前往 以查看每个作业和函数的主题列表。位置是主题名称中的最后一个部分。
  • 非预定函数:在函数的源代码中,查找 region 参数。如果未指定区域,则默认位置为 us-central1
Vertex AI in Firebase 在您的代码库中,查找 Vertex AI 服务和生成模型的初始化。如果未指定位置,则默认位置为 us-central1

由于“默认 Google Cloud 资源的位置”而可能存在的位置依赖关系

“默认 Google Cloud 资源的位置”是指与 Google App Engine 关联的所有项目资源的位置设置,包括以下内容:

  • 默认的 Cloud Firestore 数据库实例
  • Firebase 存储桶的默认 Cloud Storage,其名称格式为 *.appspot.com
  • Google Cloud Scheduler,专门用于第 1 代预定函数

此“默认 Google Cloud 资源的位置”设置不可更改。此外,当您为某个关联资源设置位置时,由于这些关联资源与 App Engine 共同关联,您会间接地为所有资源设置位置。

不过,Firebase 和 Google Cloud 生态系统在过去几年发生了许多变化,资源与 App Engine 的关联也随之不断发生变化。最值得注意的是,从 2024 年 10 月 30 日开始,所有新配置的 Firebase 存储桶的默认 Cloud Storage 的名称格式都为 *.firebasestorage.app,并且App Engine 相关联。

以下是可能的位置依赖项中发生变化的详细信息:

  • 2024 年 10 月 30 日开始,如果默认 Cloud Firestore 实例和 Firebase 存储桶的默认 Cloud Storage 尚未配置,则

    • 预配默认的 Cloud Firestore 实例会为项目中日后预配的任何 App Engine 应用设置位置。不过,它不会决定未来默认 Cloud Storage 存储桶的位置。

    • 配置默认的 Cloud Storage 存储桶不再会配置 App Engine 应用。因此,默认 Cloud Storage 存储桶的位置不会决定未来默认 Cloud Firestore 实例的位置。

  • 2024 年 10 月 30 日开始,如果默认 Cloud Firestore 实例配置,但 Firebase 存储桶的默认 Cloud Storage 尚未配置

    • 现有的默认 Cloud Firestore 实例不会决定未来默认 Cloud Storage 存储桶的位置 (*.firebasestorage.app)。
  • 2024 年 10 月 30 日开始,如果 Firebase 存储桶的默认 Cloud Storage 配置(具体而言,是 *.appspot.com 存储桶),但默认 Cloud Firestore 实例配置

    • 在配置默认 Cloud Storage 存储桶 (*.appspot.com) 时,配置了 App Engine 应用,因此当时就设置了未来默认 Cloud Firestore 实例的位置。即使您删除了 *.appspot.com 存储桶,也无法删除 App Engine 应用,因此未来默认 Cloud Firestore 实例的位置设置已设置。

如果您使用的是第 1 代预定函数,则其位置会设置为默认 Google Cloud 资源的位置。这是因为 Cloud SchedulerApp Engine 之前相互关联。此外,如果您在预配共用此位置信息设置的其他资源之前设置了第 1 代预定函数,那么您也需要设置其位置信息。

后续步骤

  • 如需详细了解如何构建应用以满足您的延迟、可用性和耐用性要求,请参阅地理位置和区域