保存したクエリの作成と管理

このページでは、保存済みクエリを作成して管理する方法について説明します。Cloud SQL Studio で SQL スクリプトを記述する場合、それらの SQL スクリプトを保存して管理できます。詳細については、保存済みクエリの概要をご覧ください。

保存済みクエリ機能は、 Google Cloud コンソールでのみ使用できます。

必要なロール

保存済みクエリの使用に必要な権限を取得するには、プロジェクトに対する次の Identity and Access Management(IAM)ロールを付与するよう管理者に依頼してください。

  • 保存済みクエリを表示する: Cloud SQL Studio ユーザー(roles/cloudsql.studiouser
  • プロジェクト内の保存済みクエリを作成、編集、表示、削除する([保存したクエリ] ページへのアクセスを含む): Cloud SQL 管理者(roles/cloudsql.admin)または Studio クエリユーザーroles/databasesconsole.studioQueryUser
  • プロジェクト内のすべての保存済みクエリを管理する([保存したクエリ] ページへのアクセスを含む): Studio クエリ管理者roles/databasesconsole.studioQueryAdmin

ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。

これらの事前定義ロールには、保存済みクエリの使用に必要な権限が含まれています。必要な権限の詳細については、必要な権限をご覧ください。

必要な権限

保存済みクエリを作成、表示、変更、削除するには、プロジェクト レベルで次の IAM 権限が必要です。

操作 必要な IAM 権限
保存済みクエリを作成する
  • databasesconsole.studioQueries.create
保存済みクエリを表示する
  • databasesconsole.studioQueries.search
  • databasesconsole.locations.get
  • databasesconsole.locations.list
保存済みクエリを変更する
  • databasesconsole.studioQueries.update
保存済みクエリを削除する
  • databasesconsole.studioQueries.delete
保存済みクエリを管理する
(管理者のみが使用)
  • databasesConsole.studioQueries.list
  • databasesconsole.locations.list
これらの権限は、カスタムロールや他の事前定義ロールを使用して取得することもできます。

Studio クエリユーザーroles/databasesconsole.studioQueryUser)ロールには、保存済みクエリの作成、表示、書き込みのアクセス権が含まれます。このロールは、ほとんどのユーザーのニーズを満たします。

Studio クエリ管理者roles/databasesconsole.studioQueryAdmin)ロールは、管理者にのみ付与します。Cloud SQL for MySQL IAM の詳細については、ロールと権限をご覧ください。

保存済みクエリを作成する

保存済みクエリを作成する手順は次のとおりです。

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

    Cloud SQL の [インスタンス] に移動

  2. 保存済みクエリを作成するインスタンスを選択します。
  3. ナビゲーション メニューで [Cloud SQL Studio] をクリックします。
  4. [Cloud SQL Studio] ページで、[ 新しいタブ] をクリックするか、空のエディタタブを使用します。
  5. クエリエディタで、SQL クエリを入力します。
  6. [保存] をクリックします。
  7. [クエリを保存] ダイアログで、保存済みクエリの名前を入力します。
  8. [保存] をクリックします。

保存済みクエリを開いて実行する

保存済みクエリを新しいクエリとして開く手順は次のとおりです。

  1. [Cloud SQL Studio] ページの [エクスプローラ] ペインで、[クエリ] セクションに移動します。
  2. 保存済みクエリをクリックして、新しいエディタタブで開きます。必要に応じて、保存済みクエリの横にある [ アクションを表示] をクリックします。[クエリを開く] をクリックして、新しいエディタタブでクエリを開きます。
  3. [実行] をクリックします。

保存済みクエリを更新する

既存の保存済みクエリを更新する手順は次のとおりです。

  1. [Cloud SQL Studio] ページの [エクスプローラ] ペインで、[クエリ] セクションに移動します。
  2. 保存済みクエリをクリックして、新しいエディタタブで開きます。必要に応じて、保存済みクエリの横にある [ アクションを表示] をクリックします。[クエリを開く] をクリックして、新しいエディタタブでクエリを開きます。
  3. クエリを変更します。
  4. 変更済みクエリを保存するには、[保存] をクリックします。

すべての保存済みクエリのリストを表示、管理する

プロジェクトに保存されているすべてのクエリのリストを表示する手順は次のとおりです。

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

    Cloud SQL の [インスタンス] に移動

  2. 任意のインスタンスを選択します。保存済みクエリはプロジェクトの子であるため、必要なロールが付与されているユーザーは、任意のインスタンスまたはデータベースから、そのプロジェクト内のすべての保存済みクエリを表示できます。
  3. ナビゲーション メニューで [Cloud SQL Studio] をクリックして、認証します。
  1. 任意のデータベースを選択します。
  2. [Cloud SQL Studio] ページの [エクスプローラ] ペインで、[クエリ] セクションに移動します。
  3. 保存済みクエリの横にある [ アクションを表示] をクリックします。[クエリを管理する] をクリックします。

    [保存したクエリ] ページが開きます。このページには、このプロジェクト内のすべての保存済みクエリ(他の Google Cloud プロダクトの保存済みクエリを含む)が一覧表示されます。

[保存したクエリ] ページでは、クエリの検索、フィルタ、表示、削除ができます。[保存したクエリ] ページで既存のクエリを編集することはできません。

保存済みクエリを削除する

保存済みクエリは、[Cloud SQL Studio] ページまたは Google Cloud コンソールの [保存したクエリ] ページで削除できます。

  1. [Cloud SQL Studio] ページの [エクスプローラ] ペインで、[クエリ] セクションに移動します。
  2. 削除する保存済みクエリの横にある [ アクションを表示] をクリックします。[クエリを削除] をクリックして、保存済みクエリを削除します。
  3. [クエリを削除] ダイアログで、[削除] をクリックします。

[保存したクエリ] ページで保存済みクエリを削除することもできます。[保存したクエリ] ページで保存済みクエリを削除する手順は次のとおりです。

  1. [保存したクエリ] ページに移動します。
  2. 削除する保存済みクエリの横にある [ アクションを表示] をクリックします。
  3. [クエリを削除] をクリックして、保存済みクエリを削除します。
  4. [クエリを削除] ダイアログで、[削除] をクリックします。

次のステップ