elasticsearch client

你可以用client做很多事情:

  • 在集群中执行index, get, delete, search,update 操作
  • 在集群中执行administrative tasks
  • 如果你想再程序中嵌入elasticsearch或者执行单元测试,你可开启一个Node

获取elasticsearch的client是很简单的事情,有两种方式可以实现:

1.第一种是通过在程序中创建一个嵌入elasticsearch节点(Node),使之成为elasticsearch集群的一部分,然后通过这个节点来与elasticsearch集群通信。Node方式创建嵌入节点的方式如下:

// 启动节点
Node node = new NodeBuilder().node();
Client client = node.client();

// 关闭节点
node.close();

当启动一个节点,它会自动加入同网段的elasticsearch集群,一个前提就是elasticsearch的集群名(cluster.name)这个参数要设置一致。默认的话启动一个节点,elasticsearch集群会自动给它分配一些索引的分片,如果想让这个节点仅仅作为一个客户端而不去保存数据,可以把node.data设置成false或 node.client设置成true:

Node node = new NodeBuilder().client(true).node();

还有一种情况是你并不想把节点加入集群,只想用它进行单元测试时,就要启动一个“本地”的elasticsearch,这里“本地”指的是在JVM的级别下运行,即两个不同的elasticsearch节点运行在同一个JVM中时会组成一个集群。它需要把节点的local参数设置成true,下面是例子:

Node node = new NodeBuilder().local(true).node();

2.是用TransportClient这个接口和elasticsearch集群通信。TransportClient方式:通过TransportClient这个接口,可以不启动节点就可以和elasticsearch集群进行通信,它需要指定elasticsearch集群中其中一台或多台机的ip地址和端口:

Client client = new TransportClient()
        .addTransportAddress(new InetSocketTransportAddress("host1", 9300))
        .addTransportAddress(new InetSocketTransportAddress("host2", 9300));
client.close();  

如果需要更改集群名(默认是elasticsearch),需要如下设置:

Settings settings = ImmutableSettings.settingsBuilder()
                .put("cluster.name", "myClusterName").build();
Client client = new TransportClient(settings);

可以设置client.transport.sniff为true来使客户端去嗅探整个集群的状态,把集群中其它机器的ip地址加到客户端中,这样做的好处是一般不用手动设置集群里所有集群的ip到连接客户端,它会自动帮你添加,并且自动发现新加入集群的机器。代码实例如下:

Settings settings = ImmutableSettings.settingsBuilder()
                .put("client.transport.sniff", true).build(); 
Client client = new TransportClient(settings)
.addTransportAddress(new InetSocketTransportAddress("host1", 9300));

注意:自动嗅探至少需要提供集群中一个节点的地址。

Parameter Description
client.transport.ignore_cluster_name Set to true to ignore cluster name validation of connected nodes. (since 0.19.4)
client.transport.ping_timeout The time to wait for a ping response from a node. Defaults to 5s.
client.transport.nodes_sampler_interval How often to sample / ping the nodes listed and connected. Defaults to 5s.
原文地址:https://www.cnblogs.com/hupengcool/p/4031335.html