JetOpenTempTable 関数

適用対象: Windows |Windows Server

JetOpenTempTable 関数

JetOpenTempTable 関数は、1 つのインデックスを持つ一時テーブルを作成します。 一時テーブルは、 JetCreateTableColumnIndex を使用して作成された通常のテーブルと同様に、レコードを格納および取得します。 ただし、一時テーブルは揮発性のため、通常のテーブルよりもはるかに高速です。 また、純粋にシーケンシャルな方法でアクセスした場合に、レコード セットを非常に迅速に並べ替えて重複除去を実行するためにも使用できます。

    JET_ERR JET_API JetOpenTempTable(
      __in          JET_SESID sesid,
      __in          const JET_COLUMNDEF* prgcolumndef,
      __in          unsigned long ccolumn,
      __in          JET_GRBIT grbit,
      __out         JET_TABLEID* ptableid,
      __out         JET_COLUMNID* prgcolumnid
    );

パラメーター

sesid

使用するセッション。

prgcolumndef

一時テーブルに作成された列の列定義。

一時テーブルで使用される列定義オプションには、重要な制限があります。 詳細については、次の「解説」を参照してください。

通常の列定義オプションに加えて、一時テーブルのコンテキストにのみ関連する次のオプションを 0 個以上指定することもできます。

ccolumn

「prgcolumndef」を参照してください。

grbit

次のオプションの 0 個以上を指定するビットのグループ。

ptableid

新しく作成された一時テーブルで開かれた新しいカーソルを受け取る出力バッファー。

prgcolumnid

一時テーブルの作成時に生成された列 ID の配列を受け取る出力バッファー。

この配列の列 ID は、列定義の入力配列に正確に対応します。 その結果、このバッファーのサイズは入力配列のサイズに対応している必要があります。

戻り値

この関数は、次のいずれかのリターン コードを使用して 、JET_ERR データ型を返します。 考えられる ESE エラーの詳細については、「 拡張可能ストレージ エンジン エラー 」および「 エラー処理パラメーター」を参照してください。

成功すると、新しく作成された一時テーブルで開かれたカーソルが返されます。 一時データベースの状態は、新しい一時テーブルを格納するように準備されます。 データベース エンジンによって使用されている通常のデータベースの状態は変更されません。

失敗した場合、一時テーブルは作成されず、カーソルは返されません。 一時データベースの状態は変更される場合があります。 データベース エンジンによって使用されている通常のデータベースの状態は変更されません。

解説

一時テーブルでは、通常データベース エンジンでサポートされている列定義オプションの完全な補完はサポートされていません。 実際には、JET_bitColumnFixedとJET_bitColumnTaggedのみがサポートされています。 つまり、一時テーブルに自動インクリメント、バージョン、または複数値の列を作成することはできません。 最後に、エスクロー更新列は、一度に 1 つのセッションでのみ使用できるため、一時テーブルでは役に立たないため、サポートされていません。 これらのオプションのいずれかが要求された場合、それらは無視されます。

一時テーブルでは既定値はサポートされていません。 既定値の指定を含む列定義が指定されている場合、その指定は無視されます。

一時テーブルは、さまざまな ESE 関数の結果として呼び出し元に返されます。 たとえば、InfoLevel パラメーターに JET_IdxInfo オプションを設定した JetGetIndexInfo は、特定のインデックス内のすべてのキー列のリストを含む一時テーブルを返します。 一時テーブルは、ここで説明する通常の一時テーブルと同じライフサイクル ルールに従います。

一時テーブルは、多くのタスクに対してデータベース エンジンによって内部的に使用されます。 これらのタスクの中で最も重要なのは、既存のテーブルに対するインデックスの作成です。 一時テーブルは、そのインデックスの作成に使用されるインデックス キーの並べ替えに使用されます。

すべての一時テーブルは一時データベースに格納されます。 一時データベースは、ESE インスタンスの有効期間中に保持され、そのインスタンスがシャットダウンまたは再起動されると削除される特殊なデータベース ファイルです。 一時データベースの場所は、 JetSetSystemParameter と JET_paramTempPathを使用して構成できます。 アプリケーションで一時テーブルを頻繁に使用したり、インデックスを頻繁に作成したりする場合は、トランザクション ログ ファイルとデータベース ファイルに対する一時データベースのディスクへの配置が重要な場合があります。

