Migrate to AidboxDB 16
Since AidboxDB 16.1 does not have the jsonknife
extension on board as it was available in the previous versions there is the guide explaining how to migrate to it.
Check if extra DB migrations steps needed
Before migrating to AidboxDB 16, it's crucial to determine whether you have any indexes using that extension. To get list of indexes utilizing jsonknife
extension, run following SQL query:
sql
SELECT indexname, indexdef
FROM pg_indexes
WHERE indexdef ILIKE '%knife%';
- No Action Required:If the query returns an empty result set, no further actions are required regarding this extension.
- Action Required:If the query results are not empty, you must follow the following steps.
Migration Steps
Backup database
Begin by creating a complete backup of your database. For example, this can be achieved using the pg_dump
command:
sql
pg_dump -U [username] [dbname] > [backupfile].sql
Provision necessary functions in the new PostgreSQL cluster&x20;
To create necessary jsonknife
functions run the following SQL with-in your PG cluster.
{:tag "file", :lines ["{% file src=\"../../.gitbook/assets/jsonknife-function-shims.sql\" %}"]}
jsonknife function shims {% endfile %}
Restore database in the new cluster
Once the new functions are defined in the new cluster, restore database using, for example, pg_restore
.
sql
pg_restore -U [username] -d [dbname] [backupfile].sql