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

# 個別匯入動作
<a name="importing-actions"></a>

完成[建立結構描述和資料集](data-prep-creating-datasets.md)建立[動作資料集](actions-datasets.md)後，您可以個別將一或多個新動作匯入資料集。當您個別匯入動作時，您可以隨著目錄的成長，使用小批次匯入來保持動作資料集的最新版本。您一次最多可以匯入 10 個動作。如果您有大量新動作，建議您先大量匯入資料，然後視需要個別匯入動作資料。請參閱 [使用資料集匯入任務將大量資料匯入 Amazon Personalize](bulk-data-import-step.md)。

您可以使用 Amazon Personalize 主控台、 AWS Command Line Interface (AWS CLI) 或 AWS SDKs來匯入動作。如果您匯入的動作與動作資料集中已有的動作`actionId`相同，Amazon Personalize 會將其取代為新的動作。

如需新記錄如何影響建議的資訊，請參閱 [訓練後更新資料集中的資料](updating-datasets.md)。

**Topics**
+ [個別匯入動作 （主控台）](#importing-actions-console)
+ [個別匯入動作 (AWS CLI)](#importing-actions-cli)
+ [個別匯入動作 (AWS SDKs)](#importing-actions-cli-sdk)

## 個別匯入動作 （主控台）
<a name="importing-actions-console"></a>

您一次最多可以將 10 個動作匯入動作資料集。本節假設您已建立動作資料集。如需建立資料集的詳細資訊，請參閱 [建立結構描述和資料集](data-prep-creating-datasets.md)。

**個別匯入動作 （主控台）**

1. 在 [https://console.aws.amazon.com/personalize/home](https://console.aws.amazon.com/personalize/home)：// 開啟 Amazon Personalize 主控台並登入您的帳戶。

1. 在**資料集群組**頁面上，選擇具有您要新增之動作資料集的資料集群組。

1. 在導覽窗格中，選擇**資料集**。

1. 在**資料集**頁面上，選擇動作資料集。

1. 在資料集詳細資訊頁面的右上角，選擇**修改資料集**，然後選擇**建立記錄**。

1. 在**建立動作記錄 (Create action record) **頁面中，針對**記錄輸入**，以 JSON 格式輸入動作詳細資訊。動作的欄位名稱和值必須符合您在建立動作資料集時所使用的結構描述。Amazon Personalize 提供 JSON 範本，其中包含此結構描述中的欄位名稱和資料類型。

1. 選擇**建立記錄 （建立記錄）**。在**回應**中，會列出匯入的結果，並顯示成功或失敗訊息。

## 個別匯入動作 (AWS CLI)
<a name="importing-actions-cli"></a>

使用 `PutActions` API 操作將一或多個動作新增至動作資料集。您一次最多可以匯入 10 個動作。本節假設您已建立動作資料集。如需建立資料集的詳細資訊，請參閱 [建立結構描述和資料集](data-prep-creating-datasets.md)。

使用下列`put-actions`命令，透過 新增一或多個動作 AWS CLI。`dataset arn` 將 取代為資料集的 Amazon Resource Name (ARN)，並將 `actionId`取代為動作的 ID。如果動作資料集中`actionId`已有相同的動作，Amazon Personalize 會將其取代為新的動作。

對於 `properties`，對於您的動作資料集中的每個欄位，將 取代`propertyName`為駱駝案例結構描述中的欄位名稱。例如，ACTION\$1EXPIRATION\$1TIMESTAMP 會是 `actionExpirationTimestamp`，而 CREATION\$1TIMESTAMP 會是 creationTimestamp。`property data` 將 取代為 屬性的資料。

```
aws personalize-events put-actions \
  --dataset-arn dataset arn \
  --actions '[{
      "actionId": "actionId", 
      "properties": "{\"propertyName\": "\property data\"}" 
    }, 
    {
      "actionId": "actionId", 
      "properties": "{\"propertyName\": "\property data\"}" 
    }]'
```

## 個別匯入動作 (AWS SDKs)
<a name="importing-actions-cli-sdk"></a>

使用 PutActions 操作將一或多個動作新增至您的動作資料集。您最多可以使用單一`PutActions`呼叫匯入 10 個動作。如果動作資料集中`actionId`已有相同的動作，Amazon Personalize 會將其取代為新的動作。本節假設您已建立動作資料集。如需建立資料集的詳細資訊，請參閱 [建立結構描述和資料集](data-prep-creating-datasets.md)。

 下列程式碼說明如何將一或多個動作新增至動作資料集。針對每個動作，指定 `actionId`。如果動作資料集中`actionId`已有相同的動作，Amazon Personalize 會將其取代為新的動作。對於 `properties`，針對動作資料集中的每個額外欄位，將 取代`propertyName`為駱駝案例結構描述中的欄位名稱。例如，ACTION\$1EXPIRATION\$1TIMESTAMP 會是 `actionExpirationTimestamp`，而 CREATION\$1TIMESTAMP 會是 creationTimestamp。`property data` 將 取代為 屬性的資料。

```
import boto3

personalize_events = boto3.client(service_name='personalize-events')

personalize_events.put_actions(
    datasetArn = 'dataset arn',
    actions = [{
      'actionId': 'actionId',
      'properties': "{\"propertyName\": \"property value\"}"   
      },
      {
      'actionId': 'actionId',
      'properties': "{\"propertyName\": \"property value\"}"   
      }]
)
```