Cette page explique comment créer et gérer des partitions d'instance Spanner.
Avant de commencer
Pour utiliser des partitions d'instance, vous devez définir l'option de base de données opt_in_dataplacement_preview
dans votre base de données vide :
Console
Accédez à la page Instances dans la console Google Cloud .
Sélectionnez l'instance à laquelle vous souhaitez ajouter des partitions d'instance.
Sélectionnez la base de données vide dans laquelle vous souhaitez partitionner les données.
Dans le menu de navigation, cliquez sur Spanner Studio.
Sur la page Spanner Studio, cliquez sur
Nouvel onglet ou utilisez l'onglet d'éditeur vide.Saisissez l'instruction LDD
ALTER DATABASE
suivante.GoogleSQL
ALTER DATABASE DATABASE_ID SET OPTIONS (opt_in_dataplacement_preview = true);
Remplacez DATABASE_ID par l'identifiant unique de votre base de données.
PostgreSQL
ALTER DATABASE DATABASE_ID SET "spanner.opt_in_dataplacement_preview" = TRUE;
Remplacez DATABASE_ID par l'identifiant unique de votre base de données.
Cliquez sur Exécuter.
gcloud
Pour définir l'option de base de données opt_in_dataplacement_preview
, utilisez gcloud spanner databases ddl update
.
GoogleSQL
gcloud spanner databases ddl update DATABASE_ID \
--instance=INSTANCE_ID \
--ddl="ALTER DATABASE DATABASE_ID SET OPTIONS (opt_in_dataplacement_preview = true);"
Remplacez les éléments suivants :
DATABASE_ID
: identifiant permanent de votre base de données Spanner.INSTANCE_ID
: identifiant permanent de votre instance Spanner.
PostgreSQL
gcloud spanner databases ddl update DATABASE_ID \
--instance=INSTANCE_ID \
--ddl="ALTER DATABASE DATABASE_ID SET "spanner.opt_in_dataplacement_preview" = TRUE"
Remplacez les éléments suivants :
DATABASE_ID
: identifiant permanent de votre base de données Spanner.INSTANCE_ID
: identifiant permanent de votre instance Spanner.
Créer une partition d'instance
Console
Dans la console Google Cloud , ouvrez la page Spanner.
Sélectionnez l'instance à laquelle vous souhaitez ajouter des partitions d'instance.
Dans le menu de navigation, sélectionnez Partitions d'instance.
Cliquez sur Créer une partition d'instance.
Saisissez un ID de partition pour identifier de manière permanente la partition de votre instance. L'ID de partition d'instance doit également être unique au sein de votre projetGoogle Cloud . Vous ne pourrez pas modifier l'ID de partition d'instance par la suite.
Dans la section Sélectionner une configuration, sélectionnez Régional ou Multirégional. Si vous souhaitez comparer les spécifications entre les régions, cliquez sur Comparer les configurations régionales.
Sélectionnez une configuration dans le menu déroulant.
Dans la section Allouer une capacité de calcul, sous Unité, cliquez sur l'une des options suivantes :
- Unités de traitement pour les petites partitions d'instance.
- Nœuds pour les instances volumineuses. Un nœud correspond à 1 000 unités de traitement.
Saisissez une valeur pour l'unité sélectionnée.
La partition de votre instance doit comporter au moins un nœud ou 1 000 unités de traitement.
Cliquez sur Créer pour créer la partition d'instance.
gcloud
Pour créer une partition d'instance, utilisez gcloud beta spanner instance-partitions create
.
gcloud beta spanner instance-partitions create INSTANCE_PARTITION_ID \ --config=INSTANCE_PARTITION_CONFIG \ --description="INSTANCE_PARTITION_DESCRIPTION" \ --instance=INSTANCE_ID \ [--nodes=NODE_COUNT | --processing-units=PROCESSING_UNIT_COUNT]
Remplacez les éléments suivants :
- INSTANCE_PARTITION_ID : identifiant permanent de la partition d'instance, unique dans votre projet Google Cloud . Vous ne pourrez pas modifier l'ID de partition d'instance par la suite.
- INSTANCE_PARTITION_CONFIG : identifiant permanent de la configuration de la partition de votre instance, qui définit l'emplacement géographique de la partition de l'instance et affecte l'emplacement de stockage des données.
- INSTANCE_PARTITION_DESCRIPTION : nom à afficher pour la partition d'instance dans la console Google Cloud . Le nom de la partition d'instance doit être unique dans votre projet Google Cloud .
- INSTANCE_ID : identifiant permanent de votre instance Spanner dans laquelle réside cette partition d'instance.
- NODE_COUNT : capacité de calcul de la partition d'instance, exprimée en nombre de nœuds. Un nœud correspond à 1 000 unités de traitement.
- PROCESSING_UNIT_COUNT : la capacité de calcul de l'instance, exprimée en nombre d'unités de traitement. Votre partition d'instance doit comporter au moins 1 000 unités de traitement. Saisissez des quantités par multiples de 1 000 (1 000, 2 000, 3 000, etc.).
Par exemple, pour créer une partition d'instance europe-partition
dans eur3
avec cinq nœuds, exécutez la commande suivante :
gcloud beta spanner instance-partitions create europe-partition --config=eur3 \
--description="europe-partition" --instance=test-instance --nodes=5
Bibliothèques clientes
C++
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.
C#
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.
Go
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.
Java
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.
Node.js
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.
PHP
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.
Python
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.
Décrire une partition d'instance
gcloud
Pour décrire une partition d'instance, utilisez gcloud beta spanner instance-partitions describe
.
gcloud beta spanner instance-partitions describe PARTITION_ID \ --instance=INSTANCE_ID
Remplacez les éléments suivants :
- INSTANCE_PARTITION_ID : identifiant permanent de la partition d'instance.
- INSTANCE_ID : identifiant permanent de l'instance.
Par exemple, pour décrire la partition d'instance europe-partition
, exécutez la commande suivante :
gcloud beta spanner instance-partitions describe europe-partition
--instance=test-instance
Lister les partitions d'instance
Console
Dans la console Google Cloud , ouvrez la page Spanner.
Sélectionnez une instance dans la liste.
Dans le menu de navigation, sélectionnez Partitions d'instance.
La liste des partitions d'instance associées à cette instance s'affiche.
gcloud
Pour répertorier les partitions de votre instance, utilisez gcloud beta spanner instance-partitions list
.
gcloud beta spanner instance-partitions list --instance=INSTANCE_ID
Gcloud CLI affiche la liste de vos partitions d'instance Spanner, ainsi que l'ID, le nom d'affichage, la configuration et la capacité de calcul de chaque partition d'instance.
Modifier une partition d'instance
La section suivante explique comment modifier la capacité de calcul de la partition de votre instance. Vous ne pouvez pas modifier l'ID, le nom ni la configuration de la partition d'instance.
Modifier la capacité de calcul
Vous devez provisionner suffisamment de capacité de calcul pour que l'utilisation du processeur et l'utilisation du stockage restent inférieures aux valeurs maximales recommandées. Pour en savoir plus, consultez les quotas et limites de Spanner.
Si vous souhaitez augmenter la capacité de calcul d'une partition d'instance, votre projetGoogle Cloud doit disposer d'un quota suffisant. Le temps nécessaire pour traiter la demande d'augmentation dépend de sa taille. Dans la plupart des cas, les demandes sont traitées en quelques minutes. Dans de rares cas, l'opération de scale-up peut prendre jusqu'à une heure.
Console
Dans la console Google Cloud , ouvrez la page Spanner.
Sélectionnez une instance dans la liste.
Dans le menu de navigation, sélectionnez Partitions d'instance.
Dans la liste des partitions d'instance, sous la colonne Actions, cliquez sur Autres actions, puis sélectionnez Modifier.
Modifiez la capacité de calcul en choisissant une unité de mesure (unités de traitement ou nœuds), puis en saisissant une quantité. Lorsque vous utilisez des unités de traitement, saisissez des quantités par multiples de 1 000 (1 000, 2 000, 3 000, etc.). Chaque nœud équivaut à 1 000 unités de traitement.
La partition de votre instance doit comporter au moins un nœud (1 000 unités de traitement).
Cliquez sur Enregistrer.
Si vous voyez apparaître une boîte de dialogue indiquant que votre quota est insuffisant pour ajouter de la capacité de calcul , suivez les instructions pour demander une augmentation de quota.
gcloud
Pour modifier la capacité de calcul de la partition d'instance, utilisez gcloud beta spanner instance-partitions update
.
Lorsque vous utilisez cette commande, spécifiez la capacité de calcul en nombre de nœuds ou d'unités de traitement.
gcloud beta spanner instance-partitions update INSTANCE_PARTITION_ID \ --instance=INSTANCE_ID \ [--nodes=NODE_COUNT | --processing-units=PROCESSING_UNIT_COUNT] [--async]
Remplacez les éléments suivants :
- INSTANCE_PARTITION_ID : identifiant permanent de la partition d'instance.
- INSTANCE_ID : identifiant permanent de l'instance.
- NODE_COUNT : la nouvelle capacité de calcul de la partition d'instance, exprimée en nombre de nœuds. Un nœud correspond à 1 000 unités de traitement.
- PROCESSING_UNIT_COUNT : nouvelle capacité de calcul de la partition d'instance, exprimée en nombre d'unités de traitement. Votre partition d'instance doit comporter au moins 1 000 unités de traitement. Saisissez des quantités par multiples de 1 000 (1 000, 2 000, 3 000, etc.).
Indicateurs facultatifs :
--async
: utilisez cette option si vous souhaitez que votre requête soit renvoyée immédiatement, sans attendre la fin de l'opération en cours.
Vous pouvez vérifier l'état de votre demande en exécutant gcloud spanner operations describe
.
Supprimer une partition d'instance
Vous ne pouvez pas supprimer une partition d'instance tant qu'elle est associée à des emplacements ou des données. Avant de pouvoir supprimer la partition d'instance, vous devez d'abord déplacer les données qu'elle contient ou supprimer les tables d'emplacement qui l'utilisent.
Console
Dans la console Google Cloud , ouvrez la page Spanner.
Sélectionnez une instance dans la liste.
Dans le menu de navigation, sélectionnez Partitions d'instance.
Dans la liste des partitions d'instance, sous la colonne Actions, cliquez sur Autres actions, puis sélectionnez Supprimer.
Suivez les instructions pour confirmer que vous souhaitez bien supprimer la partition d'instance.
Cliquez sur Supprimer.
gcloud
Exécutez la commande gcloud beta spanner instance-partitions delete
.
gcloud beta spanner instance-partitions delete INSTANCE_PARTITION_ID --instance=INSTANCE_ID
Étapes suivantes
- Découvrez comment créer et gérer des tables et des clés d'emplacement.