注意：Django中Haystack，由于Elasticsearch-6以后的版本一个索引下只能一个类型，因此Haystack无法支持Elasticsearch6以上版本
基于以上原因个人建议不要使用Haystack与Elasticsearch的组合
1.使用docker安装Elasticsearch环境
# 拉取镜像
docker image pull delron/elasticsearch-ik:2.4.6-1.0
# 运行容器
"""此处需要映射9200，9300两个端口用于通信"""
docker run -d -p 9200:9200 -p 9300:9300 --name search delron/elasticsearch-ik:2.4.6-1.0
2.安装依赖包
pip3 install drf-haystack
pip3 install elasticsearch
pip3 install djangorestframework
3.注册app
# django配置文件中注册
INSTALLED_APPS = [
...
'haystack',
'rest_framework'
]
4.设置Haystack的搜索引擎
HAYSTACK_CONNECTIONS = {
'default': {
'ENGINE': 'haystack.backends.elasticsearch_backend.ElasticsearchSearchEngine',
'URL': 'http://172.16.209.100:9200/', # 此处为elasticsearch运行的服务器ip地址，端口号固定为9200
'INDEX_NAME': 'test', # 指定elasticsearch建立的索引库的名称
},
}
# 当添加、修改、删除数据时，自动生成索引
HAYSTACK_SIGNAL_PROCESSOR = 'haystack.signals.RealtimeSignalProcessor'
# 指定搜索结果每页的条数
# HAYSTACK_SEARCH_RESULTS_PER_PAGE = 1
5.创建索引类
"""创建model类"""
from django.db import models
class Book(models.Model):
nid=models.AutoField(primary_key=True)
name=models.CharField(max_length=32)
publish=models.CharField(max_length=32)
price=models.DecimalField(max_digits=5,decimal_places=2)
#插入多条数据
"""在需要索引的应用目录下创建文件search_indexes.py文件，创建索引类"""
# 索引模型类的名称必须是 模型类名称 + Index
from haystack import indexes
from .models import Book
class BookIndex(indexes.SearchIndex, indexes.Indexable):
text = indexes.CharField(document=True, use_template=True)
def get_model(self):
"""返回建立索引的模型类"""
return Book
def index_queryset(self, using=None):
"""返回要建立索引的数据查询集"""
return self.get_model().objects.all()
"""
说明:
1.在BookIndex建立的字段，都可以借助haystack由elasticsearch搜索引擎查询。
2.其中text字段声明为document=True，表名该字段是主要进行关键字查询的字段， 该字段的索引值可以由多个数据库模型类字段组成(是多个字段,不是多个数据库模型类,转者注)，具体由哪些模型类字段组成，我们用use_template=True表示后续通过模板来指明。
3.在 REST framework中，索引类的字段会作为查询结果返回数据的来源,
"""
6.创建text字段使用的模板文件
"""创建文件templates/search/indexes/app名字/book_text.txt"""
{{ object.name }}
{{ object.publish }}
7.更新索引
python manage.py rebuild_index #数据库有多少条数据，全部会被同步到es中
8.创建Haystack序列化器
from drf_haystack.serializers import HaystackSerializer
from rest_framework.serializers import ModelSerializer
from app_test import models
from app_test.search_indexes import BookIndex
class BookSerializer(ModelSerializer):
class Meta:
model=models.Book
fields='__all__'
class BookIndexSerializer(HaystackSerializer):
object = BookSerializer(read_only=True) # 只读,不可以进行反序列化
class Meta:
index_classes = [BookIndex]# 索引类的名称
fields = ('text', 'object')# text 由索引类进行返回, object 由序列化类进行返回,第一个参数必须是text
9.创建视图类
from drf_haystack.viewsets import HaystackViewSet
from app_test.models import Book
from app_test.serializers import BookIndexSerializer
class BookSearchView(HaystackViewSet):
index_models = [Book]
serializer_class = BookIndexSerializer
#该视图会返回搜索结果的列表数据，所以如果可以为视图增加REST framework的分页功能。
#我们在配置文件已经定义了分页配置，所以此搜索视图会进行分页
10.添加路由
from django.conf.urls import url
from django.contrib import admin
from rest_framework import routers
from app_test.views import BookSearchView
router = routers.DefaultRouter()
router.register("book/search", BookSearchView, base_name="book-search")
urlpatterns = [
url(r'^admin/', admin.site.urls),
]
urlpatterns += router.urls
