Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Este artigo resume as limitações conhecidas, objetos sem suporte e considerações para converter esquemas Oracle em Banco de Dados do Azure para PostgreSQL servidor flexível ou Azure HorizonDB em Visual Studio Code.
Objetos não suportados e parcialmente suportados
As seções a seguir descrevem objetos sem suporte, conversão parcial e considerações de runtime que precisam de revisão manual. O resultado de um objeto individual depende de sua definição de origem, dependências e pré-requisitos de destino.
Descoberta, extração, conversão e implantação descrevem diferentes estágios. Um objeto pode ser descoberto, mas excluído da extração ou extraído, mas não convertido. Examine os Resultados de Discovery para o escopo de origem, o relatório de conversão HTML e o Conversion Pesquisador de Objetos para resultados e notas de conversão e relatórios do Setup Experience para resultados da implantação.
O sistema Oracle e os esquemas internos não são extraídos ou convertidos. Isso inclui esquemas como SYS, , SYSTEM, XDB, MDSYS, e CTXSYSWMSYS.
Importante
Um resultado Convertido, por si só, não comprova o sucesso da compilação, uma implementação completa, a inclusão na implantação ou um comportamento equivalente em tempo de execução. A compilação verifica a sintaxe e a estrutura, não os dados ou o comportamento do aplicativo. Examine os objetos convertidos e não convertidos e valide o comportamento em tempo de execução durante o teste de dados e o teste de aceitação do usuário (UAT), antes do uso em produção.
Resolver problemas de conversão com GitHub Copilot
Selecione Corrigir para correções assistidas por Copilot e escolha entre os modelos mais recentes disponíveis no seletor de modelos do GitHub Copilot Chat. A disponibilidade do modelo depende do plano Copilot e das políticas organizacionais. Para obter mais informações, consulte Alterar o modelo de IA no GitHub Copilot Chat.
Use o motivo registrado para decidir o que fazer a seguir. Não suportado no Discovery, uma falha de extração e não convertido nos resultados da conversão descrevem condições diferentes.
Para um objeto disponível no Conversion Pesquisador de Objetos:
- Abra suas definições disponíveis e as notas de conversão. Identifique a fonte ausente, uma dependência ausente, um erro de compilação ou uma funcionalidade que precise de uma implementação diferente.
- Selecione Perguntar para abrir a assistência do Copilot e explicar a limitação e possíveis abordagens do PostgreSQL.
- Selecione Corrigir para edições assistidas por Copilot quando uma correção do PostgreSQL for apropriada. Analise as alterações no objeto e em suas dependências e inspecione os resultados da compilação. Os objetos dependentes corrigidos são resolvidos automaticamente após a compilação bem-sucedida.
- Se uma correção revisada e compilada com êxito ainda precisar de uma atualização de status, selecione Resolve. Ele altera o status registrado para Convertido; ele não abre Copilot Chat, não compila SQL nem o implanta.
- Selecione Atualizar para atualizar os relatórios de conversão. Mantenha as correções testadas nos artefatos de implantação e verifique Configurar escopo de implantação.
Para um objeto excluído da extração ou ausente do Pesquisador de Objetos de Conversão, examine os resultados de descoberta e extração e a origem Oracle disponível. Planeje a implementação manual, um serviço alternativo ou a exclusão do escopo de conversão. Não suponha que uma ação Fix no nível do objeto esteja disponível ou que Copilot possa recuperar a lógica de origem ausente.
A assistência do Copilot não expande a cobertura de conversão automática nem estabelece comportamento equivalente. Valide independentemente a implementação escolhida. Para obter um exemplo trabalhado, consulte Corrigir um objeto e atualizar seu relatório.
Saída do placeholder
Quando não conseguir converter totalmente um objeto, a ferramenta poderá emitir DDL de melhor esforço ou espaço reservado. Alguns objetos não têm uma definição utilizável do PostgreSQL.
Um marcador de posição não implementa a lógica de negócios original. Por exemplo, uma rotina gerada cujo corpo gera um erro ainda pode aparecer como Convertido. Verifique a definição gerada e quaisquer notas de conversão, em vez de se basear apenas no status.
Objetos que dependem de um espaço reservado podem exigir alterações manuais ou ser omitidos da implantação. Examine essas dependências no Conversion Pesquisador de Objetos antes da implantação.
Os casos que podem exigir preenchimento manual incluem:
- Transações autônomas. A conversão de rotinas que usam
PRAGMA AUTONOMOUS_TRANSACTIONpode depender dedblink. Extensões necessárias ausentes ou lógica de transação sem suporte podem impedir uma conversão completa. - Referências não resolvidas. Dependências ausentes ou não resolvidas podem impedir a conversão ou compilação completa.
- Instruções do controle de transação. Construções como
ROLLBACK TO SAVEPOINTnem sempre são convertidas de forma limpa. - PL/SQL encapsulado. O corpo de origem não está disponível para conversão. Para obter mais informações, consulte PL/SQL encapsulado.
Objetos programáveis
| Tipo de objeto | Limitação ou consideração | O que fazer |
|---|---|---|
| Package | O comportamento do estado do pacote requer validação independente. | Valide a inicialização e a persistência de estado do pacote entre chamadas, transações e sessões. |
| Rotina usando transações autônomas | O comportamento de transação autônoma requer validação independente. | Valide as extensões necessárias, a identidade de conexão separada e o contexto da sessão, a visibilidade dos dados, os commits, os rollbacks e o tratamento de erros. |
| Gatilho de banco de dados e de evento de sessão | A manipulação de eventos oracle pode exigir uma implementação de destino diferente. | Valide o evento de destino, o escopo e as permissões para a lógica de LOGON, LOGOFF, STARTUP, SHUTDOWN e SERVERERROR, e reimplemente a lógica para eventos sem suporte. |
| Corpo do tipo | Os corpos de tipo podem ser extraídos, mas a extração não garante uma implementação do PostgreSQL completa dos métodos. | Examine as definições geradas para métodos de tipo e as dependências. Implemente qualquer lógica ausente manualmente. |
| código-fonte Java, procedimento armazenado Java e classe Java | Não extraído. | Reescreva a lógica em PL/pgSQL ou mova-a para a camada do aplicativo. |
Biblioteca C externa (CREATE LIBRARY) |
Não extraído. | Reescreva a lógica em PL/pgSQL ou mova-a para a camada do aplicativo. |
| PL/SQL encapsulado | O corpo da mensagem não pode ser lido. A saída gerada pode conter placeholders em vez da implementação original. Para obter mais informações, consulte PL/SQL encapsulado. | Obtenha a fonte desencapsulada original antes de iniciar a conversão, ou implemente manualmente a lógica do PostgreSQL não encontrada. |
Para obter diretrizes mais amplas de teste de runtime, consulte Validação de objetos de código complexos.
PL/SQL encapsulado
A ferramenta não pode ler a implementação de unidades PL/SQL armazenadas em forma encapsulada (ofuscada) usando o utilitário Oracle wrap ou DBMS_DDL.WRAP. Ele pode usar metadados disponíveis para gerar um espaço reservado, como uma rotina que lança um erro quando chamada. Essa saída não reconstrói a lógica de negócios original.
Examine as unidades encapsuladas no Pesquisador de Objetos de Conversão, mesmo que seu status seja Convertido. Inspecione as definições, notas de conversão e dependências geradas para identificar implementações ausentes. Um espaço reservado não garante que objetos dependentes sejam convertidos nem implantados.
Obtenha a fonte desencapsulada original antes de iniciar a conversão. Se a conversão já tiver sido concluída, implemente e valide a lógica postgreSQL ausente manualmente. Não há suporte para executar novamente uma conversão concluída.
Dados e objetos de armazenamento
| Tipo de objeto | Limitação ou consideração | O que fazer |
|---|---|---|
Operador definido pelo usuário (CREATE OPERATOR) |
A conversão não é garantida e pode produzir saída com marcador de posição. | Revise o operador gerado e teste-o. |
| Índice (bitmap, junção de bitmap, particionado global ou de domínio) | Essas definições de índice Oracle não são extraídas para conversão automática. | Analise as dependências do aplicativo em relação a recursos específicos de índice, escolha os índices de destino apropriados e teste o comportamento e o desempenho das consultas. |
Log da visão materializada (MLOG$) |
Não extraído. | Defina e teste a estratégia de atualização da visão materializada de destino, incluindo cronogramas de atualização e requisitos de atualidade dos dados. |
| Tabela externa | Não extraído. | Carregue o arquivo em uma tabela com \copy ou COPY ... FROM STDIN no lado do cliente, com uma extensão de armazenamento compatível com o serviço de destino selecionado, ou por meio do aplicativo. |
| tabela de Enfileiramento Avançado (AQ) | Não extraído. O Oracle Advanced Queuing incorpora a lógica do aplicativo. | Reprojete-a com uma fila de aplicativos, uma extensão PostgreSQL ou um serviço de mensagens Azure. |
| Tabela blockchain | Não extraído. | Reimplemente o requisito de integridade na camada de aplicação. |
| Cluster e cluster de hash | Não extraído. | Recrie como uma tabela simples ou particionada. |
| Tabela temporária global | O comportamento de dados temporários requer validação independente. | Valide o tempo de vida de dados temporários, o isolamento da sessão e o comportamento da transação. |
Objeto de diretório (CREATE DIRECTORY) |
Não extraído. | Gerencie o acesso a arquivos na camada da aplicação. |
Tipo de índice definido pelo usuário (CREATE INDEXTYPE) |
Não extraído. | Recrie o método de acesso com um índice de extensão do PostgreSQL, quando houver um. |
| Link do banco de dados | Não é convertido automaticamente. | Configure postgres_fdw manualmente ou oracle_fdw, dependendo do banco de dados remoto. Consulte links de banco de dados. |
| Synonym | Alguns sinônimos, incluindo aqueles que fazem referência a pacotes, procedimentos ou sequências, podem não ser convertidos. | Examine os mapeamentos de destino e atualize o SQL dependente para fazer referência aos objetos PostgreSQL apropriados. |
Contexto do aplicativo (CREATE CONTEXT, DBMS_SESSION.SET_CONTEXT) |
Não extraído. | Use as configurações de sessão do PostgreSQL com current_setting() para estado de aplicativo não relacionado à segurança. Os contextos usados para autorização exigem uma implementação de controle de acesso projetada e validada separadamente; as configurações personalizadas comuns não preservam a restrição de definição por agente confiável da Oracle. Consulte objetos de segurança e identidade. |
| Exibição analítica, dimensão do atributo, hierarquia, dimensão OLAP, modelo de mineração de dados e mapa de zona materializado | Não extraído para conversão automática. | Reconstrua a saída necessária como views ou funções, ou exclua-a do escopo de conversão. |
Cláusula de armazenamento LOB, esquema XML registrado (DBMS_XMLSCHEMA.REGISTERSCHEMA) e índice associado ao esquema XML |
Não extraído. | Remodele o requisito de armazenamento ou validação no alvo. |
| plano do Resource Manager e grupo de consumidores, perfil SQL, linha de base do plano SQL, edição, perfil de Tradução SQL, política de gerenciamento do ciclo de vida da informação, perfil de bloqueio e objeto do gerenciador de espaços de trabalho | Não extraído. Eles são artefatos de instância, otimizador ou ciclo de vida Oracle que estão fora do escopo. | Recrie-os na camada de aplicativo ou infraestrutura ou exclua-os do escopo de conversão. |
Links de banco de dados
A ferramenta não converte automaticamente links de banco de dados Oracle. Selecione postgres_fdw um banco de dados PostgreSQL remoto ou oracle_fdw um banco de dados Oracle remoto e configure o acesso remoto manualmente. Ambas as extensões são compatíveis com o Banco de Dados do Azure para PostgreSQL flexible server e o Azure HorizonDB.
Configure manualmente a extensão, a conexão, as credenciais e as permissões selecionadas. Atualize o SQL dependente, incluindo referências @link em sinônimos e exibições, para usar os novos objetos de acesso remoto. Valide o acesso remoto e o comportamento da transação. Mantenha as credenciais reais fora do SQL compartilhado ou versionado.
Objetos de segurança e identidade
A ferramenta não dá suporte à conversão automatizada de objetos de segurança e identidade. Planeje e valide usuários, funções, privilégios e políticas de proteção de dados separadamente do DDL de esquema convertido. Use o inventário de origem do Oracle para identificar os controles de acesso necessários. As listagens de descoberta ou os metadados extraídos não estabelecem suporte à conversão ou confirmam que os controles de acesso estão configurados no destino.
| Tipo de objeto | Limitation | O que fazer |
|---|---|---|
| Usuário | Não há suporte para conversão automatizada. | Provisione separadamente logins no Azure. Recrie cada usuário como uma role do PostgreSQL e valide o acesso resultante antes do uso em produção. |
| Função | Não há suporte para conversão automatizada. | Recrie cada função no destino. |
| Privilégio de sistema | Não há suporte para conversão automatizada. | Mapeie o acesso necessário para privilégios do PostgreSQL e, em seguida, aplique as instruções GRANT indicadas. |
| Associação de Função | Não há suporte para conversão automatizada. | Recrie como instruções GRANT <role> TO <role>. |
| Privilégio de objeto e concessão | Os metadados de concessão de origem não configuram permissões de destino equivalentes. | Recrie os privilégios do inventário de origem e valide-os. |
Segurança em nível de linha e Banco de Dados Virtual Privado (DBMS_RLS) |
Não convertido. | Recrie as políticas como políticas de segurança em nível de linha do PostgreSQL. |
| Oracle Label Security | Não convertido. | Reprojete os limites de acesso aos dados no destino. |
Ocultação de dados (DBMS_REDACT) |
Não convertido. | Reaplicar o mascaramento no destino, na camada do aplicativo ou com um equivalente postgreSQL. |
Perfil, política de senha e política de auditoria unificada ou refinada (DBMS_FGA, AUDIT POLICY) |
Não há suporte para conversão automatizada. | Configure os parâmetros de servidor Azure equivalentes e a auditoria e gerencie-os como infraestrutura como código. |
Importante
A segurança no nível da linha não encontrada, Virtual Private Database, Oracle Label Security ou proteções contra edição de dados pode expor linhas ou valores filtrados ou mascarados pela Oracle. Implemente proteções equivalentes e verifique o acesso efetivo antes de rotear o tráfego de produção para o destino.
Objetos do agendador
Examine os resultados do job e do agendamento individualmente, em vez de tratar o inventário de descoberta como prova de conversão. O SQL do trabalho gerado não estabelece que o agendador de destino está configurado, o trabalho está habilitado ou o comportamento de orquestração do Oracle é preservado. Planeje o agendamento e a orquestração separadamente das rotinas que os trabalhos chamam.
| Tipo de objeto | Considerações sobre conversão | O que fazer |
|---|---|---|
DBMS_SCHEDULER trabalho e agendamento |
Examine a saída e as notas geradas para o trabalho e seu agendamento; a conversão de rotina por si só não configura a execução. | Configure um agendador compatível com o destino, como pg_cron quando disponível ou um agendador externo. Verifique o tempo, a identidade, os comandos e a ativação. |
Job herdado DBMS_JOB |
O ambiente de execução do trabalho e o comportamento de agendamento precisam de validação separada. | Examine a saída e recrie a lógica de agendamento ausente com um banco de dados compatível ou agendador de aplicativos compatível. |
| Programa, cadeia, credencial, observador de arquivos, classe de trabalho, grupo, janela e trabalho baseado em evento | Não há suporte para a conversão automatizada desses objetos de orquestração. | Reconstrua a orquestração necessária separadamente, por exemplo, em um agendador externo. |
Lacunas no nível do recurso
Os itens a seguir são recursos oracle em vez de tipos de objeto. Eles podem exigir alterações além da criação de DDL postgreSQL válida. Examine o inventário de origem, bem como as definições convertidas, pois as diferenças no nível do recurso podem não aparecer como objetos separados nos resultados da conversão.
| Característica | Limitação ou consideração | O que fazer |
|---|---|---|
| Tabela particionada híbrida (Oracle 19.3 e versões posteriores) | Converte como uma tabela comum e as partições externas são perdidas. | Identifique tabelas particionadas híbridas na origem e carregue os dados externos separadamente. |
| Exibição da edição e gatilho entre edições | Uma exibição do PostgreSQL ou uma definição de gatilho sozinha não estabelece um comportamento baseado em edição equivalente. | Valide a visibilidade do objeto e o comportamento do gatilho para a edição convertida durante a implantação do aplicativo. |
| Colunas de identidade, geradas e invisíveis | O comportamento da coluna requer validação independente. | Valide a geração de valor, os resultados da expressão e a visibilidade da coluna para o SQL do aplicativo. |
| Tabela imutável (Oracle 19.11 e posteriores) | O requisito de tabela imutável não é detectado ou recriado pelo conversor. | Projete e valide as restrições de gravação e exclusão necessárias separadamente. |
| Arquivo de Dados do Flashback | O histórico temporal não é modelado. | Use um padrão da tabela de histórico ou uma extensão temporal no destino. |
Consulta Flashback (AS OF TIMESTAMP, AS OF SCN) |
Não convertido. | Reescreva consultas que leem versões históricas de uma linha. |
| Oracle Sharding | O conversor não modela a estratégia de distribuição da origem. | Planeje a distribuição e o roteamento separadamente para a arquitetura de destino. |
BFILE e especificidades de LOB SecureFile |
O conteúdo do arquivo externo e o comportamento de armazenamento LOB exigem um planejamento de migração separado. | Analise as referências a arquivos externos e dependências de recursos LOB específicos do Oracle. Planeje e teste o padrão de acesso e armazenamento de destino pretendido. |
As tabelas temporárias privadas existem apenas no runtime, portanto, elas não aparecem no inventário de origem.
Limites operacionais
Tenha esses limites em mente ao planejar a conversão de esquema:
- A conversão de esquema não migra dados de linha. Planeje a migração de dados e a validação de dados separadamente da conversão de esquema.
- Conversões concluídas não podem ser executadas novamente. Examine e corrija as definições de PostgreSQL geradas por meio do Conversion Pesquisador de Objetos. Use Corrigir para correções de objeto e dependência ou compile edições manuais separadamente. Mantenha as correções testadas em
postgres_ddl. Resolve atualiza o status do objeto, e Refresh atualiza os relatórios; nenhuma ação executa novamente a conversão. Para uma execução incompleta, siga as diretrizes de falha de conversão.
Obter ajuda
Comece com o fluxo de trabalho de correção assistida e as práticas recomendadas. Se um problema permanecer, use o suporte à extensão PostgreSQL e inclua a versão da extensão, o estágio com falha e os diagnósticos com informações sensíveis ocultadas. Não inclua credenciais ou detalhes confidenciais do esquema.
Conteúdo relacionado
- O que é conversão de esquemas do Oracle para o PostgreSQL do Azure?
- Exibir o relatório de conversão HTML
- Examinar e editar objetos no Conversion Pesquisador de Objetos
- Implantar esquemas convertidos com a Experiência de Instalação
- Práticas recomendadas para conversão de esquemas do Oracle para o PostgreSQL do Azure