Overview  Package   Class  Use  Tree  Deprecated  Index  Help 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD

com.metamatrix.jdbc
Class MMDatabaseMetaData

java.lang.Object
  extended by com.metamatrix.jdbc.WrapperImpl
      extended by com.metamatrix.jdbc.MMDatabaseMetaData
All Implemented Interfaces:
java.sql.DatabaseMetaData, java.sql.Wrapper
public class MMDatabaseMetaData
extends WrapperImpl
implements DatabaseMetaData

This provides metadata information about the different datasources to which metamatrix connects. Many of the methods in this class return ResultSets, Strings and boolean values. This class makes queries against RuntimeMetadata to support methods returning ResultSets. The methods on this class which return ResultSets need to return JDBC specific columns, whose information is not available in the results obtained on querying, this JDBC specific information is in this class before returning ResultSets. All the information returned by methods returning String,booleans and int.

Field Summary
 
Fields inherited from interface java.sql.DatabaseMetaData
attributeNoNulls, attributeNullable, attributeNullableUnknown, bestRowNotPseudo, bestRowPseudo, bestRowSession, bestRowTemporary, bestRowTransaction, bestRowUnknown, columnNoNulls, columnNullable, columnNullableUnknown, functionColumnIn, functionColumnInOut, functionColumnOut, functionColumnResult, functionColumnUnknown, functionNoNulls, functionNoTable, functionNullable, functionNullableUnknown, functionResultUnknown, functionReturn, functionReturnsTable, importedKeyCascade, importedKeyInitiallyDeferred, importedKeyInitiallyImmediate, importedKeyNoAction, importedKeyNotDeferrable, importedKeyRestrict, importedKeySetDefault, importedKeySetNull, procedureColumnIn, procedureColumnInOut, procedureColumnOut, procedureColumnResult, procedureColumnReturn, procedureColumnUnknown, procedureNoNulls, procedureNoResult, procedureNullable, procedureNullableUnknown, procedureResultUnknown, procedureReturnsResult, sqlStateSQL, sqlStateSQL99, sqlStateXOpen, tableIndexClustered, tableIndexHashed, tableIndexOther, tableIndexStatistic, typeNoNulls, typeNullable, typeNullableUnknown, typePredBasic, typePredChar, typePredNone, typeSearchable, versionColumnNotPseudo, versionColumnPseudo, versionColumnUnknown
 
