Skip to main content
https://github.com/django-es/django-elasticsearch-dsl/actions/workflows/ci.yml/badge.svg https://codecov.io/gh/django-es/django-elasticsearch-dsl/coverage.svg?branch=master https://badge.fury.io/py/django-elasticsearch-dsl.svg https://readthedocs.org/projects/django-elasticsearch-dsl/badge/?version=latest&style=flat

Django Elasticsearch DSL is a package that allows indexing of django models in elasticsearch. It is built as a thin wrapper around elasticsearch-py so you can use all the features developed by the elasticsearch-py team.

You can view the full documentation at https://django-elasticsearch-dsl.readthedocs.io

Features

  • Based on elasticsearch-py so you can make queries with the Search class.

  • Django signal receivers on save and delete for keeping Elasticsearch in sync.

  • Management commands for creating, deleting, rebuilding and populating indices.

  • Elasticsearch auto mapping from django models fields.

  • Complex field type support (ObjectField, NestedField).

  • Index fast using parallel indexing.

  • Requirements

    • Django >= 4.2

    • Python 3.9, 3.10, 3.11, 3.12, 3.13

Elasticsearch Compatibility: The library is compatible with all Elasticsearch versions since 5.x but you have to use a matching major version:

  • For Elasticsearch 9.0 and later, use the major version 9 (9.x.y) of the library.

  • For Elasticsearch 8.0 and later, use the major version 8 (8.x.y) of the library.

  • For Elasticsearch 7.0 and later, use the major version 7 (7.x.y) of the library.

  • For Elasticsearch 6.0 and later, use the major version 6 (6.x.y) of the library.

# Elasticsearch 9.x
elasticsearch>=9.0.0,<10.0.0

# Elasticsearch 8.x
elasticsearch-dsl>=8.0.0,<9.0.0

# Elasticsearch 7.x
elasticsearch-dsl>=7.0.0,<8.0.0

# Elasticsearch 6.x
elasticsearch-dsl>=6.0.0,<7.0.0

History

