JetOpenTemporaryTable-Funktion
Gilt für: Windows | Windows Server
JetOpenTemporaryTable-Funktion
Die JetOpenTemporaryTable-Funktion erstellt eine flüchtige Tabelle mit einem einzelnen Index, der zum Speichern und Abrufen von Datensätzen verwendet werden kann, genau wie eine gewöhnliche Tabelle, die über JetCreateTableColumnIndexerstellt wird.
**Windows Vista:**JetOpenTemporaryTable wird in Windows Vista eingeführt.
Temporäre Tabellen sind aufgrund ihrer flüchtigen Natur schneller als normale Tabellen. Sie können Datensätze schnell sortieren und duplizieren, wenn auf sie rein sequenziell zugegriffen wird.
JET_ERR JET_API JetOpenTemporaryTable(
__in JET_SESID sesid,
__in JET_OPENTEMPORARYTABLE* popentemporarytable
);
Parameter
sesid
Die Sitzung, die für diesen Aufruf verwendet wird.
popentemporarytable
Ein Zeiger auf eine JET_OPENTEMPORARYTABLE Struktur, die die Beschreibung der temporären Tabelle enthält, die bei der Eingabe erstellt werden soll. Nach einem erfolgreichen Aufruf enthält die -Struktur das Handle für die temporären Tabellen- und Spaltenidentifikationen.
Rückgabewert
Diese Funktion gibt den JET_ERR Datentyp mit einem der folgenden Rückgabecodes zurück. Weitere Informationen zu den möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine Errors and Error Handling Parameters.
Rückgabecode |
Beschreibung |
|---|---|
JET_errSuccess |
Der Vorgang wurde erfolgreich abgeschlossen. |
JET_errOutOfMemory |
Fehler beim Vorgang, weil nicht genügend Arbeitsspeicher zugeordnet werden konnte, um ihn abzuschließen. JetOpenTemporaryTable kann JET_errOutOfMemory zurückgeben, wenn der Adressraum des Hostprozesses zu fragmentiert wird. Der temporäre Tabellen-Manager ordnet für jede erstellte temporäre Tabelle einen Adressraum von 1 MB zu, unabhängig von der Menge der gespeicherten Daten. |
JET_errInvalidParameter |
Einer der bereitgestellten Parameter enthielt einen unerwarteten Wert, oder die Kombination mehrerer Parameterwerte führte zu einem unerwarteten Ergebnis. Dieser Fehler wird von JetOpenTemporaryTable unter den folgenden Bedingungen zurückgegeben:
|
JET_errNotInitialized |
Der Vorgang kann nicht abgeschlossen werden, da die Instanz, die der Sitzung zugeordnet war, noch nicht initialisiert wurde. |
JET_errClientRequestToStopJetService |
Der Vorgang kann nicht abgeschlossen werden, da alle Aktivitäten auf der Instanz, die der Sitzung zugeordnet ist, aufgrund eines Aufrufs von JetStopServicebeendet wurden. |
JET_errInstanceUnavailable |
Der Vorgang kann nicht abgeschlossen werden, da für die Instanz, die der Sitzung zugeordnet ist, ein schwerwiegender Fehler aufgetreten ist, der erfordert, dass der Zugriff auf alle Daten widerrufen wird, um die Integrität dieser Daten zu schützen. Windows XP: Dieser Fehler wird nur von Windows XP und späteren Versionen zurückgegeben. |
JET_errTermInProgress |
Der Vorgang kann nicht abgeschlossen werden, da die instanz, die der Sitzung zugeordnet ist, heruntergefahren wird. |
JET_errRestoreInProgress |
Der Vorgang kann nicht abgeschlossen werden, da ein Wiederherstellungsvorgang für die Instanz ausgeführt wird, die der Sitzung zugeordnet ist. |
JET_errSessionSharingViolation |
Dieselbe Sitzung kann nicht für mehrere Threads gleichzeitig verwendet werden. Windows XP: Dieser Fehler wird nur von Windows XP und späteren Versionen zurückgegeben. |
JET_errInvalidSesid |
Das Sitzungshandle ist ungültig oder verweist auf eine geschlossene Sitzung. Hinweis Dieser Fehler wird nicht unter allen Umständen zurückgegeben. Handles werden nur nach bestem Aufwand überprüft. |
JET_errOutOfCursors |
Fehler beim Vorgang, weil die Engine die Ressourcen nicht zuordnen kann, die zum Öffnen eines neuen Cursors erforderlich sind. Cursorressourcen werden mit jetSetSystemParameter mit JET_paramMaxCursorskonfiguriert. |
JET_errTooManySorts |
Fehler beim Vorgang, weil die Engine die Ressourcen nicht zuordnen kann, die zum Erstellen einer temporären Tabelle erforderlich sind. Temporäre Tabellenressourcen werden mit JetSetSystemParameter mit JET_paramMaxTemporaryTableskonfiguriert. |
JET_errCannotMaterializeForwardOnlySort |
Fehler bei JetOpenTemporaryTable, weil JET_bitTTForwardOnly angegeben wurde und die angegebene temporäre Tabelle nicht mit der vorwärts gerichteten Optimierung erstellt werden konnte. Windows Server 2003: Dieser Fehler wird nur von Windows Server 2003 und höher zurückgegeben. |
JET_errTooManyColumns |
Es wurde versucht, der Tabelle zu viele Spalten hinzuzufügen. Eine Tabelle darf nicht mehr als JET_ccolFixedMost festen Spalten, nicht mehr als JET_ccolVarMost Spalten variabler Länge und nicht mehr als JET_ccolTaggedMost markierten Spalten enthalten. |
JET_errTooManyOpenTables |
Fehler beim Vorgang, weil die Engine die Ressourcen nicht zuordnen kann, die zum Zwischenspeichern des Schemas der Tabelle erforderlich sind. Verwenden Sie JetSetSystemParameter mit JET_paramMaxOpenTables, um die Anzahl der Tabellen mit Schemas zu konfigurieren, die zwischengespeichert werden können. |
JET_errInvalidCodePage |
Der cp-Member der JET_COLUMNDEF-Struktur wurde nicht auf eine gültige Codepage festgelegt. Die einzigen gültigen Werte für Textspalten sind Englisch (1252) und Unicode (1200). Der Wert 0 bedeutet, dass der Standardwert verwendet wird (Englisch, 1252). |
JET_errInvalidColumnType |
Der Coltypmember des JET_COLUMNDEF wurde nicht auf einen gültigen Spaltentyp festgelegt. |
JET_errInvalidLanguageId |
Der Index konnte nicht erstellt werden, da versucht wurde, eine ungültige Gebietsschema-ID zu verwenden. Die Gebietsschema-ID ist möglicherweise entweder vollständig ungültig, oder das zugeordnete Sprachpaket ist möglicherweise nicht installiert. |
JET_errInvalidLCMapStringFlags |
Der Index konnte nicht erstellt werden, da versucht wurde, einen ungültigen Satz von Normalisierungsflags zu verwenden. Windows XP: Dieser Fehler wird nur von Windows XP und späteren Versionen zurückgegeben. Windows 2000: Am Windows 2000 führen ungültige Normalisierungsflags zu JET_errIndexInvalidDef. |
JET_errIndexInvalidDef |
Der Index konnte nicht erstellt werden, da eine ungültige Indexdefinition angegeben wurde. JetOpenTemporaryTable gibt diesen Fehler unter den folgenden Bedingungen zurück:
Windows 2000: Dieser Fehler wird nur von Windows 2000 zurückgegeben. |
JET_errTooManyOpenIndexes |
Fehler beim Vorgang, weil die Engine die Ressourcen nicht zuordnen kann, die zum Zwischenspeichern der Indizes der Tabelle erforderlich sind. Verwenden Sie JetSetSystemParameter mit JET_paramMaxOpenTables, um die Anzahl der Indizes mit Schemas zu konfigurieren, die zwischengespeichert werden können. |
Bei Erfolg wird ein Cursor zurückgegeben, der für die neu erstellte temporäre Tabelle geöffnet wurde. Der Status der temporären Datenbank wird darauf vorbereitet, die neue temporäre Tabelle zu enthalten. Der Zustand aller normalen Datenbanken, die von der Datenbank-Engine verwendet werden, bleibt unverändert.
Bei einem Fehler wird die temporäre Tabelle nicht erstellt, und es wird kein Cursor zurückgegeben. Der Status der temporären Datenbank kann geändert werden. Der Zustand aller normalen Datenbanken, die von der Datenbank-Engine verwendet werden, bleibt unverändert.
Hinweise
Temporäre Tabellen unterstützen nicht das vollständige Komplement der Spaltendefinitionsoptionen, die normalerweise von der Datenbank-Engine unterstützt werden. Tatsächlich werden nur JET_bitColumnFixed und JET_bitColumnTagged unterstützt. Dies bedeutet, dass es nicht möglich ist, eine automatische Inkrement-, Versions- oder mehrwertige Spalte in einer temporären Tabelle zu erstellen. Schließlich werden Spalten mit Zeilenumlegungsaktualisierung nicht unterstützt, da sie jeweils nur von einer Sitzung verwendet werden können. Wenn eine dieser Optionen angefordert wird, werden sie ignoriert.
Temporäre Tabellen unterstützen keine Standardwerte. Wenn eine Spaltendefinition bereitgestellt wird, die eine Standardwertspezifikation enthält, wird diese Spezifikation ignoriert.
Temporäre Tabellen werden aufgrund vieler verschiedener ESE-Funktionen an den Aufrufer zurückgegeben. Beispielsweise gibt JetGetIndexInfo mit dem JET_IdxInfo Option eine temporäre Tabelle zurück, die eine Liste aller Schlüsselspalten in einem bestimmten Index enthält. Die temporären Tabellen folgen den gleichen Lebenszyklusregeln wie normale temporäre Tabellen, wie hier beschrieben.
Temporäre Tabellen werden auch intern von der Datenbank-Engine für viele Aufgaben verwendet. Die wichtigste dieser Aufgaben ist die Erstellung eines Indexes für eine vorhandene Tabelle. Eine temporäre Tabelle wird verwendet, um die Indexschlüssel zu sortieren, die zum Erstellen dieses Indexes verwendet werden.
Alle temporären Tabellen werden in der temporären Datenbank gespeichert. Die temporäre Datenbank ist eine spezielle Datenbankdatei, die während der Lebensdauer einer ESE-Instanz verwaltet wird und gelöscht wird, wenn diese Instanz heruntergefahren oder neu gestartet wird. Der Speicherort der temporären Datenbank kann mithilfe von JetSetSystemParameter mit JET_paramTempPathkonfiguriert werden. Die Platzierung der temporären Datenbank auf dem Datenträger relativ zu Ihren Transaktionsprotokolldateien und Datenbankdateien kann wichtig sein, wenn Ihre Anwendung temporäre Tabellen stark nutzt oder häufig Indizes erstellt.
Der Lebenszyklus einer temporären Tabelle ist an die Cursor gebunden, die darauf verweisen. Wenn alle Cursor, die auf eine temporäre Tabelle verweisen, entweder implizit oder explizit geschlossen werden, wird die temporäre Tabelle gelöscht. Wenn eine temporäre Tabelle innerhalb einer Transaktion erstellt wird und anschließend ein Rollback für diese Transaktion ausgeführt wird, wird die temporäre Tabelle gelöscht, da alle Cursor, auf die zu diesem Zeitpunkt verwiesen wird, implizit geschlossen werden. Neue Cursor können nur mithilfe von JetDupCursorauf eine temporäre Tabelle verweisen. In diesem Fall werden die neuen Cursor auf dem ersten Indexeintrag der temporären Tabelle positioniert. JetDupCursor funktioniert nur in bestimmten Verwendungsphasen für die temporäre Tabelle. Weitere Informationen finden Sie in den Hinweisen zu temporären Tabellencursorfunktionen. Es ist nicht möglich, von mehreren Sitzungen gleichzeitig auf eine temporäre Tabelle zu verweisen.
Vorsicht Es gibt ein wichtiges Problem in JetDupCursor, das temporäre Tabellen betrifft. Wenn versucht wird, eine temporäre Tabelle zu duplizieren, die sich im Vorwärtsmodus befindet, wird der resultierende Cursor nicht ordnungsgemäß erstellt und funktioniert nicht. Es ist immer noch sicher, einen Cursor über einer materialisierten temporären Tabelle zu duplizieren.
Der temporäre Tabellen-Manager kann eine temporäre Tabelle auf drei Arten implementieren. Die erste Methode besteht darin, eine In-Memory-Tabelle zu verwalten. Diese Strategie ist die schnellste, kann aber nur für kleine, einfache, temporäre Tabellen verwendet werden. Die zweite Methode besteht darin, eine datenträgerbasierte Sortierung zu erstellen, die mit einem vorwärts gerichteten Iterator gesteuert werden kann. Diese Strategie kann nur unter bestimmten Umständen verwendet werden und ist die schnellste Möglichkeit zum Sortieren und Entfernen von Duplikaten aus einem sehr großen Datensatz. Die dritte Methode besteht darin, eine B+-Struktur in der temporären Datenbank zu erstellen, die die temporäre Tabelle enthält. Diese Strategie ist die langsamste, aber vielseitigste Strategie und wird als materialisierte temporäre Tabelle bezeichnet. Diese Strategien können in Kombination verwendet werden, um letztendlich die Funktionalität zu erreichen, die von der temporären Tabelle angefordert wird.
Wenn die temporäre Tabelle nicht materialisiert wird, wird sie hauptsächlich in zwei Hauptphasen verwendet. Die erste Phase ist die Einfügephase, in der die Tabelle mit ihrem anfänglichen Datensatz aufgefüllt wird. Während dieser Phase ist nur das Einfügen von Daten zulässig. Diese Phase endet, wenn versucht wird, den Cursor mit JetMove oder JetSeekzu bewegen. Die zweite Phase ist die Datenextraktionsphase. Während dieser Phase können die in der temporären Tabelle gespeicherten Daten entsprechend den Funktionen extrahiert werden, die beim Erstellen der temporären Tabelle angefordert wurden.
Funktionen des temporären Tabellencursors
Wenn die temporäre Tabelle materialisiert wird, verfügt der Cursor über die folgenden Funktionen, kann aber durch die angeforderten Optionen weiter eingeschränkt werden:
Wenn die temporäre Tabelle nicht materialisiert wird und sich in der Einfügephase befindet, verfügt der Cursor über die folgenden Funktionen, kann aber durch die angeforderten Optionen weiter eingeschränkt werden:
-
Hinweis Bewirkt den Übergang zur Extraktionsphase.
-
Hinweis Bewirkt den Übergang zur Extraktionsphase.
Wenn die temporäre Tabelle nicht materialisiert wird und sich in der Extraktionsphase befindet, verfügt der Cursor über die folgenden Funktionen, kann aber durch die angeforderten Optionen weiter eingeschränkt werden:
-
Hinweis Wenn versucht wird, eine temporäre Tabelle zu duplizieren, die sich im Vorwärtsmodus befindet, wird der resultierende Cursor nicht ordnungsgemäß erstellt und funktioniert nicht. Es ist immer noch sicher, einen Cursor über einer materialisierten temporären Tabelle zu duplizieren.
Anforderungen
| | |
Client
|Erfordert Windows Vista.
| |Server
|Erfordert Windows Server 2008.
| |Header
|Deklariert in Esent.h.
| |Bibliothek
|Verwenden Sie ESENT.lib.
| |DLL
|Erfordert ESENT.dll.
|Weitere Informationen
JET_ERR
JET_SESID
JET_OPENTEMPORARYTABLE
JetCloseTable
JetCreateTableColumnIndex
JetDupCursor
JetMove
JetRollback
JetSeek
JetSetSystemParameter
Informationsparameter
Temporäre Datenbankparameter