Questa pagina descrive come elencare, creare, aggiornare, eliminare e visualizzare i dettagli di una configurazione dell'istanza di Spanner. Alcune funzionalità di configurazione dell'istanza personalizzata non sono disponibili nella UI della console Google Cloud. In questi casi, utilizza i comandi Google Cloud CLI (gcloud) forniti.
Elenca configurazioni di istanze
Puoi elencare tutte le configurazioni di istanze Spanner disponibili con Google Cloud CLI e le librerie client. Per trovare un elenco di tutte le configurazioni delle istanze Spanner, consulta Configurazioni a livello di regione e più regioni.
gcloud
Esegui il comando gcloud spanner instance-configs list
:
gcloud spanner instance-configs list
C++
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
C#
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
Go
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
Java
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
Node.js
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
PHP
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
Python
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
Ruby
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
Mostra dettagli di configurazione dell'istanza
Puoi mostrare i dettagli di qualsiasi configurazione dell'istanza con
Google Cloud CLI e le librerie client. Quando crei una nuova configurazione dell'istanza personalizzata, puoi aggiungere qualsiasi località elencata in optionalReplicas
come replica facoltativa.
Se non vedi la località della replica di sola lettura che preferisci, puoi richiedere una nuova regione facoltativa per la replica di sola lettura.
Per maggiori informazioni, consulta Creare una configurazione di istanza personalizzata.
gcloud
Esegui il comando gcloud spanner instance-configs describe
:
gcloud spanner instance-configs describe INSTANCE-CONFIG
Specifica il seguente valore:
INSTANCE-CONFIG
- La configurazione dell'istanza, che definisce la posizione geografica dell'istanza e influisce sul modo in cui i dati vengono replicati. Ad esempio,
eur6
ous-central1
.
Per visualizzare i dettagli della configurazione di base di eur6
, esegui:
gcloud spanner instance-configs describe eur6
Ecco un output di esempio per la configurazione di 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
Note aggiuntive sull'utilizzo:
baseConfig
(solo per le configurazioni personalizzate) rimanda alla configurazione dell'istanza di base. Consulta le configurazioni a livello di regione disponibili e le configurazioni multiregionali disponibili per gli elenchi di configurazioni di istanze di base che possono essere utilizzate per creare una configurazione di istanze personalizzate.configType
indica se questa configurazione dell'istanza è un'istanza di base o una configurazione di istanza personalizzata.etag
(solo per le configurazioni personalizzate) è una rappresentazione stringa della configurazione con codifica Base64. Viene usato per il controllo ottimistico della contemporaneità.
C++
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
C#
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
Go
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
Java
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
Node.js
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
PHP
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
Python
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
Ruby
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
Crea una configurazione di istanza personalizzata
Puoi creare una configurazione dell'istanza personalizzata e aggiungere repliche di sola lettura facoltative per scalare le letture e supportare le letture inattive a bassa latenza. Consulta le configurazioni a livello di regione disponibili e le configurazioni multiregionali disponibili per gli elenchi di configurazioni di istanze di base che possono essere utilizzate per creare una configurazione di istanze personalizzate. Per saperne di più sui tipi di replica e replica di Spanner, consulta Replica.
Per creare una configurazione dell'istanza personalizzata, devi avere l'autorizzazione spanner.instanceConfigs.create
. Per impostazione predefinita, i ruoli con l'autorizzazione spanner.instances.create
avranno anche l'autorizzazione spanner.instanceConfigs.create
.
Console
Non puoi creare una configurazione di istanza personalizzata autonoma utilizzando la console Google Cloud. Per creare un'istanza con repliche di sola lettura, consulta le istruzioni fornite in Creare un'istanza con la configurazione dell'istanza personalizzata.
Puoi utilizzare Google Cloud CLI e le librerie client per creare una configurazione di istanza personalizzata autonoma.
gcloud
Usa il comando 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[:...]
Puoi utilizzare il flag --clone-config
come metodo conveniente per clonare un'altra configurazione di base o di istanza personalizzata, dichiarando al contempo la località e il tipo di una replica personalizzata specifica.
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[:...]
Fornisci i seguenti valori:
CUSTOM-INSTANCE-CONFIG-ID
- Un identificatore permanente univoco all'interno del tuo progetto Google Cloud. Non puoi modificare l'ID configurazione dell'istanza in un secondo momento. Il prefisso
custom-
è obbligatorio per evitare conflitti di nomi con le configurazioni delle istanze di base. DISPLAY-NAME
- Il nome da visualizzare per la configurazione dell'istanza personalizzata nella console Google Cloud. Se scegli di utilizzare i flag "--base-config" e "--replicas", fornisci i seguenti valori:
BASE-CONFIG
- Il nome della regione della configurazione dell'istanza di base su cui si basa la configurazione dell'istanza personalizzata. Ad esempio,
eur6
oregional-us-central1
. LOCATION
- Il nome della regione delle risorse di gestione (repliche), ad esempio
us-east1
. Per scoprire quali nomi di località vengono accettati, eseguigcloud spanner instance-configs describe INSTANCE-CONFIG
e fai riferimento agli elenchireplicas
eoptionalReplicas
. TYPE
- Il tipo di replica. Per scoprire quali località e tipi di repliche corrispondenti sono accettati, esegui
gcloud spanner instance-configs describe INSTANCE-CONFIG
e fai riferimento agli elenchireplicas
eoptionalReplicas
. I tipi sono uno dei seguenti:- READ_ONLY
- READ_WRITE
- TESTIMONIANZA
- Gli elementi nell'elenco sono separati da ":".
- A meno che non venga utilizzato il flag
--[clone-config]
, tutte le replicheLOCATION
eTYPE
devono essere specificate durante la creazione di una configurazione di istanza personalizzata, comprese quelle predefinite nella configurazione di base. Per maggiori informazioni, consulta gcloud instances-configs describe help-text.
Se scegli di utilizzare i flag --clone-config
e --add-replicas
(utilizza --skip-replicas
solo se ci sono repliche di cui non vuoi eseguire la clonazione), fornisci i seguenti valori:
--clone-config=INSTANCE-CONFIG
Utilizza questo flag come modo pratico per clonare un'altra configurazione di base o di istanza personalizzata, dichiarando al contempo la località e il tipo di una specifica replica personalizzata. Quindi utilizza
--add-replicas=location=LOCATION,type=TYPE
per specificare dove vuoi aggiungere la replica facoltativa.Ad esempio, per creare una configurazione dell'istanza personalizzata con due repliche di sola lettura in
us-east1
e copiare tutte le altre località di replica dalla configurazione dell'istanza di baseeur6
, esegui: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
Utilizza questo flag per evitare la clonazione di eventuali repliche.
Ad esempio, per creare una configurazione dell'istanza personalizzata con una replica di sola lettura in
us-east4
e copiare tutte le altre località di replica dalla configurazione dell'istanza di basenam3
, ad eccezione della replica di sola lettura inus-central1
, esegui: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
I seguenti flag e valori sono facoltativi:
--labels=KEY=VALUE,[...]
KEY
eVALUE
: un elenco di coppie chiave-valore da aggiungere alla configurazione dell'istanza personalizzata.Le chiavi devono iniziare con un carattere minuscolo e contenere solo trattini (-), trattini bassi (_), lettere minuscole e numeri. I valori devono contenere solo trattini (-), trattini bassi (_), lettere minuscole e numeri.
--validate-only
Utilizza questo flag per verificare che la richiesta vada a buon fine prima di eseguirla.
Ad esempio, per creare una configurazione dell'istanza personalizzata con la configurazione di base eur6
con una replica di sola lettura aggiuntiva in us-east1
, esegui:
gcloud spanner instance-configs create custom-eur6 \
--display-name="Custom eur6" --clone-config=eur6 \
--add-replicas=location=us-east1,type=READ_ONLY \
Puoi anche creare una configurazione dell'istanza personalizzata senza il flag --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
Dovresti vedere l'output seguente:
Creating instance-config...done.
C++
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
C#
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
Go
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
Java
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
Node.js
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
PHP
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
Python
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
Ruby
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
Crea un'istanza con una configurazione dell'istanza personalizzata
Puoi creare un'istanza con una configurazione dell'istanza personalizzata.
Console
Per creare un'istanza con una configurazione personalizzata, segui le istruzioni fornite in Creare un'istanza.
Tieni presente che non è necessario creare una configurazione dell'istanza personalizzata autonoma nella console Google Cloud. La configurazione dell'istanza viene creata automaticamente quando viene creata.
gcloud
Dopo aver creato la configurazione dell'istanza personalizzata, segui le istruzioni fornite in Creare un'istanza.
C++
Dopo aver creato la configurazione dell'istanza personalizzata, segui le istruzioni fornite in Creare un'istanza.
C#
Dopo aver creato la configurazione dell'istanza personalizzata, segui le istruzioni fornite in Creare un'istanza.
Go
Dopo aver creato la configurazione dell'istanza personalizzata, segui le istruzioni fornite in Creare un'istanza.
Java
Dopo aver creato la configurazione dell'istanza personalizzata, segui le istruzioni fornite in Creare un'istanza.
Node.js
Dopo aver creato la configurazione dell'istanza personalizzata, segui le istruzioni fornite in Creare un'istanza.
PHP
Dopo aver creato la configurazione dell'istanza personalizzata, segui le istruzioni fornite in Creare un'istanza.
Python
Dopo aver creato la configurazione dell'istanza personalizzata, segui le istruzioni fornite in Creare un'istanza.
Ruby
Dopo aver creato la configurazione dell'istanza personalizzata, segui le istruzioni fornite in Creare un'istanza.
Aggiorna la configurazione di un'istanza personalizzata
Puoi modificare il nome visualizzato e le etichette di una configurazione di istanza personalizzata. Non puoi modificare o aggiornare le repliche della configurazione dell'istanza personalizzata.
gcloud
Usa il comando 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
Fornisci i seguenti valori:
CUSTOM-INSTANCE-CONFIG-ID
- Un identificatore permanente della configurazione dell'istanza personalizzata.
Inizierà con
custom-
. NEW-DISPLAY-NAME
- Il nuovo nome da visualizzare per la configurazione dell'istanza nella console Google Cloud.
KEY
eVALUE
- Un elenco di coppie chiave-valore da aggiornare.
- Le chiavi devono iniziare con un carattere minuscolo e contenere solo trattini (-), trattini bassi (_), lettere minuscole e numeri. I valori devono contenere solo trattini (-), trattini bassi (_), lettere minuscole e numeri.
I seguenti flag e valori sono facoltativi:
--etag=ETAG
: l'argomentoETAG
può essere utilizzato per selezionare e ignorare gli aggiornamenti simultanei in uno scenario di lettura, modifica e scrittura.--validate-only
: utilizza questo flag per confermare che la richiesta abbia esito positivo prima di eseguirla.
Ad esempio:
gcloud spanner instance-configs update custom-eur6 \
--display-name="Customer managed europe replicas"
C++
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
C#
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
Go
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
Java
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
Node.js
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
PHP
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
Python
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
Ruby
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
Elimina una configurazione di istanza personalizzata
Per eliminare una configurazione dell'istanza personalizzata, elimina prima qualsiasi istanza al suo interno.
gcloud
Utilizza il comando gcloud spanner instance-configs delete
, sostituendo CUSTOM-INSTANCE-CONFIG-ID
con l'ID di configurazione dell'istanza personalizzata:
gcloud spanner instance-configs delete CUSTOM-INSTANCE-CONFIG-ID
C++
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
C#
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
Go
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
Java
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
Node.js
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
PHP
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
Python
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
Ruby
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta librerie client di Spanner.
Passaggi successivi
- Scopri come inserire, aggiornare ed eliminare dati con Data Manipulation Language (DML) o gcloud CLI.
- Concedi ruoli IAM per l'istanza e i suoi database.
- Scopri come progettare uno schema Spanner.
- Quote e limiti di Spanner.