查询数据库

您的网络钩子目前在 accountBalanceCheck 函数中使用硬编码数据。在本教程的这一步,您将创建一个 Spanner 数据库,在其中填充余额数据,并更新函数以查询该数据库。

项目配置

请务必确保您的 Dialogflow 代理和数据库位于同一项目中。 要让函数安全访问数据库,这是最简单的方法。此外,您还必须启用 Spanner API。

  1. 在创建数据库之前,请先从 Google Cloud 控制台中选择您的项目。

    转到“项目选择器”

  2. 为项目启用 Spanner API。

    启用 Spanner API

创建 Spanner 实例

首次使用 Spanner 时,您必须创建一个实例,用于分配该实例中 Spanner 数据库所使用的资源。

  1. 在 Google Cloud 控制台中,前往 Spanner 实例页面。

    转到 Spanner 实例

  2. 点击创建实例

  3. 输入 Tutorial Instance 作为实例名称。

  4. 系统会根据实例名称自动输入实例 ID。

  5. 选择您的配置中,保留默认选项 Regional,并选择您在创建函数时选择的同一区域位置

  6. 分配计算容量中,输入 100 个处理单元。这为本教程提供了最小容量。

  7. 点击创建。Google Cloud 控制台会显示您创建的实例的概览页面。

创建 Spanner 数据库

现在您已经有了实例,需要创建一个数据库。 如需创建数据库,请执行以下操作:

  1. 在实例概览页面中,点击创建数据库
  2. 输入 tutorial-database 作为数据库名称。
  3. 选择 Google 标准 SQL 数据库方言。
  4. 点击创建。Google Cloud 控制台会显示您创建的数据库的概览页面。

为数据库创建表

现在您已经有了数据库,接下来需要为该数据库创建表。 如需创建表,请执行以下操作:

  1. 在数据库概览页面的“表”部分中,点击创建表
  2. 编写 DDL 语句页面中,输入以下内容:

    CREATE TABLE Checking (
      AccountId INT64,
      Balance INT64,
    ) PRIMARY KEY(AccountId);
    
  3. 点击提交。 Google Cloud 控制台会返回数据库概览页面,并显示正在进行架构更新。等待更新完成。

  4. 在数据库概览页面的“表”部分中,点击创建表

  5. 编写 DDL 语句页面中,输入以下内容:

    CREATE TABLE Savings (
      AccountId INT64,
      Balance INT64,
    ) PRIMARY KEY(AccountId);
    
  6. 点击提交。 Google Cloud 控制台会返回数据库概览页面,并显示正在进行架构更新。等待更新完成。

将数据插入表格中

现在您的数据库已包含表,您需要向这些表添加数据。 要添加数据,请执行以下操作:

  1. 在数据库概览页面上的表列表中,点击“正在检查”表。Google Cloud 控制台会显示该表的架构页面。
  2. 在左侧导航菜单中,点击数据以显示表的数据页面。
  3. 点击插入。 Google Cloud 控制台会显示该表的查询页面,其中包含一个新的查询标签页,其中包含 INSERTSELECT 语句。用以下内容覆盖这些语句:

    INSERT INTO Checking (AccountId, Balance)
    VALUES(1, 1000),
          (2, 2000);
    
  4. 点击运行

  5. 在左侧导航菜单中,再次点击数据以显示表的数据。确认该表包含所需的数据。

  6. 点击 tutorial-database:概览链接以返回到数据库概览页面。

  7. 在数据库概览页面上的表列表中,点击“节省的金额”表。Google Cloud 控制台会显示该表的架构页面。

  8. 在左侧导航菜单中,点击数据以显示表的数据页面。

  9. 点击插入。 Google Cloud 控制台会显示该表的查询页面,其中包含一个新的查询标签页,其中包含 INSERTSELECT 语句。用以下内容覆盖这些语句:

    INSERT INTO Savings (AccountId, Balance)
    VALUES(1, 10000),
          (2, 20000);
    
  10. 点击运行

  11. 在左侧导航菜单中,再次点击数据以显示表的数据。确认该表包含所需的数据。

更新 Cloud Function 以查询数据库

webhook 代码中的 accountBalanceCheck 函数会检查特定环境变量是否设置了用于连接到数据库的信息。如果未设置这些环境变量,则该函数会使用硬编码帐号余额。

现在您已设置数据库,请更新 Cloud Functions 函数以设置所需的环境变量:

  1. 打开 Cloud Functions 概览页面。

    转到 Cloud Functions 概览

  2. 点击 tutorial-banking-webhook 函数以转到其详情页面。

  3. 点击修改

  4. 打开运行时、构建和连接设置部分。

  5. 选择运行时标签页。

  6. 在“运行时环境变量”部分中添加以下变量:

    • PROJECT_ID:您的项目 ID
    • SPANNER_INSTANCE_ID:您的 Spanner 实例 ID(可能是 tutorial-instance
    • SPANNER_DATABASE_ID:您的 Spanner 数据库 ID(可能是 tutorial-database
  7. 点击下一步

  8. 点击部署

  9. 等待状态指示器显示函数已成功部署。

测试代理

您的代理现在已准备就绪,可以试用了。点击 Dialogflow 控制台中的测试代理 (Test Agent) 按钮以打开模拟器。 尝试与客服人员进行以下对话:

回合 代理
1 您好 您好!感谢您选择 ACME Bank。
2 我想知道我的帐号余额 您想将余额存入哪个账户:储蓄账户还是支票账户?
3 正在检查 您的最新余额为:10.00 美元

如果您检查代码,您会发现 $10 不是硬编码值。 这意味着,您的 webhook 已成功连接到数据库,该数据库有余额 10 美元。

问题排查

webhook 代码包含日志记录语句。如果您遇到问题,请尝试查看 Cloud Function 的日志

如果您的函数未连接到数据库,并且您在日志中看到权限错误,则可能需要修复函数使用的默认服务帐号的角色。此服务帐号的格式为 PROJECT_ID@appspot.gserviceaccount.com。您可以通过以下任一方式来解决此问题:

更多信息

如需详细了解上述步骤,请参阅: