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

MySQL   |  PostgreSQL   |  SQL Server

プレビュー版

この機能は、サービス固有の規約の「一般サービス規約」セクションの「一般提供前サービス規約」の対象となります。 pre-GA の機能は「現状のまま」で提供されるものであり、サポートが制限されることがあります。 詳細については、リリース ステージの説明をご覧ください。

このページでは、保存済みクエリを作成して管理する方法について説明します。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 PostgreSQL の 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] をクリックして、認証します。

3. 任意のデータベースを選択します。
4. [Cloud SQL Studio] ページの [エクスプローラ] ペインで、[クエリ] セクションに移動します。
5. 保存済みクエリの横にある [ アクションを表示] をクリックします。[クエリを管理する] をクリックします。

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

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

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

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

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

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

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

次のステップ

• 保存済みクエリについて学習する。