数据库

支持的数据源类型

Sugar BI中的数据源是指数据库连接，每个空间可以建立多个数据源。目前支持的数据源类型如下，其中红色字体的表示Sugar BI支持使用数据模型方式来对接该数据源，其它的黑色字体的表示只能使用SQL 建模方式来对接。

• Excel/CSV

• 数据库

  • MySQL
  • MariaDB
  • SQL Server
  • Oracle
  • PostgreSQL
  • IBM DB2
  • SAP Hana
  • 达梦（DM8）
  • 人大金仓（KingbaseES）
  • 华为 GaussDB（openGauss）
  • 南大通用 GBase 8a
  • Exasol（私有部署版可用）

• 大数据

  • Apache Kylin
  • Apache Hive
  • Apache Spark SQL
  • Apache Impala
  • Apache Druid
  • Apache Doris（Baidu Palo）
  • CockroachDB
  • GreenPlum
  • Presto/Trino
  • Vertica
  • TiDB
  • Clickhouse
  • MaxCompute
  • OceanBase
  • Hologres
  • Amazon Athena
  • GaussDB(DWS) 华为数仓
  • Baidu BLS
  • Snowflake（私有部署版可用）
  • Teradata（私有部署版可用）

• 时序数据库

  • InfluxDB（详见InfluxDB 特殊说明）
  • Prometheus（详见Prometheus 特殊说明）
  • Graphite（详见Graphite 特殊说明）
  • OpenTSDB（详见OpenTSDB 特殊说明）
  • Baidu TSDB（详见时序时空数据库 TSDB 特殊说明）

• NoSQL

  • Cassandra
  • Redis（详见Redis 特殊说明）
  • MongoDB（详见MongoDB 特殊说明）
  • ElasticSearch（详见ElasticSearch 特殊说明）

添加数据源

空间管理员可以通过空间左侧边栏中的管理中心进入数据源管理。添加数据源时选择好数据源类型并提供连接数据库必要的信息（host、用户名、密码等），如果您的数据库有 IP 白名单的限制策略，需要您将Sugar BI的 IP 添加到您的数据库权限 IP 白名单中。

一般情况下，您在Sugar BI上填入的数据库账户，建议您只赋予数据的读权限给该账户。注意：使用Sugar BI的在线SaaS版，您输入的数据源Host必须是公网地址，如果您的数据库不能通过公网访问，您也可以考虑私有部署或者内网隧道。另外在Sugar BI的在线 SaaS 版中，如果您要连接百度智能云中的 RDS、VPC 内自建的数据库，不需要开通公网，具体使用方式可以参考左侧导航中的下一篇文档。

填写好信息后，用户可以对这个数据库连接进行测试，并保存这个数据源。当然，对于已存在的数据源，您也可以进行修改或删除。

数据库授权

在Sugar BI上添加数据库连接时，需要让数据库准许Sugar BI后端机器的访问，这样Sugar BI才能连接上您的数据库，因此需要您的数据库给Sugar BI进行授权。IP 名单为： 183.240.92.0/24、111.45.0.0/22、14.215.188.0/25，如果不支持 CIDR 形式的 IP 段，需要给以下所有 IP 进行授权。（如果云上 SaaS 版是连接的百度智能云 RDS、VPC 内自建数据源，授权的 IP 和这块不太一样，详见左侧导航中的下一篇文档）

183.240.92.139
183.240.92.19
183.240.92.138
183.240.92.13
183.240.92.142
183.240.92.11
183.240.92.147
183.240.92.9
183.240.92.144
183.240.92.146
183.240.92.7
183.240.92.135
183.240.92.17
183.240.92.16
183.240.92.12
183.240.92.136
183.240.92.6
183.240.92.140
183.240.92.145
183.240.92.133
183.240.92.8
183.240.92.137
183.240.92.4
183.240.92.134
183.240.92.132
183.240.92.5
183.240.92.143
183.240.92.15
183.240.92.18
183.240.92.141
183.240.92.10
183.240.92.14
183.240.92.149
183.240.92.21
183.240.92.20
183.240.92.148
111.45.1.7
111.45.1.198
111.45.1.197
111.45.1.70
111.45.1.136
111.45.1.200
111.45.2.199
111.45.2.72
111.45.2.134
111.45.2.136
111.45.1.72
111.45.2.5
111.45.1.134
111.45.2.198
111.45.1.6
111.45.1.5
111.45.2.135
111.45.2.133
111.45.1.71
111.45.2.6
111.45.1.133
111.45.2.69
111.45.2.8
111.45.1.199
111.45.1.69
111.45.2.70
111.45.2.200
111.45.2.197
111.45.1.8
111.45.2.71
111.45.1.135
111.45.2.7
111.45.1.9
111.45.1.137
111.45.1.201
111.45.2.9
111.45.2.137
111.45.2.201
111.45.1.73
111.45.2.73
14.215.188.4
14.215.188.5
14.215.188.6
14.215.188.7
14.215.188.8
14.215.188.9
14.215.188.10
14.215.188.11
14.215.188.12
14.215.188.13
14.215.188.14
14.215.188.15
14.215.188.16
14.215.188.17
14.215.188.18
14.215.188.19
14.215.188.68
14.215.188.69
14.215.188.70
14.215.188.71
14.215.188.72
14.215.188.73
14.215.188.74
14.215.188.75
14.215.188.76
14.215.188.77
14.215.188.78
14.215.188.79
14.215.188.80
14.215.188.81
14.215.188.82
14.215.188.83

