Adicionar um Caminho de Distribuição

Um caminho de distribuição envia a transação de dados de um processo de Extract para um processo de Replicat.

Tópicos Relacionados

Quando usar um Caminho de Distribuição

Use um Caminho de Distribuição quando precisar replicar dados em um ambiente de implantação distribuída. Um Caminho de Distribuição envia a transação dos dados do processo Extract para o processo Replicat. A criação e execução de um Caminho de Distribuição cria automaticamente um Caminho do Receptor no serviço do Receptor da implantação de destino. O Caminho do Receptor recebe a transação de dados do serviço de Distribuição da implantação de origem.

A implantação de origem é a implantação na qual você cria o Caminho de Distribuição. A implantação de destino é a implantação para a qual os dados extraídos e as Trilhas são enviados.

Antes de começar

Certifique-se de criar conexões GoldenGate para cada implantação à qual você deseja se conectar e designá-las à implantação da qual o caminho se origina. Por exemplo, a implantação na qual você cria o Caminho de Distribuição ou o Caminho do Receptor iniciado pelo destino.

Caso contrário, em implantações ativadas pelo IAM, você encontrará o erro:

The network connection could not be established: 'OGG-08654' - 'Invalid or missing OAuth
      resource - audiencescope in Client application'.

Criar e executar um Caminho de Distribuição (23ai)

Se estiver usando o armazenamento de credenciais GoldenGate, você deverá adicionar um usuário com o qual a implantação de origem use para estabelecer conexão com uma implantação de destino. Se estiver usando o armazenamento de credenciais do IAM, ignore estas etapas.
  1. Na console de implantação de destino, faça log-in e acesse a página Administração de Usuários na navegação esquerda.
  2. Clique em Adicionar Novo Usuário e, em seguida, faça o seguinte:
    • Autenticado por: Selecione Senha na lista drop-down.
    • Atribuição: Selecione Operador na lista drop-down.
    • Nome do usuário: Informe o nome do usuário.
    • Senha e Verificar Senha: Digite a senha associada a este usuário.
  3. Abra a console de implantação de origem e navegue até Conexões de Caminho no menu de navegação esquerdo.
  4. Clique em Adicionar Conexão de Caminho e conclua o seguinte:
    • Apelido da Credencial: Digite um alias.
    • ID do Usuário: Digite o nome do usuário criado na etapa 2.
    • Senha e Verificar Senha: Digite a senha associada a este usuário na etapa 2.
  5. Clique em Submeter.
