Cross plugin compatibility

This document is part of the Compatibility Guide and explains compatibility between various plugins. While combining plugins in a single driver configuration is common, some plugins may not work properly together. Such incompatibilities can arise from either plugin design constraints or logical conflicts.

For example, the failover plugin is incompatible with failover2. Both plugins support database cluster failover but implement this functionality differently. Combining them in a single configuration causes interference between their operations, leading to instability.

Similarly, the limitless plugin and customEndpoint plugin are incompatible because Limitless Database does not support custom endpoints.

Plugin codes / Plugin codes	efm	efm2	failover	failover2	gdbFailover
efm2	✗
failover	✓	✓
failover2	✓	✓	✗
gdbFailover	✓	✓	✗	✗
iam	✓	✓	✓	✓	✓
awsSecretsManager	✓	✓	✓	✓	✓
awsSecretsManager2	✓	✓	✓	✓	✓
federatedAuth	✓	✓	✓	✓	✓
okta	✓	✓	✓	✓	✓
readWriteSplitting	✓	✓	✓	✓	✓
autoReadWriteSplitting	✓	✓	✓	✓	✓
srw	✓	✓	✓	✓	✓
gdbReadWriteSplitting	✓	✓	✓	✓	✓
customEndpoint	✓	✓	✓	✓	✓
auroraConnectionTracker	✓	✓	✓	✓	✓
initialConnection	✓	✓	✓	✓	✓
auroraStaleDns	✓	✓	✓	✓	✓
connectTime	✓	✓	✓	✓	✓
fastestResponseStrategy	✓	✓	✓	✓	✓
limitless	✓	✓	✗	✗	✗
bg	✓	✓	✓	✓	✓

Plugin codes / Plugin codes	iam	awsSecretsManager	awsSecretsManager2	federatedAuth	okta
awsSecretsManager	✗
awsSecretsManager2	✗	✗
federatedAuth	✗	✗	✗
okta	✗	✗	✗	✗
readWriteSplitting	✓	✓	✓	✓	✓
autoReadWriteSplitting	✓	✓	✓	✓	✓
srw	✓	✓	✓	✓	✓
gdbReadWriteSplitting	✓	✓	✓	✓	✓
customEndpoint	✓	✓	✓	✓	✓
auroraConnectionTracker	✓	✓	✓	✓	✓
initialConnection	✓	✓	✓	✓	✓
auroraStaleDns	✓	✓	✓	✓	✓
connectTime	✓	✓	✓	✓	✓
fastestResponseStrategy	✓	✓	✓	✓	✓
limitless	✓	✓	✓	✓	✓
bg	✓	✓	✓	✓	✓

Plugin codes / Plugin codes	readWriteSplitting	autoReadWriteSplitting	srw	gdbReadWriteSplitting
autoReadWriteSplitting	✗
srw	✗	✗
gdbReadWriteSplitting	✗	✗	✗
customEndpoint	✓	✓	✓	✓
auroraConnectionTracker	✓	✓	✓	✓
initialConnection	✓	✓	✗	✓
auroraStaleDns	✓	✓	✗	✗
connectTime	✓	✓	✓	✓
fastestResponseStrategy	✓	✓	✓	✓
limitless	✗	✗	✗	✗
bg	✓	✓	✓	✓

Plugin codes / Plugin codes	customEndpoint	auroraConnectionTracker	initialConnection	auroraStaleDns
auroraConnectionTracker	✓
initialConnection	✓	✓
auroraStaleDns	✓	✓	✗
connectTime	✓	✓	✗	✓
fastestResponseStrategy	✓	✓	✓	✓
limitless	✗	✗	✗	✗
bg	✓	✓	✓	✓

Plugin codes / Plugin codes	connectTime	fastestResponseStrategy	limitless	bg
fastestResponseStrategy	✓
limitless	✓	✗
bg	✓	✓	✗