Adicionar um Caminho de Distribuição

Um caminho é criado para enviar os dados da trilha pela rede do processo Extract para o processo Replicat, criando um caminho de trilha. Antes de começar a adicionar um caminho de distribuição, certifique-se de estabelecer uma conexão de caminho. Para configurar uma conexão de caminho, consulte Adicionar uma Conexão de Caminho.

Observação: Quando um caminho de distribuição se conecta a uma implantação segura, o destino deve ter a cadeia de certificados completa (folha, intermediária e CA raiz) em seu armazenamento de certificados, enquanto a origem só precisa confiar na CA Raiz importando-a como um certificado confiável. Se o config.securityDetails.network.inbound.authMode da implantação segura for definido como clientOptional_server (default), não será necessário um certificado de cliente. No entanto, se for definido como client_server, o cliente deverá usar um certificado para autenticação, e esse certificado também deverá ser adicionado como um usuário Operador na implantação de destino. Se o certificado do cliente for assinado por um certificado da CA Raiz diferente do certificado da CA Raiz do servidor, o certificado da CA Raiz do cliente também precisará ser importado como um certificado confiável no armazenamento de certificados do servidor.

Você pode começar a adicionar um caminho de serviço de distribuição na própria home page dos Microsserviços ou usar o painel de navegação esquerdo para acessar a página Caminhos de Serviço de Distribuição, conforme mencionado nas seguintes etapas:

  1. Clique na opção Caminhos do Serviço de Distribuição no painel de navegação esquerdo para abrir a página Caminhos do Serviço de Distribuição.

  2. Clique no sinal de mais (+) ao lado de Caminhos do Serviço de Distribuição. O assistente Adicionar caminho é exibido.

  3. Na tela Informações do Caminho, observe os botões Padrão e Avançado no canto superior direito do assistente. O botão Padrão é pré-selecionado. Permite configurar o caminho para a maioria das configurações necessárias.

  4. Especifique os seguintes valores para configurar o caminho do serviço de distribuição:

    • Nome do Caminho: Selecione um nome para o caminho.

    • Descrição: Forneça uma descrição. Por exemplo, o nome dos processos de Extract e Replicat associados ao caminho de distribuição.

    • Avançado: Selecione o botão Avançado para ativar a chave Segurança do Air-Gap e configurar suas opções.

    A configuração de segurança air-gap se destina a ambientes em que a forma como os arquivos de trilha são enviados da origem para o destino não é gerenciada pelo Oracle GoldenGate. O Extract grava transações em um arquivo de trilha e o caminho de distribuição produzirá um arquivo de trilha XML local. Esse arquivo de trilha XML pode então ser enviado para uma implantação diferente em que um caminho de distribuição lerá esse arquivo de trilha e o disponibilizará para que um Replicat aplique as transações.

    Selecione uma das seguintes opções para configurar o caminho de distribuição para a entrega segura de dados Air-Gap, dependendo se você está enviando ou recebendo dados de trilha:

     - **From: Unclassified/Low-Side**

 Select this option to configure an Air Gap Path that receives trail data from a secure source location. Provide a name and the required source and target details.

 - **To: Classified/High-Side**

 Select this option to configure an Air Gap Path that writes trail data to a secure target location. Provide a name and source details. Target configuration is simplified for air-gapped delivery.

    • Origem

      • Extração de Origem: Selecione o Extract de origem para o qual a distribuição de trilha será feita pelo Caminho de Distribuição.

      • Nome da Trilha: Nome do arquivo de trilha de origem.

      • Iniciar: Selecione o ponto de onde você precisa registrar dados. É possível selecionar as opções Agora, Hora personalizada, Log de posição e CSN (na ou após) na lista suspensa.

      • Log de Origem: Especifique os valores para o log de origem: Número de Sequência, Defasagem de RBA,

    • Destino

      • Selecione o protocolo de transferência de dados. As opções disponíveis incluem wss, ws e ogg.

      • Reverter Proxy Ativado: Selecione para usar o proxy reverso.

      • Host de Destino: Informe o URL do host do destino, por exemplo, localhost, se o destino estiver no mesmo sistema.

      • Número da Porta: Número da porta da implantação de destino.

      • Arquivo de Trilha: Nome do arquivo de trilha de origem.

      • Método de Autenticação de Destino: Selecione na lista drop-down para a autenticação de destino quando o arquivo de trilha for recebido pelo caminho de distribuição. As opções são: OAuth, Certificate, UserIDAlias

  5. Clique em Próximo.

  6. Marque a caixa de seleção Criptografia para definir as seguintes opções de criptografia para o caminho:

    OBSERVAÇÃO: A caixa de seleção Criptografia não será exibida se você tiver ativado a chave Segurança do Air-Gap.

    • Perfil de Criptografia: Selecione um perfil de criptografia na lista drop-down, se necessário.

    • Algoritmo de Criptografia: Algoritmo de criptografia usado ao enviar a trilha para a implantação de destino. As opções incluem AES128, AES192 e AES256.

    • Alterar Criptografia: Ative essa opção para permitir a alteração do algoritmo de criptografia.

  7. Marque a caixa de seleção Ativar Filtragem para aplicar filtros nos Caminhos de Serviço do Receptor e clique em Próximo. A tela Filtragem é exibida quando você marca essa caixa de seleção.

  8. Na tela Filtragem, especifique as seguintes opções na tela Opções de filtragem para adicionar as regras de filtragem:

    • Nome da Regra: Nome da regra que você precisa criar.

    • Ação da Regra: Selecione entre as regras Excluir ou Incluir. Excluir seria filtrado com base nas opções selecionadas, enquanto Incluir incluiria dados com base nas opções especificadas.

    • Tipo de Filtro: Selecione na seguinte lista de opções:

      • 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, caso contrário, uma convenção 2–part é obrigatória. A convenção 3–part inclui contêiner, esquema e objeto. A convenção 2–part inclui esquema e nome do objeto.

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

    • Nomes de Objeto: Nome do objeto que está sendo filtrado.

    • Negar: marque essa caixa de seleção se precisar negar qualquer regra existente.

  9. Clique em Adicionar para adicionar a regra e depois clique em Próximo.

  10. Na tela Revisar, verifique os detalhes do caminho do serviço de distribuição configurado e edite, se necessário. Se você estiver usando a definição Padrão, poderá configurar as Opções Gerenciadas, da seguinte forma:

    • Crítico: Ative essa opção se quiser configurar o Caminho de Distribuição para alta disponibilidade.

    • Reinicialização Automática: Ative essa chave de alternância para ajustar as opções de reinicialização automática: Repetições de reinicialização automática, Atraso de reinicialização automática

  11. Na tela Revisar, clique no botão Avançado para configurar as opções de formatação de trilha e as opções de rede.

    Opções de Formato: Expanda a seção e selecione o tipo de trilha na caixa drop-down Tipo. As opções de formato de trilha são Texto sem Formatação, XML, SQL. Dependendo do formato de trilha selecionado, defina as seguintes opções de formato:

    • SQL

      • Usar Nome Qualificado: Selecione para usar o nome totalmente qualificado do arquivo de parâmetros.

      • Incluir Informações da Transação: Ative para incluir informações da transação.

      • Compatível com: Você pode selecionar a compatibilidade com o Oracle, SQLPlus, SQLLOADER.

      • Nenhuma Atualização de PK: Desativada por padrão. Ative essa opção para permitir a atualização da Chave Primária.

    • XML

      • Incluir Informações da Transação: Ative para incluir informações da transação.

      • Incluir LOB Grande: Ative para incluir transações de LOB grandes.

      • Incluir Token do Usuário: Ative para incluir o token do usuário

      • Fechar Transação: Ative para fechar uma transação após a conclusão da transação de log do arquivo de trilha.

      • Usar Propriedades em Linha?: Ative para incluir as propriedades de formato de trilha em linha.

      • Codificação: Selecione a codificação na lista drop-down.

    • Texto Simples

      • Compatível com: Selecione o utilitário que é compatível com o arquivo de trilha. As opções são: BCP, SQLLOADER, COMCAST

      • Precisão de Timestamp: Especifique o valor da precisão de timestamp para o arquivo de trilha. As opções são: TS, Date, Time

      • Colunas Extras: Inclui placeholders para colunas adicionais no final de cada registro. Use esta opção quando uma tabela de destino tiver mais colunas do que a tabela de origem.

        Especifique um valor entre 1 e 9.

      • Incluir SYSKEY: Selecione esta opção caso sua configuração de Replicat inclua tabelas com SYSKEY.

      • Estilo da Cotação: Selecione o estilo da cotação, dependendo das exigências do banco de dados. As opções são: single, none, embed

      • Incluir Nome da Coluna: Ative essa opção para incluir nomes de coluna no arquivo de trilha.

      • Nulo é Espaço: Selecione essa opção para indicar que qualquer valor nulo no arquivo de trilha é um espaço.

      • Incluir Placeholder: Gera um placeholder para colunas ausentes.

      • Incluir Campos de Cabeçalho: Selecione para incluir campos de cabeçalho no arquivo de trilha.

      • Delimitador: Um caractere delimitador alternativo.

      • Incluir Tipo de Operação: Ative essa opção para incluir o tipo de operação de trilha nas opções de trilha.

      • Incluir Indicador de Imagem: Ative essa opção para incluir detalhes sobre a imagem anterior e posterior.

      • Incluir Nome do Objeto: Ative essa opção para incluir o nome do objeto nos detalhes da trilha.

      • Codificação: UTF-8

      • Usar Nome Qualificado: Selecione esta opção para usar o nome totalmente qualificado do arquivo de parâmetros.

      • Incluir Informações da Transação: Ative para incluir informações da transação.

    Network Options: Expanda a seção para definir a seguinte configuração de rede:

    • Proxy HTTP: Ative este switch para permitir definições de proxy HTTP para o caminho de distribuição.

    • Ativar Compactação de Rede: Defina o valor limite da compactação se decidir ativar essa opção.

    • Limite de Compactação: a opção aparece quando você ativa a compactação de rede. Especifique o valor do limite de compactação.

    • Tamanho da Sequência da Trilha de Destino: O tamanho do número da sequência da trilha.

    • Atraso de Eof (centissegundos): você pode especificar o Atraso de Eof (centissegundos) em centissegundos. 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) ).

    • Frequência do Checkpoint: Frequência do caminho que está tomando o checkpoint (em segundos).

    • Bytes de Descarga TCP: informe o tamanho da descarga TCP em bytes.

    • Segundos de Descarga TCP: Informe em segundos o intervalo da descarga TCP.

    • DSCP: Selecione o valor do Ponto de Código de Serviços Diferenciados (DSCP) na lista drop-down ou procure-o na lista.

    • Termos de Serviço: Selecione o valor Tipo de serviço na lista drop-down.

    • TCP_NODELAY: Ative essa opção para evitar atrasos ao usar a opção do Nagle.

    • Confirmação Rápida: Ative esta opção para enviar confirmação rápida após receber dados.

    • TCP_CORK: Ative essa opção para permitir o uso da opção de rolha de algoritmo do Nagle.

    • Tamanho do Buffer de Envio do Sistema: Você pode definir o valor do tamanho do buffer de envio para controle de fluxo.

    • Tamanho do Buffer de Recebimento do Sistema: Você pode definir o valor do tamanho do buffer de recebimento para o controle de fluxo.

    • Manter Ativo: O time-out é para keep-alive.

  12. Clique em Criar Caminho ou Criar Caminho e Executar, conforme necessário. Selecione Cancelar se precisar sair da página Adicionar Caminho sem adicionar um caminho.

Você retornará à home page Caminho do Serviço de Distribuição, que agora inclui seu novo caminho.

Após a criação do caminho, você poderá ver o novo caminho na home page Caminho do Serviço de Distribuição. Você também pode ver esse caminho de distribuição na home page Caminho de Serviço do Receptor.