Statspackレポートの作成方法を丁寧に解説！〜spreport.sqlの使い方〜

AWR/statspack
2025.04.20

Oracle Databaseの性能を分析する上で、Statspackは非常に有用なツールです。
特に、「spreport.sql」 を使って出力されるレポートは、どの処理がボトルネックかを可視化するための強力な材料になります。

この記事では、Statspackでスナップショットを取得済みであることを前提に、レポート作成の方法と実行例、確認すべきポイントまでを解説します。

Statspackとは？SEでも使えるOracle性能診断ツールの基本と活用法
Oracleのパフォーマンス分析というと「AWR（Automatic Workload Repository）」が思い浮かぶかもしれませんが、AWRはEnterprise Edition（EE）限定で、Diagnostic Packのライセ...
oracle-master00000.com
2025.04.18

💰 【PR】Oracleエンジニアの市場価値、調べてみませんか？

Oracleのスキルは需要が高く、特定の資格や経験を持っていると年収が大幅にアップするケースがあります。まずはIT専門のエージェントで非公開求人をチェックしてみませんか？

✅ 記事で解説する内容

  • spreport.sql の実行方法
  • スナップショットIDの調べ方
  • レポートの出力先と保存形式
  • よく見る項目の紹介

🧾 1. spreport.sql とは？

spreport.sql は、2つのスナップショット（開始と終了）を指定して、その期間のOracleインスタンスの統計情報を比較・分析レポートとして出力するSQLスクリプトです。

$ORACLE_HOME/rdbms/admin/spreport.sql

このスクリプトをSQL*Plusで実行することで、Statspackレポート（プレーンテキスト形式）が作成されます。

🔍 2. スナップショットID（snap_id）の確認方法

まず、レポート作成の対象となるスナップショットIDを確認しましょう。
stats$snapshot 表に記録されています。

SELECT snap_id,
       TO_CHAR(snap_time, 'YYYY-MM-DD HH24:MI') AS snap_time
  FROM stats$snapshot
 ORDER BY snap_id DESC;

📌 出力例：

SNAP_IDSNAP_TIME
1202025-04-04 10:00
1192025-04-04 09:00
1182025-04-04 08:00

🖥️ 3. spreport.sql の実行方法

📌 手順

  1. SQL*Plus で PERFSTAT ユーザーまたは SYSDBA でログイン
sqlplus perfstat/perfstat
  1. スクリプトを実行
@?/rdbms/admin/spreport.sql
  1. 以下のように 開始と終了のスナップショットID を尋ねられます。
Enter value for begin_snap: 119
Enter value for end_snap: 120
  1. レポートファイルの出力ファイル名を入力（またはEnterでデフォルト）
Enter report name: report_119_120.lst
  1. レポート生成完了！
Report written to report_119_120.lst
SQL> conn perfstat/perfstat
接続されました。
SQL> SELECT snap_id,
  2         TO_CHAR(snap_time, 'YYYY-MM-DD HH24:MI') AS snap_time
  3    FROM stats$snapshot
  4   ORDER BY snap_id DESC;

   SNAP_ID SNAP_TIME
---------- ------------------------------------------------
         6 2025-04-06 18:00
         5 2025-04-06 17:00
         4 2025-04-06 16:00
         3 2025-04-06 15:00
         2 2025-04-06 14:00
         1 2025-04-06 13:00

6行が選択されました。

SQL> @?/rdbms/admin/spreport.sql  ★
SQL> Rem
SQL> Rem $Header: rdbms/admin/spreport.sql /main/14 2017/05/28 22:46:11 stanaya Exp $
SQL> Rem
SQL> Rem spreport.sql

:

SQL> set echo off feedback off pagesize 60 newpage 1 recsep off;


Instances in this Statspack schema
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

   DB Id    Inst Num DB Name      Instance     Host
----------- -------- ------------ ------------ ------------
 2960846808        1 V19          v19          restart

Using 2960846808 for database Id
Using          1 for instance number


Specify the number of days of snapshots to choose from
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Entering the number of days (n) will result in the most recent
(n) days of snapshots being listed.  Pressing <return> without
specifying a number lists all completed snapshots.



Listing all Completed Snapshots

                                                       Snap
Instance     DB Name        Snap Id   Snap Started    Level Comment
------------ ------------ --------- ----------------- ----- --------------------
v19          V19                  1 06 4月  2025 13:0     5
                                    0
                                  2 06 4月  2025 14:0     5
                                    0
                                  3 06 4月  2025 15:0     5
                                    0
                                  4 06 4月  2025 16:0     5
                                    0
                                  5 06 4月  2025 17:0     5
                                    0
                                  6 06 4月  2025 18:0     5
                                    0



