Configurar Origens de Banco de Dados (Método Legado)

Este é um método legado para configurar e adicionar origens de bancos de dados ao Hub do AWR. É um tópico de referência a ser usado pelos usuários do AWR Hub antes de 30 de outubro de 2023.

Os pré-requisitos para o processo de registro diferem dependendo se o banco de dados que você está registrando para obter mais informações sobre pré-requisitos de banco de dados específicos, consulte: Versões de Banco de Dados Suportadas.

Depois que os pré-requisitos listados abaixo forem atendidos, você registrará o(s) banco(s) de dados executando os scripts PL/SQL fornecidos no pop-up Registrar Informações do Banco de Dados.

Pré-requisitos do ADB-S

Os Autonomous AI Databases de origem nos quais o Hub do AWR está sendo ativado precisam ter permissões de gerenciamento no bucket do Object Storage no qual serão transferidos por upload snapshots de AWR. Para conceder essas permissões, faça o seguinte:

Observação

As duas políticas a seguir precisam ser criadas para cada um dos compartimentos nos quais os bancos de dados de origem residem.

  1. Crie um grupo dinâmico definido pelo usuário para os Autonomous AI Databases no compartimento na console do OCI.
    ALL {resource.type = 'autonomousdatabase', resource.compartment.id = '<compartmentId>'}

    Substitua o placeholder compartmentId pelo valor apropriado na política acima

    Esta política poderá exigir várias linhas se mais de um compartimento estiver envolvido (uma linha para cada compartimento).

  2. Dê permissão ao grupo dinâmico definido na etapa 1 para gerenciar o bucket do serviço Object Storage.
    allow dynamic-group '<UserDefinedDynamicGroupName>' to manage object-family in compartment <Compartment name of the bucket> where ANY{target.bucket.name='<Bucket Name>'} 

    Substitua os placeholders dynamic group name, compartment name e object storage bucket name pelos valores apropriados na política acima.

Pré-requisitos do ADB-D

Antes de registrar um banco de dados ADB-D, você precisa executar as seguintes etapas:

  1. Crie um usuário do IAM (Identity and Access Management) e crie políticas para fornecer acesso ao Bucket do AWR Hub Object Storage pelo usuário do IAM.
  2. Adicione o usuário do IAM a um grupo do IAM e conceda permissão ao grupo para gerenciar o bucket do Object Storage gravando a seguinte política:
    allow group '<UserDefinedGroupName>' to manage object-family in compartment <Compartment name of the bucket> where ANY{target.bucket.name='<Bucket Name>'}
  3. Crie as credenciais da nuvem do Hub do AWR, siga as etapas descritas em: Criar Credenciais da Nuvem.

Configurar o Banco de Dados de Origem

  • Bancos de Dados Externos:

    Para obter informações sobre como registrar bancos de dados externos no Hub do AWR, consulte: Versões de Banco de Dados Suportadas.

  • ADB-S e ADB-D
    1. No menu Ops Insights, selecione Administração e Warehouse.
    2. Na guia AWR Hub, clique em Registrar Informações do Banco de Dados. O pop-up Registrar Informações do Banco de Dados é exibido.
      O gráfico mostra a caixa de diálogo Registrar Informações do Banco de Dados.

      Aqui, você encontrará scripts PL/SQL usados para registrar o banco de dados de origem no AWR Hub.

    3. Clique em Copiar para copiar os blocos de código PL/SQL.

      Para ADB-S, o seguinte bloco PL/SQL é usado para registrar o banco de dados de origem no Hub do AWR:

      DECLARE
        -- Ask for database source name (max 10 characters).
        -- The value entered must be unique for each database registered to the same AWR Hub.
        db_src_name VARCHAR2(10) := '&SourceName';
      BEGIN
        -- Enable the resource principal in the database.
        -- This allows uploading AWR snapshots to OCI Object Storage using resource principal credentials.
        DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL();
        -- Register the database as an AWR source.
        dbms_awrhub.register_source(
          hub_name => 'HUB_CLOUD',
          source_name => db_src_name,
          hub_mailbox => 'http://the.awr.hub.mailbox.Url.returned.by.the.restUrl',
          mailbox_type => 'OBJECT_STORE',
          mailbox_cred => 'OCI$RESOURCE_PRINCIPAL');
        -- Setup a cache at the source side to upload AWR snapshots via data pump directory.
        dbms_awrhub.setup_source_cache_mailbox(
          hub_name => 'HUB_CLOUD',
          source_name => db_src_name,
          cache_mailbox => 'DATA_PUMP_DIR');
      END;
      /

      Para o ADB-D, o seguinte bloco PL/SQL é usado para registrar o banco de dados de origem no Hub do AWR:

      DECLARE
        -- Ask for database source name (max 10 characters).
        -- The value entered must be unique for each database registered to the same AWR Hub.
        db_src_name VARCHAR2(10) := '&SourceName';
      BEGIN
        
        -- Register the database as an AWR source.
        dbms_awrhub.register_source(
          hub_name => 'HUB_CLOUD',
          source_name => db_src_name,
          hub_mailbox => 'http://the.awr.hub.mailbox.Url.returned.by.the.restUrl',
          mailbox_type => 'OBJECT_STORE',
          mailbox_cred => 'AWRHUB_KEY_NEW');
        -- Setup a cache at the source side to upload AWR snapshots via data pump directory.
        dbms_awrhub.setup_source_cache_mailbox(
          hub_name => 'HUB_CLOUD',
          source_name => db_src_name,
          cache_mailbox => 'DATA_PUMP_DIR');
      END;
      /
    4. Execute o PL/SQL em cada banco de dados de destino usando qualquer editor SQL, como SQL Plus ou SQL Developer.

      O nome do banco de dados de origem é fornecido pelo usuário e pode ter até 10 caracteres. Ao executar o script, será solicitado que você forneça o nome do banco de dados de origem. A execução do script faz upload do snapshot do AWR do banco de dados de origem para o AWR Hub.

      Pode levar algum tempo para que os blocos sejam executados. A transferência de dados pode levar até 24 horas.

Exibindo Bancos de Dados de Origem

Para exibir os bancos de dados de origem que estão fazendo upload de snapshots do AWR, clique em AWR Hub no menu Ops Insights

O processo acima registra um banco de dados. Da mesma forma, você pode cancelar o registro de um banco de dados clicando em Cancelar o Registro das Informações do Banco de Dados.