クエリエディタ v2 を開く - Amazon Redshift
考慮事項アカウント設定

クエリエディタ v2 を開く

Amazon Redshift では、Amazon Redshift コンソールのクエリエディタ v2 を使用して、データウェアハウスクラスターに対して SQL クエリを実行できます。クエリエディタ v2 は、アドホッククエリ、データ検索、データ分析タスクを実行するためのユーザーフレンドリーなインターフェイスを提供するウェブベースのツールです。以下のセクションでは、コンソールでクエリエディタ v2 を開き、クエリエディタの機能を効果的に活用するプロセスについて説明します。

クエリエディタ v2 を開くには

  1. AWS Management Consoleにサインインして、https://console.aws.amazon.com/redshiftv2/ で Amazon Redshift コンソールを開きます。

  2. ナビゲーターメニューで、[エディタ]、次に [クエリエディタ V2] を選択します。新しいブラウザでクエリエディタ v2 が開きます。

クエリエディタページには、次のようにビューを選択するナビゲータメニューがあります。

エディタ Horizontal lines representing redacted or censored text.

テーブルとして編成され、データベースに含まれるデータを管理およびクエリします。データベースには、保存されたデータを格納することも、Amazon S3 などの他の場所に格納されたデータへの参照を含めることもできます。クラスターまたはサーバーレスワークグループに含まれるデータベースに接続します。

[エディタ] ビューで操作する場合、次のコントロールがあります。

  • [Cluster] (クラスター) または [Workgroup] (ワークグループ) フィールドには、現在接続されている名前が表示されます。[Database] (データベース) フィールドには、クラスターまたはワークグループ内のデータベースが表示されます。[データベース] ビューで実行するアクションは、デフォルトでは選択したデータベースに対して動作します。

  • クラスター、データベース、スキーマのツリービュー階層ビュー。スキーマでは、テーブル、ビュー、関数、および保存する手順を操作できます。ツリービューの各オブジェクトにはコンテキストメニューが用意されており、そのオブジェクトに関連するアクション ([更新] または [ドロップ]など) を実行できます。

  • The create icon used in the AWS Console. [作成] アクションを使用して、データベース、スキーマ、テーブル、および関数を作成します。

  • The upload icon used in the AWS Console. [データのロード] アクションは、Amazon S3 またはローカルファイルからデータをデータベースにロードします。

  • The floppy disk icon used in the AWS Console. 保存 アイコンをクリックすると、クエリを保存できます。

  • The shortcut icon used in the AWS Console. ショートカット アイコンをクリックすると、エディタのキーボードショートカットが表示されます。

  • The more actions icon used in the AWS Console. 詳細アイコンをクリックすると、次のような追加のアクションが表示されます 。

    • [チームと共有する]: チームとクエリやノートブックを共有します。詳細については、「チームとしての共同作業と共有」を参照してください。

    • [ショートカット]: エディタのキーボードショートカットを表示します。

    • [タブ履歴]: エディタのタブのタブ履歴を表示します。

    • [オートコンプリートを更新]: SQL の作成時に表示する候補を更新します。

  • クエリを入力および実行できる The editor icon in the AWS Console where can enter and run queries. [Editor] (エディタ) 領域。

    クエリを実行した後、[結果] タブが表示され、結果が表示されます。ここで [チャート] をオンにすると、結果を視覚化できます。また、結果を[Export] (エクスポート) できます。

  • セクションを追加して SQL を入力および実行するか、[Markdown] (マークダウン) を追加できる The icon in the AWS Console where you can add sections to enter and run SQL or add Markdown. [Notebook] (ノートブック) 領域。

    クエリを実行した後、[結果] タブが表示され、結果が表示されます。ここで結果を[Export] (エクスポート) できます。

クエリ A folder icon used in the AWS Console used to query databases.

クエリには、データベース内のデータを管理およびクエリする SQL コマンドが含まれています。クエリエディタ v2 を使用してサンプルデータをロードすると、サンプルクエリが作成され、保存されます。

保存したクエリを選択すると、コンテキスト (右クリック) メニューを使用してクエリを開き、名前を変更、削除することができます。[クエリの詳細] を選択すると、保存したクエリの [クエリ ARN] などの属性を表示できます。また、バージョン履歴を表示したり、クエリに添付されたタグを編集してチームと共有したりすることもできます。

ノートブック A book icon used in the AWS Console used as SQL notebook.

SQL ノートブックには、SQL セルと Markdown セルが含まれています。ノートブックを使用して、1 つのドキュメント内で複数の SQL コマンドを編成、注釈付け、共有できます。

保存したノートブックを選択すると、コンテキスト (右クリック) メニューを使用してノートブックを開き、名前を変更、複製、削除することができます。[ノートブックの詳細] を選択すると、保存したノートブックの [ノートブック ARN] などの属性を表示できます。また、バージョン履歴を表示、ノートブックに添付されたタグを編集、エクスポート、チームと共有することもできます。詳細については、「Amazon Redshift のノートブック」を参照してください。

