デバイス情報をアプリケーション ユーザに関連付ける CUCM の SQL クエリ

概要

このドキュメントでは、アプリケーション ユーザに関連付けられているデバイス情報を取得するために CLI で実行できる Structured Query Language（SQL）クエリについて説明します。

前提条件

要件

このドキュメントの読者は Cisco Unified Communications Manager（CUCM）に関する知識を持っていることを推奨します。

使用するコンポーネント

このドキュメントの情報は、CUCM バージョン 8.X 以降に基づいていますが、以前のバージョンでも同様に機能する場合もあります。

テーブル

SQL クエリは、次のテーブルのデータを使用して形成されます。

• Device：このテーブルには、デバイス レベルの情報（IP フォン、ゲートウェイなど）が含まれます。
• NumPlan：このテーブルには CUCM で設定されているすべてのパターンについての情報が含まれます。
• DeviceNumPlanMap：このテーブルには、Device テーブルと NumPlan テーブルのデータ間のマッピングが含まれます。
• RoutePartition：このテーブルには、CUCM で設定されているすべてのパーティションについての情報が含まれます。
• ApplicationUser：このテーブルには、アプリケーション ユーザに関する情報が含まれます。
• ApplicationUserDeviceMap：このテーブルには、ApplicationUser テーブルと Device テーブルのデータ間のマッピングが含まれます。
• DirGroup：このテーブルには、権限グループに関する情報が含まれます。
• ApplicationUserDirGroupMap：このテーブルには、ApplicationUser テーブルと DirGroup テーブルのデータ間のマッピングが含まれます。

これらのテーブルの詳細については、該当するバージョンの『CUCM Data Dictionary』を参照してください。

SQL クエリ

簡単に把握できるようにするため、クエリは一度に 1 つの関連付けを検出するように記述されています。

アプリケーション ユーザとデバイス関連付けの一覧表示

run sql select au.name as ApplicationUser, d.name as Device, d.description as DeviceDescription from applicationuser as au inner join applicationuserdevicemap as audm on audm.fkapplicationuser=au.pkid and isstandard ='f' inner join device as d on d.pkid=audm.fkdevice order by au.name

admin:run sql select au.name as ApplicationUser, d.name as Device, d.description
 as DeviceDescription from applicationuser as au inner join
 applicationuserdevicemap as audm on audm.fkapplicationuser=au.pkid and isstandard
 ='f' inner join device as d on d.pkid=audm.fkdevice order by au.name
applicationuser device          devicedescription            
=============== =============== ============================ 
Test1           SEP503DE57D7DAC 8501                         
Test1           SEPA40CC3956C5C Line 1 - 1213; Line 2 - 1212 
Test2           CTI1            CTI1    

このクエリでは、サーバのインストール後に作成されたアプリケーション ユーザだけが一覧表示されます。デフォルトのアプリケーション ユーザは一覧に含まれず、isstandard='f' 句を使用しているため削除されます。すべてのユーザの一覧を表示するには、_and isstandard='f'_ 句を削除するか、または「f」（false）を「t」（true）に変更します。

この例では、2 つのアプリケーション ユーザが示されています。

• Test 1 は 2 台の電話機に関連付けられています。
• Test 2 は、コンピュータ テレフォニー インテグレーション（CTI）ルート ポイントに関連付けられています。

注：どのフィールドも必要な情報のみが含まれるようにフィルタリングできます。たとえばデバイスにフィルタを適用するには、次のようにします。デバイス名が SEP で始まる電話機を一覧表示するには、クエリの末尾、「order by au.name」の直前に、whered.name like 'SEP% を追加します。 フォーマットは where <column name> like '<value>%' です。

アプリケーション ユーザ、権限、およびデバイス関連付けの一覧表示

run sql select au.name as ApplicationUser, d.name as Device, d.description as DeviceDescription, dg.name as PermissionGroup from applicationuser as au inner join applicationuserdevicemap as audm on audm.fkapplicationuser=au.pkid and isstandard ='f' inner join ApplicationUserDirGroupMap as audgm on audgm.fkapplicationuser=au.pkid inner join DirGroup as dg on audgm.fkdirgroup=dg.pkid inner join device as d on d.pkid=audm.fkdevice order by au.name

