Criar uma instância
Uma instância do Bigtable é um contêiner do Bigtable clusters. Uma instância que tem mais de um cluster usa replicação. É possível criar clusters em até oito regiões, com o mesmo número de clusters em cada região.
Nesta página, você verá como criar uma instância. Antes de ler esta página, familiarize-se com a visão geral do Bigtable. Leia também a visão geral de instâncias, clusters e nós.
Antes de começar
Preparar o ambiente:
-
Sign in to your Google Account.
If you don't already have one, sign up for a new account.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Verifique se a cobrança está ativada para o seu projeto do Google Cloud.
-
Enable the Cloud Bigtable API, Cloud Bigtable Admin API APIs.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Verifique se a cobrança está ativada para o seu projeto do Google Cloud.
-
Enable the Cloud Bigtable API, Cloud Bigtable Admin API APIs.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
- Execute o comando a seguir para instalar o
CLI
cbt
:gcloud components install cbt
Planejar a configuração:
Opicional: se você planeja ativar a replicação, faça o seguinte:
- Reserve alguns minutos para ler a visão geral da replicação.
- Identifique seu caso de uso para replicação.
- Determine a região ou as regiões em que sua instância deve estar, com base no caso de uso e no local do aplicativo e do tráfego.
- Decida como você usará os perfis de app para encaminhar solicitações de entrada.
Opcional: se você quiser usar chaves de criptografia gerenciadas pelo cliente (CMEK, na sigla em inglês) em vez da criptografia padrão gerenciada pelo Google, conclua as tarefas em Como criar uma instância habilitada para CMEK e tenha o ID de chave CMEK em mãos antes de criar a nova instância. Não é possível adicionar a proteção CMEK a uma instância depois que ela foi criada. Também não é possível modificar ou substituir a chave CMEK após a criação da instância.
Criar uma instância
Para criar uma instância do Bigtable:
Console
No Console do Google Cloud, acesse a página Criar instância.
Digite um nome para a instância.
O Console do Google Cloud exibe esse nome para identificar a instância.
Digite o ID de uma instância.
O código da instância é um identificador permanente da instância.
Clique em Continuar.
Escolha se é necessário usar um disco SSD ou HDD nos clusters. Na maioria dos casos, o SSD é o melhor. Essa opção é permanente. Saiba mais.
Clique em Continuar.
Digite o código do primeiro cluster.
O código é um identificador permanente do cluster.
Escolha a região e a zona em que o primeiro cluster será executado.
Escolha um modo de escalonamento de nó para o cluster. Na maioria dos casos, escolha o escalonamento automático. Para orientações sobre escalonamento, consulte Escalonamento automático.
- Em Alocação manual de nós, insira o número de nós do Bigtable para o primeiro cluster. Caso não tenha certeza de quantos nós são necessários, use o padrão. Será possível adicionar mais nodes depois.
- Em Escalonamento automático, insira os valores a seguir:
- Número mínimo de nós
- Número máximo de nós
- Meta de utilização da CPU
- Meta de uso do armazenamento
(Opcional) Para proteger a instância com CMEK em vez da criptografia padrão gerenciada pelo Google, conclua o seguinte:
- Clique em Mostrar opções de criptografia.
- Selecione o botão de opção ao lado de Chave de criptografia gerenciada pelo cliente (CMEK, na sigla em inglês).
- Selecione ou insira o nome do recurso para a chave de CMEK que você quer usar para o cluster. Não é possível adicionar essa informação posteriormente.
- Se for solicitado que você conceda permissão à conta de serviço da chave CMEK, clique em Conceder. Sua conta de usuário precisa receber o papel de Administrador do Cloud KMS para concluir essa tarefa.
- Clique em Save.
(Opcional) Para ativar a replicação agora, conclua as etapas a seguir:
- Clique em Exibir opções avançadas.
- Clique em Adicionar cluster, insira as configurações do cluster e clique em Adicionar. Repita essa etapa para criar outros clusters na instância. Também é possível ativar a replicação posteriormente adicionando um cluster.
Cada zona em uma região pode conter apenas um cluster. Caso o botão Adicionar cluster esteja desativado, altere a zona do primeiro cluster.
Para criar uma instância com mais de seis clusters, primeiro crie uma instância com seis clusters. Depois, adicione mais clusters.
Clique em Criar para criar a instância.
Revise as configurações de replicação no perfil de aplicativo padrão para ver se elas se aplicam ao caso de uso de replicação. Talvez seja necessário atualizar o perfil de aplicativo padrão ou criar perfis de aplicativo personalizados.
gcloud
Use o comando
bigtable instances create
para criar uma instância:gcloud bigtable instances create INSTANCE_ID \ --display-name=DISPLAY_NAME \ [--cluster-storage-type=CLUSTER_STORAGE_TYPE] \ [--cluster-config=id=CLUSTER_ID,zone=CLUSTER_ZONE, \ nodes=NODES] \ [--cluster-config=id=CLUSTER_ID,zone=CLUSTER_ZONE, \ autoscaling-min-nodes=AUTOSCALING_MIN_NODES, \ autoscaling-max-nodes=AUTOSCALING_MAX_NODES, \ autoscaling-cpu-target=AUTOSCALING_CPU_TARGET, \ autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET, \ kms-key=KMS_KEY]
Substitua:
INSTANCE_ID
: identificador permanente da instânciaDISPLAY_NAME
: um nome legível que identifica a instância no console do Google Cloud.CLUSTER_ID
: identificador permanente do cluster.CLUSTER_ZONE
: A zona em que o cluster é executado.
É necessário configurar pelo menos um cluster para a instância usando a sinalização
--cluster-config
. Para criar uma instância que tenha vários clusters, repita a sinalização--cluster-config
para cada um deles.Para alocação manual de nós, é opcional configurar
nodes
na sinalização--cluster-config
. Se nenhum valor for definido, o Bigtable vai alocar nós para o cluster automaticamente com base no volume de dados e otimizar para 50% da utilização do armazenamento. Essa alocação automática de nós afeta o preço. Se você quiser controlar o número de nós em um cluster, substituaNODES
pelo número de nós que que você quer no cluster. Saiba mais sobre nós.Na maioria dos casos, escolha o escalonamento automático em vez da alocação manual de nós. Para _autoscaling, forneça as opções
autoscaling-
na flag--cluster-config
(autoscaling-storage-target
é opcional) e não usenodes
. Veja escalonamento automático para orientações sobre como escolher os valores das suas configurações de escalonamento automático. Substitua o seguintecluster-config
para as chaves de opção:AUTOSCALING_MIN_NODES
: o número mínimo de nós do cluster.AUTOSCALING_MAX_NODES
: o número máximo de nós para o cluster.AUTOSCALING_CPU_TARGET
: a meta de uso da CPU para o cluster. Esse valor precisa ser de 10 a 80.AUTOSCALING_STORAGE_TARGET
: (opcional) o destino de utilização do armazenamento em GiB que o Bigtable mantém adicionando ou removendo nós.KMS_KEY: a chave CMEK para o cluster.
O valor KMS_KEY precisa ser definido no seguinte formato:
projects/PROJECT/locations/LOCATION/keyRings/KEYRING/cryptoKeys/KEY
Substitua:
- PROJECT: o identificador permanente do projeto.
- LOCATION: o local do cluster
- KEYRING: o nome do keyring que contém a chave
- KEY: o nome da chave;
Veja um exemplo abaixo.
projects/examplestore.com:dev/locations/us-east1/keyRings/devt-cmek-2/cryptoKeys/key2
Se a instância estiver protegida por CMEK, cada cluster precisará estar na mesma região que a chave CMEK. Só é possível adicionar clusters do CMEK a instâncias que já estejam protegidas por CMEK. Saiba mais.
O comando aceita as sinalizações opcionais a seguir:
--cluster-storage-type=CLUSTER_STORAGE_TYPE
: o tipo de armazenamento a ser usado na instância. O valor padrão éSSD
. Na maioria dos casos, o valor padrão é o melhor. Essa opção é permanente. Saiba mais.--project=PROJECT
: projeto em que o cluster será criado se for diferente do projeto atual.
Revise as configurações de replicação no perfil de aplicativo padrão para ver se elas se aplicam ao caso de uso de replicação. Talvez seja necessário atualizar o perfil de aplicativo padrão ou criar perfis de aplicativo personalizados.
cbt
Comece criando uma instância com um único cluster. Use o comando
createinstance
para criar uma instância:cbt createinstance INSTANCE_ID \ DISPLAY_NAME \ CLUSTER_ID \ CLUSTER_ZONE \ CLUSTER_NUM_NODES \ CLUSTER_STORAGE_TYPE
Preencha o seguinte:
INSTANCE_ID
: identificador permanente da instânciaDISPLAY_NAME
: um nome legível que identifica a instância no console do Google Cloud.CLUSTER_ID
: identificador permanente do cluster.CLUSTER_ZONE
: A zona em que o cluster é executado.CLUSTER_NUM_NODES
: este campo é opcional. Se nenhum valor for definido, o Bigtable vai alocar automaticamente os nós com base no seu volume de dados e otimizar para 50% da utilização do armazenamento. Se você quiser controlar o número de nós em um cluster, atualize o valorCLUSTER_NUM_NODES
. Verifique se o número de nós está definido como um valor diferente de zero. Saiba mais sobre nós.CLUSTER_STORAGE_TYPE
: o tipo de armazenamento a ser usado no cluster. Cada cluster em uma instância precisa usar o mesmo tipo de armazenamento. Aceita os valoresSSD
eHDD
. Na maioria dos casos, oSSD
é o melhor. Essa opção é permanente. Saiba mais.
Para ativar a replicação, use o comando
createcluster
para adicionar um cluster:cbt -instance=INSTANCE_ID \ createcluster CLUSTER_ID \ ZONE \ NUM_NODES \ STORAGE_TYPE
Preencha o seguinte:
INSTANCE_ID
: identificador permanente da instância recém-criada.CLUSTER_ID
: identificador permanente do cluster.ZONE
: A zona em que o cluster é executado.Cada zona em uma região pode conter apenas um cluster. Por exemplo, se uma instância tiver um cluster em
us-east1-b
, será possível adicionar um cluster em uma zona diferente na mesma região, comous-east1-c
, ou em uma zona em uma região separada comoeurope-west2-a
.NUM_NODES
: Este campo é opcional. Se nenhum valor for definido, o Bigtable vai alocar automaticamente os nós com base no seu volume de dados e otimizar para 50% da utilização do armazenamento. Se você quiser controlar o número de nós em um cluster, atualize o valorNUM_NODES
. Verifique se o número de nós está definido como um valor diferente de zero.Em muitos casos, cada cluster em uma instância precisa ter o mesmo número de nós, mas há exceções. Saiba mais sobre nós e replicação.
STORAGE_TYPE
: o tipo de armazenamento a ser usado no cluster. Cada cluster em uma instância precisa usar o mesmo tipo de armazenamento. Aceita os valoresSSD
eHDD
.
(Opcional) Revise as configurações de replicação no perfil de aplicativo padrão para saber se elas se aplicam ao caso de uso de replicação. Talvez seja necessário atualizar o perfil de aplicativo padrão ou criar perfis de aplicativo personalizados.
C++
Para saber como instalar e usar a biblioteca de cliente do Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
C#
Para saber como instalar e usar a biblioteca de cliente do Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Para saber como instalar e usar a biblioteca de cliente do Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Para saber como instalar e usar a biblioteca de cliente do Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
PHP
Para aprender a instalar e usar a biblioteca de cliente para o Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Para aprender a instalar e usar a biblioteca de cliente para o Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Ruby
Para aprender a instalar e usar a biblioteca de cliente para o Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
A seguir
- Veja como o Bigtable usa instâncias, clusters e nós.
- Saiba mais sobre a replicação do Bigtable.
- Revise e atualize o perfil de aplicativo padrão para replicação e crie perfis de aplicativo personalizados conforme necessário.
- Saiba como modificar uma instância atual.