libre.sh/keycloak-scim
4
0
Fork 0
Code Issues 15 Pull requests Releases 1 Activity Actions

KEYCLOAK-11908 Support for conditional creating indices based on number

Browse source
This commit is contained in:
Yoshiyuki Tabata 2020-12-11 16:51:49 +09:00 committed by Hynek Mlnařík
parent 7ad57a47ca
commit 3dec29f789
1 changed files with 28 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

28
upgrading/topics/migrate_db.adoc
View file

@ -32,6 +32,34 @@ Or run this CLI command:
When you start the server with this setting your database is automatically migrated if the database schema has changed When you start the server with this setting your database is automatically migrated if the database schema has changed
in the new version. in the new version.
Creating an index on huge tables with millions of records can easily take a huge amount of time
and potentially cause major service disruption on upgrades.
For those cases, we added a threshold (the number of records) for automated index creation.
By default, this threshold is `100000` records.
When the number of records is higher than the threshold, the index is not created automatically,
and there will be a warning message in server logs including SQL commands which can be applied later manually.
To change the threshold, set the `indexCreationThreshold` property, value for the default `connectionsLiquibase` provider:
[source,xml]
----
<spi name="connectionsLiquibase">
<provider name="default" enabled="true">
<properties>
<property name="indexCreationThreshold" value="100000"/>
</properties>
</provider>
</spi>
----
Or run this CLI command:
[source,bash]
----
/subsystem=keycloak-server/spi=connectionsLiquibase/:add(default-provider=default)
/subsystem=keycloak-server/spi=connectionsLiquibase/provider=default/:add(properties={indexCreationThreshold => "100000"},enabled=true)
----
=== Manual Relational Database Migration === Manual Relational Database Migration
To enable manual upgrading of the database schema, set the migrationStrategy property value to "manual" for the default To enable manual upgrading of the database schema, set the migrationStrategy property value to "manual" for the default