Funzione JetOpenTemporaryTable
Si applica a: Windows | Windows Server
Funzione JetOpenTemporaryTable
La funzione JetOpenTemporaryTable crea una tabella volatile con un singolo indice che può essere usato per archiviare e recuperare record, proprio come una tabella comune creata tramite JetCreateTableColumnIndex.
Windows Vista:JetOpenTemporaryTable è stato introdotto in Windows Vista.
Le tabelle temporanee sono più veloci rispetto alle tabelle normali a causa della loro natura volatile. Possono ordinare ed eseguire rapidamente la rimozione dei duplicati nei set di record quando si accede in modo puramente sequenziale.
JET_ERR JET_API JetOpenTemporaryTable(
__in JET_SESID sesid,
__in JET_OPENTEMPORARYTABLE* popentemporarytable
);
Parametri
sesid
Sessione che verrà utilizzata per questa chiamata.
popentemporarytable
Puntatore a una struttura JET_OPENTEMPORARYTABLE contenente la descrizione della tabella temporanea da creare in input. Dopo una chiamata riuscita, la struttura contiene l'handle per le identificazioni di tabella e colonna temporanee.
Valore restituito
Questa funzione restituisce il tipo di dati JET_ERR con uno dei codici restituiti seguenti. Per altre informazioni sui possibili errori ESE, vedere Errori del motore di archiviazione estendibile e parametri di gestione degli errori.
Codice restituito |
Descrizione |
|---|---|
JET_errSuccess |
Operazione riuscita. |
JET_errOutOfMemory |
L'operazione non è riuscita perché non è possibile allocare memoria sufficiente per completarla. JetOpenTemporaryTable può restituire JET_errOutOfMemory se lo spazio degli indirizzi del processo host diventa troppo frammentato. Gestione tabelle temporanee alloca un blocco di spazio indirizzi di 1 MB per ogni tabella temporanea creata indipendentemente dalla quantità di dati archiviati. |
JET_errInvalidParameter |
Uno dei parametri forniti contiene un valore imprevisto o la combinazione di diversi valori di parametro ha generato un risultato imprevisto. Questo errore viene restituito da JetOpenTemporaryTable nelle condizioni seguenti:
|
JET_errNotInitialized |
Impossibile completare l'operazione perché l'istanza associata alla sessione non è ancora stata inizializzata. |
JET_errClientRequestToStopJetService |
L'operazione non può essere completata perché tutte le attività nell'istanza associata alla sessione sono cessate a seguito di una chiamata a JetStopService. |
JET_errInstanceUnavailable |
Impossibile completare l'operazione perché l'istanza associata alla sessione ha rilevato un errore irreversibile che richiede la revoca dell'accesso a tutti i dati per proteggere l'integrità dei dati. Windows XP: Questo errore verrà restituito solo da Windows XP e versioni successive. |
JET_errTermInProgress |
Impossibile completare l'operazione perché l'istanza associata alla sessione viene arrestata. |
JET_errRestoreInProgress |
Impossibile completare l'operazione perché è in corso un'operazione di ripristino nell'istanza associata alla sessione. |
JET_errSessionSharingViolation |
La stessa sessione non può essere usata contemporaneamente per più thread. Windows XP: Questo errore verrà restituito solo da Windows XP e versioni successive. |
JET_errInvalidSesid |
L'handle di sessione non è valido o fa riferimento a una sessione chiusa. Nota Questo errore non viene restituito in tutte le circostanze. Gli handle vengono convalidati solo in base al massimo sforzo. |
JET_errOutOfCursors |
L'operazione non è riuscita perché il motore non può allocare le risorse necessarie per aprire un nuovo cursore. Le risorse del cursore vengono configurate usando JetSetSystemParameter con JET_paramMaxCursors. |
JET_errTooManySorts |
L'operazione non è riuscita perché il motore non può allocare le risorse necessarie per creare una tabella temporanea. Le risorse di tabella temporanee vengono configurate usando JetSetSystemParameter con JET_paramMaxTemporaryTables. |
JET_errCannotMaterializeForwardOnlySort |
JetOpenTemporaryTable non è riuscito perché è stato specificato JET_bitTTForwardOnly e non è stato possibile creare la tabella temporanea specificata utilizzando l'ottimizzazione forward-only. Windows Server 2003: Questo errore verrà restituito solo da Windows Server 2003 e versioni successive. |
JET_errTooManyColumns |
È stato effettuato un tentativo di aggiungere troppe colonne alla tabella. Una tabella non può contenere più di JET_ccolFixedMost colonne fisse, non più di JET_ccolVarMost colonne a lunghezza variabile e non più di JET_ccolTaggedMost colonne con tag. |
JET_errTooManyOpenTables |
L'operazione non è riuscita perché il motore non può allocare le risorse necessarie per memorizzare nella cache lo schema della tabella. Per configurare il numero di tabelle con schemi che possono essere memorizzati nella cache, usare JetSetSystemParameter con JET_paramMaxOpenTables. |
JET_errInvalidCodePage |
Il membro cp della struttura JET_COLUMNDEF non è stato impostato su una tabella codici valida. Gli unici valori validi per le colonne di testo sono inglese (1252) e Unicode (1200). Il valore 0 indica che verrà usato il valore predefinito (inglese, 1252). |
JET_errInvalidColumnType |
Il membro coltyp del JET_COLUMNDEF non è stato impostato su un tipo di colonna valido. |
JET_errInvalidLanguageId |
Impossibile creare l'indice perché è stato effettuato un tentativo di utilizzo di un ID delle impostazioni locali non valido. L'ID delle impostazioni locali potrebbe non essere completamente valido o il Language Pack associato potrebbe non essere installato. |
JET_errInvalidLCMapStringFlags |
Impossibile creare l'indice perché è stato effettuato un tentativo di utilizzo di un set non valido di flag di normalizzazione. Windows XP: Questo errore verrà restituito solo da Windows XP e versioni successive. Windows 2000: In Windows 2000 i flag di normalizzazione non validi genereranno JET_errIndexInvalidDef. |
JET_errIndexInvalidDef |
Impossibile creare l'indice perché è stata specificata una definizione di indice non valida. JetOpenTemporaryTable restituirà questo errore nelle condizioni seguenti:
Windows 2000: Questo errore verrà restituito solo da Windows 2000. |
JET_errTooManyOpenIndexes |
L'operazione non è riuscita perché il motore non può allocare le risorse necessarie per memorizzare nella cache gli indici della tabella. Per configurare il numero di indici con schemi che possono essere memorizzati nella cache, usare JetSetSystemParameter con JET_paramMaxOpenTables. |
In caso di esito positivo, verrà restituito un cursore aperto nella tabella temporanea appena creata. Lo stato del database temporaneo verrà preparato per contenere la nuova tabella temporanea. Lo stato di tutti i database ordinari in uso dal motore di database rimarrà invariato.
In caso di errore, la tabella temporanea non verrà creata e non verrà restituito un cursore. Lo stato del database temporaneo può essere modificato. Lo stato di tutti i database ordinari in uso dal motore di database rimarrà invariato.
Commenti
Le tabelle temporanee non supportano il complemento completo delle opzioni di definizione di colonna normalmente supportate dal motore di database. Infatti, sono supportati solo JET_bitColumnFixed e JET_bitColumnTagged. Ciò significa che non è possibile creare una colonna a incremento automatico, versione o multivalore in una tabella temporanea. Infine, le colonne di aggiornamento del deposito non sono supportate perché possono essere usate solo da una sessione alla volta. Se una di queste opzioni viene richiesta, verranno ignorate.
Le tabelle temporanee non supportano i valori predefiniti. Se viene fornita una definizione di colonna che contiene una specifica di valore predefinita, tale specifica verrà ignorata.
Le tabelle temporanee vengono restituite al chiamante come risultato di molte funzioni ESE diverse. Ad esempio, JetGetIndexInfo con il set di opzioni JET_IdxInfo restituirà una tabella temporanea contenente un elenco di tutte le colonne chiave in un determinato indice. Le tabelle temporanee seguono le stesse regole del ciclo di vita delle tabelle temporanee normali descritte qui.
Le tabelle temporanee vengono usate internamente dal motore di database per molte attività. La più importante di queste attività è la creazione di un indice su una tabella esistente. Verrà usata una tabella temporanea per ordinare le chiavi di indice usate per costruire tale indice.
Tutte le tabelle temporanee vengono archiviate nel database temporaneo. Il database temporaneo è un file di database speciale gestito durante la durata di un'istanza ESE e viene eliminato quando tale istanza viene arrestata o riavviata. Il percorso del database temporaneo può essere configurato usando JetSetSystemParameter con JET_paramTempPath. Il posizionamento del database temporaneo sul disco rispetto ai file di log delle transazioni e ai file di database può essere importante se l'applicazione usa pesantemente tabelle temporanee o crea spesso indici.
Il ciclo di vita di una tabella temporanea è associato ai cursori che lo fanno riferimento. Se tutti i cursori che fanno riferimento a una tabella temporanea vengono chiusi, in modo implicito o esplicito, la tabella temporanea verrà eliminata. Se una tabella temporanea viene creata all'interno di una transazione e tale transazione viene successivamente eseguito il rollback, la tabella temporanea verrà eliminata perché tutti i cursori a cui fa riferimento in questo momento verranno chiusi in modo implicito. I nuovi cursori possono fare riferimento a una tabella temporanea solo tramite l'uso di JetDupCursor. In questo caso, i nuovi cursori verranno posizionati sulla prima voce di indice della tabella temporanea. JetDupCursor funzionerà solo durante determinate fasi di utilizzo per la tabella temporanea. Per altre informazioni, vedere le osservazioni relative alle funzionalità del cursore della tabella temporanea. Non è possibile fare riferimento a una tabella temporanea da più sessioni alla volta.
Attenzione C'è un problema importante in JetDupCursor che influisce sulle tabelle temporanee. Se viene eseguito un tentativo di duplicare una tabella temporanea in modalità forward-only, il cursore risultante non verrà creato correttamente e non funzionerà correttamente. È comunque sicuro duplicare un cursore su una tabella temporanea materializzata.
Gestione tabelle temporanee può implementare una tabella temporanea in tre modi. Il primo metodo consiste nel mantenere una tabella in memoria. Questa strategia è più veloce, ma può essere usata solo per tabelle temporanee di piccole dimensioni, semplici e temporanee. Il secondo metodo consiste nel creare un ordinamento basato su disco che può essere guidato usando un iteratore solo forward.The second method is to create a disk-based sort that can be driven using a forward-only iterator. Questa strategia può essere usata solo in determinate circostanze ed è il modo più veloce per ordinare e rimuovere duplicati da un set di dati molto grande. Il terzo metodo consiste nel creare un albero B+ nel database temporaneo per contenere la tabella temporanea. Questa strategia è la più lenta, ma la più versatile e viene definita una tabella temporanea materializzata. Queste strategie possono essere usate in combinazione per ottenere in definitiva la funzionalità richiesta della tabella temporanea.
Quando la tabella temporanea non viene materializzata, viene usata principalmente in due fasi principali. La prima fase è la fase di inserimento in cui la tabella viene popolata con il set di dati iniziale. Durante questa fase è consentito solo l'inserimento dei dati. Questa fase termina quando viene eseguito un tentativo di spostare il cursore usando JetMove o JetSeek. La seconda fase è la fase di estrazione dei dati. Durante questa fase, i dati archiviati nella tabella temporanea possono essere estratti in base alle funzionalità richieste al momento della creazione della tabella temporanea.
Funzionalità del cursore di tabella temporanea
Quando la tabella temporanea viene materializzata, il cursore ha le funzionalità seguenti, ma potrebbe essere ulteriormente limitato dalle opzioni richieste:
Quando la tabella temporanea non viene materializzata e si trova nella fase di inserimento, il cursore ha le funzionalità seguenti, ma potrebbe essere ulteriormente limitato dalle opzioni richieste:
-
Nota Causa la transizione alla fase di estrazione.
-
Nota Causa la transizione alla fase di estrazione.
Quando la tabella temporanea non viene materializzata e si trova nella fase di estrazione, il cursore ha le funzionalità seguenti, ma può essere ulteriormente limitato dalle opzioni richieste:
-
Nota Se viene eseguito un tentativo di duplicare una tabella temporanea in modalità forward-only, il cursore risultante non verrà creato correttamente e non funzionerà correttamente. È comunque sicuro duplicare un cursore su una tabella temporanea materializzata.
Requisiti
| Requisito | Valore |
|---|---|
Client |
Richiede Windows Vista. |
Server |
Richiede Windows Server 2008. |
Intestazione |
Dichiarato in Esent.h. |
Libreria |
Usare ESENT.lib. |
DLL |
Richiede ESENT.dll. |
Vedere anche
JET_ERR
JET_SESID
JET_OPENTEMPORARYTABLE
JetCloseTable
JetCreateTableColumnIndex
JetDupCursor
JetMove
JetRollback
JetSeek
JetSetSystemParameter
Parametri informativi
Parametri di database temporanei