65.9K
CodeProject 正在变化。 阅读更多。
Home

Google Cloud Datastore - 注册

Google Cloud Platform
emptyStarIconemptyStarIconemptyStarIconemptyStarIconemptyStarIcon

0/5 (0投票)

2014 年 12 月 1 日

CC (Attr 3U)

8分钟阅读

viewsIcon

8215

本文档介绍了如何激活 Google Cloud Datastore API、此 API 的相关配额以及如何启用结算。激活过程因您现有的设置和环境而异。

这是 Cloud Datastore HTTP API 的预览版本。因此，API 可能会发生变更，并且该服务本身目前不包含在任何 SLA 或弃用策略中。随着 API 和服务朝着通用可用性发展，这些特性将得到评估，但开发者在使用 Cloud Datastore HTTP API 的预览版本时应将这一点考虑在内。

  1. 限制
  2. 从 Compute Engine 实例访问 Datastore API
  3. 从其他平台访问 Datastore API
  4. 从 Compute Engine 实例访问现有的 App Engine Datastore
  5. 从其他平台访问现有的 App Engine Datastore
  6. 配额和结算
    1. 配额
    2. 结算

本文档介绍了如何激活 Google Cloud Datastore API、此 API 的相关配额以及如何启用结算。激活过程因您现有的设置和环境而异。

注意：在激活过程中，您将为您的项目创建一个 Cloud 项目 ID。此 ID 值用作数据集 ID。数据集 ID 用于标识您项目使用的 Cloud Datastore 存储。

限制

Cloud Datastore 不适用于使用旧版 Google API Console 创建的项目。因此，如果您有现有的 API 项目，则需要在此 Google Developers Console 中创建一个新项目才能使用 Cloud Datastore API。

当您在全新的 Google Developers Console 项目中激活 Cloud Datastore API 时，会部署一个特殊的内置版本，并将其设为默认版本。如果您随后将 App Engine 应用部署到该项目，Cloud Datastore 内置版本将继续作为默认版本，因此您应用的请求将被发送到 Cloud Datastore 内置版本。您可以使用 Admin Console 手动将您的应用设置为默认版本。

从 Compute Engine 实例访问 Datastore API

本节介绍如何在新的或现有的 Cloud 项目中，从 Compute Engine VM 实例激活并访问 Google Cloud Datastore API。

  1. 使用 Datastore API 激活向导 激活 Datastore API。该向导允许您为一个现有项目激活 API，或创建一个新项目并为其激活 API。
  2. 使用 Google Compute Engine 激活向导 激活您在上一步中选择或创建的项目所对应的 Google Compute Engine API。
  3. 在我的项目 > 结算和设置下为项目启用结算。
  4. 如果您尚未执行此操作，请 安装 gcloud compute 并将其 认证到 Google Compute Engine。

  5. 按照 Google Compute Engine 文档中 启动实例的说明，添加一个 Google Compute Engine 实例并启动它。除了项目 ID 和实例名称外，您还必须同时指定 datastore 和 userinfo.email 范围，如下所示。

    $ PROJECT_ID=<project-id>        # replace <project-id> with the Project ID you created previously.
$ INSTANCE_NAME=<instance-name>  # replace <instance-name> with the name you want to use for your instance.
$ gcloud compute instances create $INSTANCE_NAME --project $PROJECT_ID --scopes datastore userinfo-email

  6. 确认您的 实例正在运行。

  7. 要使用此新的 Compute Engine 实例，请使用 ssh 连接到它。

此时，您的项目已配置好所有服务和授权，您可以开始 编写代码或 探索 API。

从其他平台访问 Datastore API

本节介绍如何从运行在 Google Cloud 外部的平台上的外部应用程序激活并访问 Google Cloud Datastore API。

  1. 使用 Datastore API 激活向导 激活 Datastore API。该向导允许您为一个现有项目激活 API，或创建一个新项目并为其激活 API。
  2. 在左侧边栏的API 和身份验证下，选择凭据。
  3. 点击创建新的 Client ID。
  4. 选择服务账号，然后点击创建 Client ID。您的浏览器将下载私钥。
  5. 您的服务账号是服务账号部分下显示的电子邮件地址。
  6. 您的私钥是您刚刚下载的文件。
  7. 您的数据集 ID 是您新的或现有的 Cloud项目 ID。

此时，您的项目已配置好所有服务和授权，您可以开始 编写代码或 探索 API。

从 Compute Engine 实例访问现有的 App Engine Datastore

