Configurar um banco de dados plugável do Oracle

O Datastream oferece suporte à arquitetura multilocatária da Oracle, em que um único banco de dados de contêiner (CDB) contém um ou mais bancos de dados plugáveis (PDBs). Cada banco de dados com plug-in é independente, tem um ID e um nome exclusivos e pode ser gerenciado de forma independente.

Para se conectar a um contêiner em uma configuração de arquitetura multiusuário ou alternar entre sessões de contêiner, use o seguinte comando:

ALTER SESSION SET CONTAINER = CONTAINER_NAME;

Substitua CONTAINER_NAME pelo nome do contêiner, por exemplo, o banco de dados plugável ou o contêiner CDB$ROOT.

É possível configurar o banco de dados plugável do Oracle para uso com os seguintes métodos de CDC:

• Leitor de registro binário (pré-lançamento)
• API LogMiner

Para mais informações sobre o leitor de registro binário e a API LogMiner, consulte Trabalhar com arquivos de registro "redo" do banco de dados Oracle.

Para instruções detalhadas sobre como configurar o banco de dados Oracle de origem para cada um desses métodos, consulte as seções a seguir.

Configurar o banco de dados plugável do Oracle para leitor de registro binário

Visualização

Esse recurso está sujeito aos "Termos de ofertas pré-GA" na seção "Termos de Serviço gerais" dos Termos específicos de serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Para configurar o banco de dados plugável do Oracle para uso com o método CDC do leitor de registros binários, siga estas etapas:

1. Selecione um dos métodos a seguir para acessar seus arquivos de registro:

   • Gerenciamento automático de armazenamento (ASM): se você selecionar essa opção, será necessário criar uma conexão ASM dedicada e fornecer os detalhes dela ao criar o perfil de conexão.
   • Diretórios de banco de dados: se você selecionar essa opção, será necessário criar objetos de diretório de banco de dados que apontem para os arquivos de registro de repetição e os arquivos de registro arquivados e conceder acesso READ aos diretórios ao usuário do banco de dados:

   CREATE DIRECTORY DIRECTORY_NAME_1 as 'ONLINE_REDO_LOGS_PATH';
   CREATE DIRECTORY DIRECTORY_NAME_2 as 'ARCHIVED_REDO_LOGS_PATH';
   GRANT READ ON DIRECTORY DIRECTORY_NAME_1 to USER_NAME;
   GRANT READ ON DIRECTORY DIRECTORY_NAME_2 to USER_NAME;

   Substitua:

   • DIRECTORY_NAME_1: o nome do diretório dos arquivos de registro de repetição on-line.
   • DIRECTORY_NAME_2: o nome do diretório dos arquivos de registro de repetição arquivados.
   • ONLINE_REDO_LOGS_PATH: o caminho para o diretório em que os arquivos de registro de repetição on-line serão armazenados.
   • ARCHIVED_REDO_LOGS_PATH: o caminho para o diretório em que os arquivos de registro arquivados serão armazenados.
   • USER_NAME: o nome do usuário do banco de dados a quem você quer conceder acesso READ.

   Se você selecionar o método de leitor de registro binário e usar diretórios de banco de dados, será necessário fornecer os nomes de diretório de registro de repetição e de registro arquivado ao criar o fluxo.

2. Verifique se seu banco de dados está sendo executado no modo ARCHIVELOG.

   Para fazer isso, faça login no seu banco de dados Oracle e execute o seguinte comando no prompt SQL:

   SELECT LOG_MODE FROM V$DATABASE;

   1. Se o resultado for ARCHIVELOG, avance para a próxima etapa.
   2. Se o resultado for NOARCHIVELOG, será necessário ativar o modo ARCHIVELOG para seu banco de dados.

   3. Execute os seguintes comandos quando conectado como SYSDBA:

      SHUTDOWN IMMEDIATE;
      STARTUP MOUNT;
      ALTER DATABASE ARCHIVELOG;
      ALTER DATABASE OPEN;

   4. Os arquivos de registro arquivados consomem espaço em disco. Portanto, configure o parâmetro DB_RECOVERY_FILE_DEST_SIZE para seu banco de dados. Use esse parâmetro para especificar (em bytes) o limite absoluto no espaço total a ser usado pelos arquivos de recuperação do banco de dados de destino. Ao definir esse parâmetro, é possível gerenciar a compensação entre proteger o banco de dados para que ele não fique sem espaço em disco e o fluxo falhe devido à perda da posição do registro.

