Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Esegui la migrazione della funzionalità Oracle ROWID a PostgreSQL su AWS *Rakesh Raghav e Ramesh Pathuri, Amazon Web Services* ## Riepilogo Questo modello descrive le opzioni per la migrazione della funzionalità delle `ROWID` pseudocolonne in Oracle Database a un database PostgreSQL in Amazon Relational Database Service (Amazon RDS) per PostgreSQL, Amazon Aurora PostgreSQL Compatible Edition o Amazon Elastic Compute Cloud (Amazon). EC2 In un database Oracle, la pseudocolonna è l'indirizzo fisico di una riga in una tabella. `ROWID` Questa pseudocolonna viene utilizzata per identificare in modo univoco una riga anche se la chiave primaria non è presente in una tabella. PostgreSQL ha una pseudocolonna simile `ctid` chiamata, ma non può essere usata come. `ROWID` Come spiegato nella documentazione di [PostgreSQL](https://www.postgresql.org/docs/current/ddl-system-columns.html)`ctid`, potrebbe cambiare se viene aggiornato o dopo ogni processo. `VACUUM` Esistono tre modi per creare la funzionalità `ROWID` pseudocolonna in PostgreSQL: + Usa una colonna chiave primaria invece di identificare una riga `ROWID` in una tabella. + Utilizzate una primary/unique chiave logica (che potrebbe essere una chiave composita) nella tabella.  + Aggiungi una colonna con valori generati automaticamente e rendila una primary/unique chiave da `ROWID` imitare. Questo modello illustra tutte e tre le implementazioni e descrive i vantaggi e gli svantaggi di ciascuna opzione. ## Prerequisiti e limitazioni **Prerequisiti** + Un account AWS attivo + Esperienza di codifica procedurale Language/PostgreSQL (PL/pgSQL) + Fonte Oracle Database + Un cluster compatibile con Amazon RDS per PostgreSQL o Aurora PostgreSQL o un'istanza per ospitare il database PostgreSQL EC2 **Limitazioni** + Questo modello fornisce `ROWID` soluzioni alternative per la funzionalità. PostgreSQL non fornisce un equivalente a in Oracle Database. `ROWID` **Versioni del prodotto** + PostgreSQL 11.9 o versione successiva ## Architecture **Stack tecnologico di origine** + database Oracle **Stack tecnologico Target** + Compatibile con Aurora PostgreSQL, Amazon RDS per PostgreSQL o un'istanza con un database PostgreSQL EC2 ![\[Conversione di un database Oracle in PostgreSQL su AWS\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/images/pattern-img/9a2ce994-4f68-4975-aab2-796cc20a3c82/images/6e7c2ef6-f440-476a-9003-f1f166718e15.png) **Opzioni di implementazione** Esistono tre opzioni per ovviare alla mancanza di `ROWID` supporto in PostgreSQL, a seconda che la tabella abbia una chiave primaria o un indice univoco, una chiave primaria logica o un attributo di identità. La scelta dipende dalle tempistiche del progetto, dalla fase di migrazione corrente e dalle dipendenze dall'applicazione e dal codice del database. | | | Opzione | Description | Vantaggi | Svantaggi | | --- |--- |--- |--- | | **Chiave primaria o indice univoco** | Se la tabella Oracle ha una chiave primaria, puoi utilizzare gli attributi di questa chiave per identificare in modo univoco una riga.  | Nessuna dipendenza dalle funzionalità proprietarie del database.Impatto minimo sulle prestazioni, poiché i campi chiave primari sono indicizzati. | Richiede modifiche al codice dell'applicazione e del database su cui si basa il passaggio `ROWID` ai campi della chiave primaria.  | | **Chiave logica primary/unique ** | Se la tabella Oracle ha una chiave primaria logica, è possibile utilizzare gli attributi di questa chiave per identificare in modo univoco una riga. Una chiave primaria logica è costituita da un attributo o da un insieme di attributi che possono identificare in modo univoco una riga, ma non viene applicata al database tramite un vincolo. | Nessuna dipendenza dalle funzionalità proprietarie del database. | Richiede modifiche al codice dell'applicazione e del database su cui si basa il passaggio `ROWID` ai campi chiave primari.Impatto significativo sulle prestazioni se gli attributi della chiave primaria logica non sono indicizzati. Tuttavia, è possibile aggiungere un indice univoco per evitare problemi di prestazioni. | | **Attributo di identità** | se la tua tabella Oracle non ha una chiave primaria, puoi creare un campo aggiuntivo come`GENERATED ALWAYS AS IDENTITY`. Questo attributo genera un valore univoco ogni volta che i dati vengono inseriti nella tabella, quindi può essere utilizzato per identificare in modo univoco una riga per le operazioni DML (Data Manipulation Language). | Nessuna dipendenza dalle funzionalità proprietarie del database.Il database PostgreSQL popola l'attributo e ne mantiene l'unicità. | Richiede modifiche al codice dell'applicazione e del database su `ROWID` cui si basa il passaggio all'attributo di identità.Impatto significativo sulle prestazioni se il campo aggiuntivo non è indicizzato. Tuttavia, puoi aggiungere un indice per evitare problemi di prestazioni. | ## Tools (Strumenti) + [Amazon Relational Database Service (Amazon RDS) per PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html) ti aiuta a configurare, gestire e scalare un database relazionale PostgreSQL nel cloud AWS. + [Amazon Aurora PostgreSQL Compatible Edition è un motore](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.AuroraPostgreSQL.html) di database relazionale completamente gestito e conforme ad ACID che ti aiuta a configurare, gestire e scalare le distribuzioni PostgreSQL. + [AWS Command Line Interface (AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html)) è uno strumento open source che ti aiuta a interagire con i servizi AWS tramite comandi nella tua shell a riga di comando. **In questo modello, puoi utilizzare l'AWS CLI per eseguire comandi SQL tramite pgAdmin.** + [pgAdmin](https://www.pgadmin.org/) è uno strumento di gestione open source per PostgreSQL. Fornisce un'interfaccia grafica che consente di creare, gestire e utilizzare oggetti di database. + [AWS Schema Conversion Tool (AWS SCT)](https://docs.aws.amazon.com/SchemaConversionTool/latest/userguide/CHAP_Welcome.html) supporta migrazioni di database eterogenei convertendo automaticamente lo schema del database di origine e la maggior parte del codice personalizzato in un formato compatibile con il database di destinazione. ## Epiche ### Identifica le tabelle di origine | Operazione | Description | Competenze richieste | | --- | --- | --- | | Identifica le tabelle Oracle che utilizzano l'`ROWID`attributo. | Utilizza AWS Schema Conversion Tool (AWS SCT) per identificare le tabelle Oracle con `ROWID` funzionalità. Per ulteriori informazioni, consulta la [documentazione di AWS SCT.](https://docs.aws.amazon.com/SchemaConversionTool/latest/userguide/CHAP_Source.Oracle.ToPostgreSQL.html#CHAP_Source.Oracle.ToPostgreSQL.ConvertRowID)oppureIn Oracle, usa la `DBA_TAB_COLUMNS` vista per identificare le tabelle che hanno un `ROWID` attributo. Questi campi possono essere utilizzati per memorizzare caratteri alfanumerici da 10 byte. Determina l'utilizzo e convertili in un `VARCHAR` campo, se necessario. | DBA o sviluppatore | | Identifica il codice che fa riferimento a queste tabelle. | Usa AWS SCT per generare un rapporto di valutazione della migrazione per identificare le procedure interessate da`ROWID`. Per ulteriori informazioni, consulta la [documentazione di AWS SCT.](https://docs.aws.amazon.com/SchemaConversionTool/latest/userguide/CHAP_AssessmentReport.html)oppureNel database Oracle di origine, utilizza il campo di testo della `dba_source` tabella per identificare gli oggetti che utilizzano `ROWID` funzionalità. | DBA o sviluppatore | ### Determina l'utilizzo della chiave primaria | Operazione | Description | Competenze richieste | | --- | --- | --- | | Identifica le tabelle che non dispongono di chiavi primarie. | Nel database Oracle di origine, utilizzare `DBA_CONSTRAINTS` per identificare le tabelle che non dispongono di chiavi primarie. Queste informazioni ti aiuteranno a determinare la strategia per ogni tabella. Esempio:
select dt.*
from dba_tables dt
where not exists (select 1
                  from all_constraints ct
                  where ct.owner = Dt.owner
                    and ct.table_name = Dt.table_name
                    and ct.constraint_type = 'P'
                  )
