Oracle TimesTen In-Memory Database C開発者およびリファレンス・ガイド

カテゴリ別のXLA関数の概要

TimesTen XLAは、データ・ストアへの更新を検出するために使用したり、独自のレプリケーション・ソリューションを構築するツールキットとして使用できます（「XLAとTimesTenイベント管理」を参照）。XLAは、永続モードまたは非永続モードのいずれでも初期化できます。

この項では、XLA関数をその使用方法を基準に分類し、各関数について簡単に説明します。XLA関数には、次のカテゴリがあります。

XLA永続モード関数

XLAコア関数（これらの関数は他のすべてのカテゴリに適用されます）

XLA非永続モード関数

XLAレプリケーション関数

XLA永続モード関数

「XLAコア関数」に示されているXLAコア関数に加えて、永続モードでXLAを排他的に処理する関数には、次の関数があります。


関数	説明
ttXlaPersistOpen	永続モードでトランザクション・ログにアクセスするためにTimesTenデータ・ストアへのハンドルを初期化します。
ttXlaAcknowledge	1つ以上のトランザクション更新レコードをログから取得したことを確認します。
ttXlaDeleteBookmark	トランザクション・ログ・ブックマークを削除します。
ttXlaGetLSN	データ・ストアのブックマークの現行読取りLSNを取得します。
ttXlaSetLSN	データ・ストアのブックマークの現行読取りLSNを設定します。

これらの関数の使用方法については、「XLAイベント・ハンドラ・アプリケーションの作成」を参照してください。

XLAコア関数

次のXLAコア関数は、永続モードまたは非永続モードのいずれのモードのXLAアプリケーションでも使用できます。


関数	説明
ttXlaNextUpdate	TimesTenから一連の更新を取得します。
ttXlaNextUpdateWait	TimesTenから一連の更新を取得します。使用可能な更新がログにない場合は、指定した時間待機します。
ttXlaClose	ttXlaPersistOpenまたはttXlaOpenTimesTenによってオープンされたXLAハンドルをクローズします。
ttXlaError	エラー情報を取得します。
ttXlaErrorRestart	エラー・スタック情報をリセットします。
ttXlaGetColumnInfo	表のすべての列に関する情報を取得します。
ttXlaGetTableInfo	表に関する情報を取得します。
ttXlaTableByName	所有者および名前が指定された表のシステム表識別子およびユーザー表識別子を検出します。
ttXlaTableStatus	表のXLAステータスを設定および取得します。
ttXlaDateToODBCCType	XLAのDATE値をアプリケーションで使用可能なODBC C値に変換します。
ttXlaDecimalToCString	XLAのDECIMAL値をアプリケーションで使用可能なODBC C値に変換します。
ttXlaTimeToODBCCType	トランザクション・ログのTIME値をアプリケーションで使用可能なODBC C値に変換します。
ttXlaTimeStampToODBCCType	トランザクション・ログのTIMESTAMP値をアプリケーションで使用可能なODBC C値に変換します。
ttXlaGetVersion	XLAの現行のバージョンを取得します。
ttXlaSetVersion	使用するXLAのバージョンを設定します。
ttXlaVersionCompare	2つのXLAバージョンを比較します。

これらの関数の使用方法については、「XLAイベント・ハンドラ・アプリケーションの作成」を参照してください。

XLA非永続モード関数

注意: TimesTenでは、永続モードでXLAを使用することをお薦めします。

「XLAコア関数」に示されているXLAコア関数に加えて、非永続モードでXLAを排他的に処理する関数には、次の関数があります。


関数	説明
ttXlaOpenTimesTen	非永続モードでトランザクション・ログにアクセスするためにTimesTenデータ・ストアへのハンドルを初期化します。
ttXlaConfigBuffer	XLAステージング・バッファのサイズを設定します。
ttXlaStatus	現在のXLAのステータスを取得します。
ttXlaResetStatus	XLAの統計カウンタをすべてリセットします。

これらの関数の使用方法については、「非永続モードでのXLAの使用」を参照してください。

XLAレプリケーション関数

XLAコア関数に関する項に示されているXLAコア関数に加えて、レプリケーション・メカニズムとしてXLAを排他的に処理する関数には、次の関数があります。


関数	説明
ttXlaApply	XLAハンドルに関連付けられているデータ・ストアまたはデータベースに更新を適用します。
ttXlaTableCheck	送信側のデータ・ストアから受信した表記述内の指定した表が、受信側のデータ・ストアと互換性があることを検証します。
ttXlaLookup	特定のキー値を持つ表の更新レコードを検索します。
ttXlaRollback	トランザクションをロールバックします。
ttXlaCommit	トランザクションをコミットします。
ttXlaGenerateSQL	更新レコードの結果を表現するSQL文を生成します。

これらの関数の使用方法については、「レプリケーション・メカニズムとしてのXLAの使用」を参照してください。