将 3CX 连接到 Microsoft SQL 数据库和Grafana

介绍

本指南适用于运行 V20 Update 7 的系统，并提供了将您的 3CX 电话系统连接到 Microsoft SQL 数据库以便与 Grafana 一起使用进行数据可视化和报告的简洁过程。

先决条件

  • 正在运行的 Microsoft SQL Server。本地或 Azure
  • 对 Microsoft SQL Server 的管理访问权限
  • 访问 3CX 管理控制台
  • 3CX16SC+许可证（数据连接器功能所需）

步骤 1：在 Azure 或本地创建 SQL 数据库

在 Azure 上创建 SQL 数据库

  1. 在此登录您的 Azure 门户https://portal.azure.com/
  2. 搜索并导航至SQL Server然后点击创建（Create）
  3. 选择或创建新的资源组
  4. 设置唯一的服务器名称并选择靠近 PBX 的位置
  5. 选择使用 SQL 身份验证并设置管理员登录名和强密码
  6. 记下这些凭据，因为稍后您将需要它们在 3CX 管理控制台中配置数据连接器。
  7. 点击 审阅 + 创建（Review + create）进而 创建

  1. 导航至SQL 服务器，打开刚刚创建的上述服务器并记下服务器名称因为您稍后需要它在 3CX 管理控制台中配置数据连接器。
  2. 点击创建数据库（Create database）

  1. 设置唯一的数据库名称
  2. 在计算和存储部分(Compute and Storage Sections)根据需要选择数据库的规格和大小
  3. 点击审阅 + 创建（Review + create） 进而 创建

  1. 创建数据库后，导航至SQL数据库并打开刚刚创建的上述数据库。
  2. 点击设置服务器防火墙（Set Server Firewall）

  1. 将公网访问切换为“选定的网络（Selected Networks）”，然后点击“添加防火墙规则（Add a firewall rule）”
  2. 添加将访问此数据库的 PBX 的公网 IP 地址，然后单击保存（Save）。

创建本地 SQL 数据库

  1. 从此处下载本地 Microsoft SQL Server 并运行安装程序：https://www.microsoft.com/en-us/sql-server/sql-server-downloads
  2. 安装成功后，继续下载并安装SQL Server 管理工作台
  3. 按照向导安装并启动 SQL Server Management Studio (SSMS)

  1. 默认情况下，Microsoft SQL Server 可能未监听任何端口或正在监听动态端口。要使用特定端口（例如默认的 1433），请转到Windows“开始”菜单、搜索并打开SQLServerManager16.msc
  2. 在左侧面板中，依次选择“SQL Server 网络配置”→“SQLEXPRESS 协议”。
  3. 右键单击“TCP/IP”，然后单击“启用”。
  4. 继续在SQLEXPRESS 协议中：
    双击“TCP/IP”，然后转到    “IP 地址”选项卡。
  5. 滚动到底部，找到“IPAll”部分。
  6. 将“TCP 端口”设置为 1433，并将“TCP 动态端口”留空，然后单击“确定”。
  7. 返回 SQL Server 配置管理器。在左侧面板中，转到“SQL Server 服务”。
  8. 右键单击您的实例（例如微软SQL服务器）并点击重启

  1. 打开上面安装的 SQL Server Management Studio
  2. 您可以使用 Windows 身份验证以管理员身份在本地主机上连接到新的 SQL Server，如下所示

  1. 连接到 SSMS 后，右键单击数据库>新建数据库（ Databases > New Database）
  2. 为数据库指定一个唯一的名称，然后单击OK

  1. 要启用 SQL Server 身份验证以便 PBX 能够连接到数据库，请右键单击左侧面板上的 SQL Server，然后单击属性（Properties）
  2. 导航至安全（Security），选择“SQL Server 和 Windows 身份验证模式”并点击OK
  3. 再次，从 SQL Server 管理器（如上所示）或通过任务管理器重新启动 SQL Server

  1. 要为 PBX 创建用户以连接到此数据库，请右键单击登录>新建登录（Logins > New Login）
  2. 设置您的用户名登录名
  3. 选择 SQL身份验证（Authentication ）并设置一个强密码
  4. 取消选中强制执行密码策略（ Enforce password policy）如果你不想要复杂的规则
  5. 默认数据库（Default database）：选择上面创建的新数据库（例如 cdr_db）

  1. 仍在同一个“登录”窗口中，点击左侧的“用户映射（User Mapping）”
  2. 选择您的新数据库（例如 cdr_db）
  3. 在“数据库角色成员资格”中，检查以下选项

db_datareader, db_datawriter, db_ddladmin

  1. 单击“OK确定”

步骤2：在3CX上配置数据连接器

  1. 导航至 3CX 管理控制台 > 集成 > 数据连接器
  2. 选择“Microsoft SQL 服务器”并输入以下内容：
  • 主机：安装 Microsoft SQL Server 的主机的 IP 地址或 FQDN（如有）。或者 Azure 提供的服务器名称
  • 端口：数据库端口（默认值：1433）。
  • 数据库名称：您在步骤 1 中创建的数据库的名称。
  • 用户名：您在步骤 1 中创建的新用户的用户名。
  • 密码：您为新用户配置的密码
  • 频率：设置从 PBX 到 Azure SQL 数据库的数据传输频率。
  1. 保存配置，然后点击 PBX 上的“测试”按钮，验证 MySQL 数据库的连接是否成功，并确认收到成功消息。如果测试失败，请仔细检查主机、端口、数据库名称、用户名和密码。此外，请验证 MySQL 主机或网络上的任何防火墙是否允许来自 PBX IP 的连接

步骤 3：将 Grafana 连接到 Microsoft SQL 数据库

  1. 登录您的 Grafana 实例（例如，grafana.com 或您自托管的 Grafana）。
  2. 转到 Grafana 配置菜单（齿轮图标）并单击“数据源(Data Sources)" 并点击 "添加数据源(Add data source)“。
  3. 搜索并选择“Microsoft SQL Server“

  1. 在“连接（Connection）"部分，请输入以下详细信息：
  • 主机（Host）：输入 Microsoft SQL Server 的 IP 或 FQDN 和端口，格式为：IP/FQDN:1433
  • 数据库(Datebase)：您在步骤 1 中创建的数据库的名称。
  • 用户(Username)：您在步骤 1 中创建的新用户的用户名
  • 密码(Password)：您为新用户配置的密码
  • 验证类型(Authentication Type)：SQL Server 身份验证

  1. 点击 ”保存并测试(Save & test)“并确认您收到了”数据库连接正常(Database Connection OK)“消息。如果遇到错误，请仔细检查连接详细信息和 SSL 配置。此外，请验证 Microsoft SQL 主机或网络上的任何防火墙是否允许来自 Grafana IP 的连接。

上次更新
本文件最后更新于 2025 年 7 月 24 日
https://www.3cx.cn/docs/microsoft-sql-server-configuration/