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

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

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

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

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

AlloyDB と Cloud SQL では、IAM 認証を使用するクエリがサポートされています。Auth Proxy またはパスワード ベースの認証を使用するように構成されたデータベースに対してクエリを実行することはできません。

始める前に

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

  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. [保存] をクリックします。

Cloud SQL

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

Spanner

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

クエリの設定を変更する

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

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

クエリの実行

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

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

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

SQL エディタの機能

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

機能

BigQuery

Spanner

Cloud SQL

AlloyDB for PostgreSQL

[クエリ結果] ペインのタブ

クエリ結果

✅

✅

✅

✅

ジョブ情報

✅

該当なし

該当なし

該当なし

実行の詳細

✅

❌

非対応

❌

非対応

❌

非対応

可視化

✅

✅

✅

✅

SQL エディタの構成

クエリの設定

✅

✅

✅

✅

その他の機能

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

✅

✅

✅

✅

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

✅

✅

✅

✅

次のステップ