Importar usuários individualmente

Depois de concluir Criar um conjunto de dados e um esquema para criar um conjunto de dados de usuários, você pode importar individualmente um ou mais novos usuários para o conjunto de dados. Ao importar usuários individualmente, você mantém seu conjunto de dados de usuários atualizado com pequenas importações em lote à medida que seu catálogo cresce. É possível importar até 10 usuários por vez. Se você tiver uma grande quantidade de novos usuários, recomendamos que primeiro importe os dados em lote e depois individualmente, conforme necessário. Consulte Importar dados diretamente para os conjuntos de dados do Amazon Personalize.

Você pode usar o console Amazon Personalize, o AWS Command Line Interface (AWS CLI) ou os AWS SDKs para importar usuários. Se você importar um usuário com o mesmo userId que um usuário já presente no seu conjunto de dados de usuários, o Amazon Personalize o substituirá pelo novo item. É possível importar até 10 usuários por vez.

Para saber como o Amazon Personalize atualiza filtros para novos registros e como os novos registros influenciam as recomendações, consulte Como importar registros individuais.

Importar usuários individualmente do (console)

É possível importar até 10 usuários por vez. Este procedimento pressupõe que você já criou um conjunto de dados de usuários. Para saber como criar conjuntos de dados, consulte Criar um conjunto de dados e um esquema.

Para importar usuários individualmente (console)

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

2. Na página Grupos de conjuntos de dados, escolha o grupo de conjuntos de dados com o conjunto de dados de usuários para o qual você deseja importar o usuário.

3. No painel de navegação, selecione Conjuntos de dados.

4. Na página Conjuntos de dados, escolha o conjunto de dados de usuários.

5. Na página de detalhes do conjunto de dados, no canto superior direito, escolha Modificar conjunto de dados e escolha Criar registro.

6. Na página Criar registros de usuários, para entrada de registro, insira os detalhes do usuário no formato JSON. Os nomes e valores dos campos do usuário devem corresponder ao esquema usado quando você criou o conjunto de dados de usuários. O Amazon Personalize fornece um modelo JSON com nomes de campo e tipos de dados desse esquema.

7. Escolha Criar registro(s). Em Resposta, o resultado da importação é listado, e uma mensagem de sucesso ou falha é exibida.

Importar usuários individualmente (AWS CLI)

Adicione um ou mais usuários ao seu conjunto de dados de usuários com a operação PutUsers. Você pode importar até 10 usuários com uma única chamada para PutUsers. Esta seção pressupõe que você já criou um conjunto de dados de usuários. Para saber como criar conjuntos de dados, consulte Criar um conjunto de dados e um esquema.

Use o comando put-users a seguir para adicionar um ou mais usuários com a AWS CLI. Substitua dataset arn pelo nome do recurso da Amazon (ARN) do seu conjunto de dados e user Id pelo ID do usuário. Se um usuário com o mesmo userId já estiver presente no seu conjunto de dados de usuários, o Amazon Personalize o substituirá pelo novo usuário.

Para properties, para cada campo no seu conjunto de dados de usuários, substitua propertyName pelo nome do campo do seu esquema em maiúsculas e minúsculas. Por exemplo, GENDER seria gender, e MEMBERSHIP_TYPE seria membershipType. Substitua user data pelos dados do usuário. No caso de dados de string categóricos, para incluir várias categorias em uma única propriedade, separe cada uma com um pipe (|). Por exemplo, \"Premium Class|Legacy Member\".

aws personalize-events put-users \
  --dataset-arn dataset arn \
  --users '[{
      "userId": "user Id", 
      "properties": "{\"propertyName\": "\user data\"}" 
    }, 
    {
      "userId": "user Id", 
      "properties": "{\"propertyName\": "\user data\"}" 
    }]'

Importação individual de usuários (AWS SDKs)

Adicione um ou mais usuários ao seu conjunto de dados de usuários com a operação PutUsers. Se um usuário com o mesmo userId já estiver presente no seu conjunto de dados de usuários, o Amazon Personalize o substituirá pelo novo usuário. Você pode importar até 10 usuários com uma única chamada para PutUsers. Esta seção pressupõe que você já criou um conjunto de dados de usuários. Para saber como criar conjuntos de dados, consulte Criar um conjunto de dados e um esquema.

O código a seguir mostra como adicionar um ou mais itens ao seu conjunto de dados de usuários. Para cada parâmetro de nome de propriedade, envie o nome do campo do seu esquema em maiúsculas e minúsculas. Por exemplo, GENDER seria gender, e MEMBERSHIP_TYPE seria membershipType. Para cada parâmetro de valor da propriedade, passe os dados para o usuário.

No caso de dados de string categóricos, para incluir várias categorias em uma única propriedade, separe cada uma com um pipe (|). Por exemplo, "Premium class|Legacy Member".

SDK for Python (Boto3)

import boto3

personalize_events = boto3.client(service_name='personalize-events')

personalize_events.put_users(
    datasetArn = 'dataset arn',
    users = [{
      'userId': 'user ID',
      'properties': "{\"propertyName\": \"user data\"}"   
      },
      {
      'userId': 'user ID',
      'properties': "{\"propertyName\": \"user data\"}"   
      }]
)

SDK for Java 2.x

public static int putUsers(PersonalizeEventsClient personalizeEventsClient,
                         String datasetArn,
                         String user1Id,
                         String user1PropertyName,
                         String user1PropertyValue,
                         String user2Id,
                         String user2PropertyName,
                         String user2PropertyValue) {

    int responseCode = 0;
    ArrayList<User> users = new ArrayList<>();

    try {
        User user1 = User.builder()
          .userId(user1Id)
          .properties(String.format("{\"%1$s\": \"%2$s\"}", user1PropertyName, user1PropertyValue))
          .build();

        users.add(user1);

        User user2 = User.builder()
          .userId(user2Id)
          .properties(String.format("{\"%1$s\": \"%2$s\"}", user2PropertyName, user2PropertyValue))
          .build();

        users.add(user2);

        PutUsersRequest putUsersRequest = PutUsersRequest.builder()
          .datasetArn(datasetArn)
          .build();

        responseCode = personalizeEventsClient.putUsers(putUsersRequest).sdkHttpResponse().statusCode();
        System.out.println("Response code: " + responseCode);
        return responseCode;

    } catch (PersonalizeEventsException e) {
        System.out.println(e.awsErrorDetails().errorMessage());
    }
    return responseCode;
}

SDK for JavaScript v3

import {
  PutUsersCommand,
  PersonalizeEventsClient,
} from "@aws-sdk/client-personalize-events";

const personalizeEventsClient = new PersonalizeEventsClient({
  region: "REGION",
});

// set the put users parameters
var putUsersParam = {
  datasetArn:
    "DATASET ARN",
  users: [
    {
      userId: "userId",
      properties: '{"column1Name": "value", "column2Name": "value"}',
    },
    {
      userId: "userId",
      properties: '{"column1Name": "value", "column2Name": "value"}',
    },
  ],
};
export const run = async () => {
  try {
    const response = await personalizeEventsClient.send(
      new PutUsersCommand(putUsersParam)
    );
    console.log("Success!", response);
    return response; // For unit tests.
  } catch (err) {
    console.log("Error", err);
  }
};
run();