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.

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 Trilhas são enviados.

Antes de começar

Certifique-se de criar conexões do 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 em que você cria o Caminho de Distribuição ou o Caminho do Receptor iniciado pelo destino.

Caso contrário, nas implantações ativadas para o 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 (26ai)

Se estiver usando o armazenamento de credenciais do 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. Selecione Adicionar Novo Usuário e conclua o seguinte:

    • Autenticado por: Selecione Senha no menu suspenso.

    • Função: Selecione Operador na lista drop-down.

    • Nome do Usuário: Informe seu nome de usuário.

    • Senha e Verificar Senha: Informe a senha associada ao usuário.

  3. Abra a console de implantação de origem e navegue até as Conexões de Caminho no menu de navegação esquerdo.

  4. Selecione Adicionar Conexão de Caminho e, em seguida, conclua o seguinte:

    • Alias da Credencial: Informe um alias.

    • ID do Usuário: Informe o nome do usuário criado na etapa 2.

    • Senha e Verificar Senha: Informe a senha associada ao usuário na etapa 2.

  5. Selecione Enviar.

Para adicionar um Caminho de Distribuição no GoldenGate 26ai:

  1. Na Home page da console de implantação do OCI GoldenGate, selecione Criar (ícone de mais) para Caminhos de Distribuição.

  2. No painel Adicionar Caminho, preencha os campos Informações do Caminho conforme necessário e selecione Próximo:

    1. Informe o Nome do Caminho. Informe um nome para o caminho.

    2. (Opcional) Informe uma Descrição, para descrever a finalidade desse caminho e listar os processos Extract e Replicats envolvidos.

  3. Na página Opções de Origem, informe os campos conforme necessário e selecione Próximo:

    • Selecione a Extração de Origem no menu suspenso.

    • 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. Selecione 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.

    • Para Iniciar, selecione o ponto inicial para o processamento de dados:

      • Posição no Log

      • Now

      • Horário Personalizado

      • CSN (em ou após)

    • Informe o Nº da Sequência.

    • Insira o Deslocamento de RBA.

  4. Na página Opções de Destino, preencha os campos conforme necessário e selecione Próximo:

    • Selecione um Protocolo de Destino:

      • ws

      • wss

      • ogg

    • (Opcional) Ative a opção Reverter proxy ativado para estabelecer conexão com o destino usando um proxy reverso.

    • Tipo de destino (somente Protocolo de Destino de ogg)

      • 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 do arquivo da 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 para a implantação de destino:

      • NONE

      • AES128

      • AES192

      • AES256

    • Ative Alterar Criptografia para permitir alterações no algoritmo de criptografia.

    • URI de Destino Gerado é gerado automaticamente com base nas informações fornecidas. Selecione Editar (ícone da lápis) para modificar o URI, se necessário.

    • Selecione um Método de Autenticação de Destino (somente Protocolo de Destino dowss)

      • Alias de UserID

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

      • OAuth

        Observação: Em tenancies ativadas pelo IAM, selecione OAuth ao estabelecer conexão com outra implantação ativada pelo IAM.

      • Certificado

    • Selecione um Domínio.

    • Selecione o Alias que tem o ID de Usuário e a Senha do Oracle GoldenGate.

    • Selecione um Tipo de Destino:

      • GGFormat (padrão)

      • SQL

      • XML

      • Texto Simples

  5. Na página Opções Avançadas, preencha os campos conforme necessário e selecione Próximo:

    • Ative Ativar Compactação de Rede para definir o Limite de Compactação.

    • Selecione Atraso de EOF.

      Observação: nas plataformas Linux, as configuraçõ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á tomando o checkpoint (em segundos).

    • Informe os Bytes de Descarga do TCP (em bytes).

    • Informe os Segundos de Descarga do 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 atrasos ao usar a opção do Nagle.

    • Ative a Confirmação Rápida para enviar confirmação rápida após o recebimento dos dados.

    • Ative TCP_CORK para permitir o uso da opção de cortiça do algoritmo de Nagle.

    • Informe o Tamanho do Buffer de Envio do Sistema para definir o valor do tamanho do buffer de envio para o controle de fluxo.

    • Informe o Tamanho do Buffer de Recebimento do Sistema para definir o valor do tamanho do buffer de recebimento para o controle de fluxo.

    • Defina o timeout para Manter Ativo.

  6. Na página Opções de Filtro, preencha os seguintes campos conforme necessário e selecione Próximo:

    • Informe um Nome da Regra.

    • Selecione uma Ação da Regra:

      • Excluir filtra os dados com base nas opções selecionadas.

      • Incluir inclui dados com base nas 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 CDB, você precisa usar uma convenção 3–part nomeação, caso contrário uma convenção 2–part é obrigatória. Convenção 3–part inclui container, schema, object. Convenção 2–part inclui schema, object name.

      • Nome do Recurso de Procedimento: Selecione esta opção para filtrar, com base no nome do recurso de procedimento existente.

      • Baseado em Coluna: Se você selecionar essa opção, será apresentada a opção de informar o nome da tabela e da coluna às quais a regra se aplica. Você pode filtrar usando o valor da coluna com 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, não é possível editar os detalhes.

    • Selecione Negar para negar qualquer regra existente.

    • Para adicionar a regra, selecione Adicionar.

  7. Na página Opções Gerenciadas, preencha os campos opcionais conforme necessário.

    • Ative Crítico para configurar este Caminho para alta disponibilidade.

    • Ative 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.

  8. Selecione Criar e Executar para executar seu Caminho imediatamente. Selecione Criar para executar seu Caminho manualmente posteriormente.

