「せっかく作ったWebアプリのダッシュボード、開くたびにスプレッドシートを読みに行っていて表示されるまでに5秒も10秒も待たされる……」
「社内メンバーから『ダッシュボードが重くて開くのが億劫』と言われてしまった……」
Google Apps Script(GAS)でスプレッドシートをデータベースにしてWebアプリや集計システムを作れるようになってくると、避けては通れないのがこの「画面の表示速度(パフォーマンス)の壁」ですよね。
朝、オフィスやカフェで作業を始めるとき、PCを開いて社内ポータルにアクセスしたのに、ぐるぐる回るローディング画面をずっと見つめさせられるのは地味にストレスが溜まるものです。札幌の冬、凍える寒さの中でチカホ(札幌駅前通地下歩行空間)のカフェに駆け込んで「さっと今月の売上推移を確認したい!」というときに、画面がカクカクして何秒も待たされたら、せっかく淹れたての温かいコーヒーを飲む気分まで台無しになってしまいますよね。
そんな「スプレッドシート読み込みの激重問題」を一発で解決し、表示速度を0.1秒台へと劇的に爆速化してくれる秘密兵器が、今回マスターする CacheService.getScriptCache()(キャッシュ・サービス) です!
一度スプレッドシートから読み込んだ集計データを、Googleの超高速な一時保管メモリ(キャッシュ)に預けておくことで、2回目以降のアクセスではスプレッドシートをわざわざ見に行かずに一瞬で画面を描画できるようになります。
今回は、フェーズ9で作成した「札幌オフィス統合ダッシュボード」の月次売上データを題材に、キャッシュの仕組みから基本構文、速度比較テスト、実務で必須のJSONシリアライズ連携、そして初心者が必ずハマる「キャッシュと最新データのズレ」の解決策まで、どこよりも分かりやすく徹底解説していきます!
1. そもそも CacheService とは?なぜWebアプリが爆速になるのか
まずは、「なぜスプレッドシートの読み込みは遅いのか?」「キャッシュを使うとどうして速くなるのか?」という根本的な仕組みからスッキリ整理しておきましょう。
スプレッドシートへのアクセスは「遠い倉庫への買い出し」
GASのプログラム(コード.gs)からスプレッドシートのセルを読み取る処理(SpreadsheetApp.openById() や sheet.getRange().getValues())は、Googleのクラウド内部で「別の巨大なサーバー」と通信を行っています。
これは例えるなら、「料理の注文が入るたびに、遠く離れた大型倉庫まで車を走らせて食材を取りに行く」ようなものです。1日に数百回もアクセスがあれば、そのたびに重いファイルを開いて、マス目をスキャンして、データを手元に運んでくるわけですから、数秒〜十数秒の時間がかかってしまうのは当然ですよね。
キャッシュは「キッチンの手元にある冷蔵庫」
そこで登場するのが キャッシュ(Cache) という仕組みです!
倉庫(スプレッドシート)から取ってきた食材(売上データ)を、プログラムのすぐ隣にある「一時保管用の超高速な冷蔵庫(CacheService)」にしまっておきます。次に同じ注文(ダッシュボードの表示リクエスト)が来たら、遠い倉庫まで走るのではなく、手元の冷蔵庫をパッと開けて食材を取り出します。
| 比較項目 | スプレッドシートを毎回読みに行く場合 | CacheService を活用する場合(★今回) |
|---|---|---|
| データの保管場所 | Googleドライブ上のファイル(遠い倉庫) | Googleサーバーの超高速メモリ(手元の冷蔵庫) |
| データ取得時間 | 約 1.5秒 〜 5.0秒(データ量によって増大) | 約 0.01秒 〜 0.05秒(ほぼ一瞬!) |
| 通信負荷 | スプレッドシートへのアクセス過多で重くなる | スプレッドシートを一切開かないため負荷ゼロ |
| 主な活躍シーン | 常に最新1秒を争うデータの書き込み | 月次売上、前日までの確定実績、マスタデータ |
月次売上データのように「1秒ごとに頻繁に変わるわけではないけれど、全員が何度も確認するデータ」を扱う場合、このキャッシュの仕組みを挟むだけで、体感速度が10倍〜50倍以上も跳ね上がるのです!
知っておくべき「3種類のキャッシュストア」
第93回の「スクリプトプロパティ」のときと同様に、GASの CacheService にも用途に合わせて3つの保管場所(キャッシュストア)が用意されています。違いをサクッと確認しておきましょう。
| キャッシュの種類 | 取得メソッド | 共有範囲 | 主な用途 |
|---|---|---|---|
| スクリプトキャッシュ (★今回メイン!) | getScriptCache() | そのプロジェクトを実行する全員で共有される | 社内ダッシュボードの売上データ、全社お知らせ、APIの取得結果 |
| ユーザーキャッシュ | getUserCache() | アクセスしているユーザー個人のみ | 個人の表示設定、一時的な入力下書き、ログイン状態の維持 |
| ドキュメントキャッシュ | getDocumentCache() | そのファイル単体のみ(バインド専用) | 特定のスプレッドシートやドキュメント専用の一時データ |
札幌オフィスの全メンバーや役員が見る「月次業績ダッシュボード」のように、「誰が開いても同じ売上データを見せたい」という場合は、全員でメモリを共有できる getScriptCache() 一択となります!
2. CacheService の3大メソッドと動くルール
CacheService を操作する命令は驚くほどシンプルで、覚えるべき基本メソッドはたったの3つだけです。
① cache.get(key) :キャッシュからデータを取り出す
指定した名前(キー)の冷蔵庫を開けて、中に入っているデータを取り出します。
// 'monthly_sales_202611' というキーで保管されたデータを取り出す
var cachedData = cache.get('monthly_sales_202611');
※もし冷蔵庫の中に該当するデータが入っていない(または有効期限が切れて消えてしまった)場合、エラーにはならず null(空っぽ) が返ってきます。
② cache.put(key, value, expirationInSeconds) :キャッシュに保存する
名前(キー)を付けて、データを指定した秒数の間だけ冷蔵庫にしまっておきます。
// データを「1800秒(30分間)」だけキャッシュに保存する
cache.put('monthly_sales_202611', JSON.stringify(salesData), 1800);
第3引数の expirationInSeconds(有効期限)には、以下のルールがあります。
- 最小時間:1秒
- 最大時間:21,600秒(=6時間)
- デフォルト時間:省略した場合は 600秒(=10分間)
永久に保存できる「プロパティ(金庫)」とは違い、キャッシュはあくまで「一時保管所」なので、最大でも6時間で自動消滅する仕様になっています。
③ cache.remove(key) :キャッシュを破棄する
スプレッドシートのデータが手動で更新されたときなど、「古いキャッシュを捨てて、強制的にスプレッドシートの最新データを読み直したい!」という場合に使います。
// 指定したキーのキャッシュを今すぐ消去する
cache.remove('monthly_sales_202611');
【超重要ルール】キャッシュに保存できるのは「文字列(String)」のみ!
ここが初心者が一番最初にぶつかる落とし穴です!cache.put() の第2引数に、スプレッドシートから取得した配列 [[...], [...]] やオブジェクト { sales: 150000 } をそのまま渡そうとすると、エラーが発生するか、中身が "[object Object]" という意味のない文字列に化けてしまいます。
ここで、前回(第95回)学んだ知識を思い出してください!
「入れるときは JSON.stringify() でテキスト化し、取り出したら JSON.parse() でオブジェクトに戻す」というルールを徹底します。前回の学びがここで完璧に活きてきますね!
3. 世界標準の黄金パターン「Cache-Aside(キャッシュ・アサイド)」
実務でキャッシュを導入する際、Webエンジニアが100%採用する設計パターンが Cache-Aside(キャッシュ・アサイド) です。難しそうな名前に見えますが、考え方は驚くほどシンプルです。
【データの取得リクエストが届いたとき】
│
▼
① まず CacheService の冷蔵庫を開けてみる!
│
├─ ◯ キャッシュが存在する!(キャッシュヒット)
│ ➔ スプレッドシートは見に行かず、そのデータを即座に返却!(0.01秒で完了)
│
└─ ✕ キャッシュが空っぽ(または期限切れ)だった…(キャッシュミス)
│
▼
② 仕方がないのでスプレッドシートを開いて重い集計を行う(2〜3秒かかる)
│
▼
③ 取り出した最新データを、次の人のために CacheService に保存する(put)!
│
▼
④ 取得したデータを返却する
このフローを組んでおけば、「最初の1人目だけはスプレッドシートを読みに行くけれど、その後の30分間にアクセスしてきた2人目、3人目、100人目のメンバーは全員が一瞬(0.01秒)でダッシュボードを開ける」という、理想的な高速環境が完成します!
4. STEP1:準備!「札幌オフィス月次売上集計表」を用意しよう
それでは、手元で動かすハンズオン環境を作成していきましょう!
今回は、数千行規模のデータを想定した「月次売上集計表」を用意し、キャッシュ化の効果を体感してみます。
手順1:スプレッドシートの作成
- Googleドライブを開き、新しいGoogleスプレッドシートを作成します。
- ファイル名を 「札幌オフィス_月次売上統合管理簿」 に設定します。
- シートタブ名を 「売上データ」 に変更します。
- 1行目に見出し、2行目以降に以下のようなサンプルデータを入力してください。
| A列(取引ID) | B列(取引先名) | C列(拠点・エリア) | D列(売上金額) | E列(ステータス) |
|---|---|---|---|---|
| TRX-9001 | 株式会社札幌スープカレー本舗 | 札幌・中央区 | 1,650,000 | 確定 |
| TRX-9002 | 道産子フーズ株式会社 | 札幌・北区 | 2,200,000 | 確定 |
| TRX-9003 | 北海ITソリューションズ | 札幌・白石区 | 880,000 | 確定 |
| TRX-9004 | 新千歳エアポートサービス | 千歳・空港内 | 3,300,000 | 確定 |
| TRX-9005 | 定山渓観光開発パートナーズ | 札幌・南区 | 1,420,000 | 確定 |
※実際の業務ではここに数百行〜数千行のデータが並びますが、テスト用として数行入力しておけば動作確認が可能です。
手順2:GASエディタを開く
スプレッドシートの上部メニューから 「拡張機能」 > 「Apps Script」 をクリックし、エディタ画面を開きます。プロジェクト名を「札幌ダッシュボード高速化」にしておきましょう。
5. STEP2:【実践】基本コードで「キャッシュなし vs あり」の速度差を体感しよう!
準備ができたら、まずは「毎回スプレッドシートを読みに行く重い処理」と「CacheServiceを使った爆速処理」の2つをコードで書き、処理時間をストップウォッチのように計測して比較してみましょう!
エディタ内のコードをすべて消去し、以下のスクリプトを貼り付けてください。
/**
* 第98回 STEP2:キャッシュの速度比較検証スクリプト
*/
// ① 【キャッシュなし】毎回スプレッドシートを読みに行って集計する重い関数
function getMonthlySalesWithoutCache() {
var startTime = new Date().getTime(); // 計測開始
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheetByName("売上データ");
var lastRow = sheet.getLastRow();
// スプレッドシートから全件取得して合計を計算(第13回の getValues)
var values = sheet.getRange(2, 1, lastRow - 1, 5).getValues();
var totalAmount = 0;
var count = 0;
for (var i = 0; i < values.length; i++) {
totalAmount += Number(values[i][3]) || 0;
count++;
}
var result = {
total: totalAmount,
count: count,
source: "スプレッドシート直接読み込み(遅い)"
};
var endTime = new Date().getTime(); // 計測終了
var executionTime = (endTime - startTime) / 1000;
Logger.log("■ [キャッシュなし] 実行時間: " + executionTime + " 秒 ➔ 売上合計: " + totalAmount.toLocaleString() + " 円");
return result;
}
// ② 【キャッシュあり】CacheServiceを活用した爆速関数(Cache-Asideパターン)
function getMonthlySalesWithCache() {
var startTime = new Date().getTime(); // 計測開始
// 1. スクリプトキャッシュ(冷蔵庫)を開く
var cache = CacheService.getScriptCache();
var cacheKey = "sapporo_monthly_sales_summary";
// 2. まず冷蔵庫の中身を確認してみる!
var cachedJson = cache.get(cacheKey);
var resultData = null;
if (cachedJson !== null) {
// ----------------------------------------------------
// 【キャッシュヒット!】冷蔵庫にデータがあった場合
// ----------------------------------------------------
// 第95回で学んだ JSON.parse() でオブジェクトに解凍!
resultData = JSON.parse(cachedJson);
resultData.source = "CacheServiceから即座に取得(爆速!)";
} else {
// ----------------------------------------------------
// 【キャッシュミス…】冷蔵庫が空っぽだった場合
// ----------------------------------------------------
Logger.log("※キャッシュが存在しないため、スプレッドシートから読み込みます...");
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheetByName("売上データ");
var lastRow = sheet.getLastRow();
var values = sheet.getRange(2, 1, lastRow - 1, 5).getValues();
var totalAmount = 0;
for (var i = 0; i < values.length; i++) {
totalAmount += Number(values[i][3]) || 0;
}
resultData = {
total: totalAmount,
count: values.length,
cachedAt: Utilities.formatDate(new Date(), "Asia/Tokyo", "yyyy/MM/dd HH:mm:ss")
};
// 取り出したデータを、第95回の JSON.stringify() で文字列にして冷蔵庫に保管!
// 第3引数に 1200(=20分間保持)を指定
cache.put(cacheKey, JSON.stringify(resultData), 1200);
}
var endTime = new Date().getTime(); // 計測終了
var executionTime = (endTime - startTime) / 1000;
Logger.log("■ [キャッシュあり] 実行時間: " + executionTime + " 秒 ➔ 出典: " + resultData.source);
return resultData;
}
// キャッシュを強制クリアするお掃除関数
function clearSalesCache() {
var cache = CacheService.getScriptCache();
cache.remove("sapporo_monthly_sales_summary");
Logger.log("🗑️ 売上データのキャッシュを削除しました!");
}
実行してログを見比べてみよう!
コードを保存したら、まずはキャッシュを初期化するために clearSalesCache を1回実行したあと、以下の順番でテストしてみてください。
【実験①:キャッシュなしの関数を実行】
関数 getMonthlySalesWithoutCache を選んで「実行」を押します。
情報 ■ [キャッシュなし] 実行時間: 1.284 秒 ➔ 売上合計: 9,450,000 円
【実験②:キャッシュありの関数を「1回目」実行】
関数 getMonthlySalesWithCache を選んで「実行」を押します。初回はキャッシュが空っぽなので、スプレッドシートを読みに行きます。
情報 ※キャッシュが存在しないため、スプレッドシートから読み込みます...
情報 ■ [キャッシュあり] 実行時間: 1.312 秒 ➔ 出典: null
【実験③:キャッシュありの関数を「2回目」実行(★ここが決定的瞬間!)】
もう一度、間髪入れずに getMonthlySalesWithCache を「実行」してみてください!
情報 ■ [キャッシュあり] 実行時間: 0.015 秒 ➔ 出典: CacheServiceから即座に取得(爆速!)
実行時間の数字に注目してください!
「1.3秒」かかっていた処理が、たった「0.015秒」で完了しています。実に 約90倍の高速化 です!
スプレッドシートを開く重い処理が完全にスキップされ、Googleサーバーのメモリから直接データを取り出しているため、もはや瞬きをする暇すらありません。
6. STEP3:【本格実践】Webダッシュボードへ組み込んで表示を爆速化しよう!
このキャッシュの威力を、フェーズ9で構築した「札幌オフィス統合ダッシュボード(Webアプリ)」に組み込んでみましょう!
URLを開いた瞬間にキャッシュを判定し、画面描画を劇的にスムーズにする実践コードを実装します。
1. バックエンド(コード.gs)の実装
コード.gs に、Webアプリの表示窓口である doGet(e) と、キャッシュを活用したデータ取得関数を用意します。
/**
* 札幌オフィス統合ダッシュボード Webアプリケーション
* 第98回:キャッシュチューニング版 doGet(e)
*/
function doGet(e) {
var template = HtmlService.createTemplateFromFile('index');
// キャッシュを活用して売上サマリーデータを高速取得!
template.salesSummary = getFastMonthlySales();
template.currentTime = Utilities.formatDate(new Date(), "Asia/Tokyo", "HH:mm:ss");
var htmlOutput = template.evaluate();
htmlOutput.setTitle('【札幌オフィス】月次業績ダッシュボード (高速版)');
htmlOutput.addMetaTag('viewport', 'width=device-width, initial-scale=1');
return htmlOutput;
}
/**
* ダッシュボード用のキャッシュ付き売上取得ロジック
*/
function getFastMonthlySales() {
var cache = CacheService.getScriptCache();
var cacheKey = "dashboard_sales_kpi";
var cachedData = cache.get(cacheKey);
if (cachedData) {
// キャッシュが存在すれば、JSONを解凍して即座に返却!
var data = JSON.parse(cachedData);
data.fromCache = true;
return data;
}
// キャッシュがない場合のみスプレッドシートを開く
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheetByName("売上データ");
var values = sheet.getRange(2, 1, sheet.getLastRow() - 1, 5).getValues();
var totalAmount = 0;
var areaBreakdown = {};
for (var i = 0; i < values.length; i++) {
var area = values[i][2]; // C列: エリア
var amount = Number(values[i][3]) || 0; // D列: 金額
totalAmount += amount;
areaBreakdown[area] = (areaBreakdown[area] || 0) + amount;
}
var summary = {
totalSales: totalAmount,
formattedTotal: totalAmount.toLocaleString() + " 円",
dealCount: values.length,
areas: areaBreakdown,
fromCache: false,
lastUpdated: Utilities.formatDate(new Date(), "Asia/Tokyo", "yyyy/MM/dd HH:mm:ss")
};
// 1800秒(30分間)キャッシュに保存!
cache.put(cacheKey, JSON.stringify(summary), 1800);
return summary;
}
// 画面から「最新データに更新」ボタンが押されたときにキャッシュをクリアする関数
function refreshDashboardCache() {
var cache = CacheService.getScriptCache();
cache.remove("dashboard_sales_kpi");
return { success: true, message: "キャッシュをクリアしました。次回アクセス時に最新化されます!" };
}
2. フロントエンド(index.html)の実装
エディタの index.html を開き、以下のUIコードを貼り付けて保存します。
データがキャッシュから読み込まれたのか、スプレッドシートから直接取得されたのかが一目で分かる「パフォーマンスステータスバッジ」を搭載しています!
<!DOCTYPE html>
<html lang="ja">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<base target="_top">
<title>札幌オフィス 月次業績ダッシュボード</title>
<style>
* { box-sizing: border-box; margin: 0; padding: 0; }
body {
font-family: "Helvetica Neue", Arial, sans-serif;
background-color: #f0f4f8;
color: #2d3748;
padding: 30px 20px;
display: flex;
justify-content: center;
}
.card {
background: #ffffff;
max-width: 650px;
width: 100%;
border-radius: 12px;
box-shadow: 0 4px 16px rgba(0,0,0,0.06);
padding: 30px;
border-top: 5px solid #1a365d;
}
.header {
display: flex;
justify-content: space-between;
align-items: flex-start;
margin-bottom: 24px;
border-bottom: 1px solid #edf2f7;
padding-bottom: 16px;
}
h1 { font-size: 20px; color: #1a365d; }
.badge {
font-size: 11px;
font-weight: 700;
padding: 4px 10px;
border-radius: 12px;
}
.badge-cache { background: #c6f6d5; color: #22543d; border: 1px solid #9ae6b4; }
.badge-direct { background: #feebc8; color: #7b341e; border: 1px solid #fbd38d; }
.kpi-box {
background: #f7fafc;
border: 1px solid #e2e8f0;
border-radius: 8px;
padding: 24px;
text-align: center;
margin-bottom: 24px;
}
.kpi-title { font-size: 13px; color: #718096; font-weight: 600; margin-bottom: 6px; }
.kpi-value { font-size: 32px; font-weight: 700; color: #dd6b20; }
.detail-list {
list-style: none;
font-size: 13px;
line-height: 2;
margin-bottom: 24px;
}
.btn-refresh {
background: #edf2f7;
color: #4a5568;
border: 1px solid #cbd5e0;
padding: 8px 16px;
border-radius: 6px;
font-size: 12px;
font-weight: 700;
cursor: pointer;
transition: all 0.2s;
}
.btn-refresh:hover { background: #e2e8f0; }
</style>
</head>
<body>
<div class="card">
<div class="header">
<div>
<h1>🏢 札幌オフィス 月次売上モニター</h1>
<p style="font-size: 12px; color: #718096; margin-top: 4px;">最終集計: <?= salesSummary.lastUpdated ?></p>
</div>
<!-- キャッシュ有効判定バッジ -->
<span class="badge <?= salesSummary.fromCache ? 'badge-cache' : 'badge-direct' ?>">
<?= salesSummary.fromCache ? '⚡ キャッシュ高速描画' : '🐢 シート直接取得' ?>
</span>
</div>
<div class="kpi-box">
<div class="kpi-title">当月 確定売上高合計</div>
<div class="kpi-value"><?= salesSummary.formattedTotal ?></div>
<p style="font-size: 12px; color: #4a5568; margin-top: 4px;">総取引件数: <b><?= salesSummary.dealCount ?> 件</b></p>
</div>
<h3 style="font-size: 14px; margin-bottom: 12px; color: #2d3748;">📍 エリア別売上内訳</h3>
<ul class="detail-list">
<? for (var area in salesSummary.areas) { ?>
<li style="display: flex; justify-content: space-between; border-bottom: 1px dashed #edf2f7;">
<span><?= area ?></span>
<strong><?= Number(salesSummary.areas[area]).toLocaleString() ?> 円</strong>
</li>
<? } ?>
</ul>
<div style="text-align: right;">
<button class="btn-refresh" onclick="onForceRefresh()">🔄 キャッシュをクリアして再集計</button>
</div>
</div>
<script>
function onForceRefresh() {
if (!confirm("キャッシュを破棄してスプレッドシートから再読み込みしますか?")) return;
// 第87回で学んだ google.script.run でキャッシュクリアを実行!
google.script.run
.withSuccessHandler(function(res) {
alert(res.message);
location.reload(); // 画面をリロード
})
.refreshDashboardCache();
}
</script>
</body>
</html>
3. テスト用URL(/dev)で表示速度の違いを体感しよう!
エディタ右上の「デプロイ」>「デプロイをテスト」からテスト用URLを開いてみてください。
- 1回目のアクセス:
画面右上のバッジが黄色で「🐢 シート直接取得」と表示され、少しだけ間があってから画面が開きます。この瞬間に、GASが裏でデータをキャッシュに保存しました。 - 2回目のアクセス(F5キーでリロード!):
今度は画面を開いたその瞬間、まばたきをする間もなくパッと画面が表示され、右上のバッジが緑色で「⚡ キャッシュ高速描画」に切り替わっているはずです!
「スプレッドシートを開いている感」が完全に消え去り、一般的な商用Webサービスと全く遜色ない爆速ダッシュボードへと進化しましたね!
7. 実務で差がつく!CacheService活用のプロ技3選
キャッシュの基本がマスターできたら、実務の企業システムでシニアエンジニアが必ず取り入れている3つの発展テクニックを押さえておきましょう!
プロ技①:データの更新トリガーで「先回りキャッシュ破棄」
「キャッシュは速いけれど、スプレッドシート側で数値を手作業で修正したとき、最大30分間も古い数字が表示され続けるのは困る……」という場面がありますよね。
そんなときは、第22回で学んだ onEdit(e)(セル編集時トリガー) と組み合わせるのがプロの定番です!
/**
* スプレッドシートが手動編集されたら、自動で古いキャッシュを消去する!
*/
function onEdit(e) {
var sheet = e.range.getSheet();
// 「売上データ」シートが編集された場合のみキャッシュを破棄
if (sheet.getName() === "売上データ") {
var cache = CacheService.getScriptCache();
cache.remove("dashboard_sales_kpi");
Logger.log("売上データの変更を検知:キャッシュを自動破棄しました。");
}
}
これを入れておけば、「普段はキャッシュで爆速表示させつつ、人間がセルを1文字でも書き換えた瞬間にキャッシュが自動リセットされる」という、スピードと即時性を両立した完璧な運用が実現します!
プロ技②:100KB制限を突破する「チャンク分割テクニック」
GASの CacheService には、「1つのキーあたり最大100KB(約10万文字)」という容量制限があります。数千行の膨大なJSONデータを1つのキーに詰め込もうとすると、Argument too large というエラーで保存に失敗してしまいます。
大きなデータをキャッシュしたい場合は、文字列を50KBずつ分割(チャンク化)して複数のキー(sales_part_1, sales_part_2)に分けて保存し、取り出すときにガッチャンコと結合するテクニックを使います。
// 長大な文字列を100KB以下に分割してキャッシュに保存する例
function putLargeCache(key, largeString, seconds) {
var cache = CacheService.getScriptCache();
var chunkSize = 90000; // 安全のため90KBごとに分割
var totalChunks = Math.ceil(largeString.length / chunkSize);
// 分割して保存
for (var i = 0; i < totalChunks; i++) {
var chunk = largeString.substring(i * chunkSize, (i + 1) * chunkSize);
cache.put(key + "_" + i, chunk, seconds);
}
cache.put(key + "_count", String(totalChunks), seconds);
}
プロ技③:キー名に「バージョン番号」や「日付」を含めて管理する
システムの仕様変更で集計ロジックやJSONのプロパティ構造を変えたとき、キャッシュの中に古い構造のデータが残っていると、画面側のJavaScriptが壊れてエラーになることがあります。
キー名に dashboard_kpi_v2 のようにバージョン番号(v1, v2)や集計年月を含めておくことで、プログラム改修時のキャッシュ事故を100%防ぐことができます。
8. 初心者が100%つまずく!CacheServiceの5大トラップと完全対処法
CacheService を使い始めた開発者が必ずと言っていいほど直面する「5大落とし穴」をまとめました。エラーが出たときはまずここを確認してください!
トラップ1:オブジェクトや配列をそのまま put() して大惨事!
// ✕ 超危険!絶対に動かないNGコード
var dataObj = { total: 1500000 };
cache.put("my_key", dataObj); // オブジェクトをそのまま渡している!
// 取り出したとき
var result = cache.get("my_key");
// ➔ result の中身は "[object Object]" という文字列になってしまい、データが全滅する!
【解決策】
入れるときは必ず cache.put(key, JSON.stringify(dataObj))、出すときは JSON.parse(cache.get(key)) を徹底してください!
トラップ2:有効期限に「6時間(21600秒)」を超える数値を指定してエラー
「明日の朝まで24時間キャッシュさせたいから、86400秒にしておこう!」と設定すると、以下のエラーが発生します。
Exception: Invalid argument: expirationInSeconds (must be less than or equal to 21600)
【解決策】
指定できる最大秒数は 21600(=6時間) です。それ以上の長期保管をしたい場合は、第93回で学んだ PropertiesService(スクリプトプロパティ)や別シートへの保存を検討しましょう。
トラップ3:キャッシュ容量上限(100KB)オーバーによる Exception
スプレッドシートの数万行の生データをそのまま丸ごと JSON.stringify() して put() しようとすると、100KB制限を超えてスクリプトが停止します。
【解決策】
キャッシュに入れるのは「数万行の明細そのもの」ではなく、「集計後の合計金額」や「上位10件のランキング」など、計算済みのサマリーデータに絞り込んで軽量化してから保管するのが実務の鉄則です。
トラップ4:キー名の大文字・小文字、全角半角の不一致
保存するときに cache.put("Sales_Data", ...) と書いたのに、取り出すときに cache.get("sales_data") と小文字で指定していると、キャッシュが見つからず常に null(キャッシュミス)になってしまいます。キー名はすべて半角小文字スネークケース(例: sales_kpi_summary)で統一しましょう。
トラップ5:キャッシュは「絶対に残っているとは限らない」前提を忘れる
「さっき put() して1800秒に設定したから、絶対にデータが入っているはず!」と思い込み、var data = JSON.parse(cache.get(key)); とノーガードで書くと、Google側のサーバー負荷やメモリ再起動によって期限前にキャッシュが蒸発していた場合に data is null でクラッシュします。
【解決策】
必ず本記事のSTEP2のように、if (cachedData !== null) { ... } else { スプレッドシートから再取得 } という「空っぽだったときの退避ルート」をセットで書いておくのがプロの流儀です。
9. 今回のまとめ&次回予告
今回は、Google Apps Script製Webアプリケーションの表示速度を極限まで引き上げる CacheService.getScriptCache() の使い方と、Cache-Asideパターンによる実践チューニングを徹底解説しました!
本日の重要ポイントをもう一度おさらいしておきましょう。
- CacheService.getScriptCache() は、プロジェクト全体で共有される超高速な一時保管メモリ!
- スプレッドシートの重い読み込みをスキップすることで、表示速度が 数秒 ➔ 0.01秒台へ爆速化 する!
- キャッシュできるのは「文字列のみ」のため、入れるときは
JSON.stringify()、出すときはJSON.parse()が鉄則! - 保存期間は最大6時間(21600秒)、1キーあたり100KBまでの制約を意識する!
onEdit(e)と連動して古いキャッシュを破棄すれば、スピードとデータの正確性を完璧に両立できる!
ダッシュボードを開いた瞬間にパッと数字が表示される心地よさは、一度体験するともう二度と「毎回スプレッドシートを読みに行く重い処理」には戻れなくなりますよね!チームの仲間からも「えっ、このダッシュボードなんでこんなに速いの!?」と驚かれること間違いなしです。
さて、高速化のチューニングを極め、連載ロードマップもいよいよ残すところあと2回となりました!
次回は、複数人が同時にシステムを使う環境で絶対に防がなければならない「データの衝突事故」を防止する最重要技術に挑みます!
次回(第99回)のテーマは、
「LockService.getScriptLock() × 同時ボタンクリック時の『請求書番号の二重採番』を防止」 です!
月末の請求書発行ラッシュのとき、複数のメンバーがほぼ同時に「発行ボタン」を押してしまうと、同じ請求番号(INV-1005)が2人の取引先に二重発行されてしまうという致命的なトラブルが起きてしまいます。これをGoogleの「排他制御(ロック)」を使って1人ずつ順番に並ばせ、絶対に重複事故を起こさない頑丈なシステムへと仕上げていきます。感動の100回完結へ向けて、次回もぜひ楽しみに待っていてくださいね!