Method Summary
 boolean allProceduresAreCallable()
          Checks whether the current user has the required security rights to call all the procedures returned by the method getProcedures.
 boolean allTablesAreSelectable()
          Checks whether the current user can use SELECT statement with all of the tables returned by the method getTables.
 boolean autoCommitFailureClosesAllResultSets()
           
 boolean dataDefinitionCausesTransactionCommit()
          Checks whether a DDL statement within a transaction forces the transaction to commit.
 boolean dataDefinitionIgnoredInTransactions()
          Checks whether a DDL statement within a transaction is ignored.
 boolean deletesAreDetected(int type)
          Indicates whether or not a visible row delete can be detected by calling ResultSet.rowDeleted().
 boolean doesMaxRowSizeIncludeBlobs()
          Did getMaxRowSize() include LONGVARCHAR and LONGVARBINARY blobs?
 java.sql.ResultSet getAttributes(java.lang.String catalog, java.lang.String schemaPattern, java.lang.String typeNamePattern, java.lang.String attributeNamePattern)
           
 java.sql.ResultSet getBestRowIdentifier(java.lang.String catalog, java.lang.String schema, java.lang.String table, int scope, boolean nullable)
          Gets a description of a table's optimal set of columns that uniquely identifies a row.
 java.sql.ResultSet getCatalogs()
          Gets the catalog names available to metamatrix.
 java.lang.String getCatalogSeparator()
          Gets the String object used to separate a catalog name and a table name
 java.lang.String getCatalogTerm()
          Get the metamatrix term for catalog
 java.sql.ResultSet getClientInfoProperties()
           
 java.sql.ResultSet getColumnPrivileges(java.lang.String catalog, java.lang.String schema, java.lang.String table, java.lang.String columnName)
          Gets a description of the access rights for a column of the given name.
 java.sql.ResultSet getColumns(java.lang.String catalog, java.lang.String schema, java.lang.String tableNamePattern, java.lang.String columnNamePattern)
          Get's the metadata information about the columns whose names match the given columnNamePattern.
 java.sql.Connection getConnection()
           
 java.sql.ResultSet getCrossReference(java.lang.String primaryCatalog, java.lang.String primarySchema, java.lang.String primaryTable, java.lang.String foreignCatalog, java.lang.String foreignSchema, java.lang.String foreignTable)
          Gets the description of the foreign key columns in the table foreignTable.
 int getDatabaseMajorVersion()
          Retrieves the major version number of the underlying database.
 int getDatabaseMinorVersion()
          Retrieves the minor version number of the underlying database.
 java.lang.String getDatabaseProductName()
          Gets the product name for this database
 java.lang.String getDatabaseProductVersion()
          Gets the version of metamatrix server to which this driver connects
 int getDefaultTransactionIsolation()
          Gets metamatrix default transaction isolation level.
 int getDriverMajorVersion()
          Gets this drivers major version number
 int getDriverMinorVersion()
          Gets this drivers minor version number
 java.lang.String getDriverName()
          Get the name of this JDBC driver
 java.lang.String getDriverVersion()
          This method gets the version of this JDBC driver.
 java.sql.ResultSet getExportedKeys(java.lang.String catalog, java.lang.String schema, java.lang.String table)
          This method gets a description of the forignkey columns that reference the primary key columns in the given table.
 java.lang.String getExtraNameCharacters()
          Gets the extra characters that can be used in unquoted identifier names (those beyond a-z, 0-9, and _)
 java.sql.ResultSet getFunctionColumns(java.lang.String catalog, java.lang.String schemaPattern, java.lang.String functionNamePattern, java.lang.String columnNamePattern)
           
 java.sql.ResultSet getFunctions(java.lang.String catalog, java.lang.String schemaPattern, java.lang.String functionNamePattern)
           
 java.lang.String getIdentifierQuoteString()
          Get's the string used to quote SQL identifiers.
 java.sql.ResultSet getImportedKeys(java.lang.String catalog, java.lang.String schema, java.lang.String table)
          Gets a description of the primary key columns that are referenced by the foreign key columns in the given table.
 java.sql.ResultSet getIndexInfo(java.lang.String catalog, java.lang.String schema, java.lang.String table, boolean unique, boolean approximate)
          Gets a description of the indexes that are present on a given table.
 int getJDBCMajorVersion()
          Retrieves the major JDBC version number for this driver.
 int getJDBCMinorVersion()
          Retrieves the minor JDBC version number for this driver.
 int getMaxBinaryLiteralLength()
          Gets the maximum number of hexadecimal characters allowed in an inline binary literal
 int getMaxCatalogNameLength()
          Gets the maximum number of characters allowed in a catalog name
 int getMaxCharLiteralLength()
          Gets the maximum number of characters allowed in a character literal
 int getMaxColumnNameLength()
          Gets the maximum number of characters allowed in a column name
 int getMaxColumnsInGroupBy()
          Gets the maximum number of columns allowed in a GROUP BY clause
 int getMaxColumnsInIndex()
          Gets the maximum number of columns allowed in an index
 int getMaxColumnsInOrderBy()
          Gets the maximum number of columns allowed in a ORDER BY clause
 int getMaxColumnsInSelect()
          Gets the maximum number of columns allowed in a SELECT clause
 int getMaxColumnsInTable()
          Gets the maximum number of columns allowed in a table
 int getMaxConnections()
          Gets the maximum number of active connections to metamatrix that can be maintained through this driver instance
 int getMaxCursorNameLength()
          Gets the maximum number of characters allowed in a cursor name
 int getMaxIndexLength()
          Gets the maximum number of bytes allowed in an index
 int getMaxProcedureNameLength()
          Gets the maximum number of characters allowed in a procedure name
 int getMaxRowSize()
          Gets the maximum number of bytes allowed in a single row
 int getMaxSchemaNameLength()
          Gets the maximum number of characters allowed in a schema name
 int getMaxStatementLength()
          Gets the maximum number of characters allowed in an SQL statement
 int getMaxStatements()
          Gets the maximum number of active statements that may be open on one connection at any time
 int getMaxTableNameLength()
          Gets the maximum number of characters allowed in a table name
 int getMaxTablesInSelect()
          Gets the maximum number of tables allowed in a SELECT clause
 int getMaxUserNameLength()
          Gets the maximum number of characters allowed in a user name
 java.sql.ResultSet getModels(java.lang.String catalog, java.lang.String schemaPattern, java.lang.String modelNamePattern)
          Gets a description of models available in a catalog.
 java.lang.String getNumericFunctions()
          Gets the OPEN GROUP CLI names of metamatrix math functions
 java.sql.ResultSet getPrimaryKeys(java.lang.String catalog, java.lang.String schema, java.lang.String table)
          Get's a description of the primary key columns in a table.
 java.sql.ResultSet getProcedureColumns(java.lang.String catalog, java.lang.String schemaPattern, java.lang.String procedureNamePattern, java.lang.String columnNamePattern)
          Gets a description of the input, output and results associated with certain stored procedures matching the given procedureNamePattern.
 java.sql.ResultSet getProcedures(java.lang.String catalog, java.lang.String schemaPattern, java.lang.String procedureNamePattern)
          Gets description of all the available stored procedures whose names match the given pattern.
 java.lang.String getProcedureTerm()
          Gets MetaMatrix's preferred term for procedures
 int getResultSetHoldability()
           
 java.sql.RowIdLifetime getRowIdLifetime()
           
 java.sql.ResultSet getSchemas()
          Gets the schema names available for this connection.
 java.sql.ResultSet getSchemas(java.lang.String catalog, java.lang.String schemaPattern)
           
 java.lang.String getSchemaTerm()
          Gets MetaMatrix's preferred term for schema
 java.lang.String getSearchStringEscape()
          Gets the string that can be used to escape "_" or "%" wildcards in the string search pattern used for search parameters
 java.lang.String getSQLKeywords()
          Get metamatrix keywords that are not SQL-92 keyword
 int getSQLStateType()
          Indicates whether the SQLSTATE returned by SQLException.getSQLState is X/Open (now known as Open Group) SQL CLI or SQL99.
 java.lang.String getStringFunctions()
          Gets the Open Group CLI names for metamatrix string functions
 java.sql.ResultSet getSuperTables(java.lang.String catalog, java.lang.String schemaPattern, java.lang.String tableNamePattern)
          Retrieves a description of the table hierarchies defined in a particular schema in this database.
 java.sql.ResultSet getSuperTypes(java.lang.String catalog, java.lang.String schemaPattern, java.lang.String tableNamePattern)
          Retrieves a description of the user-defined type (UDT) hierarchies defined in a particular schema in this database.
 java.lang.String getSystemFunctions()
          Gets the Open Group CLI names for metamatrix system functions
 java.sql.ResultSet getTablePrivileges(java.lang.String catalog, java.lang.String schemaPattern, java.lang.String tableName)
          Gets a description of access rights for the table of the given name.
 java.sql.ResultSet getTables(java.lang.String catalog, java.lang.String schemaPattern, java.lang.String tableNamePattern, java.lang.String[] types)
          Gets a description of tables whose table name matches tableNamePattern.
 java.sql.ResultSet getTableTypes()
          Gets the table types available to metamatrix.
 java.lang.String getTimeDateFunctions()
          Gets the Open Group CLI names for metamatrix time and date functions
 java.sql.ResultSet getTypeInfo()
          Gets the description of all datatypes supported by metamatrix.
 java.sql.ResultSet getUDTs(java.lang.String catalog, java.lang.String schemaPattern, java.lang.String typeNamePattern, int[] types)
          Gets a description of the user-defined types defined in a particular schema.
 java.lang.String getURL()
          Gets the URL used to connect to metamatrix
 java.lang.String getUserName()
          Gets the user name as known to metamatrix
 java.sql.ResultSet getVersionColumns(java.lang.String catalog, java.lang.String schema, java.lang.String table)
          Gets the description of the columns in a table that are automatically updated when any value in a row is updated.
 java.util.List getXMLSchemas(java.lang.String documentName)
           This is a different method from #getSchemas().
 boolean insertsAreDetected(int type)
          Indicates whether or not a visible row insert can be detected by calling ResultSet.rowInserted().
 boolean isCatalogAtStart()
          Checks whether a catalog name appears at the start of a fully qualified table name.
 boolean isReadOnly()
          Checks whether the databases used by metamatrix are in read-only mode
 boolean locatorsUpdateCopy()
          Indicates whether updates made to a LOB are made on a copy or directly to the LOB.
 boolean nullPlusNonNullIsNull()
          Checks whether the concatenation of a NULL vaule and a non-NULL value results in a NULL value.
 boolean nullsAreSortedAtEnd()
          Checks whether NULL vaules are sorted at the end regardless of sort order.
 boolean nullsAreSortedAtStart()
          Checks whether NULL vaules are sorted at the start regardless of sort order.
 boolean nullsAreSortedHigh()
          Checks whether NULL vaules are sorted high.
 boolean nullsAreSortedLow()
          Checks whether NULL vaules are sorted low.
 boolean othersDeletesAreVisible(int type)
          Indicates whether deletes made by others are visible.
 boolean othersInsertsAreVisible(int type)
          Indicates whether inserts made by others are visible.
 boolean othersUpdatesAreVisible(int type)
          Indicates whether updates made by others are visible.
 boolean ownDeletesAreVisible(int type)
          Indicates whether a result set's own deletes are visible.
 boolean ownInsertsAreVisible(int type)
          Indicates whether a result set's own inserts are visible.
 boolean ownUpdatesAreVisible(int type)
          Indicates whether a result set's own updates are visible.
 boolean storesLowerCaseIdentifiers()
          This method checks whether metamatrix treats mixed-case unquoted SQL identifiers used in SQL statements as case-insensitive and stores them as all lowercase in its metadata tables.
 boolean storesLowerCaseQuotedIdentifiers()
          This method checks whether metamatrix treats mixed-case quoted SQL identifiers used in SQL statements as case-insensitive and stores them as all lowercase in its metadata tables.
 boolean storesMixedCaseIdentifiers()
          This method checks whether metamatrix treats mixed-case unquoted SQL identifiers used in SQL statements as case-insensitive and stores them as all mixedcase in its metadata tables.
 boolean storesMixedCaseQuotedIdentifiers()
          This method checks whether metamatrix treats mixed-case quoted SQL identifiers used in SQL statements as case-insensitive and stores them in mixedcase in its metadata tables.
 boolean storesUpperCaseIdentifiers()
          This method checks whether metamatrix treats mixed-case unquoted SQL identifiers used in SQL statements as case-insensitive and stores them as all uppercase in its metadata tables.
 boolean storesUpperCaseQuotedIdentifiers()
          This method checks whether metamatrix treats mixed-case quoted SQL identifiers used in SQL statements as case-insensitive and stores them as all uppercase in its metadata tables.
 boolean supportsAlterTableWithAddColumn()
          Checks whether metamatrix supports ALTER TABLE with add column.
 boolean supportsAlterTableWithDropColumn()
          Checks whether metamatrix supports ALTER TABLE with drop column.
 boolean supportsANSI92EntryLevelSQL()
          Checks whether metamatrix supports ANSI-92 entry level SQL grammer.
 boolean supportsANSI92FullSQL()
          Checks whether metamatrix supports ANSI-92 full SQL grammer.
 boolean supportsANSI92IntermediateSQL()
          Checks whether metamatrix supports ANSI-92 intermediate SQL grammer.
 boolean supportsBatchUpdates()
          Indicates whether the driver supports batch updates.
 boolean supportsCatalogsInDataManipulation()
          Checks whether metamatrix supports using a catalog name in a data manipulation statement.
 boolean supportsCatalogsInIndexDefinitions()
          Checks whether metamatrix supports using a catalog name in an index definition statement.
 boolean supportsCatalogsInPrivilegeDefinitions()
          Checks whether metamatrix supports using a catalog name in a privilage definition statement.
 boolean supportsCatalogsInProcedureCalls()
          Checks whether metamatrix supports using a catalog name in a procedure call statement.
 boolean supportsCatalogsInTableDefinitions()
          Checks whether metamatrix supports using a catalog name in a table definition statement.
 boolean supportsColumnAliasing()
          Checks whether metamatrix supports column aliasing.
 boolean supportsConvert()
          Checks whether metamatrix supports scalar function CONVERT for the conversion of one JDBC type to another.
 boolean supportsConvert(int fromType, int toType)
          Checks whether metamatrix supports scalar function CONVERT for the conversion of fromType to toType.
 boolean supportsCoreSQLGrammar()
          Checks whether metamatrix supports ODBC Core SQL grammer.
 boolean supportsCorrelatedSubqueries()
          Checks whether metamatrix supports correlated subqueries.
 boolean supportsDataDefinitionAndDataManipulationTransactions()
          Checks whether metamatric supports both data definition and data manipulation statements within a transaction.
 boolean supportsDataManipulationTransactionsOnly()
          Are only data manipulation statements within a transaction supported?
 boolean supportsDifferentTableCorrelationNames()
          Checks whether metamatric supports only data manipulation statements within a transaction.
 boolean supportsExpressionsInOrderBy()
          Checks whether metamatrix supports expressions in ORDER BY lists.
 boolean supportsExtendedSQLGrammar()
          Checks whether metamatrix supports ODBC Extended SQL grammer.
 boolean supportsFullOuterJoins()
          Checks whether metamatrix supports full outer joins
 boolean supportsGetGeneratedKeys()
          Retrieves whether auto-generated keys can be retrieved after a statement has been executed.
 boolean supportsGroupBy()
          Checks whether metamatrix supports GROUP BY
 boolean supportsGroupByBeyondSelect()
          Checks whether a GROUP BY clause can use columns that are not in the SELECT clause, provided that it specifies all the columns in the SELECT clause.
 boolean supportsGroupByUnrelated()
          Checks whether a GROUP BY clause can use columns that are not in the SELECT clause.
 boolean supportsIntegrityEnhancementFacility()
          Checks whether metamatrix supports the SQL Integrity Enhancement Facility.
 boolean supportsLikeEscapeClause()
          Checks whether metamatrix supports specifying a LIKE escape clause.
 boolean supportsLimitedOuterJoins()
          Checks whether metamatrix provides limited support for outer joins.
 boolean supportsMinimumSQLGrammar()
          Checks whether metamatrix supports the ODBC minimum SQL grammer.
 boolean supportsMixedCaseIdentifiers()
          Checks whether mixed-case unquoted SQL identifiers used in SQL statements are case sensitive
 boolean supportsMixedCaseQuotedIdentifiers()
          Checks whether mixed-case quoted SQL identifiers used in SQL statements are case sensitive
 boolean supportsMultipleOpenResults()
          Retrieves whether it is possible to have multiple ResultSet objects returned from a CallableStatement object simultaneously.
 boolean supportsMultipleResultSets()
          Are multiple ResultSets from a single execute supported?
 boolean supportsMultipleTransactions()
          Checks whether multiple transactions open at once on different connectons
 boolean supportsNamedParameters()
          Retrieves whether metamatrix supports named parameters to callable statements.
 boolean supportsNonNullableColumns()
          Checks whether metamatrix supports defining columns as nonnullable.
 boolean supportsOpenCursorsAcrossCommit()
          Checks whether metamatrix supports having cursors open across commits.
 boolean supportsOpenCursorsAcrossRollback()
          Checks whether metamatrix supports having cursors open across rollbacks.
 boolean supportsOpenStatementsAcrossCommit()
          Checks whether metamatrix supports having cursors open across commits.
 boolean supportsOpenStatementsAcrossRollback()
          Checks whether metamatrix supports having cursors open across rollbacks.
 boolean supportsOrderByUnrelated()
          Checks whether an ORDER BY clause can use columns that are not in the SELECT clause.
 boolean supportsOuterJoins()
          Checks whether metamatrix supports some form of outer joins.
 boolean supportsPositionedDelete()
          Checks whether metamatrix supports positioned DELETEs on resultsets
 boolean supportsPositionedUpdate()
          Checks whether metamatrix supports positioned UPDATEs on result sets.
 boolean supportsResultSetConcurrency(int type, int concurrency)
          Does the database support the concurrency type in combination with the given result set type?
 boolean supportsResultSetHoldability(int holdability)
          Retrieves whether database supports the given result set holdability.
 boolean supportsResultSetType(int type)
          Does the database support the given result set type?
 boolean supportsSavepoints()
          Retrieves whether metamatrix supports savepoints.
 boolean supportsSchemasInDataManipulation()
          Checks whether metamatrix supports using a schema name in a data manipulation statement
 boolean supportsSchemasInIndexDefinitions()
          Checks whether metamatrix supports using a schema name in an index definition statement
 boolean supportsSchemasInPrivilegeDefinitions()
          Checks whether metamatrix supports using a schema name in a privilage definition statement
 boolean supportsSchemasInProcedureCalls()
          Checks whether metamatrix supports using a schema name in an procedure call statement
 boolean supportsSchemasInTableDefinitions()
          Checks whether metamatrix supports using a schema name in an table definition statement
 boolean supportsSelectForUpdate()
          Checks whether metamatrix supports SELECT FOR UPDATE statements
 boolean supportsStatementPooling()
          Retrieves whether this metamatrix supports statement pooling.
 boolean supportsStoredFunctionsUsingCallSyntax()
           
 boolean supportsStoredProcedures()
          Checks whether metamatrix supports stored procedure calls using the stored procedure escape syntax
 boolean supportsSubqueriesInComparisons()
          Checks whether metamatrix supports subqueries in comparision expressions.
 boolean supportsSubqueriesInExists()
          Checks whether metamatrix supports subqueries in EXISTS expressions.
 boolean supportsSubqueriesInIns()
          Checks whether metamatrix supports subqueries in IN statements.
 boolean supportsSubqueriesInQuantifieds()
          Checks whether metamatrix supports subqueries in qualified expressions.
 boolean supportsTableCorrelationNames()
          Checks whether metamatrix supports table correlation names
 boolean supportsTransactionIsolationLevel(int level)
          Checks whether metamatrix supports the given transaction isolation level
 boolean supportsTransactions()
          Checks whether metamatrix supports transactions
 boolean supportsUnion()
          Checks whether metamatrix supports SQL UNION
 boolean supportsUnionAll()
          Checks whether metamatrix supports SQL UNION ALL
 boolean updatesAreDetected(int type)
          Indicates whether or not a visible row update can be detected by calling the method ResultSet.rowUpdated.
 boolean usesLocalFilePerTable()
          Checks whether metamatrix uses a separate local file to store each table
 boolean usesLocalFiles()
          Checks whether metamatrix stores tables in a local file
 
