1.1.1

Table Of Contents
Chapter 51
Configuration Properties
SQLFire uses JDBC connection properties, connection boot properties, and Java system properties to congure SQLFire
members and connections.
Property Types on page 319
Property Prexes on page 320
Using Non-ASCII Strings in SQLFire Property Files on page 320
List of Property Names on page 320
Conguration Property Reference on page 323
Property Types
SQLFire conguration properties are divided into the following property types:
Connection properties. Connection properties congure the features of a SQLFire member or a SQLFire client
connection when you start or connect to a SQLFire member. You can dene connection properties directly in the
JDBC connection URL (or in the "connect" command in an interactive sqlf session). You can also dene connection
properties in the sqlfire.properties le or as Java system properties. For example, use
-J-Dproperty_name=property_value when you execute a sqlf utility. Or, use the JAVA_ARGS environment variable
to dene a Java system property for an interactive sqlf session (JAVA_ARGS="-Dproperty_name=property_value").
Note: You must add a prex to certain connection property names in order to specify those properties in
sqlfire.properties or as Java system properties. See Property Prexes on page 320.
Connection properties can be further categorized as either boot properties or client properties:
Boot properties. A boot connection property congures features of a SQLFire member, and can only be applied
with the rst connection that starts a SQLFire member. You can specify boot properties when you start a SQLFire
member using the FabricServer API or sqlf command, when you make the rst connection to an embedded SQLFire
member with the JDBC embedded driver, or when you use the connect peer command from an interactive
sqlf session to start a peer client. Boot properties have no effect when they are specied on connections to a
member after the member has started. Boot properties have no effect when they are specied on a thin client
connection.
For example, the server-groups property congures a data store's server groups when the data store boots. If you
specify server-groups on any subsequent connection to the data store, the server group conguration is not
changed.
Client properties. A client connection property congures features of the client connection itself, and can be used
with the JDBC thin client drive (for example, using a JDBC thin client connection URL or the connect client
command from an interactive sqlf session).
System properties. Certain SQLFire conguration properties must be specied either in the sqlfire.properties
le or as Java system properties (using -J-Dproperty_name=property_value with a sqlf utility, or setting
319