WildFly 12.0 Model Reference

  1. WildFly 12.0
  2. deployment
  3. subdeployment
  4. subsystem=datasources
  5. data-source

A JDBC data-source configuration

Children (1)

  • connection-properties The connection-properties element allows you to pass in arbitrary connection properties to the Driver.connect(url, props) method

Attributes (62)

  • allocation-retry The allocation retry element indicates the number of times that allocating a connection should be tried before throwing an exception
    • Attribute Value
    Type INT
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • allocation-retry-wait-millis The allocation retry wait millis element specifies the amount of time, in milliseconds, to wait between retrying to allocate a connection
    • Attribute Value
    Type LONG
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • allow-multiple-users Specifies if multiple users will access the datasource through the getConnection(user, password) method and hence if the internal pool type should account for that
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • authentication-context The Elytron authentication context which defines the javax.security.auth.Subject that is used to distinguish connections in the pool.
    • Attribute Value
    Capability reference
    Type STRING
    Nillable true
    Expressions Allowed false
    Storage runtime
    Access Type read-only
  • background-validation An element to specify that connections should be validated on a background thread versus being validated prior to use. Changing this value can be done only on disabled datasource, requires a server restart otherwise.
    • Attribute Value
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • background-validation-millis The background-validation-millis element specifies the amount of time, in milliseconds, that background validation will run. Changing this value can be done only on disabled datasource, requires a server restart otherwise
    • Attribute Value
    Type LONG
    Nillable true
    Expressions Allowed true
    Min 1
    Max 2,147,483,647
    Unit MILLISECONDS
    Storage runtime
    Access Type read-only
  • blocking-timeout-wait-millis The blocking-timeout-millis element specifies the maximum time, in milliseconds, to block while waiting for a connection before throwing an exception. Note that this blocks only while waiting for locking a connection, and will never throw an exception if creating a new connection takes an inordinately long time
    • Attribute Value
    Type LONG
    Nillable true
    Expressions Allowed true
    Unit MILLISECONDS
    Storage runtime
    Access Type read-only
  • capacity-decrementer-class Class defining the policy for decrementing connections in the pool
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • capacity-decrementer-properties Properties to be injected in class defining the policy for decrementing connections in the pool
    • Attribute Value
    Type OBJECT
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • capacity-incrementer-class Class defining the policy for incrementing connections in the pool
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • capacity-incrementer-properties Properties to be injected in class defining the policy for incrementing connections in the pool
    • Attribute Value
    Type OBJECT
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • check-valid-connection-sql Specify an SQL statement to check validity of a pool connection. This may be called when managed connection is obtained from the pool
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • connectable Enable the use of CMR. This feature means that a local resource can reliably participate in an XA transaction.
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • connection-listener-class Speciefies class name extending org.jboss.jca.adapters.jdbc.spi.listener.ConnectionListener that provides a possible to listen for connection activation and passivation in order to perform actions before the connection is returned to the application or returned to the pool.
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • connection-listener-property Properties to be injected in class specidied in connection-listener-class
    • Attribute Value
    Type OBJECT
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • connection-url The JDBC driver connection URL
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • credential-reference Credential (from Credential Store) to authenticate on data source
    • Attribute Value
    Type OBJECT
    Nillable true
    Expressions Allowed false
    Storage runtime
    Access Type read-only
  • datasource-class The fully qualified name of the JDBC datasource class
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • driver-class The fully qualified name of the JDBC driver class
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • driver-name Defines the JDBC driver the datasource should use. It is a symbolic name matching the the name of installed driver. In case the driver is deployed as jar, the name is the name of deployment unit
    • Attribute Value
    Type STRING
    Nillable false
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • elytron-enabled Enables Elytron security for handling authentication of connections. The Elytron authentication-context to be used will be current context if no context is specified (see authentication-context).
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • enabled Specifies if the datasource should be enabled. Note this attribute will not be supported runtime in next versions.
    • Deprecated Since 3.0.0
    Specifies if the datasource should be enabled. Note this attribute will not be supported runtime in next versions.
    Attribute Value
    Default Value true
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • enlistment-trace Defines if WildFly/IronJacamar should record enlistment traces
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • exception-sorter-class-name An org.jboss.jca.adapters.jdbc.ExceptionSorter that provides an isExceptionFatal(SQLException) method to validate if an exception should broadcast an error
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • exception-sorter-properties The exception sorter properties
    • Attribute Value
    Type OBJECT
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • flush-strategy Specifies how the pool should be flush in case of an error.
    • Attribute Value
    Default Value FailingConnectionOnly
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
    Allowed Values FailingConnectionOnly
    InvalidIdleConnections
    IdleConnections
    Gracefully
    EntirePool
    AllInvalidIdleConnections
    AllIdleConnections
    AllGracefully
    AllConnections
  • idle-timeout-minutes The idle-timeout-minutes elements specifies the maximum time, in minutes, a connection may be idle before being closed. The actual maximum time depends also on the IdleRemover scan time, which is half of the smallest idle-timeout-minutes value of any pool. Changing this value can be done only on disabled datasource, requires a server restart otherwise.
    • Attribute Value
    Type LONG
    Nillable true
    Expressions Allowed true
    Min 0
    Max 2,147,483,647
    Unit MINUTES
    Storage runtime
    Access Type read-only
  • initial-pool-size The initial-pool-size element indicates the initial number of connections a pool should hold.
    • Attribute Value
    Default Value 0
    Type INT
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • jndi-name Specifies the JNDI name for the datasource
    • Attribute Value
    Type STRING
    Nillable false
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • jta Enable JTA integration
    • Attribute Value
    Default Value true
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • max-pool-size The max-pool-size element specifies the maximum number of connections for a pool. No more connections will be created in each sub-pool
    • Attribute Value
    Default Value 20
    Type INT
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • mcp Defines the ManagedConnectionPool implementation, f.ex. org.jboss.jca.core.connectionmanager.pool.mcp.SemaphoreArrayListManagedConnectionPool
    • Attribute Value
    Default Value org.jboss.jca.core.connectionmanager.pool.mcp.SemaphoreConcurrentLinkedDequeManagedConnectionPool
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • min-pool-size The min-pool-size element specifies the minimum number of connections for a pool
    • Attribute Value
    Default Value 0
    Type INT
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • new-connection-sql Specifies an SQL statement to execute whenever a connection is added to the connection pool
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • password Specifies the password used when creating a new connection
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • pool-fair Defines if pool use should be fair
    • Attribute Value
    Default Value true
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • pool-prefill Should the pool be prefilled. Changing this value can be done only on disabled datasource, requires a server restart otherwise.
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • pool-use-strict-min Specifies if the min-pool-size should be considered strictly
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • prepared-statements-cache-size The number of prepared statements per connection in an LRU cache
    • Attribute Value
    Type LONG
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • query-timeout Any configured query timeout in seconds. If not provided no timeout will be set
    • Attribute Value
    Type LONG
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • reauth-plugin-class-name The fully qualified class name of the reauthentication plugin implementation
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • reauth-plugin-properties The properties for the reauthentication plugin
    • Attribute Value
    Type OBJECT
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • security-domain Specifies the PicketBox security domain which defines the PicketBox javax.security.auth.Subject that are used to distinguish connections in the pool
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • set-tx-query-timeout Whether to set the query timeout based on the time remaining until transaction timeout. Any configured query timeout will be used if there is no transaction
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • share-prepared-statements Whether to share prepared statements, i.e. whether asking for same statement twice without closing uses the same underlying prepared statement
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • spy Enable spying of SQL statements
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • stale-connection-checker-class-name An org.jboss.jca.adapters.jdbc.StaleConnectionChecker that provides an isStaleConnection(SQLException) method which if it returns true will wrap the exception in an org.jboss.jca.adapters.jdbc.StaleConnectionException
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • stale-connection-checker-properties The stale connection checker properties
    • Attribute Value
    Type OBJECT
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • statistics-enabled Define whether runtime statistics are enabled or not.
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • track-statements Whether to check for unclosed statements when a connection is returned to the pool, result sets are closed, a statement is closed or return to the prepared statement cache. Valid values are: "false" - do not track statements, "true" - track statements and result sets and warn when they are not closed, "nowarn" - track statements but do not warn about them being unclosed
    • Attribute Value
    Default Value NOWARN
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • tracking Defines if IronJacamar should track connection handles across transaction boundaries
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • transaction-isolation Set the java.sql.Connection transaction isolation level. Valid values are: TRANSACTION_READ_UNCOMMITTED, TRANSACTION_READ_COMMITTED, TRANSACTION_REPEATABLE_READ, TRANSACTION_SERIALIZABLE and TRANSACTION_NONE. Different values are used to set customLevel using TransactionIsolation#customLevel
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • url-delimiter Specifies the delimiter for URLs in connection-url for HA datasources
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • url-selector-strategy-class-name A class that implements org.jboss.jca.adapters.jdbc.URLSelectorStrategy
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • use-ccm Enable the use of a cached connection manager
    • Attribute Value
    Default Value true
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • use-fast-fail Whether to fail a connection allocation on the first try if it is invalid (true) or keep trying until the pool is exhausted of all potential connections (false)
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • use-java-context Setting this to false will bind the datasource into global JNDI
    • Attribute Value
    Default Value true
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • use-try-lock Any configured timeout for internal locks on the resource adapter objects in seconds
    • Attribute Value
    Type LONG
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • user-name Specify the user name used when creating a new connection
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • valid-connection-checker-class-name An org.jboss.jca.adapters.jdbc.ValidConnectionChecker that provides an isValidConnection(Connection) method to validate a connection. If an exception is returned that means the connection is invalid. This overrides the check-valid-connection-sql element
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • valid-connection-checker-properties The valid connection checker properties
    • Attribute Value
    Type OBJECT
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only
  • validate-on-match The validate-on-match element specifies if connection validation should be done when a connection factory attempts to match a managed connection. This is typically exclusive to the use of background validation
    • Attribute Value
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage runtime
    Access Type read-only

Operations (6)