Methods inherited from class com.metamatrix.jdbc.WrapperImpl
isWrapperFor, unwrap
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface java.sql.Wrapper
isWrapperFor, unwrap
 

Method Detail

allProceduresAreCallable

public boolean allProceduresAreCallable()
                                 throws java.sql.SQLException

Checks whether the current user has the required security rights to call all the procedures returned by the method getProcedures.

Specified by:
allProceduresAreCallable in interface java.sql.DatabaseMetaData
Returns:
true if the precedures are selectable else return false
Throws:
SQLException. - Should never occur.
java.sql.SQLException

allTablesAreSelectable

public boolean allTablesAreSelectable()
                               throws java.sql.SQLException

Checks whether the current user can use SELECT statement with all of the tables returned by the method getTables. Selectability is column level in metamatrix, hence return true

Specified by:
allTablesAreSelectable in interface java.sql.DatabaseMetaData
Returns:
true if tables are selectable else return false
Throws:
SQLException. - Should never occur.
java.sql.SQLException

dataDefinitionCausesTransactionCommit

public boolean dataDefinitionCausesTransactionCommit()
                                              throws java.sql.SQLException

Checks whether a DDL statement within a transaction forces the transaction to commit.

Specified by:
dataDefinitionCausesTransactionCommit in interface java.sql.DatabaseMetaData
Returns:
if so return true else return false.
Throws:
java.sql.SQLException - Should never occur.

dataDefinitionIgnoredInTransactions

public boolean dataDefinitionIgnoredInTransactions()
                                            throws java.sql.SQLException

Checks whether a DDL statement within a transaction is ignored.

Specified by:
dataDefinitionIgnoredInTransactions in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false
Throws:
java.sql.SQLException

deletesAreDetected

public boolean deletesAreDetected(int type)
                           throws java.sql.SQLException

Indicates whether or not a visible row delete can be detected by calling ResultSet.rowDeleted(). If deletesAreDetected() returns false, then deleted rows are removed from the result set.

Specified by:
deletesAreDetected in interface java.sql.DatabaseMetaData
Parameters:
result - set type, i.e. ResultSet.TYPE_XXX
Returns:
true if changes are detected by the resultset type
Throws:
SQLException, - should never occur
java.sql.SQLException

doesMaxRowSizeIncludeBlobs

public boolean doesMaxRowSizeIncludeBlobs()
                                   throws java.sql.SQLException

Did getMaxRowSize() include LONGVARCHAR and LONGVARBINARY blobs?

Specified by:
doesMaxRowSizeIncludeBlobs in interface java.sql.DatabaseMetaData
Returns:
true if so; false otherwise
Throws:
SQLException, - should never occur
java.sql.SQLException

getBestRowIdentifier

public java.sql.ResultSet getBestRowIdentifier(java.lang.String catalog,
                                               java.lang.String schema,
                                               java.lang.String table,
                                               int scope,
                                               boolean nullable)
                                        throws java.sql.SQLException

Gets a description of a table's optimal set of columns that uniquely identifies a row.

Specified by:
getBestRowIdentifier in interface java.sql.DatabaseMetaData
Parameters:
name - of the catalog from which metadata needs
catalog - name in which the table is present.
schema - name in which this table is present.
table - name whose best row identifier info is sought.
int - indicating the scope of the result.
boolean - indicating whether the nullable columns can be included.
Returns:
ResultSet object containing the bestrow indetifier info.
Throws:
java.sql.SQLException

getCatalogs

public java.sql.ResultSet getCatalogs()
                               throws java.sql.SQLException

Gets the catalog names available to metamatrix. The results are ordered by catalog name. There is no concept of catalogs in a metamatrix driver and this returns an empty resultSet.

Specified by:
getCatalogs in interface java.sql.DatabaseMetaData
Returns:
ResultSet object containing metadata info of the catalog on this connection.
Throws:
java.sql.SQLException - if there is an error obtaining server results

getCatalogSeparator

public java.lang.String getCatalogSeparator()
                                     throws java.sql.SQLException

Gets the String object used to separate a catalog name and a table name

Specified by:
getCatalogSeparator in interface java.sql.DatabaseMetaData
Returns:
String delimiter
Throws:
SQLException, - should never occur.
java.sql.SQLException

getCatalogTerm

public java.lang.String getCatalogTerm()
                                throws java.sql.SQLException

Get the metamatrix term for catalog

Specified by:
getCatalogTerm in interface java.sql.DatabaseMetaData
Returns:
String representing catalog name
Throws:
SQLException, - should never occur.
java.sql.SQLException

getColumnPrivileges

public java.sql.ResultSet getColumnPrivileges(java.lang.String catalog,
                                              java.lang.String schema,
                                              java.lang.String table,
                                              java.lang.String columnName)
                                       throws java.sql.SQLException

Gets a description of the access rights for a column of the given name. Catalog, schema and table names are not used to narrow down the search, but the schema name should match the virtualdatabasename used to obtain this driver connection.

Specified by:
getColumnPrivileges in interface java.sql.DatabaseMetaData
Parameters:
name - of the catalog to which columns belong.
name - of the schema to which columns belong.
name - of the table to which columns belong.
name - pattern to be matched by column names.
Returns:
ResultSet containing column privilage information.
Throws:
java.sql.SQLException - if there is an error obtaining server results

getColumns

public java.sql.ResultSet getColumns(java.lang.String catalog,
                                     java.lang.String schema,
                                     java.lang.String tableNamePattern,
                                     java.lang.String columnNamePattern)
                              throws java.sql.SQLException

Get's the metadata information about the columns whose names match the given columnNamePattern. Catalog, schema and tableNamePattern are not used to narrow down the search, but Catalog and schema names should match the virtualdatabasename and version used to obtain this driver connection.

The ResultSet returned by this method contains the following additional columns that are not specified in the JDBC specification.

  1. Format String => format of the column
  2. MinRange String => minimum range value of the column
  3. MaxRange String => maximum range value of the column

      Specified by:
      getColumns in interface java.sql.DatabaseMetaData
      Parameters:
      catalog - name to which the columns belong.
      schema - name to which the columns belong.
      pattern - name to be matched by table name.
      pattern - name to be matched by column name.
      Returns:
      ResultSet containing column metadata info.
      Throws:
      java.sql.SQLException - if there is an error obtaining server results.

getCrossReference

public java.sql.ResultSet getCrossReference(java.lang.String primaryCatalog,
                                            java.lang.String primarySchema,
                                            java.lang.String primaryTable,
                                            java.lang.String foreignCatalog,
                                            java.lang.String foreignSchema,
                                            java.lang.String foreignTable)
                                     throws java.sql.SQLException

Gets the description of the foreign key columns in the table foreignTable. These foreign key columns reference primary key columns of primaryTable. Catalog and schema information is not used to narrow down the search, but Catalog and schema names(primary and foreign) should match the virtualdatabasename and version used to obtain this driver connection.

Specified by:
getCrossReference in interface java.sql.DatabaseMetaData
Parameters:
name - of the catalog containing primary keys.
name - of the schema containing primary keys.
name - of the table containing primary keys.
name - of the catalog containing foreign keys.
name - of the schema containing foreign keys.
name - of the table containing foreign keys.
Returns:
ResultSet giving description of foreign key columns.
Throws:
java.sql.SQLException - if there is an error obtaining server results

getDatabaseMinorVersion

public int getDatabaseMinorVersion()
                            throws java.sql.SQLException
Retrieves the minor version number of the underlying database.

Specified by:
getDatabaseMinorVersion in interface java.sql.DatabaseMetaData
Returns:
intValue of database's minor version
Throws:
java.sql.SQLException - if a database access error occurs.

getDatabaseMajorVersion

public int getDatabaseMajorVersion()
                            throws java.sql.SQLException
Retrieves the major version number of the underlying database.

Specified by:
getDatabaseMajorVersion in interface java.sql.DatabaseMetaData
Returns:
intValue of database's minor version
Throws:
java.sql.SQLException - if a database access error occurs.

getJDBCMajorVersion

public int getJDBCMajorVersion()
                        throws java.sql.SQLException
Retrieves the major JDBC version number for this driver.

Specified by:
getJDBCMajorVersion in interface java.sql.DatabaseMetaData
Returns:
intValue JDBC major version number
Throws:
java.sql.SQLException - should never occur.

getJDBCMinorVersion

public int getJDBCMinorVersion()
                        throws java.sql.SQLException
Retrieves the minor JDBC version number for this driver.

Specified by:
getJDBCMinorVersion in interface java.sql.DatabaseMetaData
Returns:
intValue JDBC major version number
Throws:
java.sql.SQLException - should never occur.

getDatabaseProductName

public java.lang.String getDatabaseProductName()
                                        throws java.sql.SQLException

Gets the product name for this database

