Acionar manualmente a compactação principal em um banco de dados do Spanner

Pré-lançamento — Spanner columnar engine

Este recurso está sujeito aos "Termos da Oferta Pré-GA" na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os recursos pré-GA estão disponíveis no estado em que se encontram e podem ter assistência limitada. Para mais informações, consulte as descrições das fases de lançamento.

Observação: esse recurso está disponível nas edições Enterprise e Enterprise Plus do Spanner. Para mais informações, consulte o resumo das edições do Spanner.

Observação sobre a interface do PostgreSQL:Os exemplos neste tópico são destinados a bancos de dados do dialeto GoogleSQL. Esse recurso não é compatível com Interface PostgreSQL.

Neste documento, explicamos como acionar manualmente uma compactação principal em um banco de dados do Spanner.

Vários recursos relacionados ao armazenamento no Spanner, como armazenamento por níveis ou mecanismo colunar, dependem de uma compactação principal em todo o banco de dados antes de serem totalmente ativados. Por padrão, as compactações principais ocorrem automaticamente em todas as tabelas durante períodos de sete dias. Isso significa que você pode esperar até sete dias para que um novo recurso esteja totalmente disponível. Para disponibilizar novos recursos imediatamente, acione manualmente uma compactação principal.

O processo de compactação é uma operação de longa duração (LRO).

Preços

Acionar uma compactação principal aumenta temporariamente a capacidade de computação na instância do Spanner. Isso pode resultar em custos maiores.

Desempenho

As compactações principais são executadas como operações em segundo plano. No entanto, se a instância tiver um uso intenso e consistente da CPU, a carga de trabalho de compactação poderá interferir em outras operações críticas. Nesses casos, é possível fazer o escalonar verticalmente vertical temporário da instância para garantir um desempenho estável durante a compactação.

Acionar manualmente uma compactação principal

Console do Google Cloud

1. Abra o console do Google Cloud e selecione sua instância.

   Acessar a instância do Spanner

2. Selecione um banco de dados.

3. No menu de navegação, clique em Spanner Studio.

4. Abra uma nova guia clicando em Nova guia do editor de SQL ou Nova guia.

5. Chame o comando a seguir para iniciar a compactação:

   CALL compact_all();
   

   Essa operação retorna um ID de operação de longa duração (LRO) que pode ser usado para encontrar a operação na lista Operações.

6. Para monitorar o progresso da operação de compactação, no menu de navegação, clique em Operações.

C++

Para acionar compactações de forma programática usando a biblioteca de cliente C++:

void Compact(google::cloud::spanner::Client client) {
  namespace spanner = ::google::cloud::spanner;

  spanner::SqlStatement select("CALL compact_all()");
  auto rows = client.ExecuteQuery(statement);
  using RowType = std::tuple<std::string>;
  auto rows = client.ExecuteQuery(std::move(select));

  for (auto& row : spanner::StreamOf<RowType>(rows)) {
    if (!row) throw std::move(row).status();
    std::cout << "Long-running operation ID: " << std::get<0>(*row) << "\n";
  }
}

É possível verificar o progresso de uma operação de banco de dados de longa duração. Também é possível cancelar a solicitação de compactação principal em andamento usando o ID da LRO. Para mais informações, consulte Cancelar uma operação de banco de dados de longa duração.