applicationuser device          devicedescription            permissiongroup                           
=============== =============== ============================ ========================================= 
Test1           SEP503DE57D7DAC 8501                         Standard CCM Admin Users                  
Test1           SEPA40CC3956C5C Line 1 - 1213; Line 2 - 1212 Standard CCM Admin Users                  
Test2           CTI1            CTI1                         Standard CTI Allow Control of All Devices 
Test2           CTI1            CTI1                         Standard CTI Enabled  

このクエリでは、サーバのインストール後に作成されたアプリケーション ユーザだけが一覧表示されます。デフォルトのアプリケーション ユーザは一覧に含まれず、isstandard='f' 句を使用して削除されます。すべてのユーザの一覧を表示するには、_and isstandard='f'_ 句を削除するか、または「f」（false）を「t」（true）に変更します。

注：どのフィールドも必要な情報のみが含まれるようにフィルタリングできます。たとえばデバイスにフィルタを適用するには、次のようにします。デバイス名が SEP で始まる電話機を一覧表示するには、クエリの末尾、「order by au.name」の直前に whered.name like 'SEP% を追加します。 フォーマットは where <column name> like '<value>%' です。

アプリケーション ユーザ、デバイス、およびデバイス関連情報の一覧表示

run sql select au.name as ApplicationUser, d.name as Device, d.description as DeviceDescription, np.dnorpattern as DN, rp.name as partition, dp.name as DevicePool from applicationuser as au inner join applicationuserdevicemap as audm on audm.fkapplicationuser=au.pkid and isstandard ='f' inner join device as d on d.pkid=audm.fkdevice inner join devicenumplanmap as dnpm on dnpm.fkdevice = d.pkid inner join devicepool as dp on dp.pkid=d.fkdevicepool inner join numplan as np on dnpm.fknumplan = np.pkid inner join routepartition as rp on np.fkroutepartition=rp.pkid order by au.name

applicationuser device          devicedescription            dn   partition   devicepool 
=============== =============== ============================ ==== =========== ========== 
Test1           SEP503DE57D7DAC 8501                         8501 Internal_PT HQ         
Test1           SEPA40CC3956C5C Line 1 - 1213; Line 2 - 1212 1213 Internal_PT HQ         
Test1           SEPA40CC3956C5C Line 1 - 1213; Line 2 - 1212 1212 Internal_PT HQ         
Test2           CTI1            CTI1                         1945 Internal_PT HQ 

このクエリは、関連デバイスの識別名（DN）がパーティション内にある場合は、アプリケーション ユーザを一覧表示しません。None パーティションにあるものを含めるには、次のようにします。
run sql select au.name as ApplicationUser, d.name as Device, d.description as DeviceDescription, np.dnorpattern as DN, dp.name as DevicePool from applicationuser as au inner join applicationuserdevicemap as audm on audm.fkapplicationuser=au.pkid and isstandard ='f' inner join device as d on d.pkid=audm.fkdevice inner join devicenumplanmap as dnpm on dnpm.fkdevice = d.pkid inner join devicepool as dp on dp.pkid=d.fkdevicepool inner join numplan as np on dnpm.fknumplan = np.pkid order by au.name.

このクエリでは、サーバのインストール後に作成されたアプリケーション ユーザだけが一覧表示されます。デフォルトのアプリケーション ユーザは一覧に含まれず、isstandard='f' 句を使用して削除されます。すべてのユーザの一覧を表示するには、_and isstandard='f'_ 句を削除するか、または「f」（false）を「t」（true）に変更します。

注：どのフィールドも必要な情報のみが含まれるようにフィルタリングできます。たとえば DN でフィルタリングするには、クエリの末尾、「order by au.name」の直前に where np.dnorpattern like '8%' を追加します。 これは、8で始まるDNを持つすべてのエントリをリストします。形式はwhere <column name> like '<value>%'です。 デバイスでフィルタリングするには、次のようにします。デバイス名が SEP で始まる電話機を一覧表示するには、クエリの末尾、「order by au.name」の直前に whered.name like 'SEP% を追加します。