Você retorna à Home page, onde pode exibir o status do processo Caminho.

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

Adicione uma Credencial que permita a uma implantação de origem (a implantação na qual você cria este Caminho) estabelecer conexão com uma implantação de destino:

  1. Na console de implantação de destino, faça log-in e acesse a página Administrador no menu de navegação.

  2. Selecione Adicionar Usuário e, em seguida, crie um usuário que a implantação de origem possa usar para se conectar à implantação de destino. Designe 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, selecione Adicionar Credencial e, em seguida, conclua o seguinte:

    • Domínio da Credencial: Digite um nome para esta conexão

    • Alias da Credencial: Informe um alias

    • ID do Usuário: Informe o nome do usuário criado na etapa 2.

    • Senha e Verificar Senha: Informe a senha associada ao usuário na etapa 2.

  5. Selecione Enviar.

Para adicionar um Caminho de Distribuição

  1. Na console da implantação do OCI GoldenGate, selecione Serviço de Distribuição.

  2. Na página Visão Geral do Serviço de Distribuição, selecione Adicionar Caminho (ícone de adição).

  3. Na página Adicionar Caminho, preencha os campos da seguinte forma:

    1. Para Nome do Caminho, informe um nome para o caminho.

    2. (Opcional) Para a Descrição, digite uma breve descrição da finalidade deste caminho.

    3. (Opcional) Ative a opção Reverter proxy ativado para estabelecer conexão com o destino usando um proxy reverso.

    4. Para Origem, selecione o nome da Extração na lista drop-down.

    5. Para Nome da Trilha, selecione a trilha Extract na lista drop-down.

    6. Para URI de Origem Gerado, o URI é gerado automaticamente com base nas informações de Extração fornecidas. Selecione Editar (ícone De Lápis) para modificar o URI, se necessário.

    7. Para Método de Autenticação de Destino, selecione o método de autenticação para o URI de destino:

      • OAuth: Selecione essa opção se as implantações de origem e destino estiverem ativadas para 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 pelo IAM, selecione OAuth ao estabelecer conexão com outra implantação ativada para o IAM.

      • Alias UserID: Esta 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 para o IAM em uma implantação de armazenamento de credenciais do GoldenGate. Certifique-se de que o usuário exista no Segmento de Identidade do IAM.

    8. Para Destino, 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 de Destino

        • 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 selecionado, você deve preencher os seguintes campos:

        • Host de Destino

        • Número da Porta

        • Nome da Trilha

        • Nome da Implantação (proxy reverso ativado)

        • Caminho do URI (proxy reverso ativado)

      • ws: Se esta opção for selecionada, você deverá preencher os seguintes campos:

        • Host de Destino

        • 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. Selecione 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. Para Ativar Compactação de Rede, selecione esta opção para definir o limite de Compactação.

    12. Para Tamanho da Sequência, informe o tamanho do número de sequência de trilha.

    13. Para Tamanho de Trilha (MB), informe o tamanho máximo de um arquivo em uma trilha.

    14. Para 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. Para Iniciar, selecione onde registrar dados:

      • Now

      • Horário Personalizado

      • Posição no Log (padrão)

    5. Para Número de Sequência de Origem, selecione o número de sequência do Extract de implantação da origem de arquivo de trilha.

    6. Para Compensação de RBA de Origem, informe o Endereço Relativo de Byte (RBA) no arquivo de trilha onde deseja que o processo seja iniciado.

    7. Em Crítico, defina essa opção com Verdadeiro se o caminho de distribuição for crítico para a implantação. O padrão é Falso.

    8. Para Reinicialização Automática, defina essa opção para Verdadeiro se quiser que o caminho de distribuição seja reiniciado automaticamente se tiver sido encerrado.

    9. Para Opções de Reinicialização Automática, indique o número de novas tentativas a serem reiniciadas no processo do caminho e o intervalo da duração do atraso entre novas tentativas.

  5. Em Configuração do conjunto de regras, preencha os seguintes campos conforme necessário:

    1. Para Habilitar Filtragem, se selecionado, selecione 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

      • ACK Rápido: envia confirmação se ativado

      • 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. Selecione Criar e Executar.

Você retorna à página Visão Geral, onde pode exibir o status do processo de Caminho.

Saiba mais

Interessado em saber mais sobre o processo de Caminho de Distribuição? Consulte os seguintes recursos:

Problemas conhecidos

Os Caminhos de Distribuição e Receptor podem falhar após as implantações 21.x atualizadas para 21.17

A partir do Oracle GoldenGate versões 21.17 e 26ai, os Caminhos usam o nome de domínio reservado padrão, "Rede", de modo que os Caminhos existentes que usam qualquer outro nome de domínio falham com o seguinte erro reportado:

ERROR\| Exception Message: The network connection could not be established: 'OGG-10351' - 'Generic error -1 noticed. Error description - credential store alias not found in domain.'

Solução alternativa: Na console de implantação do OCI GoldenGate, edite cada Caminho e altere o nome do domínio para "Rede" e reinicie o Caminho. Para verificar, verifique o domínio do usuário de autenticação de Caminho na seção de armazenamento de Credenciais da página Configuração.

Se preferir usar o Admin Client, execute os comandos a seguir para atualizar o nome do domínio. Certifique-se de substituir os placeholders <path_name> e <alias>:

Para caminhos iniciados por origem:

ALTER DISTPATH <path_name> TARGET AUTHENTICATION USERIDALIAS <alias> domain
    Network

Para caminhos iniciados por destino:

ALTER RECVPATH <path_name> SOURCE AUTHENTICATION USERIDALIAS <alias> domain
    Network

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.