Step 1: Creating a Custom dataset group
A Custom dataset group is container for Amazon Personalize components and custom resources, including datasets, event trackers, solutions, filters, campaigns, and batch inference jobs. A dataset group organizes your resources into independent collections, so resources from one dataset group cannot influence resources in any other dataset group.
For example, you might have an application that provides recommendations for streaming video and another that provides recommendations for audio books. In Amazon Personalize, each application would have its own dataset group. You can create a dataset group with the Amazon Personalize console, AWS Command Line Interface (AWS CLI) or AWS SDKs.
Topics
Creating a dataset group (console)
Create a dataset group by specifying the dataset group name in the Amazon Personalize console.
To create a dataset group
-
Open the Amazon Personalize console at https://console.aws.amazon.com/personalize/home
and sign in to your account. -
Choose Create dataset group.
-
If this is your first time using Amazon Personalize, on the Create dataset group page, in New dataset group, choose Get started.
-
In Dataset group details, for Dataset group name, specify a name for your dataset group.
-
For Domain choose Custom.
-
For Tags, optionally add any tags. For more information about tagging Amazon Personalize resources, see Tagging Amazon Personalize resources.
-
Choose Next. The Create user-item interaction data page displays. You are now ready to add a dataset with an associated schema to your dataset group. See Creating a dataset and a schema (console).
Creating a dataset group (AWS CLI)
Create a dataset group with the following command. For more information about the CreateDatasetGroup API operation, see CreateDatasetGroup in the API reference section. You can use the Tags parameter to optionally tag resources in Amazon Personalize. For a sample see Adding tags (AWS CLI).
aws personalize create-dataset-group --name
dataset group name
The dataset group Amazon Resource Name (ARN) is displayed as shown in the following example.
{ "datasetGroupArn": "arn:aws:personalize:us-west-2:acct-id:dataset-group/DatasetGroupName" }
Record this value for future use. To display the dataset group that you created, use the describe-dataset-group
command and specify the returned dataset group ARN.
aws personalize describe-dataset-group \ --dataset-group-arn
dataset group arn
The dataset group and its properties are displayed, as shown in the following example.
{ "datasetGroup": { "name": "DatasetGroupName", "datasetGroupArn": "arn:aws:personalize:us-west-2:acct-id:dataset-group/DatasetGroupName", "status": "ACTIVE", "creationDateTime": 1542392161.262, "lastUpdatedDateTime": 1542396513.377 } }
When the dataset group's status
is ACTIVE, proceed to Creating a dataset and a schema (AWS CLI).
Creating a dataset group (AWS SDKs)
The following code shows how to create a Custom dataset group. For more information about the API operation, see CreateDatasetGroup in the API reference section. You can use the Tags parameter to optionally tag resources in Amazon Personalize. For a sample see Adding tags (AWS SDKs).
The DescribeDatasetGroup
operation returns the datasetGroupArn
and the status of the operation.
When the dataset group's status
is ACTIVE, proceed to Creating a dataset and a schema (AWS SDKs).