[AWS] Aurora DSQL 통합 Query Editor 구성 및 사용 가이드

AWS에서 2025년 11월 정식으로 Amazon Aurora DSQL 통합 Query Editor 기능이 출시되었습니다. 이를 통해 별도 클라이언트 설치 없이 AWS Management Console 브라우저에서 바로 SQL 실행 및 데이터 탐색이 가능합니다.

1. 개요 및 특징

Amazon Aurora DSQL 통합 Query Editor는 Aurora DSQL 클러스터에 직접 연결해 SQL 작업을 브라우저에서 실행할 수 있는 기능입니다. 외부 도구나 설치가 필요 없어 설정 시간을 대폭 절약할 수 있습니다.

주요 특징:

• 브라우저 기반 실행: AWS 콘솔에서 직접 SQL 실행 가능
• Syntax Highlighting, Auto-completion, Intelligent Code Assistance 제공
• 스키마 탐색, 쿼리 실행, 결과 확인을 하나의 인터페이스에서 처리
• 별도 설치/설정 필요 없음
• 지원 리전: Aurora DSQL이 제공되는 모든 리전

2. 사전 준비

Query Editor를 사용하기 전에 몇 가지 사전 조건을 충족해야 합니다.

2.1. Aurora DSQL 클러스터 준비

• Aurora DSQL 클러스터가 생성되어 있어야 합니다.
  클러스터가 생성되지 않았다면 콘솔에서 먼저 생성해야 합니다.

2.2. 클러스터 접근 설정

• 클러스터 엔드포인트가 공개 접근 또는 적절한 네트워크 정책에 의해 접근 가능해야 합니다.
• 현재 Query Editor는 VPC 엔드포인트 전용 접속만으로는 연결을 지원하지 않습니다.

2.3. IAM 권한

Query Editor를 사용하려면 AWS IAM 계정 또는 역할에 필요한 권한이 있어야 합니다.

예를 들어 아래 수준의 권한이 적정합니다:

• Aurora DSQL 콘솔 접속 권한
• 클러스터에 연결할 수 있는 IAM 권한
• 데이터베이스 연결에 필요한 자격 증명 및 Secrets Manager 접근 권한

3. 콘솔에서 Query Editor 실행

AWS 콘솔에서 Aurora DSQL Query Editor를 실행하는 순서는 다음과 같습니다.

3.1. Query Editor 열기

1. AWS Management Console에 로그인합니다.
2. Aurora DSQL 서비스로 이동합니다.
3. 왼쪽 메뉴에서 Query Editor를 선택합니다.
   • 또는 클러스터 목록에서 Connect with Query editor를 통해 바로 진입할 수 있습니다.

3.2. 클러스터 연결

Query Editor 화면에서 클러스터에 연결할 수 있는 버튼이 표시됩니다.

• Connect 버튼을 클릭하고
• 사용할 클러스터와 역할(IAM 또는 DB 역할)을 선택합니다.
• 연결 완료 후 SQL 입력창이 활성화됩니다.

4. SQL 실행 및 탐색

Query Editor가 열리고 클러스터에 연결되면 다음 작업들을 수행할 수 있습니다.

4.1. 테이블, 스키마 탐색

• 왼쪽 Cluster Explorer에서 데이터베이스, 스키마, 테이블 및 뷰를 확인할 수 있습니다.
• 객체 이름을 클릭하면 테이블 구조 등의 메타데이터를 빠르게 확인할 수 있습니다.

4.2. 쿼리 작성

SQL 입력창에 원하는 쿼리를 입력합니다.

예시:

SELECT * FROM public.orders LIMIT 10;

• 자동 완성 및 구문 하이라이트를 활용하여 편리하게 작성합니다.

4.3. 실행 및 결과 확인

• Run 버튼을 클릭하여 쿼리를 실행합니다.
• 결과는 아래 패널에서 표 형태로 확인할 수 있습니다.
• 기본적으로 쿼리 결과는 최대 10,000행까지만 표시됩니다.

5. 실행 계획 확인

Aurora DSQL에서는 쿼리 실행 계획을 확인하여 성능을 분석할 수도 있습니다.

• SQL 앞에 EXPLAIN ANALYZE 또는 EXPLAIN ANALYZE VERBOSE를 붙여 실행합니다.
• 이 명령을 통해 DPU 리소스 소비량 및 상세 실행 계획을 파악할 수 있습니다.

6. 권한 및 보안 고려사항

Query Editor는 AWS 콘솔 권한 모델을 따르기 때문에 IAM 정책이 중요합니다.

• Secrets Manager 권한이 적절히 설정되어 있어야 합니다.
• 클러스터 접근에 필요한 네트워크 레벨의 설정은 별도로 구성되어야 합니다.
• IAM 사용자/역할에는 최소 권한 원칙을 적용하는 것이 보안상 안전합니다.