Cette page explique comment modifier la région principale d'une base de données. Vous ne pouvez modifier que la région principale d'une Spanner qui utilise une configuration d'instance multirégionale. Nouvelle région principale doit être l'une des deux régions de lecture/écriture de la configuration multirégionale de votre base de données. Pour en savoir plus sur la modification de la région principale, consultez Configurez la région principale par défaut.
Pour afficher les données sur la distribution principale d'une instance ou d'une base de données multirégionales, Ouvrez la console Google Cloud et reportez-vous aux graphiques Répartition des leaders. Pour Pour en savoir plus, consultez la page Graphiques et métriques Spanner.
Modifier la région principale d'une base de données
Vous pouvez modifier la région principale d'une base de données. Pour surveiller la progression modification, consultez le graphique de répartition des leaders.
Console
Accédez à la page Instances de Spanner dans la console Google Cloud.
Cliquez sur le nom de l'instance contenant la base de données dont vous souhaitez modifier la région principale.
Cliquez sur la base de données dont vous souhaitez modifier la région principale.
Cliquez sur l'icône en forme de crayon à côté de l'élément Région principale.
Modifiez l'instruction LDD en y définissant la région principale souhaitée en tant que
default_leader
.
gcloud
Pour modifier la région principale d'une base de données existante, exécutez la commande suivante en remplaçant les variables par les valeurs appropriées :
gcloud spanner databases ddl update database-name --instance=instance-id --ddl='ALTER DATABASE `database-name` SET OPTIONS ( default_leader = "region" )'
Bibliothèques clientes
C#
C++
Go
Java
<ph type="x-smartling-placeholder">
Node.js
<ph type="x-smartling-placeholder">
PHP
<ph type="x-smartling-placeholder">
Python
<ph type="x-smartling-placeholder">
Ruby
Réinitialiser la région principale d'une base de données sur la valeur système par défaut
Console
Accédez à la page Instances de Spanner dans la console Google Cloud.
Cliquez sur le nom de l'instance contenant la base de données dont vous souhaitez modifier la région principale.
Cliquez sur la base de données dont vous souhaitez modifier la région principale.
Cliquez sur l'icône en forme de crayon à côté de l'élément Région principale.
Modifiez l'instruction LDD en y définissant la région principale souhaitée et définissez
default_leader
surNULL
.
gcloud
Pour réinitialiser la région principale d'une base de données existante sur la région principale par défaut, exécutez la commande suivante en remplaçant les variables par les valeurs appropriées :
gcloud spanner databases ddl update database-name --instance=instance-id --ddl='ALTER DATABASE `database-name` SET OPTIONS ( default_leader = NULL )'
Définir une région principale lors de la création d'une base de données
gcloud
Pour définir la région principale par défaut lors de la création d'une base de données, exécutez la commande suivante en remplaçant les variables par les valeurs appropriées :
gcloud spanner databases create database --instance=instance --ddl='CREATE TABLE mytable (a INT64, b INT64) PRIMARY KEY(a); ALTER DATABASE `database-name` SET OPTIONS (default_leader = "region")'
Bibliothèques clientes
C#
C++
Go
Java
<ph type="x-smartling-placeholder">
Node.js
<ph type="x-smartling-placeholder">
PHP
<ph type="x-smartling-placeholder">
Python
<ph type="x-smartling-placeholder">
Ruby
Afficher la région principale
Afficher la région principale d'une base de données avec la console Google Cloud et gcloud
Console
Accédez à la page Instances de Spanner dans la console Google Cloud.
La région principale de votre base de données est répertoriée sous Région principale.
gcloud
Pour afficher la région principale d'une base de données existante, exécutez la commande suivante en remplaçant les variables par les valeurs appropriées :
gcloud spanner databases describe database --instance=instance-id
Si une région principale par défaut a été définie, elle est répertoriée sous defaultLeader
.
S'il n'y a pas de région principale par défaut définie, l'élément defaultLeader
n'est pas répertorié. Dans ce
cas où Spanner utilise la région principale de votre emplacement multirégional
configuration répertoriée dans Configurations disponibles.
Afficher la région principale du LDD
gcloud
Pour afficher la région principale d'une base de données dans le LDD, exécutez la commande suivante en remplaçant les variables par les valeurs appropriées :
gcloud spanner databases ddl describe database-name --instance=instance-name
Bibliothèques clientes
C#
C++
Go
Java
<ph type="x-smartling-placeholder">
Node.js
<ph type="x-smartling-placeholder">
PHP
<ph type="x-smartling-placeholder">
Python
<ph type="x-smartling-placeholder">
Ruby
Afficher la région principale dans le schéma d'informations
gcloud
Pour afficher la région principale d'une base de données existante, exécutez la commande suivante en remplaçant les variables par les valeurs appropriées :
gcloud spanner databases execute-sql database-name --instance=instance-id --sql="SELECT s.OPTION_NAME, s.OPTION_VALUE FROM INFORMATION_SCHEMA.DATABASE_OPTIONS s WHERE s.OPTION_NAME = 'default_leader'"
Bibliothèques clientes
C#
C++
Go
Java
<ph type="x-smartling-placeholder">
Node.js
<ph type="x-smartling-placeholder">
PHP
<ph type="x-smartling-placeholder">
Python
<ph type="x-smartling-placeholder">
Ruby
Afficher les régions principales pour plusieurs bases de données
Bibliothèques clientes
C#
C++
Go
Java
<ph type="x-smartling-placeholder">
Node.js
<ph type="x-smartling-placeholder">
PHP
<ph type="x-smartling-placeholder">
Python
<ph type="x-smartling-placeholder">
Ruby
Afficher les options de leaders disponibles
Afficher les options de leaders disponibles pour une configuration d'instance
gcloud
Pour afficher les régions que vous pouvez définir comme région principale par défaut, exécutez la commande suivante en remplaçant les variables par les valeurs appropriées :
gcloud spanner instance-configs describe instance-config
Les régions que vous pouvez choisir sont répertoriées sous leaderOptions
.
Bibliothèques clientes
C#
C++
Go
Java
<ph type="x-smartling-placeholder">
Node.js
<ph type="x-smartling-placeholder">
PHP
<ph type="x-smartling-placeholder">
Python
<ph type="x-smartling-placeholder">
Ruby
Afficher les options principales disponibles pour toutes les configurations d'instance
gcloud
Pour afficher les régions que vous pouvez définir comme région principale par défaut pour toutes les configurations d'instance, exécutez la commande suivante en remplaçant variables par les valeurs appropriées :
gcloud spanner instance-configs list
Bibliothèques clientes
C#
C++
Go
Java
<ph type="x-smartling-placeholder">
Node.js
<ph type="x-smartling-placeholder">
PHP
<ph type="x-smartling-placeholder">
Python
<ph type="x-smartling-placeholder">