Trabalhar com arquivos de registros que refazem o banco de dados da Oracle
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Durante a captura de dados alterados, o Datastream lê arquivos de redo log do Oracle para monitorar mudanças nos bancos de dados de origem e replicá-las na instância de destino. Cada banco de dados Oracle tem um conjunto de arquivos de registros refazer on-line. Todos os registros de transações no banco de dados são salvos nos arquivos. Quando o arquivo de registros refazer atual é alternado (ou trocado), o processo de arquivamento copia esse arquivo em um armazenamento. Enquanto isso, o banco de dados promove
outro arquivo para servir como o arquivo atual.
O conector Oracle do Datastream extrai eventos de captura de dados alterados (CDC)
dos arquivos de registros redo da Oracle.
Acessar arquivos de refazer registros
O Datastream pode usar a API Oracle LogMiner ou o método de leitura binária para acessar os arquivos de registro "redo":
Oracle LogMiner: um utilitário pronto para uso incluído nos bancos de dados Oracle.
Se você configurar o Datastream para usar a API Oracle LogMiner, ele só poderá trabalhar com arquivos de registro "redo" arquivados. Os arquivos de registro "redo" on-line não são compatíveis.
O método da API LogMiner é de uma única linha de execução e está sujeito a maior latência e menor capacidade ao trabalhar com bancos de dados de origem de grande número de transações.
O LogMiner é compatível com a maioria dos tipos de dados e recursos do banco de dados Oracle.
Leitor binário (versão prévia):
um utilitário especializado de alto desempenho que funciona com arquivos de
registro de refazer on-line e arquivados. O leitor binário pode acessar os arquivos de registro usando o gerenciamento automático de armazenamento (ASM, na sigla em inglês) ou lendo os arquivos diretamente com objetos de diretório do banco de dados.
O leitor binário é multithread e oferece suporte à CDC de baixa latência. Além disso, ele cria um impacto baixo no banco de dados de origem, já que os registros de refazer são analisados fora das operações do banco de dados. O método CDC do leitor binário tem suporte limitado para determinados tipos ou recursos de dados. Para mais informações, consulte
Limitações conhecidas.
Definir parâmetros de configuração para arquivos de refazer do Oracle
Esse projeto tem implicações profundas na possível latência do Datastream. Se os arquivos de redo logs da Oracle forem alterados com frequência ou mantidos em tamanho menor (por exemplo, < 256 MB), o Datastream poderá replicar alterações mais rapidamente.
Existem parâmetros de configuração que você pode definir para controlar a frequência de rotação do arquivo de registros:
Tamanho: os arquivos de registros de refazer on-line têm um tamanho mínimo de 4 MB, e o tamanho padrão depende do sistema operacional. Para modificar o tamanho dos arquivos de registros, crie novos arquivos de registros on-line e solte os mais antigos.
Para encontrar o tamanho dos arquivos de registros refazer on-line, execute a seguinte consulta:
SELECTGROUP#,STATUS,BYTES/1024/1024MBFROMV$LOG
Tempo: o parâmetro ARCHIVE_LAG_TARGET fornece um limite superior de quanto tempo (em segundos) o registro atual do banco de dados primário pode abranger.
Esse não é o horário exato da alternância do registro, pois considera o tempo necessário para arquivar o registro. O valor padrão é 0 (sem limite superior), e um valor razoável de 1800 (ou 30 minutos) ou menos é sugerido.
Use os seguintes comandos para definir o parâmetro ARCHIVE_LAG_TARGET durante a inicialização ou enquanto o banco de dados está ativo:
SHOW PARAMETER ARCHIVE_LAG_TARGET; Esse comando exibe o número de segundos de duração do registro atual.
ALTER SYSTEM SET ARCHIVE_LAG_TARGET = number-of-seconds; Use este comando para alterar o limite superior.
Por exemplo, para definir o limite máximo como 10 minutos (ou 600 segundos), insira ALTER SYSTEM SET ARCHIVE_LAG_TARGET = 600;.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-12 UTC."],[[["\u003cp\u003eDatastream utilizes Oracle redo log files to capture changes in source databases and replicate them to the destination instance.\u003c/p\u003e\n"],["\u003cp\u003eDatastream can access redo logs using either the Oracle LogMiner API, which only supports archived files and is single-threaded, or the binary reader method, which supports both online and archived files and is multi-threaded.\u003c/p\u003e\n"],["\u003cp\u003eThe frequency of Oracle redo log file switching, controlled by size and time parameters, significantly impacts Datastream's latency, with smaller, more frequently switched files enabling faster replication.\u003c/p\u003e\n"],["\u003cp\u003eConfiguration parameters, including file size (ideally under 1GB) and the \u003ccode\u003eARCHIVE_LAG_TARGET\u003c/code\u003e parameter (recommended to be 1800 seconds or less), can be adjusted to optimize redo log file rotation for Datastream's performance.\u003c/p\u003e\n"],["\u003cp\u003eWhile manual switching of redo log files via \u003ccode\u003eALTER SYSTEM SWITCH LOGFILE;\u003c/code\u003e is possible for testing, it is not recommended for production due to required privileges and performance impact on the database.\u003c/p\u003e\n"]]],[],null,["# Work with Oracle database redo log files\n\nDuring change data capture, Datastream reads Oracle redo log files to\nmonitor your source databases for changes and replicate them to the destination\ninstance. Each Oracle database has a set of online redo log files. All\ntransaction records on the database are recorded in the files. When the current\nredo log file is rotated (or switched), the archive process\n[copies this file into an archive storage](https://docs.oracle.com/cd/B19306_01/server.102/b14231/archredo.htm#i1006148). Meanwhile, the database promotes\nanother file to serve as the current file.\n\nDatastream Oracle connector extracts change data capture (CDC) events\nfrom **archived** Oracle redo log files.\n\nAccess redo log files\n---------------------\n\nDatastream can use the Oracle LogMiner API or the binary\nreader method to access the redo log files:\n\n- **Oracle LogMiner** : an out-of-the-box utility included in Oracle databases.\n If you configure Datastream to use Oracle LogMiner API, Datastream\n can only work with *archived* redo log files, online redo log files aren't supported.\n The LogMiner API method is single-threaded and is subject to higher latency and\n lower throughput when working with large transaction number source databases.\n LogMiner supports most data types and Oracle database features.\n\n- **Binary reader** ([Preview](/products#product-launch-stages)):\n a specialized, high-performance utility that works with both online and archived\n redo log files. Binary reader can access the log files using Automatic Storage\n Management (ASM) or by reading the files directly using database directory objects.\n Binary reader is multithreaded and supports low-latency CDC. It also creates low\n impact on the source database as redo logs are parsed outside of the database\n operations. The binary reader CDC method has limited support for certain data\n types or features. For more information, see\n [Known limitations](/datastream/docs/sources-oracle#binary-reader-limitations).\n\nSet configuration parameters for Oracle redo log files\n------------------------------------------------------\n\nThis design has profound implications on Datastream's potential latency. If Oracle's redo log files are switched frequently or kept to a smaller size (for example, \\\u003c 256MB), Datastream can replicate changes faster.\n\nThere are configuration parameters that you can set to control the log file rotation frequency:\n\n- **Size:** Online redo log files have a minimum size of 4 MB, and the default size is dependent on your operating system. You can modify the size of the log files by creating new online log files and dropping the older log files.\n\n To find the size of the online redo log files, run the following query: \n\n ```sql\n SELECT GROUP#, STATUS, BYTES/1024/1024 MB FROM V$LOG\n ```\n | Generating very large log files might cause Datastream to time out, which can lead to stream failure. The recommended redo log file size is below 1GB.\n |\n | For information about resizing redo logs for a self-hosted Oracle instance, see [How to resize redo logs in Oracle](https://logic.edchen.org/how-to-resize-redo-logs-in-oracle).\n |\n | For information about resizing redo logs for an Amazon RDS Oracle instance, see [Resizing online redo logs](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Appendix.Oracle.CommonDBATasks.Log.html#Appendix.Oracle.CommonDBATasks.ResizingRedoLogs).\n- **Time:** The `ARCHIVE_LAG_TARGET` parameter provides an upper limit of how long (in seconds) the current log of the primary database can span.\n\n This isn't the exact log switch time, because it takes into account how long it will take to archive the log. The default value is `0` (no upper bound), and a reasonable value of `1800` (or 30 minutes) or less is suggested.\n\n You can use the following commands to set the `ARCHIVE_LAG_TARGET` parameter, either during initialization or while the database is up:\n - `SHOW PARAMETER ARCHIVE_LAG_TARGET;` This command displays how many seconds it will take for the current log to span.\n - `ALTER SYSTEM SET ARCHIVE_LAG_TARGET = `\u003cvar translate=\"no\"\u003enumber-of-seconds\u003c/var\u003e`;` Use this command to change the upper limit.\n\n For example, to set the upper limit to 10 minutes (or 600 seconds), enter `ALTER SYSTEM SET ARCHIVE_LAG_TARGET = `\u003cvar translate=\"no\"\u003e600\u003c/var\u003e`;`\n| You can switch the redo log files manually by running the following command:\n|\n| `ALTER SYSTEM SWITCH LOGFILE;`\n|\n| Although using this command is effective for testing purposes, we don't recommend it for production use-cases because of the privileges it requires and the significant performance impact on the database.\n\nWhat's next\n-----------\n\n- Learn more about [Oracle as a source](/datastream/docs/sources-oracle).\n- Learn more about [configuring a source Oracle database](/datastream/docs/configure-your-source-oracle-database)."]]