Aktualisierung einer Amazon Personalize Personalize-Metrikzuweisung

PDFRSS

Wenn Sie eine Metrik-Attribution aktualisieren, können Sie Metriken hinzufügen und entfernen und die Ausgabekonfiguration ändern. Sie können eine Metrikzuweisung mit der Amazon Personalize Personalize-Konsole oder AWS dem AWS Command Line Interface SDKS aktualisieren.

Aktualisierung einer Metrik-Zuordnung (Konsole)

Um eine Metrik-Zuordnung mit der Amazon Personalize-Konsole zu aktualisieren, nehmen Sie Ihre Änderungen auf der Seite Metrik-Zuordnung vor.

Um eine Metrik-Zuordnung zu aktualisieren

1. Öffnen Sie zu https://console.aws.amazon.com/personalize/Hause die Amazon Personalize Personalize-Konsole und melden Sie sich bei Ihrem Konto an.

2. Wählen Sie Ihre Datensatzgruppe aus.

3. Wählen Sie im Navigationsbereich die Option Metrische Zuordnung aus.

4. Wählen Sie im unteren Bereich die Registerkarte Metrikattribute oder die Registerkarte Konfiguration der metrischen Zuordnung aus, um mit den Änderungen zu beginnen.

   • Um Metriken hinzuzufügen oder zu entfernen, wählen Sie den Tab Metrikattribute und dann Attribute bearbeiten aus. Nehmen Sie Ihre Änderungen auf der Seite Metrikattribute bearbeiten vor und wählen Sie Aktualisieren, um Ihre Änderungen zu speichern.

   • Um Änderungen am Amazon S3 S3-Ausgabe-Bucket oder der IAM-Servicerolle vorzunehmen, wählen Sie die Registerkarte Konfiguration der Metrikzuweisung bearbeiten und nehmen Sie die Änderungen auf der Seite Attributionskonfiguration bearbeiten vor. Wählen Sie Aktualisieren aus, um Ihre Änderungen zu speichern.

Aktualisierung einer Metrik-Attribution ()AWS CLI

Nachdem Sie eine Metrik-Attribution erstellt haben, können Sie die AWS Command Line Interface (AWS CLI) verwenden, um Metriken hinzuzufügen und zu entfernen und die Ausgabekonfiguration zu ändern. Der folgende Code zeigt, wie Sie Metriken mit dem update-metric-attribution Befehl entfernen:

aws personalize update-metric-attribution \
--metric-attribution-arn metric attribution arn \
--remove-metrics metricName1 metricName2

Der folgende Code zeigt, wie Sie eine zusätzliche Metrik hinzufügen und eine neue Ausgabekonfiguration angeben:

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\"
}]"

Bei Erfolg gibt Amazon Personalize den ARN der Metrik-Attribution zurück, die Sie aktualisiert haben. Eine vollständige Liste aller Parameter finden Sie unter. UpdateMetricAttribution

Aktualisierung einer metrischen Zuordnung (AWS SDK)

Nachdem Sie eine Metrik-Attribution erstellt haben, können Sie Metriken hinzufügen oder entfernen und deren Ausgabekonfiguration ändern. Der folgende Code zeigt, wie Sie Metriken aus einer Metrik-Attribution entfernen.

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<String> 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();

Der folgende Code zeigt, wie Sie eine zusätzliche Metrik hinzufügen und eine neue Ausgabekonfiguration angeben:

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/<folder>"
  }
}

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<MetricAttribute> 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/<folderName>/",    /* 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();

Bei Erfolg gibt Amazon Personalize den ARN der Metrik-Attribution zurück, die Sie aktualisiert haben. Eine vollständige Liste aller Parameter finden Sie unter. UpdateMetricAttribution