Sostituzione dello schema di un set di dati per aggiungere nuove colonne

Dopo aver creato un set di dati Items o Users, puoi sostituirne lo schema con uno nuovo o esistente. È possibile sostituire lo schema di un set di dati se la struttura dei dati è cambiata dopo la creazione del set di dati. Ad esempio, potresti avere una nuova colonna di metadati degli articoli che desideri che Amazon Personalize consideri durante la formazione. Oppure potresti voler aggiungere una colonna di dati da utilizzare solo per filtrare i consigli.

Quando sostituisci lo schema di un set di dati, devi mantenere tutti i campi dello schema precedente e non puoi modificarne i tipi di dati o gli attributi. Dopo aver sostituito lo schema di un set di dati, Amazon Personalize esclude automaticamente qualsiasi nuova colonna dalla formazione per eventuali consiglieri o soluzioni personalizzate esistenti. Per ulteriori linee guida e requisiti, consulta. Linee guida e requisiti

Puoi sostituire lo schema di un set di dati con la console Amazon Personalize AWS Command Line Interface ,AWS CLI() e gli SDK. AWS

Linee guida e requisiti

Prima di sostituire lo schema per un set di dati, assicurati di conoscere le seguenti linee guida e requisiti:

• Non puoi sostituire lo schema di un set di dati sulle interazioni tra elementi, sul set di dati sulle interazioni con azioni o sul set di dati Actions.

• È possibile aggiungere nuovi campi allo schema sostitutivo, ma è necessario mantenere tutti i campi dello schema precedente. E non puoi modificare i loro tipi di dati o attributi. Ad esempio, se lo schema precedente include un MEMBERSHIP_STATUS campo per dati di tipo stringa categorico, il nuovo schema utilizzato deve includere un MEMBERSHIP_STATUS campo con questi attributi e tipi di dati.

• Se lo schema corrente include un campo che desideri rinominare o se desideri modificarne i tipi di dati o gli attributi, puoi aggiungere un nuovo campo con un nuovo nome e tipi o attributi modificati. Quindi includi il nuovo campo nella formazione ed escludi il vecchio campo. Tutti i nuovi campi devono supportare null i dati. Se il vecchio campo non supportava dati nulli, quando importi i dati, puoi utilizzare i dati segnaposto per assicurarti che l'importazione corrisponda allo schema. Per informazioni sulla configurazione delle colonne utilizzate da un programma di raccomandazione, consulta. Aggiornamento di un consiglio Per informazioni sulla configurazione delle colonne utilizzate da una soluzione, vedere. Configurazione delle colonne utilizzate durante l'allenamento

• Tutti i nuovi campi devono supportare i null dati. Per informazioni sull'aggiunta di un tipo null a un campo, vedereTipi di dati dello schema.

• Dopo aver sostituito lo schema di un set di dati, Amazon Personalize esclude automaticamente qualsiasi nuova colonna dalla formazione per eventuali consiglieri o soluzioni personalizzate esistenti. L'utilizzo del set di dati modificato comporta le seguenti azioni:

  • Per utilizzare nuove colonne nella formazione, importate dati in linea con il nuovo schema. Quindi aggiorna gli eventuali consiglieri per utilizzare nuove colonne oppure crea una nuova soluzione personalizzata e configura le colonne da utilizzare durante la formazione.

    Per informazioni sull'aggiornamento delle colonne utilizzate da un consulente, consulta. Aggiornamento di un consiglio Per informazioni sulla configurazione delle colonne utilizzate da una soluzione, vedere. Configurazione delle colonne utilizzate durante l'allenamento

  • Per utilizzare qualsiasi colonna solo per il filtraggio, importa i dati in linea con il nuovo schema, crea un filtro che utilizzi i nuovi dati e applica il filtro alle tue richieste di consigli. Non è necessario aggiornare i consiglieri o creare o aggiornare risorse personalizzate.

Sostituzione dello schema di un set di dati (console)

Per sostituire lo schema di un set di dati con la console Amazon Personalize, scegli il set di dati da modificare e scegli di sostituirlo con uno nuovo o utilizzarne uno esistente.

