About

The FreeSWITCH core provides the API for modules to make connections to databases.

DSN

Data Source Names. Database connections are defined with DSN in XML configuration parameters like "core-db-dsn" and "odbc-dsn".

Format

The generic DSN format is <type>://<connection string>

Types

FreeSWITCH currently supports the following DSN types:

• PostgreSQL in the core
• ODBC in the core
• SQLite

SQLite

sqlite://filename
sqlite:///usr/local/freeswitch/db/mega.db

PostgreSQL

pgsql://hostaddr=127.0.0.1 dbname=freeswitch user=freeswitch password= options='-c client_min_messages=NOTICE' application_name='freeswitch'"

ODBC

Upon the addition of multiple core database options (PostgreSQL, ODBC, SQLite), the format for the DSN changed so that FreeSWITCH knows which database type to use.

The following DSN (data source name) formats are valid for ODBC databases:

DSN with username and password

<param name="core-db-dsn" value="database:username:password"/>

or
<param name="core-db-dsn" value="odbc://database:username:password"/>

DSN with username

Note the colon at the end.

<param name="core-db-dsn" value="database:username:"/>

or
<param name="core-db-dsn" value="odbc://database:username"/>

DSN only

Note the two colons at the end.

 <param name="core-db-dsn" value="database::"/>

or
<param name="core-db-dsn" value="odbc://database"/> 

No DSN

DSN-less connections are also possible. Such connections don't require configuration in odbc.ini.

Essentially the syntax is the same options you would have in odbc.ini name-value pairs, separated by ; (semicolon)

MyODBC example (OPTION=67108864 enables batched statements):

<param name="core-db-dsn" value="odbc://DRIVER=mysql;SERVER=a.b.c.d;UID=username;PWD=secretpassword;DATABASE=freeswitch;OPTION=67108864">

See Also

Tag Databases