Oracle TimesTen In-Memory Database APIおよびSQLリファレンス・ガイド

ttCkpt

説明

ディスクへのロギングが有効になっている場合に、非ブロッキング・チェックポイントを実行します。ロギングがオフの場合、またはディスクレス・ロギングを使用している場合、このルーチンはブロッキング・チェックポイントを実行します。ブロッキング・チェックポイントについては、「ttCkptBlocking」で説明されています。詳細は、「ttCkptBlocking」を参照してください。チェックポイント処理は、データ・ストアの現在の状態をディスクに保存し、ログ・ファイルを削除するために行われます。非ブロッキング・チェックポイントでは、データ・ストアに対するロックは必要ありません。

アプリケーションでは、データ・ストアに対して定期的にチェックポイントを実行する必要があります。それには、バックグラウンド・チェックポイント属性（CkptFrequencyおよびCkptLogVolume）を設定するか、このプロシージャを明示的に呼び出します。

TimesTenは、バックグラウンド・チェックポイントを一定間隔で実行するようにデフォルト設定されています。アプリケーションからチェックポイント処理を実行しようとしたときに、バックグラウンド・チェックポイントが実行中だった場合、その処理が終了するのを待ってからアプリケーションによるチェックポイントが実行されます。バックグラウンド・チェックポイントを無効にするには、CkptFrequency=0およびCkptLogVolume=0に設定します。

このプロシージャは、データ・ストアで実行されている他のどのアプリケーションに対しても、非同期で呼び出すことができます。

データ・ストアに障害が発生したとき、ディスク上のチェックポイントが非ブロッキング・チェックポイントだった場合、TimesTenはログ・ファイルを使用してリカバリを行います。このため、ディスクへのロギングがオフの場合は非ブロッキング・チェックポイントを使用できません。

このプロシージャは非ブロッキングであるため、タイムアウトおよび再試行パラメータは、ディスクへのロギングを行わないアプリケーションでのみ使用されます。この場合、このルーチンはブロッキング・チェックポイントを実行します。使用方法は、「ttCkptBlocking」を参照してください。

アクセス制御

アクセス制御がTimesTenのインスタンスに対して有効である場合、このプロシージャにはADMIN権限が必要です。

構文

ttCkpt (timeout, retries)

パラメータ

ttCkptには、次のオプションのパラメータがあります。


パラメータ	データ型	説明
timeout	INTEGER	ttCkptがタイムアウトする前にデータ・ストア・ロックを取得するために待機する時間（秒）。timeoutの値は0から1,000,000です。指定しない場合、デフォルトで無制限になり、チェックポイントのタイムアウトは発生しません。プロシージャは、チェックポイントがブロッキングである場合、つまりディスクへのロギングが有効ではない場合にのみ、この値を使用します。
retries	INTEGER	タイムアウトが発生した場合にttCkptがデータ・ストア・ロックを取得しようとする回数。retriesの値は0から10です。指定しない場合、デフォルトは0です。プロシージャは、チェックポイントがブロッキングである場合、つまりディスクへのロギングが有効ではない場合にのみ、この値を使用します。

結果セット

ttCkptは結果を返しません。

例

CALL ttCkpt(); 
CALL ttCkpt(1,10);

注意

チェックポイントの詳細は、TimesTenの開発者ガイドのトランザクションの管理とリカバリに関する章を参照してください。