Aller au contenu
Krizaka Java
Skip to Content
Krizaka Java

Persistance

krizaka-persistence — les tables des stockages JDBC du kit créées et migrées au démarrage, dans leur propre historique Flyway.

<dependency>
  <groupId>com.krizaka</groupId>
  <artifactId>krizaka-spring-boot-starter-persistence</artifactId>
</dependency>

Déclare les stockages ; leurs tables existent une fois le contexte démarré — pas de script initdb, pas de DDL copié dans tes migrations.

Tu déclaresTableVersion
krizaka.messaging.outbox.jdbc.enabled: truekrizaka_outbox1.1
krizaka.messaging.dedup.store: jdbcprocessed_messages1.2
krizaka-app-config, stockage jdbcapp_config, app_config_history2.1
krizaka.idempotency.store: jdbcidempotency_keys3.1

Comment elle migre

  • Flyway exécute le schéma que livre chaque module — le fichier que le module documente, jamais une copie.
  • Dans sa propre table d'historique, krizaka_schema_history : les versions du kit ne croisent jamais ton db/migration.
  • Seulement les stockages déclarés ; un stockage ajouté plus tard est migré hors ordre, à sa propre version.
  • Les tables qu'un opérateur a déjà créées depuis les schémas livrés sont adoptées : les schémas sont IF NOT EXISTS, l'historique est initialisé, un index manquant est ajouté.
  • Une propriété de table (krizaka.messaging.outbox.jdbc.table…) renomme la table et ses index. La renommer après sa création fait échouer la validation de Flyway au lieu de créer en silence une seconde table.

krizaka.persistence.migrations.enabled: false laisse les tables à un opérateur, qui exécute les schémas livrés.

Défauts du pool

À la priorité la plus basse — ton application.yml l'emporte :

PropriétéDéfautPourquoi
spring.datasource.hikari.leak-detection-threshold20000une connexion tenue 20 s est journalisée avec la pile qui l'a prise
spring.datasource.hikari.connection-timeout10000attendre une connexion échoue en 10 s, pas 30

Prouvé

KrizakaMigrationsIT s'exécute sur PostgreSQL : chaque ensemble, une relance sans effet, un ensemble ajouté hors ordre, ton propre historique Flyway intact, l'adoption de tables créées à la main, un renommage refusé après création.

Configuration

PropriétéDescription
krizaka.persistence.migrations.enabledBooleandéfaut trueWhether the tables of the declared JDBC stores are created and migrated at startup. Turn it off when an operator runs the shipped schemas.
krizaka.persistence.migrations.history-tableStringdéfaut krizaka_schema_historyFlyway history table of the kit's migrations, kept apart from the service's own so their versions never meet.

Sur cette page