Cette page décrit la version 15.13.0 d'AlloyDB Omni à l'aide de l'option de déploiement Conteneurs. Choisissez une autre option de déploiement.

Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Mettre à niveau AlloyDB Omni vers la version 15.13.0 sur une VM

Sélectionnez une version de la documentation :

Cette page explique comment migrer de la version 15.5.2 ou antérieure vers la dernière version d'AlloyDB Omni.

À partir d'AlloyDB Omni 15.5.4, vous contrôlez AlloyDB Omni à l'aide d'outils de gestion de packages courants.

Si vous disposez d'une installation existante d'AlloyDB Omni, suivez les instructions de cette page pour migrer vers la nouvelle installation à image unique.

Prérequis

Avant de pouvoir commencer la mise à niveau vers la dernière version d'AlloyDB Omni, remplissez les prérequis suivants, si ce n'est pas déjà fait.

Mettre à niveau vers AlloyDB Omni 15.5.2

La dernière version d'AlloyDB Omni compatible avec l'interface de ligne de commande AlloyDB Omni est la version 15.5.2. Pour vérifier la version d'AlloyDB Omni, exécutez la commande suivante :

sudo alloydb version

La sortie ressemble à ceci :

AlloyDB Omni CLI version: 1.6
AlloyDB Omni database server version: 15.5.2

Si la sortie affiche une version de base de données antérieure à la version 15.5.2, exécutez la commande suivante pour effectuer la mise à niveau :

sudo alloydb database-server upgrade

Recueillir des informations sur votre installation existante

Exécutez la commande suivante :
```
cat /var/alloydb/config/dataplane.conf
```
Dans la sortie de la commande cat, notez les valeurs des variables suivantes pour référence :
- DATADIR_PATH : par exemple, /var/alloydb/main
- ENABLE_ALLOYDB_AI : par exemple, FALSE
- PGPORT : par exemple, 5432
- INSTANCE_TYPE : par exemple, PRIMARY/READ_REPLICA

Supprimer les index ScaNN créés avec l'extension `postgres_ann`

L'extension postgres_ann a été renommée alloydb_scann. Si vous avez installé l'extension postgres_ann et créé des index ScaNN à l'aide de l'extension, vous devez supprimer tous les index ScaNN et désinstaller l'extension avant d'effectuer une mise à niveau.

Pour gérer tout impact sur votre base de données en raison du changement de nom de l'extension postgres_ann, procédez comme suit :

Exécutez AlloyDB Omni et connectez-vous à celui-ci.
Identifiez toutes les tables qui utilisent l'index ScaNN.
```
 \c DATABASE_NAME
 select schemaname, relname, indexrelname, indextype, indexconfig, indexsize, indexscan FROM pg_stat_ann_indexes;
```
Remplacez DATABASE_NAME par le nom de la base de données dans laquelle vous souhaitez exécuter la requête.
Enregistrez les définitions et les paramètres d'index en tant que LDD de vidage à l'aide d'un utilitaire tel que pg_dump pour recréer les index ScaNN ultérieurement.
```
pg_dump -st TABLE_NAME DATABASE_NAME
```
Remplacez les éléments suivants :
- DATABASE_NAME : nom de la base de données
- TABLE_NAME : nom de la table
Supprimez les index ScaNN créés à l'aide de l'index postgres_ann.
```
DROP INDEX INDEX_NAME;
```
Remplacez INDEX_NAME par le nom de la base de données dans laquelle vous souhaitez exécuter la requête.

Remarque : Si l'index n'est pas supprimé avant la mise à niveau, la table ne sera pas utilisée ni interrogée dans les requêtes ultérieures.
Vérifiez qu'aucune de vos bases de données n'inclut d'index ScaNN. Utilisez la requête SQL suivante pour vérifier la suppression. Le code SQL suivant doit renvoyer un ensemble de résultats vide.
```
 \c DATABASE_NAME
 select schemaname, relname, indexrelname, indextype, indexconfig, indexsize, indexscan FROM pg_stat_ann_indexes;
```
Supprimez l'extension postgres_ann en procédant comme suit :
1. Vérifiez que l'extension postgres_ann est installée dans votre base de données.
```
select * from pg_extension;
```
1. Supprimez l'extension postgres_ann.
```
DROP EXTENSION postgres_ann CASCADE;
```
1. Vérifiez que l'extension postgres_ann n'est plus installée dans votre base de données.
```
select * from pg_extension;
```

Effectuer une mise à niveau sur place

