【汇总】常见的13种数据源及其与报表系统的连接方式

【汇总】常见的13种数据源及其与报表系统的连接方式本节介绍各类数据源的定义方法。

2.1 SQL Server数据源

定义SQL Server数据源的步骤如下：

（1）在报表资源管理器中，在“数据源”节点上单击鼠标右键，选择“添加数据源”菜单项。

（2）在弹出的“报表数据源”对话框的“类型”处，选择“Microsoft Sql Client Provider”。输入SQL Server数据库服务器的名称或IP地址、连接数据库的用户名和密码，勾选“保存我的密码”，输入或者选择数据库名。如下图：

（3）点击“确定”按钮，完成数据源创建操作，此时，在报表资源管理器窗口中的“数据源”节点下新增了一个名为“DataSource1”的子节点。

2.2 Oracle数据源

如果数据源是Oracle数据库，数据源的定义方法如下：

（1）在报表设计器中，右键单击报表资源管理窗格中的【数据源】节点，再单击【添加数据源】，如下图：

（2）在数据源【类型】处选择“Oracle Client Provider”。

（3）输入服务器名称：请输入Oracle数据库服务器的IP地址，以及数据库实例名，中间用斜杠分隔，例如：127.0.0.1/orcl

（4）输入Oracle用户名、Oracle用户密码，勾选【保存我的密码】，如下图：

（5）点击【连接字符串】切换选项卡，点击对勾状图标，验证连接字串的正确性，如下图：

（6）点击【确定】按钮，保存数据源设置。

如果在【连接字符串】选项卡中测试连接失败，可考虑用以下方法排除错误：

（1）确保完整安装Oracle客户端软件，安装过程中选择【管理员】模式，以便包含所有必需的组件。并且，在64位操作系统中，必须既安装32位的Oracle客户端，又安装64位的Oracle客户端。

（2）如果访问Linux上的Oracle数据库时出现TNS 12514错误，一个可能的原因是服务器上的服务名并非ServiceName而是SID。要解决此问题，可以在Net Manager中设置服务命名时，选中【使用Oracle8发行版8.0兼容标识】，然后在SID框中输入服务名。如下图：

这个服务命名的配置信息保存在tnsnames.ora文件中，该文件保存在

C:\app\\product\11.2.0\client_1\network\admin目录下，如下图：

可以看到常见的（Service_Name=xxx）会变成（SID=xxx）。如下图：

另外需要注意的是，只有Net Manager有那个SID的选项，用Net Configuration Assistant配置本地网络服务名时，没有机会指定SID。

（3）为Oracle数据源添加数据集时，请注意SQL语句中的参数名应为“冒号+参数名”的形式，如 where id = :P1

（4）基于Oracle数据源定义数据集时，如果SQL语句中有汉字，可能出现预览报表无

数据的问题，原因是Oracle客户端组件https://www.360docs.net/doc/0312386472.html,（即Oracle Data Provider for .NET）默

认不用Unicode的编码格式。解决办法是在数据源连接字串中加入Unicode=True; 如：Data Source=1.2.3.4/orcl;User Id=hr;Password=123;Unicode=True;

2.3 CSV数据源

葡萄城报表系统支持CSV格式的文本文件数据源，对于无法直接访问的业务数据库，可将业务数据定时导出为固定格式的CSV文件，然后基于这些CSV文件生成报表。

定义CSV数据源的方法如下：

（1）在数据源的【类型】处选择“CSV”，再点击连接字符串输入框右上角的铅笔状图标。

如下图：

（2）指定CSV文件路径，如下图：

上图所示的City.csv文件内容为一个两个字段、3条记录的简单示例，其中首行为字段列表，用逗号分隔，如下图：

（3）点击【OK】按钮返回数据源对话框，点击绿色对勾图标，验证连接字符串的正确性，如下图：

（4）点击【确定】按钮，保存数据源设置。

（5）右键点击新建CSV数据源，单击【添加数据集】，如下图：

无需输入查询语句，系统将自动解析出CSV文件中的字段，如下图：

默认情况下，CSV文件中的所有内容都将展示在报表中，如需抽取部分数据进行报表展示，可点击【过滤】，设置数据过滤条件。

2.4 ODBC数据源

葡萄城报表系统支持市场上所有的关系型数据库，对于未在【类型】下拉框中列出的数据库类型，均可采用ODBC数据源类型。

