Purpose

Specifies the file name prefix the driver uses to create or locate the set of files that define the embedded database per connection. See Mapping Objects to Tables for an explanation of embedded database.

Valid Values

prefix | path+prefix

Behavior

prefix is the file name prefix for the embedded database. For example, if DatabaseName is set to a value of JohnQPublic, the embedded database files that are created or loaded have the form johnqpublic.xxx.

path+prefix is a relative or absolute path appended to the file name prefix. The path defines the directory the driver uses to store the newly created database files or locate the existing database files. For example, if DatabaseName is set to a value of C:\data\db\johnqpublic, the driver either creates or looks for the database johnqpublic.xxx in the directory C:\data\db. If you do not specify a path, the current working directory is used.

Notes

  • The driver parses the UserId value and removes all non-alphanumeric characters. For example, if the User ID is John.Q.Public, the value used for DatabaseName is JohnQPublic.

Default

User ID specified for the connection.

Data Type

String

Alias

Database property. If both the Database and DatabaseName properties are specified in a connection URL, the last property that is positioned in the connection URL takes precedence.