|
|
|
|
|
An optional user name. The password for the user is specified in parameters if needed. The “@” character must be used to delimit the user name even if no host is specified.
|
|
A server where the database is located. The local machine is assumed if host is not specified. Host can be a machine name, an IP address, or the keyword “localhost.”
Note: host is a required element if the URI is accessing a database on a Linux operating system.
|
|
|
|
•
|
table=table – specifies a specific SQL table name. The table name must exist in DDFs for the database.
|
•
|
dbfile=file – name of a file whose location is relative to the data file location entry in DBNAMES.CFG for the current database. Since a relative location is specified, the use of drive letters, full or UNC paths is not permitted. The database engine resolves the full file name. The Pervasive PSQL client does not manipulate file in any manner. Embedded spaces are permitted and are escaped by the database engine.
|
•
|
file=file – specifies a specific data file name. The Pervasive PSQL client normalizes file and replaces the input name with the resultant fully qualified UNC name in the URI before sending the request to the database engine. Drive letters may be used and, if present, are interpreted as client-side drives. Using a UNC path is also permitted, as are embedded spaces.
|
•
|
pwd=password – clear text password. The Pervasive PSQL client changes clear text passwords into encrypted passwords before transmission.
|
|
As with any URI, certain non-alphanumeric characters have special significance in the URI syntax. If you wish to use one of these characters within one of the elements in the URI, you must use an escape sequence to identify the character as actual text rather than a special character. An escape sequence is simply another special character or character combination that represents the plain text equivalent of a special character.
Note that an empty user name or password is different than no user name or password. For example, btrv://@host/ has an empty user name, while
btrv://host/ has no user name, and
btrv://foo@host/?pwd= has a user name of “foo” with an empty password.
Some URIs allow the use of user:
password syntax. However, the password is then transmitted as clear text. To prevent the transmission of the password as clear text, the Pervasive PSQL database URI ignores the password if one is provided using the
user:
password syntax. Use the
pwd= parameter to provide a password, which the Pervasive PSQL client changes into an encrypted password before transmission.
Some URIs allow for server based naming authority with a syntax of user@
host:
port. The Pervasive PSQL database URI does support specifying a
port element.