Migrar Aplicativos de Bancos de Dados PostgreSQL para o Autonomous Database

Você pode traduzir instruções SQL gravadas em PostgreSQL para o Oracle SQL e executar as instruções traduzidas no Autonomous Database.

SET SERVEROUTPUT ON
   declare output_sql_result CLOB;
BEGIN
  DBMS_CLOUD_MIGRATION.MIGRATE_SQL(      
    original_sql => 'SELECT e.employee_id, e.last_name, e.salary FROM employees AS e;',
    output_sql   => output_sql_result,
    source_db    => 'POSTGRES');
    DBMS_OUTPUT.PUT_LINE (output_sql_result);
END;        
/

Output
–-------------------------------------------------------------
SELECT e.employee_id, e.last_name, e.salary FROM employees e;

SELECT DBMS_CLOUD_MIGRATION.MIGRATE_SQL(
     'CREATE TABLE IF NOT EXISTS cars (brand VARCHAR(255), model VARCHAR(255), year INT)',
     'POSTGRES') AS output FROM DUAL;

OUTPUT
------------------------------------------------------------------------------
create table cars (brand VARCHAR2(255), model VARCHAR2(255), year NUMBER(10);

Você pode traduzir e executar interativamente instruções PostgreSQL no seu Autonomous Database.

1. Estabeleça conexão com o seu Autonomous Database usando um cliente SQL.

   Consulte Estabelecer Conexão com o Autonomous Database para obter mais informações.

   Observação
   
   O DBMS_CLOUD_MIGRATION.ENABLE_TRANSLATION não é suportado no Database Actions e não é suportado com o Oracle APEX Service.
2. Execute DBMS_CLOUD_MIGRATION.ENABLE_TRANSLATION para ativar a tradução de SQL em tempo real em sua sessão.

   BEGIN
    DBMS_CLOUD_MIGRATION.ENABLE_TRANSLATION('POSTGRES');
   END;
   /

   Use a seguinte consulta para verificar a linguagem de tradução SQL da sua sessão:

   SELECT SYS_CONTEXT('USERENV','SQL_TRANSLATION_PROFILE_NAME') FROM DUAL;

   Consulte ENABLE_TRANSLATION Procedures para obter mais informações.

3. Informe instruções PostgreSQL. Por exemplo:

   CREATE TABLE movie (film_id int, title varchar(255));
   
   Table MOVIE created.

   Isso traduz e executa automaticamente a instrução PostgreSQL CREATE TABLE.

   Você pode verificar usando o comando DESC. Por exemplo:

   DESC movie;
   
   Name        Null?     Type          
   -------     -----     ------------- 
   FILM_ID               NUMBER(38)    
   TITLE                 VARCHAR2(255)

   A tabela MOVIE é criada e os tipos de dados de cada coluna são automaticamente convertidos em tipos de dados Oracle.

   Você poderá encontrar um erro durante a tradução se a instrução SQL de entrada não for suportada. Consulte Limitações para Migração e Tradução de Instruções PostgreSQL para o Oracle SQL para obter mais informações.

4. Insira dados na tabela MOVIE. Por exemplo:

   INSERT INTO movie (film_id, title) VALUES (123, 'Tangled');
   
   1 row inserted.
   
   INSERT INTO movie (film_id, title) VALUES (234, 'Frozen');
   
   1 row inserted.

   Verifique a inserção de dados consultando a tabela MOVIE. Por exemplo:

   SELECT * FROM movie;
   
   FILM_ID  TITLE
   –------- –--------
   123	 Tangled
   234	 Frozen
   

5. Crie uma tabela INVENTORY:

   CREATE TABLE inventory (film_id int, inventory_id int);
   
   Table INVENTORY created.

   Você pode verificar essa etapa com o comando DESC. Por exemplo:

   DESC inventory;
   
   Name        Null?     Type          
   -------     -----     ------------- 
   FILM_ID               NUMBER(38)    
   INVENTORY_ID          NUMBER(38)

   A tabela INVENTORY é criada e os tipos de dados de cada coluna são automaticamente convertidos em tipos de dados Oracle.
6. Insira dados na tabela INVENTORY. Por exemplo:

   INSERT INTO inventory(film_id, inventory_id) VALUES (123, 223);
   
   1 row inserted.
   
   INSERT INTO inventory(film_id, inventory_id) VALUES (234, 334);
   
   1 row inserted.

   Verifique a inserção de dados consultando INVENTORY. Por exemplo:

   SELECT * FROM inventory;
   
   FILM_ID  INVENTORY_ID
   –------- –------------
   123	 223
   234	 334

7. Execute uma junção externa esquerda nas tabelas MOVIE e INVENTORY:

   SELECT m.film_id, m.title, inventory.inventory_id 
       FROM movie AS m LEFT JOIN inventory 
       ON inventory.film_id = m.film_id;
   
     FILM_ID  TITLE       INVENTORY_ID
   ---------- ---------- ------------
          234 Frozen      334
          123 Tangled     223
   

   Este exemplo executa um LEFT OUTER JOIN nas tabelas movie e inventory. A palavra-chave AS para aliases de tabela na cláusula FROM não é suportada no Oracle SQL. A consulta é traduzida primeiro para o Oracle SQL e, em seguida, executada em sua sessão.

8. Use o procedimento DBMS_CLOUD_MIGRATION.DISABLE_TRANSLATION para desativar a tradução do idioma SQL em tempo real para sua sessão.

   BEGIN
    DBMS_CLOUD_MIGRATION.DISABLE_TRANSLATION;
   END;
   /

   Isso retornará um erro se a tradução do idioma SQL não estiver ativada para sua sessão.

   Consulte DISABLE_TRANSLATION Procedure

SELECT v.* 
    FROM v$mapped_sql v, dba_objects o
    WHERE v.sql_translation_profile_id = o.object_id
        AND o.object_name = 'POSTGRES'
        AND o.object_type = 'TRANSLATION PROFILE';

Você pode migrar um arquivo que contenha instruções PostgreSQL para um arquivo que contenha instruções Oracle SQL.

1. Conecte-se à sua instância do Autonomous Database.

   Consulte Estabelecer Conexão com o Autonomous Database para obter mais informações.

2. Configure o acesso ao Cloud Object Storage usando um controlador de recursos ou criando um objeto de credencial.

   Esta etapa fornece acesso ao Cloud Object Storage no qual você coloca os arquivos que está migrando:

   • Usar um controlador de recursos para acessar o Cloud Object Storage:

     Defina políticas e atribuições para acessar o Oracle Cloud Infrastructure Object Storage com um controlador de recursos. Consulte Usar o Controlador de Recursos para Acessar Recursos da Oracle Cloud Infrastructure e Usar o Controlador de Recursos com o DBMS_CLOUD para obter mais informações.

     Se seus arquivos residirem no Cloud Object Storage de outro fornecedor, defina as políticas e atribuições apropriadas para acessar o recurso. Consulte Configurar Políticas e Atribuições para Acessar Recursos para obter mais informações.

   • Crie uma credencial para acessar o Cloud Object Storage:

     Você pode criar uma credencial para acessar o Cloud Object Storage.

     Por exemplo:

     BEGIN
       DBMS_CLOUD.CREATE_CREDENTIAL (
         credential_name => 'OBJ_STORE_CRED',
         username        => 'user1@example.com',
         password        => 'password'
       );
     END;
     /
     

     Consulte CREATE_CREDENTIAL Procedures para obter mais informações.

3. Opcionalmente, você pode listar os arquivos no Object Storage. Por exemplo:

   VAR function_list CLOB;
   SELECT object_name FROM DBMS_CLOUD.LIST_OBJECTS
      (credential_name => 'OCI$RESOURCE_PRINCIPAL', location_uri => 'https://objectstorage.region.oraclecloud.com/n/namespace/b/bucket/o/files');
   
   OBJECT_NAME
   ---------------------
   postgrestest.sql
   

   Se preferir, se você criar uma credencial em vez do controlador de recursos, OCI$RESOURCE_PRINCIPAL, especifique o nome da credencial no parâmetro credential_name.

   Consulte Função LIST_OBJECTS para obter mais informações.

4. Execute DBMS_CLOUD_MIGRATION.MIGRATE_FILE para migrar o arquivo PostgreSQL para o Oracle SQL:

   BEGIN
    DBMS_CLOUD_MIGRATION.MIGRATE_FILE (
        credential_name => 'OCI$RESOURCE_PRINCIPAL',
        location_uri    => 'https://objectstorage.region.oraclecloud.com/n/namespace/b/bucket/o/files/postgrestest.sql',
        source_db       => 'POSTGRES'
       );
   END;
   /

   O parâmetro credential_name especifica a credencial para acessar o URI do Cloud Object Storage. O usuário que executa DBMS_CLOUD_MIGRATION.MIGRATE_FILE deve ter o privilégio EXECUTE para o objeto de credencial usado para acessar o URI do serviço Object Storage. Ou seja, a credencial que você especifica com o parâmetro credential_name. Se você usar uma credencial em vez de um controlador de recursos, especifique o nome da credencial no parâmetro credential_name.

   O parâmetro location_uri especifica o URI do arquivo de origem. O formato do URI depende do serviço do Cloud Object Storage que você estiver usando. Consulte DBMS_CLOUD Formatos de URI para obter mais informações.

   O parâmetro source_db especifica o PostgreSQL como idioma do banco de dados. Use o valor POSTGRES para traduzir arquivos PostgreSQL para o Oracle SQL.

   A execução desse comando traduz o arquivo PostgreSQL postgrestest.sql para o Oracle SQL e gera um novo arquivo com o nome original_filename_oracle.sql.

   Para este exemplo, a execução de DBMS_CLOUD_MIGRATION.MIGRATE_FILE com o arquivo de entrada postgrestest.sql gera postgrestest_oracle.sql. Após a etapa de tradução, o procedimento faz upload de postgrestest_oracle.sql para o Object Storage.

   Opcionalmente, use o parâmetro target_uri para especificar o local em que o arquivo traduzido será submetido a upload. O valor padrão desse parâmetro é NULL, o que significa que o arquivo traduzido é submetido a upload para o mesmo local especificado no parâmetro location_uri.

   Consulte MIGRATE_FILE Procedures para obter mais informações.

5. Verifique se o arquivo de saída foi gerado.

   SELECT object_name FROM DBMS_CLOUD.LIST_OBJECTS (
       credential_name => 'OCI$RESOURCE_PRINCIPAL', location_uri => 'https://objectstorage.region.oraclecloud.com/n/namespace/b/bucket/o/files');
   
   OBJECT_NAME
   ---------------------
   postgrestest.sql
   postgrestest_oracle.sql
   

   Se preferir, se você criar uma credencial em vez do controlador de recursos, OCI$RESOURCE_PRINCIPAL, especifique o nome da credencial no parâmetro credential_name.

   Consulte Função LIST_OBJECTS para obter mais informações.

SELECT UTL_RAW.CAST_TO_VARCHAR2 (DBMS_CLOUD.GET_OBJECT(
   credential_name => 'OCI$RESOURCE_PRINCIPAL', 
   object_uri => 'https://objectstorage.region.oraclecloud.com/n/namespace/b/bucket/o/files')) 
FROM dual;

UTL_RAW.CAST_TO_VARCHAR2(DBMS_CLOUD.GET_OBJECT(CREDENTIAL_NAME=>'CRED1',OBJECT_U
--------------------------------------------------------------------------------
SELECT f.film_id, f.title, inventory_id
FROM film f LEFT JOIN inventory
ON inventory.film_id = f.film_id;

Esta seção resume as limitações para migrar instruções SQL de PostgreSQL para o Oracle SQL.