Estabelecer Conexão com o OCI Streaming

Aprenda a criar uma conexão com o OCI Streaming para uso como origem ou destino com a replicação de dados do OCI GoldenGate e o Stream Analytics.

Antes de começar

Antes de criar uma conexão com o OCI Streaming, certifique-se de:

  • Verifique como o OCI GoldenGate se conecta à sua origem e aos seus destinos.
  • Configure as políticas necessárias para permitir o acesso seguro ao Vault e aos Segredos, como usar segredos, usar vaults e ler pacotes de segredos. Para obter mais informações, consulte Políticas mínimas recomendadas.
  • Se estiver usando controladores de recursos para autenticar o acesso ao OCI Streaming, você deverá:
    1. Crie um grupo dinâmico para a sua implantação. Você pode optar por autorizar uma única implantação ou toda a implantação em um compartimento ou tenancy. Consulte Gravando regras de correspondência para definir grupos dinâmicos.
    2. Adicionar as políticas necessárias para o grupo dinâmico
  • Obtenha o nome de usuário do Pool de Streams:
    1. No menu Console do Oracle Cloud, selecione Streaming e, em seguida, Stream Pools.
    2. Na página Pools de Streams, selecione o pool para exibir seus detalhes.
    3. Na página de detalhes do Pool de Streams, em Recursos, clique em Definições de Conexão do Kafká.
    4. Copie o nome do usuário das Strings de Conexão SASL.

      Observação:

      Se você estiver usando o serviço Oracle Identity Cloud, adicione OracleIdentityCloudService ao seu nome de usuário. Por exemplo, <tenancy-name>/OracleIdentityCloudService/<username>/<streampool-ocid>
    5. Crie um token de Autenticação:
      1. No cabeçalho global da Console do Oracle Cloud, clique em Perfil e selecione Definições do Usuário.
      2. Na página Detalhes do Usuário, em Recursos, clique em Tokens de Autorização e, em seguida, clique em Gerar Token.
      3. Na caixa de diálogo Gerar Token, informe uma descrição e, em seguida, clique em Gerar Token.
      4. Copie o token de autorização da caixa para um local seguro do qual você possa recuperá-lo posteriormente e clique em Fechar.

O nome de usuário e o token de Autenticação do Pool de Streams serão informados para o nome de usuário e a senha da conexão do Stream.

Criar a conexão de origem

Para criar uma conexão de origem do OCI Streaming:
  1. Na página Visão Geral do OCI GoldenGate, clique em Conexões.
    Você também pode clicar em Criar Conexão na seção Conceitos Básicos e ir direto para a etapa 3.
  2. Na página Conexões, clique em Criar Conexão.
  3. Na página Criar Conexão, preencha os campos da seguinte forma:
    1. Para Nome, digite um nome para a conexão.
    2. (Opcional) Para Descrição, informe uma descrição que ajude a distinguir essa conexão de outras.
    3. Para Compartimento, selecione o compartimento no qual a conexão será criada.
    4. Na lista drop-down Tipo, selecione OCI Streaming.
    5. Para obter detalhes do pool de Streams, você pode escolher:
      • Selecione um pool de fluxos
        1. Selecione um pool de streams na lista drop-down ou clique em Alterar compartimento para selecionar um em outro compartimento.
      • Especifique informações do pool de streams para especificar manualmente as informações do pool de streams.
        1. Informe o Host e a Porta do servidor de Inicialização.

          Observação:

          Se você informar um IP privado, o OCI GoldenGate reescreverá o IP privado no formato ip-10-0-0-0.ociggsvc.oracle.vcn.com.
    6. Para Usuário, selecione como autenticar e acessar o pool de streams:
      • Nome de Usuário e senha: informe o nome de usuário do Pool de Fluxos copiado das Configurações de Conexão SASL nas etapas pré-requisitos acima.
      • Usar controlador de recursos: autentica usando o controlador de recursos para acessar outros recursos do OCI.
    7. Selecione o segredo da senha do usuário do banco de dados. Se estiver localizado em outro compartimento, use a lista drop-down para alterar compartimentos.

      Observação:

      • Segredos são credenciais como senhas, certificados, chaves SSH ou tokens de autenticação usados nos serviços do OCI. Para criar um segredo, consulte Criando um segredo. Verifique se:
        • Selecione Geração de segredo manual.
        • Cole as credenciais no conteúdo do segredo.
      • Se preferir não usar segredos de senha, certifique-se de desmarcar Usar segredos no vault na seção Segurança em Opções Avançadas, localizada na parte inferior deste formulário.
    8. Expanda Mostrar opções avançadas. Você pode configurar as seguintes opções;
      • Segurança
        • Desmarque Usar segredos do vault para que você prefira não usar segredos de senha para esta conexão. Caso não esteja selecionado:
          • Selecione Usar chave de criptografia gerenciada pela Oracle para deixar para a Oracle todo o gerenciamento de chaves de criptografia.
          • Selecione Usar chave de criptografia gerenciada pelo cliente para selecionar uma chave de criptografia específica armazenada no OCI Vault para criptografar suas credenciais de conexão.
      • Conectividade de rede
        • Ponto final compartilhado, para compartilhar um ponto final com a implantação atribuída. Você deve permitir conectividade com base no IP de entrada da implantação.
        • Ponto final dedicado, para tráfego de rede por meio de um ponto final dedicado na sub-rede designada na sua VCN. Você deve permitir conectividade dos IPs de entrada dessa conexão.

          Observação:

          • Se uma conexão dedicada permanecer não designada por sete dias, o serviço a converterá em uma conexão compartilhada.
          • Saiba mais sobre a conectividade do Oracle GoldenGate.
      • Definições

        Para capturar do OCI Streaming, crie um arquivo consumer.properties com um dos seguintes desserializadores ou conversores e arraste e solte o arquivo em Propriedades do consumidor:

        • Propriedades do Consumidor Kafka para desserializador JSON:
          key.deserializer=org.apache.kafka.common.serialization.ByteArrayDeserializer
          value.deserializer=org.apache.kafka.common.serialization.ByteArrayDeserializer
        • Propriedades do consumidor Kafka para conversor JSON:
          key.converter=org.apache.kafka.connect.json.JsonConverter
          value.converter=org.apache.kafka.connect.json.JsonConverter
        • Kafka Propriedades do consumidor para Avro conversor:
          key.converter=io.confluent.connect.avro.AvroConverter
          value.converter=io.confluent.connect.avro.AvroConverter
      • Tags: Adicione tags para organizar seus recursos.
  4. Clique em Criar.
