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á. # Atualizar uma atribuição de métrica do Amazon Personalize Quando você atualizar uma atribuição de métricas, poderá adicionar ou remover métricas e modificar sua configuração de saída. Você pode atualizar uma atribuição métrica com o console AWS Command Line Interface Amazon Personalize ou SDKS. AWS **Topics** + [Atualizar uma atribuição de métrica (console)](#updating-metric-attribution-console) + [Atualizar uma atribuição de métrica (AWS CLI)](#updating-metric-attribution-cli) + [Atualização de uma atribuição métrica (SDK)AWS](#updating-metric-attribution-sdk) ## Atualizar uma atribuição de métrica (console) Para atualizar uma atribuição métrica com o console Amazon Personalize, você faz suas alterações na página de **atribuição de métrica**. **Para atualizar uma atribuição de métrica** 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. Escolha seu grupo de conjuntos de dados. 1. No painel de navegação, escolha **Atribuição de métrica**. 1. Na seção inferior, escolha a guia **Atributos de métrica** ou a guia **Configuração de atribuição de métrica** para começar a fazer alterações. + Para adicionar ou remover métricas, escolha a guia **Atributos de métrica** e escolha **Editar atributos**. Faça suas alterações na página **Editar atributos de métrica** e escolha **Atualizar** para salvar suas alterações. + Para fazer alterações no bucket de saída do Amazon S3 ou no perfil de serviço do IAM, escolha a guia **Editar configuração de atribuição métrica** e faça alterações na página **Editar configuração de atribuição**. Escolha **Atualizar** para salvar suas alterações. ## Atualizar uma atribuição de métrica (AWS CLI) Depois de criar uma atribuição de métrica, você pode usar o AWS Command Line Interface (AWS CLI) para adicionar e remover métricas e modificar sua configuração de saída. O código a seguir mostra como remover métricas com o comando `update-metric-attribution`: ``` aws personalize update-metric-attribution \ --metric-attribution-arn metric attribution arn \ --remove-metrics metricName1 metricName2 ``` O código a seguir mostra como adicionar uma métrica extra e especificar uma nova configuração de saída: ``` aws personalize update-metric-attribution \ --metric-attribution-arn metric attribution arn \ --metrics-output-config "{\"roleArn\": \"new role ARN\", \"s3DataDestination\":{\"kmsKeyArn\":\"kms key ARN\",\"path\":\"s3://amzn-s3-demo-bucket2/new-folder-name/\"}}" \ --add-metrics "[{ \"eventType\": \"event type\", \"expression\": \"SUM(DatasetType.COLUMN_NAME)\", \"metricName\": \"metric name\" }]" ``` Se obtiver êxito, o Amazon Personalize retornará o ARN da atribuição de métrica que você atualizou. Para ver uma lista com todos os parâmetros, consulte [UpdateMetricAttribution](API_UpdateMetricAttribution.md). ## Atualização de uma atribuição métrica (SDK)AWS Após criar uma atribuição de métricas, você pode adicionar ou remover métricas e modificar sua configuração de saída. O código a seguir mostra como remover métricas de uma atribuição de métrica. ------ #### [ SDK for Python (Boto3) ] ``` import boto3 personalize = boto3.client('personalize') metricsToRemove = ["metricName1", "metricName2"] response = personalize.update_metric_attribution( metricAttributionArn = "metric attribution ARN", removeMetrics = metricsToRemove ) ``` ------ #### [ SDK for Java 2.x ] ``` public static void removeMetrics(PersonalizeClient client, String metricAttributionArn, String metric1Name, String metric2Name) { ArrayList metricsToRemove = new ArrayList<>(Arrays.asList(metric1Name, metric2Name)); try { UpdateMetricAttributionRequest request = UpdateMetricAttributionRequest.builder() .metricAttributionArn(metricAttributionArn) .removeMetrics(metricsToRemove) .build(); UpdateMetricAttributionResponse response = client.updateMetricAttribution(request); System.out.println(response); } catch (PersonalizeException e) { System.out.println(e.awsErrorDetails().errorMessage()); } } ``` ------ #### [ SDK for JavaScript v3 ] ``` // Get service clients and commands using ES6 syntax. import {UpdateMetricAttributionCommand, PersonalizeClient } from "@aws-sdk/client-personalize"; // create personalizeClient const personalizeClient = new PersonalizeClient({ region: "REGION" }); // set the update request param export const updateMetricAttributionParam = { metricAttributionArn: "METRIC_ATTRIBUTION_ARN", /* required */ removeMetrics: ["METRIC_NAME_1", "METRIC_NAME_2"] /* specify list of names of metrics to delete */ }; export const run = async () => { try { const response = await personalizeClient.send( new UpdateMetricAttributionCommand(updateMetricAttributionParam) ); console.log("Success", response); return response; // For unit tests. } catch (err) { console.log("Error", err); } }; run(); ``` ------ O código a seguir mostra como adicionar uma métrica extra e especificar uma nova configuração de saída: ------ #### [ SDK for Python (Boto3) ] ``` import boto3 personalize = boto3.client('personalize') newMetrics = [{ "eventType": "event type", "expression": "SUM(DatasetType.COLUMN_NAME)", "metricName": "metric name" }] newOutputConfig = { "roleArn": "Amazon Personalize service role ARN", "s3DataDestination": { "kmsKeyArn": "key ARN", "path": "s3://amzn-s3-demo-bucket/" } } response = personalize.update_metric_attribution( metricAttributionArn = "metric attribution arn", metricsOutputConfig = newOutputConfig, addMetrics = newMetrics ) ``` ------ #### [ SDK for Java 2.x ] ``` public static void addMetricsAndUpdateOutputConfig(PersonalizeClient personalizeClient, String metricAttributionArn, String newMetric1EventType, String newMetric1Expression, String newMetric1Name, String newMetric2EventType, String newMetric2Expression, String newMetric2Name, String roleArn, String s3Path, String kmsKeyArn) { try { MetricAttribute newAttribute = MetricAttribute.builder() .eventType(newMetric1EventType) .expression(newMetric1Expression) .metricName(newMetric1Name) .build(); MetricAttribute newAttribute2 = MetricAttribute.builder() .eventType(newMetric2EventType) .expression(newMetric2Expression) .metricName(newMetric2Name) .build(); ArrayList newAttributes = new ArrayList<>(Arrays.asList(newAttribute, newAttribute2)); S3DataConfig newDataDestination = S3DataConfig.builder() .kmsKeyArn(kmsKeyArn) .path(s3Path) .build(); MetricAttributionOutput newOutputConfig = MetricAttributionOutput.builder() .roleArn(roleArn) .s3DataDestination(newDataDestination) .build(); UpdateMetricAttributionRequest request = UpdateMetricAttributionRequest.builder() .metricAttributionArn(metricAttributionArn) .metricsOutputConfig(newOutputConfig) .addMetrics(newAttributes) .build(); UpdateMetricAttributionResponse response = personalizeClient.updateMetricAttribution(request); System.out.println("New metrics added!"); System.out.println(response); } catch (PersonalizeException e) { System.out.println(e.awsErrorDetails().errorMessage()); } } ``` ------ #### [ SDK for JavaScript v3 ] ``` // Get service clients and commands using ES6 syntax. import {UpdateMetricAttributionCommand, PersonalizeClient } from "@aws-sdk/client-personalize"; // create personalizeClient const personalizeClient = new PersonalizeClient({ region: "REGION" }); export const updateMetricAttributionParam = { metricAttributionArn: "METRIC_ATTRIBUTION_ARN", addMetrics: [ { eventType: "EVENT_TYPE", /* required for each metric */ expression: "SUM(DatasetType.COLUMN_NAME)", /* required for each metric */ metricName: "METRIC_NAME", /* required for each metric */ } ], metricsOutputConfig: { roleArn: "ROLE_ARN", /* required */ s3DataDestination: { kmsKeyArn: "KEY_ARN", /* optional */ path: "s3://amzn-s3-demo-bucket//", /* optional */ }, } }; export const run = async () => { try { const response = await personalizeClient.send( new UpdateMetricAttributionCommand(updateMetricAttributionParam) ); console.log("Success", response); return response; // For unit tests. } catch (err) { console.log("Error", err); } }; run(); ``` ------ Se obtiver êxito, o Amazon Personalize retornará o ARN da atribuição de métrica que você atualizou. Para ver uma lista com todos os parâmetros, consulte [UpdateMetricAttribution](API_UpdateMetricAttribution.md).