官方文档地址:https://www.elastic.co/guide/en/elasticsearch/client/java-api/current/index.html
1.
TransportClient
TransportClient
使用传输模块远程连接到Elasticsearch群集。它不加入集群,只是获取一个或多个初始传输地址并在每个动作上以循环方式与它们进行通信(尽管大多数动作可能是“两跳”操作)
// on startup
TransportClient client = new PreBuiltTransportClient(Settings.EMPTY)
.addTransportAddress(new TransportAddress(InetAddress.getByName("host1"), 9300))
.addTransportAddress(new TransportAddress(InetAddress.getByName("host2"), 9300));
// on shutdown
client.close();
请注意,如果您使用与“elasticsearch”不同的名称,则必须设置群集名称:
Settings settings = Settings.builder()
.put("cluster.name", "myClusterName").build();
TransportClient client = new PreBuiltTransportClient(settings);
//Add transport addresses and do something with the client...
TransportClient
带有集群嗅探功能,可以动态添加新主机并删除旧主机。当启用嗅探时,传输客户端将连接到其内部节点列表中的节点,该列表通过调用addTransportAddress构建。之后,TransportClient
将调用这些节点上的内部群集状态API来发现可用的数据节点。TransportClient
的内部节点列表将仅替换为那些数据节点。此列表默认每五秒刷新一次。请注意,嗅探器连接的IP地址是在那些节点的Elasticsearch配置中声明为发布地址的IP地址。
请记住,如果该节点不是数据节点,则该列表可能不包括其连接到的原始节点。例如,如果您最初在嗅探后连接到主节点,则不会有更多请求转到该主节点,而是转而转到任何数据节点。TransportClient
排除非数据节点的原因是为了避免将搜索流量发送到仅主节点。
为了启用嗅探,请将client.transport.sniff设置为true:
Settings settings = Settings.builder()
.put("client.transport.sniff", true).build();
TransportClient client = new PreBuiltTransportClient(settings);
其他TransportClient
级别设置包括:
client.transport.ignore_cluster_name 设置为true以忽略连接节点的群集名称验证。(自0.19.4)
client.transport.ping_timeout等待来自节点的ping响应的时间。默认为5秒。
client.transport.nodes_sampler_interval 多频繁地对列出和连接的节点进行采样/ ping操作。默认为5秒。