opensips數據庫配置及數據表簡介

操作系統 ：CentOS 7.6_x64

opensips版本：2.4.9

MySQL版本：5.7.38

一、添加mysql支持

1、安裝mysql依賴庫

安裝命令如下：

wget https://repo.mysql.com/mysql57-community-release-el7.rpm
rpm -ivh mysql57-community-release-el7.rpm

rpm --import https://repo.mysql.com/RPM-GPG-KEY-mysql-2022
yum search mysql
yum install -y mysql-community-libs.x86_64 mysql-community-devel.x86_64
yum install -y mysql-community-client.x86_64

2、編譯opensips支持mysql數據庫

在opensips源碼目錄執行如下命令：

make menuconfig

選中mysql模塊：

 然後執行編譯及安裝操作：

make && make install

CentOS7環境下源碼安裝opensips，可參考如下文章：

CentOS7環境源碼安裝opensips2.4.9

3、opensips加載mysql庫

文件：/usr/local/etc/opensips/opensips.cfg

添加如下內容：

loadmodule "db_mysql.so" 

二、初始化opensips數據庫

數據庫連接信息：

host : 192.168.137.1
port : 3306
user : root
password : 123456
dbname : opensips

1、配置數據庫信息

文件：/usr/local/etc/opensips/opensipsctlrc
內容：

2、創建數據庫及數據表

文件：/usr/local/sbin/opensipsdbctl
執行如下命令：

./opensipsdbctl create

 數據庫創建成功，效果如下：

 

三、數據表描述

數據表說明可參考opensips官方文檔：
https://www.opensips.org/Documentation/Install-DBSchema-2-4

官方文檔是按模塊劃分的，這裏按表名稱的字母順序進行整理。

一共有57張表：

 

| acc                        |
| active_watchers            |
| address                    |
| b2b_entities               |
| b2b_logic                  |
| cachedb                    |
| carrierfailureroute        |
| carrierroute               |
| cc_agents                  |
| cc_calls                   |
| cc_cdrs                    |
| cc_flows                   |
| clusterer                  |
| cpl                        |
| dbaliases                  |
| dialog                     |
| dialplan                   |
| dispatcher                 |
| domain                     |
| domainpolicy               |
| dr_carriers                |
| dr_gateways                |
| dr_groups                  |
| dr_partitions              |
| dr_rules                   |
| emergency_report           |
| emergency_routing          |
| emergency_service_provider |
| fraud_detection            |
| freeswitch                 |
| globalblacklist            |
| grp                        |
| imc_members                |
| imc_rooms                  |
| load_balancer              |
| location                   |
| missed_calls               |
| presentity                 |
| pua                        |
| re_grp                     |
| registrant                 |
| rls_presentity             |
| rls_watchers               |
| route_tree                 |
| rtpengine                  |
| rtpproxy_sockets           |
| silo                       |
| sip_trace                  |
| speed_dial                 |
| subscriber                 |
| tls_mgm                    |
| uri                        |
| userblacklist              |
| usr_preferences            |
| version                    |
| watchers                   |
| xcap                       |
+----------------------------+
57 rows in set (0.00 sec)

• acc
  所屬模塊： acc
  功能：
  用於記錄成功和失敗的事務（失敗的事務會存儲在missed_calls表）。

參考文檔：https://opensips.org/docs/modules/2.4.x/acc.html

• active_watchers
  所屬模塊： presence
  功能：
  存儲presence模塊活躍的客戶端訂閱列表數據（解析後的）。
  參考文檔：https://opensips.org/docs/modules/2.4.x/presence.html

• address
  所屬模塊： permissions
  功能：
  白名單列表，不是該表的ip+port均丟棄。
  參考文檔： https://opensips.org/docs/modules/2.4.x/permissions.html

• b2b_entities
  所屬模塊：b2b_entities
  功能：
  實現B2BUA的底層邏輯。
  參考文檔： https://opensips.org/docs/modules/2.4.x/b2b_entities.html

• b2b_logic
  所屬模塊：b2b_logic
  功能：
  B2BUA的邏輯引擎。
  參考文檔：https://opensips.org/docs/modules/2.4.x/b2b_logic.html

