JetOpenTemporaryTable-Funktion

Letzte Änderung: Freitag, 27. Februar 2015

Gilt für: Windows | Windows Server

JetOpenTemporaryTable-Funktion

Die Funktion JetOpenTemporaryTable erstellt eine flüchtige Tabelle mit einem einzelnen Index, der zum Speichern und Abrufen von Datensätzen, wie eine normale Tabelle, die über JetCreateTableColumnIndexerstellt wird.

Windows Vista:  JetOpenTemporaryTable wird in Windows Vista eingeführt.

Temporäre Tabellen sind schneller als normale Tabellen aufgrund ihrer veränderliche Art. Sie können schnell sortieren und zum Entfernen von Duplikaten für Datensätze ausführen, wenn rein sequenziell auf sie zugegriffen wird.

JET_ERR JET_API JetOpenTemporaryTable(
  __in          JET_SESID sesid,
  __in          JET_OPENTEMPORARYTABLE* popentemporarytable
);

Parameter

sesid

Rufen Sie die Sitzung, die für diese verwendet werden.

popentemporarytable

Ein Zeiger auf eine JET_OPENTEMPORARYTABLE -Struktur, die die Beschreibung der zu erstellenden bei der Eingabe der temporären Tabelle enthält. Nach einem erfolgreichen Aufruf enthält die Struktur das Handle für die temporären Tabelle und Spalte Kennungen.

Return Value

Diese Funktion gibt den Datentyp JET_ERR mit einem der folgenden Rückgabecodes. Weitere Informationen zu den möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine-Fehlern und Fehler behandeln von Parametern.

Ein Cursor auf die neu erstellte temporäre Tabelle geöffnet werden bei Erfolg zurückgegeben. Der Status der temporäre Datenbank wird die neue temporäre Tabelle enthalten vorbereitet werden. Der Status der normalen Datenbanken von der Datenbank-Engine verwendet, bleiben unverändert.

Bei einem Fehler wird nicht in der temporäre Tabelle erstellt und ein Cursor wird nicht zurückgegeben. Der Status der temporäre Datenbank kann geändert werden. Der Status der normalen Datenbanken von der Datenbank-Engine verwendet, bleiben unverändert.

Anmerkungen

Temporäre Tabellen unterstützen keine umfassenden Spalte Definition Optionen, die normalerweise durch die Datenbank-Engine unterstützt werden. Tatsächlich werden nur JET_bitColumnFixed und JET_bitColumnTagged unterstützt. Dies bedeutet, dass es nicht möglich, eine automatische Inkrementierung, Version oder mit mehreren Werten Spalte in einer temporären Tabelle zu erstellen. Hinterlegten Update Spalten werden schließlich nicht unterstützt, da sie nur von einer Sitzung zu einem Zeitpunkt verwendet werden können. Wenn dieser Optionen sind angefordert werden sie ignoriert werden.

Standardwerte unterstützt temporäre Tabellen nicht. Wenn eine Spaltendefinition ist, vorausgesetzt, die eine Spezifikation des Standard-Wert enthält, werden Spezifikation ignoriert.

Temporäre Tabellen werden mit dem Anrufer als Ergebnis einer viele verschiedene ESE-Funktionen zurückgegeben. Beispielsweise gibt JetGetIndexInfo mit der Option JET_IdxInfo eine temporäre Tabelle mit einer Liste aller Schlüsselspalten in einem angegebenen Index zurück. Die temporären Tabellen führen Sie dieselben Regeln wie für normale temporäre Tabellen Lebenszyklus aus, wie hier beschrieben.

Temporäre Tabellen werden von der Datenbank-Engine für viele Aufgaben auch intern verwendet. Die wichtigste dieser Aufgaben wird die Erstellung eines Indexes über eine vorhandene Tabelle. Die Indexschlüssel sortiert, die verwendet werden, um diesen Index zu erstellen, wird eine temporäre Tabelle verwendet werden.

Alle temporäre Tabellen werden in die temporäre Datenbank gespeichert. Die temporäre Datenbank ist eine spezielle Datenbank-Datei, die während der Lebensdauer einer ESE-Instanz verwaltet wird und wird gelöscht, wenn diese Instanz heruntergefahren oder neu gestartet wird. Der Speicherort der temporären Datenbank kann mithilfe von JetSetSystemParameter mit JET_paramTempPathkonfiguriert werden. Platzierung der temporären Datenbank auf dem Datenträger relativ zu Ihrer Transaktionsprotokolldateien und Datenbankdateien möglicherweise wichtig, wenn die Anwendung bei der umfassenden Verwendung von temporären Tabellen wird oder Indizes häufig erstellt.

Der Lebenszyklus einer temporären Tabelle ist an den Cursor gebunden, die darauf verweisen. Wenn die Cursor, die eine temporäre Tabelle verweisen implizit oder explizit geschlossen werden, wird die temporäre Tabelle gelöscht werden. Wenn eine temporäre Tabelle innerhalb einer Transaktion erstellt wird und dass Transaktion anschließend klicken Sie dann die temporäre Tabelle zurückgesetzt wird werden gelöscht, da alle Cursor, die sie zu diesem Zeitpunkt referenziert implizit geschlossen werden. Neue Cursor können nur durch die Verwendung von JetDupCursoreine temporäre Tabelle verweisen. In diesem Fall werden die neue Cursor auf die erste Indexeintrag der temporären Tabelle positioniert. JetDupCursor funktioniert nur in bestimmten Testphase für die temporäre Tabelle verwenden. Die Erläuterungen temporäre Tabelle Cursor Funktionen für Weitere Informationen zu finden. Es ist nicht möglich, eine temporäre Tabelle von mehr als eine Sitzung zu einem Zeitpunkt zu verweisen.

