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

  • Статья

Применимо к: SQL Server Azure SQL DatabaseУправляемый экземпляр SQL AzureAzure Synapse AnalyticsAnalytics Platform System (PDW)

Приложение может получать метаданные для вызова подготовленной процедуры с помощью SQLNumParams и SQLDescribeParam. Для возвращающего табличное значение параметров dataTypePtr имеет значение SQL_SS_TABLE. В SQLGetDescField доступны дополнительные метаданные для SQL_CA_SS_TYPE_NAME, SQL_CA_SS_CATALOG_NAME и SQL_CA_SS_SCHEMA_NAME.

SQL_CA_SS_TYPE_NAME, SQL_CA_SS_CATALOG_NAME и SQL_CA_SS_SCHEMA_NAME можно использовать с SQLColumns для получения метаданных столбцов для типов таблиц, связанных с возвращающей табличное значение параметрами. В этом случае перед вызовом SQLColumns SQL_SOPT_SS_NAME_SCOPE необходимо задать значение SQL_SS_NAME_SCOPE_TABLE_TYPE. После получения метаданных столбца, соответствующего возвращающему табличное значение параметру, параметр SQL_SOPT_SS_NAME_SCOPE необходимо установить обратно в значение по умолчанию — SQL_SS_NAME_SCOPE_TABLE.

Параметры SQL_CA_SS_TYPE_NAME, SQL_CA_SS_TYPE_CATALOG_NAME и SQL_CA_SS_TYPE_SCHEMA_NAME также могут использоваться с параметрами определяемых пользователем типов данных CLR.

Для подготовленных инструкций, не являющихся вызовами хранимых процедур, нельзя получить метаданные возвращающего табличные значения параметра. При попытке выполнения данного действия приложение возвращает ошибку SQL_ERROR с кодом SQLSTATE 42000 и сообщение «Синтаксическая ошибка или нарушение доступа».

См. также:

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