Creazione delle regole di trasformazione Recupero delle regole di trasformazione Modifica delle regole di trasformazione Formato della regola di trasformazione Esempi di regole di trasformazione

Regole di trasformazione nella conversione dello schema DMS

Le regole di trasformazione consentono di personalizzare il modo in cui DMS Schema Conversion converte gli oggetti del database, sostituendo la denominazione predefinita e le mappature dei tipi di dati. È possibile applicare queste regole a database, schemi, tabelle, viste, colonne, valori restituiti dalle funzioni, parametri di routine e variabili locali.

Supponi, ad esempio, di avere una serie di tabelle nello schema di origine denominato test_TABLE_NAME. Puoi impostare una regola che modifichi il prefisso test_ con il prefisso demo_ nello schema di destinazione.

Puoi creare regole di trasformazione in grado di eseguire le seguenti attività:

Aggiunta, rimozione o sostituzione di un prefisso
Aggiunta, rimozione o sostituzione di un suffisso
Modificare il tipo di dati di una colonna, il valore restituito dalla funzione, il parametro di routine o la variabile locale
Converte il nome dell'oggetto in minuscolo o maiuscolo
Rinominare un oggetto

Creazione delle regole di trasformazione

La conversione dello schema DMS memorizza le regole di trasformazione come parte del progetto di migrazione. Per definire le regole di trasformazione, passale come stringa JSON che contiene un oggetto con un rules array quando crei o modifichi un progetto di migrazione. Ogni elemento dell'array rappresenta un oggetto regola separato. Un progetto di migrazione supporta fino a 512 regole di trasformazione (massimo 128 KB).

La struttura dell'array con regole di trasformazione è la seguente:


{
  "rules": [
    {
      Rule object 1
    },
    {
      Rule object 2
    },
    ...
    {
      Rule object N
    }
  ]
}

Puoi aggiungere più regole di trasformazione nel progetto. La conversione dello schema DMS applica le regole di trasformazione durante la conversione nello stesso ordine in cui le hai aggiunte.

Se più regole hanno come target lo stesso oggetto, il comportamento dipende dal tipo di azione. Le regole con tipi di azione diversi hanno tutte effetto. Ad esempio, si applicano sia una add-suffix regola che una regola. add-prefix Le regole con lo stesso tipo di azione si sovrascrivono a vicenda e solo l'ultima ha effetto.

Per creare regole di trasformazione, utilizzate uno dei seguenti metodi.

AWS Management Console

Per creare regole di trasformazione utilizzando la console

Nella pagina Crea un progetto di migrazione scegli Aggiungi regola di trasformazione. Per ulteriori informazioni, consulta Creazione di progetti di migrazione.
Per Rule target, scegli il tipo di oggetti di database a cui si applica questa regola. La procedura guidata della console supporta schematable, e column destinazioni. Per utilizzare altre destinazioni come database oview, usa l'editor JSON nella console o la AWS CLI.
Per Schema di origine scegli Inserisci uno schema. Quindi, specifica gli schemi di origine, le tabelle e le colonne a cui si applica questa regola. È possibile utilizzare un nome esatto per selezionare un oggetto oppure utilizzare un modello con il segno di percentuale (%) come jolly per abbinare un numero qualsiasi di caratteri.
In Operazione scegli l'attività da eseguire.
A seconda dell'azione della regola, inserisci valori aggiuntivi:
- add-prefixoppure add-suffix — Immettete il testo da aggiungere.
- remove-prefixoppure remove-suffix — Inserite il testo da rimuovere.
- replace-prefixo replace-suffix — Inserite il testo esistente e il testo sostitutivo.
- rename— Inserite il nuovo nome per l'oggetto.
- convert-uppercaseo convert-lowercase — Non sono richiesti valori aggiuntivi.
- change-data-type— Immettere il nome del tipo di dati di destinazione e, facoltativamente, la precisione, la scala o la lunghezza.
Scegli Aggiungi regola di trasformazione per aggiungere un'altra regola di trasformazione.

Dopo aver aggiunto le regole, scegli Crea un progetto di migrazione.

AWS CLI

Per aggiungere regole di trasformazione utilizzando la AWS CLI, utilizzate il --transformation-rules parametro con uno dei seguenti comandi:

L'esempio seguente aggiunge regole di trasformazione a un progetto di migrazione esistente:


aws dms modify-migration-project \
  --migration-project-identifier migration_project_arn \
  --transformation-rules 'json_rules'

Per eseguire questo comando in una regione AWS specifica, aggiungi il --region parametro, ad esempio--region us-west-2.

Per modificare, duplicare o rimuovere le regole di trasformazione esistenti, consultaModifica delle regole di trasformazione.

Recupero delle regole di trasformazione

È possibile recuperare le regole di trasformazione da un progetto di migrazione DMS Schema Conversion esistente utilizzando la console di AWS gestione o la AWS CLI.

Modifica delle regole di trasformazione

