Возвращающие табличное значение параметры (ODBC)

Применимо: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure azure Synapse Analytics Analytics Platform System (PDW)

Поддержка в ODBC возвращающих табличное значение параметров позволяет клиентским приложениям с большей эффективностью передавать параметризованные данные на сервер за счет передачи нескольких строк в ходе одного вызова.

Сведения о табличном значении параметров на сервере см. в разделе "Использование параметров с табличным значением" (ядро СУБД).

В ODBC существует два способа передачи на сервер возвращающих табличное значение параметров.

• Все данные табличного параметра могут находиться в памяти во время вызова SQLExecDirect или SQLExecute. Эти данные хранятся в массивах, если в табличном значении имеется несколько строк.

• Приложение может указать данные при выполнении для табличного параметра при вызове SQLExecDirect или SQLExecute. В этом случае строки данных для табличного значения могут быть представлены в пакетах или по одному, чтобы снизить требования, предъявляемые к памяти.

В первом случае хранимые процедуры могут инкапсулировать дополнительные объемы бизнес-логики. К примеру, если элементы заказа передаются в виде возвращающего табличное значение параметра, одна хранимая процедура может инкапсулировать целую транзакцию по приему заказов. Этот параметр очень эффективен, поскольку предполагает только одно обращение к серверу. Существует и другая возможность: использовать одни процедуры для обработки заголовка заказа, а другие – для элементов заказа, но в этом случае потребуется дополнительный код и более сложный контракт между клиентом и сервером.

Второй метод представляет собой эффективный механизм для выполнения массовых операций с очень большими объемами данных. Это дает приложению возможность осуществлять потоковую передачу строк данных на сервер без предварительной буферизации их в памяти.

При создании этой табличной переменной можно формировать ограничения и первичные ключи. Ограничения дают хорошую гарантию того, что данные таблицы соответствуют определенным требованиям.

В этом разделе

Сценарии использования возвращающих табличное значение параметров ODBC
Описывает основные пользовательские сценарии для возвращающих табличное значение параметров и ODBC.

Тип ODBC SQL для параметров, возвращающих табличное значение
Описывает тип SQL_SS_TABLE. Это новый тип ODBC SQL, поддерживающий возвращающие табличное значение параметры.

Поля дескрипторов возвращающего табличное значение параметра
Описывает поля дескриптора, которые поддерживают возвращающие табличное значение параметры.

Поля дескриптора для столбцов, содержащих параметры, возвращающие табличные значения
Описывает поля дескриптора, имеющие смысл для возвращающих табличное значение параметров.

Поля диагностических записей для возвращающих табличные значения параметров
Описывает два диагностических поля, добавленных к диагностическим записям для поддержки параметров, возвращающих табличное значение.

Атрибуты инструкции, влияющие на возвращающие табличное значение параметры
Описывает новое поле заголовка дескриптора, активирующее столбцы с возвращающими табличное значение параметрами, к которым будет осуществляться обращение.

Привязка и передача данных возвращающих табличное значение параметров и значений столбцов
Описывает привязку параметров и разъясняет, как передавать серверу возвращающий табличное значение параметр.

Метаданные возвращающего табличное значение параметра для подготовленных инструкций
Описывает, как приложение может получить метаданные для заготовленного вызова процедуры.

Дополнительные метаданные возвращающего табличное значение параметра
Описывает использование SQLProcedureColumns, SQLTables и SQLColumns для получения метаданных для параметра с табличным значением.

Ошибки и предупреждения преобразования данных возвращающих табличное значение параметров и другие
Описывает, как обрабатывать ошибки в значениях столбцов с возвращающими табличное значение параметрами.

Совместимость версий
Описывает конфликты, которые могут возникать, когда табличное значение параметров используются клиентом или сервером версии более ранней версии, чем SQL Server 2008 (10.0.x).

Сводка по API-интерфейсам возвращающих табличное значение параметров ODBC
Приводит перечень функций ODBC, которые поддерживают возвращающие табличное значение параметры.

См. также

SQL Server Native Client (ODBC)
Возвращающие табличное значение параметры (SQL Server Native Client)