本节介绍如何从运行在 Compute Engine 实例上的现有 App Engine Datastore 激活并访问它。此场景侧重于希望在现有的 App Engine 应用程序和 Compute Engine 实例之间共享数据的用户。

  1. 访问 App Engine 管理控制台。
  2. 选择应为其启用 Google Cloud Datastore API 的应用程序 ID。
  3. 在左侧边栏中，点击应用程序设置。

  4. 在基本设置部分，找到Google API Console 项目号并点击它，进入包含 App Engine 应用程序的项目仪表板。

    注意：新的 App Engine 应用程序会自动创建 Cloud 项目，如果您的 App Engine 应用需要与其他 Cloud 产品配合使用或使用其他 Google API，则这是必需的。然而，较旧的传统 App Engine 应用程序没有创建 Cloud 项目。如果您的应用程序没有关联的项目，请按照 我如何为 App Engine 创建 Cloud 项目 中的说明创建一个（并填充Google API Console 项目号字段）。

  5. 使用 Datastore API 激活向导 为包含 App Engine 应用程序的项目激活 Datastore API。

  6. 使用 Google Compute Engine 激活向导 为该项目激活 Google Compute Engine API。
  7. 在我的项目 > 结算和设置下，检查是否已为项目启用结算。
  8. 如果您尚未执行此操作，请 安装 gcloud compute 并将其 认证到 Google Compute Engine。

  9. 按照 Google Compute Engine 文档中 启动实例的说明，添加一个 Google Compute Engine 实例并启动它。除了项目 ID 和实例名称外，您还必须同时指定 datastore 和 userinfo.email 范围，如下所示。

    $ PROJECT_ID=<project-id>        # replace <project-id> with the Project ID you created previously.
$ INSTANCE_NAME=<instance-name>  # replace <instance-name> with the name you want to use for your instance.
$ gcloud compute instances create $INSTANCE_NAME --project $PROJECT_ID --scopes datastore userinfo-email

  10. 确认您的 实例正在运行。

  11. 要使用此新的 Compute Engine 实例，请使用 ssh 连接到它。
  12. 您的数据集 ID 与您的 App Engine应用程序 ID 相同。

此时，您的项目已配置好所有服务和授权，您可以开始 编写代码或 探索 API。

从其他平台访问现有的 App Engine Datastore

本节介绍如何从运行在 Google Cloud 外部的平台上的外部应用程序激活并访问现有的 App Engine Datastore。

  1. 访问 App Engine 管理控制台。
  2. 选择应为其启用 Google Cloud Datastore API 的应用程序 ID。
  3. 在左侧边栏中，点击应用程序设置。

  4. 在基本设置部分，找到Google API Console 项目号并点击它，进入包含 App Engine 应用程序的项目仪表板。

    注意：新的 App Engine 应用程序会自动创建 Cloud 项目，如果您的 App Engine 应用需要与其他 Cloud 产品配合使用或使用其他 Google API，则这是必需的。然而，较旧的传统 App Engine 应用程序没有创建 Cloud 项目。如果您的应用程序没有关联的项目，请按照 我如何为 App Engine 创建 Cloud 项目 中的说明创建一个（并填充Google API Console 项目号字段）。

  5. 使用 Datastore API 激活向导 为包含 App Engine 应用程序的项目激活 Datastore API。

  6. 在我的项目 > 结算和设置下，检查是否已为项目启用结算。
  7. 在左侧边栏的API 和身份验证下，选择凭据。
  8. 点击创建新的 Client ID。
  9. 选择服务账号，然后点击创建 Client ID。您的浏览器将下载私钥。
  10. 您的服务账号是服务账号部分下显示的电子邮件地址。
  11. 您的私钥是您刚刚下载的文件。
  12. 您的数据集 ID 是您的 App Engine应用程序 ID。

此时，您的项目已配置好所有服务和授权，您可以开始 编写代码或 探索 API。

配额和结算

配额

Cloud Datastore 提供免费配额，让开发者可以免费开始使用。下面列出了资源和免费配额。当需要更多配额时，开发者需要启用结算。配额按天计算，并在太平洋时间午夜前后重置。

总限制

请注意，存储在 datastore 中的数据可能会产生显著的开销。此开销取决于相关属性的数量和类型，包括内置和自定义索引使用的空间。存储在 datastore 中的每个实体都需要以下元数据：

  • 实体键，包括种类、ID 或键名以及实体的祖先键。
  • 每个属性的名称和值。由于 datastore 是无模式的，因此对于任何给定实体，必须将每个属性的名称与属性值一起存储。
  • 任何引用此实体的内置和自定义索引行。每行包含实体种类、根据索引定义数量不定的属性值以及实体键。

有关存储实体和索引所需元数据的完整细分（在 Bigtable 级别）以及 datastore 索引管理方式的详细说明，请参阅 实体和索引的存储方式 和 索引构建的工作原理。

Resource 免费默认每日限额 已启用结算的默认限额
存储数据（可计费） 1 GB* 免费 1 GB；无上限
索引数量 200* 200
写入操作 50,000 每天 1000 万次**
读取操作 50,000 每天 1000 万次**
小型操作 50,000 每天 1000 万次**
*不是每日限额，而是总限额。
**已启用结算的限额仅适用于预览版。如果您预计在此服务预览期间会超出这些限额，请 申请增加配额。

结算

为了获得更高的配额，您需要启用结算。操作方法如下：

  • 导航到 Google Developers Console。
  • 选择应启用结算的项目
  • 选择Cloud Datastore 并按照左下角的说明进行操作。

Google Cloud Datastore 的使用和结算目前是 App Engine 结算系统的一部分。此设置仅用于预览版。未来，Google Cloud Datastore 将使用自己的 SKU 单独计费，与 App Engine 分开。

除非另有说明，本页的代码示例根据 Apache 2.0 许可证 授权。

© . All rights reserved.