接口 DatabaseMetaData.getColumns

大家好，又见面了，我是你们的朋友全栈君。

来源：

getColumns

public ResultSet getColumns(String catalog,
                            String schemaPattern,
                            String tableNamePattern,
                            String columnNamePattern)
                     throws SQLException

Retrieves a description of table columns available in the specified catalog.

Only column descriptions matching the catalog, schema, table and column name criteria are returned. They are ordered by TABLE_SCHEM, TABLE_NAME, and ORDINAL_POSITION.

Each column description has the following columns:

1. TABLE_CAT String => table catalog (may be null)
2. TABLE_SCHEM String => table schema (may be null)
3. TABLE_NAME String => table name
4. COLUMN_NAME String => column name
5. DATA_TYPE int => SQL type from java.sql.Types
6. TYPE_NAME String => Data source dependent type name, for a UDT the type name is fully qualified
7. COLUMN_SIZE int => column size. For char or date types this is the maximum number of characters, for numeric or decimal types this is precision.
8. BUFFER_LENGTH is not used.
9. DECIMAL_DIGITS int => the number of fractional digits
10. NUM_PREC_RADIX int => Radix (typically either 10 or 2)
11. NULLABLE int => is NULL allowed.
    • columnNoNulls – might not allow NULL values
    • columnNullable – definitely allows NULL values
    • columnNullableUnknown – nullability unknown
12. REMARKS String => comment describing column (may be null)
13. COLUMN_DEF String => default value (may be null)
14. SQL_DATA_TYPE int => unused
15. SQL_DATETIME_SUB int => unused
16. CHAR_OCTET_LENGTH int => for char types the maximum number of bytes in the column
17. ORDINAL_POSITION int => index of column in table (starting at 1)
18. IS_NULLABLE String => “NO” means column definitely does not allow NULL values; “YES” means the column might allow NULL values. An empty string means nobody knows.
19. SCOPE_CATLOG String => catalog of table that is the scope of a reference attribute (null if DATA_TYPE isn’t REF)
20. SCOPE_SCHEMA String => schema of table that is the scope of a reference attribute (null if the DATA_TYPE isn’t REF)
21. SCOPE_TABLE String => table name that this the scope of a reference attribure (null if the DATA_TYPE isn’t REF)
22. SOURCE_DATA_TYPE short => source type of a distinct type or user-generated Ref type, SQL type from java.sql.Types (null if DATA_TYPE isn’t DISTINCT or user-generated REF)

Parameters:

catalog – a catalog name; must match the catalog name as it is stored in the database; “” retrieves those without a catalog; 
null means that the catalog name should not be used to narrow the search

schemaPattern – a schema name pattern; must match the schema name as it is stored in the database; “” retrieves those without a schema; 
null means that the schema name should not be used to narrow the search

tableNamePattern – a table name pattern; must match the table name as it is stored in the database

columnNamePattern – a column name pattern; must match the column name as it is stored in the database

Returns:

ResultSet – each row is a column description

Throws:

SQLException – if a database access error occurs

See Also:

getSearchStringEscape()

getColumns

ResultSet getColumns(String catalog,
                     String schemaPattern,
                     String tableNamePattern,
                     String columnNamePattern)
                     throws SQLException

检索可在指定类别中使用的表列的描述。

仅返回与类别、模式、表和列名称标准匹配的列描述。它们根据 TABLE_SCHEM、TABLE_NAME 和 ORDINAL_POSITION 进行排序。

每个列描述都有以下列：

TABLE_CAT String => 表类别（可为 
null）


TABLE_SCHEM String => 表模式（可为 
null）


TABLE_NAME String => 表名称


COLUMN_NAME String => 列名称


DATA_TYPE int => 来自 java.sql.Types 的 SQL 类型


TYPE_NAME String => 数据源依赖的类型名称，对于 UDT，该类型名称是完全限定的


COLUMN_SIZE int => 列的大小。对于 char 或 date 类型，列的大小是最大字符数，对于 numeric 和 decimal 类型，列的大小就是精度。


BUFFER_LENGTH 未被使用。


DECIMAL_DIGITS int => 小数部分的位数


NUM_PREC_RADIX int => 基数（通常为 10 或 2）


NULLABLE int => 是否允许使用 NULL。columnNoNulls – 可能不允许使用 
NULL 值

columnNullable – 明确允许使用 
NULL 值

columnNullableUnknown – 不知道是否可使用 null


REMARKS String => 描述列的注释（可为 
null）


COLUMN_DEF String => 默认值（可为 
null）


SQL_DATA_TYPE int => 未使用


SQL_DATETIME_SUB int => 未使用


CHAR_OCTET_LENGTH int => 对于 char 类型，该长度是列中的最大字节数


ORDINAL_POSITION int => 表中的列的索引（从 1 开始）


IS_NULLABLE String => “NO” 表示明确不允许列使用 NULL 值，”YES” 表示可能允许列使用 NULL 值。空字符串表示没人知道是否允许使用 null 值。


SCOPE_CATLOG String => 表的类别，它是引用属性的作用域（如果 DATA_TYPE 不是 REF，则为 
null）


SCOPE_SCHEMA String => 表的模式，它是引用属性的作用域（如果 DATA_TYPE 不是 REF，则为 
null）


SCOPE_TABLE String => 表名称，它是引用属性的作用域（如果 DATA_TYPE 不是 REF，则为 
null）


SOURCE_DATA_TYPE short => 不同类型或用户生成 Ref 类型、来自 java.sql.Types 的 SQL 类型的源类型（如果 DATA_TYPE 不是 DISTINCT 或用户生成的 REF，则为 
null）

参数：

catalog – 类别名称，因为存储在数据库中，所以它必须匹配类别名称。该参数为 “” 则检索没有类别的描述，为 
null 则表示该类别名称不应用于缩小搜索范围

schemaPattern – 模式名称的模式，因为存储在数据库中，所以它必须匹配模式名称。该参数为 “” 则检索那些没有模式的描述，为 
null 则表示该模式名称不应用于缩小搜索范围

tableNamePattern – 表名称模式，因为存储在数据库中，所以它必须匹配表名称

columnNamePattern – 列名称模式，因为存储在数据库中，所以它必须匹配列名称

返回：

ResultSet – 每一行都是一个列描述

抛出：

SQLException – 如果发生数据库访问错误

另请参见：

getSearchStringEscape()