res_odbc: Add basic query logging.
[asterisk/asterisk.git] / configs / samples / res_odbc.conf.sample
1 ;;; odbc setup file
2
3 ; ENV is a global set of environmental variables that will get set.
4 ; Note that all environmental variables can be seen by all connections,
5 ; so you can't have different values for different connections.
6 [ENV]
7 ;INFORMIXSERVER => my_special_database
8 ;INFORMIXDIR => /opt/informix
9 ;ORACLE_HOME => /home/oracle
10
11 ; All other sections are arbitrary names for database connections.
12
13 ;
14 ; The context name is what will be used in other configuration files, such
15 ; as extconfig.conf and func_odbc.conf, to reference this connection.
16 [asterisk]
17 ;
18 ; Permit disabling sections without needing to comment them out.
19 ; If not specified, it is assumed the section is enabled.
20 enabled => no
21 ;
22 ; This value should match an entry in /etc/odbc.ini
23 ; (or /usr/local/etc/odbc.ini, on FreeBSD and similar systems).
24 dsn => asterisk
25 ;
26 ; Username for connecting to the database.  The user defaults to the context name if unspecified.
27 ;username => myuser
28 ;
29 ; Password for authenticating the user to the database.  The default
30 ; password is blank.
31 ;password => mypass
32 ;
33 ; Build a connection at startup?
34 pre-connect => yes
35 ;
36 ; What should we execute to ensure that our connection is still alive?  The
37 ; statement should return a non-zero value in the first field of its first
38 ; record.  The default is "select 1".
39 ;sanitysql => select 1
40 ;
41 ; The maximum number of connections to have open at any given time.
42 ; This defaults to 1 and it is highly recommended to only set this higher
43 ; if using a version of UnixODBC greater than 2.3.1.
44 ;max_connections => 20
45 ;
46 ; When the channel is destroyed, should any uncommitted open transactions
47 ; automatically be committed?
48 ;forcecommit => no
49 ;
50 ; How should we perceive data in other transactions within the database?
51 ; Possible values are read_uncommitted, read_committed, repeatable_read,
52 ; and serializable.  The default is read_committed.
53 ;isolation => repeatable_read
54 ;
55 ; Is the backslash a native escape character?  The default is yes, but for
56 ; MS SQL Server, the answer is no.
57 ;backslash_is_escape => yes
58 ;
59 ; How long (in seconds) should we attempt to connect before considering the
60 ; connection dead?  The default is 10 seconds, but you may wish to reduce it,
61 ; to increase responsiveness.
62 ;connect_timeout => 10
63 ;
64 ; When a connection fails, how long (in seconds) should we cache that
65 ; information before we attempt another connection?  This increases
66 ; responsiveness, when a database resource is not working.
67 ;negative_connection_cache => 300
68 ;
69 ; Enable query logging. This keeps track of the number of prepared queries
70 ; and executed queries as well as the query that has taken the longest to
71 ; execute. This can be useful for determining the latency with a database.
72 ; The data can be viewed using the "odbc show" CLI command.
73 ; Note that only successful queries are logged currently.
74 ;logging => yes
75 ;
76 ; Slow query limit. If a query exceeds the given amount of time (in milliseconds)
77 ; when executing then a WARNING message will be output to indicate that there
78 ; may be a problem. Note that logging must be set to "yes" for this to occur. By
79 ; default this is set to 5000 milliseconds (or 5 seconds). If you would like to
80 ; disable the WARNING message it can be set to "0".
81 ;slow_query_limit => 5000
82
83 [mysql2]
84 enabled => no
85 dsn => MySQL-asterisk
86 username => myuser
87 password => mypass
88 pre-connect => yes
89
90 ; Certain servers, such as MS SQL Server and Sybase use the TDS protocol, which
91 ; limits the number of active queries per connection to 1.
92 [sqlserver]
93 enabled => no
94 dsn => mickeysoft
95 max_connections => 5
96 username => oscar
97 password => thegrouch
98 pre-connect => yes
99 sanitysql => select count(*) from systables
100 ; forcecommit => no            ; Default to committing uncommitted transactions?
101                                ; Note:  this is NOT the autocommit flag; this
102                                ; determines the end result of transactions which
103                                ; are not explicitly committed or rolled back.  By
104                                ; default, such transactions are rolled back if the
105                                ; call ends without an explicit commit.
106 ; isolation => read_committed  ; Isolation level; supported levels are:
107                                ; read_uncommitted, read_committed, repeatable_read,
108                                ; serializable.  Note that not all databases support
109                                ; all isolation levels (e.g. Postgres only supports
110                                ; repeatable_read and serializable).  See database
111                                ; documentation for further information.
112 ;
113 ; Many databases have a default of '\' to escape special characters.  MS SQL
114 ; Server does not.
115 backslash_is_escape => no
116
117 ;
118 ; If you are having problems with concurrency, please read this note from the
119 ; mailing lists, regarding UnixODBC:
120 ;
121 ; http://lists.digium.com/pipermail/asterisk-dev/2009-February/036539.html
122 ;
123 ; In summary, try setting "Threading=2" in the relevant section within your
124 ; odbcinst.ini.
125 ;