Questa pagina descrive come creare, elencare, modificare ed eliminare Spanner istantanee.
Crea un'istanza
Puoi creare un'istanza con la console Google Cloud, Google Cloud CLI o librerie client. Puoi anche creare con un'istanza configurazione di istanze personalizzate aggiungendo repliche di sola lettura facoltative.
Console
Vai alla pagina Crea istanza nella console Google Cloud.
Inserisci un Nome istanza da visualizzare nella console Google Cloud. La il nome dell'istanza deve essere univoco all'interno del progetto Google Cloud.
Inserisci un ID istanza per identificare definitivamente l'istanza. La Inoltre, l'ID istanza deve essere univoco all'interno del progetto Google Cloud. Non puoi modificare l'ID istanza in un secondo momento.
Fai clic su Continua.
Nella sezione Configura la tua istanza, in Scegli una configurazione, seleziona A livello di regione, Doppia regione o Più regioni. In alternativa, se vuoi confrontare specifiche tra le tre configurazioni, quindi fai clic su Confronta le configurazioni per le regioni.
Seleziona una configurazione dal menu a discesa.
(Facoltativo) Per aggiungere una replica di sola lettura a una base Spanner configurazione di istanza personalizzata, crea innanzitutto una configurazione di istanza personalizzata Google Cloud CLI.
Fai clic su Continua.
Nella sezione Alloca capacità di calcolo, in Seleziona unità, fai clic su una delle seguenti opzioni:
- Unità di elaborazione per istanze di piccole dimensioni.
- Nodi per istanze di grandi dimensioni. Un nodo equivale a 1000 unità di elaborazione.
Per ulteriori informazioni, consulta Capacità, nodi e unità di elaborazione di calcolo.
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 (anteprima), per consentire a Spanner di aggiungere e rimuovere automaticamente e la capacità di archiviazione. Per saperne di più sul gestore della scalabilità automatica gestito, vedi Gestore della scalabilità automatica per Spanner. Configura le seguenti opzioni del gestore della scalabilità automatica gestite:
- Minimo indica il limite minimo a cui applicare lo scale down, a seconda dell'unità di misura che scegli per Compute di archiviazione. Per ulteriori informazioni, vedi Determina il limite minimo.
- Massimo indica il limite massimo per lo scale up, a seconda dell'unità di misura che scegli per Compute di archiviazione. Per ulteriori informazioni, vedi Determina il limite massimo.
- Target di utilizzo ad alta priorità della CPU indica il target percentuale di CPU ad alta priorità da utilizzare. Per ulteriori informazioni, consulta Determinare il target di utilizzo della CPU.
- Target di utilizzo dello spazio di archiviazione indica la percentuale target di spazio di archiviazione. Per ulteriori informazioni, vedi Determina il target di utilizzo dello spazio di archiviazione.
Fai clic sul pulsante Crea per creare l'istanza.
gcloud
Utilizza la gcloud spanner instances create
per creare un'istanza. Specifica la capacità di calcolo
come il numero di nodi o unità di elaborazione che vuoi nell'istanza.
gcloud spanner instances create INSTANCE-ID \ --config=INSTANCE-CONFIG \ --description=INSTANCE-DESCRIPTION \ --nodes=NODE-COUNT
o
gcloud spanner instances create INSTANCE-ID \ --config=INSTANCE-CONFIG \ --description=INSTANCE-DESCRIPTION \ --processing-units=PROCESSING-UNIT-COUNT
Sostituisci quanto segue:
- INSTANCE-ID: un identificatore permanente univoco all'interno del tuo progetto Google Cloud. Non puoi modificare l'ID istanza in un secondo momento.
- INSTANCE-CONFIG: un identificatore permanente della tua istanza
personalizzata, che definisce la posizione geografica dell'istanza
influisce sul modo in cui i dati vengono replicati. Per le configurazioni di istanze personalizzate,
inizia con
custom-
. Per ulteriori informazioni, consulta instance configurazioni. - INSTANCE-DESCRIPTION: il nome da visualizzare per l'istanza nella sezione nella console Google Cloud. Il nome dell'istanza deve essere univoco all'interno progetto Google Cloud.
NODE-COUNT: la capacità di calcolo dell'istanza, espressa come un numero di nodi. Ogni nodo equivale a 1000 unità di elaborazione.
PROCESSING-UNIT-COUNT: capacità di calcolo dell'istanza, espresso in un numero di unità di elaborazione. Inserisci quantità fino a 1000 in multipli di 100 (100, 200, 300 e così via) e inserisci maggiore quantità in multipli di 1000 (1000, 2000, 3000 e così via). Nota: Non utilizzare questo parametro se stai creando un'istanza a cui intendi creare da abilitare in un secondo momento con il gestore della scalabilità automatica gestito.
Aggiungi scalabilità automatica gestita (anteprima)
Puoi anche configurare nuove istanze per utilizzare la scalabilità automatica gestita con
gcloud beta spanner instances create
. Per ulteriori informazioni, vedi
Gestore della scalabilità automatica per Spanner.
Utilizza il comando seguente per creare un'istanza con il gestore della scalabilità automatica gestito.
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
o
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
Sostituisci quanto segue:
- INSTANCE-ID: un identificatore permanente univoco all'interno del tuo progetto Google Cloud. Non puoi modificare l'ID istanza in un secondo momento.
- INSTANCE-CONFIG: un identificatore permanente della tua istanza
personalizzata, che definisce la posizione geografica dell'istanza
influisce sul modo in cui i dati vengono replicati. Per le configurazioni di istanze personalizzate,
inizia con
custom-
. Per ulteriori informazioni, consulta instance configurazioni. - INSTANCE-DESCRIPTION: il nome da visualizzare per l'istanza nella sezione nella console Google Cloud. Il nome dell'istanza deve essere univoco all'interno progetto Google Cloud.
- MINIMUM_PROCESSING_UNITS, MINIMUM_NODES: il valore numero minimo di unità di elaborazione o nodi durante lo scale down. Per ulteriori informazioni informazioni, consulta Determinazione del limite minimo.
- MAXIMUM_PROCESSING_UNITS, MAXIMUM_NODES: il valore numero massimo di unità di elaborazione o nodi durante lo scale up. Per ulteriori informazioni le informazioni, vedi Determina il limite massimo.
- CPU_PERCENTAGE: la percentuale target di CPU ad alta priorità a percentuale di utilizzo, dal 10 al 90%. Se ottimizzi per i costi, utilizza una query percentuale. Per ulteriori informazioni, vedi Determina il target di utilizzo della CPU.
- STORAGE_PERCENTAGE: la percentuale target di spazio di archiviazione da utilizzare, dal 10 al 99%. Per ulteriori informazioni, vedi Determina il target di utilizzo dello spazio di archiviazione.
Esempi di utilizzo delle configurazioni personalizzate
Per creare un'istanza test-instance
nell'istanza regionale di base
configurazione us-central1
, esegui:
gcloud spanner instances create test-instance --config=regional-us-central1 \
--description="Test Instance" --nodes=1
Per creare un'istanza custom-eur6-instance
in più regioni personalizzate
configurazione dell'istanza custom-eur6
, prima
crea una configurazione di istanza personalizzata.
Dopodiché, esegui:
gcloud spanner instances create custom-eur6-instance --config=custom-eur6 \
--description="Instance with custom read-only" --nodes=1
Dopo l'esecuzione, dovresti visualizzare un messaggio simile all'esempio seguente uno dei comandi precedenti:
Creating instance...done.
C++
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta Librerie client di Spanner.
Per eseguire l'autenticazione su Spanner, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi 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 su Spanner, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Vai
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta Librerie client di Spanner.
Per eseguire l'autenticazione su Spanner, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Crea un'istanza con scalabilità automatica gestita utilizzando Go (anteprima)
Java
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta Librerie client di Spanner.
Per eseguire l'autenticazione su Spanner, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Crea un'istanza con scalabilità automatica gestita utilizzando Java (anteprima)
Node.js
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta Librerie client di Spanner.
Per eseguire l'autenticazione su Spanner, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
PHP
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta Librerie client di Spanner.
Per eseguire l'autenticazione su Spanner, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta Librerie client di Spanner.
Per eseguire l'autenticazione su Spanner, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta Librerie client di Spanner.
Per eseguire l'autenticazione su Spanner, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Elenca istanze
Puoi visualizzare un elenco delle tue istanze Spanner.
Console
Vai alla pagina Istanze Spanner nella console Google Cloud.
La console Google Cloud mostra un elenco dei tuoi Spanner istanze, insieme all'ID, al nome visualizzato, alla configurazione e capacità di calcolo espressa sia in unità di elaborazione che in nodi.
gcloud
Utilizza la gcloud spanner instances list
:
gcloud spanner instances list
gcloud CLI stampa un elenco dei tuoi Spanner istanze, insieme all'ID, al nome visualizzato, alla configurazione e di calcolo della capacità di calcolo.
Modifica un'istanza
Le sezioni seguenti spiegano come modificare il nome visualizzato di un'istanza di calcolo della capacità di calcolo. Non puoi modificare l'ID istanza o la configurazione dell'istanza.
Modificare il nome visualizzato
Console
Vai alla pagina Istanze Spanner nella console Google Cloud.
Fai clic sul nome dell'istanza da rinominare.
Fai clic su Modifica istanza.
Inserisci un nuovo nome istanza. Questo nome deve essere univoco all'interno progetto Google Cloud.
Fai clic su Salva.
gcloud
Utilizza la gcloud spanner instances update
:
gcloud spanner instances update INSTANCE_ID --description=INSTANCE_NAME
Sostituisci quanto segue:
- INSTANCE_ID: l'identificatore permanente dell'istanza.
- INSTANCE_NAME: il nome da visualizzare per l'istanza nella sezione nella console Google Cloud. Il nome dell'istanza deve essere univoco all'interno progetto Google Cloud.
Modificare la capacità di calcolo
Devi eseguire il provisioning di una capacità di calcolo sufficiente per mantenere Utilizzo CPU e l'utilizzo dello spazio di archiviazione è inferiore ai valori massimi consigliati. Per ulteriori informazioni, consulta Quote e limiti per Spanner.
In alcuni casi non è possibile ridurre la capacità di calcolo di un istanza esistente:
- Per rimuovere la capacità di calcolo, l'istanza dovrebbe archiviare più di 4 TB di dati per 1000 unità di elaborazione (1 nodo).
- In base ai tuoi pattern di utilizzo storici, Spanner ha creato un numero elevato di sezioni per dell'istanza e, in alcuni rari casi, Spanner non sarebbe per gestire le suddivisioni dopo aver rimosso la capacità di calcolo.
Nel secondo caso, potresti provare a ridurre progressivamente la capacità di calcolo di piccole dimensioni finché non trovi la capacità minima richiesta da Spanner deve gestire tutte le suddivisioni dell'istanza. Se l'istanza non richiede più per un numero così elevato di suddivisioni dovute a una modifica dei pattern di utilizzo, alla fine unisce alcune suddivisioni e consente di provare a ridurre la capacità di calcolo dell'istanza dopo una o due settimane.
Quando rimuovi capacità di calcolo, monitora l'utilizzo della CPU e le richieste in Cloud Monitoring per garantire che la CPU l'utilizzo rimane al di sotto del 65% per le regioni e il 45% per ogni regione di istanze multiregionali. Potresti notare un aumento temporaneo delle richieste e la latenza minima, rimuovendo la capacità di calcolo.
Se vuoi aumentare la capacità di calcolo di un'istanza, Il progetto Google Cloud deve avere una quota sufficiente per aggiungere risorse di computing e la capacità di archiviazione. Il tempo necessario per il completamento della richiesta di aumento dipende dal le dimensioni della richiesta. Nella maggior parte dei casi, le richieste vengono completate entro pochi minuti. Attivato In rare occasioni, il completamento di uno scale up potrebbe richiedere fino a un'ora.
Console
Vai alla pagina Istanze Spanner nella console Google Cloud.
Fai clic sul nome dell'istanza da modificare.
Fai clic su Modifica istanza.
Modifica la capacità di calcolo scegliendo le unità di misura (unità di elaborazione o nodi) e poi inserire una quantità. Quando si utilizza le unità di elaborazione, inserisci quantità fino a 1000 in multipli di 100 (100 200, 300 e così via) e inserisci quantità maggiori in multipli di 1000 (1000, 2000, 3000 e così via). Ogni nodo equivale a 1000 unità di elaborazione.
Fai clic su Salva.
Se viene visualizzata una finestra di dialogo che indica che la quota non è sufficiente per aggiungere risorse di calcolo di capacità elevata in questa località, segui le istruzioni per richiedere quota.
gcloud
Utilizza la gcloud spanner instances update
. Quando utilizzi questo comando, specifica la capacità di calcolo come
di nodi o unità di elaborazione.
gcloud spanner instances update INSTANCE_ID --nodes=NODE_COUNT [--async]
o
gcloud spanner instances update INSTANCE_ID --processing-units=PROCESSING_UNIT_COUNT [--async]
Sostituisci quanto segue:
- INSTANCE_ID: l'identificatore permanente dell'istanza.
- NODE_COUNT: la capacità di calcolo dell'istanza, espressa come di nodi. Ogni nodo equivale a 1000 unità di elaborazione.
- PROCESSING_UNIT_COUNT: capacità di calcolo dell'istanza, espresso in un numero di unità di elaborazione. Inserisci quantità fino a 1000 in multipli di 100 (100, 200, 300 e così via) e inserisci maggiore quantità in multipli di 1000 (1000, 2000, 3000 e così via).
Flag facoltativi:
--async
: utilizza questo flag se vuoi che la tua richiesta venga restituita immediatamente, senza attendere il completamento dell'operazione in corso. Puoi controllare lo stato della tua richiesta eseguendogcloud spanner operations describe
Abilita o modifica il gestore della scalabilità automatica gestito su un'istanza
Quando aggiungi o modifichi la scalabilità automatica gestita, si applicano le seguenti limitazioni su un'istanza esistente:
- Non puoi abilitare il gestore della scalabilità automatica gestito su un'istanza che stai spostando.
Non puoi spostare un'istanza mentre il gestore della scalabilità automatica gestito è in un bucket in cui è abilitato il controllo delle versioni.
Console
Vai alla pagina Istanze Spanner nella console Google Cloud.
Fai clic sul nome dell'istanza per cui vuoi abilitare l'opzione gestore della scalabilità automatica.
Fai clic su Modifica istanza.
In Configura capacità di calcolo, fai clic su Scalabilità automatica.
Per Minimo, seleziona il limite minimo da utilizzare durante lo scale down. Per ulteriori informazioni, vedi Determina il limite minimo.
Per Massimo, seleziona il limite massimo da utilizzare durante lo scale up. Per Per ulteriori informazioni, consulta Determinazione del limite massimo.
Per Target di utilizzo ad alta priorità della CPU, seleziona la percentuale di CPU ad alta priorità. Per ulteriori informazioni, vedi Determina il target di utilizzo della CPU.
Per Target di utilizzo dello spazio di archiviazione, seleziona la percentuale di spazio di archiviazione da per gli utilizzi odierni. Per ulteriori informazioni, vedi Determina il target di utilizzo dello spazio di archiviazione.
Fai clic su Salva.
gcloud
Utilizza la
gcloud beta spanner instances update
per aggiungere il gestore
della scalabilità automatica gestito a un'istanza. Per ulteriori informazioni e
Vedi i flag e le limitazioni di Google Cloud CLI
.
Puoi aggiungere il gestore della scalabilità automatica gestito con il seguente comando:
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
o
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
Sostituisci quanto segue:
- INSTANCE_ID: l'identificatore permanente dell'istanza.
- MINIMUM_PROCESSING_UNITS, MINIMUM_NODES: il valore numero minimo di unità di elaborazione o nodi da utilizzare durante lo scale down. Per ulteriori informazioni, vedi Determina il limite minimo.
- MAXIMUM_PROCESSING_UNITS, MAXIMUM_NODES: il valore numero massimo di unità di elaborazione o nodi da utilizzare durante lo scale up. Per ulteriori informazioni, vedi Determina il limite massimo.
- CPU_PERCENTAGE: la percentuale target di CPU ad alta priorità a percentuale di utilizzo, dal 10% al 90%. Se ottimizzi per i costi e non hai bisogno di un latenza per tutte le richieste, quindi utilizza una percentuale più alta. Per ulteriori informazioni le informazioni, vedi Determina il target di utilizzo della CPU.
- STORAGE_PERCENTAGE: la percentuale target di spazio di archiviazione da utilizzare, dal 10% al 99%. Per ulteriori informazioni, vedi Determina il target di utilizzo dello spazio di archiviazione.
Dopo aver aggiunto il gestore della scalabilità automatica gestito a un'istanza, puoi anche modificare il e gestire la scalabilità automatica. Ad esempio, se vuoi aumentare il limite massimo di unità di elaborazione a 10.000, esegui questo comando:
gcloud beta spanner instances update test-instance \
--autoscaling-max-processing-units=10000
Cambia un'istanza dall'utilizzo della scalabilità automatica gestito alla scalabilità manuale
Console
Vai alla pagina Istanze Spanner nella console Google Cloud.
Fai clic sul nome dell'istanza che vuoi disabilitare gestore della scalabilità automatica.
In Scegli una modalità di scalabilità, fai clic su Allocazione manuale.
Fai clic su Salva.
gcloud
Utilizza la gcloud beta spanner instances update
per aggiornare l'istanza.
Utilizza il comando seguente per cambiare un'istanza dall'utilizzo della classe dalla scalabilità automatica alla scalabilità manuale:
gcloud beta spanner instances update INSTANCE_ID \ --processing-units=PROCESSING_UNIT_COUNT
o
gcloud beta spanner instances update INSTANCE_ID \ --nodes=NODE_COUNT
Sostituisci quanto segue:
- INSTANCE_ID: l'identificatore permanente dell'istanza.
- NODE_COUNT: la capacità di calcolo dell'istanza, espressa come un numero di nodi. Ogni nodo equivale a 1000 unità di elaborazione.
- PROCESSING_UNIT_COUNT: capacità di calcolo dell'istanza, espresso in un numero di unità di elaborazione. Inserisci quantità fino a 1000 in multipli di 100 (100, 200, 300 e così via) e inserisci maggiore quantità in multipli di 1000 (1000, 2000, 3000 e così via).
Etichetta un'istanza
Le etichette consentono di organizzare le risorse.
Console
Vai alla pagina Istanze Spanner nella console Google Cloud.
Seleziona la casella di controllo per l'istanza. Il riquadro delle informazioni viene visualizzato nella sul lato destro della pagina.
Fai clic sulla scheda Etichette nel riquadro Informazioni. Puoi quindi aggiungere ed eliminare o aggiornare le etichette per l'istanza Spanner.
Sposta un'istanza
Per istruzioni su come spostare l'istanza da qualsiasi configurazione di istanza qualsiasi altra configurazione di istanza, tra cui una o più regioni configurazioni, consulta Spostare un'istanza.
Elimina un'istanza
Puoi eliminare un'istanza con la console Google Cloud oppure Google Cloud CLI.
Se vuoi eliminare un'istanza che ha uno o più database con la protezione da cancellazione dei dati, è necessario disabilita la protezione da eliminazione su tutti i database dell'istanza prima di poterla eliminare.
Console
Vai alla pagina Istanze Spanner nella console Google Cloud.
Fai clic sul nome dell'istanza che vuoi eliminare.
Fai clic su Elimina istanza.
Segui le istruzioni per confermare che vuoi eliminare l'istanza.
Fai clic su Elimina.
gcloud
Utilizza la gcloud spanner instances delete
, sostituendo INSTANCE-ID con l'ID istanza:
gcloud spanner instances delete INSTANCE-ID
Arresta o riavvia un'istanza
Spanner è un servizio di database completamente gestito che supervisiona le sue alle tue attività e risorse sottostanti, tra cui il monitoraggio e il riavvio quando è necessario, senza tempi di inattività. Poiché non è necessario eseguire manualmente o riavviare una determinata istanza, Spanner non offre un modo farlo.
Passaggi successivi
- Scopri come inserire, aggiornare ed eliminare i dati con Data Manipulation Language (DML) o gcloud CLI.
- Concedi i ruoli Identity and Access Management all'istanza e ai relativi database.
- Scopri come progettare uno schema Spanner.