SQLSetStmtAttr
适用于：
SQL Server Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics Analytics 平台系统（PDW）
SQL Server Native Client ODBC 驱动程序不支持混合（键集/动态）游标模型。 如果将该值设置为非 0 值，尝试使用 SQL_ATTR_KEYSET_SIZE 设置键集大小将失败。
应用程序对所有语句设置SQL_ATTR_ROW_ARRAY_SIZE，以声明 SQLFetch 或 SQLFetchScroll 函数调用中返回的行数。 在指示服务器游标的语句中，驱动程序使用 SQL_ATTR_ROW_ARRAY_SIZE 确定服务器为满足游标的提取请求而生成的行块的大小。 在动态游标的块大小内，如果事务隔离级别足以确保对已提交事务的可重复读取，行的成员身份和顺序则是固定的。 游标在该值指示的块之外完全处于动态状态。 服务器游标块大小完全处于动态状态，并且可以在提取过程中的任一点更改。
SQLSetStmtAttr 和表值参数
在访问表值参数列的描述符字段之前，可以使用 SQLSetStmtAttr 在应用程序参数描述符（APD）中设置SQL_SOPT_SS_PARAM_FOCUS。
如果尝试将SQL_SOPT_SS_PARAM_FOCUS设置为非表值参数的参数序号，则 SQLSetStmtAttr 将返回SQL_ERROR，并使用 SQLSTATE = HY024 和消息“无效属性值”创建诊断记录。 返回 SQL_ERROR 时，不更改 SQL_SOPT_SS_PARAM_FOCUS。
将 SQL_SOPT_SS_PARAM_FOCUS 设置为 0 可以恢复对参数的描述符记录的访问权限。
SQLSetStmtAttr 还可用于设置SQL_SOPT_SS_NAME_SCOPE。 有关详细信息，请参阅本主题后面的 SQL_SOPT_SS_NAME_SCOPE 部分。
有关详细信息，请参阅 已准备语句的表值参数元数据。
有关表值参数的详细信息，请参阅表值参数（ODBC）。
SQLSetStmtAttr 对稀疏列的支持
SQLSetStmtAttr 可用于设置SQL_SOPT_SS_NAME_SCOPE。 有关详细信息，请参阅本主题后面的SQL_SOPT_SS_NAME_SCOPE部分。有关稀疏列的详细信息，请参阅稀疏列支持（ODBC）。
语句属性
SQL Server Native Client ODBC 驱动程序还支持以下特定于驱动程序的语句属性。
SQL_SOPT_SS_CURSOR_OPTIONS
SQL_SOPT_SS_CURSOR 属性指定驱动程序是否将在游标上使用特定于驱动程序的性能选项。 设置这些选项时，不允许使用 SQLGetData 。 默认设置为 SQL_CO_OFF。 ValuePtr 值的类型为 SQLLEN。
| ValuePtr 值 | 说明 |
|---|---|
| SQL_CO_OFF | 默认。 禁用快速向前、只读游标和自动提取，在仅向前只读游标上启用 SQLGetData 。 将 SQL_SOPT_SS_CURSOR_OPTIONS 设置为 SQL_CO_OFF 时，游标类型将不会发生更改。 也就是说，快速只进游标将保持为快速只进游标。 若要更改游标类型，应用程序现在必须使用 SQLSetStmtAttr/SQL_ATTR_CURSOR_TYPE设置不同的游标类型。 |
| SQL_CO_FFO | 启用快速向前只读游标，在 仅向前的只读游标上禁用 SQLGetData 。 |
| SQL_CO_AF | 针对任意游标类型启用自动提取选项。 为语句句柄设置此选项时， SQLExecute 或 SQLExecDirect 将生成隐式 SQLFetchScroll （SQL_FIRST）。 此时将打开游标，并在与服务器的单个往返中返回第一批行。 |
| SQL_CO_FFO_AF | 使用自动提取选项启用快速只进游标。 它与同时指定 SQL_CO_AF 和 SQL_CO_FFO 的效果相同。 |
当设置这些选项时，服务器将在检测到已提取最后一行时自动关闭游标。 应用程序仍必须调用 SQLFreeStmt （SQL_CLOSE） 或 SQLCloseCursor，但驱动程序不必将关闭通知发送到服务器。
如果选择列表包含文本、ntext 或图像列，则仅快进游标将转换为动态游标，并允许使用 SQLGetData。
SQL_SOPT_SS_DEFER_PREPARE
SQL_SOPT_SS_DEFER_PREPARE属性确定语句是立即准备还是推迟 到执行 SQLExecute、 SQLDescribeCol 或 SQLDescribeParam 。 在 SQL Server 7.0 及更早版本中，此属性将被忽略（无延迟准备）。 ValuePtr 值的类型为 SQLLEN。
| ValuePtr 值 | 说明 |
|---|---|
| SQL_DP_ON | 默认。 调用 SQLPrepare 函数后，语句准备将推迟到 调用 SQLExecute 或元属性操作（SQLDescribeCol 或 SQLDescribeParam）执行。 |
| SQL_DP_OFF | 执行 SQLPrepare 后，立即准备该语句。 |
SQL_SOPT_SS_REGIONALIZE
SQL_SOPT_SS_REGIONALIZE 属性用于确定语句级别的数据转换。 该属性使驱动程序在将日期、时间和货币值转换为字符串时遵循客户端区域设置。 此转换仅从 SQL Server 本机数据类型转换为字符串。
ValuePtr 值的类型为 SQLLEN。
| ValuePtr 值 | 说明 |
|---|---|
| SQL_RE_OFF | 默认。 驱动程序不能将日期、时间和货币数据转换为使用客户端区域设置的字符串。 |
| SQL_RE_ON | 驱动程序在将日期、时间和货币数据转换为字符串数据时使用客户端区域设置。 |
区域转换设置应用于货币、数字、日期和时间数据类型。 转换设置仅适用于将货币、数字、日期或时间值转换为字符串的输出转换。
注意
当启用语句选项 SQL_SOPT_SS_REGIONALIZE 时，驱动程序使用当前用户的区域设置注册表设置。 如果应用程序设置当前线程的区域设置，则驱动程序不遵循当前线程的区域设置，例如调用 SetThreadLocale。
改变数据源的区域行为可能导致应用程序失败。 对于分析日期字符串并期望日期字符串按 ODBC 定义的方式显示的应用程序，更改该值可能会对它们产生负面影响。
SQL_SOPT_SS_TEXTPTR_LOGGING
SQL_SOPT_SS_TEXTPTR_LOGGING属性切换包含 文本 或 图像 数据的列的操作日志记录。 ValuePtr 值的类型为 SQLLEN。
| ValuePtr 值 | 说明 |
|---|---|
| SQL_TL_OFF | 禁用对 文本 和 图像 数据执行的操作的日志记录。 |
| SQL_TL_ON | 默认。 启用对 文本 和 图像 数据执行的操作的日志记录。 |
SQL_SOPT_SS_HIDDEN_COLUMNS
SQL_SOPT_SS_HIDDEN_COLUMNS属性在结果集中公开 SQL Server SELECT FOR BROWSE 语句中隐藏的列。 默认情况下，驱动程序不公开这些列。 ValuePtr 值的类型为 SQLLEN。
| ValuePtr 值 | 说明 |
|---|---|
| SQL_HC_OFF | 默认。 结果集中不显示 FOR BROWSE 列。 |
| SQL_HC_ON | 公开 FOR BROWSE 列。 |
SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT
SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT 属性返回查询通知请求的消息文本。
SQL_SOPT_SS_QUERYNOTIFICATION_OPTIONS
SQL_SOPT_SS_QUERYNOTIFICATION_OPTIONS 属性指定用于查询通知请求的选项。 这些选项是在采用 name=value 语法的字符串中指定的，如下所示。 应用程序负责创建服务并从队列中读取通知。
查询通知选项字符串的语法为：
service=<service-name>[;(local database=<database>|broker instance=<broker instance>)]
例如：
service=mySSBService;local database=mydb
SQL_SOPT_SS_QUERYNOTIFICATION_TIMEOUT
SQL_SOPT_SS_QUERYNOTIFICATION_TIMEOUT 属性指定查询通知保持活动状态的秒数。 默认值为 432000 秒（5 天）。 ValuePtr 值的类型为 SQLLEN。
SQL_SOPT_SS_PARAM_FOCUS
SQL_SOPT_SS_PARAM_FOCUS属性指定后续 SQLBindParameter、SQLGetDescField、SQLSetDescField、SQLGetDescRec 和 SQLSetDescRec 调用的焦点。
SQL_SOPT_SS_PARAM_FOCUS 的类型为 SQLULEN。
默认值为 0，表示这些调用将对与 SQL 语句中的参数标记相对应的参数进行寻址。 当设置为表值参数的参数编号时，这些调用将对该表值参数的列进行寻址。 当设置的值不是表值参数的参数编号时，这些调用将返回错误 IM020：“参数焦点未引用表值参数”。
SQL_SOPT_SS_NAME_SCOPE
SQL_SOPT_SS_NAME_SCOPE 属性指定后续目录函数调用的名称范围。 SQLColumns 返回的结果集取决于SQL_SOPT_SS_NAME_SCOPE的设置。
SQL_SOPT_SS_NAME_SCOPE 的类型为 SQLULEN。
| ValuePtr 值 | 说明 |
|---|---|
| SQL_SS_NAME_SCOPE_TABLE | 默认。 当使用表值参数时，指示应返回实际表的元数据。 使用稀疏列功能时，SQLColumns 将仅返回非稀疏 column_set成员的列。 |
| SQL_SS_NAME_SCOPE_TABLE_TYPE | 指示应用程序需要表类型的元数据，而不是实际表（目录函数应返回表类型的元数据）。 然后，应用程序将表值参数的TYPE_NAME作为 TableName 参数传递。 |
| SQL_SS_NAME_SCOPE_EXTENDED | 使用稀疏列功能时，SQLColumns 返回所有列，而不 考虑column_set 成员身份。 |
| SQL_SS_NAME_SCOPE_SPARSE_COLUMN_SET | 使用稀疏列功能时，SQLColumns 仅返回稀疏 column_set成员的列。 |
| SQL_SS_NAME_SCOPE_DEFAULT | 等同于 SQL_SS_NAME_SCOPE_TABLE。 |
SS_TYPE_CATALOG_NAME和SS_TYPE_SCHEMA_NAME分别与 CatalogName 和 SchemaName 参数一起使用，以标识表值参数的目录和架构。 在应用程序检索完表值参数的元数据之后，该应用程序必须将 SQL_SOPT_SS_NAME_SCOPE 设置回原来的默认值 SQL_SS_NAME_SCOPE_TABLE。
将 SQL_SOPT_SS_NAME_SCOPE 设置为 SQL_SS_NAME_SCOPE_TABLE 时，对链接服务器的查询将失败。 对包含服务器组件的目录的 SQLColumns 或 SQLPrimaryKeys 的调用将失败。
如果尝试将 SQL_SOPT_SS_NAME_SCOPE 设置为无效值，则返回 SQL_ERROR，并生成具有 SQLSTATE HY024 和消息“属性值无效”的诊断记录。
如果目录函数是其他目录函数，则在SQL_SOPT_SS_NAME_SCOPE具有除SQL_SS_NAME_SCOPE_TABLE以外的值时调用 SQLTables、SQLColumns 或 SQLPrimaryKeys，则返回SQL_ERROR。 生成具有 SQLSTATE HY010 和消息“函数序列错误(SQL_SOPT_SS_NAME_SCOPE 未设置为 SQL_SS_NAME_SCOPE_TABLE)”的诊断记录。
另请参阅
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