7.1.4 (2020-07-05)

  • Configure Elasticsearch _id dynamically from document (#272)

  • Use chain.from_iterable in for performance improvement (#278)

  • Handle case where SimpleLazyObject being treated as an Iterable (#255)

  • Camelcase default value in management command (#254)

  • Various updates and fixup in docs (#250, #276)

  • Start testing against Python 3.8 (#266)

7.1.1 (2019-12-26)

  • Adding detailed documentation and published to Read The Docs #222

  • Resolve name resolution while delete, create index (#228)

  • Added support for Django 3.0. (#230)

  • Removing old Elasticsearc compatibility (#219)

  • Drop StringField in favor of TextField.

7.1.0 (2019-10-29)

  • Support for Django DecimalField #141

  • Indexing speedup by using parallel indexing. #213. Now you can pass –parallel or set ELASTICSEARCH_DSL_PARALLEL in your settings to get indexing speed boost while indexing through management command.

  • Fixing name resolution in management command #206

  • Small documentation fixes. #196

7.0.0 (2019-08-11)

  • Support Elasticsearch 7.0 (See PR #176)

  • Added order by to paginate queryset properly (See PR #153)

  • Remove standard token filter from README.md and test files

  • Various documentation fixes

6.4.2 (2019-07-26)

  • Fix document importing path

  • Update readme

6.4.1 (2019-06-14)

  • The DocType import has changed to Document

6.4.0 (2019-06-01)

  • Support elasticsearch-dsl>6.3.0

  • Class Meta has changed to class Django (See PR #136)

  • Add register_document decorator to register a document (See PR #136)

  • Additional Bug fixing and others

0.5.1 (2018-11-07)

  • Limit elastsearch-dsl to supported versions

0.5.0 (2018-04-22)

  • Add Support for Elasticsearch 6 thanks to HansAdema

Breaking Change:

Django string fields now point to ES text field by default. Nothing should change for ES 2.X but if you are using ES 5.X, you may need to rebuild and/or update some of your documents.

0.4.5 (2018-04-22)

  • Fix prepare with related models when deleted (See PR #99)

  • Fix unwanted calls to get_instances_from_related

  • Fix for empty ArrayField (CBinyenya)

  • Fix nested OneToOneField when related object doesn’t exist (CBinyenya)

  • Update elasticsearch-dsl minimal version

0.4.4 (2017-12-13)

  • Fix to_queryset with es 5.0/5.1

0.4.3 (2017-12-12)

  • Fix syncing of related objects when deleted

  • Add django 2.0 support

0.4.2 (2017-11-27)

  • Convert lazy string to string before serialization

  • Readme update (arielpontes)

0.4.1 (2017-10-17)

  • Update example app with get_instances_from_related

  • Typo/grammar fixes

0.4.0 (2017-10-07)

  • Add a method on the Search class to return a django queryset from an es result

  • Add a queryset_pagination option to DocType.Meta for allow the pagination of big django querysets during the index populating

  • Remove the call to iterator method for the django queryset

  • Fix DocType inheritance. The DocType is store in the registry as a class and not anymore as an instance

0.3.0 (2017-10-01)

  • Add support for resynching ES documents if related models are updated (HansAdema)

  • Better management for django FileField and ImageField

  • Fix some errors in the doc (barseghyanartur, diwu1989)

0.2.0 (2017-07-02)

  • Replace simple model signals with easier to customise signal processors (barseghyanartur)

  • Add options to disable automatic index refreshes (HansAdema)

  • Support defining DocType indexes through Meta class (HansAdema)

  • Add option to set default Index settings through Django config (HansAdema)

0.1.0 (2017-05-26)

  • First release on PyPI.

Metadata

Release files for django-elasticsearch-dsl 9.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for django-elasticsearch-dsl 9.0
File Size Uploaded
django_elasticsearch_dsl-9.0.tar.gz 31.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for django-elasticsearch-dsl 9.0
File Interpreter ABI Platform
django_elasticsearch_dsl-9.0-py2.py3-none-any.whl Python 2, Python 3 none any Details

Total release size: 52.6 kB

Release files / django_elasticsearch_dsl-9.0.tar.gz

Download URL django_elasticsearch_dsl-9.0.tar.gz
Size 31.6 kB
Tags Source
SHA-256 checksum
How to use checksums
2fb39478fcde20a3ab1b800676e57ef3de15327c0eda16d192aca3823651bdaf
BLAKE2b-256 checksum
How to use checksums
98923ea6a083afaccf758d41ff470bc4ff3bfbbfa411ce243816400d48ae42de
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.9.20

Release files / django_elasticsearch_dsl-9.0-py2.py3-none-any.whl

Download URL django_elasticsearch_dsl-9.0-py2.py3-none-any.whl
Size 21.0 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
728c691d9d2cf413e902444e180cfcccc79adbbe9b59eb82860ea73ae7ef3a9f
BLAKE2b-256 checksum
How to use checksums
10ca67bc5ca78cdfbb53bd0d8d6cdafef17231241a85c62cc56ab6dae9a9a815
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.9.20

Release history Release notifications | RSS feed

This release

9.0 This release

2 release files

8.2

2 release files

8.1

2 release files

8.0

2 release files

7.4

2 release files

7.3

2 release files

7.2.2

2 release files

7.2.1

2 release files

7.2.0

2 release files

7.1.4

2 release files

7.1.3

2 release files

7.1.2

2 release files

7.1.1

2 release files

7.1.0

2 release files

7.0.0

2 release files

6.5.0

2 release files

6.4.2

2 release files

6.4.1

2 release files

6.4.0

1 release file

0.5.1

2 release files

0.5.0

1 release file

0.4.5

1 release file

0.4.4

1 release file

0.4.3

1 release file

0.4.2

1 release file

0.4.1

1 release file

0.4.0

1 release file

0.3.0

1 release file

0.2.0

1 release file

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page