3. Defina uma política de retenção de dados para seu banco de dados executando estes comandos do Oracle Recovery Manager (RMAN):

   TARGET /
   CONFIGURE RETENTION POLICY TO RECOVERY WINDOW OF 4 DAYS;

   Use o comando TARGET / para iniciar um cliente RMAN e se conectar ao banco de dados de origem. Consulte Como fazer conexões de banco de dados com o RMAN.

   Recomendamos que você mantenha backups e arquive registros por no mínimo quatro dias. Recomendamos sete dias.

   A execução desse comando reinicia a instância do banco de dados para que as alterações feitas no banco de dados entrem em vigor.

4. Volte para o prompt SQL da ferramenta de banco de dados que você está usando para configurar a política de rotação de arquivos de registros da Oracle. Recomendamos definir um tamanho máximo de 512 MB para o arquivo de registros.

5. Ative os dados de registro complementares. Para fazer isso, primeiro ative o registro complementar mínimo no nível do banco de dados executando o seguinte comando:

   ALTER DATABASE ADD SUPPLEMENTAL LOG DATA;

   Em seguida, escolha se você quer ativar a geração de registros para tabelas específicas ou para todo o banco de dados.

   Para registrar alterações apenas em tabelas específicas, execute o seguinte comando em cada tabela que você quer replicar:

   ALTER TABLE SCHEMA.TABLE ADD SUPPLEMENTAL LOG DATA (ALL) COLUMNS;

   Substitua:

   • SCHEMA: o nome do esquema que contém a tabela.
   • TABLE: o nome da tabela para a qual você quer registrar as alterações.

   Para replicar a maioria ou todas as tabelas do banco de dados, ative o registro para todo o banco de dados. Execute o comando a seguir para ativar os dados de registro complementares em todo o banco de dados:

   ALTER DATABASE ADD SUPPLEMENTAL LOG DATA (ALL) COLUMNS;

   O modo complementar de geração de registros precisa ser definido como ALL. Não é possível definir esse modo como PK_ONLY.

6. Conceda os privilégios adequados à conta de usuário que será usada para se conectar ao banco de dados com plug-in. Para isso, execute os seguintes comandos:

   GRANT SELECT ON GV_$LOG TO USER_NAME;
   GRANT SELECT ON GV_$LOGFILE TO USER_NAME;
   GRANT SELECT ON GV_$ARCHIVED_LOG TO USER_NAME;
   GRANT SELECT ON GV_$INSTANCE TO USER_NAME;
   GRANT SELECT ON GV_$STANDBY_LOG TO USER_NAME;
   GRANT SELECT ON V_$INSTANCE TO USER_NAME;
   GRANT SELECT ON V_$PDBS TO USER_NAME;
   GRANT SELECT ON V_$TRANSPORTABLE_PLATFORM TO USER_NAME;
   GRANT SELECT ON V_$DATABASE TO USER_NAME;
   GRANT SELECT ON COL$ TO USER_NAME;
   GRANT SELECT ON DBA_OBJECTS TO USER_NAME;
   GRANT SELECT ON DBA_TABLESPACES TO USER_NAME;
   GRANT SELECT ON DBA_ENCRYPTED_COLUMNS TO USER_NAME;
   GRANT SELECT ON DBA_EXTENTS TO USER_NAME;
   
   GRANT CONNECT TO USER_NAME;
   GRANT CREATE SESSION TO USER_NAME;
   GRANT SELECT ANY TABLE TO USER_NAME;
   GRANT READ ON DIRECTORY ONLINELOG_DIR TO USER_NAME;
   GRANT READ ON DIRECTORY ARCHIVELOG_DIR TO USER_NAME;

   Substitua USER_NAME pelo nome da conta de usuário que você pretende usar para se conectar ao banco de dados.

Configurar o banco de dados plugável do Oracle para o LogMiner

Para configurar um banco de dados plugável do Oracle auto-hospedado para que ele possa ser usado com a API LogMiner, siga estas etapas:

1. Verifique se seu banco de dados está sendo executado no modo ARCHIVELOG. Para fazer isso, execute o comando a seguir no contêiner CDB$ROOT:

   SELECT LOG_MODE FROM V$DATABASE;

   1. Se o resultado for ARCHIVELOG, avance para a etapa 2.
   2. Se o resultado for NOARCHIVELOG, será necessário ativar o modo ARCHIVELOG para seu banco de dados.

   3. Execute os seguintes comandos quando conectado como SYSDBA:

      SHUTDOWN IMMEDIATE;
      STARTUP MOUNT;
      ALTER DATABASE ARCHIVELOG;
      ALTER DATABASE OPEN;
      

   4. Os arquivos de registro arquivados consomem espaço em disco. Portanto, configure o parâmetro DB_RECOVERY_FILE_DEST_SIZE para seu banco de dados. Use esse parâmetro para especificar (em bytes) o limite absoluto no espaço total a ser usado pelos arquivos de recuperação do banco de dados de destino. Ao definir esse parâmetro, é possível gerenciar a compensação entre proteger o banco de dados contra a falta de espaço em disco e a falha do stream devido à perda da posição do registro.

