Questa pagina descrive come creare, elencare, modificare ed eliminare le istanze Spanner.
Crea un'istanza
Puoi creare un'istanza con la console Google Cloud , Google Cloud CLI o le librerie client. Puoi anche creare un'istanza con una configurazione personalizzata aggiungendo repliche di sola lettura facoltative.
Console
Nella console Google Cloud , vai alla pagina Istanze Spanner.
Fai clic su Crea istanza.
Nella sezione Seleziona una versione, seleziona una versione di Spanner.
Se vuoi confrontare le specifiche delle diverse versioni, fai clic su Confronta le versioni. Per ulteriori informazioni, consulta la Panoramica delle versioni di Spanner.
Fai clic su Continua.
Nella sezione Assegna un nome all'istanza, inserisci un Nome istanza da visualizzare nella console Google Cloud . Il nome dell'istanza deve essere univoco all'interno del tuo Google Cloud progetto.
Inserisci un ID istanza per identificare in modo permanente la tua istanza. L'ID istanza deve essere univoco anche all'interno del progetto Google Cloud . Non potrai modificare l'ID istanza in un secondo momento.
Fai clic su Continua.
Nella sezione Configura l'istanza, in Scegli una configurazione, seleziona Regionale, A due regioni o Multi-regionale.
Seleziona una posizione di configurazione dal menu a discesa.
(Facoltativo) Per aggiungere una replica di sola lettura a una configurazione base di Spanner, crea prima una configurazione dell'istanza personalizzata utilizzando Google Cloud CLI. L'aggiunta di repliche di sola lettura facoltative a una configurazione di base è disponibile nelle versioni Enterprise ed Enterprise Plus.
Fai clic su Continua.
Nella sezione Alloca capacità di calcolo, in Seleziona unità, fai clic su una delle seguenti opzioni:
- Nodi per istanze di grandi dimensioni. Un nodo è pari a 1000 unità di elaborazione.
- Unità di elaborazione per le istanze piccole.
Per saperne di più, consulta Capacità di calcolo, nodi e unità di elaborazione.
In Scegli una modalità di scalabilità, fai clic su una delle seguenti opzioni:
Allocazione manuale se vuoi impostare manualmente la capacità di calcolo per risorse e costi di calcolo fissi.
- Quantità indica il numero di unità di elaborazione o nodi da utilizzare per questa istanza.
Scalabilità automatica per consentire a Spanner di aggiungere e rimuovere automaticamente la capacità di calcolo. Lo scalatore automatico gestito è disponibile nelle versioni Enterprise ed Enterprise Plus di Spanner. Per saperne di più sul gestore della scalabilità automatica gestito, consulta Gestore della scalabilità automatica gestito per Spanner. Configura le seguenti opzioni del gestore della scalabilità automatica gestito:
- Minimo indica il limite minimo di fare lo scale down, a seconda dell'unità di misura scelta per Capacità di calcolo. Per ulteriori informazioni, vedi Determinare il limite minimo.
- Massimo indica il limite massimo di scalabilità, a seconda dell'unità di misura scelta per la capacità di calcolo. Per saperne di più, consulta Determinare il limite massimo.
- Target di utilizzo ad alta priorità della CPU indica la percentuale target di CPU da utilizzare per le attività ad alta priorità. Per maggiori informazioni, consulta Determinare il target di utilizzo della CPU.
- Target di utilizzo totale della CPU indica la percentuale target di CPU da utilizzare per tutte le attività a priorità bassa, media e alta. Per ulteriori informazioni, vedi Determinare il target di utilizzo totale della CPU.
- Target di utilizzo dello spazio di archiviazione indica la percentuale target di spazio di archiviazione da utilizzare. Per saperne di più, consulta Determinare la destinazione di utilizzo dello spazio di archiviazione.
(Facoltativo) Se selezioni Scalabilità automatica come modalità di scalabilità, puoi fare clic sul menu a discesa Mostra opzioni di scalabilità automatica asimmetrica per scalare automaticamente le repliche di sola lettura indipendentemente dalle altre repliche. Per saperne di più, consulta Scalabilità automatica asimmetrica di sola lettura.
Seleziona la replica di sola lettura che vuoi scalare automaticamente in modo asimmetrico.
Configura le seguenti opzioni del gestore della scalabilità automatica asimmetrica:
- Minimo indica il limite minimo di fare lo scale down, a seconda dell'unità di misura scelta per Capacità di calcolo. Per ulteriori informazioni, vedi Determinare il limite minimo.
- Massimo indica il limite massimo di scalabilità, a seconda dell'unità di misura scelta per la capacità di calcolo. Per saperne di più, consulta Determinare il limite massimo.
- Target di utilizzo ad alta priorità della CPU indica la percentuale target di CPU da utilizzare per le attività ad alta priorità. Per saperne di più, consulta Determinare il target di utilizzo della CPU ad alta priorità.
- Target di utilizzo totale della CPU indica la percentuale target di CPU da utilizzare per tutte le attività a bassa, media e alta priorità. La percentuale di CPU può variare dal 10 al 90%. Il target CPU totale deve essere maggiore del target CPU ad alta priorità. Se ottimizzi in base al costo, utilizza una percentuale più elevata. Per ulteriori informazioni, vedi Determinare il target di utilizzo totale della CPU.
- Disabilita CPU totale indica che il gestore della scalabilità automatica deve ignorare esplicitamente il target CPU totale.
- Disattiva CPU ad alta priorità indica che il gestore della scalabilità automatica deve ignorare esplicitamente il target CPU per le attività ad alta priorità.
Nella sezione Backup, la casella di controllo Abilita le pianificazioni dei backup predefiniti è selezionata per impostazione predefinita. Per disattivare le pianificazioni dei backup predefiniti, deseleziona la casella di controllo. Se abilitata, tutti i nuovi database nell'istanza hanno backup completi creati ogni 24 ore. Questi backup vengono conservati per 7 giorni. Puoi modificare o eliminare le pianificazioni del backup predefinite in qualsiasi momento. Per saperne di più, consulta Pianificazioni di backup predefinite.
Fai clic sul pulsante Crea per creare l'istanza.
gcloud
Utilizza il comando gcloud spanner instances create
per creare un'istanza. Specifica la capacità di calcolo
come numero di nodi o unità di elaborazione che vuoi nell'istanza.
gcloud spanner instances create INSTANCE_ID \ --edition=EDITION \ --config=INSTANCE_CONFIG \ --description=INSTANCE_DESCRIPTION \ --default-backup-schedule-type=DEFAULT_BACKUP_SCHEDULE_TYPE \ --nodes=NODE_COUNT
o
gcloud spanner instances create INSTANCE_ID \ --edition=EDITION \ --config=INSTANCE_CONFIG \ --description=INSTANCE_DESCRIPTION \ --default-backup-schedule-type=DEFAULT_BACKUP_SCHEDULE_TYPE \ --processing-units=PROCESSING_UNIT_COUNT
Sostituisci quanto segue:
- INSTANCE-ID: un identificatore permanente univoco all'interno del tuo progetto Google Cloud . Non potrai modificare l'ID istanza in un secondo momento.
- INSTANCE-CONFIG: un identificatore permanente della configurazione dell'istanza, che definisce la posizione geografica dell'istanza e influisce sulla modalità di replica dei dati. Per le configurazioni personalizzate delle istanze, inizia con
custom-. Per saperne di più, consulta Configurazioni dell'istanza. - INSTANCE_DESCRIPTION: il nome da visualizzare per l'istanza nella Google Cloud console. Il nome dell'istanza deve essere univoco all'interno del progettoGoogle Cloud .
DEFAULT_BACKUP_SCHEDULE_TYPE: il tipo di pianificazione di backup predefinita utilizzato nell'istanza. Deve essere uno dei seguenti valori:
AUTOMATIC: viene creata automaticamente una pianificazione di backup predefinita quando viene creato un nuovo database nell'istanza. La pianificazione del backup predefinita crea un backup completo ogni 24 ore. Questi backup completi vengono conservati per 7 giorni. Puoi modificare o eliminare la pianificazione del backup predefinita una volta creata.NONE: una pianificazione di backup predefinita non viene creata automaticamente quando viene creato un nuovo database nell'istanza.
NODE-COUNT: la capacità di calcolo dell'istanza, espressa come numero di nodi. Ogni nodo equivale a 1000 unità di elaborazione.
PROCESSING_UNIT_COUNT: la capacità di calcolo dell'istanza, espressa come numero di unità di elaborazione. Inserisci quantità fino a 1000 in multipli di 100 (100, 200, 300 e così via) e quantità maggiori in multipli di 1000 (1000, 2000, 3000 e così via). Nota: non utilizzare questo parametro se stai creando un'istanza che intendi abilitare in un secondo momento con il gestore della scalabilità automatica gestito.
Aggiungi la scalabilità automatica gestita
Puoi anche creare istanze delle versioni Enterprise ed Enterprise Plus per utilizzare la scalabilità automatica gestita con il comando gcloud spanner instances create. Per saperne di più, consulta
Gestore della scalabilità automatica gestito per Spanner.
Utilizza il seguente comando per creare un'istanza con il gestore della scalabilità automatica gestito.
gcloud spanner instances create INSTANCE_ID \
--edition=EDITION \
--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=HIGH_PRIORITY_CPU_PERCENTAGE \
--autoscaling-total-cpu-target=TOTAL_CPU_PERCENTAGE \
--autoscaling-storage-target=STORAGE_PERCENTAGE \
[--disable-downscaling | --no-disable-downscaling] \
[--asymmetric-autoscaling-option \
location=ASYMMETRIC_AUTOSCALING_LOCATION,\
min_nodes=ASYMMETRIC_AUTOSCALING_MIN,\
max_nodes=ASYMMETRIC_AUTOSCALING_MAX,\
high_priority_cpu_target=ASYMMETRIC_HIGH_PRIORITY_CPU_TARGET,\
total_cpu_target=ASYMMETRIC_TOTAL_CPU_TARGET \
[,disable_total_cpu_autoscaling=TRUE|FALSE \
| disable_high_priority_cpu_autoscaling=TRUE|FALSE]
]o
gcloud spanner instances create INSTANCE_ID \
--edition=EDITION \
--config=INSTANCE_CONFIG \
--description=INSTANCE_DESCRIPTION \
--autoscaling-min-nodes=MINIMUM_NODES \
--autoscaling-max-nodes=MAXIMUM_NODES \
--autoscaling-high-priority-cpu-target=HIGH_PRIORITY_CPU_PERCENTAGE \
--autoscaling-total-cpu-target=TOTAL_CPU_PERCENTAGE \
--autoscaling-storage-target=STORAGE_PERCENTAGE \
[--disable-downscaling | --no-disable-downscaling] \
[--asymmetric-autoscaling-option \
location=ASYMMETRIC_AUTOSCALING_LOCATION,\
min_nodes=ASYMMETRIC_AUTOSCALING_MIN,\
max_nodes=ASYMMETRIC_AUTOSCALING_MAX,\
high_priority_cpu_target=ASYMMETRIC_HIGH_PRIORITY_CPU_TARGET, \
total_cpu_target=ASYMMETRIC_TOTAL_CPU_TARGET, \
[,disable_total_cpu_autoscaling=TRUE|FALSE \
| disable_high_priority_cpu_autoscaling=TRUE|FALSE]
]Sostituisci quanto segue:
- INSTANCE-ID: un identificatore permanente univoco all'interno del tuo progetto Google Cloud . Non potrai modificare l'ID istanza in un secondo momento.
- INSTANCE-CONFIG: un identificatore permanente della configurazione dell'istanza, che definisce la posizione geografica dell'istanza e influisce sulla modalità di replica dei dati. Per le configurazioni personalizzate delle istanze, inizia con
custom-. Per saperne di più, consulta Configurazioni dell'istanza. - INSTANCE-DESCRIPTION: il nome da visualizzare per l'istanza nella Google Cloud console. Il nome dell'istanza deve essere univoco all'interno del progettoGoogle Cloud .
- MINIMUM_PROCESSING_UNITS, MINIMUM_NODES: il numero minimo di unità di elaborazione o nodi durante la riduzione della scalabilità. Per saperne di più, consulta Determinare il limite minimo.
- MAXIMUM_PROCESSING_UNITS, MAXIMUM_NODES: il numero massimo di unità di elaborazione o nodi durante lo scale up. Per saperne di più, consulta Determinare il limite massimo.
- HIGH_PRIORITY_CPU_PERCENTAGE: la percentuale target di CPU ad alta priorità da utilizzare, in base alla priorità dell'attività. La percentuale di CPU può variare dal 10 al 90%. Se esegui l'ottimizzazione in base al costo, utilizza una percentuale più elevata. Per saperne di più, consulta Determinare il target di utilizzo della CPU ad alta priorità.
- TOTAL_CPU_PERCENTAGE: la percentuale target della CPU con priorità totale da utilizzare. Il target CPU totale deve essere maggiore del target CPU ad alta priorità. La percentuale di CPU può variare dal 10 al 90%. Se stai ottimizzando in base al costo, utilizza una percentuale più elevata. Per ulteriori informazioni, consulta Determinare il target di utilizzo totale della CPU.
- STORAGE_PERCENTAGE: la percentuale target di spazio di archiviazione da utilizzare, da 10 a 99%. Per saperne di più, consulta Determinare la destinazione di utilizzo dello spazio di archiviazione.
Flag facoltativi:
--disable-downscaling: utilizza questo flag booleano per disattivare la riduzione della scalabilità. Se impostato suTRUE, impedisce al gestore della scalabilità automatica di ridurre il numero di nodi o unità di elaborazione. L'upscaling continua a funzionare normalmente per soddisfare la maggiore domanda. Per attivare la riduzione della scalabilità dopo averla disattivata, utilizza il flag--no-disable-downscaling.--asymmetric-autoscaling-option: utilizza questo flag per abilitare la scalabilità automatica asimmetrica. Sostituisci i seguenti parametri:- ASYMMETRIC_AUTOSCALING_LOCATION: se viene utilizzato il flag, questo parametro è obbligatorio. La posizione della regione di sola lettura che vuoi scalare in modo asimmetrico.
- ASYMMETRIC_AUTOSCALING_MIN: parametro facoltativo. Il numero minimo di nodi durante la riduzione della scalabilità. Se non specificato, questo valore viene ereditato dalla configurazione dell'istanza di base.
- ASYMMETRIC_AUTOSCALING_MAX: parametro facoltativo. Il numero massimo di nodi durante lo scale up. Se non specificato, questo valore viene ereditato dalla configurazione dell'istanza di base.
- ASYMMETRIC_HIGH_PRIORITY_CPU_TARGET: parametro facoltativo. La percentuale target di CPU da utilizzare, in base alla priorità dell'attività. Se non specificato, questo valore viene ereditato dalla configurazione dell'istanza di base. Se stai ottimizzando in base al costo, utilizza una percentuale più elevata. Le repliche possono avere una percentuale target diversa rispetto all'istanza di base e alle altre repliche, ma per gli scenari di failover consigliamo di utilizzare target coerenti tra le diverse repliche. Per saperne di più, consulta Considerazioni sul failover.
- ASYMMETRIC_TOTAL_CPU_TARGET: parametro facoltativo. Imposta il target dal 10 al 90% per la CPU totale. Se non specificato, questo valore viene ereditato dalla configurazione dell'istanza di base. Se stai ottimizzando in base al costo, utilizza una percentuale più elevata. Le repliche possono avere una percentuale target diversa rispetto all'istanza di base e alle altre repliche, ma per gli scenari di failover consigliamo di utilizzare target coerenti tra le diverse repliche. Per saperne di più, consulta Scalabilità automatica asimmetrica di sola lettura.
disable_total_cpu_autoscaling: imposta questo parametro suTRUEse non vuoi che il gestore della scalabilità automatica esegua la scalabilità automatica della CPU totale sulle repliche. Non specificare questo parametro se vuoi che l'istanza erediti la destinazionetotal_cpu_autoscalingdall'istanza di base. Non puoi disattivare sia la CPU totale sia la CPU ad alta priorità nella stessa replica.disable_high_priority_cpu_autoscaling: impostadisable_high_priority_cpu_autoscalingsuTRUEse non vuoi che il gestore della scalabilità automatica esegua la scalabilità automatica della CPU ad alta priorità sulle repliche. Non specificare questo parametro se vuoi che l'istanza erediti la destinazionehigh_priority_cpu_autoscalingdall'istanza di base. Non puoi disattivare sia la CPU totale sia la CPU ad alta priorità sulla stessa replica.
Esempi di utilizzo delle configurazioni personalizzate
Per creare un'istanza test-instance nella configurazione dell'istanza regionale di base us-central1, esegui:
gcloud spanner instances create test-instance --edition=STANDARD --config=regional-us-central1 \
--description="Test Instance" --nodes=1
Per creare un'istanza custom-eur6-instance nella configurazione dell'istanza multiregionale personalizzata custom-eur6, devi prima creare una configurazione dell'istanza personalizzata.
Dopodiché, esegui:
gcloud spanner instances create custom-eur6-instance --edition=ENTERPRISE_PLUS --config=custom-eur6 \
--description="Instance with custom read-only" --nodes=1
Dopo aver eseguito uno dei comandi precedenti, dovresti visualizzare un messaggio simile al seguente esempio:
Creating instance...done.
C++
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta Librerie client di Spanner.
Per eseguire l'autenticazione in Spanner, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
C#
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta Librerie client di Spanner.
Per eseguire l'autenticazione in Spanner, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Crea un'istanza senza una pianificazione dei backup predefinita
Go
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta Librerie client di Spanner.
Per eseguire l'autenticazione in Spanner, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Crea un'istanza con la scalabilità automatica gestita utilizzando Go
Crea un'istanza con scalabilità automatica asimmetrica di sola lettura utilizzando Go
Crea un'istanza senza una pianificazione dei backup predefinita
Java
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta Librerie client di Spanner.
Per eseguire l'autenticazione in Spanner, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.