チャート Icon of a chart used in the AWS Console as visual representation of data.

チャートは、データの視覚的な表示です。クエリエディタ v2 には、さまざまなタイプのチャートを作成して保存するためのツールが用意されています。

保存したチャートを選択すると、コンテキスト (右クリック) メニューを使用してチャートを開き、名前を変更、削除することができます。[チャートの詳細] を選択すると、保存したチャートの [チャート ARN] などの属性を表示できます。また、チャートに添付されたタグを編集してエクスポートすることもできます。詳細については、「クエリ結果の視覚化」を参照してください。

履歴 Icon of a clock used in the AWS Console for query history.

クエリ履歴は、Amazon Redshift クエリエディタ v2 を使用して実行されたクエリの一覧です。これらのクエリは、個別のクエリまたは SQL ノートブックの一部として実行されます。詳細については、「クエリとタブの履歴を表示する」を参照してください。

スケジュールされたクエリ Icon of a calendar used in the AWS Console for scheduled queries.

スケジュールされたクエリは、特定の時間に開始するように設定されたクエリです。

すべてのクエリエディタ v2 ビューには次のアイコンがあります。

  • Icon of a quarter moon used in the AWS Console to switch between light and dark modes. [Visual mode] (ビジュアルモード) アイコンをクリックすると、ライトモードとダークモードが切り替わります。

  • Icon of a gear used in the AWS Console to show settings. [Settings] (設定) アイコンをクリックすると、さまざまな設定画面のメニューが表示されます。

    • Icon used in the AWS Console to show editor preferences. [Editor preferences] (エディタの環境設定) アイコンをクリックすると、クエリエディタ v2 を使用するときに、設定を編集できます。ここでワークスペース設定を編集して、フォントサイズ、タブサイズ、その他の表示設定を変更できます。[オートコンプリート] をオン(またはオフ) にして、SQL の入力時に候補を表示することもできます。

    • Icon used in the AWS Console to view connections used in the editor tab. [Connections] (接続) アイコンをクリックすると、エディタタブで使用されている接続が表示されます。

      接続は、データベースからデータを取得するために使用されます。接続は、特定のデータベースに対して作成されます。分離された接続では、あるエディタタブで一時テーブルを作成するなど、データベースを変更する SQL コマンドの結果は、別のエディタタブに表示されません。クエリエディタ v2 でエディタタブを開くとき、デフォルトは分離された接続です。共有接続を作成するとき、つまり、分離されたセッションスイッチをオフにすると、同じデータベースへの他の共有接続の結果が相互に表示されます。ただし、データベースへの共有接続を使用するエディタタブは並列で実行されません。同じ接続を使用するクエリは、接続が使用可能になるまで待機する必要があります。あるデータベースへの接続は別のデータベースと共有できないため、SQL の結果は異なるデータベース接続では表示されません。

      アカウント内のユーザーがアクティブにできる接続の数は、クエリエディタ v2 管理者によって制御されます。

    • Icon used in the AWS Console used by administrators to change settings of user accounts. [Account 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」を参照してください。

  • SQL ステートメントの実行中にクエリエディタ v2 が表示する警告の最大数は 10 です。例えば、ストアドプロシージャを実行した場合、表示される RAISE ステートメントは 10 個までです。

  • クエリエディタ v2 は、カンマ (,) を含む IAM RoleSessionName をサポートしていません。次のようなエラーが表示されることがあります: エラーメッセージ: 「'AROA123456789EXAMPLE:mytext,yourtext'は TagValue の有効な値ではありません - 不正な文字が含まれています」 この問題は、カンマを含む IAM RoleSessionName を定義し、その IAM ロールでクエリエディタ v2 を使用したときに発生します。

    IAM RoleSessionName の詳細については、「IAM ユーザーガイド」の「RoleSessionName SAML 属性」を参照してください。

アカウント設定

適切な IAM 権限を持つユーザーは、同じ AWS アカウント の他のユーザーに対して[Account settings] (アカウント設定) を表示および変更できます。この管理者は以下を表示または設定できます。

  • アカウント内のユーザーあたりの最大同時データベース接続。これには分離されたセッションも含まれます。この値を変更すると、変更が反映されるまで 10 分かかることがあります。

  • アカウントのユーザーが SQL コマンドからファイルに結果セット全体をエクスポートできるようにします。

  • 関連する保存済みクエリを含むサンプルデータベースをロードして表示します。

  • アカウントユーザーがローカルファイルからデータをロードするために使用する Amazon S3 パスを指定します。

  • クエリエディタ v2 のリソースを暗号化するために使用される KMS キー ARN を表示します。