开源搜索引擎HubbleDotNet图解之基础使用

小咪咪 2022-08-23 08:59 196阅读 0赞

**开源搜索引擎HubbleDotNet图解之基础使用**

**一、HubbleDotNet简介**

**二、HubbleDotNet的下载安装以及升级**

**三、HubbleDotNet的使用**

**四、HubbleDotNet的常见问题及解决方法**

**一、HubbleDotNet简介**

HubbleDotNet是基于.net平台下开发的一款免费的[数据库][Link 1]全文搜索引擎，为开源项目（开源协议是Apache2.0）。作者eaglet（肖波）有10多年的底层开发经验，非常熟悉Lucene等搜索引擎[架构][Link 2]，曾开发过多款Lucene.net平台下的中文分词组件如大名鼎鼎的盘古分词。其HubbleDotNet项目经过两年多的潜心开发，目前最新版本是0.9.5.0，别看版本号小，但已非常完善了。

目前的一些主流数据库都提供了FullText Search（全文搜索）功能，但其全文搜索的功能相对较弱，对于中文的搜索效果不理想，无法很好的满足实际应用需要，而一些全文搜索组件，比如比较著名的Lucene，则只提供了全文搜索功能，而缺乏和关系数据库的关联，且Lucene.net的索引文件的更新和维护很不方便，删除+重新添加=更新的索引修改方式非常糟糕。HubbleDotNet是集全文搜索和关系查询于一体的新型“数据库”系统，用户可以方便的通过SQL语句对Hubble的“数据库”（即索引库）进行全文搜索或关系查询甚至全文+关系的查询。

如何您对数据库自带的全文搜索功能不满意或对Lucene.net的索引维护感到力不从心的时候，您真的应该尝试使用HubbleDotNet来构建您的全文搜索。

**二、HubbleDotNet的下载安装以及升级**

写稿时HubbleDotNet项目网站上提供正式安装版是0.8.3.0的，需要另外下载的最新版（如0.9.5.0）的项目源文件，本地编译一下获取最新组件，覆盖到0.8.3.0的安装目录下完成升级。

