适用于旧版捆绑服务的 Namespaces API

借助 Google App Engine 中的 Namespaces API，您可以轻松地划分 Google App Engine 数据。此 API 通过 appengine.Namespace 函数实现，并已整合到某些支持命名空间的 API 中。

当您在命名空间管理器中设置命名空间时，这些 API 将获取当前命名空间，并在全局范围内使用该命名空间。您可以在本地显式声明命名空间，但在显式声明命名空间时要特别小心，因为您可能无意中造成数据泄露和其他错误。任何 App Engine 请求都可以访问任何命名空间，应用程序应在命名空间中强制实施访问控制策略。

您可以使用 Namespace API 构建各种不同的应用。此 API 的最突出用途之一是构建多租户应用，如下所述。

多租户简介

多租户指的是一种软件架构；在此架构中，远程服务器上运行的一个应用实例为多个客户组织（也称为租户）提供服务。

使用多租户架构可以简化租户管理和预配。您可以提供更精简的自定义用户体验，还可在单个数据库架构中聚合不同的数据孤岛。因此，您的应用将更具可调节性，并且在调节时成本效益更高。由于所有租户都使用相同的数据库架构，因此可以更方便地跨租户拆分和分析数据。不同的用户组将看到在更高效应用中包装的自定义内容。

使用 Namespace API 构建多租户应用

使用 Namespaces API，您只需为每个租户指定唯一的命名空间字符串，即可轻松在租户之间对数据进行分区。您只需使用命名空间管理器为每个租户全局设置命名空间（而不是针对特定请求明确设置命名空间）。默认情况下，支持命名空间的 API 始终使用此当前命名空间。

Namespaces API 与 Google Workspace 集成，这样您就可以将 Google Workspace 网域用作当前命名空间。由于 Google Workspace 可让您将应用部署到您拥有的任何网域，因此您可以轻松为与 Google Workspace 账号关联的所有网域设置独一无二的命名空间。

在设计多租户应用时，您需要防止命名空间中发生数据泄露。如需了解详情，请参阅避免数据泄露。

使用命名空间的 App Engine API

App Engine 目前在以下 API 中支持命名空间：

使用命名空间的示例项目

系统提供了两个使用命名空间的示例留言板应用：

Namespace API 的其他用途

除了在 App Engine 中启用多租户以外，Namespace API 还具有多种其他用途，包括：

  • 划分用户信息
  • 将管理数据与应用数据分离
  • 为测试和生产创建单独的数据存储区实例
  • 在单个 App Engine 实例中运行多个应用