# AWS Toolkit for JetBrains를 사용하여 Amazon RDS에 액세스
<a name="accessing-rds"></a>

Amazon Relational Database Service(Amazon RDS)를 사용하면 클라우드에서 SQL 관계형 데이터베이스 시스템을 프로비저닝하고 관리할 수 있습니다. AWS Toolkit for JetBrains를 사용하면 다음 Amazon RDS 데이터베이스 엔진에 연결하고 상호 작용할 수 있습니다.
+ Aurora – 클라우드용으로 구축된 MySQL 및 PostgreSQL 호환 관계형 데이터베이스입니다. 자세한 내용은 [**Amazon Aurora 사용 설명서](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html)를 참조하세요.
+ MySQL – Amazon RDS는 오픈 소스 관계형 데이터베이스의 여러 주요 버전을 지원합니다. 자세한 내용은 **Amazon RDS 사용 설명서의 [Amazon RDS의 MySQL](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html)을 참조하세요.
+ PostgreSQL – Amazon RDS는 오픈 소스 객체 관계형 데이터베이스의 여러 주요 버전을 지원합니다. 자세한 내용은 **Amazon RDS 사용 설명서의 [Amazon RDS for PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html)을 참조하세요.

다음 주제에서는 RDS 데이터베이스에 액세스하기 위한 사전 조건과 AWS Toolkit for JetBrains를 사용하여 데이터베이스 인스턴스에 연결하는 방법을 설명합니다.

**Topics**
+ [Amazon RDS 데이터베이스 액세스를 위한 사전 조건](rds-access-prerequisities.md)
+ [Amazon RDS 데이터베이스에 연결](rds-connection.md)

# Amazon RDS 데이터베이스 액세스를 위한 사전 조건
<a name="rds-access-prerequisities"></a>

AWS Toolkit for JetBrains를 사용하여 Amazon RDS 데이터베이스에 연결하려면 먼저 다음 태스크를 완료해야 합니다.
+ [DB 인스턴스 생성 및 인증 방법 설정](#db-authentication)
+ [DataGrip 다운로드 및 설치](#datagrip-info)

## Amazon RDS DB 인스턴스 생성 및 인증 방법 구성
<a name="db-authentication"></a>

 AWS Toolkit for JetBrains를 사용하면 AWS에서 이미 생성되고 구성된 Amazon RDS DB 인스턴스에 연결할 수 있습니다. DB 인스턴스는 사용자가 생성한 여러 데이터베이스를 포함할 수 있는 클라우드에서 실행되는 격리된 데이터베이스 환경입니다. 지원되는 데이터베이스 엔진용 DB 인스턴스 생성에 대한 자세한 내용은 **Amazon RDS 사용 설명서의 [Amazon RDS 시작하기](Amazon RDS User GuideCHAP_GettingStarted.html)를 참조하세요.

AWS Toolkit for JetBrains를 사용하여 데이터베이스에 연결할 때 사용자는 IAM 보안 인증 또는 Secrets Manager를 사용하여 인증하도록 선택할 수 있습니다. 다음 표에는 두 옵션의 주요 기능 및 정보 리소스가 설명되어 있습니다.


****  

| 인증 방법 | 작동 방식 | 추가 정보 | 
| --- | --- | --- | 
|  IAM 보안 인증을 사용하여 연결  |  IAM 데이터베이스 인증을 사용하면 인증이 AWS Identity and Access Management(IAM) 보안 인증을 사용하여 외부에서 관리되므로 데이터베이스에 사용자 보안 인증을 저장할 필요가 없습니다.DB 인스턴스에서는 기본적으로 IAM 데이터베이스 인증이 비활성화되어 있습니다. IAM 데이터베이스 인증은 AWS Management Console, AWS CLI 또는 API를 사용하여 활성화하거나 다시 비활성화할 수 있습니다.  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/toolkit-for-jetbrains/latest/userguide/rds-access-prerequisities.html)  | 
|  AWS Secrets Manager를 사용하여 연결  |  데이터베이스 관리자는 데이터베이스에 대한 보안 인증을 Secrets Manager에 보안 정보로 저장할 수 있습니다. Secrets Manager는 보안 인증을 암호화하여 보안 암호 내에 *보호되는 보안 암호 텍스트*로 저장합니다. 권한이 있는 애플리케이션이 데이터베이스에 액세스하면 Secrets Manager는 보호된 비밀 텍스트를 해독하고 보안 채널을 통해 반환합니다. 클라이언트는 보안 인증, 연결 문자열 및 기타 필요한 정보를 구문 분석한 다음 해당 정보를 사용하여 데이터베이스에 액세스합니다.  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/toolkit-for-jetbrains/latest/userguide/rds-access-prerequisities.html)  | 

## DataGrip을 사용하여 Amazon RDS 데이터베이스 작업
<a name="datagrip-info"></a>