Specified by:
getDatabaseProductName in interface java.sql.DatabaseMetaData
Returns:
String representing the product name
Throws:
java.sql.SQLException - should never occur.

getDatabaseProductVersion

public java.lang.String getDatabaseProductVersion()
                                           throws java.sql.SQLException

Gets the version of metamatrix server to which this driver connects

Specified by:
getDatabaseProductVersion in interface java.sql.DatabaseMetaData
Returns:
String representing the product version
Throws:
java.sql.SQLException - if there is an error accessing product release info.

getDefaultTransactionIsolation

public int getDefaultTransactionIsolation()
                                   throws java.sql.SQLException

Gets metamatrix default transaction isolation level.

Specified by:
getDefaultTransactionIsolation in interface java.sql.DatabaseMetaData
Returns:
intvalue giving the transaction isolation level
Throws:
java.sql.SQLException - never

getDriverMajorVersion

public int getDriverMajorVersion()

Gets this drivers major version number

Specified by:
getDriverMajorVersion in interface java.sql.DatabaseMetaData
Returns:
int representing the driver's major version

getDriverMinorVersion

public int getDriverMinorVersion()

Gets this drivers minor version number

Specified by:
getDriverMinorVersion in interface java.sql.DatabaseMetaData
Returns:
int representing the driver's minor version

getDriverName

public java.lang.String getDriverName()
                               throws java.sql.SQLException

Get the name of this JDBC driver

Specified by:
getDriverName in interface java.sql.DatabaseMetaData
Returns:
String representing the driver's name
Throws:
SQLException, - if the connection is already closed.
java.sql.SQLException

getDriverVersion

public java.lang.String getDriverVersion()
                                  throws java.sql.SQLException

This method gets the version of this JDBC driver. It combines the major and minor version numbers

Specified by:
getDriverVersion in interface java.sql.DatabaseMetaData
Returns:
String representing the driver's version
Throws:
SQLException, - should never occur.
java.sql.SQLException

getExportedKeys

public java.sql.ResultSet getExportedKeys(java.lang.String catalog,
                                          java.lang.String schema,
                                          java.lang.String table)
                                   throws java.sql.SQLException

This method gets a description of the forignkey columns that reference the primary key columns in the given table. Catalog and schema names are not used to narrow down the search, but they should match the virtualdatabasename and version used to obtain this driver connection.

Specified by:
getExportedKeys in interface java.sql.DatabaseMetaData
Parameters:
name - of the catalog which contains the given table.
schema - name which contains the given table.
table - name which contains the primary keys.
Returns:
ResultSet object giving the exported key info.
Throws:
java.sql.SQLException - if there is an error obtaining server results

getExtraNameCharacters

public java.lang.String getExtraNameCharacters()
                                        throws java.sql.SQLException

Gets the extra characters that can be used in unquoted identifier names (those beyond a-z, 0-9, and _)

Specified by:
getExtraNameCharacters in interface java.sql.DatabaseMetaData
Returns:
String representing extra charachters that can be used in identifier names.
Throws:
SQLException, - should never occur
java.sql.SQLException

getIdentifierQuoteString

public java.lang.String getIdentifierQuoteString()
                                          throws java.sql.SQLException

Get's the string used to quote SQL identifiers. This returns a " " if identifier quoting is not supported.

Specified by:
getIdentifierQuoteString in interface java.sql.DatabaseMetaData
Returns:
string used to quote SQL identifiers.
Throws:
SQLException, - should never occur
java.sql.SQLException

getImportedKeys

public java.sql.ResultSet getImportedKeys(java.lang.String catalog,
                                          java.lang.String schema,
                                          java.lang.String table)
                                   throws java.sql.SQLException

Gets a description of the primary key columns that are referenced by the foreign key columns in the given table. Catalog and schema names are not used to narrow down the search, but they should match the virtualdatabasename and version used to obtain this driver connection.

Specified by:
getImportedKeys in interface java.sql.DatabaseMetaData
Parameters:
name - of the catalog which contains the given table.
schema - name which contains the given table.
table - name which contains the foreign keys.
Returns:
ResultSet object giving the imported key info.
Throws:
java.sql.SQLException - if there is an error obtaining server results

getIndexInfo

public java.sql.ResultSet getIndexInfo(java.lang.String catalog,
                                       java.lang.String schema,
                                       java.lang.String table,
                                       boolean unique,
                                       boolean approximate)
                                throws java.sql.SQLException

Gets a description of the indexes that are present on a given table.

Specified by:
getIndexInfo in interface java.sql.DatabaseMetaData
Parameters:
name - of the catalog which contains the given table.
schema - name which contains the given table.
table - name which contains the indexes.
boolean - indicating if unique key info needs to be returned.
boolean - indicating if approximate value are to be allowed.
Returns:
ResultSet object containing metadata info of index columns.
Throws:
java.sql.SQLException - if catalog/schema info does not match for this connection.

getMaxBinaryLiteralLength

public int getMaxBinaryLiteralLength()
                              throws java.sql.SQLException

Gets the maximum number of hexadecimal characters allowed in an inline binary literal

Specified by:
getMaxBinaryLiteralLength in interface java.sql.DatabaseMetaData
Returns:
int value giving maximum length of a binary literal
Throws:
SQLException, - should never occur
java.sql.SQLException

getMaxCatalogNameLength

public int getMaxCatalogNameLength()
                            throws java.sql.SQLException

Gets the maximum number of characters allowed in a catalog name

Specified by:
getMaxCatalogNameLength in interface java.sql.DatabaseMetaData
Returns:
int value giving maximum length of a catalog name
Throws:
SQLException, - should never occur
java.sql.SQLException

getMaxCharLiteralLength

public int getMaxCharLiteralLength()
                            throws java.sql.SQLException

Gets the maximum number of characters allowed in a character literal

Specified by:
getMaxCharLiteralLength in interface java.sql.DatabaseMetaData
Returns:
int value giving maximum length of a charachter literal
Throws:
SQLException, - should never occur
java.sql.SQLException

getMaxColumnNameLength

public int getMaxColumnNameLength()
                           throws java.sql.SQLException

Gets the maximum number of characters allowed in a column name

Specified by:
getMaxColumnNameLength in interface java.sql.DatabaseMetaData
Returns:
int value giving maximum length of the column name
Throws:
SQLException, - should never occur
java.sql.SQLException

getMaxColumnsInGroupBy

public int getMaxColumnsInGroupBy()
                           throws java.sql.SQLException

Gets the maximum number of columns allowed in a GROUP BY clause

Specified by:
getMaxColumnsInGroupBy in interface java.sql.DatabaseMetaData
Returns:
int values giving max columns in GROUP BY
Throws:
SQLException, - should never occur
java.sql.SQLException

getMaxColumnsInIndex

public int getMaxColumnsInIndex()
                         throws java.sql.SQLException

Gets the maximum number of columns allowed in an index

Specified by:
getMaxColumnsInIndex in interface java.sql.DatabaseMetaData
Returns:
int gives maximum columns in an index.
Throws:
SQLException, - should never occur
java.sql.SQLException

getMaxColumnsInOrderBy

public int getMaxColumnsInOrderBy()
                           throws java.sql.SQLException

Gets the maximum number of columns allowed in a ORDER BY clause

Specified by:
getMaxColumnsInOrderBy in interface java.sql.DatabaseMetaData
Returns:
int gives maximum columns in an order by.
Throws:
SQLException, - should never occur
java.sql.SQLException

getMaxColumnsInSelect

public int getMaxColumnsInSelect()
                          throws java.sql.SQLException

Gets the maximum number of columns allowed in a SELECT clause

Specified by:
getMaxColumnsInSelect in interface java.sql.DatabaseMetaData
Returns:
int gives maximum columns in a select.
Throws:
SQLException, - should never occur
java.sql.SQLException

getMaxColumnsInTable

public int getMaxColumnsInTable()
                         throws java.sql.SQLException

Gets the maximum number of columns allowed in a table

Specified by:
getMaxColumnsInTable in interface java.sql.DatabaseMetaData
Returns:
int gives maximum columns in a table.
Throws:
SQLException, - should never occur
java.sql.SQLException

getMaxConnections

public int getMaxConnections()
                      throws java.sql.SQLException

Gets the maximum number of active connections to metamatrix that can be maintained through this driver instance

Specified by:
getMaxConnections in interface java.sql.DatabaseMetaData
Returns:
int gives maximum connections.
Throws:
SQLException, - should never occur
java.sql.SQLException

getMaxCursorNameLength

public int getMaxCursorNameLength()
                           throws java.sql.SQLException

Gets the maximum number of characters allowed in a cursor name

Specified by:
getMaxCursorNameLength in interface java.sql.DatabaseMetaData
Returns:
int gives maximum max charachters allowed in a cursor name.
Throws:
SQLException, - should never occur
java.sql.SQLException

getMaxIndexLength

public int getMaxIndexLength()
                      throws java.sql.SQLException

Gets the maximum number of bytes allowed in an index

Specified by:
getMaxIndexLength in interface java.sql.DatabaseMetaData
Returns:
int gives maximum bytes.
Throws:
SQLException, - should never occur
java.sql.SQLException

getMaxProcedureNameLength

public int getMaxProcedureNameLength()
                              throws java.sql.SQLException

Gets the maximum number of characters allowed in a procedure name

Specified by:
getMaxProcedureNameLength in interface java.sql.DatabaseMetaData
Returns:
int gives maximum length of procedure name.
Throws:
SQLException, - should never occur
java.sql.SQLException

getMaxRowSize

public int getMaxRowSize()
                  throws java.sql.SQLException

Gets the maximum number of bytes allowed in a single row

Specified by:
getMaxRowSize in interface java.sql.DatabaseMetaData
Returns:
int max row size in the result set.
Throws:
SQLException, - should never occur
java.sql.SQLException

getMaxSchemaNameLength

public int getMaxSchemaNameLength()
                           throws java.sql.SQLException

Gets the maximum number of characters allowed in a schema name

Specified by:
getMaxSchemaNameLength in interface java.sql.DatabaseMetaData
Returns:
int maximum length of a schema.
Throws:
SQLException, - should never occur
java.sql.SQLException

getMaxStatementLength

public int getMaxStatementLength()
                          throws java.sql.SQLException

Gets the maximum number of characters allowed in an SQL statement

Specified by:
getMaxStatementLength in interface java.sql.DatabaseMetaData
Returns:
maximum length of a statement
Throws:
SQLException, - should never occur
java.sql.SQLException

getMaxStatements

public int getMaxStatements()
                     throws java.sql.SQLException

Gets the maximum number of active statements that may be open on one connection at any time

