Exigences relatives au schéma du jeu de données utilisateur (personnalisé)

Un jeu de données Utilisateurs stocke les métadonnées relatives à vos utilisateurs. Cela peut inclure des informations telles que l'âge, le sexe et l'adhésion au programme de fidélité pour chaque article. Pour plus d'informations sur les types de données utilisateur que vous pouvez importer dans Amazon Personalize, consultezMétadonnées utilisateur.

Les données que vous fournissez pour chaque utilisateur doivent correspondre à votre schéma. Au minimum, vous devez fournir un nom d'utilisateur pour chaque utilisateur (256 caractères maximum). Selon votre schéma, les métadonnées utilisateur peuvent inclure des valeurs vide/nulles. Votre schéma Users doit comporter au moins un champ de métadonnées, mais si vous ajoutez un null type, cette valeur peut être nulle pour l'utilisateur. Vous êtes libre d'ajouter des champs supplémentaires en fonction de votre cas d'utilisation et de vos données. Tant que les champs ne sont pas répertoriés comme obligatoires ou réservés et que les types de données y sont répertoriésTypes de données de schéma, les noms des champs et les types de données dépendent de vous.

Pour utiliser des données catégorielles, ajoutez un champ de type string et définissez l'attribut catégorique du champ sur true dans votre schéma. Incluez ensuite les données catégorielles dans votre CSV fichier groupé et vos importations d'enregistrements individuels. Pour les utilisateurs ayant plusieurs catégories, séparez chaque valeur à l'aide de la barre verticale « | ». Par exemple, pour un MODEL champ SUBSCRIPTION _, les données relatives à un utilisateur peuvent être student|monthly|discount.

Les valeurs catégorielles peuvent comporter au maximum 1 000 caractères. Si un utilisateur possède une valeur catégorielle de plus de 1 000 caractères, votre tâche d'importation de jeu de données échouera.

Pour plus d'informations sur les exigences minimales et les limites de données maximales pour un ensemble de données utilisateurs, consultezQuotas de service.

Exemple de schéma d'utilisateurs (personnalisé)

L'exemple suivant montre comment structurer un schéma Users. Le USER_ID champ est obligatoire et les GENDER champs AGE et sont des métadonnées. Au moins un champ de métadonnées est obligatoire et vous pouvez ajouter au maximum 25 champs de métadonnées. Pour plus d'informations sur les exigences du schéma, voirExigences relatives aux ensembles de données et aux schémas personnalisés.

{
  "type": "record",
  "name": "Users",
  "namespace": "com.amazonaws.personalize.schema",
  "fields": [
      {
          "name": "USER_ID",
          "type": "string"
      },
      {
          "name": "AGE",
          "type": "int"
      },
      {
          "name": "GENDER",
          "type": "string",
          "categorical": true
      }
  ],
  "version": "1.0"
}

Pour ce schéma, les premières lignes de données historiques d'un CSV fichier peuvent ressembler à ce qui suit.

USER_ID,AGE,GENDER
5,34,Male
6,56,Female
8,65,Male
...
...