Amazon Redshift クラスターによってホストされているデータベースでクエリを実行するには、クエリエディタを使用することが最も簡単な方法です。クラスターを作成した後、Amazon Redshift コンソールでクエリエディタを使用することで、すぐにクエリを実行できます。
注記
Amazon Redshift サーバーレスでは、この元のクエリエディタを使用してデータをクエリすることはできません。Amazon Redshift クエリエディタ v2 を代わりに使用してください。
2021 年 2 月、更新されたクエリエディターがデプロイされ、クエリエディターを使用する権限が変更されました。新しいクエリエディターは、Amazon Redshift データ API を使用してクエリを実行します。AWS マネージド AWS Identity and Access Management (IAM) ポリシーである AmazonRedshiftQueryEditor ポリシーが更新され、必要なアクセス許可が含まれるようになりました。カスタム IAM ポリシーがある場合は、必ず更新してください。AmazonRedshiftQueryEditor をガイドとして使用してください。AmazonRedshiftQueryEditor への変更には、以下が含まれます。
-
クエリエディタのステートメント結果を管理する権限には、ステートメント所有者ユーザーが必要です。
-
Secrets Manager を使用してデータベースに接続する権限が追加されました。
詳細については、「Amazon Redshift コンソールのクエリエディタを使用するために必要なアクセス許可」を参照してください。
新しいクエリエディターからクラスターに接続する場合、次の 2 つの認証方法のいずれかを使用できます。
クエリエディタを使用して、以下の操作を実行できます。
-
単一の SQL ステートメントクエリを実行する。
-
最大 100 MB の結果セットをカンマ区切り値 (CSV) ファイルにダウンロードする。
-
再利用するためにクエリを保存する。ヨーロッパ (パリ) リージョン、アジアパシフィック (大阪) リージョン、アジアパシフィック (香港) リージョン、中東 (バーレーン) リージョンでは、クエリを保存できません。
-
ユーザー定義テーブルのクエリ実行の詳細を表示する。
-
将来の時間に実行するようにクエリをスケジュールします。
-
クエリエディタで作成したクエリの履歴を表示します。
-
拡張 VPC ルーティングを使用してクラスターに対してクエリを実行します。
クエリエディタの考慮事項
クエリエディタを使用するときは、クエリを操作する方法について次の操作を行います。
-
クエリの最大期間は 24 時間です。
-
クエリ結果の最大サイズは 100 MB です。100 MB を超えるレスポンスデータが返されると、その呼び出しは終了します。
-
クエリ結果の最大保持時間は 24 時間です。
-
クエリステートメントの最大サイズは 100 KB です。
-
クラスターは、Amazon VPC サービスに基づいて Virtual Private Cloud (VPC) で作成する必要があります。
-
クエリエディタでトランザクションを使用することはできません。トランザクションの詳細については、Amazon Redshift データベースデベロッパーガイドの「BEGIN」を参照してください。
-
クエリは最大 3,000 文字保存することができます。
