

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Criar um grupo do conjunto de dados do Amazon Personalize
<a name="data-prep-ds-group"></a>

Depois de [criar arquivos JSON do esquema para seus dados](how-it-works-dataset-schema.md), você poderá criar um grupo de conjuntos de dados. No Amazon Personalize, um *grupo de conjuntos de dados* é um contêiner de recursos do Amazon Personalize, incluindo conjuntos de dados, recomendadores de domínio e recursos personalizados. Um grupo de conjuntos de dados organiza seus recursos em coleções independentes, nas quais os recursos de um grupo de conjuntos de dados não podem influenciar os recursos em nenhum outro grupo de conjuntos de dados. 

 Crie um grupo de conjuntos de dados para cada um dos seus domínios de negócios. Por exemplo, você pode ter um aplicativo que faça recomendações de streaming de vídeo e outro que faça recomendações de audiolivros. No Amazon Personalize, você criaria um grupo de conjuntos de dados para cada aplicativo. Dessa forma, os dados de um aplicativo não influenciam as recomendações que o Amazon Personalize gera para o outro aplicativo. 

 Você pode criar um grupo de conjuntos de dados de domínio ou personalizado: 
+ Com um *grupo de conjuntos de dados de domínio*, você cria recursos pré-configurados e otimizados para diferentes casos de uso. Ao criar um grupo de conjuntos de dados, você o torna um grupo de conjuntos de dados de domínio especificando um domínio de VIDEO\_ON\_DEMAND ou ECOMMERCE.

  Se você tiver um aplicativo de streaming de vídeo ou de comércio eletrônico, recomendamos que crie um grupo de conjuntos de dados de domínio. Você ainda pode adicionar recursos personalizados, como soluções e versões de soluções treinadas para casos de uso personalizados. Não é possível criar os recursos de próximas melhores ações, incluindo os conjuntos de dados de interações com ações e ações, em um grupo de conjuntos de dados de domínio.
+  Um *grupo de conjuntos de dados personalizado* inclui somente recursos personalizados que você configura, dependendo do seu caso de uso. Com recursos personalizados, você treina e implanta soluções e versões de soluções configuráveis (um modelo de recomendação treinado do Amazon Personalize) com base nas necessidades da sua empresa. Se você não tiver um aplicativo de VIDEO\_ON\_DEMAND ou ECOMMERCE, recomendamos que crie um grupo de conjuntos de dados personalizados. Caso contrário, recomendamos começar com um grupo de conjuntos de dados de domínio e adicionar recursos personalizados conforme necessário. 

Você pode criar um grupo de conjuntos de dados com o console do Amazon Personalize, a AWS Command Line Interface (AWS CLI) ou os AWS SDKs.