Per sostituire lo schema di un set di dati

1. Apri la console Amazon Personalize all'indirizzo https://console.aws.amazon.com/personalize/home e accedi al tuo account.

2. Nella pagina dei gruppi di set di dati, scegli il tuo gruppo di set di dati.

3. Nel riquadro di navigazione, scegli Set di dati e scegli il pulsante di opzione per il set di dati che desideri modificare.

4. Scegli Azioni e scegli Sostituisci schema.

5. Nei dettagli dello schema, scegli di sostituirlo con un nuovo schema o con uno creato in precedenza.

6. Specificate il nuovo schema da utilizzare. Se hai scelto di:

   • Sostituisci con un nuovo schema, quindi assegna un nome allo schema e, in Definizione dello schema, apporta le modifiche allo schema JSON.

   • Usa uno schema creato in precedenza, quindi per Schema creato in precedenza, scegli lo schema che desideri utilizzare. Sono elencati solo gli schemi idonei. Per informazioni sui requisiti dello schema, vedereLinee guida e requisiti.

7. Scegliere Replace (Sostituisci). Quando il set di dati è attivo, puoi iniziare a importare dati in linea con il nuovo schema. Per ulteriori informazioni, consulta Fase 2: Preparazione e importazione dei dati.

Sostituzione dello schema di un set di dati ()AWS CLI

Per sostituire lo schema di un set di dati con AWS CLI, usa il update-dataset comando, specifica l'Amazon Resource Name (ARN) del set di dati da aggiornare e l'ARN del nuovo schema da utilizzare. Non puoi aggiornare lo schema di un set di dati sulle interazioni tra elementi, sul set di dati sulle interazioni con azioni o sul set di dati Actions.

Il codice seguente mostra come aggiornare lo schema di un set di dati con. AWS CLI Per sostituire lo schema di un set di dati con uno nuovo, usa prima il create-schema comando. Quindi usa il codice seguente per sostituire lo schema corrente con quello nuovo. Per informazioni sulla creazione di uno schema con AWS CLI, vedereCreazione di un set di dati e di uno schema ()AWS CLI. Per informazioni sui set di dati e sui requisiti dello schema, vedereSchemi.

aws personalize update-dataset \
--dataset-arn Dataset ARN \
--schema-arn New schema ARN

Quando il set di dati è attivo, puoi iniziare a importare dati in linea con il nuovo schema. Per ulteriori informazioni, consulta Fase 2: Preparazione e importazione dei dati. Per informazioni sull'ultimo aggiornamento del set di dati, è possibile utilizzare l'operazione. DescribeDataset

Sostituzione dello schema di un set di dati (SDK)AWS

Per sostituire lo schema di un set di dati con gli AWS SDK, si utilizza l'operazione API. UpdateDataset Specificare l'Amazon Resource Name (ARN) del set di dati da aggiornare e il nuovo schema da utilizzare. Non puoi aggiornare lo schema di un set di dati sulle interazioni tra elementi, sul set di dati sulle interazioni con azioni o sul set di dati Actions.

Il codice seguente mostra come sostituire lo schema di un set di dati con l'SDK for Python (Boto3). Per sostituire lo schema di un set di dati con uno nuovo, usa prima l'operazione. CreateSchema Quindi utilizzate il codice seguente per sostituire lo schema corrente con quello nuovo. Per informazioni sulla creazione di uno schema con gli AWS SDK, consultaCreazione di un set di dati e di uno schema (SDK)AWS. Per informazioni sui requisiti del set di dati e dello schema, consulta. Schemi

import boto3

personalize = boto3.client('personalize')

update_dataset_response = personalize.update_dataset(
    datasetArn = 'dataset_arn',
    schemaArn = 'new_schema_arn'
)

print(update_dataset_response)

Quando il set di dati è attivo, puoi iniziare a importare dati in linea con il nuovo schema. Per ulteriori informazioni, consulta Fase 2: Preparazione e importazione dei dati. Per informazioni sull'ultimo aggiornamento del set di dati, è possibile utilizzare l'operazione. DescribeDataset