Pré-requisitos para Configuração do Serviço Data Streams
Conclua a preparação a seguir antes de criar um Fluxo de Dados. A maioria dos problemas de conexão e payload se origina na trilha de origem, na configuração de segurança ou no design do checkpoint do consumidor, em vez de no código WebSocket.
Lista de verificação de implementação
Certifique-se de que as seguintes ações estejam em vigor antes de configurar o serviço Data Streams no Oracle GoldenGate:
-
Um processo Extract ou GoldenGate upstream em execução grava as tabelas e operações necessárias em uma trilha que o Serviço de Distribuição pode ler.
-
A trilha mantém histórico suficiente para cobrir a maior janela de interrupção e recuperação esperada do consumidor.
-
O log complementar e a configuração do Extract capturam as imagens anteriores, as colunas-chave, os valores de LOB, a DDL, os tokens e outros dados exigidos pelo consumidor.
-
O nome do Fluxo de Dados, o nome da trilha de origem e o subdiretório de trilha opcional são conhecidos.
-
O cliente pode resolver e acessar o Serviço de Distribuição ou o ponto final de serviço gerenciado na porta necessária.
-
O cliente confia na cadeia de certificados do servidor para
wss, e os certificados do cliente estão disponíveis quando o TLS mútuo é necessário. -
Uma conta GoldenGate com a atribuição necessária está disponível para administração REST e autenticação WebSocket.
-
O consumidor tem armazenamento de ponto de verificação durável e uma estratégia para gravações idempotentes ou atômicas downstream.
-
O tamanho da carga útil, o tratamento de LOB, a evolução do esquema e os requisitos de CloudEvents foram acordados com os proprietários downstream.
Atribuições da API REST
A tabela a seguir lista os privilégios necessários para executar diferentes ações para configurar um Fluxo de Dados:
| Operação | Função mínima |
|---|---|
| Listar Fluxos de Dados | Usuário |
| Recuperar AsyncAPI YAML | Usuário |
| Recuperar uma configuração de Fluxo de Dados | Operador |
| Crie, atualize ou exclua um Fluxo de Dados | Administrador |
| Atualizar AsyncAPI YAML | Administrador |
Requisitos de trilha de origem
O serviço Data Streams só pode publicar informações presentes na trilha de origem. Criar um Fluxo de Dados não adiciona log de origem, reconstrói omitido antes das imagens ou recupera colunas que o Extract não capturou. Verifique o conteúdo da trilha antes de depurar o consumidor.
| Exigência do consumidor | Requisito do lado da origem |
|---|---|
| Linha completa antes e depois das imagens | Configure o log do banco de dados e as opções de imagem Extract para que a trilha contenha as colunas necessárias. |
| Atualização/exclusão de identidade confiável | Capture uma chave primária, uma chave exclusiva ou colunas de chave GoldenGate aprovadas. |
| Eventos DDL | Ative e valide a captura de DDL para a configuração de origem e Extract. |
| Valores de LOB grandes | Capture dados de LOB e defina o Fluxo de Dados maxLobSize e maxRecordSize adequadamente. |
| Agrupamento de transações | Inclua xid, opSeqno e transInd; entenda que a filtragem pode remover operações de uma transação. |
| Identificador de commit no nível da origem | Inclua csn. Trate seu valor como uma string dependente da origem. |