From 1f85da64e421f83814c8d3f38ed8b59afcdce93d Mon Sep 17 00:00:00 2001 From: Paul-Vincent Roll Date: Tue, 3 Dec 2024 22:16:43 +0100 Subject: [PATCH] Documentation: add search caveat when using MariaDB (#8424) Co-authored-by: shamoon <4887959+shamoon@users.noreply.github.com> --- docs/advanced_usage.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/docs/advanced_usage.md b/docs/advanced_usage.md index 2a001209b..c27f940c3 100644 --- a/docs/advanced_usage.md +++ b/docs/advanced_usage.md @@ -585,10 +585,13 @@ services: ### Case Sensitivity The database interface does not provide a method to configure a MySQL -database to be case sensitive. This would prevent a user from creating a +database to be case-sensitive. A case-**in**sensitive database prevents a user from creating a tag `Name` and `NAME` as they are considered the same. -Per Django documentation, to enable this requires manual intervention. +However, there is a downside to turning on case sensitivity, as it also makes searches case-sensitive, +so for example a document with the title `Invoice` won't be found when searching for `invoice`. + +Per Django documentation, making a database case-sensitive requires manual intervention. To enable case sensitive tables, you can execute the following command against each table: @@ -605,6 +608,8 @@ existing tables) with: an older system may fix issues that can arise while setting up Paperless-ngx but `utf8mb3` can cause issues with consumption (where `utf8mb4` does not). +For more information on this topic, you can refer to [this](https://code.djangoproject.com/ticket/9682) Django issue. + ### Missing timezones MySQL as well as MariaDB do not have any timezone information by default (though some