Information on how to run SQL queries on the CUCM itself please

Question

Good Day All,
I need to run an sql query on the CUCM to list all of my directory numbers, their partition, and their external mask values.
I came across this excerpt below earlier so I have a bit of an idea how to do it but iw would be great to see some other examples of sql queries.
Any assistance is most appreciated.
Also, is there a document somewhere to tell me how to run these queries?
Thanks in advance
Regards
Amanda
Currently Being Moderated
05/04/2011 5:18 AM (in response to Joshua Royle)
Re: Is there a way of pulling a report off CM showing all phones that have diverts on?
Try if running this SQL query from the CLI helps you, it should list all DN's that have CFA enabled to VM or a DN:
run sql select dnorpattern,cfadestination,cfavoicemailenabled from CallForwardDynamic c, numplan n where c.fknumplan = n.pkid and (cfadestination != '' or cfavoicemailenabled ='t')

Answer 1

Hi Amanda
Basically it's standard SQL, so it wouldn't hurt to google 'informix select statements' and do a little reading to get the basics. There are millions of permutations of queries so it's a matter of understanding the syntax, and then applying that to the database in question. The only difference when running commands from the CLI are that:
- You prefix the standard informix SQL statement with 'run sql'
- You don't get any help from CUCM with the syntax, so you might be well advised to use something that understands SQL a little and colorises it as you type, and then paste the resulting commands into the CUCM SSH window. I use a text editor named JEdit, if you create a text file and save it as a file ending in .sql it will highlight your syntax.
- Other programs are available that do reasonable syntax highlighting (e.q. SquirrelSQL) that are designed for querying the DB directly, but you can't actually query directly against the DB for security reasons. You'd still have to copy/paste the commands.
Now... to understand the DB you'll need a reference describing all the tables etc. This is here:
http://www.cisco.com/en/US/products/sw/voicesw/ps556/products_programming_reference_guides_list.html
Pick your version of CUCM and download the 'Data Definition' document.
A few notes on the command:
run sql : is just the CLI command that tells the shell to run the following text as SQL.
select : the SQL command to retrieve data
dnorpattern,cfadestination,cfavoicemailenabled : the column names to retrieve
callforwarddynamic c, numplan n : the names of two tables, and the abbreviations you want to refer to them as
where c.fknumplan = n.pkid : this tells SQL to return values from the two tables where these fields match up. In the data definition you'll see notes that c.fknumplan (i.e. the fknumplan column in the callforwarddynamic table, as noted by the c. prefix) refers to the PKID column in the numplan field. This is a very standard type of join in the CCM DB.
and (cfadestination != '' or cfavoicemailenabled ='t') : another clause, basically in this query we want to see only rows where cfadestination isn't blank or cfavoicefmailenabled is set to 't' for true).
Most tables are linked in one of two ways in this database:
- a column prefixed 'fk' refers to the pkid field (there is always only one pkid field per table) in the table following the 'fk' prefix. E.g. above fknumplan refers to the numplan table, pkid field. fkdevice would refer to the device table, pkid field.
- a column prefiex 'tk' refers usually to an enum table which is prefixed with 'type'. This is a table that maps the number value in the 'tk' field to a string. An example would be tkmodel - this represents the phone physical model type (e.g. 7962), and maps to a table called typemodel, and the 'enum' column in that table.
Regards
Aaron HarrisonPrincipal Engineer at Logicalis UK
Please rate helpful posts...