1.使用Docker安裝Elasticsearch及其擴展
獲取鏡像,可以通過網絡pull
sudo docker image pull delron/elasticsearch-ik:2.4.6-1.0
或者加載鏡像文件
sudo docker load -i elasticsearch-ik-2.4.6_docker.tar
修改elasticsearch的配置文件 elasticsearc-2.4.6/config/elasticsearch.yml第54行,更改ip地址爲本機ip地址
network.host: 127.0.0.1
創建docker容器運行
sudo docker run -dti --network=host --name=elasticsearch -v /home/python/elasticsearch-2.4.6/config:/usr/share/elasticsearch/config delron/elasticsearch-ik:2.4.6-1.0
2. 使用haystack對接Elasticsearch
1)安裝
pip install drf-haystack
pip install elasticsearch==2.4.1
drf-haystack是爲了在REST framework中使用haystack而進行的封裝(如果在Django中使用haystack,則安裝django-haystack即可)。
2)註冊應用
INSTALLED_APPS = [
...
'haystack',
...
]
3)配置
在配置文件中配置haystack使用的搜索引擎後端
# Haystack
HAYSTACK_CONNECTIONS = {
'default': {
'ENGINE': 'haystack.backends.elasticsearch_backend.ElasticsearchSearchEngine',
'URL': 'http://127.0.0.1:9200/', # 此處爲elasticsearch運行的服務器ip地址,端口號固定爲9200
'INDEX_NAME': 'meiduo', # 指定elasticsearch建立的索引庫的名稱
},
}
# 當添加、修改、刪除數據時,自動生成索引
HAYSTACK_SIGNAL_PROCESSOR = 'haystack.signals.RealtimeSignalProcessor'
4)創建索引類
指明讓搜索引擎對哪些字段建立索引
goods應用中新建search_indexes.py文件,用於存放索引類(文件名固定)
from haystack import indexes
from .models import SKU
class SKUIndex(indexes.SearchIndex, indexes.Indexable):
"""
SKU索引數據模型類
"""
text = indexes.CharField(document=True, use_template=True)
def get_model(self):
"""返回建立索引的模型類"""
return SKU
def index_queryset(self, using=None):
"""返回要建立索引的數據查詢集"""
return self.get_model().objects.filter(is_launched=True)
-
document=True 表名該字段是主要進行關鍵字查詢的字段
-
use_template=True 表示通過模板來指明索引值由哪些模型類字段組成
5)在templates目錄中創建text字段使用的模板文件
在templates/search/indexes/goods/sku_text.txt文件中定義
{{ object.name }}
{{ object.caption }}
{{ object.id }}
- 路徑固定: templates/search/indexes/建立索引的應用名/文件名.txt
- 通過sku的name、caption、id來進行關鍵字索引查詢
6)手動生成初始索引
python manage.py rebuild_index
7)創建序列化器
在goods/serializers.py中創建haystack序列化器
from drf_haystack.serializers import HaystackSerializer
class SKUIndexSerializer(HaystackSerializer):
"""
SKU索引結果數據序列化器
"""
object = SKUSerializer(read_only=True)
class Meta:
index_classes = [SKUIndex]
fields = ('text', 'object')
說明:
- 使用SKUIndexSerializer序列化器用來檢查前端傳入的參數text,並且檢索出數據後再使用這個序列化器返回給前端;
- SKUIndexSerializer序列化器中的object字段是用來向前端返回數據時序列化的字段。
8)創建視圖
在goods/views.py中創建視圖
from drf_haystack.viewsets import HaystackViewSet
class SKUSearchViewSet(HaystackViewSet):
"""
SKU搜索
"""
index_models = [SKU]
serializer_class = SKUIndexSerializer
9)定義路由
通過REST framework的router來定義路由
router = DefaultRouter()
router.register('skus/search', views.SKUSearchViewSet, base_name='skus_search')
urlpatterns += router.urls
bug說明:
如果在配置完haystack並啓動程序後,出現如下異常,是因爲drf-haystack還沒有適配最新版本的REST framework框架
importError: cannot import name '_get_count'
可以通過修改REST framework框架代碼,補充_get_count
函數定義即可
文件路徑 虛擬環境下的 lib/python3.6/site-packages/rest_framework/pagination.py
def _get_count(queryset):
"""
Determine an object count, supporting either querysets or regular lists.
"""
try:
return queryset.count()
except (AttributeError, TypeError):
return len(queryset)