Spanner データベースでメジャー圧縮を手動でトリガーする

このドキュメントでは、Spanner データベースでメジャーコンパクションを手動でトリガーする方法について説明します。

Spanner のストレージ関連の機能（階層ストレージやカラム型エンジンなど）の多くは、完全に有効になる前にデータベース全体のメジャー圧縮に依存しています。デフォルトでは、メジャーコンパクションは 7 日間の期間にわたってすべてのテーブルで自動的に行われます。つまり、新機能が完全に利用可能になるまで最大 7 日間かかる場合があります。新しい機能をすぐに利用できるようにするには、メジャーコンパクションを手動でトリガーします。

圧縮プロセスは、長時間実行オペレーション（LRO）です。

料金

大規模な圧縮をトリガーすると、Spanner インスタンスのコンピューティング容量が一時的に増加します。これにより、費用が増加する可能性があります。

パフォーマンス

メジャーコンパクションはバックグラウンドオペレーションとして実行されます。ただし、インスタンスの CPU 使用率が常に高い場合、圧縮ワークロードが他の重要なオペレーションに干渉する可能性があります。このような場合は、コンパクション中のパフォーマンスを安定させるために、インスタンスを一時的にスケールアップできます。

メジャーコンパクションを手動でトリガーする

Google Cloud コンソール

Google Cloud コンソールを開き、インスタンスを選択します。

Spanner インスタンスに移動
データベースを選択します。
ナビゲーションメニューで [Spanner Studio] をクリックします。
[新しい SQL エディタタブ] または [新しいタブ] をクリックし、新しいタブを開きます。
次のコマンドを実行して、圧縮を開始します。
```
CALL compact_all();
```
このオペレーションは、長時間実行オペレーション（LRO）ID を返します。この ID を使用して、オペレーション リストでオペレーションを見つけることができます。
圧縮オペレーションの進行状況をモニタリングするには、ナビゲーションメニューで [オペレーション] をクリックします。

C++

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";
  }
}

長時間実行データベースオペレーションの進行状況を確認できます。LRO ID を使用して、進行中のメジャー圧縮リクエストをキャンセルすることもできます。詳細については、長時間実行データベースオペレーションをキャンセルするをご覧ください。