2. Defina uma política de retenção de dados para seu banco de dados executando o comando do Oracle Recovery Manager (RMAN) abaixo no contêiner CDB$ROOT:

   CONFIGURE RETENTION POLICY TO RECOVERY WINDOW OF 4 DAYS;
   

   O comando define a política de retenção de dados para todos os bancos de dados com plug-ins no banco de dados do contêiner.

   Use o comando TARGET / para iniciar um cliente RMAN e se conectar ao contêiner CDB$ROOT do banco de dados de origem. Para mais informações, consulte Como fazer conexões de banco de dados com o RMAN.

   Recomendamos que você mantenha backups e arquive registros por no mínimo quatro dias. Recomendamos sete dias.

3. Volte para o prompt SQL da ferramenta de banco de dados que você está usando para configurar a política de rotação de arquivos de registros da Oracle. Recomendamos definir um tamanho máximo de 512 MB para o arquivo de registros.

4. Ative os dados de registro complementares. Para fazer isso, ative o registro complementar no banco de dados no nível do contêiner CDB$ROOT executando o seguinte comando:

   ALTER DATABASE ADD SUPPLEMENTAL LOG DATA;
   

   Em seguida, escolha se você quer ativar a geração de registros para tabelas específicas ou para todo o banco de dados.

   Para registrar alterações apenas em tabelas específicas, conecte-se ao contêiner de banco de dados com plug-in e execute o seguinte comando para cada tabela que você quer replicar:

   ALTER TABLE SCHEMA.TABLE ADD SUPPLEMENTAL LOG DATA (ALL) COLUMNS;
   

   Substitua:

   • SCHEMA: o nome do esquema que contém a tabela.
   • TABLE: o nome da tabela para a qual você quer registrar as alterações.

   Para replicar várias ou todas as tabelas do banco de dados, ative o registro para todo o banco de dados.

   Execute o comando a seguir para ativar os dados de registro complementares em todo o banco de dados:

   ALTER DATABASE ADD SUPPLEMENTAL LOG DATA (ALL) COLUMNS;
   

   O modo complementar de geração de registros precisa ser definido como ALL. Não é possível definir esse modo como PK_ONLY.

5. Crie um usuário comum. Um usuário comum tem a mesma identidade no contêiner CDB$ROOT e nos bancos de dados com plug-in. Um usuário comum pode se conectar e realizar operações no contêiner CDB$ROOT e em qualquer banco de dados conectável em que ele tenha privilégios. O nome de usuário comum precisa começar com C## ou c##.

6. Conceda os privilégios adequados ao usuário comum que será usado para se conectar ao seu banco de dados. São necessárias permissões diferentes nos níveis do contêiner CDB$ROOT e do banco de dados com plug-in.

   • Conecte-se ao contêiner CDB$ROOT e execute os seguintes comandos:

   GRANT CREATE SESSION TO USER_NAME;
   GRANT SET CONTAINER TO USER_NAME;
   GRANT SELECT ON SYS.V_$DATABASE TO USER_NAME;
   GRANT SELECT ON SYS.V_$LOGMNR_CONTENTS TO USER_NAME;
   GRANT EXECUTE ON DBMS_LOGMNR TO USER_NAME;
   GRANT EXECUTE ON DBMS_LOGMNR_D TO USER_NAME;
   GRANT LOGMINING TO USER_NAME;
   GRANT EXECUTE_CATALOG_ROLE TO USER_NAME;
   

   • Conecte-se ao banco de dados com plug-in e execute os seguintes comandos:

   GRANT CREATE SESSION TO USER_NAME;
   GRANT SET CONTAINER TO USER_NAME;
   GRANT SELECT ANY TABLE TO USER_NAME;
   GRANT SELECT ON SYS.V_$DATABASE TO USER_NAME;
   GRANT SELECT ON SYS.V_$ARCHIVED_LOG TO USER_NAME;
   GRANT SELECT ON DBA_SUPPLEMENTAL_LOGGING TO USER_NAME;
   

   Para cada comando, substitua USER_NAME pelo nome da conta de usuário comum. A execução desses comandos concederá privilégios para que o usuário leia no V$DATABASE, o que é necessário para a validação, inicie o gerenciador de registros e conceda privilégios para selecionar V$LOGMNR_CONTENT.

7. Conceda ao usuário comum SELECT acesso à visualização DBA_EXTENTS no seu banco de dados. Esse privilégio permite que você use o preenchimento automático baseado em ROWID para sua origem do Oracle:

   GRANT SELECT ON DBA_EXTENTS TO USER_NAME;

A seguir

• Saiba como o Datastream funciona com as fontes da Oracle.