# Aurora DSQL 쿼리 편집기 시작하기
<a name="getting-started-query-editor"></a>

Aurora DSQL 쿼리 편집기를 사용하면 외부 클라이언트를 설치하거나 구성하지 않고도 Aurora DSQL 클러스터에 안전하게 연결하고 AWS Management Console에서 직접 SQL 쿼리를 실행할 수 있습니다. 기본 제공 구문 강조 표시, 자동 완성 및 지능형 코드 지원이 포함된 직관적인 워크스페이스를 제공합니다. 단일 인터페이스 내에서 스키마 객체를 빠르게 탐색하고, SQL 쿼리를 개발 및 실행하고, 결과를 볼 수 있습니다.

이 주제에서는 클러스터에 연결하고, 쿼리를 실행하고, 결과를 보고, 실행 계획과 같은 고급 기능을 탐색하는 단계를 안내합니다.

**참고**  
쿼리 편집기는 Aurora DSQL이 지원되는 모든 리전에서 사용할 수 있습니다. 리전별 가용성에 대한 자세한 내용은 [리전별 AWS 서비스](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/)를 참조하세요.

## 사전 조건
<a name="query-editor-prerequisites"></a>

시작하기 전에 다음 요구 사항을 충족하는지 확인하세요.
+ 사용 가능한 Aurora DSQL 클러스터가 하나 이상 있습니다. 클러스터 만들기에 대한 자세한 내용은 [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. (선택 사항) 서로 다른 역할을 사용하여 여러 클러스터 또는 동일한 클러스터에 연결합니다.

### 클러스터 객체 탐색
<a name="query-editor-explore"></a>

클러스터 탐색기는 사용 가능한 모든 클러스터 연결을 표시하고 데이터베이스, 스키마, 테이블 및 뷰와 같은 객체를 검색할 수 있습니다. 또한 **새로 고침**, **테이블 생성** 및 기타 컨텍스트별 옵션과 같은 일반적인 작업을 제공합니다.

### 쿼리 실행
<a name="query-editor-run-queries"></a>

**쿼리를 실행하려면**

1. 쿼리 편집기 탭 창에 SQL 문을 입력합니다. 예제:

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

1. 쿼리 탭의 오른쪽 상단에 표시된 **활성 클러스터 컨텍스트**를 확인합니다. 이는 현재 쿼리 탭과 연결된 클러스터 연결을 나타냅니다.

1. (선택 사항) **연결** 드롭다운을 사용하여 사용 가능한 모든 연결을 검토하거나 다른 클러스터로 전환합니다. 해당 탭의 쿼리가 실행되는 연결 업데이트 변경.

1. 그런 다음 **Run**(실행)을 선택하여 쿼리를 실행합니다.

**참고**  
각 쿼리는 결과 창에서 최대 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 문에서 사용하는 리소스를 즉시 파악할 수 있습니다.