DBeaver를 사용하여 Aurora DSQL에 액세스 - Amazon Aurora DSQL
DBeaver ProDBeaver Community Edition문제 해결

DBeaver를 사용하여 Aurora DSQL에 액세스

DBeaver는 JDBC 드라이버가 있는 데이터베이스를 관리하는 데 사용할 수 있는 범용 SQL 클라이언트입니다. 강력한 데이터 보기, 편집 및 관리 기능 덕분에 개발자와 데이터베이스 관리자 사이에서 널리 사용됩니다. DBeaver의 클라우드 연결 옵션을 사용하면 기본적으로 DBeaver를 Aurora DSQL에 연결할 수 있습니다.

DBeaver Pro

DBeaver PRO 제품은 버전 25.3부터 Aurora DSQL과의 기본 통합을 제공합니다. DBeaver 설명서의 지침에 따라 Aurora DSQL 클러스터에 연결합니다.

DBeaver Community Edition

DBeaver Community Edition은 무료 오픈 소스 버전입니다. 설치 지침은 다운로드 페이지를 참조하십시오. DBeaver Community Edition에서 DSQL에 연결하려면 DBeaver용 Aurora DSQL 플러그인을 설치해야 합니다.

DBeaver용 Aurora DSQL 플러그인은 JDBC용 Aurora DSQL 커넥터를 기반으로 구축되었으며 Aurora DSQL 클러스터에 대한 IAM 인증을 활성화합니다. DBeaver UI를 통해 편리하게 설치되므로 토큰 생성 코드를 작성하거나 유효한 IAM 토큰을 수동으로 제공할 필요가 없으므로 기존 사용자 생성 암호와 관련된 보안 위험을 제거하면서 인증을 간소화할 수 있습니다.

특성

  • IAM 인증 지원: 안전하고 암호 없는 인증을 위해 AWS IAM 자격 증명을 사용하여 Aurora DSQL 클러스터에 연결

  • 자동 드라이버 관리: JDBC용 Aurora DSQL 커넥터를 원활하게 설치하고 구성합니다.

  • 유연한 연결 옵션: 호스트 기반 또는 JDBC URL 기반 연결 구성 중에서 선택

DBeaver 설치를 위한 Aurora DSQL 플러그인

  1. DBeaver를 연 상태에서 드롭다운 메뉴 도움말 → 새 소프트웨어 설치로 이동합니다.

  2. 추가를 클릭하여 새 리포지토리를 추가합니다.

  3. 입력:

    • 이름: Aurora DSQL Plugin

    • 위치: https://awslabs.github.io/aurora-dsql-dbeaver-plugin/update-site/

  4. JDBC용 Aurora DSQL 커넥터 확인

  5. 다음을 클릭하고 라이선스를 수락한 후 설치를 완료합니다.

  6. 메시지가 표시되면 DBeaver 다시 시작

Aurora DSQL 연결 생성

  1. 새 데이터베이스 연결을 클릭합니다.

  2. Aurora DSQL 선택

  3. 다음 필드에 대해 사용자 인터페이스 텍스트 입력을 활성화하려면 서버에서 연결 기준 설정에 대해

    • 호스트:

      • 다음 중 하나를 선택합니다.

        • 엔드포인트: DSQL 클러스터 엔드포인트

        • 사용자 이름: DSQL 사용자 이름(예: admin)

        • AWS 프로필: 기본값 예 - 특정 프로필이 지정되지 않은 경우 사용되는 표준 프로필

        • AWS 리전(선택 사항): DSQL 클러스터가 있는 리전과 일치해야 합니다. 그렇지 않으면 인증이 실패합니다.

    • URL

      • 다음 형식의 JDBC URL: 

        jdbc:aws-dsql:postgresql://{cluster_endpoint}/{database}?user=admin&profile=default&region=us-east-1

      • 참고: 이 모드에서는 URL 입력만 활성화됩니다. JDBC 연결 문자열에 파라미터를 추가하려면 ?로 시작하는 URL 쿼리 파라미터 형식을 첫 번째 파라미터로 사용하고 후속 파라미터에 &를 추가합니다.

  4. 연결 테스트를 클릭하여 Aurora DSQL 연결이 작동하는지 확인합니다.

  5. 완료를 클릭합니다.

문제 해결

Windows Trust Store 문제

Windows 사용자는 Maven Central에서 JDBC 드라이버용 Aurora DSQL 커넥터를 다운로드하는 데 문제가 발생할 수 있습니다.

원인: Windows Trust Store에는 Maven Central 리포지토리에 액세스하는 데 필요한 인증서가 포함되지 않을 수 있습니다.

해결 방법:

  1. DBeaver를 "관리자"로 실행

  2. 이 설정 선택 취소 - Windows > 기본 설정 > 연결 > "Windows Trust Store 사용"

드라이버 누락 오류

누락된 드라이버 아이콘 또는 연결 오류가 표시되면 현재 DBeaver 버전에 Aurora DSQL(Community 플러그인)이 설치되지 않을 수 있습니다. 아래 오류의 몇 가지 예와 이를 수정하는 방법을 참조하세요.

  • 누락된 드라이버로 새 연결 생성:

    DBeaver의 드라이버 누락 아이콘

  • 드라이버 없이 연결 시도:

    드라이버가 누락된 경우 오류 대화 상자

원인: 여러 DBeaver 버전이 설치된 경우 연결 설정은 공유되지만 드라이버는 애플리케이션별로 설치됩니다.

해결 방법: 위의 설치 단계에 따라 Aurora DSQL(Community 플러그인)을 다시 설치합니다.

중요

PostgreSQL 데이터베이스에 대해 DBeaver에서 제공하는 관리 기능(예: 세션 관리자 및 잠금 관리자)은 고유한 아키텍처로 인해 Aurora DSQL 데이터베이스에 적용되지 않습니다. 이러한 화면은 액세스 가능하지만 데이터베이스 상태에 대한 신뢰할 수 있는 정보를 제공하지 않습니다.