Specified by:
getMaxStatements in interface java.sql.DatabaseMetaData
Returns:
max number of open statements on a connection.
Throws:
SQLException, - should never occur
java.sql.SQLException

getMaxTableNameLength

public int getMaxTableNameLength()
                          throws java.sql.SQLException

Gets the maximum number of characters allowed in a table name

Specified by:
getMaxTableNameLength in interface java.sql.DatabaseMetaData
Returns:
max length of table name.
Throws:
SQLException, - should never occur
java.sql.SQLException

getMaxTablesInSelect

public int getMaxTablesInSelect()
                         throws java.sql.SQLException

Gets the maximum number of tables allowed in a SELECT clause

Specified by:
getMaxTablesInSelect in interface java.sql.DatabaseMetaData
Returns:
max tables in a select.
Throws:
SQLException, - should never occur
java.sql.SQLException

getMaxUserNameLength

public int getMaxUserNameLength()
                         throws java.sql.SQLException

Gets the maximum number of characters allowed in a user name

Specified by:
getMaxUserNameLength in interface java.sql.DatabaseMetaData
Returns:
max length of user name.
Throws:
SQLException, - should never occur
java.sql.SQLException

getNumericFunctions

public java.lang.String getNumericFunctions()
                                     throws java.sql.SQLException

Gets the OPEN GROUP CLI names of metamatrix math functions

Specified by:
getNumericFunctions in interface java.sql.DatabaseMetaData
Returns:
string giving numeric functions supported.
Throws:
SQLException, - should never occur
java.sql.SQLException

getPrimaryKeys

public java.sql.ResultSet getPrimaryKeys(java.lang.String catalog,
                                         java.lang.String schema,
                                         java.lang.String table)
                                  throws java.sql.SQLException

Get's a description of the primary key columns in a table. The descriptions are ordered by column name. Catalog and schema names are not used to narrow down the search, but they should match the virtualdatabasename and version used to obtain this driver connection.

Specified by:
getPrimaryKeys in interface java.sql.DatabaseMetaData
Parameters:
name - of the catalog which contains the given table.
schema - name which contains the given table.
table - name which contains the primary keys.
Returns:
ResultSet object containing primary keys of the given table.
Throws:
java.sql.SQLException - if there is an error obtaining metamatrix results.

getProcedureColumns

public java.sql.ResultSet getProcedureColumns(java.lang.String catalog,
                                              java.lang.String schemaPattern,
                                              java.lang.String procedureNamePattern,
                                              java.lang.String columnNamePattern)
                                       throws java.sql.SQLException

Gets a description of the input, output and results associated with certain stored procedures matching the given procedureNamePattern. Catalog and schema names are not used to narrow down the search, but they should match the virtualdatabasename and version used to obtain this driver connection.

Specified by:
getProcedureColumns in interface java.sql.DatabaseMetaData
Parameters:
name - of the catalog the procedure is present in.
pattern - of schama name the procedure is present in.
pattern - which is to be matched by the procedureNames.
pattern - to be matched by the column names.
Returns:
ResultSet containing the metadata info for procedure parameters.
Throws:
java.sql.SQLException - if there is an error obtaining metamatrix results.

getProcedures

public java.sql.ResultSet getProcedures(java.lang.String catalog,
                                        java.lang.String schemaPattern,
                                        java.lang.String procedureNamePattern)
                                 throws java.sql.SQLException

Gets description of all the available stored procedures whose names match the given pattern. Catalog and schemaPattern are not used to narrow down the search, but they should match the virtualdatabasename and version used to obtain this driver connection.

Specified by:
getProcedures in interface java.sql.DatabaseMetaData
Parameters:
name - of the catalog.
name - of the schema.
pattern - which is to be matched by the procedureNames.
Returns:
ResultSet object which gives the metadata information about procedures.
Throws:
java.sql.SQLException - if there is an error obtaining metamatrix results.

getProcedureTerm

public java.lang.String getProcedureTerm()
                                  throws java.sql.SQLException

Gets MetaMatrix's preferred term for procedures

Specified by:
getProcedureTerm in interface java.sql.DatabaseMetaData
Returns:
String representing metamatrix procedure term.
Throws:
SQLException, - should never occur
java.sql.SQLException

getSchemas

public java.sql.ResultSet getSchemas()
                              throws java.sql.SQLException

Gets the schema names available for this connection. The results are ordered by schema name. Schema information retreived only for the schema to which used in obtaining this driver connection.

Specified by:
getSchemas in interface java.sql.DatabaseMetaData
Returns:
ResultsSet object containing schema and catalog names.
Throws:
java.sql.SQLException - if there is an error obtaining metamatrix results.

getSchemaTerm

public java.lang.String getSchemaTerm()
                               throws java.sql.SQLException

Gets MetaMatrix's preferred term for schema

Specified by:
getSchemaTerm in interface java.sql.DatabaseMetaData
Returns:
String object giving schema term
Throws:
SQLException, - should never occur
java.sql.SQLException

getSearchStringEscape

public java.lang.String getSearchStringEscape()
                                       throws java.sql.SQLException

Gets the string that can be used to escape "_" or "%" wildcards in the string search pattern used for search parameters

Specified by:
getSearchStringEscape in interface java.sql.DatabaseMetaData
Returns:
String that is used for escaping wildcards
Throws:
SQLException, - should never occur
java.sql.SQLException

getSQLKeywords

public java.lang.String getSQLKeywords()
                                throws java.sql.SQLException

Get metamatrix keywords that are not SQL-92 keyword

Specified by:
getSQLKeywords in interface java.sql.DatabaseMetaData
Returns:
String object giving non SQL-92 keywords
Throws:
SQLException, - should never occur
java.sql.SQLException

getSQLStateType

public int getSQLStateType()
                    throws java.sql.SQLException
Indicates whether the SQLSTATE returned by SQLException.getSQLState is X/Open (now known as Open Group) SQL CLI or SQL99.

Specified by:
getSQLStateType in interface java.sql.DatabaseMetaData
Returns:
intValue, the type of SQLSTATE; one of: sqlStateXOpen or sqlStateSQL99
Throws:
java.sql.SQLException

getStringFunctions

public java.lang.String getStringFunctions()
                                    throws java.sql.SQLException

Gets the Open Group CLI names for metamatrix string functions

Specified by:
getStringFunctions in interface java.sql.DatabaseMetaData
Returns:
String containing string function names
Throws:
SQLException, - should never occur
java.sql.SQLException

getSuperTables

public java.sql.ResultSet getSuperTables(java.lang.String catalog,
                                         java.lang.String schemaPattern,
                                         java.lang.String tableNamePattern)
                                  throws java.sql.SQLException
Retrieves a description of the table hierarchies defined in a particular schema in this database.

Specified by:
getSuperTables in interface java.sql.DatabaseMetaData
Parameters:
catalog - A catalog name; "" retrieves those without a catalog; null means drop catalog name from the selection criteria.
schemaPattern - A schema name pattern; "" retrieves those without a schema.
tableNamePattern - A table name pattern; may be a fully-qualified name.
Throws:
java.sql.SQLException - since not supported

getSuperTypes

public java.sql.ResultSet getSuperTypes(java.lang.String catalog,
                                        java.lang.String schemaPattern,
                                        java.lang.String tableNamePattern)
                                 throws java.sql.SQLException
Retrieves a description of the user-defined type (UDT) hierarchies defined in a particular schema in this database.

Specified by:
getSuperTypes in interface java.sql.DatabaseMetaData
Parameters:
catalog - A catalog name; "" retrieves those without a catalog; null means drop catalog name from the selection criteria.
schemaPattern - A schema name pattern; "" retrieves those without a schema.
tableNamePattern - A table name pattern; may be a fully-qualified name.
Throws:
java.sql.SQLException

getSystemFunctions

public java.lang.String getSystemFunctions()
                                    throws java.sql.SQLException

Gets the Open Group CLI names for metamatrix system functions

Specified by:
getSystemFunctions in interface java.sql.DatabaseMetaData
Returns:
String containing system function names
Throws:
SQLException, - should never occur
java.sql.SQLException

getTablePrivileges

public java.sql.ResultSet getTablePrivileges(java.lang.String catalog,
                                             java.lang.String schemaPattern,
                                             java.lang.String tableName)
                                      throws java.sql.SQLException

Gets a description of access rights for the table of the given name.

Catalog and schemaPattern are not used to narrow down the search, but they should match the virtualdatabasename and version used to obtain this driver connection.

Specified by:
getTablePrivileges in interface java.sql.DatabaseMetaData
Parameters:
name - of the catalog the table is present in.
pattern - of schama name the table is present in.
pattern - of table names whose privilage info is needed.
Returns:
ResultSet containing table privilages info.
Throws:
java.sql.SQLException - if there is an error obtaining metamatrix results.

getTables

public java.sql.ResultSet getTables(java.lang.String catalog,
                                    java.lang.String schemaPattern,
                                    java.lang.String tableNamePattern,
                                    java.lang.String[] types)
                             throws java.sql.SQLException

Gets a description of tables whose table name matches tableNamePattern.

Catalog, schemaPattern and types[] are not used to narrow down the search, but catalog and schemaPattern should match the virtualdatabasename and version respectively used to obtain this driver connection. Note: supports 1.4 API

Specified by:
getTables in interface java.sql.DatabaseMetaData
Parameters:
name - of the catalog in which tables are present.
pattern - of schema names which in which the tables are present.
pattern - of tables names.
list - of possible table types.
Returns:
ResultSet containing Table metadata information.
Throws:
java.sql.SQLException - if there is an error obtaining metamatrix results.

getTableTypes

public java.sql.ResultSet getTableTypes()
                                 throws java.sql.SQLException

Gets the table types available to metamatrix. The results are ordered by table type

Specified by:
getTableTypes in interface java.sql.DatabaseMetaData
Returns:
ResultSet object containing hardcoded table type info.
Throws:
SQLException, - should never occur.
java.sql.SQLException

getTimeDateFunctions

public java.lang.String getTimeDateFunctions()
                                      throws java.sql.SQLException

Gets the Open Group CLI names for metamatrix time and date functions

Specified by:
getTimeDateFunctions in interface java.sql.DatabaseMetaData
Returns:
String representing time and date functions in MetaMatrix
Throws:
SQLException, - should never occur
java.sql.SQLException

getTypeInfo

public java.sql.ResultSet getTypeInfo()
                               throws java.sql.SQLException

Gets the description of all datatypes supported by metamatrix.

Specified by:
getTypeInfo in interface java.sql.DatabaseMetaData
Returns:
ResultSet object containing info about the datatypes supported by MetaMatrix.
Throws:
java.sql.SQLException - if there is an error obtaining metamatrix results.

