クエリエディタ v2 の操作 - Amazon Redshift
クエリエディタ v2 を開くAmazon Redshift データベースに接続するAmazon Redshift データベースの閲覧データベースオブジェクトの作成クエリとタブの履歴を表示する考慮事項アカウント設定の変更

クエリエディタ v2 の操作

クエリエディタ v2 は、主にクエリの編集と実行、結果の視覚化、チームとの作業の共有に使用されます。クエリエディタ v2 を使用すると、データベース、スキーマ、テーブル、およびユーザー定義関数 (UDF) を作成できます。ツリービューパネルでは、各データベースのスキーマが表示されます。スキーマごとに、テーブル、ビュー、UDF、および保存する手順が表示されます。

クエリエディタ v2 を開く

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

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

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

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

エディタ Editor

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

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

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

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

  • Create [作成] アクションを使用して、データベース、スキーマ、テーブル、および関数を作成します。

  • Load[データのロード] アクションは、Amazon S3 またはローカルファイルからデータをデータベースにロードします。

  • Save 保存 アイコンをクリックすると、クエリを保存できます。

  • Shortcuts ショートカット アイコンをクリックすると、エディタのキーボードショートカットが表示されます。

  • More 詳細アイコンをクリックすると、次のような追加のアクションが表示されます 。

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

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

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

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

  • クエリを入力および実行できる Editor [Editor] (エディタ) 領域。

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

  • セクションを追加して SQL を入力および実行するか、[Markdown] (マークダウン) を追加できる Notebook [Notebook] (ノートブック) 領域。

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

クエリ Queries

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

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

ノートブック Notebooks

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

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

チャート Chart

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

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

履歴 History

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

スケジュールされたクエリ Scheduled queries

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

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

  • Visual mode [Visual mode] (ビジュアルモード) アイコンをクリックすると、ライトモードとダークモードが切り替わります。

  • Settings [Settings] (設定) アイコンをクリックすると、さまざまな設定画面のメニューが表示されます。

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

    • Connections [Connections] (接続) アイコンをクリックすると、エディタタブで使用されている接続が表示されます。

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

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

    • Account settings [Account settings] (アカウント設定) アイコンは、アカウント内のすべてのユーザーの特定の設定を変更するために管理者が使用します。詳細については、「アカウント設定の変更」を参照してください。

Amazon Redshift データベースに接続する

データベースに接続するには、ツリービューパネルでクラスターまたはワークグループ名を選択します。プロンプトが表示されたら、接続パラメータを入力します。

クラスターまたはワークグループとそのデータベースに接続するときは、通常 [Database] (データベース) 名を指定します。また、次の認証方法のいずれかに必要なパラメータも指定します。

IAM アイデンティティセンター

この方法では、ID プロバイダー (IdP) からのシングルサインオン認証情報を使用して Amazon Redshift データウェアハウスに接続します。Amazon Redshift コンソールの IAM アイデンティティセンターで、クラスターまたはワークグループが有効になっている必要があります。

フェデレーティッドユーザー

この方法では、IAM ロールまたはユーザーのプリンシパルタグで接続の詳細を指定する必要があります。これらのタグは、AWS Identity and Access Managementまたは ID プロバイダー (IdP) で設定します。クエリエディタ v2 では、次のタグを使用します。

  • RedshiftDbUser — このタグは、クエリエディタ v2 で使用されるデータベースユーザーを定義します。このタグは必須です。

  • RedshiftDbGroups — このタグは、クエリエディタ v2 に接続する場合に結合されるデータベースグループを定義します。このタグはオプションであり、その値は group1:group2:group3 のようにコロンで区切る必要があります。空の値は無視されます。つまり、group1::::group2は group1:group2 と解釈されます。

これらのタグは、クラスターの認証情報を取得するために redshift:GetClusterCredentials API に転送されます。詳細については、「クエリエディタ v2 からクラスターまたはワークグループに接続するためのプリンシパルタグの設定」を参照してください。

データベースのユーザー名を使用する一時的な認証情報

このオプションは、クラスターに接続している場合のみ使用できます。この方法では、クエリエディタ v2 によって、データベースのユーザー名が提供されます。クエリエディタ v2 が、このデータベースユーザー名でデータベースに接続するための一時パスワードを生成します。この方法を使用して接続するユーザーには、redshift:GetClusterCredentials への IAM アクセス許可を付与する必要があります。ユーザーがこの方法を使用できないようにするには、IAM ユーザーまたはロールを変更して、このアクセス許可を拒否します。

IAM ID を使用した一時的な認証情報

