Schritt 1: Erstellen einer Datensatzgruppe

Wenn Sie Amazon Personalize verwenden, erstellen Sie eine Datensatzgruppe. Eine Datensatzgruppe ist ein Container für Amazon Personalize Personalize-Ressourcen, einschließlich Datensätzen, Domain-Empfehlungen und benutzerdefinierten Ressourcen. Eine Datensatzgruppe organisiert Ihre Ressourcen in unabhängigen Sammlungen, wobei Ressourcen aus einer Datensatzgruppe keine Ressourcen in einer anderen Datensatzgruppe beeinflussen können.

Sie erstellen eine Datensatzgruppe für jede Ihrer Geschäftsdomänen. Angenommen, Sie haben eine Anwendung, die Empfehlungen für das Streamen von Videos bereitstellt, und eine andere, die Empfehlungen für Hörbücher bereitstellt. In Amazon Personalize würden Sie für jede Anwendung eine Datensatzgruppe erstellen. Auf diese Weise haben die Daten aus einer Anwendung keinen Einfluss auf die Empfehlungen, die Amazon Personalize für die andere Anwendung generiert.

Sie können eine Domain-Datensatzgruppe oder eine benutzerdefinierte Datensatzgruppe erstellen:

• Mit einer Domain-Datensatzgruppe erstellen Sie Ressourcen, die für verschiedene Anwendungsfälle vorkonfiguriert und optimiert sind. Wenn Sie eine Datensatzgruppe erstellen, machen Sie sie zu einer Domain-Datensatzgruppe, indem Sie die Domäne VIDEO_ON_DEMAND oder ECOMMERCE angeben.

  Wenn Sie über eine Streaming-Video- oder E-Commerce-Anwendung verfügen, empfehlen wir Ihnen, eine Domain-Datensatzgruppe zu erstellen. Sie können weiterhin benutzerdefinierte Ressourcen hinzufügen, z. B. Lösungen und Lösungsversionen, die für benutzerdefinierte Anwendungsfälle trainiert wurden. Sie können in einer Domain-Datensatzgruppe keine Ressourcen für die nächste beste Aktion erstellen, einschließlich der Datensätze „Aktionen“ und „Aktionsinteraktionen“.

• Eine benutzerdefinierte Datensatzgruppe umfasst nur benutzerdefinierte Ressourcen, die Sie je nach Anwendungsfall konfigurieren. Mit maßgeschneiderten Ressourcen können Sie konfigurierbare Lösungen und Lösungsversionen (ein geschultes Amazon Personalize-Empfehlungsmodell) auf der Grundlage Ihrer Geschäftsanforderungen schulen und bereitstellen. Wenn Sie keine VIDEO_ON_DEMAND- oder E-COMMERCE-Anwendung haben, empfehlen wir Ihnen, eine benutzerdefinierte Datensatzgruppe zu erstellen. Andernfalls empfehlen wir, mit einer Domain-Datensatzgruppe zu beginnen und bei Bedarf benutzerdefinierte Ressourcen hinzuzufügen.

Sie können eine Datensatzgruppe mit der Amazon Personalize Personalize-Konsole, AWS Command Line Interface (AWS CLI) oder AWS SDKs erstellen.

Eine Datensatzgruppe (Konsole) erstellen

Erstellen Sie eine Datensatzgruppe, indem Sie den Namen der Datensatzgruppe in der Amazon Personalize Personalize-Konsole angeben.

Um eine Datensatzgruppe zu erstellen

1. Öffnen Sie die Amazon Personalize Personalize-Konsole unter https://console.aws.amazon.com/personalize/home und melden Sie sich bei Ihrem Konto an.

2. Wählen Sie Create dataset group (Dataset-Gruppe erstellen).

3. Wenn Sie Amazon Personalize zum ersten Mal verwenden, wählen Sie auf der Seite Datensatzgruppe erstellen unter Neue Datensatzgruppe die Option Erste Schritte aus.

4. Geben Sie für Dataset group details (Details zur Dataset-Gruppe) in Dataset group name (Dataset-Gruppenname) einen Namen für die Dataset-Gruppe an.

5. Wählen Sie Ihre Domain:

   • Wählen Sie E-Commerce, um eine E-COMMERCE-Domain-Datensatzgruppe zu erstellen.

   • Wählen Sie Video on Demand, um eine VIDEO_ON_DEMAND-Domänen-Datensatzgruppe zu erstellen.

   • Wählen Sie Benutzerdefiniert, um eine benutzerdefinierte Datensatzgruppe zu erstellen, die nur benutzerdefinierte Ressourcen wie Lösungen, Kampagnen und Batch-Inferenzjobs enthält.

6. Fügen Sie für Tags optional beliebige Tags hinzu. Weitere Informationen zum Taggen von Amazon Personalize Personalize-Ressourcen finden Sie unter. Taggen von Amazon Personalize Personalize-Ressourcen

7. Wählen Sie Create dataset group (Dataset-Gruppe erstellen). Die Übersichtsseite wird angezeigt. Sie sind jetzt bereit, Daten zu importieren. Siehe Schritt 2: Daten vorbereiten und importieren.

Eine Datensatzgruppe erstellen (AWS CLI)

Verwenden Sie die create-dataset-group Operation, um eine Datensatzgruppe zu erstellen. Um eine Domain-Datensatzgruppe zu erstellen, geben Sie für Domain ECOMMERCE oder anVIDEO_ON_DEMAND. Um eine benutzerdefinierte Datensatzgruppe zu erstellen, geben Sie keine Domäne an. Sie können den Tags-Parameter verwenden, um optional Ressourcen in Amazon Personalize zu taggen. Ein Beispiel finden Sie unterHinzufügen von Tags (AWS CLI).

Der folgende Code erstellt eine Domain-Datensatzgruppe für die VIDEO_ON_DEMAND Domäne.

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

Bei Erfolg wird die Datensatzgruppe Amazon Resource Name (ARN) wie folgt angezeigt.

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

Notieren Sie sich diesen Wert für future Verwendung. Um die von Ihnen erstellte Datensatzgruppe anzuzeigen, verwenden Sie den describe-dataset-group Befehl und geben Sie den ARN der zurückgegebenen Datensatzgruppe an.

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

Die Datensatzgruppe und ihre Eigenschaften werden wie folgt angezeigt.

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

Wenn die Datensatzgruppe AKTIV status ist, können Sie Daten importieren. Weitere Informationen finden Sie unter Schritt 2: Daten vorbereiten und importieren.

Eine Datensatzgruppe (AWS SDKs) erstellen

Verwenden Sie den folgenden Code, um eine Domain-Datensatzgruppe zu erstellen. Geben Sie der Domain-Datensatzgruppe einen Namen und geben Sie für domain entweder ECOMMERCE oder anVIDEO_ON_DEMAND. Um eine benutzerdefinierte Datensatzgruppe zu erstellen, ändern Sie den Code, um den Domänenparameter zu entfernen.

Weitere Informationen zur API-Operation finden Sie CreateDatasetGroup im Abschnitt API-Referenz. Sie können den Tags-Parameter verwenden, um optional Ressourcen in Amazon Personalize zu taggen. Ein Beispiel finden Sie unterHinzufügen von Tags (AWS SDKs).

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();

Der DescribeDatasetGroup Vorgang gibt den datasetGroupArn und den Status des Vorgangs zurück. Wenn die Datensatzgruppe AKTIV status ist, sind Sie bereit, Daten zu importieren. Weitere Informationen finden Sie unter Schritt 2: Daten vorbereiten und importieren.