Specify the Begin and End Snapshot Ids
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
begin_snapに値を入力してください: 3  ★開始位置を指定
Begin Snapshot Id specified: 3

end_snapに値を入力してください: 4  ★終了位置を指定
End   Snapshot Id specified: 4



Specify the Report Name
~~~~~~~~~~~~~~~~~~~~~~~
The default report file name is sp_3_4.  To use this name,
press <return> to continue, otherwise enter an alternative.

report_nameに値を入力してください: sp01.txt  ★レポート名を指定

Using the report name sp01.txt

:

init.ora Parameters  DB/Inst: V19/v19  Snaps: 3-4

                                                                  End value
Parameter Name                Begin value                       (if different)
----------------------------- --------------------------------- --------------
audit_file_dest               /u01/app/oracle/admin/v19/adump
audit_trail                   DB
compatible                    19.0.0
control_files                 +DATA/V19/CONTROLFILE/current.261
                              .1157469593
db_block_size                 8192
db_create_file_dest           +DATA
db_name                       v19
diagnostic_dest               /u01/app/oracle
dispatchers                   (PROTOCOL=TCP) (SERVICE=v19XDB)
local_listener                LISTENER_V19
nls_language                  JAPANESE
nls_territory                 JAPAN
open_cursors                  300
pga_aggregate_target          382730240
processes                     300
remote_login_passwordfile     EXCLUSIVE
sga_target                    1157627904
undo_tablespace               UNDOTBS1
          -------------------------------------------------------------

End of Report ( sp01.txt )

SQL> exit
Oracle Database 19c Enterprise Edition Release 19.0.0.0.0 - Production
Version 19.3.0.0.0との接続が切断されました。
[oracle@restart ~]$ ls
sp01.txt  ★カレントディレクトリに出力
[oracle@restart ~]$

💰 【PR】Oracleエンジニアの市場価値、調べてみませんか？

Oracleのスキルは需要が高く、特定の資格や経験を持っていると年収が大幅にアップするケースがあります。まずはIT専門のエージェントで非公開求人をチェックしてみませんか？

📂 4. レポートファイルの保存先と形式

  • 保存形式：プレーンテキスト（.lst）
  • 保存場所：SQL*Plusを起動したカレントディレクトリ
    • 例：Linuxなら ~/, Windowsなら C:\app\oracle\product\...\BIN など

📌 ファイルはテキストエディタでそのまま閲覧可能です。

👀 5. レポートの見どころ（ざっくり）

Statspackレポートは情報量が非常に多いですが、特に以下の項目を最初に確認するとよいでしょう。

セクション名内容チェックポイント
Top 5 Timed Events時間がかかった上位5つのイベントCPUやI/O待ちの多さを確認
Instance Efficiency Percentagesキャッシュの効率などライブラリキャッシュやバッファキャッシュの命中率
SQL ordered by Gets/Reads/Executions負荷の高いSQL文調査対象のSQL文があるかどうか
Load Profile平均処理量などRedo生成量、物理読み取り数など

📘 テキスト図：spreport.sqlの流れ

【spreport.sql 実行イメージ】

┌────────────────────┐
│ stats$snapshot表のsnap_id確認 │
└────────┬──────────┘
         ▼
┌────────────────────┐
│ SQL*Plusでspreport.sql実行 │
└────────┬──────────┘
         ▼
┌────────────────────┐
│ 開始・終了snap_idを指定     │
└────────┬──────────┘
         ▼
┌────────────────────┐
│ レポートファイル（.lst）出力 │
└────────────────────┘

✅ まとめ

ポイント内容
spreport.sql はスナップショット差分の性能レポートを生成するスクリプト
必要なのは「開始」と「終了」の snap_id
出力はプレーンテキストで、すぐに開いて確認可能
最初は「Top 5 Timed Events」や「SQLの統計情報」に注目するとよい


[参考]
Oracle® Databaseパフォーマンス・チューニング・ガイド 19c

Oracle SQLチューニングの基本Oracle SQLチューニング最短ガイド：実行計画・統計・トレース【19c】Oracle SQLチューニングの基本
本記事は、既存記事「Oracle SQLチューニングの基本」の内容を、より実務寄り・再現可能な形に再構成したリライト版です。元記事の主旨（実務で使えるSQLチューニングの要点）を保ちつつ、最短手順・再現用スクリプト・トラブル対処を強化しまし...
oracle-master00000.com
2024.11.27

💰 【PR】Oracleエンジニアの市場価値、調べてみませんか？

Oracleのスキルは需要が高く、特定の資格や経験を持っていると年収が大幅にアップするケースがあります。まずはIT専門のエージェントで非公開求人をチェックしてみませんか？

コメント

タイトルとURLをコピーしました