1.Python模块的安装

pip install elasticsearch

2.Python 连接ElasticSearch

from elasticsearch import  Elasticsearch
# es = Elasticsearch()    # 默认连接本地elasticsearch
# es = Elasticsearch(['127.0.0.1:9200'])  # 连接本地9200端口
es = Elasticsearch(
    ["192.168.1.10", "192.168.1.11", "192.168.1.12"], # 连接集群，以列表的形式存放各节点的IP地址
    sniff_on_start=True,    # 连接前测试
    sniff_on_connection_fail=True,  # 节点无响应时刷新节点
    sniff_timeout=60    # 设置超时时间
)

3.配置忽略响应的状态码

es = Elasticsearch(['127.0.0.1:9200'],ignore=400)  # 忽略返回的400状态码
es = Elasticsearch(['127.0.0.1:9200'],ignore=[400, 405, 502])  # 以列表的形式忽略多个状态码

4.es连接对象的操作

• es.index， 向指定索引添加或者更新文档，如果索引不存在，首先会创建改索引，然后再执行添加或者更新操作。

print(es.index(index='w2', doc_type='doc', id='4', body={"name":"可可", "age": 18}))    # 正常
print(es.index(index='w2', doc_type='doc', id=5, body={"name":"卡卡西", "age":22}))     # 正常
print(es.index(index='w2', doc_type='doc', body={"name": "鸣人", "age": 22}))  # 可以不指定id，默认生成一个id

• es.get，查询索引中指定文档

print(es.get(index='w2', doc_type='doc', id=5))

• es.get_source，通过索引类型和ID获取文档的来源，直接返回需要的字典

print(es.get_source(index='py3', doc_type='doc', id='1'))  # {'name': '王五', 'age': 19}

es.search，执行搜索查询并获取与查询匹配的搜索匹配。这个用的最多，可以跟复杂的查询条件。

• index: 要搜索的以逗号分隔的索引名称列表; 使用_all 或空字符串对所有索引执行操作。

• doc_type: 要搜索的以逗号分隔的文档类型列表; 留空以对所有类型执行操作。

• body: 使用Query DSL（QueryDomain Specific Language查询表达式）的搜索定义。

• _source: 返回_source字段的true或false，或返回的字段列表，返回指定字段。

• _source_exclude：要从返回的_source字段中排除的字段列表，返回的所有字段中，排除哪些字段。

• _source_include：从_source字段中提取和返回的字段列表，跟_source差不多。

print(es.search(index='py3', doc_type='doc', body={"query": {"match":{"age": 20}}}))  # 一般查询
print(es.search(index='py3', doc_type='doc', body={"query": {"match":{"age": 19}}},_source=['name', 'age']))  # 结果字段过滤
print(es.search(index='py3', doc_type='doc', body={"query": {"match":{"age": 19}}},_source_exclude  =[ 'age']))
print(es.search(index='py3', doc_type='doc', body={"query": {"match":{"age": 19}}},_source_include =[ 'age']))

• es.count ，执行查询获取查询到的数量

body = {
    "query": {
        "match": {
            "age": 18
        }
    }
}
print(es.count(index='py2', doc_type='doc', body=body))  # {'count': 1, '_shards': {'total': 5, 'successful': 5, 'skipped': 0, 'failed': 0}}
print(es.count(index='py2', doc_type='doc', body=body)['count'])  # 1
print(es.count(index='w2'))  # {'count': 6, '_shards': {'total': 5, 'successful': 5, 'skipped': 0, 'failed': 0}}
print(es.count(index='w2', doc_type='doc'))  # {'count': 6, '_shards': {'total': 5, 'successful': 5, 'skipped': 0, 'failed': 0}}

• es.create，添加一条数据，索引不存在的话创建索引添加数据

print(es.create(index='py3', doc_type='doc', id='1', body={"name": '王五', "age": 20}))

print(es.get(index='py3', doc_type='doc', id='3'))

• es.delete，删除指定的文档

print(es.delete(index='py3', doc_type='doc', id='4'))

• es.delete_by_query，删除与查询匹配的所有文档。

print(es.delete_by_query(index='py3', doc_type='doc', body={"query": {"match":{"age": 20}}}))

• es.exists，查询elasticsearch中是否存在指定的文档，返回一个布尔值。

print(es.exists(index='py3', doc_type='doc', id='1'))

• es.info，获取当前集群的基本信息。

• es.ping，如果群集已启动，则返回True，否则返回False。

5. es对象的Indices 创建索引，定义mapping

• es.indices.create，在Elasticsearch中创建索引，用的最多。

