Questa pagina descrive come elencare, creare, aggiornare, eliminare e mostrare i dettagli di una configurazione di istanza di Spanner. Alcune funzionalità di configurazione delle istanze personalizzate non sono disponibili nell'interfaccia utente della console Google Cloud. In questi casi, utilizza i comandi Google Cloud CLI (gcloud) forniti.
Elenca le configurazioni delle 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 di istanze Spanner, consulta Configurazioni a livello di una o 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à di replica di sola lettura che ti interessa, puoi richiedere una nuova regione di replica di sola lettura facoltativa.
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 valore seguente:
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 mostrare 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) punta alla configurazione dell'istanza di base. Fai riferimento alle configurazioni regionali disponibili e alle configurazioni per più regioni disponibili per gli elenchi di configurazioni di istanze di base utilizzabili per creare una configurazione di istanze personalizzate.configType
indica se la configurazione dell'istanza è una configurazione dell'istanza di base o una configurazione dell'istanza personalizzata.etag
(solo per le configurazioni personalizzate) è una rappresentazione stringa della configurazione con codifica Base64. Viene usato per un 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 personalizzata di istanze a livello di regione o più regioni e aggiungere repliche di sola lettura facoltative per scalare le letture e supportare letture inattive a bassa latenza. Consulta le configurazioni regionali disponibili e le configurazioni per più regioni disponibili per gli elenchi delle configurazioni delle istanze di base utilizzabili per creare una configurazione delle istanze personalizzate. Non puoi creare una configurazione di istanze a due regioni personalizzata. Per ulteriori informazioni sui tipi di replica e replica di Spanner, consulta Replica.
Per creare una configurazione di istanza personalizzata, devi disporre dell'autorizzazione spanner.instanceConfigs.create
. Per impostazione predefinita, i ruoli che hanno l'autorizzazione spanner.instances.create
avranno anche l'autorizzazione spanner.instanceConfigs.create
.
Console
Non puoi creare una configurazione autonoma di un'istanza personalizzata 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 autonoma dell'istanza personalizzata.
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 base o la configurazione di un'istanza personalizzata, dichiarando anche la posizione 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 dell'istanza 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à sono accettati, eseguigcloud spanner instance-configs describe INSTANCE-CONFIG
e consulta gli elenchireplicas
eoptionalReplicas
. TYPE
- Il tipo di replica. Per scoprire quali località e tipi di replica corrispondenti sono accettati, esegui
gcloud spanner instance-configs describe INSTANCE-CONFIG
e consulta gli 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 quando si crea una configurazione di istanza personalizzata, incluse quelle predefinite nella configurazione di base. Per ulteriori informazioni, consulta la pagina gcloud instance-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 vuoi saltare la clonazione), specifica i seguenti valori:
--clone-config=INSTANCE-CONFIG
Utilizza questo flag come metodo conveniente per clonare un'altra configurazione di base o di un'istanza personalizzata, dichiarando anche 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 di istanza personalizzata con due repliche di sola lettura in
us-east1
durante la copia di 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 saltare la clonazione di qualsiasi replica.
Ad esempio, per creare una configurazione di istanza personalizzata con una replica di sola lettura in
us-east4
durante la copia di 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 (_), caratteri minuscoli e numeri. I valori devono contenere solo trattini (-), trattini bassi (_), caratteri minuscoli e numeri.
--validate-only
Utilizza questo flag per confermare che la richiesta avrà esito positivo 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 in una configurazione di istanza personalizzata
Puoi creare un'istanza in una configurazione dell'istanza personalizzata.
Console
Per creare un'istanza in una configurazione di istanza personalizzata, segui le istruzioni fornite in Creare un'istanza.
Tieni presente che non è necessario creare una configurazione autonoma di un'istanza personalizzata nella console Google Cloud. La configurazione dell'istanza viene creata automaticamente quando crei l'istanza.
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 della configurazione di un'istanza personalizzata.
Non puoi modificare o aggiornare le repliche della configurazione dell'istanza personalizzata.
Tuttavia, puoi creare una nuova configurazione dell'istanza personalizzata con ulteriori repliche, quindi spostare l'istanza alla nuova configurazione dell'istanza personalizzata con le repliche aggiuntive che hai scelto. Ad esempio, se l'istanza si trova in us-central1
e vuoi aggiungere una replica di sola lettura us-west1
, devi creare una nuova configurazione dell'istanza personalizzata con us-central1
come configurazione di base e aggiungere us-west1
come replica di sola lettura. Quindi sposta l'istanza in questa
nuova 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 (_), caratteri minuscoli e numeri. I valori devono contenere solo trattini (-), trattini bassi (_), caratteri minuscoli e numeri.
I seguenti flag e valori sono facoltativi:
--etag=ETAG
: è possibile utilizzare l'argomentoETAG
per selezionare e saltare gli aggiornamenti simultanei in uno scenario di lettura, modifica e scrittura.--validate-only
: utilizza questo flag per confermare che la richiesta avrà 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 nella configurazione dell'istanza.
gcloud
Usa 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 i ruoli IAM per l'istanza e i relativi database.
- Scopri come progettare uno schema Spanner.
- Quote e limiti di Spanner.