Para adicionar um Caminho de Distribuição no GoldenGate 23ai
  1. Na console de implantação do OCI GoldenGate, clique em Serviço de Distribuição.
  2. Na Home page, clique em Adicionar Caminho de Distribuição (ícone de mais).
  3. No painel Adicionar Caminho, preencha os campos Informações do Caminho conforme necessário e clique em Próximo:
    1. Digite o Nome do Caminho, digite um nome para o caminho.
    2. (Opcional) Digite uma Descrição para descrever a finalidade desse caminho e listar os processos Extract e Replicats envolvidos.
  4. Na página Opções da Origem, informe os campos conforme necessário e clique em Próximo:
    • Selecione Extração de Origem na lista suspensa.
    • Informe o Nome da Trilha
    • Informe o Subdiretório, se você espera que a Trilha esteja em um local diferente do padrão.
    • O URI de Origem Gerado é gerado automaticamente com base nas informações fornecidas. Clique em Editar (ícone de lápis) para modificar o URI, se necessário.
    • Selecione um Perfil de Criptografia. O perfil Wallet Local será selecionado por padrão se um perfil de criptografia não tiver sido criado.
    • Em Iniciar, selecione o ponto inicial do processamento de dados:
      • Posição no Log
      • Now
      • Horário Personalizado
      • CSN (em ou após)
    • Informe o Número da Sequência.
    • Informe o Deslocamento de RBA.
  5. Na página Opções de Destino, preencha os campos conforme necessário e clique em Próximo:
    • Selecione um Protocolo de Destino:
      • ws
      • wss
      • ogg
    • (Opcional) Ative Proxy reverso ativado para estabelecer conexão com o destino usando um proxy reverso.
    • Tipo de destino (somente Protocolo de Destino doogg)
      • Gerenciador
      • Coletor
      • Serviço do Receptor
    • Informe o Host de Destino.
    • Informe o Número da Porta da implantação de destino.
    • Informe o Nome da Trilha para o arquivo de Trilha de destino.
    • Informe o Subdiretório, se a Trilha estiver localizada em algum lugar diferente do local padrão.
    • Informe o Tamanho da Trilha máximo.
    • Selecione um Algoritmo de Criptografia de Destino usado para enviar a Trilha à implantação de destino:
      • NONE
      • AES128
      • AES192
      • AES256
    • Ative Alterar Criptografia para permitir alterações no algoritmo de criptografia.
    • O URI de Destino Gerado é gerado automaticamente com base nas informações fornecidas. Clique em Editar (ícone de lápis) para modificar o URI, se necessário.
    • Selecione um Método de Autenticação de Destino (somente Protocolo de Destino dows)
      • Alias de UserID

        Observação:

        Crie uma credencial usando o usuário do IAM ao estabelecer conexão com uma implantação ativada pelo IAM de uma implantação de armazenamento de credenciais GoldenGate. Certifique-se de que o usuário exista no Segmento de Identidade do IAM.
      • OAuth

        Observação:

        Em tenancies ativadas para IAM, selecione OAuth ao estabelecer conexão com outra implantação ativada para IAM.
      • Certificado
    • Selecione um Domínio.
    • Selecione o Alias que tem o Oracle GoldenGate UserID e a Senha.
    • Selecione um Tipo de Destino:
      • GGFormat (padrão)
      • SQL
      • XML
      • Texto Simples
  6. Na página Opções Avançadas, preencha os campos conforme necessário e clique em Próximo:
    • Ative Ativar Compactação de Rede para definir o Limite de Compactação.
    • Selecione Atraso de EOF.

      Observação:

      Em plataformas Linux, as definições padrão podem ser mantidas. No entanto, em plataformas que não são do Linux, talvez você precise ajustar essa definição para redes de alta largura de banda, alta latência ou para redes que tenham definições de Qualidade de Serviço (QoS) (DSCP e Tempo de Serviço (ToS))
    • Selecione a Frequência de Checkpoint para definir a frequência do caminho que está fazendo o checkpoint (em segundos).
    • Informe os Bytes para Liberação de TCP (em bytes).
    • Informe os Segundos para Liberação de TCP (em segundos).
    • Selecione o Ponto de Código de Serviços Diferenciados (DSCP).
    • Selecione o Tipo de Serviço (TOS).
    • Ative TCP_NODELAY para evitar atraso ao usar a opção de Nagle.
    • Ative Confirmação Rápida para enviar confirmação rápida após o recebimento de dados.
    • Ative TCP_CORK para permitir o uso da opção cork do algoritmo de Nagle.
    • Informe o Tamanho do Buffer de Envio do Sistema para definir o valor do tamanho do buffer de envio para controle de fluxo.
    • Informe o Tamanho do Buffer de Recebimento do Sistema para definir o valor do tamanho do buffer de recebimento para controle de fluxo.
    • Defina o tempo limite para Manter Ativo.
  7. Na página Opções de Filtragem, preencha os seguintes campos conforme necessário e clique em Próximo:
    • Informe um Nome de Regra.
    • Selecione uma Ação da Regra:
      • Excluir filtra os dados com base nas opções selecionadas.
      • Incluir inclui dados com base em opções especificadas.
    • Selecione um Tipo de Filtro:
      • Tipo de Objeto: Selecione entre três tipos de objeto: DML, DDL e Procedimento
      • Nomes de Objeto: Selecione esta opção para fornecer um nome de objeto existente. Uma convenção de nomenclatura de três partes depende do fato de você estar usando um CDB. Com o CDB, você precisa usar uma convenção de nomenclatura de 3 peças; caso contrário, uma convenção de 2 peças é obrigatória. A convenção de 3 peças inclui container, schema, object. A convenção de 2 peças inclui schema, object name.
      • Nome do Recurso do Procedimento: Selecione esta opção para filtrar, com base no nome do recurso do procedimento existente.
      • Com Base na Coluna: Se você selecionar essa opção, será exibida a opção de informar a tabela e o nome da coluna aos quais a regra se aplica. Você pode filtrar usando o valor de coluna com as condições LT, GT, EQ, LE, GE, NE. Você também pode especificar se deseja ter uma imagem anterior ou posterior nos dados filtrados.
      • Tag: Selecione esta opção para definir o filtro com base em tags.
      • ID do Bloco: Exibe os detalhes de configuração dos shards do banco de dados; no entanto, os detalhes não podem ser editados.
    • Selecione Negar para negar qualquer regra existente.
    • Clique em Adicionar para adicionar a regra.
  8. Na página Opções Gerenciadas, preencha os campos opcionais conforme necessário.
    • Ative Crítico para configurar este Caminho para alta disponibilidade.
    • Ative a Reinicialização Automática para ajustar as repetições de reinicialização automática e as opções de atraso de reinicialização automática.
  9. Clique em Criar e Executar para executar seu Caminho imediatamente. Clique em Criar para executar seu Caminho manualmente posteriormente.