项目网址：[http://hubbledotnet.codeplex.com/][http_hubbledotnet.codeplex.com]（不要以为是英文的就是老外的东东哦，^\_^）

0.8.3的安装程序下载地址：[http://hubbledotnet.codeplex.com/releases/view/44680][http_hubbledotnet.codeplex.com_releases_view_44680]

目前最新的0.9.5的源文件下载地址：[http://hubbledotnet.codeplex.com/SourceControl/list/changesets][http_hubbledotnet.codeplex.com_SourceControl_list_changesets]

安装步骤：

（一）下载HubbleDotNet0.8.3

![image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c4333f017beea4d0004e0d5dd93db05f9][]

（二）安装HubbleDotNet0.8.3  
![image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c62c3dd61731b7335717d3a1539e458be][]

获取Key的注册地址为：[http://www.hubbledotnet.com/key.aspx][http_www.hubbledotnet.com_key.aspx]

获取Key只要输入一个电子邮箱和姓名，Key就会即时发送到您的邮箱——作者只为统计使用人数而已。邮箱推荐使用google的或qq的，收信速度很快，163邮箱的我等了好久都没收到:(

然后是常规的选择安装目录一路Next就可以了。

（三）安装完成后可以先打开Hubble.net的控制台看一下，控制台界面非常简洁。

![image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c5e116d562c12225e22156594fdf70ac2][]

（先弹出Connect to Server对话框输入127.0.0.1即可）

![image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c6e7f0a240974221e3b0bd214f7ce0f77][]

是不是有点像SqlServer数据库的管理器啊，呵呵，左边区域显示的就是Hubble的“数据库”，你以后就在那里进行添加管理HubbleDotnet“数据库”的（嗯，其实就是索引库了，类似Lucene.net的索引文件，Hubble的将索引文件以库-表的结构形象的在控制台展示出来方便操作；右上Execute区域是SQL命令输入区，右下Results为搜索结果显示区。

（四）升级HubbleDotNet到最新版本

1.下载HubbleDotNet最新项目源代码程序回来自己编译得到编译组件。

2.停止本机上Hubble.net服务（hubble装上后就在本机上注册一个系统服务了，服务名就叫Hubble.net）

3.覆盖最新版的编译组件到0.8.3.0的安装目录的Default子目录下

4.重新启动本机Hubble.net服务  
下面是各个步骤的图解：

打开[http://hubbledotnet.codeplex.com/SourceControl/list/changesets][http_hubbledotnet.codeplex.com_SourceControl_list_changesets]去下载最新的Source Code

![image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7ce53bfb36c9f7d3a8b1d288ec521c2f11][]

解压缩后进入HubbleDotNet-xxxx/C\#/src/目录下使用vs2008打开解决方案Hubble.Net.sln

![image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c2f88221d5e352ec1ca8f580f49e04f6d][]

使用vs2008打开后将解决方案的编译模式从Debug模式改为Release模式，生成解决方案后，会在HubbleDotNet-xxxx/C\#/Bin/目录得到最新组件的编译结果，全部拷贝到刚才0.8.3.0的安装目录的Default子目录下覆盖即可（先停止系统的Hubble.net服务）

![image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c0d8f8462824ba4d7d4c89b543ef13dc8][]

![image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c8f5c6ced85532c880678c38de71e7681][]

升级后别忘了重新开启系统Hubble.net服务。打开HubbleDotNet控制台，点击菜单Help—》About查看最新的版本Hubble版本号检查升级是否成功。

三、HubbleNet的使用

**（一）在控制台中操作**

**1.创建Hubble数据库（索引库）**

现在我机上装的是SqlServer2008，里面事先已有一存储大量新闻的数据库News（如下图），现在我要新建一个Hubble索引库与这个News数据库绑定以便全文搜索  
![image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c479413ef973ca7c3814d18123e402a8a][]![image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7ca2c44177e8aa481c7d45ae3a3c6af59e][]

下面开始了：

打开HubbleDotNet控制台程序，右键点击根节点，选择CreateDatabase(新建数据库）菜单

![image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7cbea06aa2a14dac9ad25966b2b7a6e308][]  
弹出新建索引库对话窗口

![image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c61a4f7a7f8e2d0a3ae5b87827a693149][]  
Database Name（索引库名称）：填写您要新建的Hubble库的名称（可以和SqlServer系统中数据库名相同也可以不同）如：**HubbleNews**

Default Index Folder（索引存储目录路径）：在这里填写新建的Hubble索引库的存放位置，如d:TestHubbleNews

Default DB Apapter（数据库适配器）：在这里选择你机器上的数据库系统类型，有SQLSERVER2000、SQLSERVER2005、Oracle8i三种可选，看你机上装的是哪种数据库系统选择不同的适配器。（注：SQLSERVER2005适配器适用于微软SqlServer2005及其以后的数据库系统)

Default DB Connection String（数据库连接字符串）：连接到你机上数据库系统的数据库连接字符串，如：Data Source=(local);Initial Catalog=**Ne****ws**;User ID=xxx;Password=xxx

点击Test DB Connection String（测试数据库连接）按钮看看Hubble系统能否正确连接到数据库系统，弹出Connection Successful!信息表示连接成功，否则出现错误信息。

最后点击Create按钮就创建Hubble库了，Refresh刷新一下就能看到，这样这个新建的Hubble索引库**HubbleNews**与数据库**News**就算是绑定了。（这里要注意Hubble索引库有时候大家也称作“数据库”，不要和真正的SqlServer数据库概念搞混了）。

好了，刚才建立的Hubble索引库内还没有任何内容，接下来就要对该索引库里面添加Hubble的“表”，这个“Hubble表”与数据库的表又是什么关系的，看图边说。

在新建的HubbleNews这个索引库上右键菜单中选择Create Table项

![image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c6dc95b69832d41f56cd139b8cc299494][]

弹出Create Table对话框  
![image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c7930577b9a9091d63719acef2758b46d][]

Table Name（表名）：填写将要新建的Hubble表的名称，因我要和数据库News里的dob.News表绑定，如：hubbleNewsTable

Index Folder（索引文件存储位置）：表的存储目录

DB Adapter（数据库适配器）和DB Connection String（数据库连接字符串）就不再赘述了！

最后点击Next按钮即可进入一下对话界面：

![image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c46336d3b63a23864711b54b8ddb114f0][]

接下来在设置IndexMode和IncrementalMode等信息

(1)IndexMode（索引模式）下有两个选择：

Build Index in new table：在这种模式下，新建一张hubble表，你再到SqlServer中看下，数据库中会自动添加一张表，删除这个索引表，数据库中的对应表也自动没有了，这是为什么？这种模式也叫**IndexOnly=true**模式，数据库是被Hubble主动控制的，我们只要操作Hubble，Hubble自动去操作对应的数据库。（这模式我一般用的少）

Build Index from exist tale:顾名思义，是根据数据库中一张已存在的数据库表来建立索引。这个模式也叫**IndexOnly=false**模式。若选择此模式，下面会出现Exist Table Name or View Name输入框，要你填写已存在的要将索引的数据库中表名或视图名。此模式符合我当前的要求，因为我就是要为数据库News中的News这张表建立索引的，故我填上数据库中表名News。

(2)IncrementalMode这里主要是选仅是增加索引还是需要增改删的全部功能，这里一般都选择下面的Append,Delete,Update，除非你的记录只增不该，那你就选第一个Append Only。

然后点击Next到下一步

![image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c89b56202778a13ce71e61e5639337541][]

在这里设置索引表的字段和存储类型

默认情况下是它是将该数据库表的所有字段都列出来，当然如果您的数据库表有的字段不参与查询和查询那完全可以移去（选中该字段前面的Checkbox，然后点击Delete按钮即可移去一个字段），这里主要要介绍一下字段的IndexType类型，分三种：

（1）Tokenized即分词索引模式，选择Tokenized后，需要指定后面的分词器Analyzer类型(有英文分词，中文分词，盘古分词）

（2）UnTokenized即不分词但索引的模式：比如日期、数字之类的不需要分词但需要建索引

（3）None表示不分词也不索引，这适合一些字段仅需要对字段值进行存储以便数据查询时提供显示。

别忘记填写ID Fileld：指定哪个字段为自动编号字段（需要在数据库中指定该字段值是自增的）。

点击Next下一步后最后出现Rebuild Table对话框创建索引

![image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c4b0433b771d13ef7e374c720912f6b91][]

点击Rebuild按钮即可对当前索引表内的数据重建索引数据了。

RebuildWholeTable意思是是否对整张表重新建立索引

DocId from意思是从索引编号多少开始建立索引

**2.****建立Hubble库后进行搜索查询**

在控制台中输入SQL语句进行搜索查询，非常方便

![image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c566d5047c0fd2afcd5e3b6ae35a85de4][]

查询语法示例：

select \* from HubbleNewsTable

select top 10 \* from HubbleNewsTable

select \* from HubbleNewsTable where Title match '北京天安门'    （模糊搜索标题title）

select \* from HubbleNewsTable where Title contains '北京天安门'    （精确搜索标题title）

select  \* from HubbleNewsTable where Title contains '北京天安门' and NewsContent match '北京天安门'    （精确搜索标题title同时模糊搜索内容NewsContent）  
其他的自己看demo了，当然FSQL和标准的SQL也并不是完全100%一致的，比如这样不行select \* from \[HubbleNewsTable\]

**（二）在程序中使用HubbleDotNet**

这里大家主要可以参考从HubbleDotNet源码中的Demo了，我贴几段代码大家看了就会明白。

using PanGu;  
using Hubble.Framework;  
using Hubble.Core;  
using Hubble.Analyzer;  
using Hubble.SQLClient;

//....添加一个记录到Hubble表中

public static bool InsertIndex(SCH.Model.News News)  
        \{   
            string ConnectionString = ConfigurationManager.AppSettings\["ConnectionString"\];  
            string hubbleSql = "insert hubbleNewsTable (\[ID\],\[title\],\[newscontent\])   values (@ID,@title,@newscontent)";  
            int flag=0;  
            using (HubbleConnection conn = new HubbleConnection(ConnectionString))  
            \{   
                conn.Open();  
                HubbleCommand matchCmd = new HubbleCommand(hubbleSql, conn);  
                matchCmd.Parameters.Add("@ID", News.Id);  
                matchCmd.Parameters.Add("@title", News.title);  
                matchCmd.Parameters.Add("@newscontent", News.newscontent);  
                flag = matchCmd.ExecuteNonQuery();  
            \}  
            return (flag > 0) ? true : false;  
        \}

同理删除用delete语句，修改用Update语句差不多的。

需要提一下：

如果是IndexOnly=false模式下

添加数据：先添加记录到数据库，在添加记录到Hubble索引库。

删除数据：先删除Hubble索引库中记录，在删除数据库中记录。

更新记录：顺序无所谓。

也就是在IndexOnly=false模式下，你要通过程序对两边都要操作。

**四、HubbleDotNet的常见问题及解决方法**  
  
常见的问题和解决方法可以估计要放到另外一篇文章中继续了，先提供大家eaglet的博客园的小组地址：[http://home.cnblogs.com/group/search/][http_home.cnblogs.com_group_search]  
去那里可以找到人家已经问过的许多问题和eaglet本人的解答。

[Link 1]: http://lib.csdn.net/base/14
[Link 2]: http://lib.csdn.net/base/16
[http_hubbledotnet.codeplex.com]: http://hubbledotnet.codeplex.com/
[http_hubbledotnet.codeplex.com_releases_view_44680]: http://hubbledotnet.codeplex.com/releases/view/44680
[http_hubbledotnet.codeplex.com_SourceControl_list_changesets]: http://hubbledotnet.codeplex.com/SourceControl/list/changesets
[image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c4333f017beea4d0004e0d5dd93db05f9]: http://xiexie.baihui.com/image.do?imgurl=0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c4333f017beea4d0004e0d5dd93db05f9
[image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c62c3dd61731b7335717d3a1539e458be]: http://xiexie.baihui.com/image.do?imgurl=0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c62c3dd61731b7335717d3a1539e458be
[http_www.hubbledotnet.com_key.aspx]: http://www.hubbledotnet.com/key.aspx
[image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c5e116d562c12225e22156594fdf70ac2]: http://xiexie.baihui.com/image.do?imgurl=0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c5e116d562c12225e22156594fdf70ac2
[image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c6e7f0a240974221e3b0bd214f7ce0f77]: http://xiexie.baihui.com/image.do?imgurl=0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c6e7f0a240974221e3b0bd214f7ce0f77
[image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7ce53bfb36c9f7d3a8b1d288ec521c2f11]: http://xiexie.baihui.com/image.do?imgurl=0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7ce53bfb36c9f7d3a8b1d288ec521c2f11
[image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c2f88221d5e352ec1ca8f580f49e04f6d]: http://xiexie.baihui.com/image.do?imgurl=0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c2f88221d5e352ec1ca8f580f49e04f6d
[image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c0d8f8462824ba4d7d4c89b543ef13dc8]: http://xiexie.baihui.com/image.do?imgurl=0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c0d8f8462824ba4d7d4c89b543ef13dc8
[image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c8f5c6ced85532c880678c38de71e7681]: http://xiexie.baihui.com/image.do?imgurl=0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c8f5c6ced85532c880678c38de71e7681
[image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c479413ef973ca7c3814d18123e402a8a]: http://xiexie.baihui.com/image.do?imgurl=0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c479413ef973ca7c3814d18123e402a8a
[image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7ca2c44177e8aa481c7d45ae3a3c6af59e]: http://xiexie.baihui.com/image.do?imgurl=0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7ca2c44177e8aa481c7d45ae3a3c6af59e
[image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7cbea06aa2a14dac9ad25966b2b7a6e308]: http://xiexie.baihui.com/image.do?imgurl=0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7cbea06aa2a14dac9ad25966b2b7a6e308
[image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c61a4f7a7f8e2d0a3ae5b87827a693149]: http://xiexie.baihui.com/image.do?imgurl=0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c61a4f7a7f8e2d0a3ae5b87827a693149
[image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c6dc95b69832d41f56cd139b8cc299494]: http://xiexie.baihui.com/image.do?imgurl=0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c6dc95b69832d41f56cd139b8cc299494
[image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c7930577b9a9091d63719acef2758b46d]: http://xiexie.baihui.com/image.do?imgurl=0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c7930577b9a9091d63719acef2758b46d
[image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c46336d3b63a23864711b54b8ddb114f0]: http://xiexie.baihui.com/image.do?imgurl=0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c46336d3b63a23864711b54b8ddb114f0
[image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c89b56202778a13ce71e61e5639337541]: http://xiexie.baihui.com/image.do?imgurl=0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c89b56202778a13ce71e61e5639337541
[image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c4b0433b771d13ef7e374c720912f6b91]: http://xiexie.baihui.com/image.do?imgurl=0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c4b0433b771d13ef7e374c720912f6b91
[image.do_imgurl_0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c566d5047c0fd2afcd5e3b6ae35a85de4]: http://xiexie.baihui.com/image.do?imgurl=0d4654813f1704777c077955928b67d25a427c673bfa4b842d7faa3d2b262c7c566d5047c0fd2afcd5e3b6ae35a85de4
[http_home.cnblogs.com_group_search]: http://home.cnblogs.com/group/search/