このページは Cloud Translation API によって翻訳されました。

データベースに対してクエリを実行する

Webhook は現在、accountBalanceCheck 関数でハードコードされたデータを使用しています。チュートリアルのこのステップでは、Spanner データベースを作成し、対象となる宛先を入力して、データベースをクエリするように関数を更新します。

プロジェクトの構成

Dialogflow エージェントとデータベースの両方が同じプロジェクト内にあることが重要です。これは関数がデータベースに安全にアクセスできるようにするための最も簡単な方法です。また、Spanner API を有効にする必要があります。

データベースを作成する前に、Google Cloud コンソールからプロジェクトを選択します。

プロジェクトセレクタに移動
プロジェクトに対して Spanner API を有効化します

Spanner API を有効にする

Spanner インスタンスの作成

Spanner を初めて使用するときは、インスタンスを作成する必要があります。これにより、そのインスタンスの Spanner データベースによって使用されるリソースが割り当てられます。

Google Cloud コンソールで、[Spanner インスタンス] ページに移動します。

Spanner インスタンスに移動
[インスタンスを作成] をクリックします。
インスタンス名として、チュートリアルインスタンスと入力します。
インスタンス ID は、インスタンス名に基づいて自動的に入力されます。
[構成を選択] で、デフォルトのオプション [リージョン] を保持し、関数の作成時に選択した同じリージョンのロケーションを選択します。
[コンピューティング容量の割り当て] に、100 処理ユニットを入力します。これにより、チュートリアル用の容量が最小限になります。
[作成] をクリックします。Google Cloud コンソールに、作成したインスタンスの [概要] ページが表示されます。

Spanner データベースの作成

これでインスタンスが作成されたため、データベースを作成する必要があります。データベースを作成するには、次のようにします。

インスタンス概要ページで、データベースを作成 をクリックします。
データベース名に「tutorial-database」と入力します。
[Google 標準 SQL] データベースの言語を選択します。
[作成] をクリックします。Google Cloud コンソールに、作成したデータベースの [概要] ページが表示されます。

データベース用のテーブルを作成する

データベースが作成されたため、データベースのテーブルを作成する必要があります。テーブルを作成するには、次の手順を行います。

データベースの [概要] ページの [テーブル] セクションで、[テーブルを作成] をクリックします

[DDL ステートメントの記述] ページで、次のように入力します。

CREATE TABLE Checking (
  AccountId INT64,
  Balance INT64,
) PRIMARY KEY(AccountId);

[送信] をクリックします。 Google Cloud コンソールがデータベースの [概要] ページに戻り、[スキーマの更新] が進行中であることが表示されます。更新が完了するまで待ちます。
データベースの [概要] ページの [テーブル] セクションで、[テーブルを作成] をクリックします

[DDL ステートメントの記述] ページで、次のように入力します。

CREATE TABLE Savings (
  AccountId INT64,
  Balance INT64,
) PRIMARY KEY(AccountId);

[送信] をクリックします。 Google Cloud コンソールがデータベースの [概要] ページに戻り、[スキーマの更新] が進行中であることが表示されます。更新が完了するまで待ちます。

テーブルにデータを挿入する

データベースにテーブルが作成されたため、テーブルにデータを追加する必要があります。データを追加するには:

データベースの [概要] ページのテーブルで、Checking テーブルをクリックします。Google Cloud コンソールで、テーブルの [スキーマ] ページが表示されます。
左側のナビゲーション・メニューで、[データ] をクリックしてテーブルの [データ] ページを表示します。
[挿入] をクリックします。 Google Cloud コンソールで、テーブルの [クエリ] ページが開き、INSERT ステートメントと SELECT ステートメントを含む新しいクエリタブが表示されます。これらのステートメントを次のように上書きします。
```
INSERT INTO Checking (AccountId, Balance)
VALUES(1, 1000),
      (2, 2000);
```
[実行] をクリックします。
左側のナビゲーションメニューで、[データ] をもう一度クリックしてテーブルのデータを表示します。テーブルに目的のデータが含まれていることを確認します。
tutorial-database: 概要 リンクをクリックして、データベースの概要ページに戻ります。
データベースの [概要] ページのテーブルで、Savings テーブルをクリックします。Google Cloud コンソールで、テーブルの [スキーマ] ページが表示されます。
左側のナビゲーション・メニューで、[データ] をクリックしてテーブルの [データ] ページを表示します。
[挿入] をクリックします。 Google Cloud コンソールで、テーブルの [クエリ] ページが開き、INSERT ステートメントと SELECT ステートメントを含む新しいクエリタブが表示されます。これらのステートメントを次のように上書きします。
```
INSERT INTO Savings (AccountId, Balance)
VALUES(1, 10000),
      (2, 20000);
```
[実行] をクリックします。
左側のナビゲーションメニューで、[データ] をもう一度クリックして、テーブルのデータを表示します。テーブルに目的のデータが含まれていることを確認します。

データベースをクエリするように Cloud Functions の関数を更新する

Webhook コードの accountBalanceCheck 関数は、データベースに接続するための情報が特定の環境変数に設定されているかどうかを確認します。これらの環境変数が設定されていない場合、関数はハードコードされたアカウント残高を使用します。

データベースが設定されたので、Cloud Functions を更新して必要な環境変数を設定します。

Cloud Functions の概要ページを開きます。

Cloud Functions の概要に移動
tutorial-banking-webhook 関数をクリックして、関数の詳細ページに移動します。
[編集] をクリックします。
[ランタイム、ビルド、接続の設定] セクションを開きます。
[ランタイム] タブを選択します。
[ランタイム環境変数] セクションに次の変数を追加します。
- PROJECT_ID: プロジェクト ID
- SPANNER_INSTANCE_ID: Spanner インスタンス ID（tutorial-instance であると考えられます）
- SPANNER_DATABASE_ID: Spanner データベース ID（tutorial-database であると考えられます）
[次へ] をクリックします。
[デプロイ] をクリックします。
ステータスインジケーターが関数が正常にデプロイされたことを示すまで待ちます。

エージェントをテスト

エージェントを試す準備が整いました。Dialogflow コンソールで [Test Agent] ボタンをクリックして、シミュレータを開きます。エージェントとの次の会話を試行します。

会話ターン	受講者	エージェント
1	こんにちは	ACME 銀行をご利用いただきありがとうございます。
2	アカウントの残高を知りたいです	普通預金と当座預金、どちらの口座の残高をご希望ですか？
3	当座	最新の残高は $10.00 です。

コードを調べると、$10 はハードコードされた値ではありません。これは、残高が $10 であるデータベースに Webhook が正常に接続されたことを表します。

トラブルシューティング

Webhook コードにロギングステートメントが含まれています。問題が発生した場合は、Cloud Functions のログを表示してみてください。

関数がデータベースに接続しておらず、ログに権限エラーが表示される場合は、関数で使用されるデフォルトのサービスアカウントのロールを確認する必要があります。このサービスアカウントの形式は PROJECT_ID@appspot.gserviceaccount.com です。これは、次のいずれかの方法で修正できます。

デフォルトのサービスアカウントが IAM メインページに表示されている場合は、サービスアカウントの権限を変更します。編集者のロールは機能しますが、本番環境ではより詳細なロールが必要となる場合があります。

IAM メインページに移動
IAM のメインページにデフォルトのサービスアカウントが表示されない場合は、サービスアカウントを新しいプリンシパルとして追加して、必要なロールを付与します。
または、作成したサービスアカウントを使用することもできます。

詳細情報

上述の手順の詳細については、以下をご覧ください。

Webhook サービスを作成する

エージェントをホストする