Arrêtez la base de données existante :
```
sudo alloydb database-server stop
```
Démarrez la nouvelle image unique AlloyDB Omni en montant votre répertoire de données existant :
```
docker run --name CONTAINER_NAME \
    -e POSTGRES_PASSWORD=PASSWORD \
    -e PGDATA=/var/lib/postgresql/data \
    -v /var/alloydb/main/data:/var/lib/postgresql/data \
    -v /dev/shm:/dev/shm \
    -p PGPORT:5432 \
    --network=host \
    --ulimit=nice=-20:-20 \
    --ulimit=core=-1:-1 \
    --log-driver=journald \
    -d google/alloydbomni
```
Remplacez les éléments suivants :
- CONTAINER_NAME : nom à attribuer à ce nouveau conteneur AlloyDB Omni dans le registre de conteneurs de votre machine hôte (par exemple, my-omni).
- PASSWORD : mot de passe attribué à l'utilisateur postgres du nouveau conteneur après sa création.
- PGPORT : adresse IP du port sur lequel AlloyDB Omni s'exécute. Il s'agit de la valeur que vous avez notée à l'étape 2 de la section Recueillir des informations sur votre installation existante.
Les arguments de docker run sont les mêmes que dans les versions antérieures d'AlloyDB Omni, mais vous pouvez les personnaliser davantage. Pour en savoir plus, consultez Personnaliser votre installation AlloyDB Omni.

Si le type d'instance de votre base de données est PRIMARY, exécutez la commande suivante pour créer les utilisateurs suivants. Il s'agit de noms d'utilisateur qui ne sont pas utilisés pour le moment, mais qui sont réservés pour les extensions futures.

for name in alloydbagent alloydbexport alloydbiamgroupuser alloydbiamuser alloydbimportexport alloydbobservability alloydbsqllogical alloydbsuperuser; do
  echo docker exec -it CONTAINER_NAME psql -h localhost -U postgres alloydbadmin \
    -c "CREATE ROLE ${name} NOLOGIN;" \
    -c "CREATE TABLE ${name}_table();" \
    -c "ALTER TABLE ${name}_table OWNER TO ${name};"
done

Si ENABLE_ALLOYDB_AI est TRUE, suivez les instructions de la section Installer AlloyDB Omni avec AlloyDB AI pour configurer AlloyDB AI.
Connectez-vous à la base de données pour vérifier que les données n'ont pas changé :
```
docker exec -it CONTAINER_NAME psql -h localhost -U postgres
```
Désinstallez l'interface de ligne de commande AlloyDB Omni :
```
sudo alloydb database-server uninstall
```
La désinstallation de l'interface de ligne de commande AlloyDB Omni n'affecte pas les données stockées dans AlloyDB Omni.

Recréer des index ScaNN à l'aide de l'extension `alloydb_scann`

Une fois que vous avez mis à niveau AlloyDB Omni, l'extension alloydb_scann est également installée. Procédez comme suit pour recréer les index ScaNN que vous avez supprimés dans la section Supprimer les index ScaNN créés avec l'extension postgres_ann avant la mise à niveau.

Créez l'extension alloydb_scann en procédant comme suit :
1. Pour créer l'extension alloydb_scann, exécutez la requête suivante :
```
create extension alloydb_scann cascade;
```
1. Vérifiez que l'extension alloydb_scann a bien été créée.
```
select * from pg_extension;
```
Recréez l'index ScaNN pour votre table, puis restaurez les définitions d'index LDD pg_dump précédentes.
1. Créez un index ScaNN dans la table :
```
CREATE INDEX INDEX_NAME ON TABLE_NAME
    USING scann (VECTOR_COLUMN DISTANCE)
    WITH (num_leaves = NUM_LEAVES_VALUE);
```
Remplacez les éléments suivants :
- INDEX_NAME : nom de l'index
- TABLE_NAME : nom de la table
- VECTOR_COLUMN : nom de la colonne qui stocke les données vectorielles
- DISTANCE : fonction de distance à utiliser avec cet index
- NUM_LEAVES_VALUE : nombre de partitions à appliquer à l'index
1. Vérifiez que l'index est créé.
```
\d TABLE_NAME
```
1. Recommandé : Sauvegardez les données de vos index. Nous vous recommandons de créer une sauvegarde de votre base de données et de vos index.
Attention : Toute sauvegarde incluant l'extension postgres_ann et effectuée avant la mise à niveau ne peut pas être restaurée après la mise à niveau.