Memperbarui atribusi metrik Amazon Personalisasi

Saat memperbarui atribusi metrik, Anda dapat menambahkan dan menghapus metrik dan memodifikasi konfigurasi outputnya. Anda dapat memperbarui atribusi metrik dengan konsol Amazon Personalize AWS Command Line Interface,, atau. AWS SDKS

Memperbarui atribusi metrik (konsol)

Untuk memperbarui atribusi metrik dengan konsol Amazon Personalize, Anda membuat perubahan di halaman atribusi Metrik.

Untuk memperbarui atribusi metrik

1. Buka konsol Amazon Personalize di https://console.aws.amazon.com/personalize/rumah dan masuk ke akun Anda.

2. Pilih grup kumpulan data Anda.

3. Di panel navigasi, pilih Atribusi metrik.

4. Di bagian bawah, pilih tab Atribut metrik atau tab Konfigurasi atribusi metrik untuk mulai membuat perubahan.

   • Untuk menambah atau menghapus metrik, pilih tab Atribut metrik dan pilih Edit atribut. Buat perubahan di halaman Edit atribut metrik dan pilih Perbarui untuk menyimpan perubahan Anda.

   • Untuk membuat perubahan pada bucket keluaran Amazon S3 atau peran IAM layanan, pilih tab Edit konfigurasi atribusi metrik dan buat perubahan pada halaman konfigurasi Edit atribusi. Pilih Perbarui untuk menyimpan perubahan.

Memperbarui atribusi metrik ()AWS CLI

Setelah membuat atribusi metrik, Anda dapat menggunakan AWS Command Line Interface (AWS CLI) untuk menambah dan menghapus metrik dan memodifikasi konfigurasi outputnya. Kode berikut menunjukkan cara menghapus metrik dengan update-metric-attribution perintah:

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

Kode berikut menunjukkan cara menambahkan metrik tambahan dan menentukan konfigurasi keluaran baru:

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

Jika berhasil, Amazon Personalize mengembalikan atribusi metrik ARN yang Anda perbarui. Untuk daftar lengkap semua parameter, lihatUpdateMetricAttribution.

Memperbarui atribusi metrik ()AWS SDK

Setelah membuat atribusi metrik, Anda dapat menambahkan atau menghapus metrik dan memodifikasi konfigurasi outputnya. Kode berikut menunjukkan cara menghapus metrik dari atribusi metrik.

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

Kode berikut menunjukkan cara menambahkan metrik tambahan dan menentukan konfigurasi keluaran baru:

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

Jika berhasil, Amazon Personalize mengembalikan atribusi metrik ARN yang Anda perbarui. Untuk daftar lengkap semua parameter, lihatUpdateMetricAttribution.