body = {
    "mappings": {
        "doc": {
            "dynamic": "strict",  # 严格的格式
            "properties": {
                "title": {
                    "type": "text",
                    "analyzer": "ik_max_word"
                },
                "url": {
                    "type": "text"
                },
                "action_type": {
                    "type": "text"
                },
                "content": {
                    "type": "text"
                }
            }
        }
    }
}
es.indices.create('py4', body=body)  # 给索引py4添加索引的映射信息

• es.indices.analyze，返回分词结果。

es.indices.analyze(body={'analyzer': "ik_max_word", "text": "皮特和茱丽当选“年度模范情侣”Brad Pitt and Angelina Jolie"})

• es.indices.delete，在Elasticsearch中删除索引。

print(es.indices.delete(index='py4'))
print(es.indices.delete(index='w3'))    # {'acknowledged': True}

• es.indices.put_alias，为一个或多个索引创建别名，查询多个索引的时候，可以使用这个别名。

index 别名应指向的逗号分隔的索引名称列表（支持通配符），使用_all对所有索引执行操作。

name要创建或更新的别名的名称。

body别名的设置，例如路由或过滤器。

print(es.indices.put_alias(index='py4', name='py4_alias'))  # 为单个索引创建别名
print(es.indices.put_alias(index=['py3', 'py2'], name='py23_alias'))  # 为多个索引创建同一个别名，联查用

• es.indices.delete_alias，删除一个或多个别名。

print(es.indices.delete_alias(index='alias1'))
print(es.indices.delete_alias(index=['alias1, alias2']))

• es.indices.get_mapping，检索索引或索引/类型的映射定义。

print(es.indices.get_mapping(index='py4'))

• es.indices.get_settings，检索一个或多个（或所有）索引的设置。

print(es.indices.get_settings(index='py4'))

• es.indices.get，允许检索有关一个或多个索引的信息。

print(es.indices.get(index='py2'))    # 查询指定索引是否存在
print(es.indices.get(index=['py2', 'py3']))

• es.indices.get_alias，检索一个或多个别名。

print(es.indices.get_alias(index='py2'))
print(es.indices.get_alias(index=['py2', 'py3']))

• es.indices.get_field_mapping，检索特定字段的映射信息。

print(es.indices.get_field_mapping(fields='url', index='py4', doc_type='doc'))
print(es.indices.get_field_mapping(fields=['url', 'title'], index='py4', doc_type='doc'))

5.Cluster（集群相关）

• es.cluster.get_settigns，获取集群设置。

print(es.cluster.get_settings())

• es.cluster.health，获取有关群集运行状况的非常简单的状态。

print(es.cluster.health())

• es.cluster.state，获取整个集群的综合状态信息。

print(es.cluster.state())

• es.cluster.stats，返回群集的当前节点的信息。

print(es.cluster.stats())

6.Node (节点相关）

• es.nodes.info，返回集群中节点的信息。

print(es.nodes.info())  # 返回所节点
print(es.nodes.info(node_id='node1'))   # 指定一个节点
print(es.nodes.info(node_id=['node1', 'node2']))   # 指定多个节点列表

• es.nodes.stats，获取集群中节点统计信息。

print(es.nodes.stats())
print(es.nodes.stats(node_id='node1'))
print(es.nodes.stats(node_id=['node1', 'node2']))

• es.nodes.hot_threads，获取指定节点的线程信息。

print(es.nodes.hot_threads(node_id='node1'))
print(es.nodes.hot_threads(node_id=['node1', 'node2']))

• es.nodes.usage，获取集群中节点的功能使用信息。

print(es.nodes.usage())
print(es.nodes.usage(node_id='node1'))
print(es.nodes.usage(node_id=['node1', 'node2']))

7.Cat（查询）

• es.cat.allocation，返回分片使用情况。

print(es.cat.allocation())
print(es.cat.allocation(node_id=['node1']))
print(es.cat.allocation(node_id=['node1', 'node2'], format='json'))

• es.cat.count，Count提供对整个群集或单个索引的文档计数的快速访问。

print(es.cat.count())  # 集群内的文档总数
print(es.cat.count(index='py3'))  # 指定索引文档总数
print(es.cat.count(index=['py3', 'py2'], format='json'))  # 返回两个索引文档和

• es.cat.health，从集群中health里面过滤出简洁的集群健康信息。

• es.cat.indices，返回索引的信息；也可以使用此命令进行查询集群中有多少索引。

• es.cat.master，返回集群中主节点的IP，绑定IP和节点名称。

• es.cat.plugins，返回节点的插件信息。

• es.cat.shards，返回哪个节点包含哪些分片的信息。