一時テーブルのライフサイクルは、一時テーブルを参照するカーソルに関連付けられます。 一時テーブルを参照するすべてのカーソルが暗黙的または明示的に閉じられている場合、一時テーブルは削除されます。 一時テーブルがトランザクション内に作成され、その後そのトランザクションがロールバックされた場合、この時点で一時テーブルを参照していたカーソルは暗黙的に閉じられるため、一時テーブルは削除されます。 新しいカーソルは、 JetDupCursor を使用する場合にのみ一時テーブルを参照できます。 この場合、新しいカーソルは一時テーブルの最初のインデックス エントリに配置されます。 JetDupCursor は、一時テーブルの特定の使用フェーズでのみ機能します。 詳細については、一時テーブル・カーソル機能に関する解説を参照してください。 一度に複数のセッションから一時テーブルを参照することはできません。

JetDupCursor には、一時テーブルに影響する重要な問題があります。 前方専用モードの一時テーブルを複製しようとすると、結果のカーソルは正しく作成されず、誤動作します。 具体化された一時テーブルの上にカーソルを複製しても安全です。

一時テーブル マネージャーは、3 つの方法で一時テーブルを実装することを選択できます。 1 つ目の方法は、メモリ内テーブルを維持することです。 この方法は最も高速ですが、小規模で単純な一時テーブルにのみ使用できます。 2 つ目の方法は、前方スクロール反復子を使用して駆動できるディスク ベースの並べ替えを作成することです。 この方法は特定の状況でのみ使用でき、非常に大きなデータ セットの重複を並べ替えて削除する最も速い方法です。 3 番目の方法は、一時テーブルを保持する B+ ツリーを一時データベースに作成することです。 この戦略は最も遅いですが、最も汎用性が高く、具体化された一時テーブルと呼ばれます。 これらの戦略は、最終的に一時テーブルに要求された機能を実現するために組み合わせて使用できます。

一時テーブルが具体化されていない場合は、主に 2 つの主要なフェーズで使用されます。 最初のフェーズは、テーブルに初期データ セットが設定される挿入フェーズです。 このフェーズでは、データの挿入のみが許可されます。 このフェーズは、 JetMove または JetSeek を使用してカーソルを移動しようとすると終了します。 2 番目のフェーズは、データ抽出フェーズです。 このフェーズでは、一時テーブルの作成時に要求された機能に従って、一時テーブルに格納されたデータを抽出できます。

一時テーブル カーソル機能

一時テーブルが具体化されると、カーソルには次の機能がありますが、要求されたオプションによってさらに制限される場合があります。

• JetCloseTable

• JetDelete

• JetDupCursor

• JetEnumerateColumns

• JetEscrowUpdate

• JetGetBookmark

• JetGetCursorInfo

• JetGetLS

• JetGetRecordSize

• JetGetTableInfo

• JetGotoBookmark

• JetMakeKey

• JetMove

• JetPrepareUpdate

• JetRetrieveColumn

• JetRetrieveColumns

• JetRetrieveKey

• JetSeek

• JetSetColumn

• JetSetColumns

• JetSetIndexRange

• JetSetLS

• JetUpdate

一時テーブルが具体化されず、挿入フェーズにある場合、カーソルには次の機能がありますが、要求されたオプションによってさらに制限される場合があります。

• JetCloseTable

• JetEscrowUpdate

• JetMakeKey

• JetMove

  メモ 抽出フェーズに移行します。

• JetPrepareUpdate

• JetRetrieveKey

• JetSeek

  メモ 抽出フェーズに移行します。

• JetSetColumn

• JetSetColumns

• JetUpdate

一時テーブルが具体化されず、抽出フェーズにある場合、カーソルには次の機能がありますが、要求されたオプションによってさらに制限される場合があります。

• JetCloseTable

• JetDupCursor

  メモ 前方専用モードの一時テーブルを複製しようとすると、結果のカーソルは正しく作成されず、誤動作します。 具体化された一時テーブルの上にカーソルを複製しても問題ありません。

• JetEnumerateColumns

• JetGetBookmark

• JetGetLS

• JetGetRecordSize

• JetGetTableInfo

• JetGotoBookmark

• JetMakeKey

• JetMove

• JetRetrieveColumn

• JetRetrieveColumns

• JetRetrieveKey

• JetSeek

• JetSetIndexRange

• JetSetLS

必要条件

参照

JET_COLUMNDEF
JET_COLUMNID
JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_UNICODEINDEX
JetCloseTable
JetCreateTableColumnIndex
JetDupCursor
JetMove
JetRollback
JetSeek
JetSetSystemParameter
一時データベース パラメーター