getUDTs

public java.sql.ResultSet getUDTs(java.lang.String catalog,
                                  java.lang.String schemaPattern,
                                  java.lang.String typeNamePattern,
                                  int[] types)
                           throws java.sql.SQLException

Gets a description of the user-defined types defined in a particular schema. Schema-specific UDTs may have type JAVA_OBJECT, STRUCT, or DISTINCT. Supports 1.4

Specified by:
getUDTs in interface java.sql.DatabaseMetaData
Parameters:
catalog - a catalog name
schemaPattern - a schema name pattern
typeNamePattern - a type name pattern
types - a list of user-named types to include (JAVA_OBJECT, STRUCT, or DISTINCT); null returns all types
Returns:
ResultSet. Empty ResultSet object as this method is not supported.
Throws:
java.sql.SQLException - if catalog/schema info does not match for the given connection.

getURL

public java.lang.String getURL()
                        throws java.sql.SQLException

Gets the URL used to connect to metamatrix

Specified by:
getURL in interface java.sql.DatabaseMetaData
Returns:
URL used to connect.
Throws:
java.sql.SQLException

getUserName

public java.lang.String getUserName()
                             throws java.sql.SQLException

Gets the user name as known to metamatrix

Specified by:
getUserName in interface java.sql.DatabaseMetaData
Returns:
name if the user.
Throws:
java.sql.SQLException

getVersionColumns

public java.sql.ResultSet getVersionColumns(java.lang.String catalog,
                                            java.lang.String schema,
                                            java.lang.String table)
                                     throws java.sql.SQLException

Gets the description of the columns in a table that are automatically updated when any value in a row is updated. The column descriptions are not ordered.

Specified by:
getVersionColumns in interface java.sql.DatabaseMetaData
Parameters:
name - of the catalog in which the table is present.
name - of the schema in which the table is present.
name - of the table which has the version columns.
Returns:
ResultSet object containing version column information.
Throws:
SQLException, - should never occur
java.sql.SQLException

isCatalogAtStart

public boolean isCatalogAtStart()
                         throws java.sql.SQLException

Checks whether a catalog name appears at the start of a fully qualified table name. If it is not at the beginning, it appears at the end.

Specified by:
isCatalogAtStart in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

insertsAreDetected

public boolean insertsAreDetected(int type)
                           throws java.sql.SQLException

Indicates whether or not a visible row insert can be detected by calling ResultSet.rowInserted().

Specified by:
insertsAreDetected in interface java.sql.DatabaseMetaData
Parameters:
result - set type, i.e. ResultSet.TYPE_XXX
Returns:
true if changes are detected by the resultset type
Throws:
SQLException, - should never occur
java.sql.SQLException

isReadOnly

public boolean isReadOnly()
                   throws java.sql.SQLException

Checks whether the databases used by metamatrix are in read-only mode

Specified by:
isReadOnly in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

locatorsUpdateCopy

public boolean locatorsUpdateCopy()
                           throws java.sql.SQLException

Indicates whether updates made to a LOB are made on a copy or directly to the LOB.

Specified by:
locatorsUpdateCopy in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

nullPlusNonNullIsNull

public boolean nullPlusNonNullIsNull()
                              throws java.sql.SQLException

Checks whether the concatenation of a NULL vaule and a non-NULL value results in a NULL value.

Specified by:
nullPlusNonNullIsNull in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

nullsAreSortedAtEnd

public boolean nullsAreSortedAtEnd()
                            throws java.sql.SQLException

Checks whether NULL vaules are sorted at the end regardless of sort order.

Specified by:
nullsAreSortedAtEnd in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

nullsAreSortedAtStart

public boolean nullsAreSortedAtStart()
                              throws java.sql.SQLException

Checks whether NULL vaules are sorted at the start regardless of sort order.

Specified by:
nullsAreSortedAtStart in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

nullsAreSortedHigh

public boolean nullsAreSortedHigh()
                           throws java.sql.SQLException

Checks whether NULL vaules are sorted high.

Specified by:
nullsAreSortedHigh in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

nullsAreSortedLow

public boolean nullsAreSortedLow()
                          throws java.sql.SQLException

Checks whether NULL vaules are sorted low.

Specified by:
nullsAreSortedLow in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

ownUpdatesAreVisible

public boolean ownUpdatesAreVisible(int type)
                             throws java.sql.SQLException

Indicates whether a result set's own updates are visible.

Specified by:
ownUpdatesAreVisible in interface java.sql.DatabaseMetaData
Parameters:
result - set type, i.e. ResultSet.TYPE_XXX
Returns:
true if updates are visible for the result set type; false otherwise
Throws:
SQLException, - should never occur
java.sql.SQLException

ownDeletesAreVisible

public boolean ownDeletesAreVisible(int type)
                             throws java.sql.SQLException

Indicates whether a result set's own deletes are visible.

Specified by:
ownDeletesAreVisible in interface java.sql.DatabaseMetaData
Parameters:
result - set type, i.e. ResultSet.TYPE_XXX
Returns:
true if deletes are visible for the result set type; false otherwise
Throws:
SQLException, - should never occur
java.sql.SQLException

ownInsertsAreVisible

public boolean ownInsertsAreVisible(int type)
                             throws java.sql.SQLException

Indicates whether a result set's own inserts are visible.

Specified by:
ownInsertsAreVisible in interface java.sql.DatabaseMetaData
Parameters:
result - set type, i.e. ResultSet.TYPE_XXX
Returns:
true if inserts are visible for the result set type; false otherwise
Throws:
SQLException, - should never occur
java.sql.SQLException

othersUpdatesAreVisible

public boolean othersUpdatesAreVisible(int type)
                                throws java.sql.SQLException

Indicates whether updates made by others are visible.

Specified by:
othersUpdatesAreVisible in interface java.sql.DatabaseMetaData
Parameters:
result - set type, i.e. ResultSet.TYPE_XXX
Returns:
true if updates made by others are visible for the result set type; false otherwise
Throws:
SQLException, - should never occur
java.sql.SQLException

othersDeletesAreVisible

public boolean othersDeletesAreVisible(int type)
                                throws java.sql.SQLException

Indicates whether deletes made by others are visible.

Specified by:
othersDeletesAreVisible in interface java.sql.DatabaseMetaData
Parameters:
result - set type, i.e. ResultSet.TYPE_XXX
Returns:
true if deletes made by others are visible for the result set type; false otherwise
Throws:
SQLException, - should never occur
java.sql.SQLException

othersInsertsAreVisible

public boolean othersInsertsAreVisible(int type)
                                throws java.sql.SQLException

Indicates whether inserts made by others are visible.

Specified by:
othersInsertsAreVisible in interface java.sql.DatabaseMetaData
Parameters:
result - set type, i.e. ResultSet.TYPE_XXX
Returns:
true if updates are visible for the result set type true if inserts made by others are visible for the result set type; false otherwise
Throws:
SQLException, - should never occur
java.sql.SQLException

storesLowerCaseIdentifiers

public boolean storesLowerCaseIdentifiers()
                                   throws java.sql.SQLException

This method checks whether metamatrix treats mixed-case unquoted SQL identifiers used in SQL statements as case-insensitive and stores them as all lowercase in its metadata tables.

Specified by:
storesLowerCaseIdentifiers in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

storesLowerCaseQuotedIdentifiers

public boolean storesLowerCaseQuotedIdentifiers()
                                         throws java.sql.SQLException

This method checks whether metamatrix treats mixed-case quoted SQL identifiers used in SQL statements as case-insensitive and stores them as all lowercase in its metadata tables.

Specified by:
storesLowerCaseQuotedIdentifiers in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

storesMixedCaseIdentifiers

public boolean storesMixedCaseIdentifiers()
                                   throws java.sql.SQLException

This method checks whether metamatrix treats mixed-case unquoted SQL identifiers used in SQL statements as case-insensitive and stores them as all mixedcase in its metadata tables.

Specified by:
storesMixedCaseIdentifiers in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

storesMixedCaseQuotedIdentifiers

public boolean storesMixedCaseQuotedIdentifiers()
                                         throws java.sql.SQLException

This method checks whether metamatrix treats mixed-case quoted SQL identifiers used in SQL statements as case-insensitive and stores them in mixedcase in its metadata tables.

Specified by:
storesMixedCaseQuotedIdentifiers in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

storesUpperCaseIdentifiers

public boolean storesUpperCaseIdentifiers()
                                   throws java.sql.SQLException

This method checks whether metamatrix treats mixed-case unquoted SQL identifiers used in SQL statements as case-insensitive and stores them as all uppercase in its metadata tables.

Specified by:
storesUpperCaseIdentifiers in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

storesUpperCaseQuotedIdentifiers

public boolean storesUpperCaseQuotedIdentifiers()
                                         throws java.sql.SQLException

This method checks whether metamatrix treats mixed-case quoted SQL identifiers used in SQL statements as case-insensitive and stores them as all uppercase in its metadata tables.

Specified by:
storesUpperCaseQuotedIdentifiers in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsAlterTableWithAddColumn

public boolean supportsAlterTableWithAddColumn()
                                        throws java.sql.SQLException

Checks whether metamatrix supports ALTER TABLE with add column.

Specified by:
supportsAlterTableWithAddColumn in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsAlterTableWithDropColumn

public boolean supportsAlterTableWithDropColumn()
                                         throws java.sql.SQLException

Checks whether metamatrix supports ALTER TABLE with drop column.

Specified by:
supportsAlterTableWithDropColumn in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsANSI92EntryLevelSQL

public boolean supportsANSI92EntryLevelSQL()
                                    throws java.sql.SQLException

Checks whether metamatrix supports ANSI-92 entry level SQL grammer.

Specified by:
supportsANSI92EntryLevelSQL in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsANSI92FullSQL

public boolean supportsANSI92FullSQL()
                              throws java.sql.SQLException

Checks whether metamatrix supports ANSI-92 full SQL grammer.

Specified by:
supportsANSI92FullSQL in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsANSI92IntermediateSQL

public boolean supportsANSI92IntermediateSQL()
                                      throws java.sql.SQLException

Checks whether metamatrix supports ANSI-92 intermediate SQL grammer.

Specified by:
supportsANSI92IntermediateSQL in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsBatchUpdates

public boolean supportsBatchUpdates()
                             throws java.sql.SQLException

Indicates whether the driver supports batch updates.

Specified by:
supportsBatchUpdates in interface java.sql.DatabaseMetaData
Returns:
true if the driver supports batch updates; false otherwise
Throws:
SQLException, - should never occur
java.sql.SQLException

