Cette page explique comment répertorier, créer, mettre à jour, supprimer et afficher les détails de une configuration d'instance Spanner. Certaines fonctionnalités de configuration d'instance personnalisée ne sont pas disponibles dans le l'UI de la console Google Cloud. Dans ce cas, utilisez les commandes Google Cloud CLI (gcloud) fournies.
Afficher la liste des configurations d'instance
Vous pouvez répertorier toutes les configurations d'instances Spanner disponibles à l'aide de la Google Cloud CLI et des bibliothèques clientes. Pour obtenir la liste de toutes les configurations d'instances Spanner, consultez Configurations régionales et multirégionales
gcloud
Exécutez la commande gcloud spanner instance-configs list
:
gcloud spanner instance-configs list
C++
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez Bibliothèques clientes Spanner.
C#
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez Bibliothèques clientes Spanner.
Go
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez 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 Bibliothèques clientes Spanner.
Python
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez Bibliothèques clientes Spanner.
Ruby
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez Bibliothèques clientes Spanner.
Afficher les détails de la configuration de l'instance
Vous pouvez afficher les détails de n'importe quelle configuration d'instance à l'aide de la propriété
Google Cloud CLI et bibliothèques clientes. Lorsque vous
créer une configuration d'instance personnalisée ;
vous pouvez ajouter n'importe quel emplacement répertorié sous optionalReplicas
en tant qu'instance répliquée facultative.
Si vous ne voyez pas l'emplacement souhaité pour l'instance répliquée en lecture seule, vous pouvez
Demandez une nouvelle région facultative d'instance répliquée en lecture seule.
Pour en savoir plus, consultez la section Créer une configuration d'instance personnalisée.
gcloud
Exécutez la commande gcloud spanner instance-configs describe
:
gcloud spanner instance-configs describe INSTANCE-CONFIG
Indiquez la valeur suivante :
INSTANCE-CONFIG
- La configuration de l'instance, qui définit l'emplacement géographique de
et affecte la réplication des données. Exemple :
eur6
ouus-central1
.
Pour afficher les détails de la configuration de base eur6
, exécutez la commande suivante:
gcloud spanner instance-configs describe eur6
Voici un exemple de résultat pour la configuration de base eur6
:
configType: GOOGLE_MANAGED
displayName: Europe (Netherlands, Frankfurt)
freeInstanceAvailability: UNSUPPORTED
leaderOptions:
- europe-west3
- europe-west4
name: projects/cloud-spanner-demo/instanceConfigs/eur6
optionalReplicas:
- displayName: South Carolina
labels:
cloud.googleapis.com/country: US
cloud.googleapis.com/location: us-east1
cloud.googleapis.com/region: us-east1
location: us-east1
type: READ_ONLY
- displayName: South Carolina
labels:
cloud.googleapis.com/country: US
cloud.googleapis.com/location: us-east1
cloud.googleapis.com/region: us-east1
location: us-east1
type: READ_ONLY
replicas:
- defaultLeaderLocation: true
location: europe-west4
type: READ_WRITE
- location: europe-west4
type: READ_WRITE
- location: europe-west3
type: READ_WRITE
- location: europe-west3
type: READ_WRITE
- location: europe-west6
type: WITNESS
Autres remarques sur l'utilisation:
baseConfig
(pour les configurations personnalisées uniquement) pointe vers la base configuration d'instance. Consultez les configurations régionales disponibles et les configurations multirégionales disponibles pour obtenir les listes des configurations d'instance de base pouvant être utilisées pour créer une configuration d'instance personnalisée.configType
indique si cette configuration d'instance est une configuration d'instance de base ou une configuration d'instance personnalisée.etag
(pour les configurations personnalisées uniquement) est une représentation de la configuration sous forme de chaîne encodée en base64. Il est utilisé pour la simultanéité optimiste le contrôle.
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 Bibliothèques clientes Spanner.
Go
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez Bibliothèques clientes Spanner.
Java
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez Bibliothèques clientes Spanner.
Node.js
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez Bibliothèques clientes Spanner.
PHP
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez Bibliothèques clientes Spanner.
Python
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez Bibliothèques clientes Spanner.
Ruby
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez Bibliothèques clientes Spanner.
Créer une configuration d'instance personnalisée
Vous pouvez créer une configuration d'instance personnalisée régionale ou multirégionale, puis ajouter d'instances répliquées en lecture seule facultatives et prendre en charge les lectures obsolètes à faible latence. Consultez configurations régionales disponibles et les configurations multirégionales disponibles pour obtenir les listes des configurations d'instance de base pouvant être utilisées pour créer une instance configuration d'instance. Vous ne pouvez pas créer de configuration d'instance birégionale. Pour en savoir plus sur Spanner, de réplication, consultez la page Réplication.
Pour créer une configuration d'instance personnalisée, vous devez disposer du
Autorisation spanner.instanceConfigs.create
. Par défaut, les rôles disposant de l'autorisation spanner.instances.create
disposent également de l'autorisation spanner.instanceConfigs.create
.
Console
Vous ne pouvez pas créer de configuration d'instance personnalisée autonome à l'aide de la méthode console Google Cloud. Pour créer une instance avec des instances répliquées en lecture seule, consultez suivez les instructions fournies dans Créez une instance avec une configuration d'instance personnalisée.
Vous pouvez utiliser la Google Cloud CLI et le client pour créer une configuration d'instance personnalisée autonome.
gcloud
Exécutez la commande gcloud spanner instance-configs create
:
gcloud spanner instance-configs create CUSTOM-INSTANCE-CONFIG-ID \
--display-name=DISPLAY-NAME \
--base-config=BASE-CONFIG \
--labels=KEY=VALUE,[...] \
--replicas=location=LOCATION, type=TYPE[:...]
Vous pouvez utiliser l'option --clone-config
pour cloner facilement une autre instance.
une configuration d'instance de base ou personnalisée, tout en déclarant l'emplacement
d'une instance répliquée personnalisée spécifique.
gcloud spanner instance-configs create CUSTOM-INSTANCE-CONFIG-ID \
--display-name=DISPLAY-NAME \
--clone-config=INSTANCE-CONFIG \
--labels=KEY=VALUE,[...] \
--add-replicas=location=LOCATION, type=TYPE[:...] \
--skip-replicas=location=LOCATION, type=TYPE[:...]
Indiquez les valeurs suivantes :
CUSTOM-INSTANCE-CONFIG-ID
- A
un identifiant permanent unique au sein de votre projet Google Cloud. Toi
ne peut pas modifier ultérieurement l'ID de configuration de l'instance.
custom-
est requis pour éviter les conflits de noms avec l'instance de base de configuration. DISPLAY-NAME
- Les à afficher pour la configuration d'instance personnalisée dans console Google Cloud. Si vous choisissez d'utiliser les options `--base-config` et `--replicas`, indiquez les valeurs suivantes :
BASE-CONFIG
- Nom de la région de la configuration d'instance de base sur laquelle votre
une configuration d'instance personnalisée. Par exemple,
eur6
ouregional-us-central1
. LOCATION
- Nom de la région des ressources de diffusion (instances répliquées), par exemple
us-east1
Pour connaître les noms d'établissements acceptés, exécutezgcloud spanner instance-configs describe INSTANCE-CONFIG
et consultez les listesreplicas
etoptionalReplicas
. TYPE
- Type d'instance répliquée. Pour connaître les emplacements et les types de réplicas correspondants acceptés, exécutez
gcloud spanner instance-configs describe INSTANCE-CONFIG
et consultez les listesreplicas
etoptionalReplicas
. Types appartiennent à l'une des catégories suivantes:- READ_ONLY
- READ_WRITE
- TÉMOIN
- Les éléments de la liste sont séparés par : (":").
- À moins que l'option
--[clone-config]
ne soit utilisée, toutes les instances répliquéesLOCATION
etTYPE
doit être spécifié lors de la création d'une configuration d'instance personnalisée, y compris ceux prédéfinis dans la configuration de base. Pour plus consultez les gcloud instance-configs describe help-text.
Si vous choisissez d'utiliser les options --clone-config
et --add-replicas
(uniquement
Utilisez --skip-replicas
si vous souhaitez ignorer des instances répliquées
cloné), fournissez les valeurs suivantes:
--clone-config=INSTANCE-CONFIG
Utilisez cet indicateur pour cloner une autre base ou une instance personnalisée configuration d'instance tout en déclarant l'emplacement et le type une instance répliquée personnalisée spécifique. Ensuite, utilisez
--add-replicas=location=LOCATION,type=TYPE
pour indiquer où vous souhaitez ajouter votre instance répliquée facultative.Par exemple, pour créer une configuration d'instance personnalisée avec deux instances répliquées en lecture seule dans
us-east1
, tout en copiant toutes les autres instances répliquées à partir de la configuration d'instance de baseeur6
, exécutez la commande suivante:gcloud spanner instance-configs create custom-eur6 --clone-config=eur6 \ --add-replicas=location=us-east1,type=READ_ONLY:location=us-east1,type=READ_ONLY
--skip-replicas=location=LOCATION,type=TYPE
Utilisez cet indicateur pour ignorer le clonage de tout réplica.
Par exemple, pour créer une configuration d'instance personnalisée avec un réplica en lecture seule dans
us-east4
tout en copiant tous les autres emplacements de réplication à partir de la configuration d'instance de basenam3
, à l'exception du réplica en lecture seule dansus-central1
, exécutez la commande suivante :gcloud spanner instance-configs create custom-nam3 --clone-config=nam3 \ --add-replicas=location=us-east4,type=READ_ONLY \ --skip-replicas=location=us-central1,type=READ_ONLY
Les options et valeurs suivantes sont facultatives :
--labels=KEY=VALUE,[...]
KEY
etVALUE
: liste des paires clé-valeur à ajouter à la configuration de votre instance personnalisée.Les clés doivent commencer par une lettre minuscule et ne contenir que des traits d'union (-). des traits de soulignement (_), des minuscules et des chiffres. Les valeurs doivent contenir uniquement des traits d'union (-), des traits de soulignement (_), des minuscules et des chiffres.
--validate-only
Utilisez cette option pour vérifier que la requête aboutira avant l'exécution
Par exemple, pour créer une configuration d'instance personnalisée avec la base eur6
avec une instance répliquée supplémentaire en lecture seule dans us-east1
, exécutez la commande suivante:
gcloud spanner instance-configs create custom-eur6 \
--display-name="Custom eur6" --clone-config=eur6 \
--add-replicas=location=us-east1,type=READ_ONLY \
Vous pouvez également créer une configuration d'instance personnalisée sans le
L'indicateur --clone-config
:
gcloud spanner instance-configs create custom-eur6 \
--display-name="Custom eur6" --base-config=eur6 \
--replicas=location=europe-west4,type=READ_WRITE:location=europe-west3,type=READ_WRITE:location=europe-west4,type=READ_WRITE:location=europe-west3,type=READ_WRITE:location=europe-west6,type=WITNESS:location=us-east1,type=READ_ONLY
Vous devriez obtenir le résultat suivant :
Creating instance-config...done.
C++
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez 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 Bibliothèques clientes Spanner.
Java
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez 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 Bibliothèques clientes Spanner.
Python
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez Bibliothèques clientes Spanner.
Ruby
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.
Créer une instance dans une configuration d'instance personnalisée
Vous pouvez créer une instance dans une configuration d'instance personnalisée.
Console
Pour créer une instance dans une configuration d'instance personnalisée, suivez les instructions fournies dans Créer une instance.
Notez qu'il n'est pas nécessaire de créer une instance personnalisée autonome dans la console Google Cloud. La configuration de l'instance est créée automatiquement lorsque vous créez l'instance.
gcloud
Après avoir créé la configuration d'instance personnalisée, suivez les instructions fournies dans Créer une instance.
C++
Après avoir créé la configuration d'instance personnalisée, suivez les instructions fournies dans Créer une instance.
C#
Après avoir créé la configuration d'instance personnalisée, suivez les instructions fournies dans Créer une instance.
Go
Après avoir créé la configuration d'instance personnalisée, suivez les instructions fournies dans Créer une instance.
Java
Après avoir créé la configuration d'instance personnalisée, suivez les instructions fournies dans Créer une instance.
Node.js
Après avoir créé la configuration d'instance personnalisée, suivez les instructions fournies dans Créer une instance.
PHP
Après avoir créé la configuration d'instance personnalisée, suivez les instructions fournies dans Créer une instance.
Python
Après avoir créé la configuration d'instance personnalisée, suivez les instructions fournies dans Créer une instance.
Ruby
Après avoir créé la configuration d'instance personnalisée, suivez les instructions fournies dans Créer une instance.
Mettre à jour une configuration d'instance personnalisée
Vous pouvez modifier le nom à afficher et les libellés d'une configuration d'instance personnalisée.
Vous ne pouvez pas modifier ni mettre à jour les instances répliquées de la configuration de votre instance personnalisée.
Vous pouvez toutefois créer une configuration d'instance personnalisée avec
d'instances répliquées, puis déplacez-la vers la nouvelle
une configuration d'instance personnalisée avec les instances répliquées supplémentaires de votre choix. Par exemple,
si votre instance se trouve dans us-central1
et que vous souhaitez ajouter une instance répliquée en lecture seule
us-west1
, vous devez alors créer une configuration d'instance personnalisée avec
us-central1
comme configuration de base et ajouter us-west1
en lecture seule
d'une instance répliquée. Ensuite, déplacez votre instance vers
une nouvelle configuration d'instance personnalisée.
gcloud
Utilisez la commande gcloud spanner instance-configs update
:
gcloud spanner instance-configs update CUSTOM-INSTANCE-CONFIG-ID \
--display-name=NEW-DISPLAY-NAME \
--update-labels=KEY=VALUE,[...], \
--etag=ETAG
Indiquez les valeurs suivantes :
CUSTOM-INSTANCE-CONFIG-ID
- Identifiant permanent de votre configuration d'instance personnalisée.
Il commencera par
custom-
. NEW-DISPLAY-NAME
- Nouveau nom à afficher pour la configuration de l'instance dans la section console Google Cloud.
KEY
etVALUE
- Liste des paires clé/valeur à mettre à jour.
- Les clés doivent commencer par une lettre minuscule et ne contenir que des traits d'union (-), des traits de soulignement (_), des minuscules et des chiffres. Les valeurs doivent ne contenir que des traits d'union (-), des traits de soulignement (_), des minuscules et de chiffres.
Les options et valeurs suivantes sont facultatives:
--etag=ETAG
:ETAG
peut être utilisé pour sélectionner et ignorer des mises à jour simultanées dans un lecture-modification-écriture.--validate-only
: utilisez cette option pour vérifier que la requête va aboutir. avant de l'exécuter.
Exemple :
gcloud spanner instance-configs update custom-eur6 \
--display-name="Customer managed europe replicas"
C++
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez Bibliothèques clientes Spanner.
C#
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez Bibliothèques clientes Spanner.
Go
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez Bibliothèques clientes Spanner.
Java
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez Bibliothèques clientes Spanner.
Node.js
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez Bibliothèques clientes Spanner.
PHP
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez Bibliothèques clientes Spanner.
Python
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez Bibliothèques clientes Spanner.
Ruby
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez Bibliothèques clientes Spanner.
Supprimer une configuration d'instance personnalisée
Pour supprimer une configuration d'instance personnalisée, commencez par supprimer toute instance dans le configuration d'instance.
gcloud
Utilisez la commande gcloud spanner instance-configs delete
en remplaçant CUSTOM-INSTANCE-CONFIG-ID
par l'ID de configuration de l'instance personnalisée :
gcloud spanner instance-configs delete CUSTOM-INSTANCE-CONFIG-ID
C++
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez Bibliothèques clientes Spanner.
C#
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez Bibliothèques clientes Spanner.
Go
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez Bibliothèques clientes Spanner.
Java
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez Bibliothèques clientes Spanner.
Node.js
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez Bibliothèques clientes Spanner.
PHP
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez Bibliothèques clientes Spanner.
Python
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez Bibliothèques clientes Spanner.
Ruby
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez Bibliothèques clientes Spanner.
Étape suivante
- Découvrez comment insérer, mettre à jour et supprimer des données avec le langage de manipulation de données. (LMD) ou à la gcloud CLI.
- Attribuez des rôles IAM pour l'instance et ses les bases de données.
- Découvrez comment concevoir un schéma Spanner.
- Quotas et limites de Spanner.