このオプションは、クラスターに接続している場合のみ使用できます。この方法では、クエリエディタ v2 は、ユーザー名を IAM アイデンティティにマップして、IAM アイデンティティとしてデータベースに接続するための一時パスワードを生成します。この方法を使用して接続するユーザーには、redshift:GetClusterCredentialsWithIAM への IAM アクセス許可を付与する必要があります。ユーザーがこの方法を使用できないようにするには、IAM ユーザーまたはロールを変更して、このアクセス許可を拒否します。

データベースユーザー名とパスワード

この方法では、接続先のデータベースのユーザー名とパスワードも指定します。クエリエディタ v2 は、ユーザーに代わり、AWS Secrets Managerに保存するシークレットを作成します。この秘密には、データベースに接続するための認証情報が含まれます。

AWS Secrets Manager

この方法では、データベース名の代わりに、データベースとサインイン認証情報を含むシークレットマネージャーに保存されているシークレットを指定します。シークレットを作成する方法の詳細については、「データベース接続認証情報のシークレットの作成」を参照してください。

クエリエディタ v2 でクラスターまたはワークグループを選択すると、コンテキストに応じて、コンテキスト (右クリック) メニューを使用して接続を作成、編集、削除できます。[接続の詳細] を選択すると、接続の [接続 ARN] などの属性を表示できます。接続に添付されたタグを編集することもできます。

Amazon Redshift データベースの閲覧

データベース内では、ツリービューパネルでスキーマ、テーブル、ビュー、関数、および保存する手順を管理できます。ビュー内の各オブジェクトには、コンテキスト メニュー (右クリック) でアクションが関連付けられます。

階層ツリービューパネルには、データベースオブジェクトが表示されます。ツリービューパネルを更新して、ツリービューが最後に表示された後で作成された可能性があるデータベースオブジェクトを表示するには、 Refresh アイコンを選択します。オブジェクトを右クリックしてコンテキストメニューを開き、実行できるアクションを確認します。

Tree-view icons

テーブルを選択すると、次の操作を実行できます。

  • テーブル内のすべての列をクエリする SELECT ステートメントを使用してエディタでクエリを開始するには、[テーブルを選択] を使用します。

  • 属性またはテーブルを表示するには、[Show table definition] (テーブル定義を表示) を使用します。これを使用して、列名、列型、エンコーディング、分散キー、ソートキー、および列に Null 値を含めることができるかどうかを表示します。テーブル属性の詳細については、「Amazon Redshift データベースデベロッパーガイド」の「CREATE TABLE」を参照してください。

  • テーブルを削除するには、[削除] を使用します。テーブルからすべての行を削除するには [Truncate table] (テーブルの切り捨て) 、データベースからテーブルを削除するには [テーブルの削除] を使用します。詳細については、「Amazon Redshift データベースデベロッパーガイド」の「TRUNCATEDROP TABLE」を参照してください。

[スキーマ] を選択し、スキーマを [更新] または [削除] します。

[ビュー定義を表示] または [ドロップ ビュー] のビューを選択します。

関数を選択し、[Show function definition] (関数定義を表示) または [Drop function] (関数を削除) します。

保存する手順を選択して [Show procedure definition] (手順定義を表示) または [Drop procedure] (手順を削除) します。

データベースオブジェクトの作成

データベース、スキーマ、テーブル、およびユーザー定義関数 (UDF) など、データベースオブジェクトを作成できます。データベースオブジェクトを作成するには、クラスターまたはワークグループとデータベースに接続している必要があります。

データベースの作成

クエリエディタ v2 を使用して、クラスターまたはワークグループにデータベースを作成できます。

データベースを作成する

