

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 连接数据来源
<a name="kb-managed-connect-ds"></a>

完成知识库的配置后，您需要将支持的数据来源连接到知识库。

Amazon Bedrock 托管知识库支持连接到非结构化数据源。选择一个主题以了解如何连接到相应类型的数据来源：

**注意**  
对于托管知识库，该`CreateDataSource`操作是异步的。操作完成后，数据源状态`CREATING`将`AVAILABLE`从变为。

要了解如何使用 Amazon Bedrock 控制台连接到数据来源，请在本页面底部选择与您的数据来源类型对应的主题：

要使用 Amazon Bedrock API 连接到数据源，请使用亚马逊 B [edrock 运行时终端节点代理](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)
+ [微软 OneDrive](kb-managed-ds-onedrive.md)
+ [微软 SharePoint](kb-managed-ds-sharepoint.md)
+ [网络爬虫](kb-managed-ds-webcrawler.md)