Adicionar uma Replicação para Snowflake

Aprenda a adicionar um processo Replicat para um destino do Snowflake em uma replicação de dados do OCI GoldenGate.

Antes de começar

Verifique se as tabelas de destino existem no banco de dados do Snowflake.
Você deve ter contas de nuvem do Amazon Web Services, Google Cloud Platform ou Azure configuradas se pretende usar qualquer um dos locais de estágio externo, como S3, ADLS Gen2 ou GCS.
String de conexão do driver JDBC do Snowflake
O usuário do banco de dados usado para replicação no Snowflake deve receber os seguintes privilégios:
- INSERT, UPDATE, DELETE e TRUNCATE nas tabelas de destino.
- CREATE e DROP no estágio nomeado do Snowflake e no estágio externo.
- Se estiver usando o estágio externo (S3, ADLS, GCS), tabela externa CREATE, ALTER e DROP.
Analise Considerações sobre Configuração e Melhores Práticas para o Snowflake

Adicionar um Processo de Replicat (26ai)

Certifique-se de revisar pré-requisitos específicos para este tipo de destino.

No menu para navegação na console da implantação do OCI GoldenGate, selecione Replicat.
Na página Replicat, selecione Adicionar Replicat.
No painel Adicionar Replicat, na página Informações de Replicat, preencha os campos conforme necessário e selecione Próximo:
- Selecione um Tipo de Replicat:
  - Replicat Clássico
  - Replicat Coordenado
- Informe um Nome do Processo, com no máximo 5 caracteres.
- Informe uma Descrição para ajudar a distinguir esse processo de outros.
Na página Opções de Replicat, preencha os campos conforme necessário e selecione Próximo:
1. Para Trilha de Replicat:
  - Informe um Nome.
  - Informe um Subdiretório, se você espera que o arquivo de Trilha esteja em um local diferente do padrão.
  - Selecione um perfil de criptografia. Se um perfil de criptografia não tiver sido criado, a Wallet Local será selecionada por padrão.
  - Para Iniciar, selecione o ponto inicial para o processamento de dados:
    - Posição no Log (padrão)
    - Now
    - Horário Personalizado
2. Para Posição da Trilha:
  - Informe o Nº da Sequência.
  - Insira o Deslocamento de RBA.
3. Para Destino, selecione Snowflake na lista drop-down e selecione um dos seguintes:
  1. Streaming
  2. Preparar e mesclar e, em seguida, selecionar um local de preparação disponível
4. Para Credenciais de Destino:
  - Selecione um Domínio.
  - Selecione um Alias dentro do Domínio especificado.
  - Selecione uma Tabela de Checkpoint. Deixe a seleção padrão ou selecione a tabela de Checkpoint criada para a implantação do destino.
  - Selecione o Número Máximo de Threads (somente Replicats Coordenados).
Na página Opções Gerenciadas, preencha os campos opcionais conforme necessário e selecione Próximo:
- Selecione um Nome de Perfil, se houver um disponível.
- Ative Crítico para a integridade da implantação.
- Habilite e configure as configurações de início automático.
Na página Arquivo de Parâmetro, você pode adicionar parâmetros para configurar ainda mais seu processo Replicat. Por exemplo:
```
table source.table1;
```
Observação:

O GoldenGate usa o GTM (Greenwich Mean Time, Tempo médio de Greenwich) por padrão. Use SETENV para substituir a definição padrão do processo de Replicat. Esta alteração não se aplica a implantações. Por exemplo:
```
setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")
```
(Opcional) Na página Properties File, revise a propriedade:
- jvm.bootoptions: Aumente o valor de -Xmx se precisar adicionar mais memória à JVM de Replicat (-Xmx16g para usar até 16 GB de memória, -Xmx32g para até 32 GB e assim por diante).
  Observação: Um Handler de Streaming do Snowflake relacionado a um problema conhecido falha com o erro Exception: java.lang.StackOverflowError thrown from the UncaughtExceptionHandler in thread "process reaper". Para solucionar esse problema, adicione o seguinte ao arquivo de propriedades do Replicat:
