本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 导出统一的客户配置文件数据
Amazon Connect 客户档案可将统一的客户档案实时数据导出到 Amazon Kinesis 数据流。您可以启用数据流式处理，并自动将新资料和现有资料更新的数据接收到 Amazon Kinesis Data Streams 中。
您可以使用 Amazon Connect 客户档案中的最新信息保留源系统数据 up-to-date，例如 CRMs 营销自动化工具。例如，当客户呼叫您的联系中心以更新其地址时，座席可以进行更改以添加新的客户地址，并将更新的资料信息实时发送到 Kinesis Data Streams。
要进行此设置，您需要在 Customer Profiles 控制台中启用**数据导出**。
## 启用实时导出
**为您的域启用数据流式处理**
1. 打开 Amazon Connect 客户资料控制台。
1. 选择**数据导出**选项卡，然后选择**启用数据流式处理**
![\[实时数据导出可启用 Kinesis 数据流。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/enable-real-time-export-1.png)
1. 选择**启用数据流式处理**并从下拉菜单中选择现有的 Kinesis 数据流，或者选择**创建新的 Kinesis 数据流**以打开 Kinesis 控制台并创建流。有关更多信息，请参阅[创建和管理流](https://docs.aws.amazon.com/streams/latest/dev/working-with-streams.html)。
![\[实时数据导出可启用 Kinesis 数据流。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/enable-real-time-export-2.png)
1. 选择**启用数据流式处理**按钮以保存您的设置。
## 禁用实时导出
**为您的域禁用数据流式处理**
1. 打开 Amazon Connect 客户资料控制台。
1. 选择**数据导出**选项卡，然后选择**禁用数据流式处理**。
![\[实时数据导出可禁用 Kinesis 数据流。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/disable-real-time-export-1.png)
## 实时导出 Kinesis 有效负载
**JSON 格式的示例输出事件**
```
{
"SchemaVersion": 0,
"EventId": "eventId",
"EventTimestamp": "2020-01-01T00:00:00Z",
"EventType": "CREATED",
"DomainName": "domainName",
"ObjectTypeName": "objectTypeName",
"AssociatedProfileId": "associatedProfileId",
"ProfileObjectUniqueKey": "profileObjectUniqueKey",
"Object": {
"map": {
"k1": [
"a",
"b",
"c"
]
}
},
"IsMessageRealTime": true
}
```
**SchemaVersion**
架构的当前版本。
**EventId**
唯一的事件 ID。
**EventTimestamp**
使用 ISO8601 标准的事件时间戳。
**EventType**
导出的事件类型。
值：CREATED、UPDATED、HEALTH\$1CHECK
+ 已创建：导出事件是为了 CreateProfile。
+ 更新:导出事件是为了 UpdateProfile.
+ HEALTH\$1CHECK：导出 HealthCheck 活动旨在确保客户资料能够成功在 `putEvent` Kinesis Stream 中进行活动。
**DomainName**
事件所属的域。事件的 `/Domain`
**ObjectTypeName**
事件的对象类型
值：`_profile`、`_asset`、`_order`、`_case`。您也可以使用预定义的模板名称，例如`Salesforce-Account`或使用 [ PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)API 创建的自定义对象名称。
**AssociatedProfileId**
与相应对象关联的标准资料的 ID。仅当对象类型不是 `_profile` 时，它才会出现
**ProfileObjectUniqueKey**
服务 ProfileObject 生成的唯一标识符。
类型：字符串
**Object**
标准资料或标准资料对象本身。
**IsMessageRealTime**
用于通知消息是实时消息还是已重启的标志。
**JSON 格式的示例有效负载**
```
{
"SchemaVersion": 0,
"EventId": "6049bf39-0000-0000-0000-b75656dd51a8",
"EventTimestamp": "2023-02-24T07:17:05.356Z",
"EventType": "UPDATED",
"DomainName": "SampleDomain",
"ObjectTypeName": "Salesforce-Account",
"AssociatedProfileId": "5ffcee99ab0000000000b3ae01225e40",
"ProfileObjectUniqueKey": "cNo77ZI0000000000pCPB7RQcqfeBaRfBwrzW2MMbws=",
"Object": {
"Id": "0012v00002kVKVuAAO",
"IsDeleted": false,
"Name": "Company A",
"Phone": "+12065551234",
"PhotoUrl": "/services/images/photo/0012v00002kVKVuAAO",
"OwnerId": "0052v00000fmQ7sAAE",
"CreatedDate": "2019-12-13T07:56:04.000+0000",
"CreatedById": "0052v00000fmQ7sAAE",
"LastModifiedDate": "2023-02-22T20:29:43.000+0000",
"LastModifiedById": "0052v00000fmQ7sAAE",
"SystemModstamp": "2023-02-22T20:29:43.000+0000",
"LastActivityDate": "2020-03-18",
"LastViewedDate": "2023-02-23T00:09:49.000+0000",
"LastReferencedDate": "2023-02-23T00:09:49.000+0000",
"CleanStatus": "Pending"
},
"IsMessageRealTime": true
}
```
# 解决将实时事件导出到 Kinesis 数据流的问题
首次将事件导出到 Kinesis 数据流时可能会出现延迟。这是因为为服务相关角色传播 IAM 权限需要很长时间。当发生实际问题时，流状态会进入错误状态。
![\[事件无法到达目标 Kinesis 数据流，进入错误状态。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/real-time-export-troubleshooting.png)
以下各节显示了您可能会遇到的错误消息。它还提供了每个问题的原因和解决方案。
## 错误：Kinesis 数据流未处于活动状态。请检查配置并稍后重新创建事件流
目标 Kinesis 数据流未处于 `ACTIVE` 状态。在创建或删除您的 Kinesis 数据流时，可能会发生这种情况。要解决此错误，请确保您的 Kinesis 数据流处于 ACTIVE 状态，然后重新启用数据流式处理设置。
## 错误：Kinesis 数据流不存在。请使用有效的 Kinesis 数据流目标重新创建事件流
目标 Kinesis 数据流将被删除。要解决此错误，请使用现有 Kinesis 数据流作为目标重新启用数据流式处理。
## 错误：Kinesis 数据流受限制。请考虑适当预置更高的 Kinesis 吞吐量
目标 Kinesis 数据流受限制（预置不足）。要解决此错误，请确保目标 Kinesis 数据流有足够的分片计数，然后重新启用数据流式处理。
## 错误：用于加密 Kinesis 数据流的 KMS 密钥受限制。请考虑适当增加 KMS 请求限额
由 Kinesis 数据流使用的 KMS 密钥受限制。要解决此错误，请重新启用数据流式处理。
## 错误：检查您的 Kinesis 数据流的 KMS 密钥配置
Customer Profiles 无法访问由 Kinesis 数据流使用的 KMS 密钥。当您的 KMS 密钥具有拒绝来自 Customer Profiles 服务相关角色的访问的密钥政策，或者密钥未处于“已启用”状态时，可能会发生这种情况。要解决此错误，请确保 KMS 密钥政策不会拒绝来自 Customer Profiles 服务相关角色的访问，并且密钥处于“已启用”状态。要解决此错误，请重新启用数据流式处理。