Fix typo FR + article in EN

blog/2024-08-26-duckdb-launch.md

@@ -1,6 +1,6 @@
 ---
-title: DuckDB launch
-description: Are you a Home Assistant user who wants to test Gladys without touching your installation? It's possible!
+title: "DuckDB: Extreme Performance and a 97% Lighter Database!"
+description: A major Gladys update that will revolutionize your experience.
 author: Pierre-Gilles Leymarie
 author_title: Founder of Gladys Assistant
 author_url: https://twitter.com/pierregillesl
@@ -9,4 +9,184 @@ image: /img/presentation/duckdb-launch.jpg
 slug: gladys-and-duckdb
 ---
 
-DuckDB
+Hi everyone,
+
+Today is a big day: I’m releasing a major version of Gladys that will drastically improve the Gladys experience and keep us at the cutting edge of data storage technology.
+
+Imagine...
+
+➡️ Your Gladys database shrinking from 47 GB to 1.5 GB...\
+➡️ Your charts displaying instantly, even over long periods of data...\
+➡️ Your Gladys Plus backups becoming lighter and faster...
+
+Well, we did it!
+
+## The Technology: DuckDB
+
+[DuckDB](https://duckdb.org/) is an OLAP database system that, like SQLite, stores data in a single file.
+
+<!--truncate-->
+
+If we had to define DuckDB:
+
+> DuckDB is an analytical database engine designed to offer optimal performance on large volumes of data while remaining lightweight and easy to integrate. It is particularly suited for embedded data analysis, with native support for complex SQL queries and efficient in-memory processing.
+
+DuckDB, with its OLAP + file approach, is unique in its kind, and I had been monitoring this technology for several years.
+
+Until recently, DuckDB was in alpha and therefore not ready to be used in production on a critical product like Gladys.
+
+But in June, DuckDB finally reached version 1.0, with a clear announcement that the API and file format would no longer undergo major changes, making DuckDB suitable for production use.
+
+## Integration into Gladys
+
+Following the launch of version 1.0, I immediately started development in Gladys and did a YouTube live stream to test the technology with you:
+
+<div class="youtubeVideoContainerInBlog">
+    <iframe  src="https://www.youtube.com/embed/EtEfyS6uHoE" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
+</div>
+<br />
+
+We quickly saw together that the technology was very promising, so I continued development.
+
+In a nutshell, the tasks included:
+
+- Migrating the sensor history currently in SQLite to DuckDB (and if possible, without downtime)
+- Setting up an interface to monitor the migration and a way to "clean" the SQLite DB afterward
+- Modifying all the code that writes historical sensor values
+- Rewriting the dashboard chart display queries
+- Reviewing the entire Gladys Plus backup process
+- Finally, testing the migration in real-world scenarios to see if DuckDB works well in daily use on real instances.
+
+In short, there was a lot of work to do!
+
+## The Result
+
+On August 6th, I started the "real" tests on my personal Gladys setup.
+
+My instance has about forty devices and has been live since February 2024.
+
+I had a 905 MB database, with 996,000 sensor states, which after migration was reduced to:
+
+![SQLite to DuckDB Reduction Percentage Pierre-Gilles](../static/img/articles/en/gladys-and-duckdb/pierregilles-duckdb.jpg)
+
+Yes, you read that right, my database was reduced to 19 MB! It's almost ridiculous!
+
+For the largest Gladys user, Terdious, with 80 million states for a 47.7 GB database, it was reduced to:
+
+![SQLite to DuckDB Reduction Percentage Terdious](../static/img/articles/en/gladys-and-duckdb/terdious-duckdb.jpg)
+
+In short, it's quite revolutionary!
+
+For the past 20 days, this new version has been running smoothly on my setup and other Gladys users' setups.
+
+The charts are much faster; Terdious noticed load times twice as fast on his mini-PC.
+
+On his Pi 4, it's even more impressive, with dashboards containing charts now displaying in 150 ms compared to 1 to 5 seconds before.
+
+## How Does It Work Under the Hood?
+
+At this point, you might be thinking: is this magic?
+
+Actually, not really:
+
+- First of all, SQLite is not suited for this use case, so we were forced to store information 4 times in the database: once for the "raw" data, once for monthly aggregated data, once for daily aggregated data, and once for hourly aggregated data. This allowed us to fetch data more quickly from pre-reduced datasets.
+- Then, on the SQLite side, I had added very specific indexes to respond to queries like "Show me the values of temperature sensor XX between this morning and now." These multi-column indexes provided good performance but were storage-intensive (again, this is redundancy).
+- Finally, DuckDB does an outstanding job. The data is aggressively compressed (If you're interested, there's [an article on their blog](https://duckdb.org/2022/10/28/lightweight-compression.html)).
+
+For example, in the case of Gladys, if you have a binary sensor (door open sensor, motion sensor, leak sensor, etc.), the data is just 0s and 1s: there are only 2 possible values.
+
+This kind of dataset is very easy to compress:
+
+![DuckDB Compression](../static/img/articles/en/gladys-and-duckdb/duckdb-encoding.png)
+
+## How to Update?
+
+Gladys should normally update automatically if you use Watchtower.
+
+If you installed Gladys with Docker, make sure you're using Watchtower. See the [documentation](/fr/docs/installation/docker#mise-à-jour-automatique-avec-watchtower).
+
+If you're impatient and know what you're doing, you can also manually run Watchtower in "one-shot" mode:
+
+```sh
+docker run --rm \
+    -v /var/run/docker.sock:/var/run/docker.sock \
+    containrrr/watchtower \
+    --run-once
+```
+
+(Don't forget to use sudo if you're running Gladys as an administrator)
+
+Once Gladys is updated to `v4.45.0`, there are several steps to take before seeing your DB shrink.
+
+## The Migration
+
+As soon as your instance updates, the migration to DuckDB will begin.
+
+At the top of your dashboard, you will see a message:
+
+![Migration to DuckDB](../static/img/articles/en/gladys-and-duckdb/duckdb-migration.png)
+
+During this migration, your instance may be slowed down, and your charts will not be available.
+
+You can find the migration status in "Settings → System":
+
+![Migration to DuckDB Summary](../static/img/articles/en/gladys-and-duckdb/duckdb-migration-recap.png)
+
+Once the migration is complete, the "Migration completed" line will change from "No" to "Yes."
+
+Take a moment to browse Gladys and check that all your charts look correct.
+
+If everything looks good, you can then purge the SQLite states by clicking the red "Purge SQLite states" button, which will start a task:
+
+![SQLite Purge](../static/img/articles/en/gladys-and-duckdb/sqlite-state-purge.png)
+
+During this task, your Gladys instance will be a bit slower, which is normal.
+
+Depending on the number of states in your database and the speed of your disk, this task can take a few hours or even days if you have a large DB.
+
+Gladys remains usable, but slower!
+
+Finally, once this purge is complete, you'll need to clean the SQLite DB so that the file on your disk is finally reduced.
+
+To do this, click on the "Clean database" button:
+
+![Clean Database](../static/img/articles/en/gladys-and-duckdb/clean-db.png)
+
+This task is **blocking**, and Gladys will not be available during the cleanup.
+
+Finally, once the task is done, restart Gladys.
+
+You're done! You should now have a much smaller database and a much faster Gladys instance!
+
+## Conclusion
+
+I hope this update will bring you the same results as it has for all the testers!
+
+In any case, I'm convinced that this update will revolutionize the use of Gladys, and I welcome your feedback.
+
+Thanks again to all the testers who helped in the development 🙏
+
+## Getting Started with Gladys?
+
+If you want to get started with Gladys and don't have the hardware, I'm launching a unique starter kit!
+
+I'm offering:
+
+- A powerful mini-PC (the same one I have at home)
+- Access to the Gladys training (plenty of video and written content)
+- One year of Gladys Plus
+
+All at an unbeatable price.
+
+To learn more, [click here](/fr/starter-kit/)!
+
+## Supporting the Project
+
+There are many ways to support the project:
+
+- Participate in discussions on the forum, help newcomers.
+- Contribute to the project by proposing new integrations/features.
+- Improve the documentation, which is open source.
+- Take advantage of the [Gladys training (-25% off currently!)](https://formation.gladysassistant.com/?coupon=DUCKDB_LAUNCH).
+
+Thanks to everyone who supports Gladys 🙏

i18n/fr/docusaurus-plugin-content-blog/2024-08-26-duckdb-launch.md

@@ -1,6 +1,6 @@
 ---
 title: "DuckDB : Des performances extrêmes et une base de données 97% plus légère !"
-description: Une mise à jour majeure de Gladys qui va révolutionner votre utilisation
+description: Une mise à jour majeure de Gladys qui va révolutionner votre utilisation.
 author: Pierre-Gilles Leymarie
 author_title: Fondateur de Gladys Assistant
 author_url: https://twitter.com/pierregillesl
@@ -11,7 +11,7 @@ slug: gladys-and-duckdb
 
 Salut à tous,
 
-Aujourd'hui est un grand jour : je sors une version majeure de Gladys qui va améliorer drastiquement l'expérience Gladys et qui nous permet d'être à la pointe en termes de technologie de stockage de données.
+Aujourd'hui est un grand jour : je sors une version majeure de Gladys qui va améliorer drastiquement l'expérience Gladys et qui nous permet d'être à la pointe en terme de technologie de stockage de données.
 
 Imaginez...
 
@@ -35,7 +35,7 @@ DuckDB avec son approche OLAP + fichier est unique en son genre, et je surveilla
 
 Jusque-là, DuckDB était en alpha et n'était donc pas prêt à être utilisée en production sur un produit aussi critique que Gladys.
 
-Mais en juin, DuckDB est enfin sorti en 1.0, et a clairement annoncé que l'API et le format de fichier n'allait plus changer de façon majeure, et ainsi DuckDB devenait utilisable en production.
+Mais en juin, DuckDB est enfin sorti en 1.0, et a clairement annoncé que l'API et le format de fichier n'allaient plus changer de façon majeure, et ainsi DuckDB devenait utilisable en production.
 
 ## L'intégration dans Gladys
 
@@ -65,7 +65,7 @@ Le 6 août, j'ai lancé les tests "réels" en commençant sur mon installation G
 
 Mon instance a une quarantaine d'appareils, et est live depuis février 2024.
 
-J'avais une base de donnée de 905 Mo, pour 996 000 états de capteurs, qui une fois migré est passé à :
+J'avais une base de donnée de 905 Mo, pour 996 000 états de capteurs, qui une fois migrée est passée à :
 
 ![Pourcentage de réduction SQLite vers DuckDB Pierre-Gilles](../../../static/img/articles/fr/gladys-and-duckdb/pierregilles-duckdb.jpg)
 
@@ -77,7 +77,7 @@ Chez le plus gros utilisateur Gladys, Terdious, avec 80 millions d'états pour u
 
 Bref, c'est assez révolutionnaire !
 
-Depuis maintenant 20 jours, cette nouvelle version tourne chez moi et d'autres utilisateurs Gladys sans aucuns soucis.
+Depuis maintenant 20 jours, cette nouvelle version tourne chez moi et d'autres utilisateurs Gladys sans aucun soucis.
 
 Les graphiques sont beaucoup plus rapides, Terdious a remarqué des temps de chargement 2 fois plus rapide sur son mini-PC.
 
@@ -89,7 +89,7 @@ Sur son Pi 4, c'est encore plus impressionnant, les tableaux de bords comportant
 
 En fait, pas vraiment :
 
-- Déjà, SQLite n'étant pas adapté pour cet usage, nous étions obligés de stocker l'information 4 fois dans la base de donnée : une fois pour la donnée "brute", une fois pour des données agrégées mensuels, une fois pour des données agrégées journalières, et une fois pour des données agrégées horaires. Cela nous permettait d'aller chercher plus vite dans des jeux de données réduits en amont.
+- Déjà, SQLite n'étant pas adapté pour cet usage, nous étions obligés de stocker l'information 4 fois dans la base de donnée : une fois pour la donnée "brute", une fois pour des données agrégées mensuelles, une fois pour des données agrégées journalières, et une fois pour des données agrégées horaires. Cela nous permettait d'aller chercher plus vite dans des jeux de données réduits en amont.
 - Ensuite, côté SQLite, j'avais ajouté des index très précis pour répondre à des requêtes du style "Montre-moi les valeurs du capteur de température XX entre ce matin et maintenant". Ces index multicolonnes permettaient d'avoir de bonnes performances, mais étaient gourmands en stockage (là encore, c'est de la redondance).
 - Enfin, DuckDB fait un travail formidable. Les données sont compressées aggressivement (Si ça vous intéresse, il y a [article sur leur blog](https://duckdb.org/2022/10/28/lightweight-compression.html)).
 
@@ -148,15 +148,15 @@ Gladys reste utilisable, mais ralentie !
 
 Enfin, une fois cette purge terminée, vous devrez faire un nettoyage de la DB SQLite pour que le fichier sur votre disque soit finalement réduit.
 
-Pour cela, cliquez sur le bouton "Nettoyer la base de donnée" :
+Pour cela, cliquez sur le bouton "Nettoyer la base de données" :
 
 ![Nettoyer la base de donnée](../../../static/img/articles/fr/gladys-and-duckdb/clean-db.png)
 
 Cette tâche est **bloquante** et Gladys ne sera pas disponible pendant le nettoyage.
 
 Enfin, une fois la tâche terminée, redémarrez Gladys.
 
-C'est bon, vous devriez avoir une base de donnée beaucoup plus petite et une instance Gladys bien plus rapide !
+C'est bon, vous devriez avoir une base de données beaucoup plus petite et une instance Gladys bien plus rapide !
 
 ## Conclusion