【GAS】スプレッドシートの最終行を動的に取得！getLastRow()徹底解説

2020-07-17 / 2025-11-20

Google Apps Script (GAS) を用いたスプレッドシートの自動化において、「データが存在する最終行」を正確に把握することは、スクリプトの柔軟性と効率性を高める上で不可欠です。getLastRow() メソッドは、データの増減に自動対応し、処理のミスを防ぐ強力なツールとなります。

本記事では、GASのgetLastRow()の基本的な使い方から、データの追加・更新、ループ処理、一括処理によるパフォーマンス最適化、さらにはエラーハンドリングといった実務的な活用例まで、具体的なコードを交えて徹底解説します。getLastRow()をマスターし、スプレッドシート作業の自動化を次のレベルへと引き上げましょう。

Google Apps Script 始め方スプレッドシート活用例を各ショップで検索

楽天市場で探す Amazonで探す Yahoo!ショッピングで探す

`getLastRow()`メソッドとは？基本を理解しよう

getLastRow()メソッドは、スプレッドシートのシート内でデータが入力されている「最後の行番号」を取得するための機能です。例えば、A1セルからD6セルまでデータが存在する場合、このメソッドが返す最終行番号は 6 となります。

基本的な使い方

最もシンプルな使い方は以下の通りです。

const sheet = SpreadsheetApp.getActiveSheet();
const lastRow = sheet.getLastRow();

この2行のコードだけで、現在アクティブなシートの最終行番号を取得できます。これにより、新しいデータを追記する位置を動的に決定することが可能になります。

動作の仕組み

getLastRow()は、シート内の全列を対象に、データが入力されている最も下の行番号を返します。書式設定のみが適用され、値が入力されていないセルは無視されるため、データの有無に関わらず正確な最終行を特定できます。

実践的な活用シーン

データの最終行を取得する

特定のシート（例：「SalesData」）の最終行を取得する具体的なコードを見てみましょう。

function logLastRow() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('SalesData');
  if (sheet) {
    const lastRow = sheet.getLastRow();
    console.log(`データは ${lastRow} 行目で終わっています`);
  } else {
    console.log('指定されたシートが見つかりません。');
  }
}

このスクリプトを実行すると、指定したシートの最終行番号がコンソールに表示されます。実務では、この値を利用してデータの追記や処理範囲の決定を行います。

ループ処理での活用

getLastRow()はループ処理と組み合わせることで真価を発揮します。以下のコードは、シートの1行目から最終行までを順番に処理する例です。

function processAllRows() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const lastRow = sheet.getLastRow();
  
  // getRange()をループ内で使うのはパフォーマンスが悪いので注意
  for (let i = 1; i <= lastRow; i++) {
    const rowData = sheet.getRange(i, 1).getValue(); // 1列目のデータを取得
    console.log(rowData);
  }
}

この方法で、データ量に応じた柔軟な処理を実装できます。

パフォーマンスを考慮した高度な使い方

データの一括処理でパフォーマンスを向上

大量のデータを扱う場合、一行ずつセルにアクセスすると処理に時間がかかります。getValues()を使って範囲内のデータを一括で読み込み、メモリ上で処理することでパフォーマンスを大幅に改善できます。

function optimizePerformance() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const lastRow = sheet.getLastRow();
  
  if (lastRow === 0) return; // データがない場合は終了
  
  // データの一括読み込み
  const data = sheet.getRange(1, 1, lastRow, 15).getValues();
  
  // メモリ上でデータを加工
  const processedData = data.map(row => {
    // ここで各行のデータ加工処理を実装
    return row; // 例としてそのまま返す
  });
  
  // 加工したデータを一括で書き込み
  sheet.getRange(1, 16, processedData.length, processedData[0].length)
       .setValues(processedData);
}

この手法は、APIの呼び出し回数を最小限に抑え、スクリプトの実行時間を短縮する上で非常に効果的です。

エラーハンドリングで安定性を高める

スクリプトを安定して動作させるためには、適切なエラーハンドリングが不可欠です。例えば、データが存在しないシートに対して処理を実行しようとするとエラーが発生する可能性があるため、例外処理を追加します。

function safeGetLastRow() {
  try {
    const sheet = SpreadsheetApp.getActiveSheet();
    const lastRow = sheet.getLastRow();
    
    if (lastRow === 0) {
      throw new Error('シートにデータがありません');
    }
    
    return lastRow;
    
  } catch (error) {
    console.error(`エラーが発生しました: ${error.message}`);
    return null;
  }
}