getFunctionColumns 方法 (SQLServerDatabaseMetaData)
检索关于指定目录的系统函数或用户函数参数和返回类型的说明。
语法
public ResultSet getFunctionColumns(java.lang.String catalog,
java.lang.String schemaPattern,
java.lang.String functionNamePattern
java.lang.String columnNamePattern)
参数
catalog
一个包含目录名称的字符串 。 如果该名称为空字符串 ""，则结果将包括无目录的函数。 如果此字符串为“null”，目录名称则不可用于搜索 。
schemaPattern
一个包含架构名称模式的字符串 。 如果该名称为空字符串 ""，则结果将包括无架构的函数。 如果此字符串为“null”，架构名称则不可用于搜索 。
functionNamePattern
一个包含函数名称的字符串 。
columnNamePattern
一个包含参数名称的字符串 。
返回值
一个 SQLServerResultSet 对象。
例外
备注
此 getFunctionColumns 方法是由 java.sql.DatabaseMetaData 接口中的 getFunctionColumns 方法指定的。
此方法只返回与指定目录内的指定架构、函数名称和参数名称相匹配的函数和参数。
结果集中的各行均包括针对参数说明、列说明或返回类型的以下列：
| 名称 | Type | 说明 |
|---|---|---|
| FUNCTION_CAT | 字符串 | 函数所在的数据库的名称。 |
| FUNCTION_SCHEM | 字符串 | 函数的架构。 |
| FUNCTION_NAME | 字符串 | 函数的名称。 |
| COLUMN_NAME | 字符串 | 参数或列的名称。 |
| COLUMN_TYPE | short | 列的类型。 可以为下列值之一： functionColumnUnknown (0):未知类型。 functionColumnIn (1):输入参数。 functionColumnInOut (2):输入/输出参数。 functionColumnOut (3):输出参数。 functionReturn (4):函数返回值。 functionColumnResult (5):参数或列是结果集中的列。 |
| DATA_TYPE | smallint | 来自 Java.sql.Types 的 SQL 数据类型值。 |
| TYPE_NAME | 字符串 | 数据类型的名称。 |
| PRECISION | int | 有效数字总个数。 |
| LENGTH | int | 数据的长度（字节）。 |
| SCALE | short | 小数点右边的数字位数。 |
| RADIX | short | 数值类型的基数。 |
| NULLABLE | short | 指示参数或返回值是否可包括 null 值 。 可以为下列值之一： functionNoNulls (0):不允许 NULL 值。 functionNullable (1):允许 NULL 值。 functionNullableUnknown (2):未知。 |
| REMARKS | 字符串 | 有关列或参数的注释。 |
| COLUMN_DEF | 字符串 | 列的默认值。 注意： 此信息可在 SQL Server 中使用，且特定于 JDBC 驱动程序。 |
| SQL_DATA_TYPE | smallint | 此列与 DATA_TYPE 列相同，datetime 和 ISO interval 数据类型除外 。 注意： 此信息可在 SQL Server 中使用，且特定于 JDBC 驱动程序。 |
| SQL_DATETIME_SUB | smallint | 如果 SQL_DATA_TYPE 的值为 SQL_DATETIME 或 SQL_INTERVAL，则为 datetime ISO interval 子代码 。 对于 datetime 和 ISO interval 以外的数据类型，该列为 NULL。 注意： 此信息可在 SQL Server 中使用，且特定于 JDBC 驱动程序。 |
| CHAR_OCTET_LENGTH | int | 基于二进制和字符的最大长度的参数或列。 对于其他数据类型，该值为 NULL。 |
| ORDINAL_POSITION | int | 对于输入和输出参数，它表示从 1 开始的位置。 对于结果集列，它指从 1 开始的结果集的列的位置。 对于返回值，该值为 0。 |
| IS_NULLABLE | 字符串 | 确定参数或列的可为 Null 性。 可以为下列值之一： 是 ：参数或列可包括 NULL 值。 否 ：参数或列不可包括 NULL 值。 空字符串 ("")：未知。 |
| SS_TYPE_CATALOG_NAME | 字符串 | 包含用户定义类型 (UDT) 的目录名称。 |
| SS_TYPE_SCHEMA_NAME | 字符串 | 包含用户定义类型 (UDT) 的架构名称。 |
| SS_UDT_CATALOG_NAME | 字符串 | 采用完全限定名称的用户定义类型 (UDT)。 |
| SS_UDT_SCHEMA_NAME | 字符串 | 在其中定义 XML 架构集合名称的目录的名称。 如果找不到目录名称，此变量则会包含一个空字符串。 |
| SS_UDT_ASSEMBLY_TYPE_NAME | 字符串 | 在其中定义 XML 架构集合名称的架构的名称。 如果找不到架构名称，则为空字符串。 |
| SS_XML_SCHEMACOLLECTION_CATALOG_NAME | 字符串 | XML 架构集合的名称。 如果找不到名称，则为空字符串。 |
| SS_XML_SCHEMACOLLECTION_SCHEMA_NAME | 字符串 | 包含用户定义类型 (UDT) 的目录名称。 |
| SS_XML_SCHEMACOLLECTION_NAME | 字符串 | 包含用户定义类型 (UDT) 的架构名称。 |
| SS_DATA_TYPE | tinyint | 扩展存储过程使用的 SQL Server 数据类型。 注意： 有关 SQL Server 返回的数据类型的详细信息，请参阅 SQL Server 联机丛书中的“数据类型 (Transact-SQL)”。 |