openpyxlでデータ抽出を効率化！auto_filter.refでフィルターを自動適用する方法

はじめに：Excelを開いてからの「一手間」を自動化する
1. この記事で、あなたのExcel出力は「次の一歩」へ
2. auto_filter.refが効率化の鍵
auto_filterの基本的な使い方と設定
1. 結論：ws.auto_filter.ref = "範囲" と書くだけ
2. 最重要ポイント：範囲は「ヘッダー行」から始める
【実践コード】データ出力からフィルター適用まで
openpyxlのフィルター機能に関する注意点
まとめ：データ抽出の「始点」を自動化しよう

はじめに：Excelを開いてからの「一手間」を自動化する

Pythonを使って大量のデータを処理し、Excelファイルに出力する。ここまでは多くの人が実践していることでしょう。しかし、そのExcelファイルを受け取った人は、次に何をするでしょうか？

おそらく、まず始めに「フィルター」を設定して、自分が見たいデータ（例えば特定の担当者や商品カテゴリなど）を抽出しようとするはずです。この**「ファイルを開いて、データ範囲を選択し、フィルターを設定する」という一手間**を、Pythonで自動化できるのがopenpyxlのauto_filter機能です。

この記事で、あなたのExcel出力は「次の一歩」へ

この記事を読めば、あなたのPythonスクリプトは、単にデータを書き出すだけでなく、受け取った人がすぐにデータ抽出や分析を始められる、より気の利いたExcelファイルを生成できるようになります。

auto_filter.refを使ったフィルターの基本的な設定方法
フィルター範囲を指定する際の重要なポイント
具体的なサンプルコードと、その動作原理

データ抽出の効率を上げるauto_filterの使い方をマスターし、あなたの自動化スクリプトをレベルアップさせましょう。

auto_filter.refが効率化の鍵

openpyxlでは、ワークシートオブジェクトが持つauto_filter.refという属性にセル範囲を文字列で設定するだけで、Excelのオートフィルター機能を有効にできます。

これにより、ヘッダー行にドロップダウン式の矢印（▼）が自動で追加され、ユーザーはファイルを開いてすぐにデータの並べ替えや絞り込みを行えるようになります。

auto_filterの基本的な使い方と設定

オートフィルターの設定は非常に直感的です。覚えることは、基本的にauto_filter.refプロパティだけです。

結論：ws.auto_filter.ref = "範囲" と書くだけ

フィルターを設定したいワークシートオブジェクト（ここではwsとします）に対して、auto_filter.refにフィルターを適用したい範囲を文字列で代入します。

# 'A1'セルから'E50'セルまでの範囲にフィルターを適用
ws.auto_filter.ref = "A1:E50"

この一行だけで、指定範囲の先頭行（この場合は1行目）にフィルターコントロールが設置されます。

最重要ポイント：範囲は「ヘッダー行」から始める

refに指定する範囲は、必ずヘッダー行を含めたデータ全体の範囲を指定する必要があります。

openpyxlは、指定された範囲の最初の行をヘッダーとみなし、そこにフィルターボタンを自動的に配置します。もしヘッダー行を含めずにデータ部分（例："A2:E50"）だけを指定してしまうと、データの一行目（A2, B2, …）がヘッダーとして扱われてしまうため、意図した通りの結果になりません。

【実践コード】データ出力からフィルター適用まで

では、実際にデータを書き出し、そのデータ範囲にオートフィルターを適用する一連の処理をコードで見ていきましょう。

Step 1: データの準備とExcelへの書き込み

まず、サンプルとなるデータをopenpyxlで新しいExcelシートに書き込みます。

from openpyxl import Workbook

# 新しいワークブックとシートを作成
wb = Workbook()
ws = wb.active
ws.title = "TaskReport"

# ヘッダーとサンプルデータを定義
task_data = [
    ['プロジェクトID', 'タスク名', '担当者', 'ステータス'],
    ['P-001', '要件定義', '佐藤', '完了'],
    ['P-001', '基本設計', '鈴木', '作業中'],
    ['P-002', '画面デザイン', '佐藤', '完了'],
    ['P-001', '詳細設計', '鈴木', '未着手'],
    ['P-002', 'ロゴ作成', '高橋', '作業中']
]

# シートにデータを追記
for row in task_data:
    ws.append(row)

この時点では、フィルターはまだ設定されていません。

Step 2: auto_filter.refでフィルターを適用

次に、今書き込んだデータの範囲（この場合はA1からD6）に対してauto_filter.refを設定します。

# オートフィルターを適用する範囲を指定
# ヘッダー行(A1)からデータ最終行(D6)まで
filter_range = "A1:D6"

# フィルターを設定
ws.auto_filter.ref = filter_range

# ファイルを保存
wb.save("task_report_filtered.xlsx")

print(f"ファイル 'task_report_filtered.xlsx' を作成し、範囲 {filter_range} にフィルターを適用しました。")