首页 > 代码库 > .net Elasticsearch 学习入门笔记
.net Elasticsearch 学习入门笔记
一. es安装相关
1.elasticsearch安装
运行http://localhost:9200/
2.head插件
3.bigdesk插件安装
(安装细节百度:windows elasticsearch 安装，有详细内容)
二. es插件相关
http://www.searchtech.pro/elasticsearch-plugins (es 插件大全)
https://github.com/medcl/elasticsearch-analysis-ik (ik 项目)
https://github.com/lmenezes/elasticsearch-kopf (ES的插件 监控 节点状态 ， 也可以调试你的ES查询)
https://github.com/medcl/elasticsearch-rtf/tree/master (2.1.1 + 1.6ik 还有拼音 和其他分词器 集成好了)
https://github.com/lmenezes/elasticsearch-kopf (类似head的插件)
https://www.elastic.co/downloads/marvel （监控ES健康状态）
konf插件 (据说能看集群负载)
三.es C# 客户端示例
1. 包下载elasticsearch.net,nest 组件。
nest组件会依赖下载elasticsearch组件。
使用文档：http://nest.azurewebsites.net/
备注：.net 使用es的相对少一些，es版本更新也很快，很多使用也都是靠自己揣摩。多交流，多分享。
2. 创建连接客户端
public ElasticClient GetClient()
{
var node = new Uri("http://192.168.17.54:9200");
var settings = new ConnectionSettings(
node,
defaultIndex: "my-application"
);
return new ElasticClient(settings);
}
3. 创建索引模型（索引结构）
[ElasticType(IdProperty = "Id", Name = "Person")]
public class Person
{
[ElasticProperty(Name = "Id", Type = FieldType.String, Index = FieldIndexOption.NotAnalyzed)]
public string Id { get; set; }
public string Firstname { get; set; }
public string Lastname { get; set; }
public string[] Chains { get; set; }
[ElasticProperty(Name = "content", Type = FieldType.String, Index =
FieldIndexOption.Analyzed, Analyzer = "ik_max_word")]
public string Content { get; set; }
}
备注：其他人提供的model示例，更详细些，可下载附件。
4. 索引内容（创建索引）
private void btnIndex_Click(object sender, EventArgs e)
{
//var client = new ElasticsearchClient();
////index a document under /myindex/mytype/1
//var indexResponse = client.Index("myindex", "mytype", "1", new { Hello = "World" });
var client2 = GetClient();
//client2.CreateIndex("test");
//client2.Map<Person>(c => c.MapFromAttributes());
IEnumerable<Person> persons = new List<Person>
{
new Person()
{
Id = "4",
Firstname = "aaa",//Boterhuis-040
Lastname = "Gusto-040",
Chains = new string[]{ "a","b","c" },
},
new Person()
{
Id = "5",
Firstname = "sales@historichousehotels.com",
Lastname = "t Boterhuis 1",
Chains = new string[]{ "a","b","c" },
},
new Person()
{
Id = "6",
Firstname = "Aberdeen #110",
Lastname = "sales@historichousehotels.com",
Chains = new string[]{ "a","b","c" },
},
new Person()
{
Id = "7",
Firstname = "Aberdeen #110",
Lastname = "t Boterhuis 2",
Chains = new string[]{ "a","b","c" },
},
new Person()
{
Id = "8",
Firstname = "Aberdeen #110",
Lastname = "t Boterhuis 2",
Chains = new string[]{ "a","b","c" },
},
};
//foreach(var p in persons)
client2.IndexMany<Person>(persons,"test");
}
5. 简单搜索示例
var client = GetClient();
var rs = client.Search<Person>(s => s.Index("test").QueryString(this.textBox1.Text));
this.richTextBox1.Text = JsonConvert.SerializeObject(rs.Documents);
6. 索引更新
private void btnUpdate_Click(object sender, EventArgs e)
{
var client2 = GetClient();
client2.Update<Person, object>(u => u
.Index("test")
.Id(4)
.Doc(new { Id="4", Firstname = "United States" })
.RetryOnConflict(3)
.Refresh()
);
//var u1 = new Person()
// {
// Id = "4",
// Firstname = "Boterhuis-040",
// Lastname = "Gusto-040",
// Chains = new string[]{ "a","b","c" },
// };
//var u2 = new Person()
// {
// Id = "4",
// Firstname = "United States",
// Lastname = "Gusto-040",
// Chains = new string[] { "a", "b", "c" },
// };
//client2.Update<Person,Person>(u1,u2).
}
7. 索引删除
private void btnDelete_Click(object sender, EventArgs e)
{
var client2 = GetClient();
client2.DeleteIndex("test");
client2.DeleteIndex("my-application");
}
8. 总结
以上示例代码，简单的应用已经足够用。其他的就是高亮和分组。可以看文档。
四. es 集群
es 默认是一个集群，相对solr云来说配置更简单，搭建更方便些。但是更多还是要根据业务进行自己的集群设计还是好费很多时间，很多精力。（上手容易，用好难）
五. es 与solr 对比
个人目前了解的：
原来solr资料比较多，现在貌似es的资料更多一点。solr是官方英文pdf，es也是英文的。
原来solr还有中文书籍，现在貌似没有了。es 目前还有几本书籍，但是讲的es版本略有老旧。
solr上手相对es略微难些。
（n年前，我用的是solr，那时候还没有solrcloud；es还没有出来，那时候solr资料反而多。个人也实现了自己的solr集群方案。其他的功能上的对比，还是百度，不重复。）
六. 如果es客户端调试请求
建议下载HTTPAnalyzer之类的tcp拦截工具。这样可以拦截验证sdk出来的请求连接，对比资料和书籍看下哪些参数写错了，对调试很有帮助。
七. es 附录
es术语介绍：
cluster：
代
表一个集群，集群中有多个节点，其中有一个为主节点。这个主节点是可以通过选举产生的。注意，主从节点是对于集群内部来说的。es的一个概念就是去中心
化，字面上理解就是无中心节点，这是对于集群外部来说的，因为从外部来看es集群，在逻辑上是个整体，你与任何一个节点的通信和与整个es集群通信是等价
的。
shards
代表索引分片。es可以把一个完整的索引分成多个分片，这样的好处是可以把一个大的索引拆分成多个，分布到不同的节点上。构成分布式搜索。分片的数量只能在索引创建前指定，并且索引创建后不能更改。
replicas
代表索引副本，es可以设置多个索引的副本。副本的作用，一是提高系统的容错性，当某个节点的某个分片损坏或丢失时可以从副本中恢复，二是提高es的查询效率，es会自动对搜索请求进行负载均衡。
recovery
代表数据恢复或叫数据重新分布，es在有节点加入或退出时会根据机器的负载对索引分片进行重新分配，挂掉的节点重新启动时也会进行数据恢复。
river
代表es的一个数据源，也是其他存储方式（如：数据库）同步数据到es的一个方法。它是以插件方式存在的一个es服务，通过读取river中的数据并把它索引到es中，官方的river有couchDB的，RabbitMQ的，Twitter的，Wikipedia的。
gateway
代
表es索引快照的存储方式。es默认是先把索引存放到内存中，当内存满了时再持久化到本地硬盘。gateway对索引快照进行存储，当这个es集群关闭再
重新启动时，就会从gateway中读取索引备份数据。es支持多种类型的gateway，有本地文件系统（默认），分布式文件系统，Hadoop的
HDFS和amazon的s3云存储服务。
discovery.zen
代表es的自动发现节点机制。es是一个基于p2p的系统，它先通过广播寻找存在的节点，再通过多播协议来进行节点之间的通信，同时也支持点对点的交互。
Transport
代表es内部节点或集群与客户端的交互方式。默认内部是使用tcp协议进行交互，同时它支持http协议（json格式）、thrift、servlet、memcached、zeroMQ等的传输协议（通过插件方式集成）
.net Elasticsearch 学习入门笔记