Utilizzo dei file di log di ripetizione del database Oracle
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Durante Change Data Capture, Datastream legge i file di log di ripristino di Oracle per monitorare le modifiche ai database di origine e replicarle nell'istanza di destinazione. Ogni database Oracle ha un insieme di file di log di ripetizione online. Tutti
i record delle transazioni nel database vengono registrati nei file. Quando il file di log
di ripristino corrente viene ruotato (o cambiato), il processo di archiviazione
copia questo file in uno spazio di archiviazione di archivio. Nel frattempo, il database promuove
un altro file da utilizzare come file corrente.
Il connettore Oracle di Datastream estrae gli eventi Change Data Capture (CDC)
dai file di log di ripetizione Oracle archiviati.
Accedere ai file redo log
Datastream può utilizzare l'API Oracle LogMiner o il metodo di lettura binaria per accedere ai file di log di ripetizione:
Oracle LogMiner: un'utilità predefinita inclusa nei database Oracle.
Se configuri Datastream in modo che utilizzi l'API Oracle LogMiner, Datastream
può funzionare solo con i file di log di ripetizione archiviati, mentre i file di log di ripetizione online non sono supportati.
Il metodo API LogMiner è single-thread ed è soggetto a latenza più elevata e
velocità effettiva inferiore quando si lavora con database di origine con un numero elevato di transazioni.
LogMiner supporta la maggior parte dei tipi di dati e delle funzionalità del database Oracle.
Lettore binario (anteprima):
un'utilità specializzata ad alte prestazioni che funziona con i file di log di ripristino online e archiviati. Il lettore binario può accedere ai file di log utilizzando Automatic Storage
Management (ASM) o leggendo i file direttamente utilizzando gli oggetti della directory del database.
Il lettore binario è multithread e supporta CDC a bassa latenza. Inoltre, ha un impatto ridotto sul database di origine, poiché i log di ripristino vengono analizzati al di fuori delle operazioni del database. Il metodo CDC del lettore binario ha un supporto limitato per determinati tipi o funzionalità di dati. Per ulteriori informazioni, vedi
Limitazioni note.
Imposta i parametri di configurazione per i file di log di ripetizione di Oracle
Questo design ha implicazioni profonde sulla potenziale latenza di Datastream. Se i file di log di ripetizione di Oracle vengono cambiati di frequente o mantenuti di dimensioni ridotte (ad esempio < 256 MB), Datastream può replicare le modifiche più rapidamente.
Esistono parametri di configurazione che puoi impostare per controllare la frequenza di rotazione dei file di log:
Dimensioni:i file di log di ripetizione online hanno una dimensione minima di 4 MB e la dimensione predefinita dipende dal sistema operativo. Puoi modificare le dimensioni dei file di log creando nuovi file di log online ed eliminando quelli meno recenti.
Per trovare le dimensioni dei file di log di ripetizione online, esegui questa query:
SELECTGROUP#,STATUS,BYTES/1024/1024MBFROMV$LOG
Time (Ora):il parametro ARCHIVE_LAG_TARGET fornisce un limite superiore alla durata (in secondi) del log corrente del database primario.
Questo non è l'orario esatto di cambio del log, perché tiene conto del tempo necessario per archiviarlo. Il valore predefinito è 0 (nessun limite superiore) ed è consigliabile un valore ragionevole pari a 1800 (o 30 minuti) o inferiore.
Puoi utilizzare i seguenti comandi per impostare il parametro ARCHIVE_LAG_TARGET, durante l'inizializzazione o mentre il database è attivo:
SHOW PARAMETER ARCHIVE_LAG_TARGET; Questo comando mostra quanti secondi impiegherà il log corrente.
ALTER SYSTEM SET ARCHIVE_LAG_TARGET = number-of-seconds; Utilizza questo comando per modificare il limite superiore.
Ad esempio, per impostare il limite superiore a 10 minuti (o 600 secondi), inserisci ALTER SYSTEM SET ARCHIVE_LAG_TARGET = 600;
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-04 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)."]]