定义ODBC数据源的步骤如下：

（1）在数据源的【类型】处选择“Microsoft Odbc Provider”。如下图：

（2）在【连接字符串】中，根据数据库类型的不同，输入相应的连接字串。

典型的几种数据库的ODBC连接字串形式如下：

MySQL数据库：

Driver={MySQL ODBC 5.3 UNICODE Driver}; Server=???; Database=???;

User=root; Password=???; Option=3;

IBM DB2数据库：

Driver={IBM DB2 ODBC DRIVER}; Database=???; Hostname=???;Port=???; Protocol=TCPIP;Uid=???;Pwd=???;

如：

Driver={IBM DB2 ODBC DRIVER}; Database=Sample; Hostname=localhost; Port=50000; Protocol=TCPIP;Uid=db2admin;Pwd=123456;

（3）点击连接字串输入框右上角的绿色对勾图标，可验证连接字串的正确性。

（4）点击【确定】按钮，保存数据源设定。

2.5 OLE DB数据源

大多数关系型数据库或其他类型的数据服务都有厂商或第三方提供的OLE DB提供程序，

对于这些种类的数据服务，可通过OLE DB接口定义数据源。方法如下：

（1）在数据源的【类型】处选择“Microsoft OleDb Provider”。如下图：

（2）选择OLE DB提供程序，例如SQL Server的是SQLOLEDB.1，Oracle数据库的是OraOLEDB.Oracle.1。

（3）输入OLE DB连接信息，例如服务器或文件名称、数据库服务器登录帐号和密码等。

（4）选择【初始目录】，即需要连接到的数据库名称。

（5）需要的话，点击【连接字符串】选项卡，查看连接字串，必要时还可以进行编辑修改，点击绿色对勾图标还可以对测试连接字串是否正确，如下图：

（6）点击【确定】按钮，保存数据源的设置。

2.6 XML数据源

对于XML数据源，请在【类型】处选择“XML Provider”，然后输入XML数据文件路径或外部URL，如下图：

注意：

（1）XML数据源的连接字符串形式为：

xmldoc=http://localhost/xml/data;transformationdoc=http://localhost/xml/sche ma

其中，xmldoc指定数据本身来源，transformationdoc 指定XML 格式信息来源。来源可以是静态文件，也可以是其他应用程序提供的API的调用URL。

（2）XML数据源的数据集定义中，“查询”选项卡中的查询语句应为XPath语法，如：//Country。

2.7 JSON数据源

如果业务应用系统不允许报表系统直接访问，只能通过URL形式的调用接口进行访问，那么建议采用JSON类型的数据源。

定义JSON数据源的步骤如下：

（1）在数据源的【类型】处选择“Json”。如下图：

（2）输入Json Schema，即确定JSON数据的结构信息。一般来说，JSON Schema是确定的文本，可选择“内嵌”，然后输入Schema文本内容，如下图：

如果不清楚Schema内容，可通过第三方网站（如https://www.360docs.net/doc/0312386472.html,）或其他工具，从具体的JSON数据中自动生成Schema内容。

（3）设置JSON内容来源。一般来说，JSON数据是从外部调用接口提供的，可输入该调用接口的网址，如下图：

在创建好的JSON数据源基础上，添加新的数据集时，请注意【查询】部分的内容不是通

常的SQL语句，可借助报表设计器提供的JSON查询生成器，如下图：

取出全部JSON数据的语法如下： $.[*]

2.8 MySQL数据源

如果数据源是MySQL数据库，可通过ODBC方式进行连接。

定义数据源之前，请从以下网址下载MySQL数据库的ODBC驱动程序并安装：

64位ODBC Drivers:

https://https://www.360docs.net/doc/0312386472.html,/downloads/connector/odbc/

在64位操作系统中，必须同时下载并安装32位和64位两个版本的ODBC驱动程序，如下图：

如果安装ODBC驱动程序失败，请先从微软网站下载安装Visual C++ 2010 可再发行软件包。对于64位操作系统，该软件包也必须同时安装32位和64位的版本：64位版本：vcredist_x64.exe

https://https://www.360docs.net/doc/0312386472.html,/zh-CN/download/details.aspx?id=14632

32位版本： vcredist_x86.exe

