Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Création d'un groupe de jeux de données Amazon Personalize

Après avoir créé des JSON fichiers de schéma pour vos données, vous êtes prêt à créer un groupe de jeux de données. Dans Amazon Personalize, un groupe de jeux de données est un conteneur pour les ressources Amazon Personalize, notamment les ensembles de données, les recommandations de domaines et les ressources personnalisées. Un groupe de jeux de données organise vos ressources en collections indépendantes, dans lesquelles les ressources d'un groupe de jeux de données ne peuvent influencer les ressources d'aucun autre groupe de jeux de données.

Vous créez un groupe de jeux de données pour chacun de vos domaines commerciaux. Par exemple, vous pouvez avoir une application qui fournit des recommandations pour le streaming vidéo et une autre qui fournit des recommandations pour les livres audio. Dans Amazon Personalize, vous devez créer un groupe de jeux de données pour chaque application. Ainsi, les données d'une application n'influencent pas les recommandations qu'Amazon Personalize génère pour l'autre application.

Vous pouvez créer un groupe de jeux de données de domaine ou un groupe de jeux de données personnalisé :

Vous pouvez créer un groupe de jeux de données à l'aide de la console Amazon Personalize, AWS Command Line Interface (AWS CLI) ou AWS SDKs.

Création d'un groupe de jeux de données (console)

Créez un groupe de jeux de données en spécifiant le nom du groupe de données dans la console Amazon Personalize.

Création d'un groupe de jeux de données (AWS CLI)

Pour créer un groupe de jeux de données, utilisez l'create-dataset-groupopération. Pour créer un groupe de jeux de données de domaine, pour le domaine, spécifiez ECOMMERCE ouVIDEO_ON_DEMAND. Pour créer un groupe de jeux de données personnalisé, ne spécifiez pas de domaine. Vous pouvez utiliser le paramètre Tags pour étiqueter éventuellement les ressources dans Amazon Personalize. Pour un exemple, voirAjouter des tags (AWS CLI).

Le code suivant crée un groupe de jeux de données de domaine pour le VIDEO_ON_DEMAND domaine.

aws personalize create-dataset-group \
--name dataset-group-name \
--domain VIDEO_ON_DEMAND

En cas de succès, le groupe de données Amazon Resource Name (ARN) s'affiche comme suit.

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

Enregistrez cette valeur pour une utilisation future. Pour afficher le groupe de jeux de données que vous avez créé, utilisez la describe-dataset-group commande et spécifiez le groupe de jeux de données renvoyéARN.

aws personalize describe-dataset-group \
--dataset-group-arn dataset group arn
    

Le groupe de jeux de données et ses propriétés s'affichent comme suit.

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

Lorsque le groupe de jeux de données l'statusestACTIVE, vous êtes prêt à créer un schéma et un jeu de données. Consultez Création d'un schéma et d'un jeu de données.

Création d'un groupe de jeux de données (AWS SDKs)

Utilisez le code suivant pour créer un groupe de jeux de données de domaine. Donnez un nom au groupe de jeux de données de domaine, et pourdomain, spécifiez l'un ECOMMERCE ou l'autreVIDEO_ON_DEMAND. Pour créer un groupe de jeux de données personnalisé, modifiez le code pour supprimer le paramètre de domaine.

Pour plus d'informations sur l'APIopération, voir CreateDatasetGroup la section API de référence. Vous pouvez utiliser le paramètre Tags pour étiqueter éventuellement les ressources dans Amazon Personalize. Pour un exemple, voirAjouter des balises (AWS 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();

L'DescribeDatasetGroupopération renvoie le datasetGroupArn et le statut de l'opération. Lorsque le groupe de jeux de données l'statusestACTIVE, vous êtes prêt à créer un schéma et un jeu de données. Consultez Création d'un schéma et d'un jeu de données.