為所有統一的客戶設定檔資料設定大量匯出 - Amazon Connect
步驟 1：設定 KMS 金鑰和 S3 儲存貯體步驟 2：建立大量匯出任務步驟 3：檢查大量匯出任務的狀態步驟 4：在 S3 中檢視匯出的資料更新大量匯出任務刪除或取消大量匯出任務 - 不支援

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

為所有統一的客戶設定檔資料設定大量匯出

注意

若要完成本主題中的步驟，您需要具備開發人員技能，並具備使用 AWS KMS 和 Amazon S3 的經驗。

當 Amazon Connect Customer Profiles 建立統一的客戶設定檔時，它會結合來自第一方和第三方來源的資料，以增強、精簡原始資料和資訊，並將其改進為更準確的設定檔。客戶設定檔也會透過新增資料來改善資料集的品質。您可以將改進的資料集用於其他使用案例，例如制定更明智和有針對性的行銷、銷售和客戶服務策略。例如，您可能想要利用統一的客戶設定檔來：

  • 稽核您在整個網域中擁有的客戶資料。

  • 執行內部分析，例如銷售和行銷報告。

  • 將資料匯出至您自己的工具或第三方產品，以個人化廣告和目標客戶。

若要將統一的客戶設定檔資料用於其他使用案例，您可以將其大量匯出至 Amazon S3。本主題說明如何執行此操作。

步驟 1：設定 KMS 金鑰和 S3 儲存貯體

若要為您的網域啟用大量匯出，您需要設定下列資源：

接下來會說明這些步驟。

建立新的 KMS 金鑰或重複使用現有的 KMS 金鑰

若要設定大量匯出的 KMS 金鑰，您必須建立或重複使用與您計劃設定為大量匯出目的地的 Amazon S3 儲存貯體位於相同 AWS 區域中的現有 KMS 金鑰。您必須允許 Amazon Connect AppIntegrations 服務為金鑰執行 KMS 動作。

將下列陳述式新增至您的金鑰政策。

JSON
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "Enable AppIntegrations access to KMS key",
            "Effect": "Allow",
            "Principal": {
                "AWS": [
                    "arn:aws:iam::111122223333:root"
                ],
                "Service": [
                    "app-integrations.amazonaws.com"
                ]
            },
            "Action": [
                "kms:Encrypt*",
                "kms:Describe*",
                "kms:Decrypt*",
                "kms:GenerateDataKey*"
            ],
            "Resource": "*"
        }
    ]
}

設定 S3 目的地儲存貯體

您必須在與 KMS 金鑰相同的區域中設定新的或現有的儲存貯 AWS 體，並在 S3 儲存貯體上設定資源政策。

設定儲存貯體時，請務必選取使用 SSE-KMS 加密，並使用上一個程序的相同 KMS 金鑰。此外，請勿在 S3 儲存貯體上啟用 ACLs。

以下是範例資源政策。

JSON
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "Allow AppIntegrations to write data to destination bucket",
            "Effect": "Allow",
            "Principal": {
                 "Service": [
                    "app-integrations.amazonaws.com"
                ]
            },
            "Action": [
                "s3:GetObject",
                "s3:ListBucket",
                "s3:PutObject",
                "s3:PutObjectAcl"
            ],
            "Resource": [
                "arn:aws:s3:::{{amzn-s3-demo-bucket1}}",
                "arn:aws:s3:::{{amzn-s3-demo-bucket2}}/*"
            ],
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "{{AwsAccountId}}"
                },
                "ArnEquals": {
                    "aws:SourceArn": "arn:aws:*-*:{{Region}}:{{AwsAccountId}}:data-integration/*" 
                }
            }
        }
    ]
}

步驟 2：建立大量匯出任務

若要建立大量匯出任務，請叫用下列 Amazon Connect AppIntegrations APIs：

  1. CreateDataIntegration：此 API 會建立與資料來源的整合 （例如客戶設定檔）。

  2. CreateDataIntegrationAssociation：此 API 會使用資料來源將資料寫入目的地 （例如 S3 儲存貯體）。

以下是如何呼叫這些 APIs的詳細資訊。

建立資料整合

資料整合代表資料來源。您可以呼叫 CreateDataIntegration API 或執行 create-data-integration CLI 命令來建立資料整合。您必須提供客戶設定檔物件類型和客戶設定檔網域。

如果您想要匯出多個物件類型，則需要為每個物件類型建立個別的資料整合。例如，如果您想要同時匯出 _profile和 _asset 物件，則需要建立兩個不同的資料整合。

注意

過去 30 分鐘內擷取的任何資料可能不會包含在匯出中。

下列程式碼範例示範如何執行 create-data-integration CLI 命令。