**Topics**
+ [Criar um grupo de conjuntos de dados (console)](#data-prep-creating-ds-group-console)
+ [Criar um grupo de conjuntos de dados (AWS CLI)](#data-prep-creating-ds-group-cli)
+ [Criar um grupo de conjuntos de dados (AWS SDKs)](#data-prep-creating-ds-group-sdk)

## Criar um grupo de conjuntos de dados (console)
<a name="data-prep-creating-ds-group-console"></a>

Crie um grupo de conjuntos de dados especificando o nome do grupo de conjuntos de dados no console do Amazon Personalize.

**Para criar um grupo de conjuntos de dados.**

1. Abra o console do Amazon Personalize em [https://console.aws.amazon.com/personalize/home](https://console.aws.amazon.com/personalize/home) e faça login na sua conta.

1. Escolha **Criar grupo de conjuntos de dados**.

1. Se esta for a primeira vez que você usa o Amazon Personalize, na página **Criar grupo de conjuntos de dados**, em **Novo grupo de conjuntos de dados**, escolha **Começar**.

1. Em **Dataset group details (Detalhes do grupo de conjuntos de dados)**, em **Dataset group name (Nome do grupo de conjuntos de dados)**, especifique um nome para o grupo de conjuntos de dados. 

1. Escolha o seu **domínio**: 
   + Escolha **Comércio eletrônico** para criar um grupo de conjuntos de dados de domínio ECOMMERCE.
   + Escolha **Vídeo sob demanda** para criar um grupo de conjuntos de dados de domínio VIDEO\_ON\_DEMAND.
   +  Escolha **Personalizado** para criar um grupo de conjuntos de dados personalizados somente com recursos personalizados, como soluções, campanhas e trabalhos de inferência em lote. 

1. Para **Tags**, é possível adicionar quaisquer tags. Para obter mais informações sobre recursos de atribuição de tags do Amazon Personalize, consulte [Usar tags nos recursos do Amazon Personalize](tagging-resources.md).

1. Escolha **Criar grupo de conjuntos de dados**. A página **Visão geral** é exibida. Agora você pode criar um esquema e um conjunto de dados. Consulte [Criar um conjunto de dados e um esquema](data-prep-creating-datasets.md).

## Criar um grupo de conjuntos de dados (AWS CLI)
<a name="data-prep-creating-ds-group-cli"></a>

Para criar um grupo de conjuntos de dados, use a operação `create-dataset-group`. Para criar um grupo de conjuntos de dados de domínio, para domínio, especifique `ECOMMERCE` ou `VIDEO_ON_DEMAND`. Para criar um grupo de conjuntos de dados personalizado, não especifique um domínio. Você pode usar o parâmetro Tags para ter a opção de marcar recursos no Amazon Personalize. Para obter uma amostra, consulte [Adicionar tags (AWS CLI)](tags-add.md#add-tag-cli).

O código a seguir cria um grupo de conjuntos de dados de domínio para o domínio `VIDEO_ON_DEMAND`.

```
aws personalize create-dataset-group \
--name {{dataset-group-name}} \
--domain VIDEO_ON_DEMAND
```

Se for bem-sucedido, o nome do recurso da Amazon (ARN) do grupo de conjuntos de dados será exibido da seguinte forma.

```
{
  "datasetGroupArn": "arn:aws:personalize:us-west-2:acct-id:dataset-group/DatasetGroupName"
}
```

Registre esse valor para uso futuro. Para exibir o grupo de conjuntos de dados que criou, use o comando `describe-dataset-group` e especifique o ARN do grupo de conjuntos de dados retornado.

```
aws personalize describe-dataset-group \
--dataset-group-arn {{dataset group arn}}
```

O grupo de conjuntos de dados e suas propriedades são exibidos da seguinte forma.

```
{
    "datasetGroup": {
        "name": "DatasetGroupName",
        "datasetGroupArn": "arn:aws:personalize:us-west-2:acct-id:dataset-group/DatasetGroupName",
        "status": "ACTIVE",
        "creationDateTime": 1542392161.262,
        "lastUpdatedDateTime": 1542396513.377
    }
}
```

Quando o `status` do grupo do conjunto de dados for ATIVO, você poderá criar um esquema e um conjunto de dados. Consulte [Criar um conjunto de dados e um esquema](data-prep-creating-datasets.md).

## Criar um grupo de conjuntos de dados (AWS SDKs)
<a name="data-prep-creating-ds-group-sdk"></a>

Use o código a seguir para criar um grupo de conjuntos de dados de domínio. Dê um nome ao grupo de conjuntos de dados de domínio e, para o `domain`, especifique `ECOMMERCE` ou `VIDEO_ON_DEMAND`. Para criar um grupo de conjuntos de dados personalizados, modifique o código para remover o parâmetro de domínio.

 Para obter mais informações sobre a operação da API, consulte [CreateDatasetGroup](API_CreateDatasetGroup.md) na seção de referência de API. Você pode usar o parâmetro Tags para ter a opção de marcar recursos no Amazon Personalize. Para obter uma amostra, consulte [Adicionar tags (AWS SDKs)](tags-add.md#add-tag-sdk). 

------
#### [ SDK for Python (Boto3) ]

```
import boto3

personalize = boto3.client('personalize')

response = personalize.create_dataset_group(
  name = '{{dataset group name}}',
  domain = '{{business domain}}'
)
dsg_arn = response['datasetGroupArn']

description = personalize.describe_dataset_group(datasetGroupArn = dsg_arn)['datasetGroup']

print('Name: ' + description['name'])
print('ARN: ' + description['datasetGroupArn'])
print('Status: ' + description['status'])
```

------
#### [ SDK for Java 2.x ]

```
public static String createDomainDatasetGroup(PersonalizeClient personalizeClient, 
                                              String datasetGroupName,
                                              String domain) {

    try {
        CreateDatasetGroupRequest createDatasetGroupRequest = CreateDatasetGroupRequest.builder()
                .name(datasetGroupName)
                .domain(domain)
                .build();
        return personalizeClient.createDatasetGroup(createDatasetGroupRequest).datasetGroupArn();
    } catch (PersonalizeException e) {
        System.out.println(e.awsErrorDetails().errorMessage());
    }
    return "";
}
```

------
#### [ SDK for JavaScript v3 ]

```
// Get service clients module and commands using ES6 syntax.
import { CreateDatasetGroupCommand } from "@aws-sdk/client-personalize";
import { personalizeClient } from "./libs/personalizeClients.js";

// Or, create the client here.
// const personalizeClient = new PersonalizeClient({ region: "REGION"});

// Set the domain dataset group parameters.
export const domainDatasetGroupParams = {
  name: "NAME" /* required */,
  domain:
    "DOMAIN" /* required for a domain dsg, specify ECOMMERCE or VIDEO_ON_DEMAND */,
};

export const run = async () => {
  try {
    const response = await personalizeClient.send(
      new CreateDatasetGroupCommand(domainDatasetGroupParams),
    );
    console.log("Success", response);
    return response; // For unit tests.
  } catch (err) {
    console.log("Error", err);
  }
};
run();
```

------

A operação [DescribeDatasetGroup](API_DescribeDatasetGroup.md) retorna o `datasetGroupArn` e o status da operação. Quando o `status` do grupo do conjunto de dados for ATIVO, você poderá criar um esquema e um conjunto de dados. Consulte [Criar um conjunto de dados e um esquema](data-prep-creating-datasets.md).