以上是在使用Sugar BI的云上 SaaS 版时需要的数据库授权，如果您使用的是私有部署版，则需要根据您部署的机器进行相应的调整。

一般数据库要不是各个云厂商提供的数据库服务，要不就是自建的数据库，关于这两类数据库的 IP 授权参考如下：

云数据库授权

如果您的数据库是购买云厂商提供的服务，这类的数据库的授权操作比较简单，一般云厂商都有提供「安全」相关的授权页面，如百度智能云的：

自建数据库授权

如果您是自建的数据库，可参考：

• 如果您是在云服务器上自建的数据库，一般云服务器都有「安全组」相关的设置，需要您在安全组的入口和出口中配置上节中Sugar BI的 IP 地址
• 数据库需要开启 TCP/IP 远程访问，如 SQL Server 和 MySQL 默认都是不开启的
• 对于 SQL Server 要允许账号密码登录，而不仅仅是默认的 windows 身份验证
• 关闭系统的防火墙

• 数据库自身的授权管理（SQL Server 没有该机制），例如 MySQL，可参考

  GRANT ALL PRIVILEGES ON *.* TO '用户名'@'特定IP' IDENTIFIED BY '密码';
  FLUSH PRIVILEGES;

• 如果授权都确认没问题，还总是提示连接失败，请确认填写的各种信息是否正确，已经发现有多次用户输入错误（密码填错、数据库名称填错等）

预览/编辑

对已有的数据源，我们那可以对其中的数据表（table）进行预览，如下图所示：

另外对于 MySQL、SQL Server、Oracle、Postgres 数据源我们还提供了增删改查的能力，如下图所示：

需要注意如果您要使用编辑和删除功能，在添加数据源的时候需要保证这个账号是有相应权限的，如果您不想使用这个功能，可以在添加数据源的时候使用只读账号，这样在 Sugar BI 中就无法对数据进行编辑。

编辑数据

点击查询结果中的某个数据内容右边的小图标，可以对数据进行修改：

可以同时修改多个数据，然后点击「提交」：

查找数据

点击「筛选」按钮将展开过数据筛选功能，可以针对不同的列进行筛选：

另外对于查询数据结果，可以点击每列标题上的按钮来进行排序

添加数据

点击「新增」按钮可以添加数据。

数据源启用备用地址

为了支持灾备场景的数据源快速切换，可以配置备用地址的「数据库地址 Host」「端口号」「数据库名」「用户名」。在开启「启用备用地址」后数据源会使用备用地址来连接，在「空间设置」和「组织设置」也有「数据源启用备用地址」，这三个层级只要有一个是开启的就生效，组织设置的「数据源启用备用地址」对该组织下的所有数据源生效，空间设置的「数据源启用备用地址」对该空间下的所有数据源生效。该功能仅私有部署可用，环境变量需配置sugar_enable_alternative_db=1，不支持跨源查询。

注意仅支持以下类型的数据源：

• MySQL 5.x
• MySQL 8
• Oracle
• OpenTSDB
• ElasticSearch

公开为示例数据源

组织管理员可以将有管理权限的数据源公开为示例数据源，组织下的所有用户都可以使用该数据源，不限数据源类型。该功能仅私有部署可用，环境变量需配置sugar_enable_release_demo_db=1。注意数据源公开后不支持跨源查询，不支持自定义 sql 视图，不支持同源异库查询，不支持在数据表预览中对表数据修改或执行 sql。