supportsCatalogsInDataManipulation

public boolean supportsCatalogsInDataManipulation()
                                           throws java.sql.SQLException

Checks whether metamatrix supports using a catalog name in a data manipulation statement.

Specified by:
supportsCatalogsInDataManipulation in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsCatalogsInIndexDefinitions

public boolean supportsCatalogsInIndexDefinitions()
                                           throws java.sql.SQLException

Checks whether metamatrix supports using a catalog name in an index definition statement.

Specified by:
supportsCatalogsInIndexDefinitions in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsCatalogsInPrivilegeDefinitions

public boolean supportsCatalogsInPrivilegeDefinitions()
                                               throws java.sql.SQLException

Checks whether metamatrix supports using a catalog name in a privilage definition statement.

Specified by:
supportsCatalogsInPrivilegeDefinitions in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsCatalogsInProcedureCalls

public boolean supportsCatalogsInProcedureCalls()
                                         throws java.sql.SQLException

Checks whether metamatrix supports using a catalog name in a procedure call statement.

Specified by:
supportsCatalogsInProcedureCalls in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsCatalogsInTableDefinitions

public boolean supportsCatalogsInTableDefinitions()
                                           throws java.sql.SQLException

Checks whether metamatrix supports using a catalog name in a table definition statement.

Specified by:
supportsCatalogsInTableDefinitions in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsColumnAliasing

public boolean supportsColumnAliasing()
                               throws java.sql.SQLException

Checks whether metamatrix supports column aliasing. If true the SQL AS clause can be used to provide names for alias names for columns.

Specified by:
supportsColumnAliasing in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsConvert

public boolean supportsConvert()
                        throws java.sql.SQLException

Checks whether metamatrix supports scalar function CONVERT for the conversion of one JDBC type to another.

Specified by:
supportsConvert in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsConvert

public boolean supportsConvert(int fromType,
                               int toType)
                        throws java.sql.SQLException

Checks whether metamatrix supports scalar function CONVERT for the conversion of fromType to toType.

Specified by:
supportsConvert in interface java.sql.DatabaseMetaData
Parameters:
fromType - SQL type from which to convert
toType - SQL type to convert to
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsCorrelatedSubqueries

public boolean supportsCorrelatedSubqueries()
                                     throws java.sql.SQLException

Checks whether metamatrix supports correlated subqueries.

Specified by:
supportsCorrelatedSubqueries in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsCoreSQLGrammar

public boolean supportsCoreSQLGrammar()
                               throws java.sql.SQLException

Checks whether metamatrix supports ODBC Core SQL grammer.

Specified by:
supportsCoreSQLGrammar in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsDataDefinitionAndDataManipulationTransactions

public boolean supportsDataDefinitionAndDataManipulationTransactions()
                                                              throws java.sql.SQLException

Checks whether metamatric supports both data definition and data manipulation statements within a transaction.

Specified by:
supportsDataDefinitionAndDataManipulationTransactions in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsDataManipulationTransactionsOnly

public boolean supportsDataManipulationTransactionsOnly()
                                                 throws java.sql.SQLException

Are only data manipulation statements within a transaction supported?

Specified by:
supportsDataManipulationTransactionsOnly in interface java.sql.DatabaseMetaData
Returns:
true if so; false otherwise
Throws:
SQLException, - should never occur
java.sql.SQLException

supportsDifferentTableCorrelationNames

public boolean supportsDifferentTableCorrelationNames()
                                               throws java.sql.SQLException

Checks whether metamatric supports only data manipulation statements within a transaction.

Specified by:
supportsDifferentTableCorrelationNames in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsExpressionsInOrderBy

public boolean supportsExpressionsInOrderBy()
                                     throws java.sql.SQLException

Checks whether metamatrix supports expressions in ORDER BY lists.

Specified by:
supportsExpressionsInOrderBy in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsExtendedSQLGrammar

public boolean supportsExtendedSQLGrammar()
                                   throws java.sql.SQLException

Checks whether metamatrix supports ODBC Extended SQL grammer.

Specified by:
supportsExtendedSQLGrammar in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsFullOuterJoins

public boolean supportsFullOuterJoins()
                               throws java.sql.SQLException

Checks whether metamatrix supports full outer joins

Specified by:
supportsFullOuterJoins in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsGetGeneratedKeys

public boolean supportsGetGeneratedKeys()
                                 throws java.sql.SQLException
Retrieves whether auto-generated keys can be retrieved after a statement has been executed.

Specified by:
supportsGetGeneratedKeys in interface java.sql.DatabaseMetaData
Returns:
boolean true if auto-generated keys can be retrieved after a statement has executed; false otherwise
Throws:
SQLException, - should never occur
java.sql.SQLException

supportsGroupBy

public boolean supportsGroupBy()
                        throws java.sql.SQLException

Checks whether metamatrix supports GROUP BY

Specified by:
supportsGroupBy in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsGroupByBeyondSelect

public boolean supportsGroupByBeyondSelect()
                                    throws java.sql.SQLException

Checks whether a GROUP BY clause can use columns that are not in the SELECT clause, provided that it specifies all the columns in the SELECT clause.

Specified by:
supportsGroupByBeyondSelect in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsGroupByUnrelated

public boolean supportsGroupByUnrelated()
                                 throws java.sql.SQLException

Checks whether a GROUP BY clause can use columns that are not in the SELECT clause.

Specified by:
supportsGroupByUnrelated in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsIntegrityEnhancementFacility

public boolean supportsIntegrityEnhancementFacility()
                                             throws java.sql.SQLException

Checks whether metamatrix supports the SQL Integrity Enhancement Facility.

Specified by:
supportsIntegrityEnhancementFacility in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsLikeEscapeClause

public boolean supportsLikeEscapeClause()
                                 throws java.sql.SQLException

Checks whether metamatrix supports specifying a LIKE escape clause.

Specified by:
supportsLikeEscapeClause in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsLimitedOuterJoins

public boolean supportsLimitedOuterJoins()
                                  throws java.sql.SQLException

Checks whether metamatrix provides limited support for outer joins.

Specified by:
supportsLimitedOuterJoins in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsMinimumSQLGrammar

public boolean supportsMinimumSQLGrammar()
                                  throws java.sql.SQLException

Checks whether metamatrix supports the ODBC minimum SQL grammer.

Specified by:
supportsMinimumSQLGrammar in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsMixedCaseIdentifiers

public boolean supportsMixedCaseIdentifiers()
                                     throws java.sql.SQLException

Checks whether mixed-case unquoted SQL identifiers used in SQL statements are case sensitive

Specified by:
supportsMixedCaseIdentifiers in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsMixedCaseQuotedIdentifiers

public boolean supportsMixedCaseQuotedIdentifiers()
                                           throws java.sql.SQLException

Checks whether mixed-case quoted SQL identifiers used in SQL statements are case sensitive

Specified by:
supportsMixedCaseQuotedIdentifiers in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsOpenCursorsAcrossCommit

public boolean supportsOpenCursorsAcrossCommit()
                                        throws java.sql.SQLException

Checks whether metamatrix supports having cursors open across commits.

Specified by:
supportsOpenCursorsAcrossCommit in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.

Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsMultipleResultSets

public boolean supportsMultipleResultSets()
                                   throws java.sql.SQLException

Are multiple ResultSets from a single execute supported?

Specified by:
supportsMultipleResultSets in interface java.sql.DatabaseMetaData
Returns:
true if so; false otherwise
Throws:
SQLException, - should never occur
java.sql.SQLException

supportsMultipleOpenResults

public boolean supportsMultipleOpenResults()
                                    throws java.sql.SQLException
Retrieves whether it is possible to have multiple ResultSet objects returned from a CallableStatement object simultaneously.

Specified by:
supportsMultipleOpenResults in interface java.sql.DatabaseMetaData
Returns:
true if so; false otherwise
Throws:
SQLException, - should never occur
java.sql.SQLException

supportsMultipleTransactions

public boolean supportsMultipleTransactions()
                                     throws java.sql.SQLException

Checks whether multiple transactions open at once on different connectons

Specified by:
supportsMultipleTransactions in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsNamedParameters

public boolean supportsNamedParameters()
                                throws java.sql.SQLException
Retrieves whether metamatrix supports named parameters to callable statements.

Specified by:
supportsNamedParameters in interface java.sql.DatabaseMetaData
Returns:
boolean true if named parameters are supported; false otherwise.
Throws:
SQLException, - should never occur
java.sql.SQLException

supportsNonNullableColumns

public boolean supportsNonNullableColumns()
                                   throws java.sql.SQLException

Checks whether metamatrix supports defining columns as nonnullable.

Specified by:
supportsNonNullableColumns in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsOpenCursorsAcrossRollback

public boolean supportsOpenCursorsAcrossRollback()
                                          throws java.sql.SQLException

Checks whether metamatrix supports having cursors open across rollbacks.

Specified by:
supportsOpenCursorsAcrossRollback in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsOpenStatementsAcrossCommit

public boolean supportsOpenStatementsAcrossCommit()
                                           throws java.sql.SQLException

Checks whether metamatrix supports having cursors open across commits.

Specified by:
supportsOpenStatementsAcrossCommit in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsOpenStatementsAcrossRollback

public boolean supportsOpenStatementsAcrossRollback()
                                             throws java.sql.SQLException

Checks whether metamatrix supports having cursors open across rollbacks.

Specified by:
supportsOpenStatementsAcrossRollback in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsOrderByUnrelated

public boolean supportsOrderByUnrelated()
                                 throws java.sql.SQLException

Checks whether an ORDER BY clause can use columns that are not in the SELECT clause.

Specified by:
supportsOrderByUnrelated in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsOuterJoins

public boolean supportsOuterJoins()
                           throws java.sql.SQLException

Checks whether metamatrix supports some form of outer joins.

Specified by:
supportsOuterJoins in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsPositionedDelete

public boolean supportsPositionedDelete()
                                 throws java.sql.SQLException

Checks whether metamatrix supports positioned DELETEs on resultsets

Specified by:
supportsPositionedDelete in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsPositionedUpdate

public boolean supportsPositionedUpdate()
                                 throws java.sql.SQLException

Checks whether metamatrix supports positioned UPDATEs on result sets.

Specified by:
supportsPositionedUpdate in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsResultSetConcurrency

public boolean supportsResultSetConcurrency(int type,
                                            int concurrency)
                                     throws java.sql.SQLException

Does the database support the concurrency type in combination with the given result set type?

Specified by:
supportsResultSetConcurrency in interface java.sql.DatabaseMetaData
Parameters:
type - defined in java.sql.ResultSet
concurrency - type defined in java.sql.ResultSet
Returns:
true if so; false otherwise
Throws:
SQLException, - should never occur
java.sql.SQLException
See Also:
Connection