https://https://www.360docs.net/doc/0312386472.html,/zh-CN/download/details.aspx?id=5555

MySQL数据源的定义方法如下：

（1）在报表设计器中，右键单击报表资源管理窗格中的【数据源】节点，再单击【添加数据源】，如下图：

（2）在数据源【类型】处选择“Microsoft Odbc Provider”。

（3）输入如下形式的连接字串：

Driver={MySQL ODBC 5.3 UNICODE Driver}; Server=???; Port=????; Database=???; User=???; Password=???; Option=3;

其中，Server参数为MySQL数据库服务器的IP地址，Port参数为MySQL服务器的端口号，默认为3306，Database参数为数据库名。例如：

Driver={MySQL ODBC 5.3 UNICODE Driver}; Server=192.168.1.23; Port=3306; Database=MyDb; User=root; Password=123; Option=3;

（4）点击【确定】按钮，保存数据源设置。

基于MySQL数据源定义数据集时，如果提示错误信息，请按如下方法排错：

（1）提示“xxx is not allowed to connect to this MySQL server”

这是因为服务器端禁止客户端访问，可通过两种方法解决：

（a）在MySQL服务器上执行GRANT授权语句，如：

GRANT ALL PRIVILEGES ON *.* TO ‘root’@’192.168.1.3′IDENTIFIED BY ‘mypassword’ WITH GRANT OPTION;

（b）在MySQL服务器上修改user表中的记录，将host字段的值更新为百分号（%）：mysql>use mysql

mysql>GRANT SELECT,INSERT,UPDATE,DELETE ON [db_name].* TO [username]@[ipadd] identified by '[password]';

mysql>update user set host = ‘%’ where user = ‘root’;

（2）提示错误：08S01 Lost connection to MySQL server at 'waiting for initial communication packet'

这是通讯设置问题，解决方法如下：

（a）在/etc/https://www.360docs.net/doc/0312386472.html,f文件的[mysqld]中加上 skip-name-resolve，然后重启MySQL。

（b）在/etc/hosts文件中添加【IP地址主机名】映射，例如：

192.168.1.1 localhost

（3）参数查询不出结果，可能是参数形式问题，参数必须是问号形式，如：

select * from userinfo where date_format(duedate,'%Y') = ? and ID<=?

多个参数时，按数据集定义对话框中【参数】列表的次序来匹配。

2.9 DB2数据源

如果数据源是DB2数据库，可通过ODBC方式进行连接。

定义数据源之前，请从以下IBM网址下载DB2数据库的客户端并安装：

https://www.360docs.net/doc/0312386472.html,/developerworks/cn/downloads/im/udbexp/

请注意：DB2客户端组件包含DB2的ODBC驱动程序和其他必要组件。仅仅下载安装单独的ODBC驱动程序是不够的。

DB2客户端组件的安装界面如下图：

建议勾选所有功能部件。

DB2数据源的定义方法如下：

（1）在报表设计器中，右键单击报表资源管理窗格中的【数据源】节点，再单击【添加数据源】，如下图：

（2）在数据源【类型】处选择“Microsoft Odbc Provider”。

（3）输入如下形式的连接字串：

Driver={IBM DB2 ODBC DRIVER}; Database=myDB; Hostname=myServer;

Port=xxxx; Protocol=TCPIP; Uid=myUsername; Pwd=myPassword;

其中，Hostname参数为DB2数据库服务器的IP地址，Port参数为服务端口号，Database参数为数据库名。例如：

Driver={IBM DB2 ODBC DRIVER}; Database=Sample; Hostname=localhost; Port=5000; Protocol=TCPIP; Uid=db2admin; Pwd=Db123456;

（4）点击【确定】按钮，保存数据源设置。

基于DB2数据源定义数据集时，SQL语句中的表和视图名之前，应加上Owner前缀，例如：

select * from Staff

需要修改为：

select * from Administrator.Staff

2.10 MongoDB数据源

MongoDB是典型的非关系型数据库，其操作与普通关系型数据库差异较大，以下详细介

绍如何使用葡萄城报表设计器，设计以MongoDB数据库为数据源的报表。

（1）下载安装MongDB的ODBC驱动程序

MongoDB的ODBC驱动程序可从以下网址下载：

https://www.360docs.net/doc/0312386472.html,/drivers/mongodb-odbc-jdbc/

