| java.sql.DatabaseMetaData |
An interface which provides comprehensive information about the database.
This interface is implemented by JDBC driver writers in order to provide information about the underlying Database capabilities and the JDBC driver capabilities taken together.
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 one 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 might 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 | importedKeyCascade | For the column UPDATE_RULE, States that when the primary key is updated, the foreign key (imported key) is changed to agree with it. | |||||||||
| int | importedKeyInitiallyDeferred | States deferrability. | |||||||||
| int | importedKeyInitiallyImmediate | States defer-ability. | |||||||||
| 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 defer-ability. | |||||||||
| 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 this 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 whether NULL values are permitted is unknown. |
|||||||||
| 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 | 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 X/Open (who are now know as Open Group) . | |||||||||
| 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 one can base all WHERE search clauses except WHERE . | |||||||||
| int | typePredChar | States that WHERE is the only WHERE search clause that may
be based on this type. |
|||||||||
| int | typePredNone | States that this type does not support WHERE search
clauses. |
|||||||||
| int | typeSearchable | States that all WHERE search clauses may be based on this type. | |||||||||
| 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
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. | |||||||||||
Returns if 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
ResultSet.rowDeleted. | |||||||||||
Returns whether the return value of
getMaxRowSize includes
the SQL data types LONGVARCHAR and
LONGVARBINARY. | |||||||||||
Returns a description of the specified attribute of the specified type
for an SQL User Defined Type (UDT) for a specified schema and catalog.
| |||||||||||
Returns a list of a table's optimal set of columns that uniquely
identifies a row.
| |||||||||||
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 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 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 hold-ability.
| |||||||||||
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 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.
| |||||||||||
Determine if 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.
| |||||||||||
Determine if the database is in read-only mode.
| |||||||||||
Determine if updates are made to a copy of, or directly on, Large Objects
(LOBs).
| |||||||||||
Determine if the database handles concatenations between
NULL and non-NULL values by producing a
NULL output. | |||||||||||
Determine if
NULL values are always sorted to the end of
sorted results regardless of requested sort order. | |||||||||||
Determine if
NULL values are always sorted at the start of
the sorted list, irrespective of the sort order. | |||||||||||
Determine if
NULL values are sorted high - i.e. | |||||||||||
Determine if
NULL values are sorted low - ie they are
sorted as if they are lower than any other values. | |||||||||||
Determine if deletes made by others are visible, for a specified
ResultSet type.
| |||||||||||
Determine if inserts made by others are visible, for a specified
ResultSet type.
| |||||||||||
Determine if updates made by others are visible, for a specified
ResultSet type.
| |||||||||||
Determine if a ResultSet's own deletes are visible, for a specified
ResultSet type.
| |||||||||||
Determine if its own inserts are visible to a given ResultSet type.
| |||||||||||
Determine if for a supplied type of ResultSet, the ResultSet's own
updates are visible.
| |||||||||||
Determine whether the database treats SQL identifiers that are in mixed
case (and unquoted) as case insensitive.
| |||||||||||
Determine whether the database considers mixed case quoted SQL
identifiers as case insensitive and stores them in lower case.
| |||||||||||
Determine whether the database considers mixed case unquoted SQL
identifiers as case insensitive and stores them in mixed case.
| |||||||||||
Determine whether the database considers identifiers as case insensitive
if they are mixed case quoted SQL.
| |||||||||||
Determine whether the database considers mixed case unquoted SQL
identifiers as case insensitive and stores them in upper case.
| |||||||||||
Determine whether the database considers mixed case quoted SQL
identifiers as case insensitive and stores them in upper case.
| |||||||||||
Determine if the database supports the ANSI92 entry level SQL grammar.
| |||||||||||
Determine if the database supports the ANSI92 full SQL grammar.
| |||||||||||
Determine if the database supports the ANSI92 intermediate SQL Grammar.
| |||||||||||
Determine if the database supports ALTER TABLE operation with add column.
| |||||||||||
Determine if the database supports ALTER TABLE operation with drop
column.
| |||||||||||
Determine if the database supports Batch Updates.
| |||||||||||
Determine whether catalog names may be used in data manipulation
statements.
| |||||||||||
Determine if catalog names can be used in Index Definition statements.
| |||||||||||
Determine if catalog names can be used in privilege definition
statements.
| |||||||||||
Determine if catalog names can be used in procedure call statements.
| |||||||||||
Determine if catalog names may be used in table definition statements.
| |||||||||||
Determine if the database supports column aliasing.
| |||||||||||
Determine if the database supports CONVERT operation for two supplied SQL
types.
| |||||||||||
Determine if the database supports the CONVERT operation between SQL
types.
| |||||||||||
Determine if the database supports the Core SQL Grammar for ODBC.
| |||||||||||
Determine if the database supports correlated sub-queries.
| |||||||||||
Determine if the database allows both data definition and data
manipulation statements inside a transaction.
| |||||||||||
Determine if the database only allows data manipulation statements inside
a transaction.
| |||||||||||
Determine if table correlation names are restricted to be different from
the names of the tables, when they are supported.
| |||||||||||
Determine whether expressions in ORDER BY lists are supported.
| |||||||||||
Determine whether the Extended SQL Grammar for ODBC is supported.
| |||||||||||
Determine if the database supports full nested outer joins.
| |||||||||||
Determine if auto generated keys can be returned when a statement
executes.
| |||||||||||
Determine if the database supports a form of GROUP BY clause.
| |||||||||||
Determine if 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.
| |||||||||||
Determine if the database supports using a column name in a GROUP BY
clause that is not in the SELECT statement.
| |||||||||||
Determine whether the database supports SQL Integrity Enhancement
Facility.
| |||||||||||
Determine if the database supports using a LIKE escape clause.
| |||||||||||
Determine if the database provides limited support for outer Join
operations.
| |||||||||||
Determine if the database supports Minimum SQL Grammar for ODBC.
| |||||||||||
Determine if the database treats mixed case unquoted SQL identifiers as
case sensitive storing them in mixed case.
| |||||||||||
Determine whether the database considers mixed case quoted SQL
identifiers as case sensitive, storing them in mixed case.
| |||||||||||
Determine if it is possible for a single CallableStatement to return
multiple ResultSets simultaneously.
| |||||||||||
Determine whether retrieving multiple ResultSets from a single call to
the
execute method is supported. | |||||||||||
Determine whether multiple transactions in progress at at time on
different connections are supported.
| |||||||||||
Determine whether call-able statements with named parameters is
supported.
| |||||||||||
Determine if columns in the database can be defined as non-nullable.
| |||||||||||
Determine whether keeping Cursors open across Commit operations is
supported.
| |||||||||||
Determine if the database can keep Cursors open across Rollback
operations.
| |||||||||||
Determine whether keeping Statements open across Commit operations is
supported.
| |||||||||||
Determine whether keeping Statements open across Rollback operations is
supported.
| |||||||||||
Determine whether using a column in an ORDER BY clause that is not in the
SELECT statement is supported.
| |||||||||||
Determine whether outer join operations are supported.
| |||||||||||
Determine whether positioned DELETE statements are supported.
| |||||||||||
Determine whether positioned UPDATE statements are supported.
| |||||||||||
Determine whether there is support for a given concurrency style for the
given ResultSet.
| |||||||||||
Determine whether the supplied ResultSet holdability is supported.
| |||||||||||
Determine whether the supplied ResultSet type is supported.
| |||||||||||
Determine whether Savepoints for transactions are supported.
| |||||||||||
Determine whether a schema name may be used in a data manipulation
statement.
| |||||||||||
Determine whether a schema name may be used in an index definition
statement.
| |||||||||||
Determine whether a database schema name can be used in a privilege
definition statement.
| |||||||||||
Determine if a procedure call statement may be contain in a schema name.
| |||||||||||
Determine if a schema name can be used in a table definition statement.
| |||||||||||
Determine if this
SELECT FOR UPDATE statements ar
supported. | |||||||||||
Determine whether statement pooling is supported.
| |||||||||||
Determine whether stored procedure calls using the stored procedure
escape syntax is supported.
| |||||||||||
Determine whether subqueries in comparison expressions are supported.
| |||||||||||
Determine whether subqueries in EXISTS expressions are supported.
| |||||||||||
Determine whether subqueries in
IN statements are
supported. | |||||||||||
Determine whether subqueries in quantified expressions are supported.
| |||||||||||
Determine whether the database has table correlation names support.
| |||||||||||
Determine whether a specified transaction isolation level is supported.
| |||||||||||
Determine whether transactions are supported.
| |||||||||||
Determine whether the
SQL UNION operation is supported. | |||||||||||
Determine whether the
SQL UNION ALL operation is
supported. | |||||||||||
Determine if the method
ResultSet.rowUpdated can detect a
visible row update. | |||||||||||
Determine if this database uses a file for each table.
| |||||||||||
Determine whether this database uses a local file to store tables.
| |||||||||||
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 might not allow NULL values.
States that the column definitely allows NULL values.
States that it is unknown whether the columns may be nulled.
For the column UPDATE_RULE, States that when the primary key is updated, the foreign key (imported key) is changed to agree with it.
States deferrability.
States defer-ability.
For the columns UPDATE_RULE and DELETE_RULE, States that if the primary key has been imported, it cannot be updated or deleted.
States defer-ability.
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 this 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 whether NULL values are permitted is unknown.
States that it is unknown whether or not the procedure returns a result.
States that the procedure returns a result.
States that the value is an SQL99 SQLSTATE value.
States that the value is an SQL CLI SQLSTATE value as defined by X/Open (who are now know as Open Group) .
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 one can base all WHERE search clauses except WHERE .
States that WHERE is the only WHERE search clause that may
be based on this type.
States that this type does not support WHERE search
clauses.
States that all WHERE search clauses may be based on this type.
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
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 |
|---|
Returns if 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
ResultSet.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 description of the specified attribute of the specified type
for an SQL User Defined Type (UDT) for a specified schema and catalog.
The descriptions returned are ordered by TYPE_SCHEM,
TYPE_NAME and ORDINAL_POSITION. The descriptions do not
contain inherited attributes.
The returned ResultSet object has rows with the following column 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 nameATTR_NAME - String - the Attribute nameDATA_TYPE - int - the Attribute type as defined in
java.sql.TypesATTR_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
supportedNUM_PREC_RADIX - int - numeric values radixNULLABLE - int - whether NULL is
permitted:
NULLsNULLs
definitely permittedREMARKS - String - A comment describing the attribute
(possibly null)null)SQL_DATA_TYPE - int - not usedCHAR types, the max
number of bytes in the columnNULLs, "YES" = column allows NULLs "" =
NULL status unknownSCOPE_CATALOG - String - Catalog for table,
SCOPE of Reference attribute. NULL if
DATA_TYPE is not REF.SCOPE_SCHEMA - String - Schema for table,
SCOPE of Reference attribute. NULL if
DATA_TYPE is not REF.SCOPE_TABLE - String - Table name for
SCOPE of Reference attribute. NULL if
DATA_TYPE is not REF.SOURCE_DATA_TYPE - String - The source type for user
generated REF type or for a Distinct type. (NULL if
DATA_TYPE is not DISTINCT or user generated REF)| 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. |
|---|---|
| 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. This pattern must match the type name stored in the database. |
| attributeNamePattern | an Attribute name. Must match the attribute name as stored in the database. |
| SQLException | if there is a database error |
|---|
Returns a list of a table's optimal set of columns that uniquely
identifies a row. 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:
COLUMN_NAME - String - the column name DATA_TYPE - int - the Type of the data, as defined in
java.sql.Types TYPE_NAME - String - 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 eg. and Oracle ROWID:
| 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 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 |
| 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.
TABLE_CAT.| SQLException | if there is a database error |
|---|
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 - Catalog name (possibly
null)TABLE_SCHEM - String - Schema name (possibly
null) TABLE_NAME - String - The Table name COLUMN_NAME - String - The Column nameGRANTOR - 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 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 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. |
| 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 - Catalog name (possibly
null)TABLE_SCHEM - String - Schema name (possibly
null) TABLE_NAME - String - The Table name COLUMN_NAME - String - The Column nameDATA_TYPE - int - The SQL type as specified in
java.sql.TypesTYPE_NAME - String - Name for the data type, depends
on database, UDT names are fully qualifiedCOLUMN_SIZE - int - Column size - the precision for
numeric types, max characters for char and date typesBUFFER_LENGTH - int - Not used DECIMAL_DIGITS - int - maximum number of fractional
digits NUM_PREC_RADIX - int - the Radix NULLABLE - int - does the column allow
nulls:
NULLsNULLsNULL
statusREMARKS - 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 - Column index in the table (1
based) IS_NULLABLE - String - "NO" = column does not allow
NULLs, "YES" = column allows NULLs "" = NULL status
unknownSCOPE_CATALOG - String - Catalog for table,
SCOPE of Reference attribute. NULL if
DATA_TYPE is not REF.SCOPE_SCHEMA - String - Schema for table, scope of
Reference attribute. NULL if DATA_TYPE is
not REF.SCOPE_TABLE - String - Table name for scope of
Reference attribute. NULL if DATA_TYPE is
not REF.SOURCE_DATA_TYPE - String - The source type for user
generated REF type or for a Distinct type. (NULL if
DATA_TYPE is not DISTINCT or user generated REF)| 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. |
|---|---|
| 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. |
| 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. |
| 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 - primary key table : name
PKCOLUMN_NAME - String - primary key column : nameFKTABLE_CAT - String - from the foreign key table :
the catalog name being exported (possibly null)FKTABLE_SCHEM - String - foreign key table : Schema
name being exported (possibly null) FKTABLE_NAME - String - foreign key table : the name
being exportedFKCOLUMN_NAME - String - foreign key column : the
name being exportedKEY_SEQ - short - sequence number (in the foreign
key)UPDATE_RULE - short - how to treat foreign key when
primary key is updated:
nullDELETE_RULE - short - how to treat foreign key when
primary key is deleted:
nullnull)null)| primaryCatalog | 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. |
|---|---|
| primarySchema | a Schema Name. 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. |
| 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. 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. |
| foreignSchema | a Schema Name. 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. |
| foreignTable | the name of the table importing the key. It must match the name of the table in the database |
| 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.
| SQLException | a database error occurred |
|---|
Returns the version number of this 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 or
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.
| SQLException | a database error occurred |
|---|
Returns the version number of this 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 - primary key table : Catalog
(possibly null)PKTABLE_SCHEM - String - primary key table : Schema
(possibly null) PKTABLE_NAME - String - primary key table : name
PKCOLUMN_NAME - String - primary key column : nameFKTABLE_CAT - String - foreign key table : Catalog
name being exported (possibly null)FKTABLE_SCHEM - String - foreign key table : Schema
name being exported (possibly null) FKTABLE_NAME - String - foreign key table : name
being exportedFKCOLUMN_NAME - String - foreign key column : name
being exportednullnullnull)null)| 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. 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. |
| table | a table name, which must match the name of a table in the database |
| 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 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 importedFKTABLE_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 nameFKCOLUMN_NAME - String - foreign key column namenullnullnull)null)| 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. 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. |
| table | a table name, which must match the name of a table in the database |
| 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 TYPE is
tableIndexStatisticINDEX_QUALIFIER - String : index catalog name.
null when TYPE is 'tableIndexStatistic'INDEX_NAME - String : index name. null
when TYPE is 'tableIndexStatistic'COLUMN_NAME - String - the column name.
null when TYPE is tableIndexStatisticnull if
sequencing not supported or TYPE is tableIndexStatistic; otherwise "A"
means sort ascending and "D" means sort descending. | 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. 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. |
| 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 |
| 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.
| 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.
| SQLException | a database error occurred |
|---|
Returns the maximum number of columns in a SELECT list for this database.
| 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.
| 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 keyPK_NAME - String - the primary key name (possibly
null)| 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 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 using 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 |
| 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:
COLUMN_NAME - String - the name of the columnDATA_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 qualifiedNULLs not
permittedNULLs are
permitted 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 using 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. |
| 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. |
| 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_SCHEME and PROCEDURE_NAME, with the data in each row as follows:
PROCEDURE_CAT - String : the procedure catalog namePROCEDURE_SCHEM - String : the procedure schema name
(possibly null) PROCEDURE_NAME - String : the procedure nameReservedReservedReservedREMARKS - String - information about the procedurePROCEDURE_TYPE - short : one of:
| 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. |
|---|---|
| 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. |
| procedureNamePattern | a procedure name pattern, which must match the procedure name stored in the database |
| SQLException | a database error occurred |
|---|
Returns the result set's default hold-ability.
ResultSet.HOLD_CURSORS_OVER_COMMIT or
ResultSet.CLOSE_CURSORS_AT_COMMIT| SQLException | a database error occurred |
|---|
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.
| SQLException | a database error occurred |
|---|
Returns the database vendor's preferred term for "schema".
| SQLException | a database error occurred |
|---|
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 nameTABLE_CATALOG - String - the Catalog name (possibly
null) | 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 strings which are a pattern and so which use the wildcard characters. '_' is used to represent any single character wile '%' 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 and sub tables 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 using 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. |
| 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. |
| 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. |
| 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 | 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. |
|---|---|
| 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. |
| tableNamePattern | a Table Name, which should match the Table name as stored in the database. |
| 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" | 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 using 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. |
| 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. |
| 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_NAMR - String : the Type nameDATA_TYPE - int : the SQL data type value as defined
in java.sql.TypesPRECISION - int - the maximum precision of the typeLITERAL_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 null-able:
NULLs not permittedNULLs are permitted
NULL status
unknown TYPE_NAME - String - a localized version of
the type name (possibly null)DATA_TYPE - int - not used | 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 nameDATA_TYPE - int - The SQL type as specified in
java.sql.Types. One of DISTINCT, STRUCT and JAVA_OBJECTREMARKS - 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.| 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. |
|---|---|
| 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, 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. |
| 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 nameDATA_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):
| 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 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. It must match the name of a table in the database. |
| SQLException | a database error occurred |
|---|
Determine if 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 |
|---|
Determine if the database is in read-only mode.
true if the database is in read-only mode,
false otherwise.| SQLException | a database error occurred |
|---|
Determine if updates are made to a copy of, or directly on, Large Objects (LOBs).
true if updates are made to a copy of the Large
Object, false otherwise| SQLException | a database error occurred |
|---|
Determine if 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 |
|---|
Determine if 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 |
|---|
Determine if 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 |
|---|
Determine if 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 |
|---|
Determine if NULL values are sorted low - ie 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 |
|---|
Determine if 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 |
|---|
Determine if 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 |
|---|
Determine if 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 |
|---|
Determine if a ResultSet's own deletes are visible, 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 delete's are seen by the own ResultSet
otherwise false.| SQLException | a database error occurred |
|---|
Determine if its own inserts are visible to a given ResultSet type.
| type | the type of the ResultSet:
ResultSet.TYPE_FORWARD_ONLY,
ResultSet.TYPE_SCROLL_INSENSITIVE, or
ResultSet.TYPE_SCROLL_SENSITIVE |
|---|
true if inserts are visible for this type
false otherwise.| SQLException | a database error occurred |
|---|
Determine if for a supplied type of ResultSet, the ResultSet's own updates are visible.
| type | the type of the ResultSet:
ResultSet.TYPE_FORWARD_ONLY,
ResultSet.TYPE_SCROLL_INSENSITIVE, or
ResultSet.TYPE_SCROLL_SENSITIVE |
|---|
true if updates are visible to in this ResultSet
type otherwise false.| SQLException | a database error occurred |
|---|
Determine 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 |
|---|
Determine 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 |
|---|
Determine 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 |
|---|
Determine 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 |
|---|
Determine 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 |
|---|
Determine 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 |
|---|
Determine if 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 |
|---|
Determine if the database supports the ANSI92 full SQL grammar.
true if the ANSI92 full SQL grammar is supported,
false otherwise.| SQLException | a database error occurred |
|---|
Determine if the database supports the ANSI92 intermediate SQL Grammar.
true if the ANSI92 intermediate SQL grammar is
supported, false otherwise.| SQLException | a database error occurred |
|---|
Determine if 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 |
|---|
Determine if 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 |
|---|
Determine if the database supports Batch Updates.
true if batch updates are supported,
false otherwise.| SQLException | a database error occurred |
|---|
Determine 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 |
|---|
Determine if 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 |
|---|
Determine if 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 |
|---|
Determine if 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 |
|---|
Determine if 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 |
|---|
Determine if 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 |
|---|
Determine if 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 |
|---|
Determine if the database supports the CONVERT operation between SQL types.
true if the CONVERT operation is supported,
false otherwise.| SQLException | a database error occurred |
|---|
Determine if the database supports the Core SQL Grammar for ODBC.
true if the Core SQL Grammar is supported,
false otherwise.| SQLException | a database error occurred |
|---|
Determine if the database supports correlated sub-queries.
true if the database does support correlated
sub-queries and false otherwise.| SQLException | a database error occurred |
|---|
Determine if 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 |
|---|
Determine if the database only allows data manipulation statements inside a transaction.
true if only data manipulation statements are
permitted, false otherwise.| SQLException | a database error occurred |
|---|
Determine if table correlation names are restricted to be different from the names of the tables, when they are supported.
true if correlation names must be different to
table names, false otherwise.| SQLException | a database error occurred |
|---|
Determine whether expressions in ORDER BY lists are supported.
true if expressions in ORDER BY lists are
supported.| SQLException | a database error occurred |
|---|
Determine whether the Extended SQL Grammar for ODBC is supported.
true if the Extended SQL Grammar is supported,
false otherwise.| SQLException | a database error occurred |
|---|
Determine if the database supports full nested outer joins.
true if full nested outer joins are supported,
false otherwise.| SQLException | a database error occurred |
|---|
Determine if 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 |
|---|
Determine if the database supports a form of GROUP BY clause.
true if a form of GROUP BY clause is supported,
false otherwise.| SQLException | a database error occurred |
|---|
Determine if 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 |
|---|
Determine if 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 |
|---|
Determine whether the database supports SQL Integrity Enhancement Facility.
true if the Integrity Enhancement Facility is
supported, false otherwise.| SQLException | a database error occurred |
|---|
Determine if the database supports using a LIKE escape clause.
true if LIKE escape clause is supported,
false otherwise| SQLException | a database error occurred |
|---|
Determine if 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 |
|---|
Determine if the database supports Minimum SQL Grammar for ODBC.
true if the Minimum SQL Grammar is supported,
false otherwise.| SQLException | a database error occurred |
|---|
Determine if 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 |
|---|
Determine 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 |
|---|
Determine if it is possible for a single CallableStatement to return multiple ResultSets simultaneously.
true if a single CallableStatement can return
multiple ResultSets simultaneously, false
otherwise.| SQLException | a database error occurred |
|---|
Determine whether retrieving multiple ResultSets from a single call to
the execute method is supported.
true if multiple ResultSets can be retrieved,
false otherwise.| SQLException | a database error occurred |
|---|
Determine whether multiple transactions in progress at at time on different connections are supported.
true if multiple open transactions are supported,
false otherwise.| SQLException | a database error occurred |
|---|
Determine whether call-able statements with named parameters is supported.
true if named parameters can be used with
call-able statements, false otherwise.| SQLException | a database error occurred |
|---|
Determine if 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 |
|---|
Determine 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 |
|---|
Determine if 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 |
|---|
Determine 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 |
|---|
Determine 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 |
|---|
Determine 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 |
|---|
Determine whether outer join operations are supported.
true if outer join operations are supported,
false otherwise.| SQLException | a database error occurred |
|---|
Determine whether positioned DELETE statements are supported.
true if the database supports positioned DELETE
statements.| SQLException | a database error occurred |
|---|
Determine whether positioned UPDATE statements are supported.
true if the database supports positioned UPDATE
statements, false otherwise.| SQLException | a database error occurred |
|---|
Determine whether there is support for a given concurrency style for the given ResultSet.
| type | the ResultSet type, as defined in
java.sql.ResultSet:
ResultSet.TYPE_FORWARD_ONLY,
ResultSet.TYPE_SCROLL_INSENSITIVE, or
ResultSet.TYPE_SCROLL_SENSITIVE |
|---|---|
| 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 |
|---|
Determine whether the supplied ResultSet holdability 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 |
|---|
Determine 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 |
|---|
Determine whether Savepoints for transactions are supported.
true if Savepoints are supported,
false otherwise.| SQLException | a database error occurred |
|---|
Determine 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 |
|---|
Determine 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 |
|---|
Determine 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 |
|---|
Determine if 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 |
|---|
Determine if 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 |
|---|
Determine if this SELECT FOR UPDATE statements ar
supported.
true if SELECT FOR UPDATE
statements are supported otherwise false.| SQLException | a database error occurred |
|---|
Determine whether statement pooling is supported.
true of the database does support statement
pooling otherwise false.| SQLException | a database error occurred |
|---|
Determine 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 |
|---|
Determine whether subqueries in comparison expressions are supported.
true if subqueries are supported in comparison
expressions.| SQLException | a database error occurred |
|---|
Determine whether subqueries in EXISTS expressions are supported.
true if subqueries are supported in EXISTS
expressions otherwise false.| SQLException | a database error occurred |
|---|
Determine whether subqueries in IN statements are
supported.
true if subqueries are supported in IN statements
otherwise false.| SQLException | a database error occurred |
|---|
Determine whether subqueries in quantified expressions are supported.
true if subqueries are supported otherwise
false.| SQLException | a database error occurred |
|---|
Determine whether the database has table correlation names support.
true if table correlation names are supported
otherwise false.| SQLException | a database error occurred |
|---|
Determine 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 |
|---|
Determine 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 |
|---|
Determine whether the SQL UNION operation is supported.
true of the database does support
UNION otherwise false.| SQLException | a database error occurred |
|---|
Determine whether the SQL UNION ALL operation is
supported.
true if the database does support UNION ALL
otherwise false.| SQLException | a database error occurred |
|---|
Determine if the method ResultSet.rowUpdated can detect a
visible row update.
| 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 |
|---|
Determine if 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 |
|---|
Determine whether this database uses a local file to store tables.
true of the database does store tables in a local
file otherwise false.| SQLException | a database error occurred |
|---|