As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Importar usuários individualmente
Depois de concluir [Criar um conjunto de dados e um esquema](data-prep-creating-datasets.md) 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 em massa para o Amazon Personalize com um trabalho de importação do conjunto de dados](bulk-data-import-step.md).
Você pode usar o console Amazon Personalize, o AWS Command Line Interface (AWS CLI) ou AWS SDKs 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 [Importar registros individuais para um conjunto de dados do Amazon Personalize](incremental-data-updates.md).
**Topics**
+ [Importar usuários individualmente do (console)](#importing-users-console)
+ [Importar usuários individualmente (AWS CLI)](#importing-users-cli)
+ [Importar usuários individualmente (AWS SDKs)](#importing-users-sdk)
## 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](data-prep-creating-datasets.md).
**Para importar usuários individualmente (console)**
1. Abra o console Amazon Personalize em [https://console.aws.amazon.com/personalize/casa](https://console.aws.amazon.com/personalize/home) e faça login na sua conta.
1. 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.
1. No painel de navegação, selecione **Conjuntos de dados**.
1. Na página **Conjuntos de dados**, escolha o conjunto de dados de usuários.
1. Na página de detalhes do conjunto de dados, no canto superior direito, escolha **Modificar conjunto de dados** e escolha **Criar registro**.
1. 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.
1. 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](API_UBS_PutUsers.md). 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](data-prep-creating-datasets.md).
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}}\"}"
}]'
```
## Importar usuários individualmente (AWS SDKs)
Adicione um ou mais usuários ao seu conjunto de dados de usuários com a operação [PutUsers](API_UBS_PutUsers.md). 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](data-prep-creating-datasets.md).
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 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();
```
------