Questa pagina descrive come creare e gestire le partizioni di istanze Spanner.
Prima di iniziare
Per utilizzare le partizioni dell'istanza, devi impostare l'opzione di database opt_in_dataplacement_preview
nel database vuoto:
Console
Vai alla pagina Istanze nella console Google Cloud .
Seleziona l'istanza in cui vuoi aggiungere le partizioni dell'istanza.
Seleziona il database vuoto in cui vuoi partizionare i dati.
Nel menu di navigazione, fai clic su Spanner Studio.
Nella pagina Spanner Studio, fai clic su
Nuova scheda o utilizza la scheda dell'editor vuota.Inserisci la seguente istruzione DDL
ALTER DATABASE
.GoogleSQL
ALTER DATABASE DATABASE_ID SET OPTIONS (opt_in_dataplacement_preview = true);
Sostituisci DATABASE_ID con l'identificatore univoco del tuo database.
PostgreSQL
ALTER DATABASE DATABASE_ID SET "spanner.opt_in_dataplacement_preview" = TRUE;
Sostituisci DATABASE_ID con l'identificatore univoco del tuo database.
Fai clic su Esegui.
gcloud
Per impostare l'opzione del database opt_in_dataplacement_preview
, utilizza
gcloud spanner databases ddl update
.
GoogleSQL
gcloud spanner databases ddl update DATABASE_ID \
--instance=INSTANCE_ID \
--ddl="ALTER DATABASE DATABASE_ID SET OPTIONS (opt_in_dataplacement_preview = true);"
Sostituisci quanto segue:
DATABASE_ID
: l'identificatore permanente del tuo database Spanner.INSTANCE_ID
: l'identificatore permanente dell'istanza Spanner.
PostgreSQL
gcloud spanner databases ddl update DATABASE_ID \
--instance=INSTANCE_ID \
--ddl="ALTER DATABASE DATABASE_ID SET "spanner.opt_in_dataplacement_preview" = TRUE"
Sostituisci quanto segue:
DATABASE_ID
: l'identificatore permanente del tuo database Spanner.INSTANCE_ID
: l'identificatore permanente dell'istanza Spanner.
Crea una partizione dell'istanza
Console
Nella console Google Cloud , apri la pagina Spanner.
Seleziona l'istanza in cui vuoi aggiungere le partizioni dell'istanza.
Nel menu di navigazione, seleziona Partizioni istanza.
Fai clic su Crea partizione dell'istanza.
Inserisci un ID partizione per identificare in modo permanente la partizione della tua istanza. L'ID partizione dell'istanza deve essere univoco anche all'interno del tuo Google Cloud progetto. Non puoi modificare l'ID partizione dell'istanza in un secondo momento.
Nella sezione Scegli una configurazione, seleziona Regionale o Più regioni. In alternativa, se vuoi confrontare le specifiche tra le regioni, fai clic su Confronta configurazioni per regioni.
Seleziona una configurazione dal menu a discesa.
Nella sezione Alloca capacità di calcolo, in Unità, fai clic su una delle seguenti opzioni:
- Unità di elaborazione per le partizioni di istanze di piccole dimensioni.
- Nodi per istanze di grandi dimensioni. Un nodo è pari a 1000 unità di elaborazione.
Inserisci un valore per l'unità selezionata.
La partizione dell'istanza deve avere almeno un nodo o 1000 unità di elaborazione.
Fai clic su Crea per creare la partizione dell'istanza.
gcloud
Per creare una partizione dell'istanza, utilizza
gcloud beta spanner instance-partitions create
.
gcloud beta spanner instance-partitions create INSTANCE_PARTITION_ID \ --config=INSTANCE_PARTITION_CONFIG \ --description="INSTANCE_PARTITION_DESCRIPTION" \ --instance=INSTANCE_ID \ [--nodes=NODE_COUNT | --processing-units=PROCESSING_UNIT_COUNT]
Sostituisci quanto segue:
- INSTANCE_PARTITION_ID: l'identificatore della partizione dell'istanza permanente univoco all'interno del tuo progetto Google Cloud . Non puoi modificare l'ID partizione dell'istanza in un secondo momento.
- INSTANCE_PARTITION_CONFIG: l'identificatore permanente della configurazione della partizione dell'istanza, che definisce la posizione geografica della partizione dell'istanza e influisce sulla posizione di archiviazione dei dati.
- INSTANCE_PARTITION_DESCRIPTION: il nome da visualizzare per la partizione dell'istanza nella console Google Cloud . Il nome della partizione dell'istanza deve essere univoco all'interno del progetto Google Cloud .
- INSTANCE_ID: l'identificatore permanente della tua istanza Spanner in cui risiede questa partizione dell'istanza.
- NODE_COUNT: la capacità di calcolo della partizione dell'istanza, espressa come numero di nodi. Un nodo equivale a 1000 unità di elaborazione.
- PROCESSING_UNIT_COUNT: la capacità di calcolo dell'istanza, espressa come numero di unità di elaborazione. La partizione dell'istanza deve avere almeno 1000 unità di elaborazione. Inserisci le quantità in multipli di 1000 (1000, 2000, 3000 e così via).
Ad esempio, per creare una partizione di istanza europe-partition
in eur3
con 5 nodi, esegui il seguente comando:
gcloud beta spanner instance-partitions create europe-partition --config=eur3 \
--description="europe-partition" --instance=test-instance --nodes=5
Librerie client
C++
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta la sezione Librerie client Spanner.
C#
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta la sezione Librerie client Spanner.
Vai
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta la sezione Librerie client Spanner.
Java
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta la sezione Librerie client Spanner.
Node.js
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta la sezione Librerie client Spanner.
PHP
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta la sezione Librerie client Spanner.
Python
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta la sezione Librerie client Spanner.
Descrivere una partizione dell'istanza
gcloud
Per descrivere una partizione di istanza, utilizza
gcloud beta spanner instance-partitions describe
.
gcloud beta spanner instance-partitions describe PARTITION_ID \ --instance=INSTANCE_ID
Sostituisci quanto segue:
- INSTANCE_PARTITION_ID: l'identificatore permanente della partizione dell'istanza.
- INSTANCE_ID: l'identificatore permanente dell'istanza.
Ad esempio, per descrivere la partizione dell'istanza europe-partition
,
esegui il comando seguente:
gcloud beta spanner instance-partitions describe europe-partition
--instance=test-instance
Elenca partizioni istanza
Console
Nella console Google Cloud , apri la pagina Spanner.
Seleziona un'istanza dall'elenco.
Nel menu di navigazione, seleziona Partizioni istanza.
Viene visualizzato un elenco di partizioni dell'istanza associate a questa istanza.
gcloud
Per elencare le partizioni dell'istanza, utilizza
gcloud beta spanner instance-partitions list
.
gcloud beta spanner instance-partitions list --instance=INSTANCE_ID
Gcloud CLI stampa un elenco delle partizioni dell'istanza Spanner, insieme all'ID, al nome visualizzato, alla configurazione e alla capacità di calcolo di ogni partizione dell'istanza.
Modificare una partizione dell'istanza
La sezione seguente spiega come modificare la capacità di calcolo della partizione dell'istanza. Non puoi modificare l'ID, il nome o la configurazione della partizione dell'istanza.
Modificare la capacità di calcolo
Devi eseguire il provisioning di una capacità di calcolo sufficiente a mantenere l'utilizzo della CPU e l'utilizzo dello spazio di archiviazione al di sotto dei massimi consigliati. Per ulteriori informazioni, consulta quote e limiti per Spanner.
Se vuoi aumentare la capacità di calcolo di una partizione dell'istanza, il tuo Google Cloud progetto deve avere una quota sufficiente per aggiungere la capacità di calcolo. Il tempo necessario per completare la richiesta di aumento dipende dalle dimensioni della richiesta. Nella maggior parte dei casi, le richieste vengono completate in pochi minuti. In rari casi, l'upgrade potrebbe richiedere fino a un'ora.
Console
Nella console Google Cloud , apri la pagina Spanner.
Seleziona un'istanza dall'elenco.
Nel menu di navigazione, seleziona Partizioni istanza.
Nell'elenco delle partizioni dell'istanza, nella colonna Azioni, fai clic su Altre azioni e seleziona Modifica.
Modifica la capacità di calcolo scegliendo un'unità di misura (unità di elaborazione o nodi) e poi inserendo una quantità. Quando utilizzi le unità di elaborazione, inserisci quantità in multipli di 1000 (1000, 2000, 3000 e così via). Ogni nodo equivale a 1000 unità di elaborazione.
La partizione dell'istanza deve avere almeno un nodo (1000 unità di elaborazione).
Fai clic su Salva.
Se viene visualizzata una finestra di dialogo che indica che la quota è insufficiente per aggiungere capacità di calcolo , segui le istruzioni per richiedere una quota più alta.
gcloud
Per modificare la capacità di calcolo della partizione dell'istanza, utilizza
gcloud beta spanner instance-partitions update
.
Quando utilizzi questo comando, specifica la capacità di calcolo come numero di nodi o unità di elaborazione.
gcloud beta spanner instance-partitions update INSTANCE_PARTITION_ID \ --instance=INSTANCE_ID \ [--nodes=NODE_COUNT | --processing-units=PROCESSING_UNIT_COUNT] [--async]
Sostituisci quanto segue:
- INSTANCE_PARTITION_ID: l'identificatore permanente della partizione dell'istanza.
- INSTANCE_ID: l'identificatore permanente dell'istanza.
- NODE_COUNT: la nuova capacità di calcolo della partizione dell'istanza, espressa come numero di nodi. Un nodo equivale a 1000 unità di elaborazione.
- PROCESSING_UNIT_COUNT: la nuova capacità di calcolo della partizione dell'istanza, espressa come numero di unità di elaborazione. La partizione dell'istanza deve avere almeno 1000 unità di elaborazione. Inserisci le quantità in multipli di 1000 (1000, 2000, 3000 e così via).
Flag facoltativi:
--async
: utilizza questo flag se vuoi che la richiesta venga restituita immediatamente, senza attendere il completamento dell'operazione in corso.
Puoi controllare lo stato della tua richiesta eseguendo
gcloud spanner operations describe
.
Elimina una partizione dell'istanza
Non puoi eliminare una partizione dell'istanza mentre è associata a posizionamenti o dati. Prima di poter eliminare la partizione dell'istanza, devi prima spostare tutti i dati che si trovano nella partizione dell'istanza o eliminare le tabelle di posizionamento che utilizzano la partizione dell'istanza.
Console
Nella console Google Cloud , apri la pagina Spanner.
Seleziona un'istanza dall'elenco.
Nel menu di navigazione, seleziona Partizioni istanza.
Nell'elenco delle partizioni dell'istanza, nella colonna Azioni, fai clic su Altre azioni e seleziona Elimina.
Segui le istruzioni per confermare che vuoi eliminare la partizione Instance.
Fai clic su Elimina.
gcloud
Utilizza il comando gcloud beta spanner instance-partitions delete
.
gcloud beta spanner instance-partitions delete INSTANCE_PARTITION_ID --instance=INSTANCE_ID