Testar Cargas de Trabalho com o Oracle Real Application Testing

Quando você inicia a captura da carga de trabalho em um sistema de produção, todas as solicitações de clientes externos direcionadas ao Oracle Database são rastreadas e armazenadas em arquivos binários chamados arquivos de captura.

Uma captura de carga de trabalho resulta na criação de dois subdiretórios, cap e capfiles, que contêm os arquivos de captura. Os arquivos de captura fornecem todas as informações pertinentes sobre a solicitação do cliente, incluindo detalhes da transação, valores de vínculo e texto SQL. Esses arquivos de captura são independentes de plataforma e podem ser transportados para outro sistema.

Execute DBMS_CLOUD_ADMIN.START_WORKLOAD_CAPTURE para iniciar a captura de carga de trabalho em uma instância do Autonomous Database.

Consulte Clonar, Mover ou Fazer Upgrade de uma Instância do Autonomous Database para obter mais informações.

Para iniciar uma captura de carga de trabalho na sua instância do Autonomous Database, você deve estar conectado como usuário ADMIN ou ter o privilégio EXECUTE em DBMS_CLOUD_ADMIN.

Exemplo para iniciar uma captura de carga de trabalho:

BEGIN 
   DBMS_CLOUD_ADMIN.START_WORKLOAD_CAPTURE(
        capture_name => 'test',
        duration     => 60);
   END;
/

Isso inicia a captura da carga de trabalho na sua instância do Autonomous Database.

Os parâmetros são:

• capture_name: é o nome da captura da carga de trabalho.

• duration: é a duração (em minutos) da qual você precisa capturar a carga de trabalho. Esse parâmetro é opcional.

Consulte START_WORKLOAD_CAPTURE Procedures para obter mais informações.

Eventos de Captura de Carga de Trabalho

Você pode se inscrever no evento de Informações com.oraclecloud.databaseservice.autonomous.database.information para ser notificado no início do START_WORKLOAD_CAPTURE. Consulte (Opcional) Inscrever-se em Eventos de Informações a Serem Notificados sobre Detalhes de Captura e Repetição para obter mais informações.

Visualizações de Captura e Repetição da carga de trabalho

Você pode encontrar informações sobre captura e repetição de carga de trabalho nas exibições DBA_CAPTURE_REPLAY_STATUS e DBA_CAPTURE_REPLAY_HISTORY. Consulte DBA_CAPTURE_REPLAY_STATUS View e DBA_CAPTURE_REPLAY_HISTORY View para obter mais informações.

Para cancelar uma captura de carga de trabalho, você deve estar conectado como usuário ADMIN ou ter o privilégio EXECUTE em DBMS_CLOUD_ADMIN.

Exemplo:

BEGIN
    DBMS_CLOUD_ADMIN.CANCEL_WORKLOAD_CAPTURE;
END;
/

Isso cancela a captura da carga de trabalho atual e executa uma atualização no clone atualizável.

Você pode consultar a exibição DBA_CAPTURE_REPLAY_STATUS para verificar o status da carga de trabalho de cancelamento.

Consulte DBA_CAPTURE_REPLAY_STATUS View para obter mais informações.

Consulte CANCEL_WORKLOAD_CAPTURE Procedures para obter mais informações.

Exemplo para finalizar uma captura de carga de trabalho em sua instância do Autonomous Database:

BEGIN
    DBMS_CLOUD_ADMIN.FINISH_WORKLOAD_CAPTURE;
END;
/

Para executar este procedimento, você deve estar conectado como usuário ADMIN ou ter o privilégio EXECUTE em DBMS_CLOUD_ADMIN. Quando você executa este procedimento, um arquivo de captura de carga de trabalho é carregado no Object Store como um arquivo zip.

Consulte FINISH_WORKLOAD_CAPTURE Procedures para obter mais informações.

Eventos de Captura de Carga de Trabalho

Você pode se inscrever no evento de Informações com.oraclecloud.databaseservice.autonomous.database.information para ser notificado sobre uma captura de carga de trabalho, que inclui:

• A conclusão de FINISH_WORKLOAD_CAPTURE.