• cachedb
  所屬模塊：cachedb_sql
  功能：
  CacheDB 數據庫訪問接口。
  參考文檔：https://opensips.org/docs/modules/2.4.x/cachedb_sql.html

• carrierfailureroute
  所屬模塊：carrierroute
  功能：
  存儲故障路由信息，用於故障時重新路由。
  參考文檔：https://opensips.org/docs/modules/2.4.x/carrierroute.html

• carrierroute
  所屬模塊：carrierroute
  功能：
  存儲路由信息，用於選擇最佳路由。
  參考文檔：https://opensips.org/docs/modules/2.4.x/carrierroute.html

• cc_agents
  所屬模塊：carrierroute
  功能：
  存儲呼叫中心模塊坐席信息。
  參考文檔：https://opensips.org/docs/modules/2.4.x/carrierroute.html

• cc_calls

所屬模塊：call_center
功能：
存儲呼叫中心模塊正在進行的呼叫，該表存儲運行時數據，不能手動配置。
參考文檔：https://opensips.org/docs/modules/2.4.x/call_center.html

• cc_cdrs
  所屬模塊：call_center
  功能：
  存儲呼叫中心模塊的通話記錄。
  參考文檔：https://opensips.org/docs/modules/2.4.x/call_center.html

• cc_flows
  所屬模塊：call_center
  功能：
  存儲呼叫中心模塊的呼叫隊列或呼叫流。
  參考文檔：https://opensips.org/docs/modules/2.4.x/call_center.html

• clusterer
  所屬模塊：clusterer
  功能：
  用於配置opensips實例的集羣。
  參考文檔：https://opensips.org/docs/modules/2.4.x/clusterer.html

• cpl
  所屬模塊：cpl_c
  功能：
  配置cpl模塊（Call Processing Language）的表，存儲呼叫處理邏輯。
  參考文檔：https://opensips.org/docs/modules/2.4.x/cpl_c.html

• dbaliases
  所屬模塊：alias_db
  功能：
  存儲數據庫別名和連接參數。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/alias_db.html

• dialog
  所屬模塊：dialog
  功能：
  存儲sip會話信息。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/dialog.html

• dialplan
  所屬模塊：dialplan
  功能：
  存儲dialplan模塊規則數據。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/dialplan.html

• dispatcher
  所屬模塊：dispatcher
  功能：
  存儲dispatcher模塊配置數據，用於負載均衡和路由選擇。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/dispatcher.html

• domain
  所屬模塊： domain
  功能：
  存儲域信息配置數據，用於區分不同域。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/domain.html

• domainpolicy
  所屬模塊：
  功能：
  存儲域策略配置數據。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/domainpolicy.html

• dr_carriers
  所屬模塊： drouting
  功能：
  存儲運營商配置數據。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/drouting.html

• dr_gateways
  所屬模塊： drouting
  功能：
  存儲轉發消息的目的地數據。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/drouting.html

• dr_groups
  所屬模塊： drouting
  功能：
  保存每個trunk各個號碼的路由規則。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/drouting.html

• dr_partitions
  所屬模塊： drouting
  功能：
  存儲drouting的分區信息。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/drouting.html

• dr_rules
  所屬模塊： drouting
  功能：
  保存相同groupid對於不同被叫的轉發規則。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/drouting.html

• emergency_report
  所屬模塊： emergency
  功能：
  緊急呼叫路由模塊的事件記錄數據，以便排障。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/emergency.html
  https://opensips.org/Documentation/Tutorials-Emergency-2-4

• emergency_routing
  所屬模塊： emergency
  功能：
  緊急呼叫路由模塊使用該表將 ERT（緊急路由元組）信息轉換爲用於將緊急呼叫路由到相應 ESGW 網關的 ESGWRI信息。

參考文檔：
https://opensips.org/docs/modules/2.4.x/emergency.html
https://opensips.org/Documentation/Tutorials-Emergency-2-4

• emergency_service_provider
  所屬模塊： emergency
  功能：
  緊急呼叫路由中涉及的供應商信息。

參考文檔：
https://opensips.org/docs/modules/2.4.x/emergency.html
https://opensips.org/Documentation/Tutorials-Emergency-2-4

