logo - 跳到首页

VastbaseG100

基于openGauss内核开发的企业级关系型数据库。

Menu

SQLSpecialColumns

功能描述

检索有关指定表中的列的以下信息：

  • 唯一标识表中的行的最佳列集。
  • 当事务更新行中任何值时自动更新的列。

接口原型

RETCODE		SQL_API
SQLSpecialColumns(HSTMT StatementHandle,
				  SQLUSMALLINT IdentifierType,
  SQLCHAR *CatalogName,
				  SQLSMALLINT NameLength1,
                  SQLCHAR *SchemaName,
				  SQLSMALLINT NameLength2,
                  SQLCHAR *TableName,
				  SQLSMALLINT NameLength3,
                  SQLUSMALLINT Scope,
				  SQLUSMALLINT Nullable)

参数说明

参数名 参数说明
StatementHandle 语句句柄。
IdentifierType 要返回的列的类型。 必须是以下值之一：
  • SQL_BEST_ROWID：返回最佳列或列集，通过从列或列中检索值，允许唯一标识指定表中的任何行。 列可以是专用于此目的的伪列 (如 Oracle ROWID 或 Ingres TID) 或表的任何唯一索引的列或列。
  • SQL_ROWVER：返回指定表中的列（如果有）当行中的任意值由任何事务更新时由数据源自动更新的列 (如 SQLBase ROWID 或 Sybase TIMESTAMP) 所示。
CatalogName 目录名称。 如果驱动程序支持某些目录的名称，但不支持其他目录的名称，例如，当驱动程序从不同的 DBMS 中检索数据时，空字符串 ("") 表示没有名称的目录。 CatalogName 不能包含字符串搜索模式。
Vastbase在实现此接口时没有用到该参数。
NameLength1 CatalogName 的长度（以字符表示）。
Vastbase在实现此接口时没有用到该参数。
SchemaName 模式名。如果驱动程序支持某些表的模式，但不支持其他表的模式，例如当驱动程序从不同的dbms检索数据时，一个空字符串("")表示那些没有模式的表。SchemaName不能包含字符串搜索模式。
NameLength2 *SchemaName的字符长度。
TableName 表名。这个参数不能是空指针。TableName不能包含字符串搜索模式。
NameLength3 *TableName的字符长度。
Scope rowid 的最小必需范围。
具体实现没有用到该参数。
Nullable 确定是否返回可以具有 NULL 值的特殊列。
具体实现没有用到该参数。

返回

  • SQL_SUCCESS：表示调用正确。
  • SQL_ERROR：表示比较严重的错误，如：内存分配失败、建立连接失败等。

其他

无。