Google Cloud Data Agent Kit IDE 拡張機能の統合 SQL エディタを使用すると、IDE から直接 データ Google Cloud に対して SQL クエリを実行できます。
サポートされているコーディング エージェントで Data Agent Kit プラグインを使用している場合は、エージェントで SQL クエリを実行するか、自然言語プロンプトを使用して SQL クエリを生成できます。
サポートされるデータソース
Data Agent Kit を使用すると、次の Google Cloud データサービスでテーブルとビューに対してクエリを実行できます。
- BigQuery
- Spanner
- AlloyDB for PostgreSQL
- Cloud SQL for MySQL
- Cloud SQL for PostgreSQL
AlloyDB と Cloud SQL では、IAM 認証を使用するクエリがサポートされています。Auth Proxy またはパスワードベースの認証を使用するように構成されたデータベースに対してクエリを実行することはできません。
始める前に
データに対してクエリを実行する前に、次の操作を行います。
新しい SQL ファイルを作成する
SQL エディタは複数の方法で開くことができます。
[File] メニューから新しい SQL ファイルを作成する
- VS Code のメニューバーで、[File]、[New Text File] をクリックします。エディタに名前のないファイルが表示されます。
- 新しいファイルを
.sql拡張子で保存します。 - エディタタブで [Select Connection] をクリックします。
- クエリ設定を構成するの手順を完了します。
カタログから新しいクエリを作成する
- アクティビティ バーの [Google Cloud Data Agent Kit] タブで、[Catalog] を展開して、クエリを実行するデータセットを見つけます。
- データセットの名前を右クリックまたは Ctrl キーを押しながらクリックし、[Query] を選択して、そのデータセット用に事前構成された新しい SQL ファイルを開きます。
[BigQuery] セクションから新しいクエリを作成する
- アクティビティ バーの [Google Cloud Data Agent Kit] タブで、[BigQuery] を展開します。
- [+ New Query] をクリックします。BigQuery をデータソースとして構成した名前のない SQL ファイルがエディタに表示されます。
クエリ設定を構成する
SQL クエリに必要な設定は、 Google Cloud サービスによって異なります。
AlloyDB
- [SQL editor] で、[Open Query Settings] をクリックします。
- [Databases] を選択します。
- [AlloyDB] を選択します。
- クラスタを選択します。
- インスタンスを選択します。クエリはこのインスタンスにルーティングされます。
- データベースを選択します。
- [保存] をクリックします。
BigQuery
- [SQL editor] で、[Open Query Settings] をクリックします。
- [BigQuery] を選択します。
- [保存] をクリックします。
Cloud SQL
- [SQL editor] で、[Open Query Settings] をクリックします。
- [Databases] を選択します。
- [Cloud SQL] を選択します。
- インスタンスを選択します。クエリはこのインスタンスにルーティングされます。
- クエリを実行するデータベースを選択します。
- [保存] をクリックします。
Spanner
- [SQL editor] で、[Open Query Settings] をクリックします。
- [Databases] を選択します。
- [Spanner] を選択します。
- インスタンスを選択します。クエリはこのインスタンスにルーティングされます。
- クエリを実行するデータベースを選択します。
- [保存] をクリックします。
クエリ設定を変更する
クエリ設定は SQL ファイルごとに異なります。SQL ファイルを開いた後で、設定を変更できます。
- エディタで、表示されているデータソースをクリックします。クエリ設定 エディタが表示されます。
- クエリ設定を構成するの手順を完了します。
クエリの実行
クエリファイルを作成してクエリを作成したら、[▷ Run Query] をクリックします。
[クエリ結果] ペインの [結果] タブにクエリ結果が表示されます。
クエリエディタで SQL ステートメントのサブセットを実行するには、[▷ Run Query] をクリックする前にサブセットをハイライト表示します。
SQL エディタの機能
すべてのデータソース タイプで、すべての SQL エディタ機能がサポートされているわけではありません。次の表に、プレビュー期間中にデータソース タイプごとにサポートされている SQL エディタの機能を示します。
機能 |
BigQuery |
Spanner |
Cloud SQL |
AlloyDB for PostgreSQL |
[クエリ結果] ペインのタブ |
||||
クエリ結果 |
✅ |
✅ |
✅ |
✅ |
ジョブ情報 |
✅ |
該当なし |
該当なし |
該当なし |
実行の詳細 |
✅ |
❌ 対象外 |
❌ 対象外 |
❌ 対象外 |
可視化 |
✅ |
✅ |
✅ |
✅ |
SQL エディタの構成 |
||||
クエリ設定 |
✅ |
✅ |
✅ |
✅ |
その他の機能 |
||||
複数ステートメント クエリのサポート |
✅ |
✅ |
✅ |
✅ |
カタログ: エディタにリソース名を挿入する |
✅ |
✅ |
✅ |
✅ |