기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 데이터 소스 연결
<a name="kb-managed-connect-ds"></a>

지식 기반에 대한 구성을 완료한 후 지원되는 데이터 소스를 지식 기반에 연결합니다.

Amazon Bedrock 관리형 지식 기반은 비정형 데이터 소스에 대한 연결을 지원합니다. 주제를 선택하여 해당 유형의 데이터 소스에 연결하는 방법을 알아봅니다.

**참고**  
관리형 지식 기반의 경우 `CreateDataSource` 작업은 비동기식입니다. 작업이 완료되면 데이터 소스 상태가에서 `AVAILABLE` `CREATING`로 전환됩니다.

Amazon Bedrock 콘솔을 사용하여 데이터 소스에 연결하는 방법을 알아보려면 이 페이지 하단에서 데이터 소스 유형에 해당하는 주제를 선택합니다.

Amazon Bedrock API를 사용하여 데이터 소스에 연결하려면 [Amazon Bedrock Agents 런타임 엔드포인트](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt)를 사용하여 [CreateDataSource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateDataSource.html) 요청을 보냅니다.

**필수 필드:**


****  

| 필드 | 설명 | 
| --- | --- | 
| knowledgeBaseId | 기술 자료의 ID입니다. | 
| name | 데이터 소스의 이름입니다. | 
| dataSourceConfiguration | type 필드에 데이터 소스 유형을 지정하고 해당 구성을 포함합니다. 커넥터별 구성에 대한 자세한 내용은이 페이지 하단의 주제에서 커넥터 주제를 선택합니다. | 

내에서 다음을 지정`dataSourceConfiguration`해야 합니다.
+ `type` - 반드시 `MANAGED_KNOWLEDGE_BASE_CONNECTOR`여야 합니다.
+ `managedKnowledgeBaseConnectorConfiguration` - 커넥터에 대한 구성입니다. 다음 필드가 포함됩니다.
  + `connectorParameters` (필수) - 커넥터 유형을 `type` 지정하는 필드와 로 설정된 필수 `version` 필드를 포함합니다`1`. 지원되는 유형 값은 `S3`, `ONEDRIVE`, `CONFLUENCE`, `SHAREPOINT`, 및 `WEB_CRAWLER`입니다`GOOGLE_DRIVE`. 의 나머지 필드는 커넥터 유형에 따라 `connectorParameters` 다릅니다. 자세한 내용은 각 데이터 커넥터 페이지를 참조하세요.
  + `deletionProtectionConfiguration` (선택 사항) - 인덱싱된 콘텐츠가 실수로 대량 삭제되지 않도록 보호합니다. `deletionProtectionStatus` (`ENABLED` 또는 `DISABLED`)를 포함하고, 활성화된 경우 선택 사항`deletionProtectionThreshold`(0\~100, 기본값은 15)을 포함합니다. 임계값은 동기화 작업이 인덱스에서 삭제할 수 있는 문서의 최대 백분율입니다. 동기화가이 백분율보다 많이 삭제되는 경우 동기화는 삭제 단계를 건너뛰고 인덱싱된 문서를 그대로 둡니다. 사용자 지정 커넥터에는 지원되지 않습니다.
  + `mediaExtractionConfiguration` (선택 사항) - 데이터 소스 파일에서 미디어(이미지, 오디오, 비디오)를 추출하기 위한 구성입니다.

**선택적 필드:**


****  

| 필드 | 설명 | 
| --- | --- | 
| description | 데이터 소스에 대한 설명을 입력합니다. | 
| vectorIngestionConfiguration | 수집 프로세스를 사용자 지정하기 위한 구성이 포함되어 있습니다. 자세한 내용은 [데이터 소스에 대한 수집 사용자 지정](kb-managed-customize-ingestion.md) 단원을 참조하십시오. | 
| clientToken | API 요청이 한 번만 완료되도록 합니다. 자세한 내용은 [멱등성 보장하기](https://docs.aws.amazon.com/ec2/latest/devguide/ec2-api-idempotency.html)를 참조하세요. | 

다음 예제에서는 S3 커넥터가 있는 `CreateDataSource` 요청을 보여줍니다.

```
{
    "knowledgeBaseId": "{{your-knowledge-base-id}}",
    "name": "{{my-s3-data-source}}",
    "description": "{{S3 data source for my managed knowledge base}}",
    "dataSourceConfiguration": {
        "type": "MANAGED_KNOWLEDGE_BASE_CONNECTOR",
        "managedKnowledgeBaseConnectorConfiguration": {
            "mediaExtractionConfiguration": {
                "imageExtractionConfiguration": {
                    "imageExtractionStatus": "ENABLED"
                }
            },
            "deletionProtectionConfiguration": {
                "deletionProtectionStatus": "ENABLED",
                "deletionProtectionThreshold": 15
            },
            "connectorParameters": {
                "type": "S3",
                "version": "1",
                "connectionConfiguration": {
                    "bucketName": "{{my-bucket-name}}",
                    "bucketOwnerAccountId": "{{123456789012}}"
                },
                "filterConfiguration": {
                    "maxFileSizeInMegaBytes": "50"
                }
            }
        }
    }
}
```

특정 커넥터 및 해당 구성에 대해 자세히 알아보려면 아래에서 주제를 선택합니다.

**Topics**
+ [Amazon S3](kb-managed-ds-s3.md)
+ [Confluence](kb-managed-ds-confluence.md)
+ [사용자 지정](kb-managed-ds-custom.md)
+ [Google Drive](kb-managed-ds-googledrive.md)
+ [Microsoft OneDrive](kb-managed-ds-onedrive.md)
+ [Microsoft SharePoint](kb-managed-ds-sharepoint.md)
+ [웹 크롤러](kb-managed-ds-webcrawler.md)