Функция JetOpenTempTable2
Применимо к: Windows | Windows Server
Функция JetOpenTempTable2
Функция JetOpenTempTable2 создает временную таблицу с одним индексом, который можно использовать для хранения и извлечения записей так же, как обычная таблица, созданная с помощью JetCreateTableColumnIndex. Эта функция также имеет идентификатор языкового стандарта, который можно использовать для сравнения данных ключевого столбца Юникода во временной таблице. Однако временные таблицы выполняются гораздо быстрее, чем обычные таблицы из-за их нестабильной природы. Их также можно использовать для очень быстрой сортировки и удаления дубликатов наборов записей при доступе исключительно последовательно.
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
);
Параметры
sesid
Используемый сеанс.
prgcolumndef
Определения столбцов, создаваемых во временной таблице.
Существуют важные ограничения для параметров определения столбцов, используемых с временной таблицей. Дополнительные сведения см. в разделе "Примечания".
Помимо обычных параметров определения столбцов, можно также указать ноль или несколько следующих параметров, которые актуальны только в контексте временной таблицы.
Значение |
Значение |
|---|---|
JET_bitColumnTTDescending |
Порядок сортировки ключевого столбца для временной таблицы должен быть по убыванию, а не по возрастанию. Если этот параметр указан без JET_bitColumnTTKey этот параметр игнорируется. |
JET_bitColumnTTKey |
Столбец будет ключевым для временной таблицы. Порядок определений столбцов с этим параметром, заданным во входном массиве, определяет приоритет каждого ключевого столбца для временной таблицы. Первым определением столбца в массиве с этим набором параметров будет наиболее значимый ключевой столбец и т. д. Если запрашивается больше ключевых столбцов, чем поддерживается ядром СУБД, этот параметр игнорируется для неподдерживаемых ключевых столбцов. |
ccolumn
См. prgcolumndef.
lcid
Идентификатор языкового стандарта, используемый для сравнения любых данных столбца ключа Юникода во временной таблице.
Можно использовать любой языковой стандарт, если на компьютере установлен соответствующий языковой пакет. Исключением является то, что языковой стандарт нейтрализуемого языка (LCID с нулевым значением) является недопустимым.
В Windows Server 2003 и более поздних версиях, если для этого параметра указан языковой стандарт, не зависящий от языка, вместо него будет использоваться идентификатор языкового стандарта по умолчанию (английский язык США). Это позволяет нулю означать значение по умолчанию, а не недопустимое значение.
Если этот параметр отсутствует, а параметр pidxunicode отсутствует, для сравнения всех данных ключевого столбца Юникода во временной таблице будет использоваться LCID по умолчанию. По умолчанию LCID используется английский языковой стандарт США.
grbit
Группа битов, содержащих параметры, которые будут использоваться для этого вызова, которые включают ноль или более из следующих значений.
Значение |
Значение |
|---|---|
JET_bitTTErrorOnDuplicateInsertion |
Этот параметр запрашивает, чтобы любая попытка вставки записи с тем же ключом индекса, что и ранее вставленная запись, немедленно завершалась сбоем с JET_errKeyDuplicate. Если этот параметр не запрашивается, то дубликата может быть обнаружена немедленно и неудачно или удалена автоматически позже в зависимости от стратегии, выбранной ядром СУБД для реализации временной таблицы на основе запрошенных функциональных возможностей. Если эта функция не требуется, лучше не запрашивать ее. Если эта функция не запрашивается, диспетчер временных таблиц может выбрать стратегию управления временной таблицей, что приведет к повышению производительности. |
JET_bitTTForceMaterialization |
Этот параметр заставляет временного диспетчера таблиц отказаться от любых попыток выбрать умную стратегию управления временной таблицей, которая приведет к повышению производительности. |
JET_bitTTForwardOnly |
Этот параметр запрашивает создание временной таблицы только в том случае, если временный диспетчер таблиц может использовать реализацию, оптимизированную для промежуточных результатов запроса. Если какая-либо характеристика временной таблицы не позволит использовать эту оптимизацию, операция завершится сбоем с JET_errCannotMaterializeForwardOnlySort. Побочным эффектом этого параметра является разрешение временной таблице содержать записи с повторяющимися ключами индекса. Дополнительные сведения см. в разделе JET_bitTTUnique. Этот параметр доступен только в Windows Server 2003 и более поздних выпусках. |
JET_bitTTIndexed |
Этот параметр требует, чтобы временная таблица была достаточно гибкой, чтобы использовать JetSeek для поиска записей по ключу индекса. Если эта функция не требуется, лучше не запрашивать ее. Если эта функция не запрашивается, диспетчер временных таблиц может выбрать стратегию управления временной таблицей, что приведет к повышению производительности. |
JET_bitTTScrollable |
Этот параметр требует, чтобы временная таблица была достаточно гибкой, чтобы разрешить сканирование записей в произвольном порядке и направлении с помощью JetMove. Если эта функция не требуется, лучше не запрашивать ее. Если эта функция не запрашивается, диспетчер временных таблиц может выбрать стратегию управления временной таблицей, что приведет к повышению производительности. |
JET_bitTTSortNullsHigh |
Этот параметр запрашивает сортировку значений ключевого столбца NULL ближе к концу индекса, чем значения столбцов, отличных от NULL. |
JET_bitTTUnique |
Этот параметр запрашивает удаление записей с повторяющимися ключами индекса из окончательного набора записей во временной таблице. До Windows Server 2003 ядро СУБД всегда предполагало, что этот параметр действует, так как все кластеризованные индексы также должны быть первичными и, следовательно, должны быть уникальными. В Windows Server 2003 теперь можно создать временную таблицу, которая не удаляет дубликаты при указании параметра JET_bitTTForwardOnly. Невозможно узнать, какие дубликаты выиграют, а какие будут удалены в целом. Однако при запросе параметра JET_bitTTErrorOnDuplicateInsertion первая запись с заданным ключом индекса, вставляемая во временную таблицу, всегда выигрывает. |
JET_bitTTUpdatable |
Этот параметр требует, чтобы временная таблица была достаточно гибкой, чтобы разрешить последующее изменение записей, которые были вставлены ранее. Если эта функция не требуется, лучше не запрашивать ее. Если эта функция не запрашивается, диспетчер временных таблиц может выбрать стратегию управления временной таблицей, что приведет к повышению производительности. |
JET_bitTTIntrinsicLVsOnly |
Запрашивает разрешение только внутренних длинных значений. Windows 7: JET_bitTTIntrinsicLVsOnly появилась в Windows 7. |
ptableid
Выходной буфер, который получит новый курсор, открытый во вновь созданной временной таблице.
prgcolumnid
Выходной буфер, который получит массив идентификаторов столбцов, созданных во время создания временной таблицы.
Идентификаторы столбцов в этом массиве в точности соответствуют входному массиву определений столбцов. В результате размер этого буфера должен соответствовать размеру входного массива.
Возвращаемое значение
Эта функция возвращает тип данных JET_ERR с одним из следующих кодов возврата. Дополнительные сведения о возможных ошибках ESE см. в разделах Ошибки подсистемы расширяемого хранилища и Параметры обработки ошибок.
Код возврата |
Описание |
|---|---|
JET_errSuccess |
Операция выполнена успешно. |
JET_errCannotMaterializeForwardOnlySort |
Сбой JetOpenTempTable2 , так как был указан JET_bitTTForwardOnly и не удалось создать временную таблицу, как указано, с помощью оптимизации только для пересылки. Эта ошибка будет возвращена только в Windows Server 2003 и более поздних выпусках. |
JET_errClientRequestToStopJetService |
Невозможно выполнить операцию, так как все действия экземпляра, связанного с сеансом, прекратились в результате вызова JetStopService. |
JET_errInstanceUnavailable |
Невозможно выполнить операцию, так как экземпляр, связанный с сеансом, столкнулся с неустранимой ошибкой, требующей отмены доступа ко всем данным для защиты целостности этих данных. Эта ошибка будет возвращена только в Windows XP и более поздних выпусках. |
JET_errInvalidCodePage |
Для поля cp JET_COLUMNDEF не задана допустимая кодовая страница. Единственными допустимыми значениями текстовых столбцов являются английский (1252) и Юникод (1200). Значение 0 означает, что будет использоваться значение по умолчанию (английский язык, 1252). |
JET_errInvalidColumnType |
Для поля coltypJET_COLUMNDEF не задан допустимый тип столбца. |
JET_errIndexInvalidDef |
Не удалось создать индекс, так как указано недопустимое определение индекса. JetOpenTempTable2 вернет эту ошибку, если:
Эта ошибка будет возвращена только Windows 2000. |
JET_errInvalidLanguageId |
Не удалось создать индекс, так как была предпринята попытка использовать недопустимый идентификатор языкового стандарта. Код языкового стандарта может быть либо полностью недопустимым, либо не установлен соответствующий языковой пакет. |
JET_errInvalidLCMapStringFlags |
Не удалось создать индекс, так как была предпринята попытка использовать недопустимый набор флагов нормализации. Эта ошибка будет возвращена только в Windows XP и более поздних выпусках. В Windows 2000 недопустимые флаги нормализации приведут к JET_errIndexInvalidDef. |
JET_errNotInitialized |
Невозможно выполнить операцию, так как экземпляр, связанный с сеансом, еще не инициализирован. |
JET_errOutOfCursors |
Операция завершилась сбоем, так как подсистеме не удается выделить ресурсы, необходимые для открытия нового курсора. Ресурсы курсора настраиваются с помощью JetSetSystemParameter с JET_paramMaxCursors. |
JET_errOutOfMemory |
Операция завершилась сбоем, так как для ее завершения было выделено недостаточно памяти. JetOpenTempTable2 может возвращать JET_errOutOfMemory, если адресное пространство хост-процесса становится слишком фрагментировано. Диспетчер временных таблиц всегда выделяет блок адресного пространства размером 1 МБ для каждой созданной временной таблицы независимо от объема хранимых данных. |
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. |
При успешном выполнении будет возвращен курсор, открытый во вновь созданной временной таблице. Состояние временной базы данных будет подготовлено для размещения новой временной таблицы. Состояние всех обычных баз данных, используемых ядром СУБД, останется неизменным.
В случае сбоя временная таблица не будет создана, и курсор не будет возвращен. Состояние временной базы данных может быть изменено. Состояние всех обычных баз данных, используемых ядром СУБД, останется неизменным.
Комментарии
Требования
| Требование | Значение |
|---|---|
Клиент |
Требуется Windows Vista, Windows XP или Windows 2000 Профессиональная. |
Сервер |
Требуется 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
Системные параметры