Cotas e limites

Nesta página, descrevemos as cotas e os limites de produção do Cloud Spanner. É possível solicitar um aumento de cotas, mas não podemos ajustar um limite.

Esses valores estão sujeitos a alterações.

Observação:o armazenamento e o uso da rede são calculados em gigabytes binários (GB), em que 1 GB equivale a 2³⁰ bytes. Essa unidade de medida também é conhecida como gibibyte (GiB). Da mesma forma, 1 TB equivale a 2⁴⁰ bytes, ou seja, 1.024 GB.

Como verificar suas cotas

Para verificar as cotas atuais para os recursos do seu projeto, use o Console do Google Cloud:

Verificar suas cotas

Como aumentar as cotas

À medida que o uso do Cloud Spanner aumenta, o limite de cotas também é ampliado. Se você espera um aumento significativo no uso, faça uma solicitação com alguns dias de antecedência para garantir que as cotas tenham o limite necessário.

Observação: para solicitar mais cotas, sua conta de usuário precisa ter a permissão serviceusage.quotas.update. Por padrão, ela está incluída nos seguintes papéis predefinidos: proprietário, editor e administrador de cotas.

1. Acesse a página Cotas no Console do Cloud:

   Acessar a página "Cotas"

2. Selecione API Cloud Spanner na lista suspensa Serviços.

   Se você não encontrar a opção API Cloud Spanner, é porque ela não foi ativada.

3. Selecione as cotas que você quer alterar.

4. Clique em Editar cotas.

5. Preencha seu nome, e-mail e número de telefone, e clique em Próxima.

6. Preencha o formulário de cota e clique em Enviar solicitação.

Você receberá uma resposta da equipe do Cloud Spanner até 48 horas após a solicitação.

Limites de instância

Valor	Limite
Comprimento do ID da instância	2 a 64 caracteres

Limites do banco de dados

Valor	Limite
Bancos de dados por instância	100
Comprimento do ID do banco de dados	2 a 30 caracteres
Tamanho do armazenamento por nó	2 TB^1

Limites de backup e restauração

Valor	Limite
Número de operações de criação de backup em andamento por banco de dados	1
Número de operações de restauração de banco de dados em andamento por instância (na instância do banco de dados restaurado, não no backup)	1
Tempo de retenção máximo do backup	Um ano (incluindo o dia extra em anos bissextos)

Limites de esquema

Instruções DDL

Valor	Limite
Tamanho da instrução DDL para uma única mudança de esquema	10 MB
Tamanho da instrução DDL para todo o esquema de um banco de dados, conforme retornado por GetDatabaseDdl	10 MB

Tabelas

Valor	Limite
Tabelas por banco de dados	2.560
Comprimento do nome da tabela	1 a 128 caracteres
Colunas por tabela	1.024
Comprimento do nome da coluna	1 a 128 caracteres
Tamanho dos dados por coluna	10 MB
Número de colunas em uma chave de tabela	16 Inclui colunas chave compartilhadas com qualquer tabela pai
Profundidade de intercalação da tabela	7 Uma tabela de nível superior com tabela filho tem profundidade 1. Uma tabela de nível superior com tabelas neto tem profundidade 2 e assim por diante
Tamanho total de uma tabela ou chave de índice	8 KB Inclui o tamanho de todas as colunas que compõem a chave
Tamanho dos dados por linha	4 GB Inclui a linha de nível superior e todas as linhas intercaladas dela, como as de filho e de índice

Índices

Valor	Limite
Índices por banco de dados	5.120
Índices por tabela	32
Comprimento do nome do índice	1 a 128 caracteres
Número de colunas em uma chave de índice	16 O número de colunas indexadas (exceto as colunas de STORING) mais o número de colunas da chave primária na tabela base

Limites de consulta

Valor	Limite
Colunas em uma cláusula GROUP BY	1.000
Chamadas de funções	1.000
Mesclagens	15
Chamadas de funções aninhadas	75
Cláusulas GROUP BY aninhadas	35
Expressões de subconsulta aninhadas	25
Declarações de subseleção aninhadas	60
Parâmetros	950
Comprimento da declaração de consulta	1 milhão de caracteres
Campos STRUCT	1.000
Filhos da expressão da subconsulta	40
Uniões em uma consulta	200

Limites para criar, ler, atualizar e excluir dados

Valor	Limite
Tamanho da confirmação (incluindo índices)	100 MB
Leituras simultâneas por sessão	100
Mutações por confirmação (incluindo índices)^2	20.000
Declarações DML particionadas simultâneas por banco de dados	20.000

Limites administrativos

Valor	Limite
Tamanho da solicitação de ações administrativas^3	1 MB
Limitação de taxa para ações administrativas^4	Cinco por segundo, por projeto e por usuário (média de mais de 100 segundos)

Limites de solicitações

Valor	Limite
Tamanho da solicitação, que não seja o das confirmações^5	10 MB

Observações

1. Para você usar o Cloud Spanner e acessar um banco de dados com alta disponibilidade e baixa latência, é necessário um nó para cada 2 TB de dados no banco de dados. Por exemplo, se a instância tiver um banco de dados que armazena 3,5 TB de dados, você precisará provisionar pelo menos dois nós. Eles manterão a instância abaixo do limite até que o banco de dados aumente para 4 TB. Depois que o banco de dados atingir esse tamanho, você precisará adicionar outro nó para que o banco de dados possa crescer. Caso contrário, as gravações no banco de dados falharão. Para ter uma experiência de crescimento otimizada, adicione os nós antes que esse limite seja atingido no banco de dados.

2. As operações de inserção e atualização consideram a multiplicidade do número de colunas que elas afetam. Por exemplo, inserir um novo registro poderá contabilizar cinco mutações caso os valores sejam inseridos em cinco colunas. As operações de exclusão e de remoção de intervalos contam como uma mutação, independentemente do número de colunas afetadas. Excluir uma linha de uma tabela mãe que tem a anotação ON DELETE CASCADE também conta como uma mutação, independentemente do número de linhas filhas intercaladas. A exceção é que, se houver índices secundários definidos em linhas que estejam sendo excluídos, as alterações nos índices secundários serão contadas individualmente. Por exemplo, se uma tabela tiver dois índices secundários, excluir um intervalo de linhas dela contará como uma mutação, mais duas mutações para cada linha excluída. Isso acontece porque as linhas no índice secundário podem estar espalhadas pelo espaço de chave, impossibilitando que o Cloud Spanner chame uma operação única de intervalo de exclusão nesse ambiente. Índices secundários incluem os índices de backup de chaves externas.

3. O limite de uma solicitação de ação administrativa exclui confirmações, solicitações listadas na observação 5 e alterações de esquema.

4. Essa limitação de taxa inclui todas as chamadas para a API admin, inclusive chamadas para apurar operações de longa duração em uma instância, um banco de dados ou um backup.

5. Esse limite inclui solicitações de criação e atualização de um banco de dados, leitura, streaming de leituras, execução de consultas SQL e realização de consultas SQL de streaming.