django-elastic-migrations 0.8.2

用法

安装

1. pip install django elastic migrations ；请参见pypi上的 django elastic migrations 。

2. 在 requirements.txt中引用此包

3. 确保可访问有效的elasticsearch dsl py版本，并进行配置 Django设置中配置的ElasticSearch Singleton客户端的路径： django_elastic_migrations_es_client="tests.es_config.es_client" 。 在您的应用程序中应该只有一个实例化的es_客户端。

4. 将django弹性迁移添加到django中已安装的应用程序中 设置文件

5. 将以下信息添加到django设置文件：

   DJANGO_ELASTIC_MIGRATIONS_ES_CLIENT = "path.to.your.singleton.ES_CLIENT"
   # optional, any unique number for your releases to associate with indexes
   DJANGO_ELASTIC_MIGRATIONS_GET_CODEBASE_ID = subprocess.check_output(['git', 'describe', "--tags"]).strip()
   # optional, can be used to have multiple servers share the same
   # elasticsearch instance without conflicting
   DJANGO_ELASTIC_MIGRATIONS_ENVIRONMENT_PREFIX = "qa1_"
   

6. 通过运行 /manage.py migrate创建 django_elastic_migrations 表

7. 创建一个 demindex ：

   from django_elastic_migrations.indexes import DEMIndex, DEMDocType
   from .models import Movie
   from elasticsearch_dsl import Text
   
   MoviesIndex = DEMIndex('movies')
   
   
   @MoviesIndex.doc_type
   class MovieSearchDoc(DEMDocType):
       text = TEXT_COMPLEX_ENGLISH_NGRAM_METAPHONE
   
       @classmethod
       def get_queryset(self, last_updated_datetime=None):
           """
           return a queryset or a sliceable list of items to pass to
           get_reindex_iterator
           """
           qs = Movie.objects.all()
           if last_updated_datetime:
               qs.filter(last_modified__gt=last_updated_datetime)
           return qs
   
       @classmethod
       def get_reindex_iterator(self, queryset):
           return [
               MovieSearchDoc(
                   text="a little sample text").to_dict(
                   include_meta=True) for g in queryset]
   

8. 将新索引添加到settings/common.py中的django_elastic_migrations_index

9. 运行 /manage.py es_list以查看可用的索引：

   ./manage.py es_list
   
   Available Index Definitions:
   +----------------------+-------------------------------------+---------+--------+-------+-----------+
   |   Index Base Name    |         Index Version Name          | Created | Active | Docs  |    Tag    |
   +======================+=====================================+=========+========+=======+===========+
   | movies               |                                     | 0       | 0      | 0     | Current   |
   |                      |                                     |         |        |       | (not      |
   |                      |                                     |         |        |       | created)  |
   +----------------------+-------------------------------------+---------+--------+-------+-----------+
   Reminder: an index version name looks like 'my_index-4', and its base index name
   looks like 'my_index'. Most Django Elastic Migrations management commands
   take the base name (in which case the activated version is used)
   or the specific index version name.
   

10. 使用 /manage.py es_create movies在elasticsearch中创建 电影 索引：

    $> ./manage.py es_create movies
    The doc type for index 'movies' changed; created a new index version
    'movies-1' in elasticsearch.
    $> ./manage.py es_list
    
    Available Index Definitions:
    +----------------------+-------------------------------------+---------+--------+-------+-----------+
    |   Index Base Name    |         Index Version Name          | Created | Active | Docs  |    Tag    |
    +======================+=====================================+=========+========+=======+===========+
    | movies               | movies-1                            | 1       | 0      | 0     | 07.11.005 |
    |                      |                                     |         |        |       | -93-gd101 |
    |                      |                                     |         |        |       | a1f       |
    +----------------------+-------------------------------------+---------+--------+-------+-----------+
    
    Reminder: an index version name looks like 'my_index-4', and its base index name
    looks like 'my_index'. Most Django Elastic Migrations management commands
    take the base name (in which case the activated version is used)
    or the specific index version name.
    

11. 激活 movies-1索引版本，以便所有更新和读取都转到它。

    ./manage.py es_activate movies
    For index 'movies', activating 'movies-1' because you said so.
    

12. 假设您已经实现了 get reindex\u迭代器，那么您可以调用 /manage.py es_update 更新索引。

    $> ./manage.py es_update movies
    
    Handling update of index 'movies' using its active index version 'movies-1'
    Checking the last time update was called:
     - index version: movies-1
     - update date: never
    Getting Reindex Iterator...
    Completed with indexing movies-1
    
    $> ./manage.py es_list
    
    Available Index Definitions:
    +----------------------+-------------------------------------+---------+--------+-------+-----------+
    |   Index Base Name    |         Index Version Name          | Created | Active | Docs  |    Tag    |
    +======================+=====================================+=========+========+=======+===========+
    | movies               | movies-1                            | 1       | 1      | 3     | 07.11.005 |
    |                      |                                     |         |        |       | -93-gd101 |
    |                      |                                     |         |        |       | a1f       |
    +----------------------+-------------------------------------+---------+--------+-------+-----------+
    

< > >