Per modificare, aggiungere o rimuovere le regole di trasformazione nel progetto di migrazione, utilizzate uno dei seguenti metodi.

Formato delle regole di trasformazione

Una regola di trasformazione utilizza i campi degli oggetti JSON per definire come convertire un oggetto di origine nel suo equivalente di destinazione. Ogni tipo di regola utilizza un set specifico di campi. Includi solo i campi relativi all'attività.

Il seguente oggetto JSON descrive una regola di trasformazione di DMS Schema Conversion:


{
  "rule-type": "transformation",
  "rule-id": rule_id,
  "rule-name": "rule_name",
  "rule-action": "rule_action",
  "rule-target": "rule_target",
  "object-locator": {
    [ "database-name": "database_name", ]
    [ "schema-name": "schema_name", ]
    [ "table-name": "table_name", ]
    [ "column-name": "column_name", ]
    [ "parent": "parent_name", ]
    [ "function-name": "function_name", ]
    [ "procedure-name": "procedure_name", ]
    [ "parameter-name": "parameter_name", ]
    [ "local-variable-name": "local_variable_name", ]
    [ "type": "source_data_type", ]
    [ "precision": source_precision, ]
    [ "scale": source_scale, ]
    [ "length": source_length ]
  },
  [ "value": "rule_value", ]
  [ "old-value": "rule_old_value", ]
  [ "data-type": {
    "type": "data_type_name",
    [ "precision": data_type_precision, ]
    [ "scale": data_type_scale, ]
    [ "length": data_type_length ]
  } ]
}

La tabella seguente descrive ogni parametro.