aws appintegrations create-data-integration \ 
--region "us-west-2" \
--name "bulk-export-job-01" \ 
--description "Data integration for _profile objects" \
--kms-key "arn:aws:kms:us-west-2:123456789012:key/123456789012-1234-1234-123456789012" \ 
--source-uri "AmazonConnect://AppIntegrations" \ 
--object-configuration '{"CustomerProfiles":{"domainName":["my-domain-pdx"],"objectType":["_profile"]}}'

下列程式碼範例示範如何呼叫 CreateDataIntegration API。

{
    "Description": "Data integration for _profile objects",
    "KmsKey": "arn:aws:kms:us-west-2:123456789012:key/123456789012-1234-1234-123456789012",
    "Name": "unique-data-integration-name-01",
    "SourceURI": "AmazonConnect://AppIntegrations",
    "ObjectConfiguration": {
        "CustomerProfiles": {
            "domainName": [
                "my-domain-pdx"
            ],
            "objectType": [
                "_profile"
            ]
        }
    }
}

建立資料整合關聯

資料整合關聯代表您要匯出資料的目的地，以及選擇要匯出資料的時間範圍。您可以呼叫 CreateDataIntegrationAssociation API 或執行 create-data-integration-association CLI 命令來建立資料整合。您可以使用 StartTime和 EndTime 屬性來設定時間範圍。此時間範圍對應至客戶設定檔中上次更新物件的時間。

您指定的目的地 S3 儲存貯體可以只是儲存貯體名稱，也可以包含要匯出資料的其他資料夾或 S3 字首。

注意

如需並行大量匯出任務的配額，請參閱 Amazon Connect Customer Profiles 服務配額。大量匯出任務完成或失敗後，就不會再計入並行配額。

下列程式碼範例示範如何執行 create-data-integration-association CLI 命令。

aws appintegrations create-data-integration-association \
--region "us-west-2" \
--data-integration-identifier "unique-data-integration-name-01" \
--destination-uri "s3://amzn-s3-demo-bucket1" \
--execution-configuration '{"ExecutionMode": "ON_DEMAND", "OnDemandConfiguration": {"StartTime":"1715278292014", "EndTime":"1715364692014"}}'

下列程式碼範例示範如何呼叫 CreateDataIntegrationAssociation API。

{
    "DataIntegrationIdentifier": "arn:aws:app-integrations:us-west-2:123456789012:data-integration/123456789012-1234-1234-123456789012",
    "DestinationURI": "s3://amzn-s3-demo-bucket1",
    "ExecutionConfiguration": {
        "ExecutionMode": "ON_DEMAND",
        "OnDemandConfiguration": {
            "StartTime": "1713565000004",
            "EndTime": "1713565000005"
        }
    }
}

步驟 3：檢查大量匯出任務的狀態

若要檢視大量匯出任務的狀態，您可以呼叫 ListDataIntegrationAssociations API，或執行 list-data-integration-associations CLI 命令。

下列程式碼範例示範如何執行 list-data-integration-associations CLI 命令。

aws appintegrations list-data-integration-associations \
--region "us-west-2" \
--data-integration-identifier "unique-data-integration-name-01"

步驟 4：在 S3 中檢視匯出的資料

當資料整合關聯在 中時IN_PROGRESS，您會開始看到資料複製到 S3 儲存貯體。

匯出的資料使用下列路徑結構寫入：

  • {BucketNameAndFolderName}

    • {AwsAccountId}

      • {DomainName}

        • {RequestTimestamp}

          • {lStartTime}-{EndTime}

            • {ObjectTypeName}

              • <filename： uuid>

以下是範例路徑：

amzn-s3-demo-bucket1/123456789012/my-domain-pdx/20240607T175023/20240101T235959-20240430T235959/_profile/123456789012-1234-1234-123456789012

更新大量匯出任務

任務完成後，您可以使用不同的資料提取開始時間和資料提取結束時間來更新資料整合關聯。這會建立新的大量匯出任務。如果您過去曾執行大量匯出，並且只想要匯出自上次匯出以來更新的資料，您可能想要執行此操作。例如，如果您的最後一個大量匯出任務是在三個月前，您可以將 3 個月前的時間範圍資料整合關聯更新為今天。

您可以呼叫 UpdateDataIntegrationAssociation API，或執行 update-data-integration-association CLI 命令來更新匯出任務。

下列程式碼範例示範如何執行 update-data-integration-association CLI 命令。

aws appintegrations update-data-integration-association \
--region "us-west-2" \
--data-integration-identifier "unique-data-integration-name-01" \
--data-integration-association-identifier "arn:aws:app-integrations:us-west-2:123456789012:data-integration-association/123456789012-1234-1234-123456789012/123456789012-1234-1234-123456789012" \ 
--execution-configuration '{"ExecutionMode": "ON_DEMAND", "OnDemandConfiguration": {"StartTime":"1715278292014", "EndTime":"1715364692014"}}'

刪除或取消大量匯出任務 - 不支援

您無法刪除或取消大量匯出。匯出任務完成後，就不會再計入匯出配額。