Множественные результаты
Результатом является то, что возвращается источником данных после выполнения инструкции. ODBC имеет два типа результатов: результирующие наборы и счетчики строк. Количество строк — это количество строк, затронутых инструкцией обновления, удаления или вставки. Пакеты, описанные в пакетах инструкций SQL, могут создавать несколько результатов.
В следующей таблице перечислены параметры SQLGetInfo , которые приложение использует для определения того, возвращает ли источник данных несколько результатов для каждого типа пакета. В частности, источник данных может возвращать одно число строк для всего пакета инструкций или отдельных счетчиков строк для каждой инструкции в пакете. В случае инструкции создания результирующих наборов, выполняемой с массивом параметров, источник данных может возвращать один результирующий набор для всех наборов параметров или отдельных результирующих наборов для каждого набора параметров.
| Тип пакетной службы | Количество строк | Результирующие наборы |
|---|---|---|
| Явный пакет | SQL_BATCH_ROW_COUNT[a] | --[b] |
| Процедура | SQL_BATCH_ROW_COUNT[a] | --[b] |
| Массивы параметров | SQL_PARAM_ARRAYS_ROW_COUNTS | SQL_PARAM_ARRAYS_SELECTS |
[a] Операторы подсчета строк в пакете могут поддерживаться, но возврат счетчиков строк не поддерживается. Параметр SQL_BATCH_SUPPORT в SQLGetInfo указывает, разрешены ли инструкции подсчета строк в пакетах; параметр SQL_BATCH_ROW_COUNTS указывает, возвращаются ли эти счетчики строк приложению.
[b] Явные пакеты и процедуры всегда возвращают несколько результирующих наборов при включении нескольких инструкций создания результирующих наборов.
Примечание.
Параметр SQL_MULT_RESULT_SETS, представленный в ODBC 1.0, предоставляет только общие сведения о том, можно ли возвращать несколько результирующих наборов. В частности, оно имеет значение "Y", если SQL_BS_SELECT_EXPLICIT или SQL_BS_SELECT_PROC биты возвращаются для SQL_BATCH_SUPPORT или если SQL_PAS_BATCH возвращается для SQL_PARAM_ARRAYS_SELECT.
Для обработки нескольких результатов приложение вызывает SQLMoreResults. Эта функция не карта текущего результата и делает следующий результат доступным. Он возвращает SQL_NO_DATA, если нет дополнительных результатов. Например, предположим, что следующие инструкции выполняются как пакет:
SELECT * FROM Parts WHERE Price > 100.00;
UPDATE Parts SET Price = 0.9 * Price WHERE Price > 100.00
После выполнения этих инструкций приложение извлекает строки из результированного набора, созданного инструкцией SELECT . Когда выполняется получение строк, он вызывает SQLMoreResults , чтобы сделать доступное количество частей, которые были повторялись. При необходимости SQLMoreResults не карта извлекает неуправляемые строки и закрывает курсор. Затем приложение вызывает SQLRowCount , чтобы определить, сколько частей было повторно инструкцией UPDATE .
Это зависит от драйвера, выполняется ли весь пакетный оператор до того, как будут доступны результаты. В некоторых реализациях это так. в других службах вызов SQLMoreResults активирует выполнение следующей инструкции в пакете.
Если одна из инструкций в пакете завершается ошибкой, SQLMoreResults возвращает SQL_ERROR или SQL_SUCCESS_WITH_INFO. Если пакет был прерван, когда инструкция завершилась сбоем или не удалось выполнить последнюю инструкцию в пакете, SQLMoreResults вернет SQL_ERROR. Если пакет не был прерван при сбое инструкции, а не последняя инструкция в пакете, SQLMoreResults вернет SQL_SUCCESS_WITH_INFO. SQL_SUCCESS_WITH_INFO указывает, что был создан хотя бы один результирующий набор или число, и что пакет не был прерван.