Cette page explique comment créer, répertorier, modifier et supprimer des instances Spanner.
Créer une instance
Vous pouvez créer une instance à l'aide de la console Google Cloud, de Google Cloud CLI ou des bibliothèques clientes. Vous pouvez également créer une instance avec une configuration d'instance personnalisée en ajoutant des instances dupliquées en lecture seule facultatives.
Console
Accédez à la page Créer une instance dans la console Google Cloud.
Saisissez un nom d'instance à afficher dans la console Google Cloud. Le nom de l'instance doit être unique au sein de votre projet Google Cloud.
Saisissez un ID d'instance pour identifier définitivement votre instance. L'ID d'instance doit également être unique au sein de votre projet Google Cloud. Une fois cet ID d'instance créé, vous ne pourrez plus le modifier.
Cliquez sur Continuer.
Dans la section Configurer votre instance, sous Choisir une configuration, sélectionnez Régional, Birégional ou Multirégion. Si vous souhaitez comparer les spécifications des trois configurations, cliquez sur Comparer les configurations régionales.
Sélectionnez une configuration dans le menu déroulant.
Facultatif: Pour ajouter une instance dupliquée en lecture seule à une configuration de base Spanner, commencez par créer une configuration d'instance personnalisée à l'aide de la Google Cloud CLI.
Cliquez sur Continuer.
Dans la section Allouer de la capacité de calcul, sous Sélectionner une unité, cliquez sur l'une des options suivantes:
- Les unités de traitement pour les petites instances
- Nœuds pour les instances volumineuses Un nœud correspond à 1 000 unités de traitement.
Pour en savoir plus, consultez la section Capacité de calcul, nœuds et unités de traitement.
Sous Sélectionner un mode de scaling, cliquez sur l'une des options suivantes:
L'allocation manuelle si vous souhaitez définir manuellement la capacité de calcul pour des ressources et des coûts de calcul fixes.
- La quantité indique le nombre d'unités de traitement ou de nœuds à utiliser pour cette instance.
L'autoscaling (version preview) pour permettre à Spanner d'ajouter et de supprimer automatiquement de la capacité de calcul. Pour en savoir plus sur l'autoscaler géré géré, consultez la page Autoscaler géré pour Spanner. Configurez les options d'autoscaler géré suivantes:
- Minimum (Minimum) indique la limite minimale à atteindre, en fonction de l'unité de mesure que vous choisissez pour la capacité de calcul. Pour en savoir plus, consultez la section Déterminer la limite minimale.
- Maximum indique la limite maximale pour le scaling à la hausse, en fonction de l'unité de mesure que vous choisissez pour la capacité de calcul. Pour en savoir plus, consultez la section Déterminer la limite maximale.
- L'objectif d'utilisation du processeur à priorité élevée indique le pourcentage cible de processeurs à priorité élevée à utiliser. Pour en savoir plus, consultez la section Déterminer l'objectif d'utilisation du processeur.
- Objectif d'utilisation du stockage : indique le pourcentage cible de l'espace de stockage à utiliser. Pour en savoir plus, consultez la page Déterminer la cible d'utilisation du stockage.
Cliquez sur Créer pour créer l'instance.
gcloud
Exécutez la commande gcloud spanner instances create
pour créer une instance. Spécifiez la capacité de calcul en tant que nombre de nœuds ou d'unités de traitement souhaité sur l'instance.
gcloud spanner instances create INSTANCE-ID \ --config=INSTANCE-CONFIG \ --description=INSTANCE-DESCRIPTION \ --nodes=NODE-COUNT
ou
gcloud spanner instances create INSTANCE-ID \ --config=INSTANCE-CONFIG \ --description=INSTANCE-DESCRIPTION \ --processing-units=PROCESSING-UNIT-COUNT
Remplacez les éléments suivants :
- INSTANCE-ID: identifiant permanent et unique au sein de votre projet Google Cloud. Une fois cet ID d'instance créé, vous ne pourrez plus le modifier.
- INSTANCE-CONFIG: identifiant permanent de la configuration de l'instance, qui définit l'emplacement géographique de l'instance et affecte la réplication des données. Pour les configurations d'instances personnalisées, il commence par
custom-
. Pour en savoir plus, consultez la page Configurations d'instances. - INSTANCE-DESCRIPTION: nom à afficher pour l'instance dans la console Google Cloud. Le nom de l'instance doit être unique au sein de votre projet Google Cloud.
NODE-COUNT: capacité de calcul de l'instance, exprimée en nombre de nœuds. Chaque nœud équivaut à 1 000 unités de traitement.
PROCESSING-UNIT-COUNT: capacité de calcul de l'instance, exprimée en nombre d'unités de traitement. Saisissez des quantités jusqu'à 1 000 par multiples de 100 (100, 200, 300, etc.), puis des quantités supérieures par multiples de 1 000 (1 000, 2 000, 3 000, etc.). Remarque : N'utilisez pas ce paramètre si vous créez une instance que vous prévoyez d'activer avec l'autoscaler géré ultérieurement.
Ajouter l'autoscaling géré (version preview)
Vous pouvez également configurer de nouvelles instances pour qu'elles utilisent l'autoscaling géré à l'aide de la commande gcloud beta spanner instances create
. Pour en savoir plus, consultez la page Autoscaler géré pour Spanner.
Utilisez la commande suivante pour créer une instance avec un autoscaler géré.
gcloud beta spanner instances create INSTANCE-ID \ --config=INSTANCE-CONFIG \ --description=INSTANCE-DESCRIPTION \ --autoscaling-min-processing-units=MINIMUM_PROCESSING_UNITS \ --autoscaling-max-processing-units=MAXIMUM_PROCESSING_UNITS \ --autoscaling-high-priority-cpu-target=CPU_PERCENTAGE \ --autoscaling-storage-target=STORAGE_PERCENTAGE
ou
gcloud beta spanner instances create INSTANCE-ID \ --config=INSTANCE-CONFIG \ --description=INSTANCE-DESCRIPTION \ --autoscaling-min-nodes=MINIMUM_NODES \ --autoscaling-max-nodes=MAXIMUM_NODES \ --autoscaling-high-priority-cpu-target=CPU_PERCENTAGE \ --autoscaling-storage-target=STORAGE_PERCENTAGE
Remplacez les éléments suivants :
- INSTANCE-ID: identifiant permanent et unique au sein de votre projet Google Cloud. Une fois cet ID d'instance créé, vous ne pourrez plus le modifier.
- INSTANCE-CONFIG: identifiant permanent de la configuration de l'instance, qui définit l'emplacement géographique de l'instance et affecte la réplication des données. Pour les configurations d'instances personnalisées, il commence par
custom-
. Pour en savoir plus, consultez la page Configurations d'instances. - INSTANCE-DESCRIPTION: nom à afficher pour l'instance dans la console Google Cloud. Le nom de l'instance doit être unique au sein de votre projet Google Cloud.
- MINIMUM_PROCESSING_UNITS, MINIMUM_NODES: nombre minimal d'unités de traitement ou de nœuds lors d'un scaling à la baisse. Pour en savoir plus, consultez la section Déterminer la limite minimale.
- MAXIMUM_PROCESSING_UNITS, MAXIMUM_NODES: nombre maximal d'unités de traitement ou de nœuds lors du scaling à la hausse. Pour en savoir plus, consultez la section Déterminer la limite maximale.
- CPU_PERCENTAGE: pourcentage cible du processeur à priorité élevée à utiliser, compris entre 10 et 90%. Si vous optimisez les coûts, utilisez un pourcentage plus élevé. Pour en savoir plus, consultez la section Déterminer l'objectif d'utilisation du processeur.
- STORAGE_PERCENTAGE: pourcentage cible de l'espace de stockage à utiliser, compris entre 10 et 99%. Pour en savoir plus, consultez la section Déterminer la cible d'utilisation du stockage.
Exemples d'utilisation des configurations personnalisées
Pour créer une instance test-instance
dans la configuration d'instance régionale de base us-central1
, exécutez la commande suivante:
gcloud spanner instances create test-instance --config=regional-us-central1 \
--description="Test Instance" --nodes=1
Pour créer une instance custom-eur6-instance
dans la configuration d'instance multirégionale personnalisée custom-eur6
, commencez par créer une configuration d'instance personnalisée.
Exécutez ensuite la commande ci-dessous :
gcloud spanner instances create custom-eur6-instance --config=custom-eur6 \
--description="Instance with custom read-only" --nodes=1
Un message semblable à l'exemple suivant doit s'afficher après l'exécution de l'une des commandes précédentes:
Creating instance...done.
C++
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.
Pour vous authentifier auprès de Spanner, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
C#
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.
Pour vous authentifier auprès de Spanner, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Go
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.
Pour vous authentifier auprès de Spanner, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Créer une instance avec autoscaling géré à l'aide de Go (Preview)
Java
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.
Pour vous authentifier auprès de Spanner, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Créer une instance avec autoscaling géré à l'aide de Java (Preview)
Node.js
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.
Pour vous authentifier auprès de Spanner, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
PHP
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.
Pour vous authentifier auprès de Spanner, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.
Pour vous authentifier auprès de Spanner, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Ruby
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.
Pour vous authentifier auprès de Spanner, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Répertorier les instances
Vous pouvez afficher la liste de vos instances Spanner.
Console
Accédez à la page Instances de Spanner dans la console Google Cloud.
La console Google Cloud affiche une liste de vos instances Spanner, ainsi que l'ID, le nom à afficher, la configuration et la capacité de calcul de chaque instance, exprimés en unités de traitement et en nœuds.
gcloud
Exécutez la commande gcloud spanner instances list
:
gcloud spanner instances list
Gcloud CLI affiche la liste de vos instances Spanner, ainsi que l'ID, le nom à afficher, la configuration et la capacité de calcul de chaque instance.
Modifier une instance
Dans les sections suivantes, nous expliquons comment modifier le nom à afficher et la capacité de calcul d'une instance. Vous ne pouvez pas modifier l'ID d'une instance ni sa configuration.
Modifier le nom à afficher
Console
Accédez à la page Instances de Spanner dans la console Google Cloud.
Cliquez sur le nom de l'instance que vous souhaitez renommer.
Cliquez sur Modifier l'instance.
Saisissez un nouveau nom d'instance. Ce nom doit être unique au sein du projet Google Cloud.
Cliquez sur Enregistrer.
gcloud
Exécutez la commande gcloud spanner instances update
:
gcloud spanner instances update INSTANCE_ID --description=INSTANCE_NAME
Remplacez les éléments suivants :
- INSTANCE_ID: identifiant permanent de l'instance.
- INSTANCE_NAME: nom à afficher pour l'instance dans la console Google Cloud. Le nom de l'instance doit être unique au sein de votre projet Google Cloud.
Modifier la capacité de calcul
Vous devez provisionner une capacité de calcul suffisante pour maintenir l'utilisation du processeur et l'utilisation du stockage en dessous des valeurs maximales recommandées. Pour en savoir plus, consultez les quotas et limites de Spanner.
Dans certains cas, vous ne pouvez pas réduire la capacité de calcul d'une instance existante:
- Pour supprimer de la capacité de calcul, votre instance doit stocker plus de 4 To de données pour 1 000 unités de traitement (1 nœud).
- Sur la base de l'historique de vos schémas d'utilisation, Spanner a créé un grand nombre de divisions pour les données de votre instance. Dans de rares cas, Spanner n'est pas en mesure de gérer les divisions après avoir supprimé de la capacité de calcul.
Dans ce dernier cas, vous pouvez essayer de réduire progressivement la capacité de calcul jusqu'à trouver la capacité minimale dont Spanner a besoin pour gérer toutes les divisions de l'instance. Si l'instance n'a plus besoin d'autant de divisions en raison d'un changement dans les schémas d'utilisation, Spanner peut à terme fusionner certaines divisions et vous permettre d'essayer de réduire davantage la capacité de calcul de l'instance au bout d'une semaine ou deux.
Lorsque vous supprimez de la capacité de calcul, surveillez l'utilisation du processeur et la latence des requêtes dans Cloud Monitoring pour vous assurer que cette utilisation reste inférieure à 65% pour les instances régionales et à 45% pour chaque région dans les instances multirégionales. Vous risquez de constater une augmentation temporaire des latences des requêtes lors de la suppression de la capacité de calcul.
Si vous souhaitez augmenter la capacité de calcul d'une instance, votre projet Google Cloud doit disposer d'un quota suffisant pour ajouter cette capacité. Le temps nécessaire au traitement de la demande d'augmentation dépend de sa taille. Dans la plupart des cas, les requêtes sont traitées en quelques minutes. Dans de rares cas, un scaling à la hausse peut prendre jusqu'à une heure.
Console
Accédez à la page Instances de Spanner dans la console Google Cloud.
Cliquez sur le nom de l'instance que vous souhaitez modifier.
Cliquez sur Modifier l'instance.
Modifiez la capacité de calcul en choisissant les unités de mesure (unités de traitement ou nœuds), puis en saisissant une quantité. Lorsque vous utilisez des unités de traitement, saisissez les quantités jusqu'à 1 000 par multiples de 100 (100, 200, 300, etc.) et les quantités supérieures par multiples de 1 000 (1 000, 2 000, 3 000, etc.). Chaque nœud équivaut à 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 à cet emplacement, suivez les instructions pour demander une augmentation de quota.
gcloud
Exécutez la commande gcloud spanner instances update
. Lorsque vous utilisez cette commande, spécifiez la capacité de calcul en tant que nombre de nœuds ou d'unités de traitement.
gcloud spanner instances update INSTANCE_ID --nodes=NODE_COUNT [--async]
ou
gcloud spanner instances update INSTANCE_ID --processing-units=PROCESSING_UNIT_COUNT [--async]
Remplacez les éléments suivants :
- INSTANCE_ID: identifiant permanent de l'instance.
- NODE_COUNT: capacité de calcul de l'instance, exprimée en nombre de nœuds. Chaque nœud équivaut à 1 000 unités de traitement.
- PROCESSING_UNIT_COUNT: capacité de calcul de l'instance, exprimée en nombre d'unités de traitement. Saisissez des quantités jusqu'à 1 000 par multiples de 100 (100, 200, 300, etc.), puis des quantités supérieures 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 requête en exécutant la commandegcloud spanner operations describe
.
Activer ou modifier l'autoscaler géré sur une instance
Les limites suivantes s'appliquent lorsque vous ajoutez ou modifiez la fonctionnalité d'autoscaling géré sur une instance existante:
- Vous ne pouvez pas activer l'autoscaler géré sur une instance que vous déplacez.
Vous ne pouvez pas déplacer une instance tant que l'autoscaler géré est activé.
Console
Accédez à la page Instances de Spanner dans la console Google Cloud.
Cliquez sur le nom de l'instance sur laquelle vous souhaitez activer l'autoscaler géré.
Cliquez sur Modifier l'instance.
Sous Configurer la capacité de calcul, cliquez sur Autoscaling.
Dans Minimum, sélectionnez la limite minimale à utiliser pour le scaling à la baisse. Pour en savoir plus, consultez la section Déterminer la limite minimale.
Dans Maximum, sélectionnez la limite maximale à utiliser pour le scaling à la hausse. Pour en savoir plus, consultez la section Déterminer la limite maximale.
Pour Objectif d'utilisation du processeur de haute priorité, sélectionnez le pourcentage de processeur de haute priorité à utiliser. Pour en savoir plus, consultez la section Déterminer l'objectif d'utilisation du processeur.
Pour Objectif d'utilisation du stockage, sélectionnez le pourcentage d'espace de stockage à utiliser. Pour en savoir plus, consultez la section Déterminer la cible d'utilisation du stockage.
Cliquez sur Enregistrer.
gcloud
Exécutez la commande gcloud beta spanner instances update
pour ajouter l'autoscaler géré à une instance. Pour en savoir plus et connaître les limites, consultez la section Options et limites de Google Cloud CLI
.
Vous pouvez ajouter l'autoscaler géré à l'aide de la commande suivante:
gcloud beta spanner instances update INSTANCE_ID \ --autoscaling-min-processing-units=MINIMUM_PROCESSING_UNITS \ --autoscaling-max-processing-units=MAXIMUM_PROCESSING_UNITS \ --autoscaling-high-priority-cpu-target=CPU_PERCENTAGE \ --autoscaling-storage-target=STORAGE_PERCENTAGE
ou
gcloud beta spanner instances update INSTANCE_ID \ --autoscaling-min-processing-units=MINIMUM_NODES \ --autoscaling-max-processing-units=MAXIMUM_NODES \ --autoscaling-high-priority-cpu-target=CPU_PERCENTAGE \ --autoscaling-storage-target=STORAGE_PERCENTAGE
Remplacez les éléments suivants :
- INSTANCE_ID: identifiant permanent de l'instance.
- MINIMUM_PROCESSING_UNITS, MINIMUM_NODES: nombre minimal d'unités de traitement ou de nœuds à utiliser pour effectuer un scaling à la baisse. Pour en savoir plus, consultez la section Déterminer la limite minimale.
- MAXIMUM_PROCESSING_UNITS, MAXIMUM_NODES: nombre maximal d'unités de traitement ou de nœuds à utiliser pour le scaling à la hausse. Pour en savoir plus, consultez la section Déterminer la limite maximale.
- CPU_PERCENTAGE: pourcentage cible du processeur à priorité élevée à utiliser, compris entre 10% et 90%. Si vous optimisez les coûts et n'exigez pas une faible latence pour toutes les requêtes, utilisez un pourcentage plus élevé. Pour en savoir plus, consultez la section Déterminer l'objectif d'utilisation du processeur.
- STORAGE_PERCENTAGE: pourcentage cible de stockage à utiliser, compris entre 10% et 99%. Pour en savoir plus, consultez la page Déterminer la cible d'utilisation du stockage.
Après avoir ajouté l'autoscaler géré à une instance, vous pouvez également modifier ses paramètres. Par exemple, si vous souhaitez augmenter le nombre maximal d'unités de traitement à 10 000, exécutez la commande suivante:
gcloud beta spanner instances update test-instance \
--autoscaling-max-processing-units=10000
Faire passer une instance de l'utilisation de l'autoscaler géré au scaling manuel
Console
Accédez à la page Instances de Spanner dans la console Google Cloud.
Cliquez sur le nom de l'instance sur laquelle vous souhaitez désactiver l'autoscaler géré.
Sous Sélectionner un mode de scaling, cliquez sur Allocation manuelle.
Cliquez sur Enregistrer.
gcloud
Exécutez la commande gcloud beta spanner instances update
pour mettre à jour l'instance.
Utilisez la commande suivante pour faire passer une instance de l'autoscaler géré au scaling manuel:
gcloud beta spanner instances update INSTANCE_ID \ --processing-units=PROCESSING_UNIT_COUNT
ou
gcloud beta spanner instances update INSTANCE_ID \ --nodes=NODE_COUNT
Remplacez les éléments suivants :
- INSTANCE_ID: identifiant permanent de l'instance.
- NODE_COUNT: capacité de calcul de l'instance, exprimée en nombre de nœuds. Chaque nœud équivaut à 1 000 unités de traitement.
- PROCESSING_UNIT_COUNT: capacité de calcul de l'instance, exprimée en nombre d'unités de traitement. Saisissez des quantités jusqu'à 1 000 par multiples de 100 (100, 200, 300, etc.), puis des quantités supérieures par multiples de 1 000 (1 000, 2 000, 3 000, etc.).
Ajouter une étiquette à une instance
Les libellés vous aident à organiser vos ressources.
Console
Accédez à la page Instances de Spanner dans la console Google Cloud.
Cochez la case correspondant à l'instance. Le panneau d'informations apparaît sur le côté droit de la page.
Cliquez sur l'onglet Libellés dans le panneau d'informations. Vous pouvez ensuite ajouter, supprimer ou mettre à jour des libellés pour l'instance Spanner.
Déplacer une instance
Pour savoir comment déplacer votre instance depuis n'importe quelle configuration d'instance vers toute autre configuration d'instance, y compris entre des configurations régionales et multirégionales, consultez la page Déplacer une instance.
Supprimer une instance
Vous pouvez supprimer une instance à l'aide de la console Google Cloud ou de Google Cloud CLI.
Si vous souhaitez supprimer une instance dans laquelle se trouve une ou plusieurs bases de données pour lesquelles la protection contre la suppression est activée, vous devez d'abord désactiver cette protection sur toutes les bases de données de cette instance avant de pouvoir supprimer l'instance.
Console
Accédez à la page Instances de Spanner dans la console Google Cloud.
Cliquez sur le nom de l'instance que vous souhaitez supprimer.
Cliquez sur Supprimer l'instance.
Suivez les instructions pour confirmer que vous souhaitez bien supprimer l'instance.
Cliquez sur Supprimer.
gcloud
Exécutez la commande gcloud spanner instances delete
, en remplaçant INSTANCE-ID par l'ID d'instance:
gcloud spanner instances delete INSTANCE-ID
Arrêter ou redémarrer une instance
Spanner est un service de base de données entièrement géré qui supervise ses propres tâches et ressources sous-jacentes, y compris les processus de surveillance et de redémarrage si nécessaire, sans temps d'arrêt. Étant donné qu'il n'est pas nécessaire d'arrêter ou de redémarrer manuellement une instance donnée, Spanner ne permet pas de le faire.
Étapes suivantes
- Découvrez comment insérer, mettre à jour et supprimer des données à l'aide du langage de manipulation de données (LMD) ou de la gcloud CLI.
- Attribuez des rôles Identity and Access Management pour l'instance et ses bases de données.
- Découvrez comment concevoir un schéma Spanner.