Funzione JetOpenTempTable2

Si applica a: Windows | Windows Server

Funzione JetOpenTempTable2

La funzione JetOpenTempTable2 crea una tabella temporanea con un singolo indice che può essere usato per archiviare e recuperare record come una tabella normale creata usando JetCreateTableColumnIndex. Questa funzione include anche un ID impostazioni locali che può essere usato per confrontare i dati di colonna chiave Unicode nella tabella temporanea. Tuttavia, le tabelle temporanee sono molto più veloci rispetto alle tabelle normali a causa della loro natura volatile. Possono anche essere usati per ordinare in modo molto rapido ed eseguire la rimozione duplicata nei set di record quando si accede in modo puramente sequenziale.

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

Parametri

sesid

Sessione da usare.

prgcolumndef

Definizioni di colonna delle colonne da creare nella tabella temporanea.

Esistono limitazioni importanti per le opzioni di definizione della colonna usate con una tabella temporanea. Per altre informazioni, vedere la sezione Osservazioni.

Oltre alle opzioni di definizione di colonna consuete, è possibile specificare zero o più delle opzioni seguenti che sono rilevanti solo nel contesto di una tabella temporanea.

Valore	Significato
JET_bitColumnTTDescending	L'ordinamento della colonna chiave per la tabella temporanea deve essere decrescente anziché crescente. Se questa opzione viene specificata senza JET_bitColumnTTKey, questa opzione viene ignorata.
JET_bitColumnTTKey	La colonna sarà una colonna chiave per la tabella temporanea. L'ordine delle definizioni di colonna con questa opzione specificata nella matrice di input determina la precedenza di ogni colonna chiave per la tabella temporanea. La prima definizione di colonna nella matrice con questo set di opzioni sarà la colonna chiave più significativa e così via. Se sono richieste più colonne chiave di quanto possa essere supportato dal motore di database, questa opzione viene ignorata per le colonne chiave non supportate.

ccolumn

Vedere prgcolumndef.

lcid

ID delle impostazioni locali da usare per confrontare i dati delle colonne chiave Unicode nella tabella temporanea.

Tutte le impostazioni locali possono essere usate finché il Language Pack appropriato è stato installato nel computer. L'eccezione è che le impostazioni locali language neutral (LCID pari a zero) sono illegali.

In Windows Server 2003 e versioni successive, se le impostazioni locali Language Neutral vengono specificate per questo parametro, verrà invece usato l'ID delle impostazioni locali predefinite (inglese U.S. ). Si tratta di consentire a un valore pari a zero di firmare il valore predefinito anziché un valore illegale.

Quando questo parametro non è presente e quando il parametro pidxunicode non è presente, verrà usato l'LCID predefinito per confrontare i dati di colonna chiave Unicode nella tabella temporanea. LCID predefinito è le impostazioni locali inglese degli Stati Uniti.

grbit

Un gruppo di bit che contengono le opzioni da usare per questa chiamata, che includono zero o più dei seguenti.

Valore	Significato
JET_bitTTErrorOnDuplicateInsertion	Questa opzione richiede che qualsiasi tentativo di inserimento di un record con la stessa chiave di indice di un record inserito in precedenza avrà esito negativo immediatamente con JET_errKeyDuplicate. Se questa opzione non viene richiesta, un duplicato può essere rilevato immediatamente e può essere rimosso in modo silenzioso in seguito a seconda della strategia scelta dal motore di database per implementare la tabella temporanea in base alla funzionalità richiesta. Se questa funzionalità non è necessaria, è preferibile non richiederla. Se questa funzionalità non è richiesta, la gestione tabelle temporanee può essere in grado di scegliere una strategia per la gestione della tabella temporanea che comporterà un miglioramento delle prestazioni.
JET_bitTTForceMaterialization	Questa opzione impone al gestore tabelle temporanee di abbandonare qualsiasi tentativo di scegliere una strategia intelligente per la gestione della tabella temporanea che comporterà prestazioni migliorate.
JET_bitTTForwardOnly	Questa opzione richiede che la tabella temporanea venga creata solo se la gestione tabelle temporanee può usare l'implementazione ottimizzata per i risultati delle query intermedie. Se una caratteristica della tabella temporanea impedisce l'uso di questa ottimizzazione, l'operazione avrà esito negativo con JET_errCannotMaterializeForwardOnlySort. Un effetto collaterale di questa opzione consiste nell'consentire alla tabella temporanea di contenere record con chiavi di indice duplicate. Per altre informazioni, vedere JET_bitTTUnique. Questa opzione è disponibile solo nelle versioni di Windows Server 2003 e versioni successive.
JET_bitTTIndexed	Questa opzione richiede che la tabella temporanea sia abbastanza flessibile per consentire l'uso di JetSeek per cercare i record in base alla chiave di indice. Se questa funzionalità non è necessaria, è preferibile non richiederla. Se questa funzionalità non è richiesta, la gestione tabelle temporanee può essere in grado di scegliere una strategia per la gestione della tabella temporanea che comporterà un miglioramento delle prestazioni.
JET_bitTTScrollable	Questa opzione richiede che la tabella temporanea sia abbastanza flessibile per consentire l'analisi dei record in ordine arbitrario e direzione usando JetMove. Se questa funzionalità non è necessaria, è preferibile non richiederla. Se questa funzionalità non è richiesta, la gestione tabelle temporanee può essere in grado di scegliere una strategia per la gestione della tabella temporanea che comporterà un miglioramento delle prestazioni.
JET_bitTTSortNullsHigh	Questa opzione richiede che i valori di colonna chiave NULL siano ordinati più vicino alla fine dell'indice rispetto ai valori di colonna chiave NON NULL.
JET_bitTTUnique	Questa opzione richiede che i record con chiavi di indice duplicati vengano rimossi dal set finale di record nella tabella temporanea. Prima di Windows Server 2003, il motore di database ha sempre assunto questa opzione a causa del fatto che tutti gli indici cluster devono essere anche una chiave primaria e quindi devono essere univoci. A partire da Windows Server 2003, è ora possibile creare una tabella temporanea che non rimuove duplicati quando viene specificata anche l'opzione JET_bitTTForwardOnly. Non è possibile sapere quale duplicato vincerà e quali duplicati verranno eliminati in generale. Tuttavia, quando l'opzione JET_bitTTErrorOnDuplicateInsertion viene richiesta, il primo record con una determinata chiave di indice da inserire nella tabella temporanea verrà sempre vinto.
JET_bitTTUpdatable	Questa opzione richiede che la tabella temporanea sia abbastanza flessibile per consentire la modifica dei record inseriti in precedenza. Se questa funzionalità non è necessaria, è preferibile non richiederla. Se questa funzionalità non è richiesta, la gestione tabelle temporanee può essere in grado di scegliere una strategia per la gestione della tabella temporanea che comporterà un miglioramento delle prestazioni.
JET_bitTTIntrinsicLVsOnly	Richieste per consentire solo valori intrinseci a lungo termine. Windows 7: JET_bitTTIntrinsicLVsOnly è stato introdotto in Windows 7.