• fraud_detection
  所屬模塊： fraud_detection
  功能：
  fraud_detection（欺騙檢測）模塊使用該表存儲規則數據。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/fraud_detection.html

• freeswitch
  所屬模塊： freeswitch
  功能：
  存儲freeswitch的ESL配置數據。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/freeswitch.html
  https://opensips.org/docs/modules/2.4.x/freeswitch_scripting.html

• globalblacklist
  所屬模塊： userblacklist
  功能：
  存儲全局黑名單數據，用於屏蔽特定號碼或IP地址。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/userblacklist.html

• grp
  所屬模塊： group
  功能：
  存儲用戶和組的綁定關係。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/group.html

• imc_members
  所屬模塊： imc
  功能：
  存儲即時消息會議（ instant message conference）的成員數據。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/imc.html

• imc_rooms
  所屬模塊： imc
  功能：
  存儲即時消息會議（ instant message conference）的會議室數據。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/imc.html

• load_balancer
  所屬模塊： load_balancer
  功能：
  存儲負載均衡模塊配置數據。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/load_balancer.html

• location
  所屬模塊： usrloc
  功能：
  存儲usrloc模塊的用戶位置信息。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/usrloc.html

• missed_calls
  所屬模塊： acc
  功能：
  存儲未接通的呼叫數據。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/acc.html

• presentity
  所屬模塊： presence
  功能：
  存儲presence服務的發佈者數據。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/presence.html

• pua
  所屬模塊： pua
  功能：
  存儲presence服務的用戶代理（UA）數據。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/pua.html
  https://opensips.org/docs/modules/2.4.x/presence.html

• re_grp
  所屬模塊： group
  功能：
  group 模塊使用此表來檢查基於正則表達式的成員資格。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/group.html

• registrant
  所屬模塊： uac_registrant
  功能：
  存儲uac_registrant模塊的註冊信息，用於opensips作爲uac註冊到其它sip服務器。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/uac_registrant.html

• rls_presentity
  所屬模塊： rls
  功能：
  存儲資源列表服務器（Resource List Server）的發佈者信息。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/rls.html

• rls_watchers
  所屬模塊： rls
  功能：
  存儲資源列表服務器（Resource List Server）的訂閱者信息。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/rls.html

• route_tree
  所屬模塊： carrierroute
  功能：
  carrierroute模塊用於提供路由、負載均衡和黑名單功能。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/carrierroute.html

• rtpengine
  所屬模塊： rtpengine
  功能：
  存儲rtpengine的配置數據。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/rtpengine.html

• rtpproxy_sockets
  所屬模塊： rtpproxy
  功能：
  存儲rtpproxy的配置數據。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/rtpproxy.html

• silo
  所屬模塊： msilo
  功能：
  msilo 模塊使用該表進行離線消息存儲。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/msilo.html

• sip_trace
  所屬模塊： siptrace
  功能：
  siptrace模塊使用該表進行 SIP 消息存儲。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/siptrace.html

• speed_dial
  所屬模塊： speeddial
  功能：
  speeddial模塊使用該表存儲快速撥號數據。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/speeddial.html

• subscriber
  所屬模塊： auth_db
  功能：
  存儲身份驗證信息。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/auth_db.html

• tls_mgm
  所屬模塊： tls_mgm
  功能：
  存儲TLS 證書和參數數據。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/tls_mgm.html

• uri
  所屬模塊： uri
  功能：
  存儲sip uri數據用於檢測。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/uri.html

• userblacklist
  所屬模塊： userblacklist
  功能：
  存儲用戶黑名單數據，用於屏蔽特定號碼或IP地址。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/userblacklist.html

• usr_preferences
  所屬模塊： avpops
  功能：
  存儲用戶首選項信息（可用於個性化設置）。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/avpops.html

• version

功能：存儲各個表的版本信息。

• watchers
  所屬模塊： presence
  功能：
  存儲presence模塊客戶端訂閱列表數據（解析後的）。
  參考文檔：
  https://opensips.org/docs/modules/2.4.x/presence.html

• xcap
  所屬模塊： xcap
  功能：
  存儲xcap文檔。
  opensips可以和openxcap服務器配合使用，具體參考： http://openxcap.org/

•