java.sql.DatabaseMetaData |
An interface which provides comprehensive information about the database management system and its supported features.
This interface is implemented by JDBC driver vendors in order to provide information about the underlying database capabilities in association with the JDBC driver.
Some of the methods in this interface take string parameters which are
patterns. Within these string patterns,
'%'
and
'_'
characters have special meanings.
'%'
means
"match any substring of 0 or more characters".
'_'
means
"match any character". Only metadata entries that match the pattern are
returned. If such a search pattern string is set to
null
, that
argument's criteria are dropped from the search.
Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
short | attributeNoNulls |
States that it may not be permitted to store
NULL
values.
|
|||||||||
short | attributeNullable |
States that
NULL
values are definitely permitted.
|
|||||||||
short | attributeNullableUnknown |
States that whether
NULL
values are permitted is unknown.
|
|||||||||
int | bestRowNotPseudo | States the best row identifier is NOT a pseudo column. | |||||||||
int | bestRowPseudo | States that the best row identifier is a pseudo column. | |||||||||
int | bestRowSession | States that the remainder of the current session is used as the scope for the best row identifier. | |||||||||
int | bestRowTemporary | States that best row identifier scope lasts only while the row is being used. | |||||||||
int | bestRowTransaction | States that the remainder of the current transaction is used as the scope for the best row identifier. | |||||||||
int | bestRowUnknown | States that the best row identifier may or may not be a pseudo column. | |||||||||
int | columnNoNulls |
States that the column must not allow
NULL
values.
|
|||||||||
int | columnNullable |
States that the column definitely allows
NULL
values.
|
|||||||||
int | columnNullableUnknown | States that it is unknown whether the columns may be nulled. | |||||||||
int | functionColumnIn | States that the parameter or column is an IN parameter | |||||||||
int | functionColumnInOut | States that the parameter or column is an INOUT parameter | |||||||||
int | functionColumnOut | States that the parameter or column is an OUT parameter | |||||||||
int | functionColumnResult | States that the parameter or column is a column in a result set | |||||||||
int | functionColumnUnknown | States that the parameter of function is unknown | |||||||||
int | functionNoNulls | States that NULL values are not allowed | |||||||||
int | functionNoTable | States that the function does not return a table | |||||||||
int | functionNullable | States that NULL values are allowed | |||||||||
int | functionNullableUnknown | States that whether NULL values are allowed is unknown | |||||||||
int | functionResultUnknown | States that it is not known whether the function returns a result or a table | |||||||||
int | functionReturn | States that the parameter or column is a return value | |||||||||
int | functionReturnsTable | States that the function returns a table. | |||||||||
int | importedKeyCascade |
For the column
UPDATE_RULE
, states that when the primary key is
updated, the foreign key (imported key) is changed accordingly.
|
|||||||||
int | importedKeyInitiallyDeferred | States that the evaluation of foreign key constraints is deferred (delayed until commit). | |||||||||
int | importedKeyInitiallyImmediate |
States that the evaluation of foreign key constraint is
IMMEDIATE
.
|
|||||||||
int | importedKeyNoAction |
For the columns
UPDATE_RULE
and
DELETE_RULE
, states that
if the primary key has been imported, it cannot be updated or deleted.
|
|||||||||
int | importedKeyNotDeferrable |
States that the evaluation of foreign key constraint must not be
DEFERRED
.
|
|||||||||
int | importedKeyRestrict | States that a primary key must not be updated when imported as a foreign key by some other table. | |||||||||
int | importedKeySetDefault | States that when the primary key is modified (updated or deleted) the foreign (imported) key is changed to its default value. | |||||||||
int | importedKeySetNull |
States that when the primary key is modified (updated or deleted) the
foreign (imported) key is changed to
NULL
.
|
|||||||||
int | procedureColumnIn |
States that the column stores
IN
type parameters.
|
|||||||||
int | procedureColumnInOut |
States that this column stores
INOUT
type parameters.
|
|||||||||
int | procedureColumnOut |
States that this column stores
OUT
type parameters.
|
|||||||||
int | procedureColumnResult | States that the column stores results. | |||||||||
int | procedureColumnReturn | States that the column stores return values. | |||||||||
int | procedureColumnUnknown | States that type of the column is unknown. | |||||||||
int | procedureNoNulls |
States that
NULL
values are not permitted.
|
|||||||||
int | procedureNoResult | States that the procedure does not return a result. | |||||||||
int | procedureNullable |
States that
NULL
values are permitted.
|
|||||||||
int | procedureNullableUnknown |
States that it is unknown whether
NULL
values are permitted.
|
|||||||||
int | procedureResultUnknown | States that it is unknown whether or not the procedure returns a result. | |||||||||
int | procedureReturnsResult | States that the procedure returns a result. | |||||||||
int | sqlStateSQL | States that the method DatabaseMetaData.getSQLStateType may returns an SQLSTATE value or not. | |||||||||
int | sqlStateSQL99 |
States that the value is an SQL99
SQLSTATE
value.
|
|||||||||
int | sqlStateXOpen |
States that the value is an SQL
CLI SQLSTATE
value as defined by
the X/Open standard.
|
|||||||||
short | tableIndexClustered | States that this table index is a clustered index. | |||||||||
short | tableIndexHashed | States that this table index is a hashed index. | |||||||||
short | tableIndexOther | States this table's index is neither a clustered index, not a hashed index, and not a table statistics index; i.e. | |||||||||
short | tableIndexStatistic | States this column has the table's statistics, and that it is returned in conjunction with the table's index description. | |||||||||
int | typeNoNulls |
States that a
NULL
value is
NOT
permitted for
this data type.
|
|||||||||
int | typeNullable |
States that a
NULL
value is permitted for this data type.
|
|||||||||
int | typeNullableUnknown |
States that it is unknown if a
NULL
value is permitted for
this data type.
|
|||||||||
int | typePredBasic |
States that this column shall not be used for
WHERE
statements
with a
LIKE
clause.
|
|||||||||
int | typePredChar |
States that this column can only be used in a
WHERE...LIKE
statement.
|
|||||||||
int | typePredNone | States that this column does not support searches. | |||||||||
int | typeSearchable | States that the column is searchable. | |||||||||
int | versionColumnNotPseudo | States that the version column is known to be not a pseudo column. | |||||||||
int | versionColumnPseudo | States that this version column is known to be a pseudo column. | |||||||||
int | versionColumnUnknown | States that the version column may be a pseudo column or not. |
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
|
Returns whether all procedures returned by
getProcedures(String, String, String)
can be
called by the current user.
|
||||||||||
|
Returns whether all the tables returned by
getTables
can be used
by the current user in a
SELECT
statement.
|
||||||||||
|
Determine if a SQLException while autoCommit is true indicates that all
open ResultSets are closed, even ones that are holdable
|
||||||||||
|
Returns whether a data definition statement in a transaction forces a
commit
of the transaction.
|
||||||||||
|
Returns whether the database ignores data definition statements within a
transaction.
|
||||||||||
|
Returns whether a visible row delete can be detected by calling
rowDeleted()
.
|
||||||||||
|
Returns whether the return value of
getMaxRowSize
includes the
SQL data types
LONGVARCHAR
and
LONGVARBINARY
.
|
||||||||||
|
Returns a
ResultSet
describing a subset of the attributes of a
specified SQL User Defined Type (UDT) for a specified schema and catalog.
|
||||||||||
|
Returns a list of a table's optimal set of columns that uniquely
identify the rows.
|
||||||||||
|
Returns the separator that this database uses between a catalog name and
table name.
|
||||||||||
|
Returns the term that the database vendor prefers term for "catalog".
|
||||||||||
|
Returns the set of catalog names available in this database.
|
||||||||||
|
Returns a list of the client info properties of the driver.
|
||||||||||
|
Returns a description of access rights for a table's columns.
|
||||||||||
|
Returns a description of table columns available in a specified catalog.
|
||||||||||
|
Returns the database connection that created this metadata.
|
||||||||||
|
Returns a list of foreign key columns in a given foreign key table that
reference the primary key columns of a supplied primary key table.
|
||||||||||
|
Returns the major version number of the database software.
|
||||||||||
|
Returns the minor version number of the database software.
|
||||||||||
|
Returns the name of the database software.
|
||||||||||
|
Returns the version number of this database software.
|
||||||||||
|
Returns the default transaction isolation level for this database.
|
||||||||||
|
Returns the JDBC driver's major version number.
|
||||||||||
|
Returns the JDBC driver's minor version number.
|
||||||||||
|
Returns the name of this JDBC driver.
|
||||||||||
|
Returns the version number of this JDBC driver.
|
||||||||||
|
Returns a list of the foreign key columns that reference the primary key
columns of a specified table (the foreign keys exported by a table).
|
||||||||||
|
Returns a string of characters that may be used in unquoted identifier
names.
|
||||||||||
|
Returns a description according to the given catalog's system or user
function parameters and return type.
|
||||||||||
|
Returns a description of the system and user functions available
according to the given catalog.
|
||||||||||
|
Returns the string used to quote SQL identifiers.
|
||||||||||
|
Returns a list columns in a table that are both primary keys and
referenced by the table's foreign key columns (that is, the primary keys
imported by a table).
|
||||||||||
|
Returns a list of indices and statistics for a specified table.
|
||||||||||
|
Returns this driver's major JDBC version number.
|
||||||||||
|
Returns the minor JDBC version number for this driver.
|
||||||||||
|
Get the maximum number of hex characters in an in-line binary literal for
this database.
|
||||||||||
|
Returns the maximum size of a catalog name in this database.
|
||||||||||
|
Returns the maximum size for a character literal in this database.
|
||||||||||
|
Returns the maximum size for a Column name for this database.
|
||||||||||
|
Get the maximum number of columns in a
GROUP BY
clause for this
database.
|
||||||||||
|
Returns the maximum number of columns in an Index for this database.
|
||||||||||
|
Returns the maximum number of columns in an
ORDER BY
clause for
this database.
|
||||||||||
|
Returns the maximum number of columns in a
SELECT
list for this
database.
|
||||||||||
|
Returns the maximum number of columns in a table for this database.
|
||||||||||
|
Returns the database's maximum number of concurrent connections.
|
||||||||||
|
Returns the maximum length of a cursor name for this database.
|
||||||||||
|
Returns the maximum length in bytes for an Index for this database.
|
||||||||||
|
Returns the maximum number of characters for a procedure name in this
database.
|
||||||||||
|
Returns the maximum number of bytes within a single row for this
database.
|
||||||||||
|
Returns the maximum number of characters in a schema name for this
database.
|
||||||||||
|
Returns the maximum number of characters in an SQL statement for this
database.
|
||||||||||
|
Get the maximum number of simultaneously open active statements for this
database.
|
||||||||||
|
Returns the maximum size for a table name in the database.
|
||||||||||
|
Returns the maximum number of tables permitted in a
SELECT
statement for the database.
|
||||||||||
|
Returns the maximum number of characters in a user name for the database.
|
||||||||||
|
Returns a list of the math functions available with this database.
|
||||||||||
|
Returns a list of the primary key columns of a specified table.
|
||||||||||
|
Returns a list of parameter and result columns for the stored procedures
belonging to a specified catalog.
|
||||||||||
|
Returns the database vendor's preferred name for "procedure".
|
||||||||||
|
Returns a list of the stored procedures available in a specified catalog.
|
||||||||||
|
Returns the result set's default holdability.
|
||||||||||
|
Returns the lifetime for which a RowId object remains valid if this data
source supports the SQL ROWID type
|
||||||||||
|
Returns a list of all the SQL keywords that are NOT also SQL92 keywords
for the database.
|
||||||||||
|
States the type of
SQLState
value returned by
SQLException.getSQLState
.
|
||||||||||
|
Returns the database vendor's preferred term for "schema".
|
||||||||||
|
Returns the schema names ordered by TABLE_CATALOG and TABLE_SCHEMA.
|
||||||||||
|
Returns a list of the schema names in the database.
|
||||||||||
|
Returns the string that is used to escape wildcard characters.
|
||||||||||
|
Returns a list of string functions available with the database.
|
||||||||||
|
Returns a listing of the hierarchies of tables in a specified schema in
the database.
|
||||||||||
|
Returns the User Defined Type (UDT) hierarchies for a given schema.
|
||||||||||
|
Returns a list of system functions available with the database.
|
||||||||||
|
Returns a description of access rights for each table present in a
catalog.
|
||||||||||
|
Returns a list of table types supported by the database.
|
||||||||||
|
Returns a description of the tables in a specified catalog.
|
||||||||||
|
Returns a list of time and date functions available for the database.
|
||||||||||
|
Get a list of the standard SQL types supported by this database.
|
||||||||||
|
Returns a description of the User Defined Types (UDTs) defined in a given
schema, which includes the types
DISTINCT
,
STRUCT
and
JAVA_OBJECT
.
|
||||||||||
|
Returns the URL for this database.
|
||||||||||
|
Determine the user name as known by the database.
|
||||||||||
|
Returns which of a table's columns are automatically updated when any
value in a row is updated.
|
||||||||||
|
Determines whether a visible row insert can be detected by calling
ResultSet.rowInserted
.
|
||||||||||
|
Determine whether a fully qualified table name is prefixed or suffixed to
a fully qualified table name.
|
||||||||||
|
Determines whether the database is in read-only mode.
|
||||||||||
|
Determines whether updates are made to a copy of, or directly on, Large Objects
(
LOB
s).
|
||||||||||
|
Determines whether the database handles concatenations between
NULL
and
non-
NULL
values by producing a
NULL
output.
|
||||||||||
|
Determines whether
NULL
values are always sorted to the end of sorted
results regardless of requested sort order.
|
||||||||||
|
Determines whether
NULL
values are always sorted at the start of the
sorted list, irrespective of the sort order.
|
||||||||||
|
Determines whether
NULL
values are sorted high - i.e.
|
||||||||||
|
Determines whether
NULL
values are sorted low - i.e.
|
||||||||||
|
Determines whether deletes made by others are visible, for a specified
ResultSet
type.
|
||||||||||
|
Determines whether inserts made by others are visible, for a specified
ResultSet
type.
|
||||||||||
|
Determines whether updates made by others are visible, for a specified
ResultSet
type.
|
||||||||||
|
Determines whether a
ResultSet
can see its own deletes, for a
specified
ResultSet
type.
|
||||||||||
|
Determines whether a
ResultSet
can see its own inserts, for a
specified
ResultSet
type.
|
||||||||||
|
Determines whether a
ResultSet
can see its own updates, for a
specified
ResultSet
type.
|
||||||||||
|
Determines whether the database treats SQL identifiers that are in mixed
case (and unquoted) as case insensitive.
|
||||||||||
|
Determines whether the database considers mixed case quoted SQL
identifiers as case insensitive and stores them in lower case.
|
||||||||||
|
Determines whether the database considers mixed case unquoted SQL
identifiers as case insensitive and stores them in mixed case.
|
||||||||||
|
Determines whether the database considers identifiers as case insensitive
if they are mixed case quoted SQL.
|
||||||||||
|
Determines whether the database considers mixed case unquoted SQL
identifiers as case insensitive and stores them in upper case.
|
||||||||||
|
Determines whether the database considers mixed case quoted SQL
identifiers as case insensitive and stores them in upper case.
|
||||||||||
|
Determines whether the database supports the ANSI92 entry level SQL grammar.
|
||||||||||
|
Determines whether the database supports the ANSI92 full SQL grammar.
|
||||||||||
|
Determines whether the database supports the ANSI92 intermediate SQL Grammar.
|
||||||||||
|
Determines whether the database supports
ALTER TABLE
operation with
ADD COLUMN
.
|
||||||||||
|
Determines whether the database supports
ALTER TABLE
operation with
DROP COLUMN
.
|
||||||||||
|
Determines whether the database supports batch updates.
|
||||||||||
|
Determines whether catalog names may be used in data manipulation
statements.
|
||||||||||
|
Determines whether catalog names can be used in index definition statements.
|
||||||||||
|
Determines whether catalog names can be used in privilege definition
statements.
|
||||||||||
|
Determines whether catalog names can be used in procedure call statements.
|
||||||||||
|
Determines whether catalog names may be used in table definition statements.
|
||||||||||
|
Determines whether the database supports column aliasing.
|
||||||||||
|
Determines whether the database supports
CONVERT
operation for two
supplied SQL types.
|
||||||||||
|
Determines whether the database supports the
CONVERT
operation between
SQL types.
|
||||||||||
|
Determines whether the database supports the Core SQL Grammar for ODBC.
|
||||||||||
|
Determines whether the database supports correlated sub-queries.
|
||||||||||
|
Determines whether the database allows both data definition and data
manipulation statements inside a transaction.
|
||||||||||
|
Determines whether the database only allows data manipulation statements inside
a transaction.
|
||||||||||
|
Determines whether table correlation names are required to be different from
the names of the tables, when they are supported.
|
||||||||||
|
Determines whether expressions in
ORDER BY
lists are supported.
|
||||||||||
|
Determines whether the Extended SQL Grammar for ODBC is supported.
|
||||||||||
|
Determines whether the database supports full nested outer joins.
|
||||||||||
|
Determines whether auto generated keys can be returned when a statement
executes.
|
||||||||||
|
Determines whether the database supports
GROUP BY
clauses.
|
||||||||||
|
Determines whether the database supports using a column name in a
GROUP
BY
clause not included in the
SELECT
statement as long as all of
the columns in the
SELECT
statement are used in the
GROUP
BY
clause.
|
||||||||||
|
Determines whether the database supports using a column name in a
GROUP
BY
clause that is not in the
SELECT
statement.
|
||||||||||
|
Determines whether the database supports SQL Integrity Enhancement
Facility.
|
||||||||||
|
Determines whether the database supports a
LIKE
escape clause.
|
||||||||||
|
Determines whether the database provides limited support for outer join
operations.
|
||||||||||
|
Determines whether the database supports Minimum SQL Grammar for ODBC.
|
||||||||||
|
Determines whether the database treats mixed case unquoted SQL identifiers as
case sensitive storing them in mixed case.
|
||||||||||
|
Determines whether the database considers mixed case quoted SQL
identifiers as case sensitive, storing them in mixed case.
|
||||||||||
|
Determines whether it is possible for a single
CallableStatement
to
return multiple
ResultSet
s simultaneously.
|
||||||||||
|
Determines whether retrieving multiple
ResultSet
s from a single
call to the
execute
method is supported.
|
||||||||||
|
Determines whether multiple simultaneous transactions on
different connections are supported.
|
||||||||||
|
Determines whether callable statements with named parameters is supported.
|
||||||||||
|
Determines whether columns in the database can be defined as non-nullable.
|
||||||||||
|
Determines whether keeping cursors open across commit operations is
supported.
|
||||||||||
|
Determines whether the database can keep cursors open across rollback
operations.
|
||||||||||
|
Determines whether keeping statements open across commit operations is
supported.
|
||||||||||
|
Determines whether keeping statements open across rollback operations is
supported.
|
||||||||||
|
Determines whether using a column in an
ORDER BY
clause that is
not in the
SELECT
statement is supported.
|
||||||||||
|
Determines whether outer join operations are supported.
|
||||||||||
|
Determines whether positioned
DELETE
statements are supported.
|
||||||||||
|
Determines whether positioned
UPDATE
statements are supported.
|
||||||||||
|
Determines whether there is support for a given concurrency style for the
given
ResultSet
.
|
||||||||||
|
Determines whether the supplied
ResultSet
holdability mode is
supported.
|
||||||||||
|
Determines whether the supplied
ResultSet
type is supported.
|
||||||||||
|
Determines whether savepoints for transactions are supported.
|
||||||||||
|
Determines whether a schema name may be used in a data manipulation
statement.
|
||||||||||
|
Determines whether a schema name may be used in an index definition
statement.
|
||||||||||
|
Determines whether a database schema name can be used in a privilege
definition statement.
|
||||||||||
|
Determines whether a procedure call statement may be contain in a schema name.
|
||||||||||
|
Determines whether a schema name can be used in a table definition statement.
|
||||||||||
|
Determines whether the
SELECT FOR UPDATE
statement is supported.
|
||||||||||
|
Determines whether statement pooling is supported.
|
||||||||||
|
Determine if this database supports invoking user-defined or vendor
functions using the stored procedure escape syntax.
|
||||||||||
|
Determines whether stored procedure calls using the stored procedure
escape syntax is supported.
|
||||||||||
|
Determines whether subqueries in comparison expressions are supported.
|
||||||||||
|
Determines whether subqueries in
EXISTS
expressions are supported.
|
||||||||||
|
Determines whether subqueries in
IN
statements are supported.
|
||||||||||
|
Determines whether subqueries in quantified expressions are supported.
|
||||||||||
|
Determines whether the database has table correlation names support.
|
||||||||||
|
Determines whether a specified transaction isolation level is supported.
|
||||||||||
|
Determines whether transactions are supported.
|
||||||||||
|
Determines whether the
SQL UNION
operation is supported.
|
||||||||||
|
Determines whether the
SQL UNION ALL
operation is supported.
|
||||||||||
|
Determines whether the method
ResultSet.rowUpdated
can detect a visible
row update for the specified
ResultSet
type.
|
||||||||||
|
Determines whether this database uses a file for each table.
|
||||||||||
|
Determines whether this database uses a local file to store tables.
|
[Expand]
Inherited Methods
|
|||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From interface
java.sql.Wrapper
|
States that it may not be permitted to store
NULL
values.
States that
NULL
values are definitely permitted.
States that whether
NULL
values are permitted is unknown.
States the best row identifier is NOT a pseudo column.
States that the best row identifier is a pseudo column.
States that the remainder of the current session is used as the scope for the best row identifier.
States that best row identifier scope lasts only while the row is being used.
States that the remainder of the current transaction is used as the scope for the best row identifier.
States that the best row identifier may or may not be a pseudo column.
States that the column must not allow
NULL
values.
States that the column definitely allows
NULL
values.
States that it is unknown whether the columns may be nulled.
States that the parameter or column is an IN parameter
States that the parameter or column is an INOUT parameter
States that the parameter or column is an OUT parameter
States that the parameter or column is a column in a result set
States that the parameter of function is unknown
States that NULL values are not allowed
States that the function does not return a table
States that NULL values are allowed
States that whether NULL values are allowed is unknown
States that it is not known whether the function returns a result or a table
States that the parameter or column is a return value
States that the function returns a table.
For the column
UPDATE_RULE
, states that when the primary key is
updated, the foreign key (imported key) is changed accordingly.
States that the evaluation of foreign key constraints is deferred (delayed until commit).
States that the evaluation of foreign key constraint is
IMMEDIATE
.
For the columns
UPDATE_RULE
and
DELETE_RULE
, states that
if the primary key has been imported, it cannot be updated or deleted.
States that the evaluation of foreign key constraint must not be
DEFERRED
.
States that a primary key must not be updated when imported as a foreign
key by some other table. Used for the column
UPDATE_RULE
.
States that when the primary key is modified (updated or deleted) the
foreign (imported) key is changed to its default value. Applies to the
UPDATE_RULE
and
DELETE_RULE
columns.
States that when the primary key is modified (updated or deleted) the
foreign (imported) key is changed to
NULL
. Applies to the
UPDATE_RULE
and
DELETE_RULE
columns.
States that the column stores
IN
type parameters.
States that this column stores
INOUT
type parameters.
States that this column stores
OUT
type parameters.
States that the column stores results.
States that the column stores return values.
States that type of the column is unknown.
States that
NULL
values are not permitted.
States that the procedure does not return a result.
States that
NULL
values are permitted.
States that it is unknown whether
NULL
values are permitted.
States that it is unknown whether or not the procedure returns a result.
States that the procedure returns a result.
States that the method DatabaseMetaData.getSQLStateType may returns an SQLSTATE value or not.
States that the value is an SQL99
SQLSTATE
value.
States that the value is an SQL
CLI SQLSTATE
value as defined by
the X/Open standard.
States that this table index is a clustered index.
States that this table index is a hashed index.
States this table's index is neither a clustered index, not a hashed index, and not a table statistics index; i.e. it is something else.
States this column has the table's statistics, and that it is returned in conjunction with the table's index description.
States that a
NULL
value is
NOT
permitted for
this data type.
States that a
NULL
value is permitted for this data type.
States that it is unknown if a
NULL
value is permitted for
this data type.
States that this column shall not be used for
WHERE
statements
with a
LIKE
clause.
States that this column can only be used in a
WHERE...LIKE
statement.
States that this column does not support searches.
States that the column is searchable.
States that the version column is known to be not a pseudo column.
States that this version column is known to be a pseudo column.
States that the version column may be a pseudo column or not.
Returns whether all procedures returned by
getProcedures(String, String, String)
can be
called by the current user.
true
if all procedures can be called by the current user,
false
otherwise.
SQLException | if there is a database error. |
---|
Returns whether all the tables returned by
getTables
can be used
by the current user in a
SELECT
statement.
true
if all the tables can be used,
false
otherwise.
SQLException | if there is a database error. |
---|
Determine if a SQLException while autoCommit is true indicates that all open ResultSets are closed, even ones that are holdable
SQLException | if any error occurs |
---|
Returns whether a data definition statement in a transaction forces a
commit
of the transaction.
true
if the statement forces a commit,
false
otherwise.
SQLException | if there is a database error. |
---|
Returns whether the database ignores data definition statements within a transaction.
true
if the database ignores a data definition statement,
false
otherwise.
SQLException | if there is a database error. |
---|
Returns whether a visible row delete can be detected by calling
rowDeleted()
.
type |
the type of the
ResultSet
involved:
ResultSet.TYPE_FORWARD_ONLY
,
ResultSet.TYPE_SCROLL_INSENSITIVE
, or
ResultSet.TYPE_SCROLL_SENSITIVE
|
---|
true
if the visible row delete can be detected,
false
otherwise.
SQLException | if there is a database error. |
---|
Returns whether the return value of
getMaxRowSize
includes the
SQL data types
LONGVARCHAR
and
LONGVARBINARY
.
true
if the return value includes
LONGVARBINARY
and
LONGVARCHAR
, otherwise
false
.
SQLException | if there is a database error. |
---|
Returns a
ResultSet
describing a subset of the attributes of a
specified SQL User Defined Type (UDT) for a specified schema and catalog.
The subset is determined by restricting to those attributes whose
name matches the
attributeNamePattern
and whose type name
matches the
typeNamePattern
. Each row of the
ResultSet
describes one attribute, and the rows are ordered by the columns
TYPE_SCHEM
,
TYPE_NAME
and
ORDINAL_POSITION
. Inherited attributes
are not included.
The columns of the returned
ResultSet
object have the following
names and meanings:
TYPE_CAT
- String - the type catalog name (possibly
null
)
TYPE_SCHEM
- String - the type schema name (possibly
null
)
TYPE_NAME
- String - the type name
ATTR_NAME
- String - the attribute name
DATA_TYPE
- int - the attribute type as defined in
java.sql.Types
ATTR_TYPE_NAME
- String - the attribute type name. This
depends on the data source. For a
UDT
the name is fully
qualified. For a
REF
it is both fully qualified and represents
the target type of the reference.
ATTR_SIZE
- int - the column size. When referring to char and
date types this value is the maximum number of characters. When referring
to numeric types is is the precision.
DECIMAL_DIGITS
- int - how many fractional digits are
supported
NUM_PREC_RADIX
- int - numeric values radix
NULLABLE
- int - whether
NULL
is permitted:
NULL
values not permitted
NULL
values definitely
permitted
REMARKS
- String - a comment describing the attribute
(possibly
null
)
null
)
SQL_DATA_TYPE
- int - not used
CHAR
types, the max number of
bytes in the column
"NO"
= the column does not allow
NULL
s,
"YES"
= the column allows
NULL
s, "" = status unknown
SCOPE_CATALOG
- String - if the
DATA_TYPE
is
REF
,
this gives the catalog of the table corresponding to the attribute's scope.
NULL if the
DATA_TYPE
is not REF.
SCOPE_SCHEMA
- String - if the
DATA_TYPE
is
REF
,
this gives the schema of the table corresponding to the attribute's scope.
NULL if the
DATA_TYPE
is not REF.
SCOPE_TABLE
- String - if the
DATA_TYPE
is
REF
,
this gives the name of the table corresponding to the attribute's scope.
NULL if the
DATA_TYPE
is not REF.
SOURCE_DATA_TYPE
- String - The source type for a user
generated REF type or for a Distinct type. (
NULL
if
DATA_TYPE
is not DISTINCT or a user generated REF)
catalog |
a catalog name.
null
is used to imply no narrowing of
the search by catalog name. Otherwise, the name must match a
catalog name held in the database, with "" used to retrieve
those without a catalog name.
|
---|---|
schemaPattern |
a schema name pattern.
null
is used to imply no
narrowing of the search by a schema name. Otherwise, the name
must match a schema name in the database, with "" used to
retrieve those without a schema name.
|
typeNamePattern | a type name. This pattern must match the type name stored in the database. |
attributeNamePattern | an Attribute name. This pattern must match the attribute name as stored in the database. |
ResultSet
, where each row is an attribute description.
SQLException | if there is a database error. |
---|
Returns a list of a table's optimal set of columns that uniquely
identify the rows. The results are ordered by
SCOPE
(see below).
The results are returned as a table, with one entry for each column, as follows:
SCOPE
- short - the
SCOPE
of the result, as follows:
DatabaseMetaData.bestRowTemporary
- the result is very temporary,
only valid while on the current row
DatabaseMetaData.bestRowTransaction
- the result is good for remainder of
current transaction
DatabaseMetaData.bestRowSession
- the result is good for remainder of
database session
COLUMN_NAME
- String - the column name
DATA_TYPE
- int - the Type of the data, as defined in
java.sql.Types
TYPE_NAME
- String - the Name of the type - database dependent.
For UDT types the name is fully qualified
COLUMN_SIZE
- int - the precision of the data in the column
BUFFER_LENGTH
- int - not used
DECIMAL_DIGITS
- short - number of fractional digits
PSEUDO_COLUMN
- short - whether this is a pseudo column (e.g.
an Oracle
ROWID
):
DatabaseMetaData.bestRowUnknown
- it is not known whether this is
a pseudo column
DatabaseMetaData.bestRowNotPseudo
- the column is not pseudo
DatabaseMetaData.bestRowPseudo
- the column is a pseudo column
catalog |
a catalog name.
null
is used to imply no narrowing of
the search by catalog name. Otherwise, the name must match a
catalog name held in the database, with "" used to retrieve
those without a catalog name.
|
---|---|
schema |
a schema name pattern.
null
is used to imply no
narrowing of the search by schema name. Otherwise, the name
must match a schema name in the database, with "" used to
retrieve those without a schema name.
|
table | the table name. This must match the name of the table as declared in the database. |
scope |
the
SCOPE
of interest, values as defined above.
|
nullable |
true
= include columns that are nullable,
false
= do not include nullable columns.
|
ResultSet
where each row is a description of a column
and the complete set of rows is the optimal set for this table.
SQLException | if there is a database error. |
---|
Returns the separator that this database uses between a catalog name and table name.
SQLException | if there is a database error. |
---|
Returns the term that the database vendor prefers term for "catalog".
SQLException | if there is a database error. |
---|
Returns the set of catalog names available in this database. The set is returned ordered by catalog name.
ResultSet
containing the catalog names, with each row
containing one catalog name (as a
String
) in the
single column named
TABLE_CAT
.
SQLException | if there is a database error. |
---|
Returns a list of the client info properties of the driver.
SQLException | if any error occurs |
---|
Returns a description of access rights for a table's columns. Only access rights matching the criteria for the column name are returned.
The description is returned as a
ResultSet
with rows of data for
each access right, with columns as follows:
TABLE_CAT
- String - the catalog name (possibly
null
)
TABLE_SCHEM
- String - the schema name (possibly
null
)
TABLE_NAME
- String - the table name
COLUMN_NAME
- String - the Column name
GRANTOR
- String - the grantor of access (possibly
null
)
PRIVILEGE
- String - Access right - one of SELECT, INSERT,
UPDATE, REFERENCES,...
IS_GRANTABLE
- String -
"YES"
implies that the
receiver can grant access to others,
"NO"
if the receiver cannot
grant access to others,
null
if unknown.
catalog |
a catalog name.
null
is used to imply no narrowing of
the search by catalog name. Otherwise, the name must match a
catalog name held in the database, with "" used to retrieve
those without a catalog name.
|
---|---|
schema |
a schema name pattern.
null
is used to imply no
narrowing of the search by schema name. Otherwise, the name
must match a schema name in the database, with "" used to
retrieve those without a schema name.
|
table | the table name. This must match the name of the table as declared in the database. |
columnNamePattern | the column name. This must match the name of a column in the table in the database. |
ResultSet
containing the access rights, one row for
each privilege description.
SQLException | if there is a database error. |
---|
Returns a description of table columns available in a specified catalog. Only descriptions meeting the specified catalog, schema, table, and column names are returned.
The descriptions are returned as a
ResultSet
conforming to the
following data layout, with one row per table column:
TABLE_CAT
- String - the catalog name (possibly
null
)
TABLE_SCHEM
- String - the schema name (possibly
null
)
TABLE_NAME
- String - the table name
COLUMN_NAME
- String - the column name
DATA_TYPE
- int - the SQL type as specified in
java.sql.Types
TYPE_NAME
- String - the name of the data type, (database-dependent,
UDT names are fully qualified)
COLUMN_SIZE
- int - the column size (the precision for numeric
types, max characters for
char
and
date
types)
BUFFER_LENGTH
- int - Not used
DECIMAL_DIGITS
- int - maximum number of fractional digits
NUM_PREC_RADIX
- int - the radix for numerical types
NULLABLE
- int - whether the column allows
null
s:
NULL
s
NULL
s
NULL
status
REMARKS
- String - A description of the column (possibly
null
)
COLUMN_DEF
- String - Default value for the column (possibly
null
)
SQL_DATA_TYPE
- int - not used
SQL_DATETIME_SUB
- int - not used
CHAR_OCTET_LENGTH
- int - maximum number of bytes in the
char
type columns
ORDINAL_POSITION
- int - the column index in the table (1 based)
IS_NULLABLE
- String -
"NO"
= column does not allow
NULLs,
"YES"
= column allows NULLs, "" =
NULL
status
unknown
SCOPE_CATALOG
- String - if the
DATA_TYPE
is
REF
,
this gives the catalog of the table corresponding to the attribute's scope.
NULL if the
DATA_TYPE
is not REF.
SCOPE_SCHEMA
- String - if the
DATA_TYPE
is
REF
,
this gives the schema of the table corresponding to the attribute's scope.
NULL if the
DATA_TYPE
is not REF.
SCOPE_TABLE
- String - if the
DATA_TYPE
is
REF
,
this gives the name of the table corresponding to the attribute's scope.
NULL if the
DATA_TYPE
is not REF.
SOURCE_DATA_TYPE
- String - The source type for a user
generated REF type or for a Distinct type. (
NULL
if
DATA_TYPE
is not DISTINCT or a user generated REF)
catalog |
a catalog name.
null
is used to imply no narrowing of
the search by catalog name. Otherwise, the name must match a
catalog name held in the database, with "" used to retrieve
those without a catalog name.
|
---|---|
schemaPattern |
a schema name pattern.
null
is used to imply no
narrowing of the search by schema name. Otherwise, the name
must match a schema name in the database, with "" used to
retrieve those without a schema name.
|
tableNamePattern | the table name. This must match the name of the table as declared in the database. |
columnNamePattern | the column name. This must match the name of a column in the table in the database. |
ResultSet
with rows in the form
defined above.
SQLException | if there is a database error. |
---|
Returns the database connection that created this metadata.
SQLException | if there is a database error. |
---|
Returns a list of foreign key columns in a given foreign key table that reference the primary key columns of a supplied primary key table. This describes how one table imports the key of another table. It would be expected to return a single foreign key - primary key pair in most cases.
The descriptions are returned as a
ResultSet
with one row for
each foreign key, with the following layout:
PKTABLE_CAT
- String - from the primary key table : Catalog
(possibly
null
)
PKTABLE_SCHEM
- String - from the primary key table : Schema
(possibly
null
)
PKTABLE_NAME
- String - from the primary key table : name
PKCOLUMN_NAME
- String - from the primary key column : name
FKTABLE_CAT
- String - from the foreign key table : the
catalog name being exported (possibly
null
)
FKTABLE_SCHEM
- String - from the foreign key table : the schema name
being exported (possibly
null
)
FKTABLE_NAME
- String - from the foreign key table : the name being
exported
FKCOLUMN_NAME
- String - from the foreign key column : the name being
exported
KEY_SEQ
- short - the sequence number (in the foreign key)
UPDATE_RULE
- short - a value giving the rule for how to treat the corresponding foreign key when a primary
key is updated:
DatabaseMetaData.importedKeyNoAction
- don't allow the
primary key to be updated if it is imported as a foreign key
DatabaseMetaData.importedKeyCascade
- change the imported key to
match the updated primary key
DatabaseMetaData.importedKeySetNull
- set the imported key to
null
DatabaseMetaData.importedKeySetDefault
- set the imported key
to its default value
DatabaseMetaData.importedKeyRestrict
- same as
importedKeyNoAction
DELETE_RULE
- short - a value giving the rule for how to treat the foreign key when the corresponding primary
key is deleted:
DatabaseMetaData.importedKeyNoAction
- don't allow the
primary key to be deleted if it is imported as a foreign key
DatabaseMetaData.importedKeyCascade
- delete those rows that
import a deleted key
DatabaseMetaData.importedKeySetNull
- set the imported key to
null
DatabaseMetaData.importedKeySetDefault
- set the imported key
to its default value
DatabaseMetaData.importedKeyRestrict
- same as
importedKeyNoAction
FK_NAME
- String - the foreign key name (possibly
null
)
PK_NAME
- String - the primary key name (possibly
null
)
DEFERRABILITY
- short - whether foreign key constraints can be
deferred until commit (see the SQL92 specification for definitions):
DatabaseMetaData.importedKeyInitiallyDeferred
DatabaseMetaData.importedKeyInitiallyImmediate
DatabaseMetaData.importedKeyNotDeferrable
primaryCatalog |
a catalog name for the primary key table.
null
is used to imply no narrowing of
the search by catalog name. Otherwise, the name must match a
catalog name held in the database, with "" used to retrieve
those without a catalog name.
|
---|---|
primarySchema |
a schema name for the primary key table.
null
is used to imply no narrowing of
the search by schema name. Otherwise, the name must match a
schema name in the database, with "" used to retrieve those
without a schema name.
|
primaryTable | the name of the table which exports the key. It must match the name of the table in the database. |
foreignCatalog |
a catalog name for the foreign key table.
null
is used to imply no narrowing of
the search by catalog name. Otherwise, the name must match a
catalog name held in the database, with "" used to retrieve
those without a catalog name.
|
foreignSchema |
a schema name for the foreign key table.
null
is used to imply no narrowing of
the search by schema name. Otherwise, the name must match a
schema name in the database, with "" used to retrieve those
without a schema name.
|
foreignTable | the name of the table importing the key. It must match the name of the table in the database. |
ResultSet
containing rows with the descriptions of the
foreign keys laid out according to the format defined above.
SQLException | if there is a database error. |
---|
Returns the major version number of the database software.
SQLException | a database error occurred. |
---|
Returns the minor version number of the database software.
SQLException | a database error occurred. |
---|
Returns the name of the database software.
String
with the name of the database software.
SQLException | a database error occurred. |
---|
Returns the version number of this database software.
String
with the version number of the database
software.
SQLException | a database error occurred. |
---|
Returns the default transaction isolation level for this database.
TRANSACTION_NONE
TRANSACTION_READ_COMMITTED
TRANSACTION_READ_UNCOMMITTED
TRANSACTION_REPEATABLE_READ
TRANSACTION_SERIALIZABLE
SQLException | a database error occurred. |
---|
Returns the JDBC driver's major version number.
Returns the JDBC driver's minor version number.
Returns the name of this JDBC driver.
String
containing the name of the JDBC driver
SQLException | a database error occurred. |
---|
Returns the version number of this JDBC driver.
String
containing the complete version number of the
JDBC driver.
SQLException | a database error occurred. |
---|
Returns a list of the foreign key columns that reference the primary key columns of a specified table (the foreign keys exported by a table).
The list is returned as a
ResultSet
with a row for each of the
foreign key columns, ordered by
FKTABLE_CAT
,
FKTABLE_SCHEM
,
FKTABLE_NAME
, and
KEY_SEQ
, with the
format for each row being:
PKTABLE_CAT
- String - from the primary key table : the catalog (possibly
null
)
PKTABLE_SCHEM
- String - from the primary key table : the schema (possibly
null
)
PKTABLE_NAME
- String - from the primary key table : the name
PKCOLUMN_NAME
- String - from the primary key column : the name
FKTABLE_CAT
- String - from the foreign key table : the catalog name being
exported (possibly
null
)
FKTABLE_SCHEM
- String - from the foreign key table : the schema name
being exported (possibly
null
)
FKTABLE_NAME
- String - from the foreign key table : the name being
exported
FKCOLUMN_NAME
- String - from the foreign key column : the name being
exported
KEY_SEQ
- short - the sequence number (in the foreign key)
UPDATE_RULE
- short - a value giving the rule for how to treat the foreign key when the corresponding primary
key is updated:
DatabaseMetaData.importedKeyNoAction
- don't allow the
primary key to be updated if it is imported as a foreign key
DatabaseMetaData.importedKeyCascade
- change the imported key to
match the primary key update
DatabaseMetaData.importedKeySetNull
- set the imported key to
null
DatabaseMetaData.importedKeySetDefault
- set the imported key
to its default value
DatabaseMetaData.importedKeyRestrict
- same as
importedKeyNoAction
DELETE_RULE
- short - how to treat the foreign key when the corresponding primary
key is deleted:
DatabaseMetaData.importedKeyNoAction
- don't allow the
primary key to be deleted if it is imported as a foreign key
DatabaseMetaData.importedKeyCascade
- the deletion should
also delete rows that import a deleted key
DatabaseMetaData.importedKeySetNull
- the deletion sets the
imported key to
null
DatabaseMetaData.importedKeySetDefault
- the deletion sets the
imported key to its default value
DatabaseMetaData.importedKeyRestrict
- same as
importedKeyNoAction
FK_NAME
- String - the foreign key name (possibly
null
)
PK_NAME
- String - the primary key name (possibly
null
)
DEFERRABILITY
- short - defines whether the foreign key
constraints can be deferred until commit (see the SQL92 specification for
definitions):
DatabaseMetaData.importedKeyInitiallyDeferred
DatabaseMetaData.importedKeyInitiallyImmediate
DatabaseMetaData.importedKeyNotDeferrable
catalog |
a catalog name.
null
is used to imply no narrowing of
the search by catalog name. Otherwise, the name must match a
catalog name held in the database, with "" used to retrieve
those without a catalog name.
|
---|---|
schema |
a schema name.
null
is used to imply no narrowing of
the search by schema name. Otherwise, the name must match a
schema name in the database, with "" used to retrieve those
without a schema name.
|
table | a table name, which must match the name of a table in the database |
ResultSet
containing a row for each of the foreign key
columns, as defined above
SQLException | a database error occurred |
---|
Returns a string of characters that may be used in unquoted identifier
names. The characters
a-z
,
A-Z
,
0-9
and
_
are always permitted.
SQLException | a database error occurred. |
---|
Returns a description according to the given catalog's system or user function parameters and return type.
catalog | the given catalong |
---|---|
schemaPattern | the schema pattern |
functionNamePattern | the function name pattern |
columnNamePattern | the column name pattern |
SQLException | if any error occurs |
---|
Returns a description of the system and user functions available according to the given catalog.
catalog | the given catalog |
---|---|
schemaPattern | the schema pattern |
functionNamePattern | the function name pattern |
SQLException | if any error occurs |
---|
Returns the string used to quote SQL identifiers. Returns " " (space) if identifier quoting not supported.
SQLException | a database error occurred. |
---|
Returns a list columns in a table that are both primary keys and referenced by the table's foreign key columns (that is, the primary keys imported by a table).
The list returned is a
ResultSet
with a row entry for each
primary key column, ordered by
PKTABLE_CAT
,
PKTABLE_SCHEM
,
PKTABLE_NAME
, and
KEY_SEQ
, with the following format:
PKTABLE_CAT
- String - primary key catalog name being
imported (possibly
null
)
PKTABLE_SCHEM
- String - primary key schema name being
imported (possibly
null
)
PKTABLE_NAME
- String - primary key table name being imported
PKCOLUMN_NAME
- String - primary key column name being
imported
FKTABLE_CAT
- String - foreign key table catalog name
(possibly
null
)
FKTABLE_SCHEM
- String - foreign key table schema name
(possibly
null
)
FKTABLE_NAME
- String - foreign key table name
FKCOLUMN_NAME
- String - foreign key column name
KEY_SEQ
- short - sequence number (in the foreign key)
UPDATE_RULE
- short - how to treat the foreign key when the corresponding primary
key is updated:
DatabaseMetaData.importedKeyNoAction
- don't allow any update of
the primary key if it is imported as a foreign key
DatabaseMetaData.importedKeyCascade
- change imported key to
match the primary key update
DatabaseMetaData.importedKeySetNull
- set the imported key to
null
DatabaseMetaData.importedKeySetDefault
- set the imported key
to its default value
DatabaseMetaData.importedKeyRestrict
- same as
importedKeyNoAction
DELETE_RULE
- short - how to treat the foreign key when the corresponding primary
key is deleted:
DatabaseMetaData.importedKeyNoAction
- don't allow the primary key to be deleted
if it is imported as a foreign key
DatabaseMetaData.importedKeyCascade
- delete those rows that
import a deleted key
DatabaseMetaData.importedKeySetNull
- set the imported key to
null
DatabaseMetaData.importedKeySetDefault
- set the imported key
to its default value
DatabaseMetaData.importedKeyRestrict
- same as
importedKeyNoAction
FK_NAME
- String - foreign key name (possibly
null
)
PK_NAME
- String - primary key name (possibly
null
)
DEFERRABILITY
- short - defines whether foreign key
constraints can be deferred until commit (see SQL92 specification for
definitions):
DatabaseMetaData.importedKeyInitiallyDeferred
DatabaseMetaData.importedKeyInitiallyImmediate
DatabaseMetaData.importedKeyNotDeferrable
catalog |
a catalog name.
null
is used to imply no narrowing of
the search by catalog name. Otherwise, the name must match a
catalog name held in the database, with "" used to retrieve
those without a catalog name.
|
---|---|
schema |
a schema name.
null
is used to imply no narrowing of
the search by schema name. Otherwise, the name must match a
schema name in the database, with "" used to retrieve those
without a schema name.
|
table | a table name, which must match the name of a table in the database. |
ResultSet
containing the list of primary key columns as
rows in the format defined above.
SQLException | a database error occurred. |
---|
Returns a list of indices and statistics for a specified table.
The list is returned as a
ResultSet
, with one row for each index
or statistic. The list is ordered by
NON_UNIQUE
,
TYPE
,
INDEX_NAME
, and
ORDINAL_POSITION
. Each row has the
following format:
TABLE_CAT
- String - table catalog name (possibly
null
)
TABLE_SCHEM
- String - table schema name (possibly
null
)
TABLE_NAME
- String - The table name
NON_UNIQUE
- boolean -
true
when index values can be
non-unique. Must be
false
when the TYPE is tableIndexStatistic
INDEX_QUALIFIER
- String : index catalog name.
null
when the TYPE is 'tableIndexStatistic'
INDEX_NAME
- String : index name.
null
when TYPE is
'tableIndexStatistic'
TYPE
- short - the index type. One of:
DatabaseMetaData.tableIndexStatistic
- table statistics
returned with Index descriptions
DatabaseMetaData.tableIndexClustered
- a clustered Index
DatabaseMetaData.tableIndexHashed
- a hashed Index
DatabaseMetaData.tableIndexOther
- other style of Index
ORDINAL_POSITION
- short - column sequence within Index. 0
when TYPE is tableIndexStatistic
COLUMN_NAME
- String - the column name.
null
when
TYPE is tableIndexStatistic
ASC_OR_DESC
- String - column sort sequence.
null
if
sequencing not supported or TYPE is tableIndexStatistic; otherwise "A"
means sort ascending and "D" means sort descending.
CARDINALITY
- int - Number of unique values in the Index. If
TYPE is tableIndexStatistic, this is number of rows in the table.
PAGES
- int - Number of pages for current Index. If TYPE is
tableIndexStatistic, this is number of pages used for the table.
FILTER_CONDITION
- String - Filter condition. (possibly null)
catalog |
a catalog name.
null
is used to imply no narrowing of
the search by catalog name. Otherwise, the name must match a
catalog name held in the database, with "" used to retrieve
those without a catalog name.
|
---|---|
schema |
a schema name.
null
is used to imply no narrowing of
the search by schema name. Otherwise, the name must match a
schema name in the database, with "" used to retrieve those
without a schema name.
|
table | a table name, which must match the name of a table in the database. |
unique |
true
means only return indices for unique values,
false
implies that they can be returned even if not
unique.
|
approximate |
true
implies that the list can contain approximate or
"out of data" values,
false
implies that all values
must be precisely accurate
|
ResultSet
containing the list of indices and statistics
for the table, in the format defined above.
SQLException | a database error occurred. |
---|
Returns this driver's major JDBC version number.
SQLException | a database error occurred. |
---|
Returns the minor JDBC version number for this driver.
SQLException | a database error occurred. |
---|
Get the maximum number of hex characters in an in-line binary literal for this database.
SQLException | a database error occurred. |
---|
Returns the maximum size of a catalog name in this database.
SQLException | a database error occurred. |
---|
Returns the maximum size for a character literal in this database.
SQLException | a database error occurred. |
---|
Returns the maximum size for a Column name for this database.
SQLException | a database error occurred. |
---|
Get the maximum number of columns in a
GROUP BY
clause for this
database.
GROUP BY
clause. If
the limit is unknown, or the value is unlimited, then the result
is zero.
SQLException | a database error occurred. |
---|
Returns the maximum number of columns in an Index for this database.
SQLException | a database error occurred. |
---|
Returns the maximum number of columns in an
ORDER BY
clause for
this database.
ORDER BY
clause. If
the limit is unknown, or the value is unlimited, then the result
is zero.
SQLException | a database error occurred. |
---|
Returns the maximum number of columns in a
SELECT
list for this
database.
SELECT
list. If the
limit is unknown, or the value is unlimited, then the result is
zero.
SQLException | a database error occurred. |
---|
Returns the maximum number of columns in a table for this database.
SQLException | a database error occurred. |
---|
Returns the database's maximum number of concurrent connections.
SQLException | a database error occurred. |
---|
Returns the maximum length of a cursor name for this database.
SQLException | a database error occurred. |
---|
Returns the maximum length in bytes for an Index for this database. This covers all the parts of a composite index.
SQLException | a database error occurred. |
---|
Returns the maximum number of characters for a procedure name in this database.
SQLException | a database error occurred. |
---|
Returns the maximum number of bytes within a single row for this database.
SQLException | a database error occurred. |
---|
Returns the maximum number of characters in a schema name for this database.
SQLException | a database error occurred. |
---|
Returns the maximum number of characters in an SQL statement for this database.
SQLException | a database error occurred. |
---|
Get the maximum number of simultaneously open active statements for this database.
SQLException | a database error occurred. |
---|
Returns the maximum size for a table name in the database.
SQLException | a database error occurred. |
---|
Returns the maximum number of tables permitted in a
SELECT
statement for the database.
SELECT
statement. If the limit is unknown, or the value is unlimited,
then the result is zero.
SQLException | a database error occurred. |
---|
Returns the maximum number of characters in a user name for the database.
SQLException | a database error occurred. |
---|
Returns a list of the math functions available with this database. These are used in the JDBC function escape clause and are the Open Group CLI math function names.
SQLException | a database error occurred. |
---|
Returns a list of the primary key columns of a specified table.
The list is returned as a
ResultSet
with one row for each primary
key column, ordered by
COLUMN_NAME
, with each row having the
structure as follows:
TABLE_CAT
- String - table catalog name (possibly null)
TABLE_SCHEM
- String - table schema name (possibly null)
TABLE_NAME
- String - The table name
COLUMN_NAME
- String - The column name
KEY_SEQ
- short - the sequence number for this column in the
primary key
PK_NAME
- String - the primary key name (possibly null)
catalog |
a catalog name.
null
is used to imply no narrowing of
the search by catalog name. Otherwise, the name must match a
catalog name held in the database, with the empty string used
to retrieve those without a catalog name.
|
---|---|
schema |
a schema name.
null
is used to imply no narrowing of
the search by schema name. Otherwise, the name must match a
schema name in the database, with the empty string used to
retrieve those without a schema name.
|
table | the name of a table, which must match the name of a table in the database. |
ResultSet
containing the list of keys in the format
defined above.
SQLException | a database error occurred. |
---|
Returns a list of parameter and result columns for the stored procedures belonging to a specified catalog.
The list is returned as a
ResultSet
with one row for each
parameter or result column. The data is ordered by
PROCEDURE_SCHEM
and
PROCEDURE_NAME
, while for each procedure,
the return value (if any) is first, followed by the parameters in the
order they appear in the stored procedure call, followed by
ResultSet
columns in column number order. Each row has the following
structure:
PROCEDURE_CAT
- String - the procedure catalog name
PROCEDURE_SCHEM
- String - the procedure schema name
(possibly null)
PROCEDURE_NAME
- String - the procedure name
COLUMN_NAME
- String - the name of the column
COLUMN_TYPE
- short - the kind of column or parameter, as
follows:
DatabaseMetaData.procedureColumnUnknown
- type unknown
DatabaseMetaData.procedureColumnIn
- an
IN
parameter
DatabaseMetaData.procedureColumnInOut
- an
INOUT
parameter
DatabaseMetaData.procedureColumnOut
- an
OUT
parameter
DatabaseMetaData.procedureColumnReturn
- a return value
DatabaseMetaData.procedureReturnsResult
- a result column in
a result set
DATA_TYPE
- int - the SQL type of the data, as in
java.sql.Types
TYPE_NAME
- String - the SQL type name, for a UDT it is fully
qualified
PRECISION
- int - the precision
LENGTH
- int - the length of the data in bytes
SCALE
- short - the scale for numeric types
RADIX
- short - the Radix for numeric data (typically 2 or
10)
NULLABLE
- short - can the data contain
null
:
DatabaseMetaData.procedureNoNulls
-
NULL
s not
permitted
DatabaseMetaData.procedureNullable
-
NULL
s are
permitted
DatabaseMetaData.procedureNullableUnknown
-
NULL
status unknown
REMARKS
- String - an explanatory comment about the data item
catalog |
a catalog name.
null
is used to imply no narrowing of
the search by catalog name. Otherwise, the name must match a
catalog name held in the database, with "" used to retrieve
those without a catalog name.
|
---|---|
schemaPattern |
a schema name pattern.
null
is used to imply no
narrowing of the search by schema name. Otherwise, the name
must match a schema name in the database, with "" used to
retrieve those without a schema name.
|
procedureNamePattern | a pattern that must match the name of the procedure stored in the database. |
columnNamePattern | a column name pattern. The name must match the column name stored in the database. |
ResultSet
with the list of parameter and result columns
in the format defined above.
SQLException | a database error occurred. |
---|
Returns the database vendor's preferred name for "procedure".
SQLException | a database error occurred. |
---|
Returns a list of the stored procedures available in a specified catalog.
The list is returned as a
ResultSet
with one row for each stored
procedure, ordered by PROCEDURE_SCHEM and PROCEDURE_NAME, with the data
in each row as follows:
PROCEDURE_CAT
- String : the procedure catalog name
PROCEDURE_SCHEM
- String : the procedure schema name
(possibly
null
)
PROCEDURE_NAME
- String : the procedure name
Reserved
Reserved
Reserved
REMARKS
- String - information about the procedure
PROCEDURE_TYPE
- short : one of:
DatabaseMetaData.procedureResultUnknown
- procedure may
return a result
DatabaseMetaData.procedureNoResult
- procedure does not
return a result
DatabaseMetaData.procedureReturnsResult
- procedure
definitely returns a result
catalog |
a catalog name.
null
is used to imply no narrowing of
the search by catalog name. Otherwise, the name must match a
catalog name held in the database, with "" used to retrieve
those without a catalog name.
|
---|---|
schemaPattern |
a schema name pattern.
null
is used to imply no
narrowing of the search by schema name. Otherwise, the name
must match a schema name in the database, with "" used to
retrieve those without a schema name.
|
procedureNamePattern | a procedure name pattern, which must match the procedure name stored in the database. |
ResultSet
where each row is a description of a stored
procedure in the format defined above.
SQLException | a database error occurred. |
---|
Returns the result set's default holdability.
ResultSet.HOLD_CURSORS_OVER_COMMIT
or
ResultSet.CLOSE_CURSORS_AT_COMMIT
.
SQLException | a database error occurred. |
---|
Returns the lifetime for which a RowId object remains valid if this data source supports the SQL ROWID type
SQLException | if any error occurs |
---|
Returns a list of all the SQL keywords that are NOT also SQL92 keywords for the database.
SQLException | a database error occurred. |
---|
States the type of
SQLState
value returned by
SQLException.getSQLState
. This can either be the X/Open (now known as
Open Group) SQL CLI form or the SQL99 form.
DatabaseMetaData.sqlStateSQL99
or
DatabaseMetaData.sqlStateXOpen
.
SQLException | a database error occurred. |
---|
Returns the database vendor's preferred term for "schema".
SQLException | a database error occurred. |
---|
Returns the schema names ordered by TABLE_CATALOG and TABLE_SCHEMA.
catalog | the catalog |
---|---|
schemaPattern | the schema pattern |
SQLException | if any error occurs |
---|
Returns a list of the schema names in the database. The list is returned
as a
ResultSet
, ordered by the schema name, with one row per
schema in the following format:
TABLE_SCHEM
- String - the schema name
TABLE_CATALOG
- String - the catalog name (possibly
null
)
ResultSet
with one row for each schema in the format
defined above.
SQLException | a database error occurred. |
---|
Returns the string that is used to escape wildcard characters. This
string is used to escape the
'_'
and
'%'
wildcard
characters in catalog search pattern strings.
'_'
is used to represent any single
character while
'%'
is used for a sequence of zero or more
characters.
SQLException | a database error occurred. |
---|
Returns a list of string functions available with the database. These functions are used in JDBC function escape clause and follow the Open Group CLI string function names definition.
SQLException | a database error occurred. |
---|
Returns a listing of the hierarchies of tables in a specified schema in the database.
The listing only contains entries for tables that have a super table.
Super tables and corresponding subtables must be defined in the same catalog and schema. The
list is returned as a
ResultSet
, with one row for each table that
has a super table, in the following format:
TABLE_CAT
- String - table catalog name (possibly
null
)
TABLE_SCHEM
- String - Table schema name (possibly
null
)
TABLE_NAME
- String - The table name
TABLE_NAME
- String - The super table name
catalog |
a catalog name.
null
is used to imply no narrowing of
the search by catalog name. Otherwise, the name must match a
catalog name held in the database, with "" used to retrieve
those without a catalog name.
|
---|---|
schemaPattern |
a schema name pattern.
null
is used to imply no
narrowing of the search by schema name. Otherwise, the name
must match a schema name in the database, with "" used to
retrieve those without a schema name.
|
tableNamePattern | a table name, which should match the table name as stored in the database. it may be a fully qualified name. If it is fully qualified the catalog name and schema name parameters are ignored. |
ResultSet
with one row for each table which has a super
table, in the format defined above. An empty
ResultSet
is
returned if the database does not support table hierarchies.
SQLException | a database error occurred. |
---|
Returns the User Defined Type (UDT) hierarchies for a given schema. Only the immediate parent/child relationship is described. If a UDT does not have a direct supertype, it is not listed.
The listing is returned as a
ResultSet
where there is one row for
a specific UDT which describes its supertype, with the data organized in
columns as follows:
TYPE_CAT
- String - the UDT catalog name (possibly
null
)
TYPE_SCHEM
- String - the UDT schema name (possibly
null
)
TYPE_NAME
- String - the UDT type name
TYPE_CAT
- String - direct supertype's catalog name
(possibly
null
)
TYPE_SCHEM
- String - direct supertype's schema name
(possibly
null
)
TYPE_NAME
- String - direct supertype's name
catalog |
the catalog name. "" means get the UDTs without a catalog.
null
means don't use the catalog name to restrict the
search.
|
---|---|
schemaPattern | the Schema pattern name. "" means get the UDT's without a schema. |
typeNamePattern | the UDT name pattern. This may be a fully qualified name. When a fully qualified name is specified, the catalog name and schema name parameters are ignored. |
ResultSet
in which each row gives information about a
particular UDT in the format defined above. An empty ResultSet is
returned for a database that does not support type hierarchies.
SQLException | a database error occurred. |
---|
Returns a list of system functions available with the database. These are names used in the JDBC function escape clause and are Open Group CLI function names.
SQLException | a database error occurred. |
---|
Returns a description of access rights for each table present in a catalog. Table privileges can apply to one or more columns in the table - but are not guaranteed to apply to all columns.
The privileges are returned as a
ResultSet
, with one row for each
privilege, ordered by
TABLE_SCHEM
,
TABLE_NAME
,
PRIVILEGE
, and each row has data as defined in the following column
definitions:
TABLE_CAT
- String - table catalog name (possibly
null
)
TABLE_SCHEM
- String - Table schema name (possibly
null
)
TABLE_NAME
- String - The table name
"YES"
implies the grantee can grant
access to others,
"NO"
implies guarantee cannot grant access to
others,
null
means this status is unknown
catalog |
a catalog name.
null
is used to imply no narrowing of
the search by catalog name. Otherwise, the name must match a
catalog name held in the database, with "" used to retrieve
those without a catalog name.
|
---|---|
schemaPattern |
a schema name pattern.
null
is used to imply no
narrowing of the search by schema name. Otherwise, the name
must match a schema name in the database, with "" used to
retrieve those without a schema name.
|
tableNamePattern | a Table Name, which should match the table name as stored in the database. |
ResultSet
containing a list with one row for each table
in the format defined above.
SQLException | a database error occurred. |
---|
Returns a list of table types supported by the database.
The list is returned as a
ResultSet
with one row per table type,
ordered by the table type. The information in the
ResultSet
is
structured into a single column per row, as follows:
TABLE_TYPE
- String - the table type. Typical names include
"TABLE"
,
"VIEW"
, "
SYSTEM TABLE"
,
"ALIAS"
,
"SYNONYM"
,
"GLOBAL TEMPORARY"
ResultSet
with one row per table type in the format
defined above.
SQLException | a database error occurred. |
---|
Returns a description of the tables in a specified catalog.
The descriptions are returned as rows in a
ResultSet
, one row for
each Table. The ResultSet is ordered by
TABLE_TYPE
,
TABLE_SCHEM
and
TABLE_NAME
. Each row in the ResultSet consists
of a series of columns as follows:
TABLE_CAT
- String - table catalog name (possibly
null
)
TABLE_SCHEM
- String - Table schema name (possibly
null
)
TABLE_NAME
- String - The table name
TABLE_TYPE
- String - Typical names include "TABLE", "VIEW",
"SYSTEM TABLE", "ALIAS", "SYNONYM", "GLOBAL TEMPORARY"
REMARKS
- String - A comment describing the table
TYPE_CAT
- String - the 'Types' catalog(possibly
null
)
TYPE_SCHEM
- String - the 'Types' schema(possibly
null
)
TYPE_NAME
- String - the 'Types' name (possibly
null
)
SELF_REFERENCING_COL_NAME
- String - the name of a designated
identifier column in a typed table (possibly
null
)
SELF_REFERENCING_COL_NAME
are created (possibly
null
)
catalog |
a catalog name.
null
is used to imply no narrowing of
the search by catalog name. Otherwise, the name must match a
catalog name held in the database, with "" used to retrieve
those without a catalog name.
|
---|---|
schemaPattern |
a schema name pattern.
null
is used to imply no
narrowing of the search by schema name. Otherwise, the name
must match a schema name in the database, with "" used to
retrieve those without a schema name.
|
tableNamePattern | a table name, which should match the table name as stored in the database. |
types |
a list of table types to include in the list.
null
implies list all types.
|
ResultSet
with one row per table in the format defined
above.
SQLException | a database error occurred. |
---|
Returns a list of time and date functions available for the database.
SQLException | a database error occurred. |
---|
Get a list of the standard SQL types supported by this database. The list
is returned as a
ResultSet
, with one row for each type, ordered
by the
DATA_TYPE
value, where the data in each row is structured
into the following columns:
TYPE_NAME
- String : the type name
DATA_TYPE
- int : the SQL data type value as defined in
java.sql.Types
PRECISION
- int - the maximum precision of the type
LITERAL_PREFIX
- String : the prefix to be used when quoting
a literal value (possibly
null
)
LITERAL_SUFFIX
- String : the suffix to be used when quoting
a literal value (possibly
null
)
CREATE_PARAMS
- String : params used when creating the type
(possibly
null
)
NULLABLE
- short : shows if the value is nullable:
DatabaseMetaData.typeNoNulls
:
NULL
s not permitted
DatabaseMetaData.typeNullable
:
NULL
s are permitted
DatabaseMetaData.typeNullableUnknown
:
NULL
status
unknown
CASE_SENSITIVE
- boolean : true if the type is case sensitive
SEARCHABLE
- short : how this type can be used with
WHERE
clauses:
DatabaseMetaData.typePredNone
-
WHERE
clauses cannot be used
DatabaseMetaData.typePredChar
- support for
WHERE...LIKE
only
DatabaseMetaData.typePredBasic
- support except for
WHERE...LIKE
DatabaseMetaData.typeSearchable
- support for all
WHERE
clauses
UNSIGNED_ATTRIBUTE
- boolean - the type is unsigned or not
FIXED_PREC_SCALE
- boolean - fixed precision = it can be used
as a money value
AUTO_INCREMENT
- boolean - can be used as an auto-increment
value
LOCAL_TYPE_NAME
- String - a localized version of the type
name (possibly
null
)
MINIMUM_SCALE
- short - the minimum scale supported
MAXIMUM_SCALE
- short - the maximum scale supported
SQL_DATA_TYPE
- int - not used
SQL_DATETIME_SUB
- int - not used
NUM_PREC_RADIX
- int - number radix (typically 2 or 10)
ResultSet
which is structured as described above.
SQLException | a database error occurred. |
---|
Returns a description of the User Defined Types (UDTs) defined in a given
schema, which includes the types
DISTINCT
,
STRUCT
and
JAVA_OBJECT
.
The types matching the supplied the specified catalog, schema, type name
and type are returned as rows in a
ResultSet
with columns of
information as follows:
TABLE_CAT
- String - catalog name (possibly
null
)
TABLE_SCHEM
- String - schema name (possibly
null
)
TABLE_NAME
- String - The table name
CLASS_NAME
- String - The Java class name
DATA_TYPE
- int - The SQL type as specified in
java.sql.Types
. One of DISTINCT, STRUCT, and JAVA_OBJECT
REMARKS
- String - A comment which describes the type
BASE_TYPE
- short - A type code. For a DISTINCT type, the
source type. For a structured type this is the type that implements the
user generated reference type of the
SELF_REFERENCING_COLUMN
.
This is defined in
java.sql.Types
, and will be
null
if
the
DATA_TYPE
does not match these criteria.
If the driver does not support UDTs, the
ResultSet
is empty.
catalog |
a catalog name.
null
is used to imply no narrowing of
the search by catalog name. Otherwise, the name must match a
catalog name held in the database, with "" used to retrieve
those without a catalog name.
|
---|---|
schemaPattern |
a schema name pattern.
null
is used to imply no
narrowing of the search using schema name. Otherwise, the name
must match a schema name in the database, with "" used to
retrieve those without a schema name.
|
typeNamePattern | a type name pattern, which should match a type name as stored in the database. It may be fully qualified. |
types |
a list of the UDT types to include in the list - one of
DISTINCT
,
STRUCT
or
JAVA_OBJECT
.
|
ResultSet
in the format described above.
SQLException | a database error occurred. |
---|
Returns the URL for this database.
null
if it cannot be generated.
SQLException | a database error occurred. |
---|
Determine the user name as known by the database.
SQLException | a database error occurred. |
---|
Returns which of a table's columns are automatically updated when any value in a row is updated.
The result is laid-out in the following columns:
SCOPE
- short - not used
COLUMN_NAME
- String - Column name
DATA_TYPE
- int - The SQL data type, as defined in
java.sql.Types
TYPE_NAME
- String - The SQL type name, data source dependent
COLUMN_SIZE
- int - Precision for numeric types
BUFFER_LENGTH
- int - Length of a column value in bytes
DECIMAL_DIGITS
- short - Number of digits after the decimal
point
PSEUDO_COLUMN
- short - If this is a pseudo-column (for
example, an Oracle
ROWID
):
DatabaseMetaData.bestRowUnknown
- don't know whether this is
a pseudo column
DatabaseMetaData.bestRowNotPseudo
- column is not pseudo
DatabaseMetaData.bestRowPseudo
- column is a pseudo column
catalog |
a catalog name.
null
is used to imply no narrowing of
the search using catalog name. Otherwise, the name must match
a catalog name held in the database, with "" used to retrieve
those without a catalog name.
|
---|---|
schema |
a schema name pattern.
null
is used to imply no
narrowing of the search using schema names. Otherwise, the
name must match a schema name in the database, with "" used to
retrieve those without a schema name.
|
table | a table name. It must match the name of a table in the database. |
ResultSet
containing the descriptions, one row for each
column, in the format defined above.
SQLException | a database error occurred. |
---|
Determines whether a visible row insert can be detected by calling
ResultSet.rowInserted
.
type |
the
ResultSet
type. This may be one of
ResultSet.TYPE_SCROLL_SENSITIVE
or
ResultSet.TYPE_SCROLL_INSENSITIVE
or
ResultSet.TYPE_FORWARD_ONLY
,
|
---|
true
if
ResultSet.rowInserted
detects a visible
row insert otherwise
false
.
SQLException | a database error occurred. |
---|
Determine whether a fully qualified table name is prefixed or suffixed to a fully qualified table name.
true
if the catalog appears at the start of a fully
qualified table name,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether the database is in read-only mode.
true
if the database is in read-only mode,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether updates are made to a copy of, or directly on, Large Objects
(
LOB
s).
true
if updates are made to a copy of the Large Object,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether the database handles concatenations between
NULL
and
non-
NULL
values by producing a
NULL
output.
true
if
NULL
to non-
NULL
concatenations
produce a
NULL
result,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether
NULL
values are always sorted to the end of sorted
results regardless of requested sort order. This means that they will
appear at the end of sorted lists whatever other non-
NULL
values
may be present.
true
if
NULL
values are sorted at the end,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether
NULL
values are always sorted at the start of the
sorted list, irrespective of the sort order. This means that they appear
at the start of sorted lists, whatever other values may be present.
true
if
NULL
values are sorted at the start,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether
NULL
values are sorted high - i.e. they are sorted
as if they are higher than any other values.
true
if
NULL
values are sorted high,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether
NULL
values are sorted low - i.e. they are sorted as
if they are lower than any other values.
true
if
NULL
values are sorted low,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether deletes made by others are visible, for a specified
ResultSet
type.
type |
the type of the
ResultSet
. It may be either
ResultSet.TYPE_FORWARD_ONLY
or
ResultSet.TYPE_SCROLL_INSENSITIVE
, or
ResultSet.TYPE_SCROLL_SENSITIVE
)
|
---|
true
if others' deletes are visible,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether inserts made by others are visible, for a specified
ResultSet
type.
type |
the type of the
ResultSet
. May be
ResultSet.TYPE_FORWARD_ONLY
, or
ResultSet.TYPE_SCROLL_INSENSITIVE
, or
ResultSet.TYPE_SCROLL_SENSITIVE
|
---|
true
if others' inserts are visible, otherwise
false
.
SQLException | a database error occurred. |
---|
Determines whether updates made by others are visible, for a specified
ResultSet
type.
type |
the type of the
ResultSet
. May be
ResultSet.TYPE_FORWARD_ONLY
, or
ResultSet.TYPE_SCROLL_INSENSITIVE
, or
ResultSet.TYPE_SCROLL_SENSITIVE
|
---|
true
if others' inserts are visible, otherwise
false
.
SQLException | a database error occurred. |
---|
Determines whether a
ResultSet
can see its own deletes, for a
specified
ResultSet
type.
type |
the type of the
ResultSet
:
ResultSet.TYPE_FORWARD_ONLY
,
ResultSet.TYPE_SCROLL_INSENSITIVE
, or
ResultSet.TYPE_SCROLL_SENSITIVE
|
---|
true
if the deletes are seen by the
ResultSet
itself, otherwise
false
.
SQLException | a database error occurred. |
---|
Determines whether a
ResultSet
can see its own inserts, for a
specified
ResultSet
type.
type |
the type of the
ResultSet
:
ResultSet.TYPE_FORWARD_ONLY
,
ResultSet.TYPE_SCROLL_INSENSITIVE
, or
ResultSet.TYPE_SCROLL_SENSITIVE
|
---|
true
if the inserts are seen by the
ResultSet
itself, otherwise
false
.
SQLException | a database error occurred. |
---|
Determines whether a
ResultSet
can see its own updates, for a
specified
ResultSet
type.
type |
the type of the
ResultSet
:
ResultSet.TYPE_FORWARD_ONLY
,
ResultSet.TYPE_SCROLL_INSENSITIVE
, or
ResultSet.TYPE_SCROLL_SENSITIVE
|
---|
true
if the updates are seen by the
ResultSet
itself, otherwise
false
.
SQLException | a database error occurred. |
---|
Determines whether the database treats SQL identifiers that are in mixed
case (and unquoted) as case insensitive. If
true
then the
database stores them in lower case.
true
if unquoted SQL identifiers are stored in lower
case,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether the database considers mixed case quoted SQL identifiers as case insensitive and stores them in lower case.
true
if quoted SQL identifiers are stored in lower case,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether the database considers mixed case unquoted SQL identifiers as case insensitive and stores them in mixed case.
true
if unquoted SQL identifiers as stored in mixed case,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether the database considers identifiers as case insensitive if they are mixed case quoted SQL. The database stores them in mixed case.
true
if quoted SQL identifiers are stored in mixed case,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether the database considers mixed case unquoted SQL identifiers as case insensitive and stores them in upper case.
true
if unquoted SQL identifiers are stored in upper
case,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether the database considers mixed case quoted SQL identifiers as case insensitive and stores them in upper case.
true
if quoted SQL identifiers are stored in upper case,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether the database supports the ANSI92 entry level SQL grammar.
true
if the ANSI92 entry level SQL grammar is supported,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether the database supports the ANSI92 full SQL grammar.
true
if the ANSI92 full SQL grammar is supported,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether the database supports the ANSI92 intermediate SQL Grammar.
true
if the ANSI92 intermediate SQL grammar is supported,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether the database supports
ALTER TABLE
operation with
ADD COLUMN
.
true
if
ALTER TABLE
with
ADD COLUMN
is
supported,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether the database supports
ALTER TABLE
operation with
DROP COLUMN
.
true
if
ALTER TABLE
with
DROP COLUMN
is
supported,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether the database supports batch updates.
true
if batch updates are supported,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether catalog names may be used in data manipulation statements.
true
if catalog names can be used in data manipulation
statements,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether catalog names can be used in index definition statements.
true
if catalog names can be used in index definition
statements,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether catalog names can be used in privilege definition statements.
true
if catalog names can be used in privilege definition
statements,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether catalog names can be used in procedure call statements.
true
if catalog names can be used in procedure call
statements.
SQLException | a database error occurred. |
---|
Determines whether catalog names may be used in table definition statements.
true
if catalog names can be used in definition
statements,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether the database supports column aliasing.
If aliasing is supported, then the SQL AS clause is used to provide names for computed columns and provide alias names for columns.
true
if column aliasing is supported,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether the database supports
CONVERT
operation for two
supplied SQL types.
fromType |
the Type to convert from, as defined by
java.sql.Types
|
---|---|
toType |
the Type to convert to, as defined by
java.sql.Types
|
true
if the
CONVERT
operation is supported for
these types,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether the database supports the
CONVERT
operation between
SQL types.
true
if the
CONVERT
operation is supported,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether the database supports the Core SQL Grammar for ODBC.
true
if the Core SQL Grammar is supported,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether the database supports correlated sub-queries.
true
if the database does support correlated sub-queries
and
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether the database allows both data definition and data manipulation statements inside a transaction.
true
if both types of statement are permitted,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether the database only allows data manipulation statements inside a transaction.
true
if data manipulation statements are permitted only within a transaction,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether table correlation names are required to be different from the names of the tables, when they are supported.
true
if correlation names must be different from table
names,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether expressions in
ORDER BY
lists are supported.
true
if expressions in
ORDER BY
lists are
supported.
SQLException | a database error occurred. |
---|
Determines whether the Extended SQL Grammar for ODBC is supported.
true
if the Extended SQL Grammar is supported,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether the database supports full nested outer joins.
true
if full nested outer joins are supported,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether auto generated keys can be returned when a statement executes.
true
if auto generated keys can be returned,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether the database supports
GROUP BY
clauses.
true
if the
GROUP BY
clause is supported,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether the database supports using a column name in a
GROUP
BY
clause not included in the
SELECT
statement as long as all of
the columns in the
SELECT
statement are used in the
GROUP
BY
clause.
true
if
GROUP BY
clauses can use column names in
this way,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether the database supports using a column name in a
GROUP
BY
clause that is not in the
SELECT
statement.
true
if
GROUP BY
clause can use a column name not
in the
SELECT
statement,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether the database supports SQL Integrity Enhancement Facility.
true
if the Integrity Enhancement Facility is supported,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether the database supports a
LIKE
escape clause.
true
if LIKE escape clause is supported,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether the database provides limited support for outer join operations.
true
if there is limited support for outer join
operations,
false
otherwise. This will be
true
if
supportsFullOuterJoins
returns
true
.
SQLException | a database error occurred. |
---|
Determines whether the database supports Minimum SQL Grammar for ODBC.
true
if the Minimum SQL Grammar is supported,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether the database treats mixed case unquoted SQL identifiers as case sensitive storing them in mixed case.
true
if unquoted SQL identifiers are stored in mixed
case,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether the database considers mixed case quoted SQL identifiers as case sensitive, storing them in mixed case.
true
if quoted SQL identifiers are stored in mixed case,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether it is possible for a single
CallableStatement
to
return multiple
ResultSet
s simultaneously.
true
if a single
CallableStatement
can return
multiple
ResultSet
s simultaneously,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether retrieving multiple
ResultSet
s from a single
call to the
execute
method is supported.
true
if multiple
ResultSet
s can be retrieved,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether multiple simultaneous transactions on different connections are supported.
true
if multiple open transactions are supported,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether callable statements with named parameters is supported.
true
if named parameters can be used with callable
statements,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether columns in the database can be defined as non-nullable.
true
if columns can be defined non-nullable,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether keeping cursors open across commit operations is supported.
true
if cursors can be kept open across commit
operations,
false
if they might get closed.
SQLException | a database error occurred. |
---|
Determines whether the database can keep cursors open across rollback operations.
true
if cursors can be kept open across rollback
operations,
false
if they might get closed.
SQLException | a database error occurred. |
---|
Determines whether keeping statements open across commit operations is supported.
true
if statements can be kept open,
false
if
they might not.
SQLException | a database error occurred. |
---|
Determines whether keeping statements open across rollback operations is supported.
true
if statements can be kept open,
false
if
they might not.
SQLException | a database error occurred. |
---|
Determines whether using a column in an
ORDER BY
clause that is
not in the
SELECT
statement is supported.
true
if it is possible to
ORDER
using a column
not in the
SELECT
,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether outer join operations are supported.
true
if outer join operations are supported,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether positioned
DELETE
statements are supported.
true
if the database supports positioned
DELETE
statements.
SQLException | a database error occurred. |
---|
Determines whether positioned
UPDATE
statements are supported.
true
if the database supports positioned
UPDATE
statements,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether there is support for a given concurrency style for the
given
ResultSet
.
type |
the
ResultSet
type, as defined in
java.sql.ResultSet
:
|
---|---|
concurrency |
a concurrency type, which may be one of
ResultSet.CONCUR_READ_ONLY
or
ResultSet.CONCUR_UPDATABLE
.
|
true
if that concurrency and
ResultSet
type
pairing is supported otherwise
false
.
SQLException | a database error occurred. |
---|
Determines whether the supplied
ResultSet
holdability mode is
supported.
holdability |
as specified in
java.sql.ResultSet
:
ResultSet.HOLD_CURSORS_OVER_COMMIT
or
ResultSet.CLOSE_CURSORS_AT_COMMIT
|
---|
true
if the given ResultSet holdability is supported and
if it isn't then
false
.
SQLException | a database error occurred. |
---|
Determines whether the supplied
ResultSet
type is supported.
type |
the
ResultSet
type as defined in
java.sql.ResultSet
:
ResultSet.TYPE_FORWARD_ONLY
,
ResultSet.TYPE_SCROLL_INSENSITIVE
, or
ResultSet.TYPE_SCROLL_SENSITIVE
|
---|
true
if the
ResultSet
type is supported,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether savepoints for transactions are supported.
true
if savepoints are supported,
false
otherwise.
SQLException | a database error occurred. |
---|
Determines whether a schema name may be used in a data manipulation statement.
true
if a schema name can be used in a data manipulation,
otherwise
false
.
SQLException | a database error occurred. |
---|
Determines whether a schema name may be used in an index definition statement.
true
if a schema name can be used in an index definition,
otherwise
false
.
SQLException | a database error occurred. |
---|
Determines whether a database schema name can be used in a privilege definition statement.
true
if a database schema name may be used in a privilege
definition, otherwise
false
SQLException | a database error occurred. |
---|
Determines whether a procedure call statement may be contain in a schema name.
true
if a schema name can be used in a procedure call,
otherwise
false
.
SQLException | a database error occurred. |
---|
Determines whether a schema name can be used in a table definition statement.
true
if a schema name can be used in a table definition,
otherwise
false
.
SQLException | a database error occurred. |
---|
Determines whether the
SELECT FOR UPDATE
statement is supported.
true
if
SELECT FOR UPDATE
statements are
supported, otherwise
false
.
SQLException | a database error occurred. |
---|
Determines whether statement pooling is supported.
true
of the database does support statement pooling,
otherwise
false
.
SQLException | a database error occurred. |
---|
Determine if this database supports invoking user-defined or vendor functions using the stored procedure escape syntax.
SQLException | if any error occurs |
---|
Determines whether stored procedure calls using the stored procedure escape syntax is supported.
true
if stored procedure calls using the stored procedure
escape syntax are supported, otherwise
false
.
SQLException | a database error occurred. |
---|
Determines whether subqueries in comparison expressions are supported.
true
if subqueries are supported in comparison
expressions.
SQLException | a database error occurred. |
---|
Determines whether subqueries in
EXISTS
expressions are supported.
true
if subqueries are supported in
EXISTS
expressions, otherwise
false
.
SQLException | a database error occurred. |
---|
Determines whether subqueries in
IN
statements are supported.
true
if subqueries are supported in
IN
statements,
otherwise
false
.
SQLException | a database error occurred. |
---|
Determines whether subqueries in quantified expressions are supported.
true
if subqueries are supported, otherwise
false
.
SQLException | a database error occurred. |
---|
Determines whether the database has table correlation names support.
true
if table correlation names are supported, otherwise
false
.
SQLException | a database error occurred. |
---|
Determines whether a specified transaction isolation level is supported.
level |
the transaction isolation level, as specified in
java.sql.Connection
:
TRANSACTION_NONE
,
TRANSACTION_READ_COMMITTED
,
TRANSACTION_READ_UNCOMMITTED
,
TRANSACTION_REPEATABLE_READ
,
TRANSACTION_SERIALIZABLE
|
---|
true
if the specific isolation level is supported,
otherwise
false
.
SQLException | a database error occurred. |
---|
Determines whether transactions are supported.
If transactions are not supported, then the
commit
method does
nothing and the transaction isolation level is always
TRANSACTION_NONE
.
true
if transactions are supported, otherwise
false
.
SQLException | a database error occurred. |
---|
Determines whether the
SQL UNION
operation is supported.
true
of the database does support
UNION
, otherwise
false
.
SQLException | a database error occurred. |
---|
Determines whether the
SQL UNION ALL
operation is supported.
true
if the database does support
UNION ALL
,
otherwise
false
.
SQLException | a database error occurred. |
---|
Determines whether the method
ResultSet.rowUpdated
can detect a visible
row update for the specified
ResultSet
type.
type |
ResultSet
type:
ResultSet.TYPE_FORWARD_ONLY
,
ResultSet.TYPE_SCROLL_INSENSITIVE
, or
ResultSet.TYPE_SCROLL_SENSITIVE
|
---|
true
detecting changes is possible, otherwise
false
.
SQLException | a database error occurred. |
---|
Determines whether this database uses a file for each table.
true
if the database uses one file for each table,
otherwise
false
.
SQLException | a database error occurred. |
---|
Determines whether this database uses a local file to store tables.
true
if the database stores tables in a local file,
otherwise
false
.
SQLException | a database error occurred. |
---|