```
jvm.bootoptions= -Djdk.lang.processReaperUseDefaultStackSize=true
```
Para obter informações sobre as propriedades deste destino e saber as diferenças entre os Handlers de Estágio e Mesclagem e Streaming, consulte Snowflake no guia Oracle GoldenGate for Distributed Applications and Analytics.
Selecione Criar e Executar. Se você selecionar Criar, poderá iniciar manualmente o processo Replicat posteriormente na página Replicats.

Adicionar um Processo de Replicat (21c)

Para adicionar um processo Replicat para Snowflake no Oracle GoldenGate 21c:

Na console de implantação da OCI GoldenGate, na página Visão Geral do Serviço de Administração, selecione Adicionar Replicat (ícone de adição).
Na página Adicionar Processo de Replicat, selecione um tipo de Processo de Replicat e, em seguida, selecione Próximo

Os tipos de Replicats são:
- Replicat Clássico
- Replicat Coordenado
Na página Opções de Replicação, preencha os seguintes campos e selecione Próximo:
1. Para Nome do Processo, informe um nome para o processo de Replicat.
2. Para Nome da Trilha, informe o nome da trilha de dois caracteres.
3. Para Destino, selecione a conexão Snowflake de destino no menu suspenso.
4. Para Apelidos Disponíveis, selecione seu alias no menu suspenso.
5. (Opcional) Ativar armazenamento externo para selecionar um local de preparação disponível no menu suspenso.
Na página Parâmetros de Replicat, adicione os mapeamentos necessários e selecione Próximo:
Observação:
- Se estiver usando o Replicat Coordenado, adicione os seguintes parâmetros na segunda linha do Arquivo de Parâmetros:
```
TARGETDB LIBFILE libggjava.so SET property=/u02/Deployment/etc/conf/ogg/.properties
```
O uso de replicat coordenado resultará na criação de vários arquivos. Se omitido, você encontrará o seguinte erro:
```
OGG-01091 Oracle GoldenGate Delivery, RSNOW.prm: Unable to open file "/u02/Deployment/etc/conf/ogg/001.properties" (error 2, No such file or directory).
```
- Se houver operações de mesclagem de longa duração no Snowflake e um grande número de bloqueios for observado, certifique-se de que nenhuma outra tabela esteja modificando a mesma tabela. Além disso, use replicat coordenado com cautela, pois pode levar a um alto número de bloqueios de tabela.
- O GoldenGate usa o GTM (Greenwich Mean Time, Tempo médio de Greenwich) por padrão. Use SETENV para substituir a definição padrão do processo de Replicat. Esta alteração não se aplica a implantações. Por exemplo:
```
setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")
```
Saiba mais sobre SETENV.
(Opcional) Na página Properties File, revise as seguintes propriedades:

Observação: essas propriedades são definidas quando você criou a conexão e não devem ser modificadas aqui.
- ggs.eventhandler.snowflake.connectionURL: URL JDBC para estabelecer conexão com o Snowflake.
- ggs.eventhandler.snowflake.UserName: Nome de usuário do banco de dados do Snowflake.
- ggs.eventhandler.snowflake.Password: Senha associada ao usuário do banco de dados do Snowflake.
- ggs.eventhandler.snowflake.storageIntegration: A credencial do data warehouse do Snowflake para acessar os respectivos arquivos do Object Store. Para obter mais informações, consulte Integração de armazenamento Snowflake.
- jvm.bootoptions: Aumente o valor de -Xmx se precisar adicionar mais memória à JVM de Replicat (-Xmx16g para usar até 16 GB de memória, -Xmx32g para até 32 GB e assim por diante.)
Selecione Criar e Executar. Se você selecionar Criar, poderá iniciar manualmente o processo Replicat posteriormente na página Visão Geral do Serviço de Administração.

Você retorna à página Visão Geral do Serviço de Administração na qual pode exibir a criação do processo Replicat e acessar Ações do Replicat.

Detalhes do alvo do Snowflake

Problemas conhecidos

Bug 37518857: OGGDAA GGS Snowflake Streaming Replicat erro

O Handler de Streaming do Snowflake falha com: Exception: java.lang.StackOverflowError thrown from the UncaughtExceptionHandler in thread "process reaper"

Solução alternativa: adicione o seguinte ao arquivo de Propriedades do Replicat:

jvm.bootoptions= -Djdk.lang.processReaperUseDefaultStackSize=true