データに対するクエリを実行する

Google Cloud Data Agent Kit IDE 拡張機能の統合 SQL エディタを使用すると、IDE から直接 Google Cloud データに対して SQL クエリを実行できます。

サポートされているコーディング エージェントで Data Agent Kit プラグインを使用している場合は、エージェントで SQL クエリを実行したり、自然言語プロンプトを使用して SQL クエリを生成したりできます。

サポートされるデータソース

Data Agent Kit を使用すると、次のGoogle Cloud データ サービスでテーブルとビューに対してクエリを実行できます。

  • BigQuery
  • Bigtable
  • Spanner
  • AlloyDB for PostgreSQL
  • Cloud SQL for MySQL
  • Cloud SQL for PostgreSQL

Cloud SQL では、Identity and Access Management（IAM）データベース認証と組み込みのデータベース認証（パスワードが Secret Manager のリージョン シークレットとして保存されている）を使用するクエリがサポートされています。Cloud SQL が Secret Manager を使用して組み込みユーザーを認証する方法の詳細については、Cloud SQL for MySQL と Cloud SQL for PostgreSQL の Data API を使用して SQL ステートメントを実行するをご覧ください。AlloyDB では、IAM データベース認証を使用するクエリのみがサポートされています。

始める前に

データをクエリする前に、次の操作を行います。

  1. 拡張機能をインストールします。
  2. 拡張機能の設定を構成します。
  3. データを見つけて探索するのガイダンスを確認します。

新しい SQL ファイルを作成する

SQL エディタは複数の方法で開くことができます。

[ファイル] メニューから新しい SQL ファイルを作成する

  1. VS Code のメニューバーで、[File]、[New Text File] の順にクリックします。エディタに無題のファイルが表示されます。
  2. 新しいファイルを .sql 拡張子で保存します。
  3. エディタのタブで [Select Connection] をクリックします。
  4. クエリの設定を構成するの手順を完了します。

カタログから新しいクエリを作成する

  1. アクティビティ バーの [Google Cloud Data Agent Kit] タブで、[カタログ] を開いて、クエリするデータセットを見つけます。
  2. データセットの名前を右クリックまたは Ctrl+クリックして、[クエリ] を選択し、そのデータセット用に事前構成された新しい SQL ファイルを開きます。

BigQuery セクションから新しいクエリを作成する

  1. アクティビティ バーの [Google Cloud Data Agent Kit] タブで、[BigQuery] を開きます。
  2. [+ 新しいクエリ] をクリックします。BigQuery をデータソースとして構成した、無題の SQL ファイルがエディタに表示されます。

クエリ設定を構成する

SQL クエリに必要な設定は、 Google Cloud サービスによって異なります。

AlloyDB

  1. SQL エディタで、[クエリ設定を開く] をクリックします。
  2. [データベース] を選択します。
  3. [AlloyDB] を選択します。
  4. クラスタを選択します。
  5. インスタンスを選択します。クエリはこのインスタンスに転送されます。
  6. データベースを選択します。
  7. [保存] をクリックします。

BigQuery

  1. SQL エディタで、[クエリ設定を開く] をクリックします。
  2. [BigQuery] を選択します。
  3. [保存] をクリックします。

Bigtable

  1. SQL エディタで、[クエリ設定を開く] をクリックします。
  2. [データベース] を選択します。
  3. [Bigtable] を選択します。
  4. インスタンスを選択します。
  5. 省略可: デフォルトのアプリ プロファイル以外のアプリ プロファイルを使用するには、そのアプリ プロファイルを選択します。
  6. クエリを作成します。
  7. [保存] をクリックします。

Cloud SQL

  1. SQL エディタで、[クエリ設定を開く] をクリックします。
  2. [データベース] を選択します。
  3. [Cloud SQL] を選択します。
  4. インスタンスを選択します。クエリはこのインスタンスに転送されます。
  5. クエリするデータベースを選択します。

  6. [認証方法] で、認証方法を選択します。

    • IAM データベース認証: Google Cloud アカウントを使用して認証します。

    • 組み込みデータベース認証: パスワードが Secret Manager のリージョン シークレットとして保存されている組み込みデータベース ユーザーとして認証します。

      1. [ユーザー] リストで、データベース ユーザーを選択します。リストを読み込めない場合は、[ユーザー] フィールドにユーザー名を入力します。Cloud SQL for MySQL では、デフォルトの root ユーザーはサポートされていません。
      2. [パスワード（Secret Manager に保存）] リストで、ユーザーのパスワードを保存するリージョン シークレットを選択します。シークレットがまだない場合は、[リージョン REGION に新しいシークレットを作成] を選択し、名前とパスワードを入力して、[シークレットを作成] をクリックします。シークレットは、インスタンスと同じリージョンに作成されます。
      3. 省略可: [シークレット バージョン] リストで、特定のバージョンを選択します。デフォルトでは latest が選択され、常に最新バージョンのシークレットが使用されます。

      組み込みユーザーとリージョン シークレットの要件の詳細については、Cloud SQL for MySQL と Cloud SQL for PostgreSQL の Data API を使用して SQL ステートメントを実行するをご覧ください。

  7. [保存] をクリックします。

Spanner

  1. SQL エディタで、[クエリ設定を開く] をクリックします。
  2. [データベース] を選択します。
  3. [Spanner] を選択します。
  4. インスタンスを選択します。クエリはこのインスタンスに転送されます。
  5. クエリするデータベースを選択します。
  6. [保存] をクリックします。

クエリの設定を変更する

クエリ設定は SQL ファイルごとに異なります。SQL ファイルを開いた後、設定を変更できます。

  1. エディタで、表示されているデータソースをクリックします。Query Settings エディタが表示されます。
  2. クエリの設定を構成するの手順を完了します。

クエリの実行

クエリファイルを作成してクエリを作成したら、[▷ クエリを実行] をクリックします。

[クエリ結果] ペインの [結果] タブに、クエリの結果が表示されます。

クエリエディタで SQL ステートメントのサブセットを実行するには、サブセットをハイライト表示してから、[▷ クエリを実行] をクリックします。

SQL エディタの機能

SQL エディタのすべての機能が、すべてのデータソース タイプでサポートされているわけではありません。次の表に、プレビュー期間中にデータソース タイプごとにサポートされている SQL エディタの機能を示します。

機能

BigQuery

Bigtable

Spanner

Cloud SQL

AlloyDB for PostgreSQL

クエリ結果

✅

✅

✅

✅

✅

ジョブ情報

該当なし

該当なし

該当なし

該当なし

該当なし

実行の詳細

✅

✅

経過時間

❌

非対応

❌

非対応

❌

非対応

可視化

✅

✅

✅

✅

✅

クエリの設定

✅

✅

✅

✅

✅

複数ステートメント クエリのサポート

✅

✅

✅

✅

✅

カタログ: エディタにリソース名を挿入

✅

✅

✅

✅

✅

次のステップ