JetOpenTempTable 函式
適用于： Windows |Windows Server
JetOpenTempTable 函式
JetOpenTempTable函式會建立具有單一索引的臨時表。 臨時表會儲存和擷取記錄，就像使用 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
臨時表中建立之資料行的資料行定義。
與臨時表搭配使用的資料行定義選項有重要的限制。 如需詳細資訊，請參閱＜備註＞一節。
除了一般的資料行定義選項之外，也可以指定下列零或多個選項，只與臨時表的內容相關。
值 |
意義 |
|---|---|
JET_bitColumnTTDescending |
臨時表索引鍵資料行的排序次序應該遞減，而不是遞增。 如果未指定此選項，則不會JET_bitColumnTTKey則會忽略此選項。 |
JET_bitColumnTTKey |
資料行將是臨時表的索引鍵資料行。 在輸入陣列中指定此選項的資料行定義順序，將決定臨時表每個索引鍵資料行的優先順序。 陣列中已設定此選項的第一個資料行定義將是最重要的索引鍵資料行等等。 如果要求的索引鍵資料行數目超過資料庫引擎所能支援的數目，則會忽略不支援索引鍵資料行的這個選項。 |
ccolumn
請參閱 prgcolumndef。
grbit
指定下列選項之零或多個位群組。
值 |
意義 |
|---|---|
JET_bitTTErrorOnDuplicateInsertion |
任何嘗試插入與先前插入之記錄相同的索引鍵的記錄，都會立即失敗並JET_errKeyDuplicate。 如果未要求此選項，則會立即偵測重複專案並失敗，或稍後會根據資料庫引擎選擇的策略，根據要求的功能實作臨時表而以無訊息方式移除。 如果不需要此功能，最好不要要求此功能。 如果未要求這項功能，臨時表管理員可能會選擇管理臨時表的策略，以提升效能。 |
JET_bitTTForceMaterialization |
強制臨時表管理員放棄搜尋最佳策略，以使用管理會導致增強效能的臨時表。 |
JET_bitTTForwardOnly |
只有在臨時表管理員可以使用針對中繼查詢結果優化的實作時，才會建立臨時表。 如果臨時表的任何特性會防止使用此優化，則作業將會因為JET_errCannotMaterializeForwardOnlySort而失敗。 這個選項的副作用是允許臨時表包含具有重複索引鍵的記錄。 如需詳細資訊，請參閱JET_bitTTUnique。 此選項僅適用于 Windows Server 2003 和更新版本。 |
JET_bitTTIndexed |
此選項要求臨時表具有足夠的彈性，以允許使用 JetSeek 依索引鍵查閱記錄。 如果不需要此功能，最好不要要求此功能。 如果未要求這項功能，臨時表管理員可能會選擇管理臨時表的策略，以提升效能。 |
JET_bitTTUnique |
要求從臨時表中的最後一組記錄中移除具有重複索引鍵的記錄。 在 Windows Server 2003 之前，資料庫引擎一律假設這個選項生效，因為所有叢集索引也必須是主鍵，因此必須是唯一的。 從 Windows Server 2003 開始，現在可以建立臨時表，在同時指定 [JET_bitTTForwardOnly] 選項時不會移除重複專案。 通常無法知道哪一個重複專案會成功，而且會捨棄哪些重複專案。 不過，當要求JET_bitTTErrorOnDuplicateInsertion選項時，具有指定索引鍵的第一筆記錄一律會成功插入臨時表。 |
JET_bitTTUpdatable |
要求臨時表具有足夠的彈性，以允許先前插入的記錄後續變更。 如果不需要此功能，最好不要要求此功能。 如果未要求這項功能，臨時表管理員可能會選擇管理臨時表的策略，以提升效能。 |
JET_bitTTScrollable |
要求臨時表具有足夠的彈性，以允許使用 JetMove以任意順序和方向掃描記錄。 如果不需要這項功能，最好不要要求此功能。 如果未要求這項功能，臨時表管理員可能會選擇管理臨時表的策略，以提升效能。 |
JET_bitTTSortNullsHigh |
要求 Null 索引鍵資料行值比非 Null 索引鍵資料行值更接近索引結尾。 |
JET_bitTTIntrinsicLVsOnly |
只允許內建 long 值的要求。 Windows 7：windows 7 引進 JET_bitTTIntrinsicLVsOnly 。 |
ptableid
輸出緩衝區，接收在新建立的臨時表上開啟的新資料指標。
prgcolumnid
輸出緩衝區，接收在建立臨時表期間所產生的資料行識別碼陣列。
此陣列中的資料行識別碼會完全符合資料行定義的輸入陣列。 因此，這個緩衝區的大小必須對應至輸入陣列的大小。
傳回值
此函式會傳回具有下列其中一個傳回碼 的 JET_ERR 資料類型。 如需可能 ESE 錯誤的詳細資訊，請參閱 可延伸儲存引擎錯誤 和 錯誤處理參數。
傳回碼 |
描述 |
|---|---|
JET_errSuccess |
作業已成功完成。 |
JET_errCannotMaterializeForwardOnlySort |
JetOpenTempTable 失敗，因為已指定JET_bitTTForwardOnly，而且無法使用順向優化來建立指定的臨時表。 此錯誤只會由 Windows Server 2003 和更新版本傳回。 |
JET_errClientRequestToStopJetService |
無法完成作業，因為與會話相關聯之實例上的所有活動因 JetStopService呼叫而停止。 |
JET_errIndexInvalidDef |
無法建立索引，因為指定了不正確索引定義。 JetOpenTempTable 會在下列情況下傳回此錯誤：
此錯誤只會由 Windows 2000 傳回。 |
JET_errInstanceUnavailable |
無法完成作業，因為與會話相關聯的實例發生嚴重錯誤，需要撤銷所有資料的存取權，以保護該資料的完整性。 此錯誤只會由 Windows XP 和更新版本傳回。 |
JET_errInvalidCodePage |
JET_COLUMNDEF的 cp 欄位未設定為有效的字碼頁。 文字資料行的唯一有效值為英文 (1252) 和 Unicode (1200) 。 值為 0 表示預設值將用於英文、1252) (。 |
JET_errInvalidColumnType |
JET_COLUMNDEF的coltyp欄位未設定為有效的資料行類型。 |
JET_errInvalidLanguageId |
無法建立索引，因為嘗試使用不正確地區設定識別碼。 地區設定識別碼可能完全無效，或可能未安裝相關聯的語言套件。 |
JET_errInvalidLCMapStringFlags |
無法建立索引，因為嘗試使用一組不正確正規化旗標。 此錯誤只會由 Windows XP 和更新版本傳回。 在 Windows 2000 上，不正確正規化旗標會導致JET_errIndexInvalidDef。 |
JET_errInvalidSesid |
會話控制碼無效或參考已關閉的會話。 注意 在所有情況下都不會傳回此錯誤。 控制碼只會以最佳方式進行驗證。 |
JET_errNotInitialized |
無法完成作業，因為與會話相關聯的實例尚未初始化。 |
JET_errOutOfCursors |
作業失敗，因為引擎無法配置開啟新資料指標所需的資源。 資料指標資源是使用 JetSetSystemParameter 搭配 JET_paramMaxCursors來設定。 |
JET_errOutOfMemory |
作業失敗，因為無法配置足夠的記憶體來完成。 如果主機進程的位址空間太分散，JetOpenTempTable可以傳回JET_errOutOfMemory。 不論要儲存的資料量為何，臨時表管理員一律會為每個建立的臨時表配置 1MB 的位址空間。 |
JET_errRestoreInProgress |
無法完成作業，因為與會話相關聯的實例上正在進行還原作業。 |
JET_errSessionSharingViolation |
同一個會話不能同時用於一個以上的執行緒。 此錯誤只會由 Windows XP 和更新版本傳回。 |
JET_errTermInProgress |
無法完成作業，因為與會話相關聯的實例正在關閉。 |
JET_errTooManyColumns |
嘗試將太多資料行加入資料表。 資料表不能超過JET_ccolFixedMost個固定資料行、不超過JET_ccolVarMost可變長度資料行，而且不能超過JET_ccolTaggedMost標記的資料行。 |
JET_errTooManyOpenIndexes |
作業失敗，因為引擎無法配置快取資料表索引所需的資源。 可以使用 JetSetSystemParameter 搭配 JET_paramMaxOpenTables來設定其架構的索引數目。 |
JET_errTooManyOpenTables |
作業失敗，因為引擎無法配置快取資料表架構所需的資源。 可以使用 JetSetSystemParameter 搭配 JET_paramMaxOpenTables來設定其架構的資料表數目。 |
JET_errTooManySorts |
作業失敗，因為引擎無法配置建立臨時表所需的資源。 臨時表資源是使用 JetSetSystemParameter 搭配 JET_paramMaxTemporaryTables來設定。 |
成功時，將會傳回在新建立的臨時表上開啟的資料指標。 暫存資料庫的狀態將會準備好包含新的臨時表。 資料庫引擎使用中任何一般資料庫的狀態會保持不變。
失敗時，不會建立臨時表，而且不會傳回資料指標。 暫存資料庫的狀態可能會變更。 資料庫引擎使用中任何一般資料庫的狀態會保持不變。
備註
臨時表不支援資料庫引擎通常支援的資料行定義選項完整補充。 事實上，僅支援JET_bitColumnFixed和JET_bitColumnTagged。 這表示無法在臨時表中建立自動遞增、版本或多重值資料行。 最後，不支援委付更新資料行，因為它們在臨時表中並不實用，因為它們一次只能由一個會話使用。 如果要求其中任何一個選項，則會忽略這些選項。
臨時表不支援預設值。 如果提供包含預設值規格的資料行定義，則會忽略該規格。
臨時表會因為許多不同的 ESE 函數而傳回給呼叫端。 例如，在InfoLevel參數中設定JET_IdxInfo選項的JetGetIndexInfo會傳回臨時表，其中包含指定索引中所有索引鍵資料行的清單。 臨時表遵循與一般臨時表相同的生命週期規則，如這裡所述。
資料庫引擎也會在內部使用臨時表來執行許多工作。 這些工作最重要的就是在現有資料表上建立索引。 臨時表將用來排序用來建構該索引的索引鍵。
所有臨時表都會儲存在臨時資料庫中。 暫存資料庫是特殊的資料庫檔案，會在 ESE 實例的存留期間維護，並在該實例關閉或重新開機時刪除。 您可以使用 JetSetSystemParameter 搭配 JET_paramTempPath來設定暫存資料庫的位置。 如果您的應用程式大量使用臨時表或經常建立索引，則暫存資料庫在相對於交易記錄檔和資料庫檔案的磁片上放置可能很重要。
臨時表的生命週期會系結至參考它的資料指標。 如果參考臨時表的所有資料指標都會以隱含或明確方式關閉，則會刪除臨時表。 如果在交易內建立臨時表，且後續回復該交易，則會刪除臨時表，因為此時參考它的任何資料指標都會隱含關閉。 新的資料指標只能透過 使用 JetDupCursor來參考臨時表。 在此情況下，新的資料指標會放在臨時表的第一個索引項目目上。 JetDupCursor 只能在臨時表的特定使用階段運作。 如需詳細資訊，請參閱臨時表資料指標功能的備註。 無法一次從多個會話參考臨時表。
JetDupCursor中會影響臨時表的重要問題。 如果嘗試複製處於順向模式的臨時表，則產生的資料指標將不會正確建立，而且會失敗。 在具體化臨時表上複製資料指標仍然很安全。
臨時表管理員可以選擇以三種方式實作臨時表。 第一個方法是維護記憶體內部資料表。 此策略是最快的策略，但只能用於小型、簡單的臨時表。 第二種方法是建立可使用順向反覆運算器驅動之磁片型排序。 此策略只能在特定情況下使用，而且是從非常大型資料集排序和移除重複專案最快的方式。 第三種方法是在暫存資料庫中建立 B+ 樹狀結構，以保存臨時表。 此策略最慢，但最靈活，又稱為具體化臨時表。 這些策略可以搭配使用，最終達到臨時表所要求的功能。
當臨時表未具體化時，它主要會用於兩個主要階段。 第一個階段是插入階段，其中資料表會填入其初始資料集。 在此階段中，只允許插入資料。 此階段會在嘗試使用 JetMove 或 JetSeek移動游標時結束。 第二個階段是資料擷取階段。 在這個階段中，儲存在臨時表中的資料可能會根據建立臨時表時所要求的功能來擷取。
臨時表資料指標功能
當臨時表具體化時，資料指標具有下列功能，但可能會受到所要求的選項進一步限制：
當臨時表未具體化且處於插入階段時，游標具有下列功能，但可能會受到所要求的選項進一步限制：
-
注意 導致轉換至擷取階段。
-
注意 導致轉換至擷取階段。
當臨時表未具體化且處於擷取階段時，資料指標具有下列功能，但可能會受到所要求的選項進一步限制：
-
注意 如果嘗試複製處於順向模式的臨時表，則產生的資料指標將不會正確建立，而且會失敗。 在具體化臨時表上複製資料指標仍然很安全。
規格需求
| 需求 | 值 |
|---|---|
用戶端 |
需要 Windows Vista、Windows XP 或 Windows 2000 Professional。 |
Server |
需要 Windows Server 2008、Windows Server 2003 或 Windows 2000 Server。 |
標頭 |
在 Esent.h 中宣告。 |
程式庫 |
使用 ESENT.lib。 |
Dll |
需要ESENT.dll。 |
另請參閱
JET_COLUMNDEF
JET_COLUMNID
JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_UNICODEINDEX
JetCloseTable
JetCreateTableColumnIndex
JetDupCursor
JetMove
JetRollback
JetSeek
JetSetSystemParameter
暫存資料庫參數