Depois que a conexão é criada, ela aparece na lista Conexões. Certifique-se de designar a conexão a uma implantação para usá-la como origem ou destino em uma replicação.

Criar a conexão de destino

Para criar uma conexão de destino do OCI Streaming:
  1. Na página Visão Geral do OCI GoldenGate, clique em Conexões.
    Você também pode clicar em Criar Conexão na seção Conceitos Básicos e ir direto para a etapa 3.
  2. Na página Conexões, clique em Criar Conexão.
  3. Na página Criar Conexão, preencha os campos da seguinte forma:
    1. Para Nome, digite um nome para a conexão.
    2. (Opcional) Para Descrição, informe uma descrição que ajude a distinguir essa conexão de outras.
    3. Para Compartimento, selecione o compartimento no qual a conexão será criada.
    4. Na lista drop-down Tipo, selecione OCI Streaming.
    5. Para obter detalhes do pool de Streams, você pode escolher:
      • Selecione um pool de fluxos
        1. Selecione um pool de streams na lista drop-down ou clique em Alterar compartimento para selecionar um em outro compartimento.
      • Especifique informações do pool de streams para especificar manualmente as informações do pool de streams.
        1. Informe o Host e a Porta do servidor de Inicialização.

          Observação:

          Se você informar um IP privado, o OCI GoldenGate reescreverá o IP privado no formato ip-10-0-0-0.ociggsvc.oracle.vcn.com.
    6. Para Usuário, selecione como autenticar e acessar o pool de streams:
      • Nome de Usuário e senha: informe o nome de usuário do Pool de Fluxos copiado das Configurações de Conexão SASL nas etapas pré-requisitos acima.
      • Usar controlador de recursos: autentica usando o controlador de recursos para acessar outros recursos do OCI.
    7. Selecione o segredo da senha do usuário do banco de dados. Se estiver localizado em outro compartimento, use a lista drop-down para alterar compartimentos.

      Observação:

      • Segredos são credenciais como senhas, certificados, chaves SSH ou tokens de autenticação usados nos serviços do OCI. Para criar um segredo, consulte Criando um segredo. Verifique se:
        • Selecione Geração de segredo manual.
        • Cole as credenciais no conteúdo do segredo.
      • Se preferir não usar segredos de senha, certifique-se de desmarcar Usar segredos no vault na seção Segurança em Opções Avançadas, localizada na parte inferior deste formulário.
    8. Expanda Mostrar opções avançadas. Você pode configurar as seguintes opções;
      • Segurança
        • Desmarque Usar segredos do vault para que você prefira não usar segredos de senha para esta conexão. Caso não esteja selecionado:
          • Selecione Usar chave de criptografia gerenciada pela Oracle para deixar para a Oracle todo o gerenciamento de chaves de criptografia.
          • Selecione Usar chave de criptografia gerenciada pelo cliente para selecionar uma chave de criptografia específica armazenada no OCI Vault para criptografar suas credenciais de conexão.
      • Conectividade de rede
        • Ponto final compartilhado, para compartilhar um ponto final com a implantação atribuída. Você deve permitir conectividade com base no IP de entrada da implantação.
        • Ponto final dedicado, para tráfego de rede por meio de um ponto final dedicado na sub-rede designada na sua VCN. Você deve permitir conectividade dos IPs de entrada dessa conexão.

          Observação:

          • Se uma conexão dedicada permanecer não designada por sete dias, o serviço a converterá em uma conexão compartilhada.
          • Saiba mais sobre a conectividade do Oracle GoldenGate.
      • Definições

        Para usar a compactação Snappy na replicação do Kafka, arraste e solte ou selecione Propriedades do produtor e altere as definições de replicação, conforme discutido em Usando a Replicação Kafka do OCI de Compactação GoldenGate (Confluente).

      • Tags: Adicione tags para organizar seus recursos.
  4. Clique em Criar.
Depois que a conexão é criada, ela aparece na lista Conexões. Certifique-se de designar a conexão a uma implantação para usá-la como origem ou destino em uma replicação.