Vorsicht  Es ist ein wichtiges Problem in JetDupCursor , die temporäre Tabellen wirkt sich auf. Wenn versucht wird, eine temporäre Tabelle duplizieren, die im vorwärts-Modus ist, und klicken Sie dann dem Cursor nicht ordnungsgemäß erstellt und funktioniert. Es ist immer noch sicher ist, um einen Cursor über eine materialisierte temporäre Tabelle zu duplizieren.

Der temporäre Tabellenmanager kann eine temporäre Tabelle auf drei Arten implementieren. Die erste Methode wird zum Aufrechterhalten einer Tabelle im Arbeitsspeicher. Diese Strategie ist die schnellste Methode kann nur für kleine, einfache, temporäre Tabellen verwendet werden. Die zweite Methode ist die Erstellung einer datenträgerbasierter sortieren, die ein Vorwärtscursor einen listenfelditerator gesteuert werden kann. Diese Strategie kann nur unter bestimmten Umständen verwendet werden und ist die schnellste Methode zum Sortieren und Entfernen von Duplikaten aus einem großen DataSet. Die dritte Methode ist die Erstellung einer B +-Struktur in die temporäre Datenbank zum Speichern der temporären Tabelle. Dieser Strategie ist der langsamste, aber vielseitig, und eine materialisierte temporäre Tabelle genannt wird. Diese Strategien können in Kombination verwendet werden, um die Funktionalität letztlich zu erzielen, die der temporären Tabelle angefordert wird.

Wenn die temporäre Tabelle nicht materialisiert ist ist dann hauptsächlich in zwei Hauptphasen verwendet. Die erste Phase ist die Einfügung-Phase, in dem die Tabelle mit seiner ursprünglichen Dataset gefüllt ist. Während dieser Phase ist nur Daten einfügen zulässig. Diese Phase beendet, wenn versucht wird, verschieben Sie den Cursor mit JetMove oder wurde. Die zweite Phase ist die Phase, Daten extrahieren. Während dieser Phase können die Daten, die in der temporären Tabelle gespeichert werden basierend auf den Fähigkeiten extrahiert werden, die beim Erstellen die temporäre Tabelle angefordert wurden.

Temporäre Tabelle Cursor-Funktionen

Wenn die temporäre Tabelle materialisiert ist, wird der Cursor verfügt über die folgenden Funktionen jedoch möglicherweise weiter eingeschränkt werden, durch die Optionen, die angefordert werden:

• JetCloseTable

• JetDelete

• JetDupCursor

• JetEnumerateColumns

• JetEscrowUpdate

• JetGetBookmark

• JetGetCursorInfo

• JetGetLS

• JetGetRecordSize

• JetGetTableInfo

• JetGotoBookmark

• JetMakeKey

• JetMove

• JetPrepareUpdate

• JetRetrieveColumn

• JetRetrieveColumns

• JetRetrieveKey

• JetSeek

• JetSetColumn

• JetSetColumns

• JetSetIndexRange

• JetSetLS

• JetUpdate

Wenn die temporäre Tabelle nicht materialisiert wird und befindet sich in der Phase einfügen, der Cursor verfügt über die folgenden Funktionen jedoch möglicherweise weiter eingeschränkt werden, durch die Optionen, die angefordert werden:

• JetCloseTable

• JetEscrowUpdate

• JetMakeKey

• JetMove

  Hinweis  Ursachen Übergang zur Phase extrahieren.

• JetPrepareUpdate

• JetRetrieveKey

• JetSeek

  Hinweis  Ursachen Übergang zur Phase extrahieren.

• JetSetColumn

• JetSetColumns

• JetUpdate

Wenn die temporäre Tabelle nicht materialisiert wird und befindet sich in der Phase extrahieren, der Cursor verfügt über die folgenden Funktionen jedoch möglicherweise weiter eingeschränkt werden, durch die Optionen, die angefordert werden:

• JetCloseTable

• JetDupCursor

  Hinweis  Wenn versucht wird, eine temporäre Tabelle duplizieren, die im vorwärts-Modus ist, und klicken Sie dann dem Cursor nicht ordnungsgemäß erstellt und funktioniert. Es ist immer noch sicher ist, um einen Cursor über eine materialisierte temporäre Tabelle zu duplizieren.

• JetEnumerateColumns

• JetGetBookmark

• JetGetLS

• JetGetRecordSize

• JetGetTableInfo

• JetGotoBookmark

• JetMakeKey

• JetMove

• JetRetrieveColumn

• JetRetrieveColumns

• JetRetrieveKey

• JetSeek

• JetSetIndexRange

• JetSetLS

Voraussetzungen

Siehe auch

JET_ERR
JET_SESID
JET_OPENTEMPORARYTABLE
JetCloseTable
JetCreateTableColumnIndex
JetDupCursor
JetMove
JetRollback
wurde
JetSetSystemParameter
Informationszwecken Parameter
temporäre Datenbank-Parameter