Parametro	Valori possibili	Description
`rule-type`	`transformation`	Un valore che applica la regola a ogni oggetto specificato dall'object locator. Per tutte le regole di trasformazione, impostalo su. `transformation` Parametro obbligatorio.
`rule-id`	Un valore numerico (intero).	Un valore numerico univoco per identificare la regola. Parametro obbligatorio.
`rule-name`	Un valore alfanumerico.	Un nome univoco per identificare la regola. Parametro obbligatorio.
`rule-action`	`add-prefix`, `remove-prefix`, `replace-prefix`, `add-suffix`, `remove-suffix`, `replace-suffix`, `convert-uppercase`, `convert-lowercase`, `rename`, `change-data-type`	La trasformazione che desideri applicare all'oggetto. Tutte le operazioni delle regole di trasformazione prevedono una distinzione tra lettere maiuscole e minuscole. Operazioni con prefisso: `add-prefix`— Aggiunge un testo specificato all'inizio di un nome. `remove-prefix`— Rimuove un testo specificato dall'inizio di un nome. `replace-prefix`— Sostituire un prefisso esistente con uno nuovo. Operazioni sui suffissi: `add-suffix`— Aggiunge un testo specificato alla fine di un nome. `remove-suffix`— Rimuove un testo specificato dalla fine di un nome. `replace-suffix`— Sostituire un suffisso esistente con uno nuovo. Conversione dei casi: `convert-uppercase`— Converte tutti i caratteri di un nome in maiuscolo. `convert-lowercase`— Converte tutti i caratteri di un nome in lettere minuscole. Modifica diretta: `rename`— Cambia il nome con un valore specificato completamente nuovo. `change-data-type`— Modificare il tipo di dati di una colonna o di una variabile locale con un tipo di dati diverso. Ambito: le operazioni di prefisso, suffisso, ridenominazione e conversione dei casi possono essere applicate a schemi, tabelle e colonne. L'`change-data-type`operazione si applica solo alle colonne, ai valori restituiti dalle funzioni, ai parametri di routine e alle variabili locali. Parametro obbligatorio.
`rule-target`	`database`, `schema`, `table`, `view`, `column`, `function result`, `routine parameter`, `local variable`	Il tipo di oggetto a cui verrà applicata la regola. `database`— Database. `schema`— Schema del database. `table`— Tabella del database. `view`— Visualizzazione del database. `column`— Tabella o colonna di visualizzazione del database. `function result`— Valore restituito dalla funzione. `routine parameter`— Procedura o parametro di funzione memorizzato. `local variable`— Variabile locale all'interno della procedura o della funzione memorizzata. Parametro obbligatorio.
`object-locator`	Un oggetto JSON.	Un oggetto che identifica gli oggetti del database di origine a cui si applica la regola. È possibile utilizzare il segno di percentuale (`%`) come carattere jolly per tutto o parte del valore in ogni campo dell'`object-locator`oggetto. L'oggetto contiene i seguenti campi di stringa: `database-name` `schema-name` `table-name` `column-name` `parent` `function-name` `procedure-name` `parameter-name` `local-variable-name` `type` `precision` `scale` `length` Tutti i nomi degli oggetti, ad esempio i nomi di tabelle o colonne, nelle regole di trasformazione fanno distinzione tra maiuscole e minuscole. Le sezioni seguenti descrivono ogni campo dell'oggetto. Parametro obbligatorio.
`object-locator \| database-name`	Un valore alfanumerico che segue le regole di denominazione per il database di origine.	Il nome del database di origine. Applicabile ai fornitori di database in cui l'architettura del database proviene dal database come contenitore di oggetti di primo livello. Ad esempio: Microsoft SQL Server, SAP ASE. Campo oggetto JSON opzionale.
`object-locator \| schema-name`	Un valore alfanumerico che segue le regole di denominazione per il database di origine.	Il nome dello schema del database di origine. Campo oggetto JSON opzionale.
`object-locator \| table-name`	Un valore alfanumerico che segue le regole di denominazione per il database di origine.	Il nome della tabella del database di origine. Campo oggetto JSON opzionale.
`object-locator \| column-name`	Un valore alfanumerico che segue le regole di denominazione per il database di origine.	Il nome della colonna della tabella del database di origine. Campo oggetto JSON opzionale.
`object-locator \| parent`	Un valore alfanumerico che segue le regole di denominazione per il database di origine.	Il nome dell'oggetto del database di origine che è il padre dell'oggetto specificato, ad esempio per o. `function-name` `procedure-name` Nei database di alcuni fornitori, l'oggetto a cui viene applicata la regola può essere subordinato e richiedere di specificare il relativo elemento principale. Ad esempio, le funzioni pacchettizzate in Oracle, dove l'elemento principale è il nome del pacchetto. Campo oggetto JSON opzionale.
`object-locator \| function-name`	Un valore alfanumerico che segue le regole di denominazione per il database di origine.	Il nome della funzione del database di origine. Campo oggetto JSON opzionale.
`object-locator \| procedure-name`	Un valore alfanumerico che segue le regole di denominazione per il database di origine.	Il nome della procedura del database di origine. Campo oggetto JSON opzionale.
`object-locator \| parameter-name`	Un valore alfanumerico che segue le regole di denominazione per il database di origine.	Il nome della funzione o del parametro della procedura del database di origine. Campo oggetto JSON opzionale.
`object-locator \| local-variable-name`	Un valore alfanumerico che segue le regole di denominazione per il database di origine.	Il nome di una variabile locale all'interno della funzione o della procedura del database di origine. Campo oggetto JSON opzionale.
`object-locator \| type`	Un valore alfanumerico.	Il nome del tipo di dati di origine da abbinare. Utilizzate questo campo per applicare la regola solo agli oggetti con un tipo di dati specifico. Campo oggetto JSON opzionale.
`object-locator \| precision`	Un valore numerico (intero).	La precisione del tipo di dati di origine da abbinare. Campo oggetto JSON opzionale.
`object-locator \| scale`	Un valore numerico (intero).	La scala del tipo di dati di origine da abbinare. Campo oggetto JSON opzionale.
`object-locator \| length`	Un valore numerico (intero).	La lunghezza del tipo di dati di origine da abbinare. Campo oggetto JSON opzionale.
`value`	Un valore alfanumerico che segue le regole di denominazione per il database di destinazione.	Il valore di testo utilizzato dall'azione di trasformazione. Per `add-prefix` e`add-suffix`, specifica il testo da aggiungere. Per `remove-prefix` and`remove-suffix`, specifica il testo da rimuovere. Per `replace-prefix` e`replace-suffix`, specifica il testo sostitutivo. Per`rename`, specifica il nuovo nome. Obbligatorio per tutte le azioni tranne `convert-uppercaseconvert-lowercase`, e`change-data-type`.
`old-value`	Un valore alfanumerico che segue le regole di denominazione per il database di origine.	Il valore esistente da trovare e sostituire nel nome dell'oggetto. Necessario per azioni come `replace-prefix` e`replace-suffix`. Parametro opzionale.
`data-type`	Un oggetto JSON.	Un oggetto che descrive le proprietà del tipo di dati sostitutivo quando è`rule-action`. `change-data-type` L'oggetto include i seguenti campi: `type`: stringa `precision`: numero `scale`: numero `length`: numero Le seguenti sezioni descrivono ogni campo dell'oggetto. Parametro opzionale.
`data-type \| type`	Un valore alfanumerico.	Il nome del tipo di dati sostitutivo per la colonna del database di destinazione, se `rule-action` è`change-data-type`. Deve essere un tipo di dati del database di destinazione valido. Campo oggetto JSON obbligatorio.
`data-type \| precision`	Un valore numerico (intero).	La precisione del tipo di dati sostitutivo per il database di destinazione, se è`rule-action`. `change-data-type` Campo oggetto JSON opzionale.
`data-type \| scale`	Un valore numerico (intero).	La scala del tipo di dati sostitutivo per il database di destinazione, se è`rule-action`. `change-data-type` Campo oggetto JSON opzionale.
`data-type \| length`	Un valore numerico (intero).	La lunghezza del tipo di dati sostitutivo per il database di destinazione, se è`rule-action`. `change-data-type` Campo oggetto JSON opzionale.

Esempi di regole di trasformazione

Gli esempi seguenti mostrano il valore JSON del --transformation-rules parametro per diversi tipi di regole: