このページは Cloud Translation API によって翻訳されました。

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

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

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

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

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

スキーマ
テーブル
列
インデックスとキー
トリガー
ビュー
関数
プロシージャ
シーケンス
型
拡張機能

必要なロールと権限

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

alloydb.clusters.get
alloydb.databases.list
alloydb.instances.executeSql
alloydb.instances.list
alloydb.users.list

これらの権限は、roles/alloydb.admin ロールまたは roles/alloydb.viewer ロールと roles/alloydb.databaseUser ロールの組み合わせを使用して取得できます。このロールを付与されていない場合は、組織管理者に連絡してアクセス権をリクエストしてください。必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

また、認証に使用しているデータベースに対して、データベースレベルの権限があることを確認します。

データを探す

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

Google Cloud コンソールで、[AlloyDB] ページを開きます。

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

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

クエリエディタを使用して SQL ステートメントを実行できます。ステートメントはセミコロンで区切る必要があります。クエリをご自分で作成できます。または、テンプレートを使用してクエリエディタにデータを入力することもできます。

ステートメントは、クエリエディタに入力した順序に基づいて実行されます。

データの作成、クエリ、変更を行う手順は次のとおりです。

Google Cloud コンソールで、[AlloyDB] ページを開きます。

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

1 つ以上のクエリを同時に選択して実行することもできます。これを行うには、クエリまたは複数のクエリを選択し、[選択項目を実行] をクリックします。

制限事項

AlloyDB Studio は軽量のクエリをサポートしています。レスポンスが 10 MB を超えると、切り捨てられる場合があります。部分的な結果が返された場合は、AlloyDB Studio に表示されます。
インスタンスで 5 分を超えるリクエストはキャンセルされます。
SQL スクリプトの実行が完了した後、AlloyDB Studio はデータベース接続を維持しません。同様に、[エディタ] タブでは共通のセッションが共有されません。実行のたびに、別のセッションを使用して新しい接続が開始されます。
AlloyDB Studio は、PostgreSQL ネイティブの認証（ユーザー名とパスワード）のみをサポートしています。Identity and Access Management を使用した認証や、Secrets Manager に保存されている認証情報の使用はできません。
複数のクエリステートメントを同時に実行し、1 つのクエリでエラーが発生すると、クエリ全体がキャンセルされます。

次のステップ

詳しくは、Gemini で SQL の作成やデータ分析を行うをご覧ください。