Package io.quarkus.agroal.runtime

Interface DataSourceJdbcRuntimeConfig

public interface DataSourceJdbcRuntimeConfig

  • Method Details

    • url

      Optional<@WithConverter(io.quarkus.runtime.configuration.TrimmedStringConverter.class) String> url()
      The datasource URL

    • initialSize

      OptionalInt initialSize()
      The initial size of the pool. Usually you will want to set the initial size to match at least the minimal size, but this is not enforced so to allow for architectures which prefer a lazy initialization of the connections on boot, while being able to sustain a minimal pool size after boot.

    • minSize

      @WithDefault("0") int minSize()
      The datasource pool minimum size

    • maxSize

      @WithDefault("20") int maxSize()
      The datasource pool maximum size

    • backgroundValidationInterval

      @WithDefault("2M") Duration backgroundValidationInterval()
      The interval at which we validate idle connections in the background.

      Set to 0 to disable background validation.

    • foregroundValidationInterval

      Optional<Duration> foregroundValidationInterval()
      Perform foreground validation on connections that have been idle for longer than the specified interval.

    • acquisitionTimeout

      @WithDefault("5S") Optional<Duration> acquisitionTimeout()
      The timeout before cancelling the acquisition of a new connection

    • leakDetectionInterval

      @ConfigDocDefault("This feature is disabled by default.") Optional<Duration> leakDetectionInterval()
      The interval at which we check for connection leaks.

    • idleRemovalInterval

      @WithDefault("5M") Duration idleRemovalInterval()
      The interval at which we try to remove idle connections.

    • maxLifetime

      @ConfigDocDefault("By default, there is no restriction on the lifespan of a connection.") Optional<Duration> maxLifetime()
      The max lifetime of a connection.

    • transactionIsolationLevel

      Optional<io.agroal.api.configuration.AgroalConnectionFactoryConfiguration.TransactionIsolation> transactionIsolationLevel()
      The transaction isolation level.

    • extendedLeakReport

      @WithDefault("false") boolean extendedLeakReport()
      Collect and display extra troubleshooting info on leaked connections.

    • flushOnClose

      @WithDefault("false") boolean flushOnClose()
      Allows connections to be flushed upon return to the pool. It's not enabled by default.

    • detectStatementLeaks

      @WithDefault("true") boolean detectStatementLeaks()
      When enabled, Agroal will be able to produce a warning when a connection is returned to the pool without the application having closed all open statements. This is unrelated with tracking of open connections. Disable for peak performance, but only when there's high confidence that no leaks are happening.

    • newConnectionSql

      Optional<String> newConnectionSql()
      Query executed when first using a connection.

    • validationQuerySql

      Optional<String> validationQuerySql()
      Query executed to validate a connection.

    • validationQueryTimeout

      Optional<Duration> validationQueryTimeout()
      The timeout for the connection validation query

    • validateOnBorrow

      @WithDefault("false") boolean validateOnBorrow()
      Forces connection validation prior to acquisition (foreground validation) regardless of the idle status.

      Because of the overhead of performing validation on every call, it’s recommended to rely on default idle validation instead, and to leave this to `false`.

    • poolingEnabled

      @WithDefault("true") boolean poolingEnabled()
      Disable pooling to prevent reuse of Connections. Use this when an external pool manages the life-cycle of Connections.

    • enableRecovery

      @WithDefault("true") boolean enableRecovery()
      Whether to enable recovery for this datasource.

      Normally a transaction manager will call xa_recover () on an XA connection during recovery to obtain a list of transaction branches that are currently in a prepared or heuristically completed state. However, it can happen that multiple XA connections connect to the same datasource which would all return the same set of branches and for reasons of improved performance only one should be used for recover() calls. The default value for this configuration property is true because when there is only one connection it is vital for data consistency that the connection is able to report its list of prepared or heuristically completed branches.

    • transactionRequirement

      Optional<io.agroal.api.configuration.AgroalConnectionPoolConfiguration.TransactionRequirement> transactionRequirement()
      Require an active transaction when acquiring a connection. Recommended for production. WARNING: Some extensions acquire connections without holding a transaction for things like schema updates and schema validation. Setting this setting to STRICT may lead to failures in those cases.

    • additionalJdbcProperties

      @ConfigDocMapKey("property-key") Map<String,String> additionalJdbcProperties()
      Other unspecified properties to be passed to the JDBC driver when creating new connections.

    • telemetry

      @WithName("telemetry.enabled") @ConfigDocDefault("false if quarkus.datasource.jdbc.telemetry=false and true if quarkus.datasource.jdbc.telemetry=true") Optional<Boolean> telemetry()
      Enable OpenTelemetry JDBC instrumentation.