アプリケーション ユーザ、権限、およびデバイス関連情報の一覧表示

run sql select au.name as ApplicationUser, d.name as Device, d.description as DeviceDescription, np.dnorpattern as DN, rp.name as partition, dp.name as DevicePool, dg.name as PermissionGroup from applicationuser as au inner join applicationuserdevicemap as audm on audm.fkapplicationuser=au.pkid and isstandard ='f' inner join ApplicationUserDirGroupMap as audgm on audgm.fkapplicationuser=au.pkid inner join DirGroup as dg on audgm.fkdirgroup=dg.pkid inner join device as d on d.pkid=audm.fkdevice inner join devicenumplanmap as dnpm on dnpm.fkdevice = d.pkid inner join devicepool as dp on dp.pkid=d.fkdevicepool inner join numplan as np on dnpm.fknumplan = np.pkid inner join routepartition as rp on np.fkroutepartition=rp.pkid order by au.name

applicationuser device          devicedescription            dn   partition   devicepool permissiongroup                           
=============== =============== ============================ ==== =========== ========== ========================================= 
Test1           SEPA40CC3956C5C Line 1 - 1213; Line 2 - 1212 1213 Internal_PT HQ         Standard CCM Admin Users                  
Test1           SEP503DE57D7DAC 8501                         8501 Internal_PT HQ         Standard CCM Admin Users                  
Test1           SEPA40CC3956C5C Line 1 - 1213; Line 2 - 1212 1212 Internal_PT HQ         Standard CCM Admin Users                  
Test2           CTI1            CTI1                         1945 Internal_PT HQ         Standard CTI Allow Control of All Devices 
Test2           CTI1            CTI1                         1945 Internal_PT HQ         Standard CTI Enabled  

このクエリは、関連デバイスの DN がパーティション内にある場合は、アプリケーション ユーザを一覧表示しません。None パーティションにあるものを含めるには、次のようにします。
run sql select au.name as ApplicationUser, d.name as Device, d.description as DeviceDescription, np.dnorpattern as DN, dp.name as DevicePool, dg.name as PermissionGroup from applicationuser as au inner join applicationuserdevicemap as audm on audm.fkapplicationuser=au.pkid and isstandard ='f' inner join ApplicationUserDirGroupMap as audgm on audgm.fkapplicationuser=au.pkid inner join DirGroup as dg on audgm.fkdirgroup=dg.pkid inner join device as d on d.pkid=audm.fkdevice inner join devicenumplanmap as dnpm on dnpm.fkdevice = d.pkid inner join devicepool as dp on dp.pkid=d.fkdevicepool inner join numplan as np on dnpm.fknumplan = np.pkid order by au.name

このクエリでは、サーバのインストール後に作成されたアプリケーション ユーザだけが一覧表示されます。デフォルトのアプリケーション ユーザは一覧に含まれず、isstandard='f' 句を使用して削除されます。すべてのユーザの一覧を表示するには、_and isstandard='f'_ 句を削除するか、または「f」（false）を「t」（true）に変更します。

注：どのフィールドも必要な情報のみが含まれるようにフィルタリングできます。たとえば DN でフィルタリングするには、クエリの末尾、「order by au.name」の直前に where np.dnorpattern like '8%' を追加します。 8で始まるDNを持つすべてのエントリが表示されます。形式はwhere <column name> like '<value>%'です。 デバイスでフィルタリングするには、次のようにします。デバイス名が SEP で始まる電話機を一覧表示するには、クエリの末尾、「order by au.name」の直前に、whered.name like 'SEP% を追加します。

権限グループの権限ロールの一覧表示

run sql select dg.name as PermissionGroup, fr.name as PermissionRole from DirGroup as dg inner join functionroledirgroupmap as frdgm on frdgm.fkdirgroup=dg.pkid inner join functionrole as fr on frdgm.fkfunctionrole=fr.pkid