この他のコマンドオプションについては、「Amazon Redshift データベースデベロッパーガイド」の「CREATE DATABASE」を参照してください。

  1. Create[作成] を選択し、次に [データベース] を選択します。

  2. [データベース名] を入力します。

  3. (任意) [ユーザーとグループ] を選択し、[データベースユーザー] を選択します。

  4. (オプション) データベースはデータ共有または AWS Glue Data Catalog から作成できます。AWS Glue の詳細については、AWS Glue デベロッパーガイド の「What is AWS Glue?」を参照してください。

    • (オプション) [データ共有を使用して作成する] を選択し、[データ共有の選択] を選択します。このリストには、現在のクラスターまたはワークグループでコンシューマーデータ共有の作成に使用できるプロデューサーデータ共有が含まれています。

    • (オプション) [AWS Glue Data Catalogを使用して作成する] を選択し、[AWS Glue データベースを選択] を選択します。[データカタログスキーマ] に、データを参照するときにスキーマで使用する名前を 3 つの部分からなる表記 (database.schema.table) で入力します。

  5. [データベースの作成] を選択します。

    ツリービューパネルに新しいデータベースが表示されます。

    データ共有から作成したデータベースをクエリするオプションのステップを選択する場合は、クラスターまたはワークグループ内の Amazon Redshift データベース (例えば、デフォルトデータベース dev) に接続し、[データ共有を使用して作成する] の選択時に作成したデータベース名を参照する 3 つの部分からなる表記 (database.schema.table) を使用します。データ共有データベースは、クエリエディタ v2 のエディタタブに表示されますが、直接接続には使用できません。

    AWS Glue Data Catalog から作成したデータベースをクエリするオプションのステップを選択する場合は、クラスターまたはワークグループ内の Amazon Redshift データベース (例えば、デフォルトデータベース dev) に接続し、[AWS Glue Data Catalog を使用して作成する] の選択時に作成したデータベース名、[データカタログスキーマ] で名前を付けたスキーマ、および AWS Glue Data Catalog のテーブルを参照する 3 つの部分からなる表記 (database.schema.table) を使用します。次のような表記になります。

    SELECT * FROM glue-database.glue-schema.glue-table
    注記

    接続方法として [IAM ID を使用した一時的な認証情報] を使用してデフォルトのデータベースに接続していること、および AWS Glue データベースの使用権限が IAM 認証情報に付与されていることを確認します。

    GRANT USAGE ON DATABASE glue-database to "IAM:MyIAMUser"

    AWS Glue データベースは、クエリエディタ v2 のエディタタブに表示されますが、直接接続には使用できません。

    AWS Glue Data Catalog にクエリを実行する方法の詳細については、「Amazon Redshift データベース開発者ガイド」の「コンシューマーとして Lake Formation 管理のデータ共有を使用する」と「プロデューサーとして Lake Formation 管理のデータ共有を使用する」を参照してください。。

データ共有コンシューマーとしてデータベースを作成する例

次の例は、クエリエディタ v2 を使用してデータ共有からデータベースを作成するために使用した特定のシナリオを示しています。このシナリオを通じて、使用環境でデータ共有からデータベースをどのようにして作成できるかを確認してください。このシナリオでは、cluster-base(プロデューサークラスター) と cluster-view (コンシューマークラスター) の 2 つのクラスターを使用します。

  1. Amazon Redshift コンソールを使用してクラスター cluster-base でテーブル category2 のデータ共有を作成します。プロデューサーデータ共有の名前は datashare_base です。

    データ共有の作成の詳細については、「Amazon Redshift データベース開発者ガイド」の「Amazon Redshift でのクラスター間のデータの共有」を参照してください。

  2. Amazon Redshift コンソールを使用して、クラスター cluster-view でテーブル category2 のコンシューマーとしてデータ共有 datashare_base を受け入れます。

  3. クエリエディタ v2 のツリービューパネルを開いて、次のような cluster-base の階層を表示します。

    • クラスター: cluster-base

      • データベース: dev

        • スキーマ：public

          • テーブ: category2

  4. Create[作成] を選択し、次に [データベース] を選択します。

  5. [データベース名] に「see_datashare_base」と入力します。

  6. [データ共有を使用して作成する] を選択し、[データ共有を選択] を選択します。作成するデータベースのソースとして使用する datashare_base を選択します。

    クエリエディタ v2 のツリービューパネルに、次のように cluster-view の階層が表示されます。

    • クラスター: cluster-view

      • データベース: see_datashare_base

        • スキーマ：public

          • テーブル: category2

  7. データをクエリするときは、クラスター cluster-view のデフォルトデータベース (通常は dev という名前) に接続しますが、SQL でデータ共有データベース see_datashare_base を参照します。

    注記

    クエリエディタ v2 のエディタビューでは、選択したクラスターは cluster-view です。選択したデータベースは dev です。データベース see_datashare_base は表示されますが、直接接続には使用できません。dev データベースを選択し、実行した SQL で see_datashare_base を参照します。

    SELECT * FROM "see_datashare_base"."public"."category2";

    クエリは、クラスター cluster_base のデータ共有 datashare_base からデータを取得します。

AWS Glue Data Catalog からデータベースを作成する例

