Amazon Redshift は、パッチ 198 以降、新しい Python UDF の作成をサポートしなくなります。既存の Python UDF は、2026 年 6 月 30 日まで引き続き機能します。詳細については、[ブログ記事](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)を参照してください。
# クエリエディタ v2 を開く
Amazon Redshift では、Amazon Redshift コンソールのクエリエディタ v2 を使用して、データウェアハウスクラスターに対して SQL クエリを実行できます。クエリエディタ v2 は、アドホッククエリ、データ検索、データ分析タスクを実行するためのユーザーフレンドリーなインターフェイスを提供するウェブベースのツールです。以下のセクションでは、コンソールでクエリエディタ v2 を開き、クエリエディタの機能を効果的に活用するプロセスについて説明します。
**クエリエディタ v2 を開くには**
1. AWS マネジメントコンソール にサインインして、[https://console.aws.amazon.com/redshiftv2/](https://console.aws.amazon.com/redshiftv2/) で Amazon Redshift コンソールを開きます。
1. ナビゲーターメニューで、**[エディタ]**、次に **[クエリエディタ V2]** を選択します。新しいブラウザでクエリエディタ v2 が開きます。
クエリエディタページには、次のようにビューを選択するナビゲータメニューがあります。
**エディタ**
テーブルとして編成され、データベースに含まれるデータを管理およびクエリします。データベースには、保存されたデータを格納することも、Amazon S3 などの他の場所に格納されたデータへの参照を含めることもできます。クラスターまたはサーバーレスワークグループに含まれるデータベースに接続します。
**[エディタ]** ビューで操作する場合、次のコントロールがあります。
+ **[Cluster]** (クラスター) または **[Workgroup]** (ワークグループ) フィールドには、現在接続されている名前が表示されます。**[Database]** (データベース) フィールドには、クラスターまたはワークグループ内のデータベースが表示されます。**[データベース]** ビューで実行するアクションは、デフォルトでは選択したデータベースに対して動作します。
+ クラスター、データベース、スキーマのツリービュー階層ビュー。スキーマでは、テーブル、ビュー、関数、および保存する手順を操作できます。ツリービューの各オブジェクトにはコンテキストメニューが用意されており、そのオブジェクトに関連するアクション (**[更新]** または **[ドロップ]**など) を実行できます。
+  **[作成]** アクションを使用して、データベース、スキーマ、テーブル、および関数を作成します。
+ **[データのロード]** アクションは、Amazon S3 またはローカルファイルからデータをデータベースにロードします。
+  **保存** アイコンをクリックすると、クエリを保存できます。
+  **ショートカット** アイコンをクリックすると、エディタのキーボードショートカットが表示されます。
+  **詳細**アイコンをクリックすると、次のような追加のアクションが表示されます 。
+ **[チームと共有する]**: チームとクエリやノートブックを共有します。詳細については、「[チームとしての共同作業と共有](query-editor-v2-team.md)」を参照してください。
+ **[ショートカット]**: エディタのキーボードショートカットを表示します。
+ **[タブ履歴]**: エディタのタブのタブ履歴を表示します。
+ **[オートコンプリートを更新]**: SQL の作成時に表示する候補を更新します。
+ クエリを入力および実行できる  **[Editor]** (エディタ) 領域。
クエリを実行した後、**[結果]** タブが表示され、結果が表示されます。ここで **[チャート]** をオンにすると、結果を視覚化できます。また、結果を**[Export]** (エクスポート) できます。
+ セクションを追加して SQL を入力および実行するか、[Markdown] (マークダウン) を追加できる **[Notebook]** (ノートブック) 領域。
クエリを実行した後、**[結果]** タブが表示され、結果が表示されます。ここで結果を**[Export]** (エクスポート) できます。
**クエリ **
クエリには、データベース内のデータを管理およびクエリする SQL コマンドが含まれています。クエリエディタ v2 を使用してサンプルデータをロードすると、サンプルクエリが作成され、保存されます。
保存したクエリを選択すると、コンテキスト (右クリック) メニューを使用してクエリを開き、名前を変更、削除することができます。**[クエリの詳細]** を選択すると、保存したクエリの **[クエリ ARN]** などの属性を表示できます。また、バージョン履歴を表示したり、クエリに添付されたタグを編集してチームと共有したりすることもできます。
**ノートブック **
SQL ノートブックには、SQL セルと Markdown セルが含まれています。ノートブックを使用して、1 つのドキュメント内で複数の SQL コマンドを編成、注釈付け、共有できます。
保存したノートブックを選択すると、コンテキスト (右クリック) メニューを使用してノートブックを開き、名前を変更、複製、削除することができます。**[ノートブックの詳細]** を選択すると、保存したノートブックの **[ノートブック ARN]** などの属性を表示できます。また、バージョン履歴を表示、ノートブックに添付されたタグを編集、エクスポート、チームと共有することもできます。詳細については、「[Amazon Redshift のノートブックNotebooks](query-editor-v2-notebooks.md)」を参照してください。
**チャート **
チャートは、データの視覚的な表示です。クエリエディタ v2 には、さまざまなタイプのチャートを作成して保存するためのツールが用意されています。
保存したチャートを選択すると、コンテキスト (右クリック) メニューを使用してチャートを開き、名前を変更、削除することができます。**[チャートの詳細]** を選択すると、保存したチャートの **[チャート ARN]** などの属性を表示できます。また、チャートに添付されたタグを編集してエクスポートすることもできます。詳細については、「[クエリ結果の視覚化](query-editor-v2-charts.md)」を参照してください。
**履歴 **
クエリ履歴は、Amazon Redshift クエリエディタ v2 を使用して実行されたクエリの一覧です。これらのクエリは、個別のクエリまたは SQL ノートブックの一部として実行されます。詳細については、「[クエリとタブの履歴を表示する](query-editor-v2-history.md)」を参照してください。
**スケジュールされたクエリ **
スケジュールされたクエリは、特定の時間に開始するように設定されたクエリです。
すべてのクエリエディタ v2 ビューには次のアイコンがあります。
+  **[Visual mode]** (ビジュアルモード) アイコンをクリックすると、ライトモードとダークモードが切り替わります。
+  **[Settings]** (設定) アイコンをクリックすると、さまざまな設定画面のメニューが表示されます。
+  **[Editor preferences]** (エディタの環境設定) アイコンをクリックすると、クエリエディタ v2 を使用するときに、設定を編集できます。ここで**ワークスペース設定を編集**して、フォントサイズ、タブサイズ、その他の表示設定を変更できます。**[オートコンプリート]** をオン(またはオフ) にして、SQL の入力時に候補を表示することもできます。
+  **[Connections]** (接続) アイコンをクリックすると、エディタタブで使用されている接続が表示されます。
接続は、データベースからデータを取得するために使用されます。接続は、特定のデータベースに対して作成されます。分離された接続では、あるエディタタブで一時テーブルを作成するなど、データベースを変更する SQL コマンドの結果は、別のエディタタブに表示されません。クエリエディタ v2 でエディタタブを開くとき、デフォルトは分離された接続です。共有接続を作成するとき、つまり、**分離されたセッション**スイッチをオフにすると、同じデータベースへの他の共有接続の結果が相互に表示されます。ただし、データベースへの共有接続を使用するエディタタブは並列で実行されません。同じ接続を使用するクエリは、接続が使用可能になるまで待機する必要があります。あるデータベースへの接続は別のデータベースと共有できないため、SQL の結果は異なるデータベース接続では表示されません。
アカウント内のユーザーがアクティブにできる接続の数は、クエリエディタ v2 管理者によって制御されます。
+  **[Account settings]** (アカウント設定) アイコンは、アカウント内のすべてのユーザーの特定の設定を変更するために管理者が使用します。詳細については、「[アカウント設定](#query-editor-v2-settings)」を参照してください。
## クエリエディタ v2 を使用する際の考慮事項
クエリエディタ v2 を使用する場合は、次の点を考慮してください。
+ クエリの最大期間は 24 時間です。
+ クエリ結果の最大サイズは 100 MB です。呼び出しで返されるレスポンスデータが 100 MB を上回る場合は、最初の 100 MB が警告とともに返されます。
+ 最大 300,000 文字のクエリを実行できます。
+ 最大 30,000 文字のクエリを保存できます。
+ デフォルトでは、クエリエディタ v2 は、実行する各 SQL コマンドを自動コミットします。BEGIN ステートメントを指定すると、BEGIN-COMMIT ブロックまたは BEGIN-ROLLBACK ブロック内のステートメントは 1 つのトランザクションとして実行されます。トランザクションの詳細については、*Amazon Redshift データベースデベロッパーガイド*の「[BEGIN](https://docs.aws.amazon.com/redshift/latest/dg/r_BEGIN.html)」を参照してください。
+ SQL ステートメントの実行中にクエリエディタ v2 が表示する警告の最大数は `10` です。例えば、ストアドプロシージャを実行した場合、表示される RAISE ステートメントは 10 個までです。
+ クエリエディタ v2 は、カンマ (,) を含む IAM `RoleSessionName` をサポートしていません。次のようなエラーが表示されることがあります: エラーメッセージ: 「'AROA123456789EXAMPLE:mytext,yourtext'は TagValue の有効な値ではありません - 不正な文字が含まれています」 この問題は、カンマを含む IAM `RoleSessionName` を定義し、その IAM ロールでクエリエディタ v2 を使用したときに発生します。
IAM `RoleSessionName` の詳細については、「IAM ユーザーガイド」の「[RoleSessionName SAML 属性](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_create_saml_assertions.html#saml_role-session-attribute)」を参照してください。**
## アカウント設定
適切な IAM 権限を持つユーザーは、同じ AWS アカウント の他のユーザーに対して**[Account settings]** (アカウント設定) を表示および変更できます。この管理者は以下を表示または設定できます。
+ アカウント内のユーザーあたりの最大同時データベース接続。これには**分離されたセッション**も含まれます。この値を変更すると、変更が反映されるまで 10 分かかることがあります。
+ アカウントのユーザーが SQL コマンドからファイルに結果セット全体をエクスポートできるようにします。
+ 関連する保存済みクエリを含むサンプルデータベースをロードして表示します。
+ アカウントユーザーがローカルファイルからデータをロードするために使用する Amazon S3 パスを指定します。
+ クエリエディタ v2 のリソースを暗号化するために使用される KMS キー ARN を表示します。