Django>=2.0的SphinxSearch数据库后端
django-sphinxsearch的Python项目详细描述
Django Sphinxsearch公司
SphinxSearch用于Django的数据库后端。
- 不是django_sphinx_db叉子
Django>=2.0,<2.3
支持
安装和使用
安装django sphinxsearch软件包
pip install django_sphinxsearch
配置django设置
INSTALLED_APPS+=('sphinxsearch',)SPHINX_DATABASE_NAME='sphinx'DATABASES[SPHINX_DATABASE_NAME]={'ENGINE':'sphinxsearch.backend.sphinx','HOST':'127.0.0.1','PORT':9306,'OPTIONS':{'use_unicode':False# if non-ascii letters looks bad in results}}DATABASE_ROUTERS=['sphinxsearch.routers.SphinxRouter']
在sphinx.conf中创建索引定义
index testapp_testmodel { type = rt path = /data/sphinx/testapp/testmodel/ rt_field = sphinx_field rt_attr_uint = attr_uint rt_attr_bool = attr_bool rt_attr_bigint = attr_bigint rt_attr_float = attr_float rt_attr_multi = attr_multi rt_attr_multi_64 = attr_multi_64 rt_attr_timestamp = attr_timestamp rt_attr_string = attr_string rt_attr_json = attr_json }
为索引定义django模型
fromdatetimeimportdatetimefromdjango.dbimportmodelsfromjsonfield.fieldsimportJSONFieldfromsphinxsearchimportmodelsasspx_modelsclassFieldMixin(spx_models.SphinxModel):# Note that NULL values are not allowed for sphinx rt-index.# Indexed text field. If no attribute with same name defined, can't be# retrieved from index.classMeta:abstract=True# Indexed text field. If no attribute with same name defined, can't be# retrieved from index.sphinx_field=spx_models.SphinxField(default='')other_field=spx_models.SphinxField(default='')# Numeric attributesattr_uint=spx_models.SphinxIntegerField(default=0,db_column='attr_uint_')attr_bigint=spx_models.SphinxBigIntegerField(default=0)attr_float=models.FloatField(default=0.0)attr_timestamp=spx_models.SphinxDateTimeField(default=datetime.now)attr_bool=models.BooleanField(default=False)# String attributesattr_string=models.CharField(max_length=32,default='')attr_json=JSONField(default={})# Multi-value fields (sets of integer values)attr_multi=spx_models.SphinxMultiField(default=[])attr_multi_64=spx_models.SphinxMulti64Field(default=[])classTestModel(FieldMixin,spx_models.SphinxModel):pass
从应用程序中查询索引
# Numeric attributes filteringTestModel.objects.filter(attr_uint=0,attr_float__gte=10,attr_multi__in=[1,2])# For sphinxsearch>=2.2.7, string attr filtering enabledTestModel.objects.filter(attr_string='some test')# Use mysql-fulltext-search filtering:TestModel.objects.filter(sphinx_field__search='find me')# Run match queriesTestModel.objects.match('find in all fields',sphinx_field='only in this field')# Insert and update documents to indexobj=TestModel.objects.create(**values)obj.attr_uint=1obj.save()TestModel.objects.filter(attr_bool=True).update(attr_uint=2)
生产使用注意事项
- sphinxsearch引擎在sql语法支持方面有一些问题,它们各不相同 从一个版本到另一个版本。也就是说,float属性是不可比较的, 字符串属性在v2.2.7之前是不可比较的。
- sphinxsearch只返回20个匹配的文档。
- uint属性接受-1,但将其作为无符号32位整数返回。
- bigint接受2**63+1,但将其作为带符号的64位整数返回。
- 使用sphinxintegerfield和sphinxbiginterfield而不是integerfield和
来自django.db.models的bigingerfield,因为in是
sql(
value IN column
),但sphinxsearch中的函数(IN(value, column)
)。 - 由于3.0.1 multi64字段错误地解析大于2**31的值,因此 对于bigint值完全不可用。
- 在3.1.1中,可以使用相同的字符串字段和配置中的attr创建rt索引 但无法克隆此索引,因此基于属性的筛选不起作用。