permissiongroup                                                         permissionrole                                                          
======================================================================= ======================================================================= 
Standard CCM Super Users                                                Standard CCMADMIN Administration                                        
Standard CCM Super Users                                                Standard SERVICEABILITY Administration                                  
Standard CCM Super Users                                                Standard CCM Admin Users                                                
Standard CCM Super Users                                                Standard Admin Rep Tool Admin                                           
Standard CCM Super Users                                                Standard AXL API Access                                                 
Standard CCM Super Users                                                Standard EM Authentication Proxy Rights                                 
Standard CCM Super Users                                                Standard CUReporting                                                    
Standard CCM Admin Users                                                Standard CCM Admin Users                                                
Standard CCM Admin Users                                                Standard CUReporting                                                    
Standard CCM Read Only                                                  Standard CCMADMIN Read Only                                             
Standard CCM Read Only                                                  Standard CCM Admin Users                                                
Standard CCM Read Only                                                  Standard SERVICEABILITY Read Only                                       
Standard CCM Server Monitoring                                          Standard CCMADMIN Read Only                                             
Standard CCM Server Monitoring                                          Standard SERVICEABILITY                                                 
Standard CCM Server Monitoring                                          Standard CCM Admin Users                                                
Standard CCM Server Maintenance                                         Standard CCMADMIN Read Only                                             
Standard CCM Server Maintenance                                         Standard CCM System Management                                          
Standard CCM Server Maintenance                                         Standard CCM Feature Management                                         
Standard CCM Server Maintenance                                         Standard CCM Service Management                                         
Standard CCM Server Maintenance                                         Standard System Service Management                                      
Standard CCM Server Maintenance                                         Standard CCM Admin Users                                                
Standard CCM Phone Administration                                       Standard CCMADMIN Read Only                                             
Standard CCM Phone Administration                                       Standard CCM Phone Management                                           
Standard CCM Phone Administration                                       Standard CCM Admin Users                                                
Standard CCM Gateway Administration                                     Standard CCMADMIN Read Only                                             
Standard CCM Gateway Administration                                     Standard CCM Gateway Management                                         
Standard CCM Gateway Administration                                     Standard CCM Admin Users                                                
Standard CTI Enabled                                                    Standard CTI Enabled                                                    
Standard CTI Allow Calling Number Modification                          Standard CTI Allow Calling Number Modification                          
Standard CTI Allow Call Park Monitoring                                 Standard CTI Allow Call Park Monitoring                                 
Standard CTI Allow Control of All Devices                               Standard CTI Allow Control of All Devices                               
Standard CAR Admin Users                                                Standard Admin Rep Tool Admin                                           
Standard EM Authentication Proxy Rights                                 Standard EM Authentication Proxy Rights                                 
Standard CCM End Users                                                  Standard CCM End Users                                                  
Standard CCM End Users                                                  Standard CCMUSER Administration                                         
Standard Packet Sniffer Users                                           Standard Packet Sniffing                                                
Standard Packet Sniffer Users                                           Standard CCM Admin Users                                                
Standard CTI Secure Connection                                          Standard CTI Secure Connection                                          
Standard CTI Allow Reception of SRTP Key Material                       Standard CTI Allow Reception of SRTP Key Material                       
Standard TabSync User                                                   Standard AXL API Access                                                 
Standard CTI Allow Call Monitoring                                      Standard CTI Allow Call Monitoring                                      
Standard CTI Allow Call Recording                                       Standard CTI Allow Call Recording                                       
Standard RealtimeAndTraceCollection                                     Standard RealtimeAndTraceCollection                                     
Standard Audit Users                                                    Standard Audit Log Administration                                       
Standard CTI Allow Control of Phones supporting Connected Xfer and conf Standard CTI Allow Control of Phones supporting Connected Xfer and conf 
Standard CTI Allow Control of Phones supporting Rollover Mode           Standard CTI Allow Control of Phones supporting Rollover Mode           
AXL_User                                                                Standard AXL API Access