기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon RDS/Aurora
데이터베이스 데이터 소스를 사용하여 데이터베이스에 저장된 문서를 인덱싱할 수 있습니다. 데이터베이스에 대한 연결 정보를 제공한 후는 문서를 Amazon Kendra연결하고 인덱싱합니다.
Amazon Kendra는 다음 데이터베이스를 지원합니다.
+ Amazon Aurora MySQL
+ Amazon Aurora PostgreSQL
+ Amazon RDSMySQL용
+ Amazon RDSPostgreSQL용
**참고**
Serverless Aurora 데이터베이스는 지원되지 않습니다.
**중요**
이 Amazon RDS/Aurora 커넥터는 2023년 말 사용이 중단될 예정입니다.
Amazon Kendra는 이제 새 데이터베이스 데이터 소스 커넥터를 지원합니다. 사용 환경을 개선하려면 사용 사례에 맞게 다음과 같은 새 커넥터를 선택하는 것이 좋습니다.
[Aurora(MySQL)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-aurora-mysql.html)
[Aurora(PostgreSQL)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-aurora-postgresql.html)
[Amazon RDS(MySQL)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-rds-mysql.html)
[Amazon RDS(Microsoft SQL Server)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-rds-ms-sql-server.html)
[Amazon RDS(Oracle)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-rds-oracle.html)
[Amazon RDS(PostgreSQL)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-rds-postgresql.html)
[IBM DB2](https://docs.aws.amazon.com/kendra/latest/dg/data-source-ibm-db2.html)
[Microsoft SQL Server](https://docs.aws.amazon.com/kendra/latest/dg/data-source-ms-sql-server.html)
[MySQL](https://docs.aws.amazon.com/kendra/latest/dg/data-source-mysql.html)
[Oracle Database](https://docs.aws.amazon.com/kendra/latest/dg/data-source-oracle-database.html)
[PostgreSQL](https://docs.aws.amazon.com/kendra/latest/dg/data-source-postgresql.html)
[Amazon Kendra콘솔](https://console.aws.amazon.com/kendra/) 및 [DatabaseConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_DatabaseConfiguration.html) API를 사용하여 데이터베이스 데이터 소스에 Amazon Kendra연결할 수 있습니다.
Amazon Kendra데이터베이스 데이터 소스 커넥터의 문제 해결은 섹션을 참조하세요[데이터 소스 문제 해결](troubleshooting-data-sources.md).
**Topics**
+ [지원되는 기능](#supported-features-database)
+ [사전 조건](#prerequisites-database)
+ [연결 지침](#data-source-procedure-database)
## 지원되는 기능
Amazon Kendra데이터베이스 데이터 소스 커넥터는 다음 기능을 지원합니다.
+ 필드 매핑
+ 사용자 컨텍스트 필터링
+ Virtual private cloud(VPC)
## 사전 조건
Amazon Kendra를 사용하여 데이터베이스 데이터 소스를 인덱싱하려면 먼저 데이터베이스와 AWS계정을 변경합니다.
**데이터베이스에서 다음을 확인하세요.**
+ 데이터베이스 사용자 이름과 암호의 기본 보안 인증 정보를 기록했습니다.
+ 호스트 이름, 포트 번호, 호스트 주소, 데이터베이스 이름, 문서 데이터가 포함된 데이터 테이블 이름을 복사했습니다. PostgreSQL의 경우 데이터 테이블은 공개 테이블 또는 공용 스키마여야 합니다.
**참고**
호스트와 포트는 인터넷에서 데이터베이스 서버를 찾을 Amazon Kendra위치를 알려줍니다. 데이터베이스 이름과 테이블 이름은 데이터베이스 서버에서 문서 데이터를 찾을 Amazon Kendra위치를 알려줍니다.
+ 문서 데이터가 포함된 데이터 테이블의 열 이름을 복사했습니다. 문서 ID, 문서 본문, 문서 변경 여부를 감지할 열(예: 마지막으로 업데이트한 열), 사용자 지정 인덱스 필드에 매핑되는 선택적 데이터 테이블 열을 포함해야 합니다. [Amazon Kendra 예약된 필드 이름](https://docs.aws.amazon.com/kendra/latest/dg/hiw-document-attributes.html#index-reserved-fields)을 테이블 열에 매핑할 수도 있습니다.
+ MySQLAmazon RDS에를 사용하는지 또는 다른 유형을 사용하는지와 같은 데이터베이스 엔진 유형 정보를 복사했습니다.
+ 데이터베이스 및 동일한 인덱스에 사용할 다른 여러 데이터 소스에서 각 문서가 고유한지 확인했습니다. 인덱스에 사용하려는 각 데이터 소스에는 데이터 소스 전체에서 동일한 문서가 포함되어서는 안 됩니다. 문서 ID는 인덱스 전체에 적용되며 인덱스별로 고유해야 합니다.
**에 다음이 있는지 AWS 계정확인합니다.**
+ [Amazon Kendra인덱스를 생성하고](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) API를 사용하는 경우 인덱스 ID를 기록했습니다.
+ 데이터 소스에 대한 [IAM역할을 생성하고](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) API를 사용하는 경우 IAM역할의 ARN을 기록했습니다.
**참고**
인증 유형과 자격 증명을 변경하는 경우 올바른 AWS Secrets Manager보안 암호 ID에 액세스하도록 IAM역할을 업데이트해야 합니다.
+ 데이터베이스 보안 인증 정보를 AWS Secrets Manager 보안 암호에 저장했고 API를 사용하는 경우 보안 암호의 ARN을 기록했습니다.
**참고**
보안 인증 정보와 보안 암호를 정기적으로 새로 고치거나 교체하는 것이 좋습니다. 보안을 위해 필요한 액세스 수준만 제공하세요. 데이터 소스, 커넥터 버전 1.0 및 2.0(해당하는 경우) 간에 보안 인증 정보와 보안 암호를 재사용하지 **않는** 것이 좋습니다.
기존 IAM역할이나 보안 암호가 없는 경우 데이터베이스 데이터 소스를 연결할 때 콘솔을 사용하여 새 IAM역할 및 Secrets Manager보안 암호를 생성할 수 있습니다Amazon Kendra. API를 사용하는 경우 기존 IAM역할 및 Secrets Manager보안 암호의 ARN과 인덱스 ID를 제공해야 합니다.
## 연결 지침
데이터베이스 데이터 소스Amazon Kendra에 연결하려면가 데이터에 액세스할 Amazon Kendra수 있도록 데이터베이스 데이터 소스에 필요한 세부 정보를 제공해야 합니다. 에 대한 데이터베이스를 아직 구성하지 않은 경우 섹션을 Amazon Kendra참조하세요[사전 조건](#prerequisites-database).
------
#### [ Console ]
**데이터베이스에 Amazon Kendra연결하려면**
1. 에 로그인AWS Management Console하고 [Amazon Kendra콘솔](https://console.aws.amazon.com/kendra/)을 엽니다.
1. 왼쪽 탐색 창에서 **인덱스**를 선택한 다음 인덱스 목록에서 사용할 인덱스를 선택합니다.
**참고**
**인덱스 설정**에서 **사용자 액세스 제어** 설정을 구성하거나 편집할 수 있습니다.
1. **시작하기** 페이지에서 **데이터 소스 추가**를 선택합니다.
1. **데이터 소스 추가** 페이지에서 **데이터베이스 커넥터**를 선택한 다음 **커넥터 추가**를 선택합니다. 버전 2(해당하는 경우)를 사용하는 경우 'V2.0' 태그가 있는 **데이터베이스 커넥터**를 선택합니다.
1. **데이터 소스 세부 정보 지정** 페이지에서 다음 정보를 입력합니다.
1. **이름 및 설명**에서 **데이터 소스 이름**에 데이터 소스의 이름을 입력합니다. 하이픈은 포함할 수 있지만 공백은 포함할 수 없습니다.
1. (선택 사항) **설명** - 데이터 소스에 대한 선택적 설명을 입력합니다.
1. **기본 언어** - 인덱스에 사용할 문서를 필터링할 언어를 선택합니다. 달리 지정하지 않는 한, 언어는 영어로 기본 설정됩니다. 문서 메타데이터에 지정된 언어가 선택한 언어보다 우선합니다.
1. **태그**에서 **새 태그 추가** - 리소스를 검색 및 필터링하거나 AWS비용을 추적하는 선택적 태그를 포함합니다.
1. **다음**을 선택합니다.
1. **액세스 및 보안 정의** 페이지에서 다음 정보를 입력합니다.
1. **엔드포인트** - DNS 호스트 이름, IPv4 주소 또는 IPv6 주소.
1. **포트** - 포트 번호.
1. **데이터베이스** - 데이터베이스 이름.
1. **테이블 이름** - 테이블 이름.
1. **인증 유형**에서 **기존** 인증과 **신규** 인증 정보 중 하나를 선택하여 데이터베이스 보안 인증 정보를 저장합니다. 새 암호를 만들기로 선택하면 AWS Secrets Manager 보안 암호 창이 열립니다.
1. **AWS Secrets Manager 보안 암호 생성 창**에 다음 정보를 입력합니다.
1. **보안 암호 이름** - 보안 암호의 이름. 'AmazonKendra-database-'라는 접두사가 보안 암호 이름에 자동으로 추가됩니다.
1. **데이터베이스 사용자 이름** 및 **암호**의 경우 - 데이터베이스 계정의 보안 인증 값을 입력합니다.
1. **인증 저장**을 선택합니다.
1. **Virtual Private Cloud(VPC)** - VPC를 사용하기로 선택할 수 있습니다. 그렇다면 **서브넷**과 **VPC 보안 그룹**을 추가해야 합니다.
**참고**
프라이빗 서브넷을 사용해야 합니다. RDS 인스턴스가 VPC의 퍼블릭 서브넷에 있는 경우, 퍼블릭 서브넷의 NAT 게이트웨이에 대한 아웃바운드 액세스 권한이 있는 프라이빗 서브넷을 생성할 수 있습니다. VPC 구성에 제공되는 서브넷은 미국 서부(오레곤), 미국 동부(버니지아), EU(아일랜드)에 있어야 합니다.
1. **IAM역할** - 기존IAM 역할을 선택하거나 새 IAM역할을 생성하여 리포지토리 자격 증명 및 인덱스 콘텐츠에 액세스합니다.
**참고**
IAM인덱스에 사용되는 역할은 데이터 소스에 사용할 수 없습니다. 기존 역할을 인덱스나 FAQ에 사용하는지 확실하지 않은 경우 **새 역할 생성**을 선택하여 오류를 방지하세요.
1. **다음**을 선택합니다.
1. **동기화 설정 구성** 페이지에 다음 정보를 입력합니다.
1. 사용 사례에 따라 **Aurora MySQL**, **MySQL**, **Aurora PostgreSQL**, **PostgreSQL** 중에서 선택합니다.
1. **SQL 식별자를 큰따옴표로 묶기** - SQL 식별자를 큰따옴표로 묶으려면 이 옵션을 선택합니다. 예: “columnName”
1. **ACL 열** 및 **변경 감지 열** -가 변경 감지에 Amazon Kendra사용하는 열(예: 마지막으로 업데이트된 열)과 액세스 제어 목록을 구성합니다.
1. **동기화 실행 일정**에서 **빈도** - Amazon Kendra가 데이터 소스와 동기화하는 빈도를 선택합니다.
1. **다음**을 선택합니다.
1. **필드 매핑 설정** 페이지에 다음 정보를 입력합니다.
1. **Amazon Kendra기본 필드 매핑 **- 인덱스에 매핑하려는 Amazon Kendra생성된 기본 데이터 소스 필드 중에서 선택합니다. `document_id` 및 `document_body`에 대한 **데이터베이스 열** 값을 추가해야 합니다.
1. **사용자 지정 필드 매핑** - 사용자 지정 데이터 소스 필드를 추가하려면 매핑할 인덱스 필드 이름과 필드 데이터 유형을 만듭니다.
1. **다음**을 선택합니다.
1. **검토 및 생성** 페이지에서 입력한 정보가 정확한지 확인한 다음 **데이터 소스 추가**를 선택합니다. 이 페이지에서 정보를 편집하도록 선택할 수도 있습니다. 데이터 소스가 성공적으로 추가된 후 **데이터 소스** 페이지에 데이터 소스가 표시됩니다.
------
#### [ API ]
**데이터베이스에 Amazon Kendra연결하려면**
다음과 같이 [DatabaseConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_DatabaseConfiguration.html) API를 지정해야 합니다.
+ **ColumnConfiguration** - 인덱스가 데이터베이스에서 문서 정보를 가져와야 하는 위치에 대한 정보입니다. 자세한 내용은 [ColumnConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ColumnConfiguration.html)을 참조하세요. `DocumentDataColumnName`(문서 본문 또는 본문) 및 `DocumentIdColumnName`, `ChangeDetectingColumn`(예: 최근 업데이트된 열) 필드를 지정해야 합니다. `DocumentIdColumnName` 필드에 매핑된 열은 정수 열이어야 합니다. 다음 예제에서는 데이터베이스 데이터 소스의 단순한 열 구성을 보여줍니다.
```
"ColumnConfiguration": {
"ChangeDetectingColumns": [
"LastUpdateDate",
"LastUpdateTime"
],
"DocumentDataColumnName": "TextColumn",
"DocumentIdColumnName": "IdentifierColumn",
"DocoumentTitleColumnName": "TitleColumn",
"FieldMappings": [
{
"DataSourceFieldName": "AbstractColumn",
"IndexFieldName": "Abstract"
}
]
}
```
+ **ConnectionConfiguration** - 데이터베이스에 연결하는 데 필요한 구성 정보입니다. 자세한 내용은 [ConnectionConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ConnectionConfiguration.html)을 참조하세요.
+ **DatabaseEngineType** - 데이터베이스를 실행하는 데이터베이스 엔진의 유형입니다. 의 `DatabaseHost` 필드는 데이터베이스의 Amazon Relational Database Service(Amazon RDS) 인스턴스 엔드포인트여야 `ConnectionConfiguration` 합니다. 클러스터 엔드포인트를 사용하지 마세요.
+ **보안 암호 Amazon 리소스 이름(ARN)** - 데이터베이스 계정의 인증 자격 증명이 포함된 Secrets Manager보안 암호의 Amazon 리소스 이름(ARN)을 제공합니다. 보안 암호에는 다음 키가 있는 JSON 구조가 저장됩니다.
```
{
"username": "user name",
"password": "password"
}
```
다음 예제에서는 보안 암호 ARN을 포함한 데이터베이스 구성을 보여줍니다.
```
"DatabaseConfiguration": {
"ConnectionConfiguration": {
"DatabaseHost": "host.subdomain.domain.tld",
"DatabaseName": "DocumentDatabase",
"DatabasePort": 3306,
"SecretArn": "arn:aws:secretmanager:region:account ID:secret/secret name",
"TableName": "DocumentTable"
}
}
```
**참고**
보안 인증 정보와 보안 암호를 정기적으로 새로 고치거나 교체하는 것이 좋습니다. 보안을 위해 필요한 액세스 수준만 제공하세요. 데이터 소스, 커넥터 버전 1.0 및 2.0(해당하는 경우) 간에 보안 인증 정보와 보안 암호를 재사용하지 **않는** 것이 좋습니다.
+ **IAM역할** - Secrets Manager보안 암호`CreateDataSource`에 액세스하고 데이터베이스 커넥터 및에 필요한 퍼블릭 APIs를 호출할 수 있는 권한을 IAM역할에 제공하기 위해를 호출할 `RoleArn` 때를 지정합니다Amazon Kendra. 자세한 내용은 [데이터베이스 데이터 소스에 대한 IAM 역할](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds)을 참조하세요.
다음 선택적 기능도 추가할 수 있습니다.
+ **Virtual Private Cloud(VPC)** - 데이터 소스 구성의 일부로 `VpcConfiguration`를 지정합니다. [VPC 사용을 위한 Amazon Kendra 구성](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html)을 참조하세요.
**참고**
프라이빗 서브넷만 사용해야 합니다. RDS 인스턴스가 VPC의 퍼블릭 서브넷에 있는 경우, 퍼블릭 서브넷의 NAT 게이트웨이에 대한 아웃바운드 액세스 권한이 있는 프라이빗 서브넷을 생성할 수 있습니다. VPC 구성에 제공되는 서브넷은 미국 서부(오레곤), 미국 동부(버니지아), EU(아일랜드)에 있어야 합니다.
+ **필드 매핑** - 데이터베이스 데이터 소스 필드를 Amazon Kendra 인덱스 필드에 매핑하기로 선택합니다. 자세한 내용을 알아보려면 [데이터 소스 필드 매핑](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html)을 참조하세요.
**참고**
가 문서를 Amazon Kendra검색하려면 문서 본문 필드 또는 문서에 해당하는 문서 본문이 필요합니다. 데이터 소스의 문서 본문 필드 이름을 인덱스 필드 이름 `_document_body`에 매핑해야 합니다. 다른 모든 필드는 선택 사항입니다.
+ **사용자 컨텍스트 필터링 및 액세스 제어** - Amazon Kendra는 문서에 대한 액세스 제어 목록(ACL)이 있는 경우 문서의 ACL을 크롤링합니다. ACL 정보는 검색 결과를 문서에 대한 사용자 또는 그룹의 액세스 권한을 기준으로 필터링하는 데 사용됩니다. 자세한 내용은 [사용자 컨텍스트 필터링](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter)을 참조하세요.
------