ptableid

Buffer di output che riceverà il nuovo cursore aperto nella tabella temporanea appena creata.

prgcolumnid

Buffer di output che riceverà la matrice di ID di colonna generati durante la creazione della tabella temporanea.

Gli ID di colonna in questa matrice corrispondono esattamente alla matrice di input delle definizioni di colonna. Di conseguenza, le dimensioni di questo buffer devono corrispondere alle dimensioni della matrice di input.

Valore restituito

Questa funzione restituisce il tipo di dati JET_ERR con uno dei codici restituiti seguenti. Per altre informazioni sugli errori ESE possibili, vedere Errori del motore di archiviazione estendibili e parametri di gestione degli errori.

Codice restituito	Descrizione
JET_errSuccess	Operazione riuscita.
JET_errCannotMaterializeForwardOnlySort	JetOpenTempTable2 non è riuscito perché è stato specificato JET_bitTTForwardOnly e la tabella temporanea come specificato non è stato possibile creare usando l'ottimizzazione solo in avanti. Questo errore verrà restituito solo da Windows Server 2003 e versioni successive.
JET_errClientRequestToStopJetService	Non è possibile completare l'operazione perché tutte le attività nell'istanza associata alla sessione non sono state interrotte in seguito a una chiamata a JetStopService.
JET_errInstanceUnavailable	Non è possibile completare l'operazione perché l'istanza associata alla sessione ha rilevato un errore irreversibile che richiede che l'accesso a tutti i dati venga revocato per proteggere l'integrità dei dati. Questo errore verrà restituito solo da Windows XP e versioni successive.
JET_errInvalidCodePage	Il campo cp della 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 campo coltyp del JET_COLUMNDEF non è stato impostato su un tipo di colonna valido.
JET_errIndexInvalidDef	Impossibile creare l'indice perché è stata specificata una definizione di indice non valida. JetOpenTempTable2 restituirà questo errore quando: Sono specificate le impostazioni locali Language Neutral. Viene specificato un set non valido di flag di normalizzazione. Questo errore verrà restituito solo da Windows 2000.
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. Questo errore verrà restituito solo da Windows XP e versioni successive. In Windows 2000 i flag di normalizzazione non validi genereranno invece JET_errIndexInvalidDef.
JET_errNotInitialized	Non è possibile completare l'operazione perché l'istanza associata alla sessione non è ancora stata inizializzata.
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_errOutOfMemory	L'operazione non è riuscita perché non è possibile allocare memoria sufficiente per completarla. JetOpenTempTable2 può restituire JET_errOutOfMemory se lo spazio degli indirizzi del processo host diventa troppo frammentato. Gestione tabelle temporanee allocherà sempre un blocco di 1 MB di spazio indirizzi per ogni tabella temporanea creata indipendentemente dalla quantità di dati da archiviare.
JET_errRestoreInProgress	Non è possibile 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. Questo errore verrà restituito solo da Windows XP e versioni successive.
JET_errTermInProgress	Non è possibile completare l'operazione perché l'istanza associata alla sessione viene arrestata.
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_errTooManyOpenIndexes	L'operazione non è riuscita perché il motore non può allocare le risorse necessarie per memorizzare nella cache gli indici della tabella. Il numero di indici il cui schema può essere memorizzato nella cache viene configurato usando JetSetSystemParameter con JET_paramMaxOpenTables.
JET_errTooManyOpenTables	Operazione non riuscita perché il motore non può allocare le risorse necessarie per memorizzare nella cache lo schema della tabella. Il numero di tabelle il cui schema può essere memorizzato nella cache viene configurato usando JetSetSystemParameter con JET_paramMaxOpenTables.
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.

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

Vedere JetOpenTempTable.

Requisiti

Requisito	Valore
Client	Richiede Windows Vista, Windows XP o Windows 2000 Professional.
Server	Richiede Windows Server 2008, Windows Server 2003 o Windows 2000 Server.
Intestazione	Dichiarato in Esent.h.
Libreria	Usare ESENT.lib.
DLL	Richiede ESENT.dll.

Vedere anche

JET_COLUMNDEF
JET_COLUMNID
JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_UNICODEINDEX
JetCloseTable
JetCreateTableColumnIndex
JetDupCursor
JetMove
JetRollback
JetSeek
JetSetSystemParameter
Parametri di sistema