Crie uma instância
Uma instância do Bigtable é um contentor para clusters do Bigtable. Uma instância com mais do que um cluster usa a replicação. Pode criar clusters em até 8 regiões, com tantos clusters em cada região quantas zonas existirem.
Esta página explica como criar uma instância. Antes de ler esta página, deve conhecer a vista geral do Bigtable. Também deve ler a vista geral das instâncias, dos clusters e dos nós.
Antes de começar
Prepare o seu 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.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator
(
roles/resourcemanager.projectCreator
), which contains theresourcemanager.projects.create
permission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
-
Enable the Cloud Bigtable API, Cloud Bigtable Admin API APIs.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin
), which contains theserviceusage.services.enable
permission. Learn how to grant roles. -
Install the Google Cloud CLI.
-
Se estiver a usar um fornecedor de identidade (IdP) externo, tem primeiro de iniciar sessão na CLI gcloud com a sua identidade federada.
-
Para inicializar a CLI gcloud, execute o seguinte comando:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator
(
roles/resourcemanager.projectCreator
), which contains theresourcemanager.projects.create
permission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
-
Enable the Cloud Bigtable API, Cloud Bigtable Admin API APIs.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin
), which contains theserviceusage.services.enable
permission. Learn how to grant roles. -
Install the Google Cloud CLI.
-
Se estiver a usar um fornecedor de identidade (IdP) externo, tem primeiro de iniciar sessão na CLI gcloud com a sua identidade federada.
-
Para inicializar a CLI gcloud, execute o seguinte comando:
gcloud init
- Execute o seguinte comando para instalar a CLI
cbt
:gcloud components install cbt
Opcional: se planeia ativar a replicação, faça o seguinte:
- Dedique alguns minutos a ler a vista geral da replicação.
- Identifique o exemplo de utilização para a replicação.
- Determine a região ou as regiões em que a sua instância deve estar, com base no seu exemplo de utilização e na localização da sua aplicação e tráfego.
- Decida como vai usar os perfis de aplicações para encaminhar pedidos recebidos.
Opcional: se quiser usar chaves de encriptação geridas pelo cliente (CMEK) em vez da encriptação predefinida gerida pela Google, conclua as tarefas em Criar uma instância com CMEK e tenha o ID da chave CMEK pronto antes de criar a nova instância. Não pode adicionar proteção CMEK a uma instância depois de esta ter sido criada, e não pode modificar nem substituir a chave CMEK depois de a instância ter sido criada.
Na Google Cloud consola, aceda à página Criar instância.
Introduza um nome para a instância.
A Google Cloud consola apresenta este nome para identificar a sua instância.
Introduza um ID da instância.
O ID da instância é um identificador permanente da instância.
Clique em Continuar.
Escolha se quer usar um disco SSD ou HDD para os seus clusters. Na maioria dos casos, o SSD é a melhor opção. Esta escolha é permanente. Saiba mais.
Clique em Continuar.
Introduza um ID do cluster para o primeiro cluster.
O ID do cluster é um identificador permanente do cluster.
Escolha a região e a zona onde o primeiro cluster vai ser executado.
Opcional: para configurar o cluster de modo a que seja sempre dimensionado em incrementos de dois nós, selecione Ativar o dimensionamento de nós 2x. O dimensionamento de nós 2x não está disponível em todas as zonas. Para mais informações, consulte o artigo Fator de dimensionamento do nó.
Escolha um modo de dimensionamento de nós para o cluster. Na maioria dos casos, deve escolher o ajuste de escala automático. Para orientações sobre o dimensionamento, consulte o artigo Dimensionamento automático.
- Para a atribuição manual de nós, introduza o número de nós do Bigtable para o primeiro cluster. Se não tiver a certeza de quantos nós precisa, use o valor predefinido. Pode adicionar mais nós posteriormente.
- Para a escalabilidade automática, introduza valores para o seguinte:
- Número mínimo de nós
- Número máximo de nós
- Alvo de utilização da CPU
- Objetivo de utilização do armazenamento
Opcional: para proteger a sua instância com CMEK em vez da encriptação predefinida gerida pela Google, conclua os seguintes passos:
- Clique em Mostrar opções de encriptação.
- Selecione o botão de opção junto a Chave de encriptação gerida pelo cliente (CMEK).
- Selecione ou introduza o nome do recurso da chave CMEK que quer usar para o cluster. Não pode adicionar esta informação mais tarde.
- Se lhe for pedido que conceda autorização à conta de serviço da chave CMEK, clique em Conceder. A sua conta de utilizador tem de ter a função de administrador do Cloud KMS para concluir esta tarefa.
- Clique em Guardar.
Opcional: para ativar a replicação agora, conclua os seguintes passos adicionais:
- Clique em Mostrar opções avançadas.
- Clique em Adicionar cluster, introduza as definições do cluster e, de seguida, clique em Adicionar. Repita este passo para criar clusters adicionais na instância. Também pode ativar a replicação mais tarde adicionando um cluster.
Cada zona numa região só pode conter um cluster. Se o botão Adicionar cluster estiver desativado, altere a zona do primeiro cluster.
Para criar uma instância com mais de seis clusters, comece por criar uma instância com seis clusters e, em seguida, adicione mais clusters à instância.
Clique em Criar para criar a instância.
Reveja as definições de replicação no perfil da app predefinido para ver se fazem sentido para o seu exemplo de utilização de replicação. Pode ter de atualizar o perfil da app predefinida ou criar perfis de apps personalizados.
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], \ [node-scaling-factor=NODE_SCALING_FACTOR]
Substitua o seguinte:
INSTANCE_ID
: O identificador permanente da instância.DISPLAY_NAME
: um nome legível por humanos que identifica a instância na consola Google Cloud .CLUSTER_ID
: O identificador permanente do cluster.CLUSTER_ZONE
: A zona onde o cluster é executado.
Tem de configurar, pelo menos, um cluster para a instância, usando a flag
--cluster-config
. Para criar uma instância com vários clusters, repita a flag--cluster-config
para cada cluster.Para a atribuição manual de nós, a definição da flag
nodes
no elemento--cluster-config
é opcional. Se não for definido nenhum valor, o Bigtable atribui nós ao cluster automaticamente com base na sua pegada de dados e otimiza para uma utilização de armazenamento de 50%. Esta atribuição automática de nós tem um impacto nos preços. Se quiser controlar o número de nós num cluster, substituaNODES
pelo número de nós que quer no cluster. Saiba mais sobre os nós.Na maioria dos casos, escolha o dimensionamento automático em vez da atribuição manual de nós. Para o dimensionamento automático, forneça opções
autoscaling-
na flag--cluster-config
(autoscaling-storage-target
é opcional) e não usenodes
. Consulte o artigo Dimensionamento automático para obter orientações sobre a escolha dos valores para as definições de dimensionamento automático. Substitua o seguinte pelas chaves de opçõescluster-config
:AUTOSCALING_MIN_NODES
: o número mínimo de nós para o cluster.AUTOSCALING_MAX_NODES
: o número máximo de nós para o cluster.AUTOSCALING_CPU_TARGET
: a percentagem de utilização da CPU alvo para o cluster. Este valor tem de estar entre 10 e 80.AUTOSCALING_STORAGE_TARGET
: (Opcional) O objetivo 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 tem de ser definido no seguinte formato:
projects/PROJECT/locations/LOCATION/keyRings/KEYRING/cryptoKeys/KEY
Substitua o seguinte:
- PROJECT: o identificador permanente do projeto
- LOCATION: a localização do seu cluster
- KEYRING: o nome do conjunto de chaves que contém a chave
- KEY: o nome da chave
Segue-se um exemplo:
projects/examplestore.com:dev/locations/us-east1/keyRings/devt-cmek-2/cryptoKeys/key2
Se a instância estiver protegida por CMEK, cada cluster tem de estar na mesma região que a respetiva chave CMEK. Só pode adicionar clusters CMEK a instâncias que já estejam protegidas com CMEK. Saiba mais.
O comando aceita as seguintes flags opcionais:
--cluster-storage-type=CLUSTER_STORAGE_TYPE
: o tipo de armazenamento a usar para a instância. O valor predefinido éSSD
. Na maioria dos casos, o valor predefinido é o melhor. Esta escolha é permanente. Saiba mais.--project=PROJECT
: O projeto no qual criar o cluster, se for diferente do projeto atual.node-scaling-factor=NODE_SCALING_FACTOR
: um sinalizador que ativa o dimensionamento de nós 2x. Pode ativar esta funcionalidade com o ajuste de escala manual e o ajuste de escala automático. Os valores aceitáveis sãonode-scaling-factor-2x
ounode-scaling-factor-1x
.
Para ver uma lista de zonas do Bigtable que não estão disponíveis para o dimensionamento de nós 2x, consulte as limitações do fator de dimensionamento de nós.
Reveja as definições de replicação no perfil da app predefinido para ver se fazem sentido para o seu exemplo de utilização de replicação. Pode ter de atualizar o perfil da app predefinida ou criar perfis de apps personalizados.
Comece por criar 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
Forneça os seguintes dados:
INSTANCE_ID
: O identificador permanente da instância.DISPLAY_NAME
: um nome legível por humanos que identifica a instância na consola Google Cloud .CLUSTER_ID
: O identificador permanente do cluster.CLUSTER_ZONE
: A zona onde o cluster é executado.CLUSTER_NUM_NODES
: este campo é opcional. Se não for definido nenhum valor, o Bigtable atribui automaticamente nós com base na sua pegada de dados e otimiza para uma utilização de armazenamento de 50%. Se quiser controlar o número de nós num cluster, atualize o valorCLUSTER_NUM_NODES
. Certifique-se de que o número de nós está definido como um valor diferente de zero. Saiba mais sobre os nós.CLUSTER_STORAGE_TYPE
: O tipo de armazenamento a usar para o cluster. Cada cluster numa instância tem de usar o mesmo tipo de armazenamento. Aceita os valoresSSD
eHDD
. Na maioria dos casos,SSD
é a melhor opção. Esta escolha é 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
Forneça os seguintes dados:
INSTANCE_ID
: o identificador permanente da instância que acabou de criar.CLUSTER_ID
: O identificador permanente do cluster.ZONE
: A zona onde o cluster é executado.Cada zona numa região só pode conter um cluster. Por exemplo, se uma instância tiver um cluster em
us-east1-b
, pode adicionar um cluster numa zona diferente na mesma região, comous-east1-c
, ou numa zona numa região separada, comoeurope-west2-a
.NUM_NODES
: este campo é opcional. Se não for definido nenhum valor, o Bigtable atribui automaticamente nós com base na sua pegada de dados e otimiza para uma utilização de armazenamento de 50%. Se quiser controlar o número de nós num cluster, atualize o valorNUM_NODES
. Certifique-se de que o número de nós está definido como um valor diferente de zero.Em muitos casos, cada cluster numa instância deve ter o mesmo número de nós, mas existem exceções. Saiba mais sobre os nós e a replicação.
STORAGE_TYPE
: O tipo de armazenamento a usar para o cluster. Cada cluster numa instância tem de usar o mesmo tipo de armazenamento. Aceita os valoresSSD
eHDD
.
(Opcional) Reveja as definições de replicação no perfil da app predefinido para ver se fazem sentido para o seu exemplo de utilização de replicação. Pode ter de atualizar o perfil da app predefinida ou criar perfis de apps personalizados.
- Saiba como o Bigtable usa instâncias, clusters e nós.
- Saiba mais sobre a replicação do Bigtable.
- Reveja e atualize o perfil da app predefinido para a replicação e crie perfis da app personalizados conforme necessário.
- Saiba como modificar uma instância existente.
Planeie a sua configuração:
Crie uma instância
Para criar uma instância do Bigtable:
Consola
gcloud
cbt
.C++
Para saber como instalar e usar a biblioteca cliente do Bigtable, consulte o artigo Bibliotecas cliente do Bigtable.
Para se autenticar no Bigtable, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
C#
Para saber como instalar e usar a biblioteca cliente do Bigtable, consulte o artigo Bibliotecas cliente do Bigtable.
Para se autenticar no Bigtable, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Java
Para saber como instalar e usar a biblioteca cliente do Bigtable, consulte o artigo Bibliotecas cliente do Bigtable.
Para se autenticar no Bigtable, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Node.js
Para saber como instalar e usar a biblioteca cliente do Bigtable, consulte o artigo Bibliotecas cliente do Bigtable.
Para se autenticar no Bigtable, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
PHP
Para saber como instalar e usar a biblioteca cliente do Bigtable, consulte o artigo Bibliotecas cliente do Bigtable.
Para se autenticar no Bigtable, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Python
Para saber como instalar e usar a biblioteca cliente do Bigtable, consulte o artigo Bibliotecas cliente do Bigtable.
Para se autenticar no Bigtable, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Ruby
Para saber como instalar e usar a biblioteca cliente do Bigtable, consulte o artigo Bibliotecas cliente do Bigtable.
Para se autenticar no Bigtable, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.