Amazon RDS 데이터 소스에 연결한 후 데이터 소스와 상호 작용을 시작할 수 있습니다. JetBrains의 DataGrip을 사용하면 SQL 작성, 쿼리 실행, 데이터 가져오기/내보내기와 같은 데이터베이스 태스크를 수행할 수 있습니다. DataGrip에서 제공하는 기능은 다양한 JetBrains IDE의 데이터베이스 플러그인에서도 사용할 수 있습니다. DataGrip에 대한 자세한 내용은 [https://www.jetbrains.com/datagrip/](https://www.jetbrains.com/datagrip/)을 참조하세요.

# Amazon RDS 데이터베이스에 연결
<a name="rds-connection"></a>

**AWS Explorer**를 사용하면 Amazon RDS 데이터베이스를 선택하고 인증 방법을 선택한 다음 연결 설정을 구성할 수 있습니다. 연결 테스트에 성공하면 JetBrains DataGrip을 사용하여 데이터 소스와의 상호 작용을 시작할 수 있습니다.

**중요**  
사용자가 Amazon RDS 데이터베이스에 액세스하고 상호 작용할 수 있도록 [사전 조건](rds-access-prerequisities.md)을 완료했는지 확인하세요.

기본 인증 방법을 사용하여 데이터베이스 인스턴스에 연결하는 방법에 대한 지침을 보려면 탭을 선택합니다.

------
#### [ Connect with IAM credentials ]

1. AWS Explorer가 열려 있지 않은 경우 이를 엽니다.

1. **Amazon RDS** 노드를 클릭하여 지원되는 데이터베이스 엔진 목록을 확장합니다.

1. 지원되는 데이터베이스 엔진(Aurora, MySQL 또는 PostgreSQL) 노드를 클릭하여 사용 가능한 데이터베이스 인스턴스 목록을 확장합니다.
**참고**  
Aurora를 선택하면 MySQL 클러스터 확장과 PostgreSQL 클러스터 확장 중에서 선택할 수 있습니다.

1. 데이터베이스를 마우스 오른쪽 버튼으로 클릭하고 **IAM 보안 인증으로 연결**을 선택합니다.
**참고**  
**ARN 복사**를 선택하여 클립보드에 데이터베이스의 Amazon 리소스 이름(ARN)을 추가할 수도 있습니다.

1. **데이터 소스 및 드라이버** 대화 상자에서 다음을 수행하여 데이터베이스 연결을 열 수 있도록 합니다.
   + **가져온 데이터 소스** 창에서 올바른 데이터 소스가 선택되었는지 확인합니다.
   + **누락된 드라이버 파일을 다운로드**해야 한다는 메시지가 표시되면 **드라이버로 이동**(렌치 아이콘)을 선택하여 필요한 파일을 다운로드합니다.

1. **설정** 창의 **일반** 탭에서 다음 필드에 올바른 값이 표시되는지 확인합니다.
   + **호스트/포트** - 데이터베이스 연결에 사용되는 엔드포인트와 포트입니다. AWS Cloud에서 호스팅되는 Amazon RDS 데이터베이스의 경우 엔드포인트는 항상 `rds.amazon.com`으로 끝납니다. 프록시를 통해 DB 인스턴스에 연결하는 경우 이 필드를 사용하여 프록시의 연결 세부 정보를 지정합니다.
   + **인증** - **AWS IAM**(IAM 보안 인증을 사용한 인증)입니다.
   + **사용자** – 데이터베이스 사용자 계정의 이름입니다.
   + **보안 인증** - AWS 계정에 액세스하는 데 사용되는 보안 인증입니다.
   + **리전** - 데이터베이스가 호스팅되는 AWS 리전입니다.
   + **RDS 호스트/포트** - AWS Management Console에 나열된 데이터베이스의 엔드포인트 및 포트입니다. 다른 엔드포인트를 사용하여 DB 인스턴스에 연결하는 경우 **호스트/포트** 필드에 프록시의 연결 세부 정보를 지정합니다(앞서 설명).
   + **데이터베이스** – 데이터베이스의 이름입니다.
   + **URL** – JetBrains IDE가 데이터베이스에 연결하는 데 사용할 URL입니다.  
![\[인증용 IAM 보안 인증을 사용하는 Amazon RDS 데이터베이스에 대한 연결 설정\]](http://docs.aws.amazon.com/ko_kr/toolkit-for-jetbrains/latest/userguide/images/rds-auth-iam.png)
**참고**  
**데이터 소스 및 드라이버** 대화 상자를 사용하여 구성할 수 있는 연결 설정에 대한 자세한 설명은 사용 중인 [JetBrains IDE의 설명서](https://www.jetbrains.com/help/)를 참조하세요.

1. 연결 설정이 올바른지 확인하려면 **연결 테스트**를 선택합니다.

   녹색 확인 표시는 테스트 성공을 나타냅니다.

1. **적용**을 선택하여 설정을 적용한 다음 **확인**을 선택하여 데이터 소스 작업을 시작합니다.

   **데이터베이스** 도구 창이 열립니다. 그러면 사용 가능한 데이터 소스가 스키마, 테이블, 키 등의 데이터베이스 요소를 나타내는 노드가 있는 트리로 표시됩니다.
**중요**  
**데이터베이스** 도구 창을 사용하려면 먼저 JetBrains에서 DataGrip을 다운로드하여 설치해야 합니다. 자세한 내용은 [https://www.jetbrains.com/datagrip/](https://www.jetbrains.com/datagrip/)을 참조하세요.

------
#### [ Connect with Secrets Manager ]

1. AWS Explorer가 열려 있지 않은 경우 이를 엽니다.

1. **Amazon RDS** 노드를 클릭하여 지원되는 데이터베이스 엔진 목록을 확장합니다.

1. 지원되는 데이터베이스 엔진(Aurora, MySQL 또는 PostgreSQL) 노드를 클릭하여 사용 가능한 데이터베이스 인스턴스 목록을 확장합니다.
**참고**  
Aurora를 선택하면 MySQL 클러스터 확장과 PostgreSQL 클러스터 확장 중에서 선택할 수 있습니다.

1. 데이터베이스를 마우스 오른쪽 버튼으로 클릭하고 **Secrets Manager와 연결**을 선택합니다.
**참고**  
**ARN 복사**를 선택하여 클립보드에 데이터베이스의 Amazon 리소스 이름(ARN)을 추가할 수도 있습니다.

1. **데이터베이스 보안 암호 선택** 대화 상자에서 드롭다운 필드를 사용하여 데이터베이스에 대한 보안 인증을 선택한 다음 **생성**을 선택합니다.

1. **데이터 소스 및 드라이버** 대화 상자에서 다음을 수행하여 데이터베이스 연결을 열 수 있도록 합니다.
   + **가져온 데이터 소스** 창에서 올바른 데이터 소스가 선택되었는지 확인합니다.
   + **누락된 드라이버 파일을 다운로드**해야 한다는 메시지가 표시되면 **드라이버로 이동**(렌치 아이콘)을 선택하여 필요한 파일을 다운로드합니다.

1. **설정** 창의 **일반** 탭에서 다음 필드에 올바른 값이 표시되는지 확인합니다.
   + **호스트/포트** - 데이터베이스 연결에 사용되는 엔드포인트와 포트입니다. AWS Cloud에서 호스팅되는 Amazon RDS 데이터베이스의 경우 엔드포인트는 항상 `rds.amazon.com`으로 끝납니다. 프록시 데이터베이스를 통해 데이터베이스에 연결하는 경우 이 필드를 사용하여 프록시의 연결 세부 정보를 지정합니다.
   + **인증** – **SecretsManager Auth**(AWS Secrets Manager를 사용하여 인증)입니다.
   + **보안 인증** - AWS 계정에 액세스하는 데 사용되는 보안 인증입니다.
   + **리전** - 데이터베이스가 호스팅되는 AWS 리전입니다.
   + **보안 암호/ARN** - 인증 보안 인증 정보가 포함된 보안 암호의 이름과 ARN입니다. **호스트/포트** 필드의 연결 설정을 재정의하려면 **보안 암호의 URL 및 포트 사용** 확인란을 선택합니다.
   + **데이터베이스** - **AWS Explorer**에서 선택한 데이터베이스 인스턴스의 이름입니다.
   + **URL** – JetBrains IDE가 데이터베이스에 연결하는 데 사용할 URL입니다.
**참고**  
인증에 Secrets Manager를 사용하는 경우 데이터베이스의 사용자 이름 및 암호 필드가 없습니다. 이 정보는 보안 암호의 암호화된 보안 암호 데이터 부분에 포함되어 있습니다.  
![\[인증용 IAM 보안 인증을 사용하는 연결 설정\]](http://docs.aws.amazon.com/ko_kr/toolkit-for-jetbrains/latest/userguide/images/rds-auth-asm.png)
**참고**  
**데이터 소스 및 드라이버** 대화 상자를 사용하여 구성할 수 있는 연결 설정에 대한 자세한 설명은 사용 중인 [JetBrains IDE의 설명서](https://www.jetbrains.com/help/)를 참조하세요.

1. 연결 설정이 올바른지 확인하려면 **연결 테스트**를 선택합니다.

   녹색 확인 표시는 테스트 성공을 나타냅니다.

1. **적용**을 선택하여 설정을 적용한 다음 **확인**을 선택하여 데이터 소스 작업을 시작합니다.

   **데이터베이스** 도구 창이 열립니다. 그러면 사용 가능한 데이터 소스가 스키마, 테이블, 키 등의 데이터베이스 요소를 나타내는 노드가 있는 트리로 표시됩니다.
**중요**  
**데이터베이스** 도구 창을 사용하려면 먼저 JetBrains에서 DataGrip을 다운로드하여 설치해야 합니다. 자세한 내용은 [https://www.jetbrains.com/datagrip/](https://www.jetbrains.com/datagrip/)을 참조하세요.

------