Conecte os Dados do Kafka Streams ao Oracle Autonomous Database
Você pode criar uma instância de computação e instalar o Kafka para enviar mensagens como Produtor ou usar as etapas a seguir na Console do OCI.
- Faça log-in no console da OCI e vá para Marketplace.
- Em Todos os Aplicativos, procure GoldenGate Stream Analytics.
- Clique em Ativar Pilha.
- Forneça detalhes da VCN e adicione uma chave Pública SSH para fazer log-in na instância do Stream Analytics GoldenGate usando a chave Privada posteriormente.
Observação:
Esta instância do Stream Analytics GoldenGate tem um exemplo incorporado de Kafka Streams (Produtores) instalado, se você tiver seus próprios Kafka Streams, poderá usá-los também.
Criar um Autonomous Database
- Clique em Oracle Database no menu superior esquerdo e, em seguida, clique em Autonomous Database.
- Na home page Autonomous Databases, clique em Criar Autonomous Database.
- Selecione um Compartimento no qual você deseja criar o Banco de Dados.
- Nome para exibição: Digite uma descrição simplificada ou outras informações que ajudem a identificar facilmente o Autonomous Database.
- Nome do banco de dados: Forneça um nome para o novo Autonomous Database.
- Escolha o Tipo de carga de trabalho como Data Warehouse.
- Escolha o Tipo de implantação como Sem Servidor.
- Escolha Versão do banco de dados como 19c, contagem de ECPUs como 2 e Armazenamento (TB) como 1.
- Crie credenciais de administrador e informe a senha. A senha deve atender aos critérios de complexidade de senha forte com base nos padrões de segurança do Oracle Cloud. Para obter mais informações sobre as regras de complexidade de senhas, consulte Criar Usuários de Banco de Dados.
- Escolha o acesso à rede como Acesso seguro de qualquer lugar.
- Mantenha os parâmetros restantes como padrão e clique em Criar Autonomous Database.
Sua exibição mostra Provisionando até que o novo Autonomous Database esteja disponível.
Criar uma tabela para armazenar mensagens do Kafka
- Abra SQLDeveloper e clique no ícone + para Criar uma conexão de banco de dados Oracle.
- Informe um Nome de conexão, forneça o nome de usuário e a senha do banco de dados.
- Selecione o Tipo de conexão como Wallet da Nuvem e procure o arquivo
wallet.zip
e clique em Conectar. A conexão deve ser criada com sucesso. - Crie uma tabela de amostra usando o seguinte script:
CREATE TABLE "TEST"."SAMPLE" ( "FRUIT" VARCHAR2(50 BYTE)", "TOTAL" VARCHAR2(50 BYTE)", "COLOR" VARCHAR2(50 BYTE)" )
Criando uma Instância do Oracle Integration 3
- Na console do OCI, clique em Developer Services e, em Application Integration, clique em Integration.
- Na home page Instâncias de Integração, clique em Criar Instância.
- Informe um Nome, selecione Versão como Oracle Integration 3, Edição como Enterprise, Forma como Produção e Tipo de licença como Inscrever-se em uma nova Instância do Oracle Integration.
- Clique em Criar.
Depois que a instância for criada, clique na Console de Serviço e isso levará você a uma nova janela.
Criar uma Conexão do Oracle Autonomous Data Warehouse no Oracle Integration 3
- Na instância do Oracle Integration, clique no menu de hambúrguer e, em Design, selecione Conexões.
- Clique em Criar, procure o Oracle ADW e selecione.
- Informe um Nome, Identificador, Atribuição como Acionar e Chamar, Palavra-chave e Descrição sobre essa conexão.
- Em Propriedades, expanda Propriedades opcionais e informe o Nome do Serviço.
- Em Segurança, selecione JDBC Sobre SSL e faça upload do arquivo
Wallet.zip
. - Informe a Senha da Wallet que foi fornecida quando o banco de dados foi criado.
- Informe o Nome do Usuário do Serviço Database como administrador.
- Informe a Senha do Serviço de Banco de Dados para o usuário administrador.
- Selecione o Tipo de Acesso como Gateway público.
- Clique em Testar no canto superior direito.
- Quando uma mensagem bem-sucedida for exibida, clique em Salvar.
Associar grupo de Agentes na Instância do Kafka
Você precisa de um agente que precise estar em execução na instância em que o Kafka Streams está instalado.
- Na instância do Oracle Integration 3, clique no menu de hambúrguer e, em Design, selecione Agentes.
- Na página Agentes, clique em Criar.
- Digite um Nome, um Identificador, uma Descrição e clique em Criar.
- Depois que o Agente for criado, clique em Fazer Download e, em seguida, clique em Agente de Conectividade.
- Após o download bem-sucedido, copie o
oic_conn_agent_installer.zip
para a instância do Kafka na qual seus tópicos do Kafka estão sendo executados e produzindo mensagens. Neste exemplo de manual da solução, é a instância do Oracle GoldenGate Stream Analytics. - Descompacte
oic_conn_agent_installer.zip
. - Na coluna Status, clique no ícone ... e, em seguida, clique em Fazer Download da Configuração.
- Copie o arquivo
InstallerProfile.cfg
e copie-o para a Instância do Kafka. - Substitua o arquivo
InstallerProfile.cfg
na Instância do Kafka. - Após substituir
InstallerProfile.cfg
, execute a seguinte instrução para iniciar o Agente na instância do Oracle GoldenGate Stream Analytics ou na sua instância local do Kafka usando este comando:$ java -jar connectivityagent.jar
O agente deve ser iniciado com sucesso, deixe-o em execução e não pare. Para obter mais informações, consulte Usando Integrações no Oracle Integration Generation 2
Criar uma Conexão Kafka no Oracle Integration 3
- Na instância do Oracle Integration 3, clique no menu de hambúrguer e, em Design, selecione Conexões.
- Clique em Criar, pesquise o Apache Kafka e selecione.
- Informe um Nome, um Identificador, uma Atribuição como Acionar e Chamar, uma Palavra-chave e uma Descrição sobre essa conexão.
- Em Propriedades, informe os Servidores de Inicialização: instancename:9092.
Observação:
Na VCN que está sendo usada pela instância do Kafka, em Lista de Segurança, você precisa adicionar a porta 9092 para permitir tráfego. - Selecione Nenhuma Política de Segurança para Segurança.
- Selecione Tipo de acesso como Agente de Conectividade e clique em Associar grupo de agentes.
- Selecione o Agente e clique em Usar.
- Clique em Testar. Você deve receber uma mensagem de sucesso.
- Clique em Salvar.
Criar uma Integração entre o Kafka e o Oracle Autonomous Data Warehouse no Oracle Integration 3
- Na instância do Oracle Integration 3, clique no menu de hambúrguer e, em Design, selecione Integrações.
- Clique em Criar e, na caixa de diálogo Criar Integração, selecione Aplicativo.
- Informe o nome da integração como KafkaToADW e clique em Criar.
Observação:
Você observará duas conexões que criou para o Kafka e o Oracle Autonomous Data Warehouse como Triggers. - Selecione o Kafka e você será solicitado a informar um nome para o trigger, selecione Tipo de Mensagem como Consumidor e clique em Continuar.
- Selecione o tópico do Kafka na lista drop-down e forneça um nome de consumidor, deixe os campos como padrão e clique em Continuar.
- Selecione a Estrutura da Mensagem como Documento JSON de Amostra e arraste e solte o mesmo arquivo JSON.
- Na janela Resumo, verifique todos os detalhes e clique em Concluir.
- Você notará uma seta para baixo sob o Trigger que foi criado.
- Clique no ícone + e, em Chamar, selecione ADW e você verá uma caixa adicional por nome Mapa.
- Mova o mouse sobre Chamar, clique em ... e selecione Editar.
- Forneça um nome e selecione Executar uma Operação em uma Tabela para o campo Quais operações você deseja executar?, selecione Inserir e clique em Continuar.
- Selecione a tabela, clique em Continuar e, na página Resumo, clique em Finalizar.
- Em seguida, mova o mouse sobre a caixa Mapear, clique em ... e selecione Editar.
- Na página Mapeamento, conecte os campos Origem e Destino.
- Clique em Validar e ele deverá ser validado com sucesso.
- Na página Integração, clique em Salvar e isso deverá configurar a integração com sucesso.
- Na home page Integração, mova o mouse sobre o campo Status e clique no ícone Energia para ativar.
- Você verá uma janela por nome Ativar Integração, selecione Produção e clique em Ativar. Isso ativará com sucesso a integração para consumir mensagens do Kafka.
- Inicie o tópico do Kafka e você verá mensagens sendo armazenadas no banco de dados. Abra SQLDeveloper, abra a tabela e clique na guia Dados para ver as mensagens.
- Se você tiver seus próprios fluxos do Kafka, poderá começar a produzir mensagens no mesmo formato.
- Se você estiver usando o Oracle GoldenGate Stream Analytics, conecte-se via SSH à sua instância do Oracle GoldenGate Stream Analytics e vá para a pasta
/u01/app/osa/utilities/kafka-utils
. - Você pode usar
sample.json
como os dados de entrada. Use este formato json:{"fruit": "Apple","total": "Large","color": "Red"}
- Execute o seguinte comando para fazer loop no feed de dados como um tópico do Kafka:
opc@ggsanew kafka-utils]$ ./loop-file.sh ./sample.json | ./sampler.sh 1 1 | ./kafka.sh feed complex
Verifique os Dados
- Abra a console do Oracle Integration, clique em Observabilidade e selecione Integrações.
- Você verá os detalhes dos dados Recebidos, Processados e Bem-sucedidos.
- Abra o Oracle SQL Developer e verifique a tabela para confirmar se os dados estão disponíveis lá.
- Clique em Oracle Connections e selecione seu banco de dados do Oracle Autonomous Data Warehouse.
- Expanda Tabelas, selecione a tabela Amostra e você observará os dados.