Cloud SQL Studio を使用してデータを管理する

MySQL | PostgreSQL | SQL Server

このページでは、Google Cloud コンソールで Cloud SQL Studio を使用し、Cloud SQL データの探索と管理を行う方法について説明します。

Cloud SQL Studio を使用すると、承認済みユーザーは SQL データベースを直接操作し、Google Cloud コンソールから SQL クエリを実行してデータにアクセスして操作できます。テーブルとインデックスの作成、テーブルの変更、ビューの設定など、SQL コマンドラインクライアントで行うさまざまなアクションを実行できます。

Cloud SQL Studio には [エクスプローラ] ペインがあり、クエリエディタと SQL クエリ結果テーブルが統合されています。このインターフェースから DDL、DML、DQL ステートメントを実行できます。たとえば、サードパーティのデータベースクエリツールを構成する代わりに、Cloud SQL Studio のクエリエディタでテーブルを作成し、データに対するクエリを実行できます。

[エクスプローラ] ペインを使用して、データベースオブジェクトを表示し、操作できます。次のようなデータベースオブジェクトの作成、変更、削除を行います。

テーブル
列
インデックスとキー
関数

また、[エクスプローラ] ペインを使用して、テーブルの SELECT クエリにシードすることもできます。

Cloud SQL を初めて使用する場合は、Cloud SQL の概要をご覧ください。

必要なロールと権限

このドキュメントのタスクを完了するのに必要な権限を取得するには、プロジェクトに対する Cloud SQL Studio ユーザー（roles/cloudsql.studioUser）IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

Cloud SQL Studio を使用するには、次の権限が必要です。

cloudsql.databases.list
cloudsql.instances.executeSql
cloudsql.instances.get
cloudsql.users.list

また、認証に使用するデータベースに対するデータベースレベルの権限と、使用する特権データベースユーザーのパスワードが必要です。

データを探す

[エクスプローラ] ペインにアクセスする手順は、次のとおりです。

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

Cloud SQL の [インスタンス] に移動
リストからインスタンスを選択します。
ナビゲーションメニューで [Cloud SQL Studio] をクリックします。
データベースの名前、ユーザー名、パスワードを使用して Cloud SQL Studio にログインします。[エクスプローラ] ペインに、データベースにあるオブジェクトのリストが表示されます。

データの作成、変更、クエリ

SQL エディタを使用すると、DDL、DML、DQL ステートメントの組み合わせを実行できます。自分でクエリを作成することも、エクスプローラを使用してクエリエディタにテンプレートを入力することもできます。

データの構造化、修正、クエリ実行を行う手順は、次のとおりです。

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

Cloud SQL の [インスタンス] に移動
リストからインスタンスを選択します。
ナビゲーションメニューで [Cloud SQL Studio] をクリックします。
データベースの名前、ユーザー名、パスワードを使用して Cloud SQL Studio にログインします。
次のいずれかの方法でクエリを作成します。
- 独自のクエリを作成する手順は次のとおりです。
  1. をクリックして新しいタブを開きます。
  2. クエリエディタが表示されたら、クエリを入力します。
- テンプレートからクエリを作成する手順は次のとおりです。
  1. [エクスプローラ] ペインで、データベースオブジェクトまたはコレクションの横にあるアクションを表示アイコン more_vert をクリックします。可能な操作が 1 つ以上表示されます。
  2. アクションをクリックします。クエリエディタにテンプレートが入力されます。
  3. テンプレート内のプレースホルダをすべて置き換えます。
次のいずれかの方法でクエリを実行します。
- クエリエディタ内のすべてのステートメントを実行するには、[実行] をクリックします。
- 特定のステートメントを実行するには、1 つまたは複数のステートメントを選択して、[選択項目を実行] をクリックします。
クエリの結果は [結果] タブに表示されます。複数の結果セットがある場合は、[すべての結果] プルダウンリストから結果を選択します。

制限事項

Cloud SQL Studio は軽量のクエリをサポートしています。レスポンスが 10 MB を超えると、切り捨てられる場合があります。その場合、部分的な結果が返されたことが Cloud SQL Studio に表示されます。
クエリは、実行中の Cloud SQL インスタンスに対してのみ実行できます。
Cloud SQL Studio は外部サーバーをサポートしていません。
5 分以上かかるリクエストはキャンセルされます。
SQL スクリプトの実行が完了した後、Cloud SQL Studio はデータベース接続を維持しません。同様に、エディタタブでは共通のセッションが共有されません。実行のたびに新しいセッションが開始されます。
DML、DQL、DDL ステートメントを組み合わせて実行すると、DQL クエリの結果のみが表示されます。
ブラウザまたはブラウザタブを閉じても、Cloud SQL Studio でクエリの実行は停止しません。クエリは、完了するかタイムアウトするまで実行されます。

Cloud SQL Studio は、PostgreSQL ネイティブの認証（ユーザー名とパスワード）のみをサポートしています。Identity and Access Management を使用した認証や、Secrets Manager に保存されている認証情報の使用はできません。
クエリエディタで複数のステートメントを同時に実行している場合、1 つ以上のステートメントでエラーが発生すると、すべてのステートメントの実行が中止され、最初に発生したエラーが表示されます。