在64位的操作系统中，请同时安装32位和64位的两个驱动程序。安装文件分别为：Simba MongoDB 2.2 32-bit.msi和Simba MongoDB 2.2 64-bit.msi

安装后请注意要将从https://www.360docs.net/doc/0312386472.html,获得的许可文件SimbaMongoDBODBCDriver.lic复制到安装目录下的lib子目录中（C:\Program Files\Simba MongoDB ODBC Driver\lib）。

（2）启动MongoDB的服务

（a）创建C:\MongoData\db1子目录，作为数据库文件的存储文件夹。

（b）运行cmd打开命令行窗口，转到MongoDB的安装目录下的Bin子目录，例如：C:\Program Files\MongoDB\Server\3.4\bin。执行以下命令：

mongod.exe --dbpath C:\MongoData\db1

（3）插入示例数据

（a）运行cmd打开命令行窗口，转到MongoDB的安装目录下的Bin子目录，例如：C:\Program Files\MongoDB\Server\3.4\bin。执行以下命令：

mongo

（b）创建集合（相当于数据库的表）

> db.createCollection(“Emp”)

其中，Emp为集合名，相当于数据库的表名。

（c）插入文档（相当于数据库的记录）

> db.Emp.insert({name:’John’, age: 30})

（4）设计MongoDB数据源

（a）打开报表设计器，添加新数据源。

（b）选择【类型】为Microsoft Odbc Provider。

（c）输入如下形式的连接字符串：

Driver={Simba MongoDB ODBC Driver};Server=; Port=27017; 如下图：

完整的连接字串形如：

Driver=Simba MongoDB ODBC Driver; Server=[ServerInfo];

Port=[PortNumber]; Database=[MongoDBDatabase];

authMechanism=SCRAM-SHA-1或GSSAPI或PLAIN;

UID=[UserName]; PWD=[Password];

（5）设计MongoDB数据集

（a）在新添加的MongoDB数据源下添加新数据集。

（b）在【查询】部分输入SQL语句。

如： select * from Emp

其中，Emp就是MongoDB的集合名。

（6）设计报表表格

（a）在设计区拖放一个表格元素。

（b）设置表格字段绑定。

如下图：

预览效果如下图：

2.11 Excel数据源

葡萄城报表系统支持Excel文件数据源，对于无法直接访问的业务数据库，可将业务数据导出为Excel文件，然后基于这些文件生成报表。

定义Excel数据源的方法如下：

（1）在报表设计器中，右键单击报表资源管理窗格中的【数据源】节点，再单击【添加数据源】，如下图：

（2）在数据源【类型】处选择“Microsoft Odbc Provider”，如下图：

（3）在【连接字符串】处输入如下形式的ODBC连接字串：

如果是Excel 2003以及更早的XLS格式文件，连接字串形如:

Driver={Microsoft Excel Driver (*.xls)}; DriverId=790; Dbq=C:\...\xxx.xls;

如果是Excel 2007或者更晚的XLSX格式文件，连接字串形如：

Driver={Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb)}; DBQ=C:\...\xxx.xlsx;

（4）点击【确定】按钮，保存数据源设置。

注意：

（1）Excel的ODBC驱动程序是由Access数据库引擎（Database Engine）提供的。可从下面的网址下载：

https://https://www.360docs.net/doc/0312386472.html,/en-US/download/details.aspx?id=13255

（2）在64位操作系统中，报表服务要求安装64位的Access引擎，而32位的报表设计器要求安装32位的Access引擎。但是Windows系统不允许同时安装32位和64位的Access 数据库引擎，因此，请在报表服务器之外的电脑上安装运行独立报表设计器，以及32位的Access数据库引擎。

（3）为Excel数据源添加数据集时，请注意SQL语句中，表名应为Excel工作表的名称加上美元符（$），例如：

select [ID],[名称] from [Sheet1$]

2.12 Access 数据源

如果数据源是微软的Access数据库，可通过OLEDB方式进行连接。定义Access数据源的方法如下：

（1）在报表设计器中，右键单击报表资源管理窗格中的【数据源】节点，再单击【添加数据源】，如下图：

（2）在数据源【类型】处选择“Microsoft OleDb Provider”。

（3）在【OLE DB提供程序】下拉列表中选择“Microsoft.ACE.OLEDB.12.0”。