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

ttCkpt

説明

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

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

デフォルトで、TimesTenはバックグラウンド・チェックポイントを一定間隔で実行します。

バックアップの実行中にアプリケーションがチェックポイント処理を実行しようとした場合、実行中のバックアップは、チェックポイント処理が終了するまで待機します。チェックポイント処理が、バックグラウンド・チェックポイント、またはアプリケーションで要求されたチェックポイントのどちらの場合でも、次のように処理されます。

バックアップまたはチェックポイント処理の実行中に、ユーザーがバックアップを実行しようとした場合は、実行中のバックアップまたはチェックポイント処理の終了を待ちます。

バックアップまたはチェックポイント処理の実行中に、チェックポイント処理を実行しようとした場合は、実行中の処理が終了するのを待たずに、即座にエラーが返されます。

バックグラウンド・チェックポイントを無効にするには、CkptFrequency=0およびCkptLogVolume=0を設定します。

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

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

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

アクセス制御

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

構文

ttCkpt (timeout, retries)

パラメータ

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


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

結果セット

ttCkptは結果を返しません。

例

CALL ttCkpt();

CALL ttCkpt(1,10);

注意

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

ttCkpt

説明

アクセス制御

構文

パラメータ

結果セット

例

注意

関連項目