次の例は、クエリエディタ v2 を使用して AWS Glue Data Catalog からデータベースを作成するために使用した特定のシナリオを示しています。このシナリオを通じて、使用環境で AWS Glue Data Catalog からデータベースをどのようにして作成できるかを確認してください。このシナリオでは 1 つのクラスター cluster-view を使用して、作成したデータベースを格納します。

  1. Create[作成] を選択し、次に [データベース] を選択します。

  2. [データベース名] に「data_catalog_database」と入力します。

  3. [AWS Glue Data Catalogを使用して作成する] を選択し、[AWS Glue データベースを選択] を選択します。作成するデータベースのソースとして使用する glue_db を選択します。

    [データカタログスキーマ] を選択し、3 つの部分からなる表記で使用するスキーマ名として「myschema」と入力します。

    クエリエディタ v2 のツリービューパネルに、次のように cluster-view の階層が表示されます。

    • クラスター: cluster-view

      • データベース: data_catalog_database

        • スキーマ：myschema

          • テーブ: category3

  4. データをクエリするときは、クラスター cluster-view のデフォルトデータベース (通常は dev という名前) に接続しますが、SQL でデータベース data_catalog_database を参照します。

    注記

    クエリエディタ v2 のエディタビューでは、選択したクラスターは cluster-view です。選択したデータベースは dev です。データベース data_catalog_database は表示されますが、直接接続には使用できません。dev データベースを選択し、実行した SQL で data_catalog_database を参照します。

    SELECT * FROM "data_catalog_database"."myschema"."category3";

    クエリは、AWS Glue Data Catalog でカタログ化されたデータを取得します。

スキーマの作成

クエリエディタ v2 を使用して、クラスターまたはワークグループにスキーマを作成できます。

スキーマを作成するには

スキーマについては、「Amazon Redshift データベースデベロッパーガイド」の「スキーマ」を参照してください。

  1. Create[作成]を選択し、[スキーマ] を選択します。

  2. [スキーマ名] を入力します。

  3. [Local] (ローカル) または[External] (外部) を [Schema type] (スキーマタイプ) として選択します。

    ローカルスキーマの詳細については、Amazon Redshift データベースデベロッパーガイドの「スキーマの作成」を参照してください。外部スキーマの詳細については、Amazon Redshift データベースデベロッパーガイドの「外部スキーマの作成」を参照してください。

  4. [External] (外部) を選択すると、外部スキーマの次の選択肢があります。

    • Glue データカタログ — AWS Glue 内のテーブルを参照する外部スキーマを Amazon Redshift に作成します。AWS Glue データベースを選択する以外に、クラスターに関連付けられた IAM ロールとデータカタログに関連付けられた IAM ロールを選択します。

    • PostgreSQL — Amazon Redshift で、Amazon RDS for PostgreSQL または Amazon Aurora PostgreSQL-Compatible Edition データベースを参照する外部スキーマを作成します。データベースの接続情報も提供します。詳細については、Amazon Redshift データベースデベロッパーガイドの「フェデレーテッドクエリを使用したデータのクエリ」を参照してください。

    • MySQL — Amazon Redshift で、Amazon RDS for MySQL または Amazon Aurora MySQL-Compatible Edition データベースを参照する外部スキーマを作成します。データベースの接続情報も提供します。フェデレーティッドクエリの詳細については、「Amazon Redshift データベースデベロッパーガイド」の「フェデレーテッドクエリを使用したデータのクエリ」を参照してください。

  5. [スキーマの作成] を選択します。

    ツリービューパネルに新しいスキーマが表示されます。

テーブルの作成

クエリエディタ v2 を使用して、クラスターまたはワークグループにテーブルを作成できます。

テーブルを作成するには

テーブルの各列を指定または定義するカンマ区切り値 (CSV) ファイルに基づいてテーブルを作成できます。テーブルの詳細については、「Amazon Redshift データベースデベロッパーガイド」の「テーブル設計」と「CREATE TABLE」を参照してください。