and dt.owner = '{schema}'
| DBA o sviluppatore | ### Identifica e applica la soluzione | Operazione | Description | Competenze richieste | | --- | --- | --- | | Applica le modifiche alle tabelle con una chiave primaria definita o logica. | Apportate le modifiche al codice dell'applicazione e del database mostrate nella sezione [Informazioni aggiuntive](#migrate-oracle-rowid-functionality-to-postgresql-on-aws-additional) per utilizzare una chiave primaria univoca o una chiave primaria logica per identificare una riga nella tabella. | DBA o sviluppatore | | Aggiungi un campo aggiuntivo alle tabelle che non hanno una chiave primaria definita o logica. | Aggiungi un attributo di tipo`GENERATED ALWAYS AS IDENTITY`. Apporta le modifiche al codice dell'applicazione e del database mostrate nella sezione [Informazioni aggiuntive](#migrate-oracle-rowid-functionality-to-postgresql-on-aws-additional). | DBA o sviluppatore | | Aggiungi un indice se necessario. | Aggiungi un indice al campo aggiuntivo o alla chiave logica primaria per migliorare le prestazioni SQL. | DBA o sviluppatore | ## Risorse correlate + [PostgreSQL CTID (documentazione PostgreSQL](https://www.postgresql.org/docs/current/ddl-system-columns.html)) + [Colonne generate](https://www.postgresql.org/docs/current/ddl-generated-columns.html) (documentazione PostgreSQL) + [Pseudocolonna ROWID](https://docs.oracle.com/en/database/oracle/oracle-database/19/sqlrf/ROWID-Pseudocolumn.html#GUID-F6E0FBD2-983C-495D-9856-5E113A17FAF1) (documentazione Oracle) ## Informazioni aggiuntive Le sezioni seguenti forniscono esempi di codice Oracle e PostgreSQL per illustrare i tre approcci. **Scenario 1: utilizzo di una chiave unica primaria** Negli esempi seguenti, si crea la tabella `testrowid_s1` con `emp_id` come chiave primaria. *Codice Oracle:* ``` create table testrowid_s1 (emp_id integer, name varchar2(10), CONSTRAINT testrowid_pk PRIMARY KEY (emp_id)); INSERT INTO testrowid_s1(emp_id,name) values (1,'empname1'); INSERT INTO testrowid_s1(emp_id,name) values (2,'empname2'); INSERT INTO testrowid_s1(emp_id,name) values (3,'empname3'); INSERT INTO testrowid_s1(emp_id,name) values (4,'empname4'); commit; SELECT rowid,emp_id,name FROM testrowid_s1; ROWID EMP_ID NAME ------------------ ---------- ---------- AAAF3pAAAAAAAMOAAA 1 empname1 AAAF3pAAAAAAAMOAAB 2 empname2 AAAF3pAAAAAAAMOAAC 3 empname3 AAAF3pAAAAAAAMOAAD 4 empname4 UPDATE testrowid_s1 SET name = 'Ramesh' WHERE rowid = 'AAAF3pAAAAAAAMOAAB' ; commit; SELECT rowid,emp_id,name FROM testrowid_s1; ROWID EMP_ID NAME ------------------ ---------- ---------- AAAF3pAAAAAAAMOAAA 1 empname1 AAAF3pAAAAAAAMOAAB 2 Ramesh AAAF3pAAAAAAAMOAAC 3 empname3 AAAF3pAAAAAAAMOAAD 4 empname4 ``` *Codice PostgreSQL:* ``` CREATE TABLE public.testrowid_s1 ( emp_id integer, name character varying, primary key (emp_id) ); insert into public.testrowid_s1 (emp_id,name) values (1,'empname1'),(2,'empname2'),(3,'empname3'),(4,'empname4'); select emp_id,name from testrowid_s1; emp_id | name --------+---------- 1 | empname1 2 | empname2 3 | empname3 4 | empname4 update testrowid_s1 set name = 'Ramesh' where emp_id = 2 ; select emp_id,name from testrowid_s1; emp_id | name --------+---------- 1 | empname1 3 | empname3 4 | empname4 2 | Ramesh ``` **Scenario 2: utilizzo di una chiave logica primaria** Negli esempi seguenti, si crea la tabella `testrowid_s2` con `emp_id` come chiave primaria logica. *Codice Oracle:* ``` create table testrowid_s2 (emp_id integer, name varchar2(10) ); INSERT INTO testrowid_s2(emp_id,name) values (1,'empname1'); INSERT INTO testrowid_s2(emp_id,name) values (2,'empname2'); INSERT INTO testrowid_s2(emp_id,name) values (3,'empname3'); INSERT INTO testrowid_s2(emp_id,name) values (4,'empname4'); commit; SELECT rowid,emp_id,name FROM testrowid_s2; ROWID EMP_ID NAME ------------------ ---------- ---------- AAAF3rAAAAAAAMeAAA 1 empname1 AAAF3rAAAAAAAMeAAB 2 empname2 AAAF3rAAAAAAAMeAAC 3 empname3 AAAF3rAAAAAAAMeAAD 4 empname4 UPDATE testrowid_s2 SET name = 'Ramesh' WHERE rowid = 'AAAF3rAAAAAAAMeAAB' ; commit; SELECT rowid,emp_id,name FROM testrowid_s2; ROWID EMP_ID NAME ------------------ ---------- ---------- AAAF3rAAAAAAAMeAAA 1 empname1 AAAF3rAAAAAAAMeAAB 2 Ramesh AAAF3rAAAAAAAMeAAC 3 empname3 AAAF3rAAAAAAAMeAAD 4 empname4 ``` *Codice PostgreSQL:* ``` CREATE TABLE public.testrowid_s2 ( emp_id integer, name character varying ); insert into public.testrowid_s2 (emp_id,name) values (1,'empname1'),(2,'empname2'),(3,'empname3'),(4,'empname4'); select emp_id,name from testrowid_s2; emp_id | name --------+---------- 1 | empname1 2 | empname2 3 | empname3 4 | empname4 update testrowid_s2 set name = 'Ramesh' where emp_id = 2 ; select emp_id,name from testrowid_s2; emp_id | name --------+---------- 1 | empname1 3 | empname3 4 | empname4 2 | Ramesh ``` **Scenario 3: utilizzo di un attributo di identità** Negli esempi seguenti, si crea la tabella `testrowid_s3` senza chiave primaria e utilizzando un attributo di identità. *Codice Oracle:* ``` create table testrowid_s3 (name varchar2(10)); INSERT INTO testrowid_s3(name) values ('empname1'); INSERT INTO testrowid_s3(name) values ('empname2'); INSERT INTO testrowid_s3(name) values ('empname3'); INSERT INTO testrowid_s3(name) values ('empname4'); commit; SELECT rowid,name FROM testrowid_s3; ROWID NAME ------------------ ---------- AAAF3sAAAAAAAMmAAA empname1 AAAF3sAAAAAAAMmAAB empname2 AAAF3sAAAAAAAMmAAC empname3 AAAF3sAAAAAAAMmAAD empname4 UPDATE testrowid_s3 SET name = 'Ramesh' WHERE rowid = 'AAAF3sAAAAAAAMmAAB' ; commit; SELECT rowid,name FROM testrowid_s3; ROWID NAME ------------------ ---------- AAAF3sAAAAAAAMmAAA empname1 AAAF3sAAAAAAAMmAAB Ramesh AAAF3sAAAAAAAMmAAC empname3 AAAF3sAAAAAAAMmAAD empname4 ``` *Codice PostgreSQL:* ``` CREATE TABLE public.testrowid_s3 ( rowid_seq bigint generated always as identity, name character varying ); insert into public.testrowid_s3 (name) values ('empname1'),('empname2'),('empname3'),('empname4'); select rowid_seq,name from testrowid_s3; rowid_seq | name -----------+---------- 1 | empname1 2 | empname2 3 | empname3 4 | empname4 update testrowid_s3 set name = 'Ramesh' where rowid_seq = 2 ; select rowid_seq,name from testrowid_s3; rowid_seq | name -----------+---------- 1 | empname1 3 | empname3 4 | empname4 2 | Ramesh ```