• O campo captureDownloadURL que contém o URL da PAR para acessar a captura e os relatórios no Object Store. A captura e os relatórios são válidos por sete (7) dias a partir da data em que o URL da PAR é gerado.

Consulte (Opcional) Inscrever-se em Eventos de Informações a Serem Notificados sobre Detalhes de Captura e Repetição para obter mais informações.

Visualizações de Captura e Repetição da carga de trabalho

Você pode consultar a exibição DBA_CAPTURE_REPLAY_STATUS para verificar o status de uma captura de carga de trabalho concluída. Consulte DBA_CAPTURE_REPLAY_STATUS View para obter mais informações.

Você pode encontrar informações sobre captura e repetição da carga de trabalho na exibição DBA_CAPTURE_REPLAY_HISTORY. Consulte DBA_CAPTURE_REPLAY_HISTORY View para obter mais informações.

Você pode consultar as colunas ID, NAME, START_TIME e END_TIME da exibição DBA_WORKLOAD_CAPTURES para recuperar os detalhes da captura da carga de trabalho. Consulte DBA_WORKLOAD_CAPTURES para obter mais informações.

Você tem duas opções para preparar um clone atualizável para reproduzir uma captura de carga de trabalho. Você pode executar o DBMS_CLOUD_ADMIN.PREPARE_REPLAY para preparar automaticamente um clone atualizável para uma repetição de carga de trabalho. Este procedimento atualiza o clone atualizável para o horário inicial da captura e desconecta o clone atualizável. Você também tem a opção de preparar manualmente um clone atualizável para reproduzir uma captura de carga de trabalho.

Preparar Automaticamente um Clone Atualizável para Repetição da Carga de Trabalho

Exemplo para preparar automaticamente um clone atualizável para uma repetição de carga de trabalho:

BEGIN
 DBMS_CLOUD_ADMIN.PREPARE_REPLAY (
    capture_name    'test'
END;
/

Para executar este procedimento, você deve estar conectado como usuário ADMIN ou ter o privilégio EXECUTE em DBMS_CLOUD_ADMIN.

DBMS_CLOUD_ADMIN.PREPARE_REPLAY faz o seguinte:

• Atualiza o clone atualizável para o timestamp inicial da captura.

• Desconecta o clone atualizável.

Opcionalmente, neste ponto, antes de reproduzir uma captura, você pode fazer alterações em um clone atualizável. Por exemplo, alterando valores de parâmetro e ativando/desativando determinados recursos para ver o impacto na repetição.

Preparar Manualmente um Clone Atualizável para Repetição da Carga de Trabalho

Essas etapas de clone atualizável manual não são necessárias quando você prepara automaticamente um clone atualizável executando o DBMS_CLOUD_ADMIN.PREPARE_REPLAY.

Execute as seguintes etapas para se preparar manualmente para uma repetição de carga de trabalho:

1. Localize o timestamp inicial da captura consultando a view DBA_WORKLOAD_CAPTURES. Consulte DBA_WORKLOAD_CAPTURES para obter mais informações.

2. Atualize o clone atualizável para o timestamp inicial da captura. Consulte Atualizar um Clone Atualizável no Autonomous Database para obter mais informações.

3. Desconecte manualmente o clone atualizável. Consulte Desconectar um Clone Atualizável do Banco de Dados de Origem para obter mais informações.

4. Opcionalmente, antes de reproduzir uma captura, você pode fazer alterações no clone atualizável. Por exemplo, alterando valores de parâmetro, ativando/desativando determinados recursos para ver o impacto na repetição.

Execute o procedimento DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD para iniciar a repetição da carga de trabalho no seu banco de dados. Você deve estar conectado como usuário ADMIN ou ter o privilégio EXECUTE em DBMS_CLOUD_ADMIN para executar DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD.

Você pode reproduzir uma carga de trabalho capturada em um clone atualizável ou em um clone completo da instância do Autonomous Database da qual a carga de trabalho foi capturada. Os destinos de captura e repetição devem estar em um estado lógico consistente.

Repetir Carga de Trabalho em um Clone Atualizável

O exemplo a seguir faz download dos arquivos de captura do Object Storage, repete a carga de trabalho capturada e faz upload de um relatório de repetição para o Object Storage.

BEGIN 
  DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD(
      capture_name => 'CAP_TEST1');
END;
/

O parâmetro CAPTURE_NAME especifica o nome da captura da carga de trabalho. Este parâmetro é obrigatório.

Repetir Carga de Trabalho em um Clone Completo

Este exemplo a seguir faz download de arquivos de captura do Object Storage, repete a carga de trabalho capturada no clone e faz upload de um relatório de repetição para o Object Storage.

BEGIN 
  DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD(
       capture_name                => 'CAP_TEST1',        
       capture_source_tenancy_ocid => 'OCID1.TENANCY.REGION1..ID1',         
       capture_source_db_name      => 'ADWFINANCE');
END;
/

O parâmetro CAPTURE_NAME especifica o nome da captura da carga de trabalho. Este parâmetro é obrigatório.

O parâmetro CAPTURE_SOURCE_TENANCY_OCID especifica o OCID da tenancy de origem da captura da carga de trabalho. Esse parâmetro é obrigatório ao executar a captura da carga de trabalho em um clone completo.

O parâmetro CAPTURE_SOURCE_DB_NAME especifica o nome do banco de dados de origem da captura da carga de trabalho. Esse parâmetro é obrigatório ao executar a captura da carga de trabalho em um clone completo.

Consulte REPLAY_WORKLOAD Procedures para obter mais informações.

Eventos de Repetição da Carga de Trabalho

Inscreva-se no evento Information com.oraclecloud.databaseservice.autonomous.database.information para ser notificado sobre os seguintes

• O início e a conclusão de um REPLAY_WORKLOAD.

• O link Armazenamento de Objetos para fazer download de relatórios de repetição. O evento fornece um URL da PAR para acessar os relatórios no campo replayDownloadURL. Os relatórios são válidos por 7 (sete) dias a partir da data em que o URL da PAR é gerado.

Consulte Eventos de Informações no Autonomous Database para obter mais informações.

Visualizações de Captura e Repetição da carga de trabalho

Você pode consultar a exibição DBA_CAPTURE_REPLAY_STATUS para verificar o status de repetição da carga de trabalho.

Consulte DBA_CAPTURE_REPLAY_STATUS View para obter mais informações.

Você pode encontrar informações sobre captura e repetição da carga de trabalho na exibição DBA_CAPTURE_REPLAY_HISTORY. Consulte DBA_CAPTURE_REPLAY_HISTORY View para obter mais informações.

Essa opção Capture-Replay é especialmente útil quando você deseja testar suas cargas de trabalho em execução no Oracle Database 19c antes de fazer upgrade para o Oracle Database 23ai.

Siga estas etapas para reproduzir suas cargas de trabalho em outra versão do banco de dados:

1. (Opcional) Inscrever-se em Eventos de Informações a Serem Notificados sobre Detalhes de Captura e Repetição

2. Capture suas cargas de trabalho em um Autonomous Database com o Oracle Database 19c. Consulte Capturar uma Carga de Trabalho em uma Instância do Autonomous Database para obter mais informações.

3. Execute DBMS_CLOUD_ADMIN.FINISH_WORKLOAD_CAPTURE para concluir a captura da carga de trabalho na sua instância do Banco de Dados 19c sourceAutonomous do Oracle Database.

4. Prepare seu Clone Atualizável do Oracle Database 23ai de destino. Consulte Preparar um Clone Atualizável para Repetição da Carga de Trabalho para obter mais informações.

5. Depois de concluir a captura da carga de trabalho e preparar o Clone Atualizável de destino do Oracle Database 23ai, repita a carga de trabalho no destino. Consulte Repetir uma Carga de Trabalho em uma Instância do Autonomous Database para obter mais informações.

Quando você inicia a captura da carga de trabalho no sistema de produção, todas as solicitações de clientes externos direcionadas ao Oracle Database são rastreadas e armazenadas em arquivos binários chamados arquivos de captura.

Uma captura de carga de trabalho resulta na criação de dois subdiretórios, cap e capfiles, que contêm os arquivos de captura.

Os arquivos de captura fornecem todas as informações pertinentes sobre a solicitação do cliente, incluindo detalhes da transação, valores de vínculo e texto SQL.

Esses arquivos de captura são independentes de plataforma e podem ser transportados para outro sistema.

Consulte Captura de Carga de Trabalho para capturar uma carga de trabalho em um banco de dados local.

Execute DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD para iniciar a repetição da carga de trabalho no seu banco de dados. Você deve estar conectado como usuário ADMIN ou ter o privilégio EXECUTE no DBMS_CLOUD_ADMIN para executar o REPLAY_WORKLOAD.

Exemplo para reproduzir em uma instância do Autonomous Database uma carga de trabalho capturada de um banco de dados local:

BEGIN 
   DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD(
      location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o',
      credential_name => 'CRED_TEST',   
      synchronization => TRUE,
      process_capture => TRUE);    
END;
/

Isso faz download dos arquivos de captura contidos no local do Object Storage especificado no parâmetro location_uri e repete a captura da carga de trabalho dos arquivos de captura. A repetição gera e faz upload da repetição e os relatórios do Repositório Automático de Carga de Trabalho para o local do Object Storage especificado no parâmetro location_uri.

Neste exemplo, namespace-string é o namespace do Oracle Cloud Infrastructure Object Storage e bucketname é o nome do bucket. Consulte Noções Básicas de Namespaces do serviço Object Storage para obter mais informações.

Consulte Fazer Upload de Arquivos para o Bucket do Oracle Cloud Infrastructure Object Store para obter mais informações sobre o upload de arquivos para o Armazenamento de Objetos.

Consulte Navegar até o Oracle Cloud Infrastructure Object Storage e Criar um Bucket para obter mais informações sobre o serviço Object Storage.

O parâmetro credential_name especifica a credencial para acessar o bucket de armazenamento de objetos. A credencial fornecida deve ter os privilégios de gravação para gravar no bucket do Object Storage. Os privilégios de gravação são necessários para fazer upload do relatório de repetição para o bucket.

Se você não especificar um valor credential_name, DEFAULT_CREDENTIAL será usado.

Não será necessário criar uma credencial para acessar o Oracle Cloud Infrastructure Object Store se você ativar credenciais do controlador de recursos. Consulte Usar o Controlador de Recursos para Acessar Recursos da Oracle Cloud Infrastructure para obter mais informações.

O parâmetro synchronization especifica o método de sincronização usado durante a repetição da carga de trabalho. Um valor TRUE indica que a sincronização é baseada em SCN.

O process_capture especifica se você precisa especificar o valor process_capture ou não. Um valor TRUE indica que a repetição inclui process_capture.

Consulte REPLAY_WORKLOAD Procedures para obter mais informações.

Eventos de Repetição da Carga de Trabalho

Você pode se inscrever no evento Information com.oraclecloud.databaseservice.autonomous.database.information para ser notificado sobre os eventos WorkloadReplayBegin e WorkloadReplayEnd. Estes eventos fornecem informações sobre:

• Início e conclusão do REPLAY_WORKLOAD.

• O campo replayDownloadURL que contém o URL da PAR para acessar os relatórios no Object Store. O URL da PAR é válido por 7 dias a partir da data de geração.

Consulte Eventos de Informações no Autonomous Database para obter mais informações.

Visualizações de Captura e Repetição da carga de trabalho

Você pode consultar as views DBA_CAPTURE_REPLAY_STATUS e DBA_CAPTURE_REPLAY_HISTORY para verificar o status de repetição da carga de trabalho.

Consulte DBA_CAPTURE_REPLAY_STATUS View e DBA_CAPTURE_REPLAY_HISTORY View para obter mais informações.

O Autonomous Database permite provisionar uma instância ou criar um clone atualizável com a opção de nível de patch Anterior. Em instâncias executadas no nível de patch Inicial, o Autonomous Database aplica os próximos patches de manutenção uma semana antes de os patches serem aplicados a bancos de dados de produção (bancos de dados provisionados no nível de patch Regular). Usando o recurso WORKLOAD_AUTO_REPLAY, você pode garantir que um próximo patch seja testado em relação à sua carga de trabalho antes que o patch entre em produção. Isso permite verificar se o patch corrige um problema conhecido ou não introduz um problema que afeta sua carga de trabalho.

Para encontrar informações sobre capturas e reapresentações, assine eventos de Informações. Os eventos de informações fornecem notificação para eventos de captura e resposta da carga de trabalho e incluem um URL de PAR no qual você pode fazer download do arquivo de captura e do relatório de repetição. Consulte (Opcional) Inscrever-se em Eventos de Informações a Serem Notificados sobre Detalhes de Captura e Repetição para obter mais informações.

Quando o WORKLOAD_AUTO_REPLAY está ativado, o banco de dados de origem captura uma carga de trabalho executando por um número especificado de minutos. Por padrão, a captura da carga de trabalho começa quando você ativa WORKLOAD_AUTO_REPLAY (opcionalmente, você pode usar parâmetros para definir o dia e a hora de início da captura). Em seguida, o Autonomous Database verifica o banco de dados de destino para verificar o status da aplicação de patch. Após a aplicação do próximo patch semanal, o Autonomous Database repete a carga de trabalho no banco de dados de destino. Esse ciclo de repetição de captura continua automaticamente a cada semana com o Autonomous Database capturando a carga de trabalho no banco de dados de origem, aguardando a aplicação do próximo patch e repetindo a carga de trabalho no clone atualizável.

Observe as seguintes opções para ativar WORKLOAD_AUTO_REPLAY:

• O banco de dados de origem deve usar o nível de patch Regular.

• O banco de dados de destino deve usar o nível de patch Inicial.

• O banco de dados de destino deve ser um clone atualizável do banco de dados de origem e deve ser criado antes de você ativar o WORKLOAD_AUTO_REPLAY.

• Um banco de dados de origem pode ativar WORKLOAD_AUTO_REPLAY para não mais de um clone atualizável (você pode ativar esse recurso para um máximo de um clone atualizável, mesmo que você crie vários clones atualizáveis do mesmo banco de dados de origem).

• Depois que você ativa o WORKLOAD_AUTO_REPLAY, o ciclo de captura e repetição continua toda semana. O Autonomous Database executa uma captura no banco de dados de origem e, em seguida, repete a carga de trabalho no banco de dados de destino, até você desativar WORKLOAD_AUTO_REPLAY.

Você pode encontrar informações sobre capturas e repetições de carga de trabalho na exibição DBA_CAPTURE_REPLAY_HISTORY. Consulte DBA_CAPTURE_REPLAY_HISTORY View para obter mais informações.

O Autonomous Database aplica patches automaticamente no seu banco de dados. A Oracle fornece um objetivo de nível de serviço de regressões zero em seu banco de dados de produção devido a esses patches. Consulte Objetivo do Nível de Serviço de Regressão Zero para obter mais informações.

Este exemplo ativa o WORKLOAD_AUTO_REPLAY no Autonomous Database de origem e no banco de dados clone atualizável de destino especificado. Com a opção WORKLOAD_AUTO_REPLAY ativada, a cada semana o Autonomous Database executa uma captura no banco de dados de origem e reproduz a carga de trabalho no banco de dados de destino, até você desativar a opção WORKLOAD_AUTO_REPLAY.

Para encontrar informações sobre capturas e reapresentações, assine eventos de Informações. Os eventos de informações fornecem notificação para eventos de captura e resposta da carga de trabalho e incluem um URL de PAR no qual você pode fazer download do arquivo de captura e do relatório de repetição. Consulte (Opcional) Inscrever-se em Eventos de Informações a Serem Notificados sobre Detalhes de Captura e Repetição para obter mais informações.

Você pode encontrar informações sobre capturas e repetições de carga de trabalho na exibição DBA_CAPTURE_REPLAY_HISTORY. Consulte DBA_CAPTURE_REPLAY_HISTORY View para obter mais informações.

Execute DBMS_CLOUD_ADMIN.DISABLE_FEATURE para desativar a repetição automática da carga de trabalho. Por exemplo:

BEGIN 
DBMS_CLOUD_ADMIN.DISABLE_FEATURE(
    feature_name => 'WORKLOAD_AUTO_REPLAY');   
END;
/

Você deve estar conectado como ADMIN ou ter privilégios DBMS_CLOUD_ADMIN para executar DBMS_CLOUD_ADMIN.DISABLE_FEATURE.

Consulte DISABLE_FEATURE Procedures para obter mais informações.