[エディタでクエリを開く] をクリックして [CREATE TABLE] のステートメントを表示して編集してから、クエリを実行してテーブルを作成します。

  1. Create[Create] (作成)、[Table] (テーブル) の順に選択します。

  2. スキーマを選択します。

  3. テーブル名を入力します。

  4. Create [フィールドの追加] を選択して列を追加します。

  5. CSV ファイルをテーブル定義のテンプレートとして使用します。

    1. [CSV からロードする] を選択します。

    2. ファイルの場所をブラウズします。

      CSV ファイルを使用する場合は、ファイルの最初の行に列見出しが含まれていることを確認してください。

    3. ファイルを選択し、[開く] を選択します。列の名前とデータ型が意図したものであることを確認します。

  6. 各列について、列を選択し、必要なオプションを選択します。

    • [エンコード] の値を選択します。

    • [デフォルト値] を選択します。

    • 列の値を増分させたい場合は、[Automatically increment] (自動増分) をオンにします。次に、[Auto increment seed] (自動増分シード) と [Auto increment step] (自動増分ステップ) の値を指定します。

    • 列が常に値を含む必要がある場合は、[Not NULL] をオンにします。

    • 列の [サイズ] 値を入力します。

    • 列をプライマリキーにしたい場合は、[プライマリキー] をオンにします。

    • 列を一意のキーにしたい場合は、[Unique key] (一意のキー) をオンにします。

  7. (任意) [テーブルの詳細] を選択し、以下のいずれかのオプションを選択します。

    • 分散キーの列とスタイル。

    • ソートキー列とソートタイプ。

    • [Backup] (バックアップ) をオンにして、クラスタースナップショットにテーブルを含めます。

    • [一時テーブル] をオンにして、一時テーブルを作成します。

  8. [エディタでクエリを開く] をクリックしてテーブルを定義するオプションの指定を続行するか テーブルの作成 を選択してテーブルを作成します。

関数の作成

クエリエディタ v2 を使用して、クラスターまたはワークグループに関数を作成できます。

関数を作成するには

  1. Create[作成] を選択し [関数] を選択します。

  2. [タイプ] については [SQL] または [Python] を選択します。

  3. [スキーマ] の値を選択します。

  4. 関数の [名前] に値を入力します。

  5. 関数の [Volatility] (ボラティリティ) に値を入力します。

  6. 入力パラメータの順に、データ型別に [パラメータ] を選択します。

  7. [戻り値] で、データ型を選択します。

  8. 関数の [SQL プログラム] または [Python プログラム] コードを入力します。

  9. [Create] (作成) を選択します。

ユーザー定義関数 (UDF) の詳細については、「Amazon Redshift データベースデベロッパーガイド」の「ユーザー定義関数の作成」を参照してください。

クエリとタブの履歴を表示する

クエリ履歴は、クエリエディタ v2 で表示できます。クエリエディタ v2 を使用して実行したクエリのみがクエリ履歴に表示されます。[Editor] (エディタ) タブまたは [Notebook] (ノートブック) タブを使用して実行された両方のクエリが表示されます。表示されるリストを、This week のように月曜日から日曜日と 1 週間と定義するなど、期間でフィルタリングできます。クエリのリストは、フィルターに一致するクエリを一度に 25 行取得します。[Load more] (さらに読み込む) を選択すると、次のセットが表示されます。[Actions] (アクション) メニューからクエリを選択します。実行できるアクションは、選択したクエリが保存されているかどうかによって変わります。以下の操作を選択できます。

  • [View query details] (クエリの詳細を表示) — 実行済みクエリに関する情報の詳細ページを表示します。

  • [Open query in a new tab] (新しいタブでクエリを開く)— 新しいエディタタブを開き、選択したクエリをプライミングします。接続中の場合、クラスターまたはワークグループと、データベースが自動的に選択されます。クエリを実行するには、まず、正しいクラスターまたはワークグループと、データベースが選択されていることを確認します。

  • [Open source] (ソースを開く)–タブ — そのまま開いている場合は、クエリの実行時に含まれていたエディタまたはノートブックのタブに移動します。クエリの実行後にエディタまたはノートブックの内容が変更された可能性があります。

  • [Open saved query] (保存したクエリを開く) — [Editor] (エディタ) タブまたは [Notebook] (ノートブック) タブに移動してクエリを開きます。

また、[Editor] (エディタ) タブまたは [Notebook] (ノートブック) タブで実行されたクエリの履歴を表示できます。クエリの履歴をタブで表示するには、[Tab history] (タブ履歴) を選択します。タブ履歴では、次の操作を実行できます。

  • [Copy query] (クエリのコピー)— クエリバージョンの SQL コンテンツをクリップボードにコピーします。

  • [Open query in a new tab] (新しいタブでクエリを開く)— 新しいエディタタブを開き、選択したクエリをプライミングします。クエリを実行するには、クラスター、ワークグループ、データベースを選択する必要があります。

  • [View query details] (クエリの詳細を表示) — 実行済みクエリに関する情報の詳細ページを表示します。

クエリエディタ v2 を使用する際の考慮事項

クエリエディタ v2 を使用する場合は、次の点を考慮してください。

  • クエリ結果の最大サイズは、5 MB または 100,000 行のうち小さい方です。

  • 最大 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 を表示します。