sa_clean_database( [ duration ] )

データベースクリーナーは、デフォルトのスケジュールで実行される内部タスクです。このシステムプロシージャーを使用すると、データベースクリーナーを強制的にただちに実行したり、クリーナーの起動のたびにその実行時間を指定したりできます。データベースの検証中にこのシステムプロシージャーを使用してデータベースクリーナーを起動した場合、検証が完了するまでデータベースクリーナーは実行されません。

要求の一部を後で実行すると、スナップショットアイソレーショントランザクション、インデックス管理、ローの削除などのデータベースタスクをより効率的に実行できます。このような後回しにできるアクティビティには、一般的に、削除済みエントリ、履歴エントリなどの不要なエントリをデータベースページから削除することによるクリーンアップや、アクセス効率を上げるためのデータベースページの再編成などがあります。

こうしたアクティビティを後で実行することにより、現在の要求がより高速に処理されるだけでなく、データベースサーバーの負荷が軽いときにクリーンアップを実行する余地が生まれます。不要なエントリが区別されて、他のトランザクションから認識できなくなりますが、ページ上の領域は使用しているので、いつかは削除する必要があります。

データベースクリーナーは、後回しにされたクリーンアップアクティビティを実行します。データベースクリーナーは、20 秒ごとに実行されるようスケジュールされています。起動されると、データベースを DB 領域全体にわたって順次読み出し、クリーンアップ可能なページを検証してクリーニングし、次のページへ移ります。データベースクリーナーは、データベースサーバーによって自動的に起動された場合は、セルフチューニングプロセスになります。データベースクリーナーによる作業量と実行時間は、DB 領域内の未処理のクリーンアップ可能ページの割合、データベースサーバーの現在のアクティビティ量、データベースクリーナーがすでにクリーニングに費やした時間など、いくつかの要因に左右されます。0.5 秒間実行した後に、クリーナーがサーバーでアクティブな要求を検出した場合、クリーナーは停止し、通常の間隔で実行するよう自らをスケジュールし直します。データベースクリーナーは、サーバーで実行されている要求が他にないときにページ処理を試行することで、サーバーの休止時間を活用します。

データベースクリーナーの統計情報は、次の 4 つのデータベースプロパティから取得できます。

CleanablePagesAdded 値と CleanablePagesCleaned 値の差は、クリーニングが必要な残りのデータベースページ数を示します。

sa_clean_database システムプロシージャーを使用すると、データベースクリーナーをデータベース内のすべてのページがクリーンアップされるまで実行したり、データベースクリーナーの実行時間の上限を指定したりできます。

データベースクリーナーの動作をさらにカスタマイズするには、クリーンアップが必要なページ数やロー数が指定したしきい値を超えたらデータベースクリーナーを起動するイベントを設定します。

DBA 権限。

なし。

• CREATE EVENT 文
• CleanablePagesAdded データベースプロパティ
• CleanablePagesCleaned データベースプロパティ
• CleanableRowsAdded データベースプロパティ
• CleanableRowsCleaned データベースプロパティ

次の例では、データベースクリーナーの実行時間を 10 秒に設定します。

CALL sa_clean_database( 10 );

次の例では、データベースクリーナーを毎日実行してデータベース内のすべてのページをクリーンアップするようスケジュールされたイベントを作成します。

CREATE EVENT DailyDatabaseCleanup
SCHEDULE
   START TIME '6:00 pm'
   ON ( 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday' )
   HANDLER
      BEGIN
         CALL sa_clean_database( );
      END;

次の例では、データベース内のページの 20% 以上でクリーンアップが必要になるとデータベースクリーナーを強制的に実行します。

CREATE EVENT PERIODIC_CLEANER
SCHEDULE
BETWEEN '9:00 am' and '5:00 pm'
EVERY 1 HOURS
HANDLER
BEGIN
     DECLARE @num_db_pages INTEGER;
     DECLARE @num_dirty_pages INTEGER;

     -- Get the number of database pages
     SELECT (SUM( DB_EXTENDED_PROPERTY( 'FileSize', t.dbspace_id ) - 
                     DB_EXTENDED_PROPERTY( 'FreePages', t.dbspace_id ) ))
     INTO @num_db_pages
     FROM (SELECT dbspace_id FROM SYSDBSPACE) AS t;

     -- Get the number of dirty pages to be cleaned
     SELECT (DB_PROPERTY( 'CleanablePagesAdded' ) - 
                     DB_PROPERTY( 'CleanablePagesCleaned' ))
     INTO @num_dirty_pages;

     -- Check whether the number of dirty pages exceeds 20% of
     -- the size of the database
     IF @num_dirty_pages > @num_db_pages * 0.20 THEN
       -- Start cleaning the database for a maximum of 60 seconds
       CALL sa_clean_database( 60 );
     END IF;
END;