Você retorna à Home page na qual pode exibir o status do processo do Caminho.

Criar e executar um Caminho de Distribuição (21c)

Adicione uma Credencial que permita que uma implantação de origem (a implantação na qual você cria este Caminho) se conecte a uma implantação de destino:
  1. Na console de implantação de destino, faça login e acesse a página Administrador no menu de navegação.
  2. Clique em Adicionar Usuário e crie um usuário que a implantação de origem possa usar para estabelecer conexão com a implantação de destino. Atribua a esse usuário a atribuição Operador.
  3. Abra a console de implantação de origem e navegue até a página Configuração.
  4. Na guia Banco de Dados, clique em Adicionar Credencial e faça o seguinte:
    • Domínio da Credencial: Digite um nome para esta conexão
    • Apelido da Credencial: Digite um alias
    • ID do Usuário: Digite o nome do usuário criado na etapa 2.
    • Senha e Verificar Senha: Digite a senha associada a este usuário na etapa 2.
  5. Clique em Submeter.
Para adicionar um Caminho de Distribuição
  1. Na console de implantação do OCI GoldenGate, clique em Serviço de Distribuição.
  2. Na página Visão Geral do Serviço de Distribuição, clique em Adicionar Caminho (ícone de mais).
  3. Na página Adicionar Caminho, preencha os campos da seguinte forma:
    1. Em Nome do Caminho, digite um nome para o caminho.
    2. (Opcional) Em Descrição, digite uma descrição curta da finalidade desse caminho.
    3. (Opcional) Ative Proxy reverso ativado para estabelecer conexão com o destino usando um proxy reverso.
    4. Em Origem, selecione o nome do Extract na lista drop-down.
    5. Em Nome da Trilha, selecione a trilha do Extract na lista drop-down.
    6. Em URI de Origem Gerado, o URI é gerado automaticamente com base nas informações fornecidas no Extract. Clique em Editar (ícone de lápis) para modificar o URI, se necessário.
    7. Em Método de Autenticação de Destino, selecione o método de autenticação do URI de destino:
      • OAuth: Selecione essa opção se as implantações de origem e de destino estiverem ativadas para o serviço IAM. Essa opção usa as credenciais do cliente para autenticação do Serviço de Distribuição para o Serviço do Receptor.

        Observação:

        Em tenancies ativadas para IAM, selecione OAuth ao estabelecer conexão com outra implantação ativada para IAM.
      • Alias UserID: Essa opção usa um Alias UserID que você pode criar no Oracle GoldenGate de destino para estabelecer uma conexão.

        Observação:

        Crie uma credencial usando o usuário do IAM ao estabelecer conexão com uma implantação ativada pelo IAM de uma implantação de armazenamento de credenciais GoldenGate. Certifique-se de que o usuário exista no Segmento de Identidade do IAM.
    8. Em Alvo, selecione um protocolo de transferência de dados na lista drop-down:
      • wss: O soquete Web seguro é a opção padrão. Se selecionado, preencha os seguintes campos:
        • Host do Alvo
        • Número da Porta
        • Nome da Trilha
        • Nome da Implantação (proxy reverso ativado)
        • Caminho do URI (proxy reverso ativado)
        • Domínio
        • Alias
      • ogg: Se selecionar, preencha os seguintes campos:
        • Host do Alvo
        • Número da Porta
        • Nome da Trilha
        • Nome da Implantação (proxy reverso ativado)
        • Caminho do URI (proxy reverso ativado)
      • ws: If selected, you must complete the following fields:
        • Host do Alvo
        • Número da Porta
        • Nome da Trilha
        • Nome da Implantação (proxy reverso ativado)
        • Caminho do URI (proxy reverso ativado)
        • Domínio
        • Alias
    9. Para URI de Destino Gerado, o URI é preenchido automaticamente com base nas informações fornecidas. Clique em Editar (ícone de lápis) para modificar o URI, se necessário.
    10. Em Algoritmo de Criptografia de Destino, selecione um algoritmo de criptografia para a trilha de destino:
      • Nenhum(a)
      • AES128
      • AES192
      • AES256
    11. Em Ativar Compressão de Rede, selecione essa opção para definir o Limite de Compressão.
    12. Em Tamanho da Sequência, informe o tamanho do número de sequência da trilha.
    13. Em Tamanho da Trilha (MB), informe o tamanho máximo de um arquivo em uma trilha.
    14. Em Configurar Formato de Trilha, ative essa opção se quiser configurar o formato do arquivo de trilha e, em seguida, preencha os campos adicionais conforme necessário.
  4. Na seção Perfil de Criptografia, preencha os seguintes campos conforme necessário:
    1. Nome do Perfil
    2. Tipo de Perfil de Criptografia
    3. Nome da Chave Principal
    4. Em Iniciar, selecione onde registrar dados:
      • Now
      • Horário Personalizado
      • Posição no Log (padrão)
    5. Em Número de Sequência de Origem, selecione o número de sequência do processo Extract da implantação de origem do arquivo de trilha.
    6. Em Defasagem de RBA de Origem, informe o Endereço de Byte Relativo (RBA) no arquivo de trilha no qual você deseja que o processo seja iniciado.
    7. Em Crítica, defina essa opção como Verdadeira se o caminho de distribuição for crítico para a implantação. O padrão é Falso.
    8. Em Reinicialização Automática, defina essa opção como Verdadeira se quiser que o caminho de distribuição seja reinicializado automaticamente se for encerrado.
    9. Em Opções de Inicialização Automática, indique o número de novas tentativas para reiniciar o processo de caminho e o intervalo de duração do atraso entre as novas tentativas.
  5. Em Configuração do conjunto de regras, preencha os seguintes campos conforme necessário:
    1. Em Ativar Filtro, se selecionado, clique em Adicionar Regra e preencha os campos adicionais.
  6. Em Mais opções, preencha os seguintes campos conforme necessário:
    1. Atraso de EOF: atraso de fim do arquivo antes de procurar dados de origem
    2. Frequência de Checkpoint: frequência em segundos para checkpoints de rotina
    3. Opções do Aplicativo
      • Bytes para Liberação de TCP: Tamanho da liberação
      • Segundos para Liberação de TCP: Intervalo de liberação
    4. Opções de TCP
      • DSCP: serviços diferenciados de rede
      • Termo de serviço do TOS
      • TCP_NODELAY: desativa o uso do algoritmo de Nagle se ativado
      • Confirmação Rápida: envia confirmação, se ativada
      • TCP_CORK: ativa o uso do algoritmo de Nagle
      • Tamanho do buffer de Envio do Sistema
      • Tamanho do Buffer de Recebimento do Sistema
      • Keep Alive: timeout para keep alive
  7. Click Create and Run.
