# Aurora DSQL クエリエディタの使用を開始する
<a name="getting-started-query-editor"></a>

Aurora DSQL クエリエディタを使用すると、外部クライアントをインストールまたは設定することなく、Aurora DSQL クラスターに安全に接続し、AWS マネジメントコンソールから直接 SQL クエリを実行できます。組み込みの構文強調表示、自動補完、インテリジェントなコード支援を備えた直感的なワークスペースを提供します。スキーマオブジェクトの探索、SQL クエリの開発と実行、結果の表示をすべて 1 つのインターフェイスですばやく行うことができます。

このトピックでは、クラスターへの接続、クエリの実行、結果の表示、実行プランなどの高度な機能の詳細を確認する手順について説明します。

**注記**  
クエリエディタは、Aurora DSQL がサポートされているすべてのリージョンで利用できます。各リージョンでご利用いただけるサービスの詳細については、「[AWS リージョン別のサービス](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/)」を参照してください。

## 前提条件
<a name="query-editor-prerequisites"></a>

開始する前に、以下の前提条件を満たしていることを確認してください。
+ 使用可能な Aurora DSQL クラスターが少なくとも 1 つあります。クラスターの作成の詳細については、「[ステップ 1: Aurora DSQL 単一リージョンクラスターを作成する](getting-started.md#getting-started-create-cluster)」を参照してください。
+ クラスターエンドポイントはパブリックアクセス可能です。クエリエディタは、リソースベースのポリシーによってパブリックアクセスがブロックされているクラスター、または VPC エンドポイントを介して管理されているクラスターをサポートしていません。アクセス制限の詳細については、「[Aurora DSQL のリソースベースのポリシーでパブリックアクセスをブロックする](rbp-block-public-access.md)」および「[AWS PrivateLink を使用した Amazon Aurora DSQL クラスターの管理と接続](privatelink-managing-clusters.md)」を参照してください。
+ IAM ユーザーまたはロールには、クラスターにアクセスして接続するために必要なアクセス許可があります。アクセス許可の詳細については、「[データベースロールと IAM 認証の使用](using-database-and-iam-roles.md)」を参照してください。

## クエリエディタの操作
<a name="query-editor-working"></a>

### クエリエディタを開く
<a name="query-editor-open"></a>

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

1. [Aurora DSQL コンソール](https://console.aws.amazon.com/dsql)を開きます。

1. ナビゲーションペインで**クエリエディタ**を選択します。

または、**[クラスター]** ページから、クエリするクラスターを選択し、**[クエリエディタと接続]** を選択してエディタを直接起動します。

**注記**  
作業状態と接続状態は保存されません。Aurora DSQL コンソールから移動するか、ブラウザタブを閉じるか、サインアウトすると、接続、クエリテキスト、結果が失われます。

### クラスターに接続する
<a name="query-editor-connect"></a>

**クラスターに接続するには**

1. クラスター接続が存在しない場合、エディタには **[クラスターが接続されていません]** と表示されます。既存のクラスターに接続するには、**[クラスターエクスプローラー]** ペインで **[接続]** または **[\$1]** (追加) を選択します。

1. (オプション) 異なるロールを使用して、複数のクラスターまたは同じクラスターに接続します。

### クラスターオブジェクトを調べる
<a name="query-editor-explore"></a>

クラスターエクスプローラーには使用可能なすべてのクラスター接続が表示され、データベース、スキーマ、テーブル、ビューなどのオブジェクトを参照できます。また、**[更新]**、**[テーブルの作成]**、その他のコンテキスト固有のオプションなどの一般的なアクションも提供します。

### クエリを実行する
<a name="query-editor-run-queries"></a>

**クエリを実行する**

1. クエリエディタのタブペインで、SQL ステートメントを入力します。例えば、次のようになります。

   ```
   SELECT * FROM public.orders LIMIT 10;
   ```

1. クエリタブの右上に表示される **[アクティブクラスターコンテキスト]** を確認します。これは、現在のクエリタブに関連付けられているクラスター接続を示します。

1. (オプション) **[接続]** ドロップダウンを使用して、使用可能なすべての接続を確認するか、別のクラスターに切り替えます。接続を変更すると、そのタブのクエリが実行される場所が更新されます。

1. クエリを実行するには、**[実行]** を選択します。

**注記**  
各クエリは、結果ペインで最大 10,000 行を返すことができます。データセットが大きい場合は、フィルターまたは制限を使用してクエリを絞り込みます。

### 結果と実行計画を確認する
<a name="query-editor-view-results"></a>

クエリが実行されたら、エディタの下部にある **[結果パネル]** で出力を確認します。デフォルトでは、各クエリ実行には **[結果 (テーブル)]** タブが表示され、表形式のクエリ出力が表示されます。

クエリ実行プランを取得するには、`EXPLAIN ANALYZE` または `EXPLAIN ANALYZE VERBOSE` を実行して、クエリのパフォーマンスに関する追加のインサイトを取得します。実行計画の詳細については、「[Aurora DSQL EXPLAIN プランの読み取り](reading-dsql-explain-plans.md)」を参照してください。

**ヒント**  
`EXPLAIN ANALYZE VERBOSE` コマンドは、コンピューティング、読み取り、書き込み、合計 DPU 値を含む DPU 使用量の見積もりを表示し、個々の SQL ステートメントによって消費されるリソースを即座に可視化します。