本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 匯出統一的客戶設定檔資料
Amazon Connect 客戶設定檔可將統一客戶設定檔的即時資料匯出至 Amazon Kinesis Data Stream。您可以啟用資料串流，並自動接收新設定檔的資料，以及 Amazon Kinesis Data Stream 中現有設定檔的更新。
您可以讓來源系統資料，例如 CRMs和行銷自動化工具， up-to-date 隨時掌握 Amazon Connect 客戶設定檔的最新資訊。例如，當客戶致電您的聯絡中心更新地址時，客服人員可以進行變更以新增新的客戶地址，而更新的設定檔資訊會即時傳送至 Kinesis Data Stream。
若要進行設定，您必須在客戶設定檔主控台中啟用**資料匯出**功能。
## 啟用即時匯出
**啟用網域的資料串流**
1. 開啟 Amazon Connect 客戶設定檔主控台。
1. 選擇**資料匯出**標籤，然後選擇**啟用資料流**
![\[即時資料匯出功能會啟用 Kinesis 資料串流。\]](http://docs.aws.amazon.com/zh_tw/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_tw/connect/latest/adminguide/images/enable-real-time-export-2.png)
1. 選擇**啟用資料串流**按鈕以儲存設定。
## 啟用即時匯出
**若要停用網域的資料串流**
1. 開啟 Amazon Connect 客戶設定檔主控台。
1. 選擇**資料匯出**標籤，然後選擇**停用資料串流**。
![\[即時資料匯出功能會停用 Kinesis 資料串流。\]](http://docs.aws.amazon.com/zh_tw/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**
唯一的事件識別符。
**EventTimestamp**
使用 ISO8601 標準的事件時間戳記。
**EventType**
匯出的事件的類型。
值：CREATED、UPDATED、HEALTH\$1CHECK
+ CREATED：匯出事件適用於 CreateProfile。
+ UPDATED：匯出事件適用於 UpdateProfile。
+ HEALTH\$1CHECK：匯出事件用於 HealthCheck 事件，以確保客戶設定檔可以在 Kinesis 串流中成功 `putEvent`。
**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 Data Stream 的即時事件
第一次將事件匯出至 Kinesis Data Stream 時，可能會產生延遲。這是因為需要些時間為服務連結角色傳播 IAM 權限。實際發生問題時，串流狀態可能進入錯誤狀態。
![\[事件無法到達目的地 Kinesis Data Stream，進入錯誤狀態。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/real-time-export-troubleshooting.png)
以下各節顯示您可能遇到的可能錯誤訊息。它還提供了每個問題的原因和解決方案。
## 錯誤：Kinesis 資料串流未處於作用中狀態。請檢查組態並稍後重新建立事件流
目的地 Kinesis 資料串流未處於 `ACTIVE` 狀態。建立或刪除 Kinesis 資料串流時，可能會發生這種情況。若要解決錯誤，請確定 Kinesis 資料串流處於作用中狀態，並重新啟用資料串流設定。
## 錯誤：Kinesis 資料串流不存在。請使用有效的 Kinesis 資料串流目的地重新建立事件串流
目的地 Kinesis 資料串流已刪除。若要解決錯誤，請以現有 Kinesis 資料串流作為目的地重新啟用資料串流。
## 錯誤：Kinesis 資料串流被限流。請考慮適當地提供較高的 Kinesis 輸送量
目的地 Kinesis 資料串流被限流 (佈建不足)。若要解決錯誤，請確定目的地 Kinesis 資料串流有足夠的碎片計數，然後重新啟用資料串流。
## 錯誤：用來加密 Kinesis 資料串流的 KMS 金鑰被限流。請考慮適當地增加 KMS 要求配額
Kinesis 資料串流使用的 KMS 金鑰被限流。若要解決錯誤，請重新啟用資料串流。
## 錯誤：檢查 Kinesis 資料串流的 KMS 金鑰設定
Customer Profiles 無法存取 Kinesis 資料串流使用的 KMS 金鑰。當您的 KMS 金鑰具有拒絕從客戶設定檔服務連結角色存取的金鑰政策，或金鑰未處於「已啟用」狀態時，可能會發生這種情況。若要解決錯誤，請確定 KMS 金鑰政策不會拒絕來自客戶設定檔服務連結角色的存取，且金鑰處於「已啟用」狀態。重新啟用資料串流以解決錯誤。