Функция 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 вернет эту ошибку, если:

  • Указан языковой стандарт Language Neutral.

  • Указан недопустимый набор флагов нормализации.

Эта ошибка будет возвращена только 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.

При успешном выполнении будет возвращен курсор, открытый во вновь созданной временной таблице. Состояние временной базы данных будет подготовлено для размещения новой временной таблицы. Состояние всех обычных баз данных, используемых ядром СУБД, останется неизменным.

В случае сбоя временная таблица не будет создана, и курсор не будет возвращен. Состояние временной базы данных может быть изменено. Состояние всех обычных баз данных, используемых ядром СУБД, останется неизменным.

Комментарии

См. раздел JetOpenTempTable.

Требования

Требование Значение

Клиент

Требуется 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
Системные параметры