Sobre os espaços de trabalho de conversão legados

Os espaços de trabalho de conversão legados são um tipo mais antigo e limitado de espaços de trabalho de conversão. Os espaços de trabalho de conversão legados não são compatíveis com os recursos de conversão aprimorados com o Gemini nem com o editor interativo de SQL. Você só pode usá-los para converter o esquema de origem com a ferramenta de migração Ora2Pg.

Importante: o Database Migration Service é compatível com as versões 21.1 a 23.2 do Ora2Pg.

Não recomendamos usar o tipo legado de espaços de trabalho de conversão para suas migrações, porque eles apresentam várias outras limitações no fluxo de trabalho de conversão:

Tabela 1: comparação de recursos do espaço de trabalho de conversão

Espaço de trabalho de conversão interativo	Espaço de trabalho de conversão legado
A conversão de esquema e objeto de código acontece no Database Migration Service.	Você realiza conversões de esquema e objeto de código fora do Database Migration Service usando a ferramenta de migração Ora2Pg.
É possível aplicar fontes convertidas diretamente ao banco de dados de destino no Database Migration Service.	Você é responsável por aplicar o esquema convertido ao banco de dados de destino no cluster de destino do AlloyDB para PostgreSQL.
Teste o esquema e o código do rascunho diretamente no Database Migration Service para garantir que eles possam ser aplicados ao cluster de destino com sucesso.	Não é possível testar o esquema e o código de rascunho sem afetar o cluster de destino.
Adiciona automaticamente as colunas rowid ausentes para tabelas que não têm chaves primárias e restrições exclusivas.	Adicione as chaves primárias ausentes às tabelas de destino depois de aplicar o esquema.

Usar espaços de trabalho de conversão legados

Se o seu cenário exigir o uso de espaços de trabalho de conversão legados, modifique o processo de migração com as seguintes ações:

1. Crie um arquivo de configuração do Ora2Pg.

   Consulte a documentação do Ora2Pg para saber como usar a ferramenta de conversão do Ora2Pg. Expanda as seções a seguir para conferir a lista completa de diretivas compatíveis com o Database Migration Service.

   Configuração do Ora2Pg compatível com o Database Migration Service

   O Database Migration Service usa a seguinte configuração para arquivos do Ora2Pg:

   • BOOLEAN_VALUES
   • DATA_TYPE
   • DEFAULT_NUMERIC
   • ENABLE_MICROSECOND
   • EXPORT_SCHEMA
   • MODIFY_STRUCT
   • MODIFY_TYPE
   • PG_INTEGER_TYPE
   • PG_NUMERIC_TYPE
   • PG_SCHEMA
   • PRESERVE_CASE
   • REPLACE_AS_BOOLEAN
   • REPLACE_COLS
   • REPLACE_TABLES
   • REPLACE_ZERO_DATE
   • SCHEMA

   O Database Migration Service usa perfis de conexão para definir detalhes de conectividade. Assim, não é necessário definir as seguintes informações no arquivo de configuração do Or2Pg:

   • ORACLE_DSN
   • ORACLE_HOME
   • ORACLE_PWD
   • ORACLE_USER
   • PG_DSN
   • PG_PWD
   • PG_USER

   Além disso, o Database Migration Service não usa a diretiva de configuração WHERE para limitar os registros a serem migrados.

2. Crie um espaço de trabalho de conversão legado e converta o esquema.

3. Aplique manualmente o esquema convertido ao banco de dados de destino.

   Depois de criar a configuração do Ora2Pg e o espaço de trabalho, aplique o código gerado por conta própria diretamente no banco de dados de destino.

   Importante:com os espaços de trabalho de conversão legados, não é possível testar o esquema antes da migração. Se você encontrar problemas ao aplicar o esquema convertido, limpe o esquema com falha do banco de dados de destino, ajuste o arquivo Ora2Pg e recrie o espaço de trabalho de conversão legado com o arquivo Ora2Pg.

4. Migre tabelas sem chaves primárias.

   O Database Migration Service migra apenas tabelas com chaves primárias. Se o banco de dados de origem incluir tabelas sem chaves primárias, será necessário criar manualmente chaves primárias ou restrições exclusivas nas tabelas convertidas no banco de dados de destino depois de aplicar o esquema convertido. Abra a seção a seguir para mais detalhes.

   Adicione chaves primárias ou restrições exclusivas no banco de dados de destino

   Para migrar tabelas do Oracle sem chaves primárias, faça o seguinte:

   1. Conecte-se ao cluster do AlloyDB para PostgreSQL com o cliente psql.
   2. Crie as restrições de chave primária ausentes para suas tabelas. Para mais informações sobre chaves primárias, consulte Chaves primárias na documentação do PostgreSQL.

      Você também pode expandir as seções a seguir para ver exemplos de comandos SQL:

      Criar chaves primárias usando colunas atuais

      Sua tabela já pode ter uma chave primária lógica com base em uma coluna ou uma combinação de colunas. Por exemplo, pode haver colunas com uma restrição ou um índice exclusivo configurado. Use essas colunas para gerar uma nova chave primária para tabelas no banco de dados de origem. Exemplo:

      ALTER TABLE TABLE_NAME
      ADD PRIMARY KEY (COLUMN_NAME);

      Criar uma chave primária usando todas as colunas

      Se você não tiver uma restrição preexistente que possa servir como uma chave primária, crie chaves primárias usando todas as colunas da tabela. Verifique se você não excedeu o comprimento máximo da chave primária permitido pelo cluster do PostgreSQL. Exemplo:

      ALTER TABLE TABLE_NAME
      ADD PRIMARY KEY (COLUMN_NAME_1, COLUMN_NAME_2, COLUMN_NAME_3, ...);

      Ao criar uma chave primária composta como essa, é necessário listar explicitamente todos os nomes de coluna que você quer usar. Não é possível usar uma instrução para recuperar todos os nomes de coluna para essa finalidade.

      Criar uma restrição exclusiva com a pseudocoluna ROWID

      Os bancos de dados Oracle usam a pseudocoluna ROWID para armazenar o local de cada linha em uma tabela. Para migrar tabelas do Oracle que não têm chaves primárias, adicione uma coluna ROWID no banco de dados PostgreSQL de destino. O Database Migration Service preenche a coluna com os valores numéricos correspondentes da pseudocoluna ROWID do Oracle de origem.

      Para adicionar a coluna e defini-la como chave primária, execute o seguinte comando:

      ALTER TABLE TABLE_NAME ADD COLUMN rowid numeric(33,0) NOT NULL;
      CREATE SEQUENCE TABLE_NAME_rowid_seq INCREMENT BY -1 START WITH -1 OWNED BY TABLE_NAME.rowid;
      ALTER TABLE TABLE_NAME ALTER COLUMN rowid SET DEFAULT nextval('TABLE_NAME_rowid_seq');
      ALTER TABLE TABLE_NAME ADD CONSTRAINT CONSTRAINT_DISPLAY_NAME PRIMARY KEY (rowid);

A seguir

Depois de realizar o fluxo de trabalho de conversão com o espaço de trabalho legado, siga os procedimentos padrão de migração. Consulte Criar um job de migração.