supportsResultSetHoldability

public boolean supportsResultSetHoldability(int holdability)
                                     throws java.sql.SQLException
Retrieves whether database supports the given result set holdability. Holdability - one of the following constants: ResultSet.HOLD_CURSORS_OVER_COMMIT or ResultSet.CLOSE_CURSORS_AT_COMMIT.

Specified by:
supportsResultSetHoldability in interface java.sql.DatabaseMetaData
Parameters:
intValue - holdability
Returns:
boolean true if so; false otherwise
Throws:
SQLException, - should never occur
java.sql.SQLException

supportsResultSetType

public boolean supportsResultSetType(int type)
                              throws java.sql.SQLException

Does the database support the given result set type?

Specified by:
supportsResultSetType in interface java.sql.DatabaseMetaData
Parameters:
type - defined in java.sql.ResultSet
Returns:
true if so; false otherwise
Throws:
SQLException, - should never occur
java.sql.SQLException
See Also:
Connection

supportsSavepoints

public boolean supportsSavepoints()
                           throws java.sql.SQLException
Retrieves whether metamatrix supports savepoints.

Specified by:
supportsSavepoints in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsSchemasInDataManipulation

public boolean supportsSchemasInDataManipulation()
                                          throws java.sql.SQLException

Checks whether metamatrix supports using a schema name in a data manipulation statement

Specified by:
supportsSchemasInDataManipulation in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsSchemasInIndexDefinitions

public boolean supportsSchemasInIndexDefinitions()
                                          throws java.sql.SQLException

Checks whether metamatrix supports using a schema name in an index definition statement

Specified by:
supportsSchemasInIndexDefinitions in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsSchemasInPrivilegeDefinitions

public boolean supportsSchemasInPrivilegeDefinitions()
                                              throws java.sql.SQLException

Checks whether metamatrix supports using a schema name in a privilage definition statement

Specified by:
supportsSchemasInPrivilegeDefinitions in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsSchemasInProcedureCalls

public boolean supportsSchemasInProcedureCalls()
                                        throws java.sql.SQLException

Checks whether metamatrix supports using a schema name in an procedure call statement

Specified by:
supportsSchemasInProcedureCalls in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsSchemasInTableDefinitions

public boolean supportsSchemasInTableDefinitions()
                                          throws java.sql.SQLException

Checks whether metamatrix supports using a schema name in an table definition statement

Specified by:
supportsSchemasInTableDefinitions in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsSelectForUpdate

public boolean supportsSelectForUpdate()
                                throws java.sql.SQLException

Checks whether metamatrix supports SELECT FOR UPDATE statements

Specified by:
supportsSelectForUpdate in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsStatementPooling

public boolean supportsStatementPooling()
                                 throws java.sql.SQLException
Retrieves whether this metamatrix supports statement pooling.

Specified by:
supportsStatementPooling in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsStoredProcedures

public boolean supportsStoredProcedures()
                                 throws java.sql.SQLException

Checks whether metamatrix supports stored procedure calls using the stored procedure escape syntax

Specified by:
supportsStoredProcedures in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsSubqueriesInComparisons

public boolean supportsSubqueriesInComparisons()
                                        throws java.sql.SQLException

Checks whether metamatrix supports subqueries in comparision expressions.

Specified by:
supportsSubqueriesInComparisons in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsSubqueriesInExists

public boolean supportsSubqueriesInExists()
                                   throws java.sql.SQLException

Checks whether metamatrix supports subqueries in EXISTS expressions.

Specified by:
supportsSubqueriesInExists in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsSubqueriesInIns

public boolean supportsSubqueriesInIns()
                                throws java.sql.SQLException

Checks whether metamatrix supports subqueries in IN statements.

Specified by:
supportsSubqueriesInIns in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsSubqueriesInQuantifieds

public boolean supportsSubqueriesInQuantifieds()
                                        throws java.sql.SQLException

Checks whether metamatrix supports subqueries in qualified expressions.

Specified by:
supportsSubqueriesInQuantifieds in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsTableCorrelationNames

public boolean supportsTableCorrelationNames()
                                      throws java.sql.SQLException

Checks whether metamatrix supports table correlation names

Specified by:
supportsTableCorrelationNames in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsTransactionIsolationLevel

public boolean supportsTransactionIsolationLevel(int level)
                                          throws java.sql.SQLException

Checks whether metamatrix supports the given transaction isolation level

Specified by:
supportsTransactionIsolationLevel in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsTransactions

public boolean supportsTransactions()
                             throws java.sql.SQLException

Checks whether metamatrix supports transactions

Specified by:
supportsTransactions in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsUnion

public boolean supportsUnion()
                      throws java.sql.SQLException

Checks whether metamatrix supports SQL UNION

Specified by:
supportsUnion in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

supportsUnionAll

public boolean supportsUnionAll()
                         throws java.sql.SQLException

Checks whether metamatrix supports SQL UNION ALL

Specified by:
supportsUnionAll in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

updatesAreDetected

public boolean updatesAreDetected(int type)
                           throws java.sql.SQLException

Indicates whether or not a visible row update can be detected by calling the method ResultSet.rowUpdated.

Specified by:
updatesAreDetected in interface java.sql.DatabaseMetaData
Parameters:
result - set type, i.e. ResultSet.TYPE_XXX
Returns:
true if changes are detected by the result set type; false otherwise
Throws:
SQLException, - should never occur
java.sql.SQLException

usesLocalFilePerTable

public boolean usesLocalFilePerTable()
                              throws java.sql.SQLException

Checks whether metamatrix uses a separate local file to store each table

Specified by:
usesLocalFilePerTable in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

usesLocalFiles

public boolean usesLocalFiles()
                       throws java.sql.SQLException

Checks whether metamatrix stores tables in a local file

Specified by:
usesLocalFiles in interface java.sql.DatabaseMetaData
Returns:
if so return true, else false.
Throws:
SQLException, - should never occur.
java.sql.SQLException

getModels

public java.sql.ResultSet getModels(java.lang.String catalog,
                                    java.lang.String schemaPattern,
                                    java.lang.String modelNamePattern)
                             throws java.sql.SQLException
Gets a description of models available in a catalog.

Only model descriptions matching the catalog, schema, and model are returned. They are ordered by MODEL_NAME.

Each model description has the following columns:

  1. MODEL_CAT String => model catalog (may be null)
  2. MODEL_SCHEM String => model schema (may be null)
  3. MODEL_NAME String => model name
  4. DESCRIPTION String => explanatory comment on the model (may be null)
  5. IS_PHYSICAL Boolean => true if the model is a physical model
  6. SUP_WHERE_ALL Boolean => true if queries without a criteria are allowed
  7. SUP_DISTINCT Boolean => true if distinct clause can be used
  8. SUP_JOIN Boolean => true if joins are supported
  9. SUP_OUTER_JOIN Boolean => true if outer joins are supported
  10. SUP_ORDER_BY Boolean => true if order by is supported

Note: Some databases may not return information for all models.

Parameters:
catalog - a catalog name; "" retrieves those without a catalog; null means drop catalog name from the selection criteria
schemaPattern - a schema name pattern; "" retrieves those without a schema
modelNamePattern - a model name pattern
Returns:
ResultSet - each row is a model description
Throws:
java.sql.SQLException - if a database access error occurs

getXMLSchemas

public java.util.List getXMLSchemas(java.lang.String documentName)
                             throws java.sql.SQLException

This is a different method from #getSchemas(). It only extracts the XML schemas.

Parameters:
documentName - of the Group specified in the XML model
Returns:
a list of xml schemas
Throws:
SQLException - if a database access error occurs
java.sql.SQLException

autoCommitFailureClosesAllResultSets

public boolean autoCommitFailureClosesAllResultSets()
                                             throws java.sql.SQLException
Specified by:
autoCommitFailureClosesAllResultSets in interface java.sql.DatabaseMetaData
Throws:
java.sql.SQLException

getResultSetHoldability

public int getResultSetHoldability()
                            throws java.sql.SQLException
Specified by:
getResultSetHoldability in interface java.sql.DatabaseMetaData
Throws:
java.sql.SQLException

getConnection

public java.sql.Connection getConnection()
                                  throws java.sql.SQLException
Specified by:
getConnection in interface java.sql.DatabaseMetaData
Throws:
java.sql.SQLException

supportsStoredFunctionsUsingCallSyntax

public boolean supportsStoredFunctionsUsingCallSyntax()
                                               throws java.sql.SQLException
Specified by:
supportsStoredFunctionsUsingCallSyntax in interface java.sql.DatabaseMetaData
Throws:
java.sql.SQLException

getAttributes

public java.sql.ResultSet getAttributes(java.lang.String catalog,
                                        java.lang.String schemaPattern,
                                        java.lang.String typeNamePattern,
                                        java.lang.String attributeNamePattern)
                                 throws java.sql.SQLException
Specified by:
getAttributes in interface java.sql.DatabaseMetaData
Throws:
java.sql.SQLException

getClientInfoProperties

public java.sql.ResultSet getClientInfoProperties()
                                           throws java.sql.SQLException
Specified by:
getClientInfoProperties in interface java.sql.DatabaseMetaData
Throws:
java.sql.SQLException

getFunctionColumns

public java.sql.ResultSet getFunctionColumns(java.lang.String catalog,
                                             java.lang.String schemaPattern,
                                             java.lang.String functionNamePattern,
                                             java.lang.String columnNamePattern)
                                      throws java.sql.SQLException
Specified by:
getFunctionColumns in interface java.sql.DatabaseMetaData
Throws:
java.sql.SQLException

getFunctions

public java.sql.ResultSet getFunctions(java.lang.String catalog,
                                       java.lang.String schemaPattern,
                                       java.lang.String functionNamePattern)
                                throws java.sql.SQLException
Specified by:
getFunctions in interface java.sql.DatabaseMetaData
Throws:
java.sql.SQLException

getRowIdLifetime

public java.sql.RowIdLifetime getRowIdLifetime()
                                        throws java.sql.SQLException
Specified by:
getRowIdLifetime in interface java.sql.DatabaseMetaData
Throws:
java.sql.SQLException

getSchemas

public java.sql.ResultSet getSchemas(java.lang.String catalog,
                                     java.lang.String schemaPattern)
                              throws java.sql.SQLException
Specified by:
getSchemas in interface java.sql.DatabaseMetaData
Throws:
java.sql.SQLException
Overview  Package   Class  Use  Tree  Deprecated  Index  Help 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD
Copyright © 2009. All Rights Reserved.