Database Identifier (db-uri)
The Database Uniform Resource Identifier (db-uri
) is used to identify the database name, location and communication transport to be used when opening a database. The syntax for the naming convention is:
db-uri: [ db-uri ] database_name
Database Name | Description |
---|---|
bookStore | "bookStore" on embedded TFS. |
tfs-tcp://www.raima.com/bookStore | "bookStore" using TCP/IP with the default port number at hostname "www.raima.com" |
tfs-shm://21553/bookStore | "bookStore" using default shared-memory to TFS |
tfs-shm://partition-01/bookStore | "bookStore" using shared-memory to TFS named "partition-01" |
tfs-tcp://[::1]:1530/bookStore | "bookStore" using TCP/IP IPv6 using the loopback address on port 1530 |
tfs-tcp://[fe80::40da:bf3f:ae9f:fe87]:2000/bookStore | "bookStore" using TCP/IP IPv6 to a specified machine on port 2000. |
tfs-tcp://192.168.101.139:2000/bookStore | "bookStore" using TCP/IP IPv4 to a specified machine on port 2000. |
Specifying a database name will by default open the database in the
current working directory. However, specifying a database URI will open
the database on a remote TFServer. Examples of database name or URIs:
'MY_DB', 'tfs-tcp://localhost:21553/MY_DB
', 'tfs-shm://MY_TFS/MY_DB
'
A db-uri is required for connecting to external TFS.
An empty db-uri is required to connect to an in-process TFS (embedded).