In questa pagina viene descritto come elencare, creare, aggiornare, eliminare e mostrare i dettagli una configurazione dell'istanza di Spanner. Alcune funzionalità di configurazione delle istanze personalizzate non sono disponibili in UI della console Google Cloud. In questi casi, utilizza i comandi Google Cloud CLI (gcloud) fornito.
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.
Vai
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 librerie client. Quando
creare 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:
richiedi una nuova regione facoltativa replica di sola lettura.
Per ulteriori informazioni, vedi Crea una configurazione dell'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 configurazioni personalizzate) punta alla base configurazione dell'istanza. Consulta le configurazioni regionali disponibili e configurazioni multiregionali disponibili per elenchi di configurazioni di istanze di base utilizzabili per creare configurazione dell'istanza personalizzata.configType
indica se la configurazione dell'istanza è un configurazione dell'istanza di base o una configurazione dell'istanza personalizzata.etag
(solo per configurazioni personalizzate) è una stringa con codifica Base64 rappresentazione della configurazione. Viene usato per la contemporaneità ottimistica controllo.
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.
Vai
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 di istanza regionale o multiregionale personalizzata e aggiungere repliche di sola lettura facoltative da scalare e supportano letture inattive a bassa latenza. Consulta configurazioni regionali disponibili e configurazioni multiregionali disponibili per elenchi di configurazioni di istanze di base utilizzabili per creare configurazione dell'istanza. Non puoi creare un modello configurazione di un'istanza a due regioni. Per saperne di più su Spanner e i tipi di replica, consulta Replica.
Per creare una configurazione di istanza personalizzata, devi disporre
Autorizzazione spanner.instanceConfigs.create
. Per impostazione predefinita, i ruoli
L'autorizzazione spanner.instances.create
avrà anche
Autorizzazione spanner.instanceConfigs.create
.
Console
Non puoi creare una configurazione autonoma di un'istanza personalizzata utilizzando nella console Google Cloud. Per creare un'istanza con repliche di sola lettura, consulta alle istruzioni fornite in Crea un'istanza con la configurazione dell'istanza personalizzata.
Puoi utilizzare Google Cloud CLI e il client librerie 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 pratico per clonarne un altro
configurazione di base o personalizzata dell'istanza, dichiarando anche la posizione
di una specifica replica personalizzata.
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
- A
identificatore permanente univoco all'interno del tuo progetto Google Cloud. Tu
non potrai modificare l'ID configurazione dell'istanza in un secondo momento.
custom-
per evitare conflitti di nomi con l'istanza di base configurazioni. DISPLAY-NAME
- Il il nome da visualizzare per la configurazione dell'istanza personalizzata nella console Google Cloud. Se scegli di usare i flag "--base-config" e "--replicas", fornisci il i seguenti valori:
BASE-CONFIG
- Il nome della regione della configurazione dell'istanza di base su cui
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 sapere quali nomi di località sono accettati, eseguigcloud spanner instance-configs describe INSTANCE-CONFIG
e consulta ireplicas
e ioptionalReplicas
elenchi. TYPE
- Il tipo di replica. Per scoprire quali sedi e località corrispondenti
i tipi di replica accettati, esegui
gcloud spanner instance-configs describe INSTANCE-CONFIG
e fai riferimento Elenchireplicas
eoptionalReplicas
. I tipi sono:- 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
deve essere specificato durante la creazione di una configurazione di istanza personalizzata incluse quelle predefinite nella configurazione di base. Per ulteriori informazioni informazioni, consulta gcloud instance-configs describe help-text.
Se scegli di utilizzare i flag --clone-config
e --add-replicas
(solo
utilizza --skip-replicas
se esistono repliche che vuoi evitare
clonati), fornisci i seguenti valori:
--clone-config=INSTANCE-CONFIG
Usa questo flag come metodo conveniente per clonare un'altra base o un'altra configurazione dell'istanza, dichiarando anche la posizione e il tipo una replica personalizzata specifica. Quindi utilizza
--add-replicas=location=LOCATION,type=TYPE
e specificare dove vuoi aggiungere la replica facoltativa.Ad esempio, per creare una configurazione di istanza personalizzata repliche di sola lettura in
us-east1
durante la copia di tutte le altre repliche località 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 replica di sola lettura in
us-east4
durante la copia di tutte le altre repliche località dalla configurazione dell'istanza di basenam3
, ad eccezione di 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 le 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 confermare che la richiesta avrà esito positivo prima dell'esecuzione li annotino.
Ad esempio, per creare una configurazione dell'istanza personalizzata con eur6
di base
configurazione 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
--clone-config
flag:
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.
Vai
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 dell'istanza personalizzata, segui le istruzioni fornite in Creare un'istanza.
Tieni presente che non è necessario creare un'istanza personalizzata autonoma configurazione nella console Google Cloud. La configurazione dell'istanza è 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.
Vai
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
di repliche, quindi sposta l'istanza nel nuovo
configurazione dell'istanza personalizzata con le repliche aggiuntive che hai scelto. Ad esempio:
se la tua istanza si trova in us-central1
e vuoi aggiungere una replica di sola lettura
us-west1
, devi creare una nuova configurazione dell'istanza personalizzata
us-central1
come configurazione di base e aggiungi us-west1
come configurazione di sola lettura
replica. Quindi sposta la tua istanza
la 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 nell' 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
:ETAG
può essere utilizzato per selezionare e saltare gli aggiornamenti simultanei in un nello scenario lettura, modifica e scrittura.--validate-only
: utilizza questo flag per confermare l'esito della richiesta prima di eseguirlo.
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.
Vai
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 la configurazione di un'istanza personalizzata, devi prima eliminare qualsiasi istanza nella configurazione dell'istanza.
gcloud
Usa il comando gcloud spanner instance-configs delete
, sostituendo
CUSTOM-INSTANCE-CONFIG-ID
con l'istanza personalizzata
ID configurazione:
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.
Vai
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 la sua o Microsoft SQL Server.
- Scopri come progettare uno schema Spanner.
- Quote e limiti di Spanner.