Requisitos do esquema de conjunto de dados de usuários (personalizado)

Um conjunto de dados de usuários armazena metadados sobre seus usuários. Isso pode incluir informações como idade, gênero e associação de fidelidade para cada item. Para obter informações sobre os tipos de dados de usuário que você pode importar para o Amazon Personalize, consulte Metadados do usuário.

Os dados que você fornece para cada usuário devem corresponder ao seu esquema. No mínimo, você deve fornecer um ID de usuário para cada usuário (comprimento máximo de 256 caracteres). Dependendo do seu esquema, os metadados de usuário podem incluir valores vazios/nulos. Seu esquema de usuários deve ter no mínimo um campo de metadados, mas, se você adicionar um tipo null, esse valor pode ser nulo para o usuário. Você pode adicionar outros campos, dependendo do seu caso de uso e dos seus dados. Desde que os campos não estejam listados como obrigatórios ou reservados e os tipos de dados estejam listados em Tipos de dados do esquema, é você quem escolhe os nomes e tipos de dados dos campos.

Para usar dados categóricos, adicione um campo do tipo string e defina o atributo categórico do campo como true em seu esquema. Em seguida, inclua os dados categóricos no arquivo CSV em massa e nas importações de registros individuais. Para usuários com várias categorias, separe cada valor usando a barra vertical '|'. Por exemplo, para um campo SUBSCRIPTION_MODEL, seus dados de um usuário podem ser estudante|mensal|desconto.

Os valores categóricos podem ter no máximo 1.000 caracteres. Se você tiver um usuário com um valor categórico com mais de 1.000 caracteres, sua tarefa de importação do conjunto de dados falhará.

Para obter mais informações sobre requisitos mínimos e limites máximos de dados para um conjunto de dados de usuários, consulte Cotas de serviço.

Exemplo de esquema de usuários (personalizado)

O exemplo a seguir mostra como estruturar um esquema de usuários. O campo USER_ID é obrigatório e os campos AGE e GENDER são metadados. Pelo menos um campo de metadados é obrigatório e você pode adicionar no máximo 25 campos de metadados. Para obter informações sobre requisitos do esquema, consulte Requisitos de conjuntos de dados personalizados e esquemas.

{
  "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"
}

Para este esquema, as primeiras linhas de dados históricos em um arquivo CSV podem ser da seguinte forma.

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