Esta página descreve como listar, criar, atualizar, excluir e mostrar os detalhes de uma configuração de instância do Spanner. Algumas funcionalidades de configuração de instâncias personalizadas não estão disponíveis no UI do console do Google Cloud. Nesses casos, use os comandos da Google Cloud CLI (gcloud). fornecidas.
Listar configurações de instância
É possível listar todas as configurações de instâncias do Spanner disponíveis com a Google Cloud CLI e as bibliotecas de cliente. Para encontrar uma lista de todas as configurações de instâncias do Spanner, consulte Configurações regionais e multirregionais.
gcloud
Execute o comando gcloud spanner instance-configs list
:
gcloud spanner instance-configs list
C++
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
C#
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Go
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Java
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Node.js
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
PHP
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Python
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Ruby
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Mostrar detalhes de configuração da instância
É possível mostrar os detalhes de qualquer configuração de instância com o
Google Cloud CLI e bibliotecas de cliente. Quando você
criar uma nova configuração de instância personalizada;
é possível adicionar qualquer local listado em optionalReplicas
como uma réplica opcional.
Se o local desejado da réplica somente leitura não for exibido, você poderá
solicitar uma nova região de réplica somente leitura opcional.
Para mais informações, consulte Crie uma configuração de instância personalizada.
gcloud
Execute o comando gcloud spanner instance-configs describe
:
gcloud spanner instance-configs describe INSTANCE-CONFIG
Forneça o seguinte valor:
INSTANCE-CONFIG
- A configuração da instância, que define a localização geográfica do
da instância e afeta a replicação dos dados. Por exemplo,
eur6
. ouus-central1
.
Para mostrar os detalhes da configuração base eur6
, execute:
gcloud spanner instance-configs describe eur6
Confira um exemplo de saída para a configuração básica 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
Observações adicionais de uso:
baseConfig
(somente para configurações personalizadas) aponta para a base configuração da instância. Consulte as configurações regionais disponíveis. e as configurações multirregionais disponíveis para listas de configurações de instância base que podem ser usadas para criar uma configuração personalizada da instância.configType
indica se a configuração dessa instância é uma configuração de instância de base ou uma configuração de instância personalizada.etag
(apenas para configurações personalizadas) é uma string codificada em base64 representação da configuração. É usado para simultaneidade otimista controle
C++
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
C#
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Go
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Java
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Node.js
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
PHP
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Python
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Ruby
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Criar uma configuração de instância personalizada
É possível criar uma configuração de instância regional ou multirregional personalizada e adicionar réplicas somente leitura opcionais para escalonar e dão suporte a leituras desatualizadas de baixa latência. Consulte configurações regionais disponíveis e as configurações multirregionais disponíveis para listas de configurações de instância de base que podem ser usadas para criar um configuração da instância. Não é possível criar um configuração de instâncias birregionais. Para mais informações sobre o Spanner, replicação e tipos de réplica, consulte Replicação.
Para criar uma configuração de instância personalizada, é preciso ter o
spanner.instanceConfigs.create
. Por padrão, as funções com o
A permissão spanner.instances.create
também terá a
spanner.instanceConfigs.create
.
Console
Não é possível criar uma configuração de instância personalizada independente usando o console do Google Cloud. Para criar uma instância com réplicas somente leitura, consulte às instruções fornecidas na Crie uma instância com a configuração de instância personalizada.
É possível usar a Google Cloud CLI e o cliente para criar uma configuração de instância personalizada independente.
gcloud
Use o 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[:...]
É possível usar a sinalização --clone-config
como uma maneira conveniente de clonar outro
configuração de instância básica ou personalizada, além de declarar o local e
o tipo de uma réplica personalizada específica.
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[:...]
Forneça os valores a seguir:
CUSTOM-INSTANCE-CONFIG-ID
- R
identificador permanente e exclusivo no projeto do Google Cloud. Você
não poderá alterar o ID de configuração da instância posteriormente. O
custom-
prefixo é obrigatório para evitar conflitos de nome com a instância de base personalizadas. DISPLAY-NAME
- O nome a ser exibido para a configuração da instância personalizada no console do Google Cloud. . Se você optar por usar as sinalizações "--base-config" e "--replicas", forneça o seguintes valores:
BASE-CONFIG
- O nome da região da configuração da instância base em que
com base na configuração personalizada
da instância. Por exemplo,
eur6
ouregional-us-central1
. LOCATION
- O nome da região dos recursos de veiculação (réplicas), por exemplo,
us-east1
. Para descobrir quais nomes de locais são aceitos, executegcloud spanner instance-configs describe INSTANCE-CONFIG
e consulte osreplicas
eoptionalReplicas
listas. TYPE
- O tipo da réplica. Para saber quais locais e
são aceitos, execute
gcloud spanner instance-configs describe INSTANCE-CONFIG
e consultereplicas
eoptionalReplicas
. Os tipos são um dos seguintes:- READ_ONLY
- READ_WRITE
- TESTEMUNHO
- Os itens da lista são separados por ":".
- A menos que a sinalização
--[clone-config]
seja usada, todas as réplicasLOCATION
eTYPE
precisam ser especificados ao criar uma configuração de instância personalizada, incluindo as predefinidas na configuração base. Para mais mais informações, consulte a gcloud instance-configs describe help-text.
Se você optar por usar as sinalizações --clone-config
e --add-replicas
(somente
use --skip-replicas
se houver réplicas que você quer deixar de serem
clonado), forneça os seguintes valores:
--clone-config=INSTANCE-CONFIG
Use essa flag como uma maneira conveniente de clonar outra base ou configuração da instância ao mesmo tempo em que declara o local e o tipo réplica personalizada específica. Em seguida, use
--add-replicas=location=LOCATION,type=TYPE
para especificar onde você quer adicionar a réplica opcional.Por exemplo, para criar uma configuração de instância personalizada com duas Réplicas somente leitura em
us-east1
enquanto copia todas as outras réplicas da configuração da instância baseeur6
, execute: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
Use essa flag para ignorar a clonagem de qualquer réplica.
Por exemplo, para criar uma configuração de instância personalizada com uma réplica somente leitura em
us-east4
ao copiar todas as outras réplicas da configuração da instância de basenam3
, exceto o réplica somente leitura emus-central1
, execute: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
As sinalizações e os valores a seguir são opcionais:
--labels=KEY=VALUE,[...]
KEY
eVALUE
: uma lista de pares de chave-valor para adicionar à configuração da instância personalizada.As chaves precisam começar com uma letra minúscula e conter apenas hifens (-). sublinhados (_), caracteres minúsculos e números. Os valores devem conter apenas hifens (-), sublinhados (_), caracteres minúsculos e números.
--validate-only
Use este flag para validar se a solicitação será bem-sucedida antes da execução reimplantá-lo.
Por exemplo, para criar uma configuração de instância personalizada com a base eur6
com uma réplica somente leitura extra em us-east1
, execute:
gcloud spanner instance-configs create custom-eur6 \
--display-name="Custom eur6" --clone-config=eur6 \
--add-replicas=location=us-east1,type=READ_ONLY \
Você também pode criar uma configuração de instância personalizada sem o
Sinalização --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
Você verá esta resposta:
Creating instance-config...done.
C++
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
C#
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Go
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Java
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Node.js
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
PHP
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Python
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Ruby
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Criar uma instância em uma configuração de instância personalizada
É possível criar uma instância em uma configuração de instância personalizada.
Console
Para criar uma instância em uma configuração de instância personalizada, siga as instruções fornecidas em Criar uma instância.
Não é preciso criar uma instância personalizada independente no console do Google Cloud. A configuração da instância é criado automaticamente quando você cria a instância.
gcloud
Depois de criar a configuração da instância personalizada, siga as instruções fornecidas em Criar uma instância.
C++
Depois de criar a configuração da instância personalizada, siga as instruções fornecidas em Criar uma instância.
C#
Depois de criar a configuração da instância personalizada, siga as instruções fornecidas em Criar uma instância.
Go
Depois de criar a configuração da instância personalizada, siga as instruções fornecidas em Criar uma instância.
Java
Depois de criar a configuração da instância personalizada, siga as instruções fornecidas em Criar uma instância.
Node.js
Depois de criar a configuração da instância personalizada, siga as instruções fornecidas em Criar uma instância.
PHP
Depois de criar a configuração da instância personalizada, siga as instruções fornecidas em Criar uma instância.
Python
Depois de criar a configuração da instância personalizada, siga as instruções fornecidas em Criar uma instância.
Ruby
Depois de criar a configuração da instância personalizada, siga as instruções fornecidas em Criar uma instância.
Atualizar uma configuração de instância personalizada
É possível alterar o nome de exibição e os rótulos de uma configuração de instância personalizada.
Não é possível alterar ou atualizar as réplicas da configuração da sua instância personalizada.
No entanto, é possível criar uma nova configuração de instância personalizada com
réplicas e, em seguida, mover a instância para a nova
configuração personalizada da instância
com as réplicas adicionais escolhidas. Por exemplo:
Se a instância estiver em us-central1
e você quiser adicionar uma réplica somente leitura
us-west1
, você precisa criar uma configuração de instância personalizada com
us-central1
como a configuração básica e adicione us-west1
como um arquivo
réplica. Em seguida, mova sua instância para esta
uma nova configuração de instância personalizada.
gcloud
Use o 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
Forneça os valores a seguir:
CUSTOM-INSTANCE-CONFIG-ID
- Um identificador permanente da configuração de instância personalizada.
Ele vai começar com
custom-
. NEW-DISPLAY-NAME
- O novo nome a ser exibido para a configuração da instância no console do Google Cloud.
KEY
eVALUE
- Uma lista de pares de chave-valor a serem atualizados. .
- As chaves precisam começar com uma letra minúscula e conter apenas hifens (-), sublinhados (_), caracteres minúsculos e números. Os valores devem conter apenas hifens (-), sublinhados (_), caracteres minúsculos e números grandes.
As sinalizações e os valores a seguir são opcionais:
--etag=ETAG
: oETAG
pode ser usado para selecionar e ignorar atualizações simultâneas em um no cenário read-modify-write.--validate-only
: use essa sinalização para validar se a solicitação será bem-sucedida. antes da execução.
Exemplo:
gcloud spanner instance-configs update custom-eur6 \
--display-name="Customer managed europe replicas"
C++
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
C#
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Go
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Java
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Node.js
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
PHP
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Python
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Ruby
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Excluir uma configuração de instância personalizada
Para excluir uma configuração de instância personalizada, primeiro exclua qualquer instância na configuração da instância.
gcloud
Use o comando gcloud spanner instance-configs delete
, substituindo
CUSTOM-INSTANCE-CONFIG-ID
pela instância personalizada
ID de configuração:
gcloud spanner instance-configs delete CUSTOM-INSTANCE-CONFIG-ID
C++
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
C#
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Go
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Java
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Node.js
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
PHP
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Python
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
Ruby
Para aprender a instalar e usar a biblioteca de cliente do Spanner, consulte Bibliotecas de cliente do Spanner.
A seguir
- Aprenda a inserir, atualizar e excluir dados com a linguagem de manipulação de dados (DML) ou a CLI gcloud.
- Conceda papéis do IAM para a instância e a respectiva bancos de dados.
- Entenda como projetar um esquema do Spanner.
- Cotas e limites do Spanner.