Você retorna à página Visão Geral, na qual poderá exibir o status do processo do Caminho.

Problemas conhecidos

Para criar Caminhos de Distribuição para enviar ou extrair dados do Oracle Cloud Infrastructure GoldenGate, certifique-se de adicionar o certificado raiz ao Gerenciamento de Certificados ou à wallet do cliente

Para enviar ou extrair dados do OCI GoldenGate, crie um Caminho do Servidor de Distribuição ou um caminho iniciado pelo destino do Servidor do Receptor no Oracle GoldenGate on-premises ou do Marketplace, respectivamente. Adicione também o certificado raiz ou o certificado autoassinado do OCI GoldenGate ao Gerenciamento de Certificos do Oracle GoldenGate (Oracle GoldenGate 21c ou mais recente) ou à wallet do cliente (Oracle GoldenGate 19c). Isso cria uma conexão confiável entre as implantações do Oracle GoldenGate e do OCI GoldenGate. Somente o protocolo WSS (WebSocket Secure) é suportado para Caminhos do Servidor de Distribuição e do Receptor entre o Oracle GoldenGate e o OCI GoldenGate.

Uma alteração no certificado raiz do OCI GoldenGate fará com que o Caminho do Servidor de Distribuição ou um caminho iniciado pelo destino do Servidor do Receptor no Oracle GoldenGate on-premises ou do Marketplace falhe e produza o seguinte erro:

ERROR   OGG-10390  Oracle GoldenGate Receiver Service:  Generic error -1 noticed for endpoint
      wss://<deployment URL>:443/services/v2/sources?trail=<trail name>. Error description - SSL
      connection unexpectedly closed.

Solução alternativa: Para corrigir esse problema, atualize o certificado na wallet do cliente ou na tela Gerenciamento de Certificos do Gerenciador de Serviços para usar o certificado raiz da Console de Implantação GoldenGate do OCI. Em alguns casos, quando o certificado da implantação GoldenGate do OCI não for assinado diretamente pelo certificado raiz, mas por um ou mais intermediários, por exemplo, talvez seja necessário também adicionar o(s) certificado(s) da CA intermediária.

Saber mais:

Apenas a Autenticação de Compilação é suportada atualmente

O Oracle Cloud Infrastructure GoldenGate no momento não suporta autenticação baseada em certificado quando você usa o Oracle Cloud Infrastructure GoldenGate como destino do Caminho de Distribuição.

Solução Alternativa: Nenhuma.