Class PgDatabaseMetaData
- java.lang.Object
-
- org.postgresql.jdbc.PgDatabaseMetaData
-
- All Implemented Interfaces:
DatabaseMetaData
,Wrapper
public class PgDatabaseMetaData extends Object implements DatabaseMetaData
-
-
Field Summary
Fields Modifier and Type Field Description protected PgConnection
connection
-
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
-
-
Constructor Summary
Constructors Constructor Description PgDatabaseMetaData(PgConnection conn)
-
Method Summary
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface java.sql.DatabaseMetaData
supportsSharding
-
-
-
-
Field Detail
-
connection
protected final PgConnection connection
-
-
Constructor Detail
-
PgDatabaseMetaData
public PgDatabaseMetaData(PgConnection conn)
-
-
Method Detail
-
getMaxIndexKeys
protected int getMaxIndexKeys() throws SQLException
- Throws:
SQLException
-
getMaxNameLength
protected int getMaxNameLength() throws SQLException
- Throws:
SQLException
-
allProceduresAreCallable
public boolean allProceduresAreCallable() throws SQLException
- Specified by:
allProceduresAreCallable
in interfaceDatabaseMetaData
- Throws:
SQLException
-
allTablesAreSelectable
public boolean allTablesAreSelectable() throws SQLException
- Specified by:
allTablesAreSelectable
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getURL
public String getURL() throws SQLException
- Specified by:
getURL
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getUserName
public String getUserName() throws SQLException
- Specified by:
getUserName
in interfaceDatabaseMetaData
- Throws:
SQLException
-
isReadOnly
public boolean isReadOnly() throws SQLException
- Specified by:
isReadOnly
in interfaceDatabaseMetaData
- Throws:
SQLException
-
nullsAreSortedHigh
public boolean nullsAreSortedHigh() throws SQLException
- Specified by:
nullsAreSortedHigh
in interfaceDatabaseMetaData
- Throws:
SQLException
-
nullsAreSortedLow
public boolean nullsAreSortedLow() throws SQLException
- Specified by:
nullsAreSortedLow
in interfaceDatabaseMetaData
- Throws:
SQLException
-
nullsAreSortedAtStart
public boolean nullsAreSortedAtStart() throws SQLException
- Specified by:
nullsAreSortedAtStart
in interfaceDatabaseMetaData
- Throws:
SQLException
-
nullsAreSortedAtEnd
public boolean nullsAreSortedAtEnd() throws SQLException
- Specified by:
nullsAreSortedAtEnd
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getDatabaseProductName
public String getDatabaseProductName() throws SQLException
Retrieves the name of this database product. We hope that it is PostgreSQL, so we return that explicitly.- Specified by:
getDatabaseProductName
in interfaceDatabaseMetaData
- Returns:
- "PostgreSQL"
- Throws:
SQLException
-
getDatabaseProductVersion
public String getDatabaseProductVersion() throws SQLException
- Specified by:
getDatabaseProductVersion
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getDriverName
public String getDriverName()
- Specified by:
getDriverName
in interfaceDatabaseMetaData
-
getDriverVersion
public String getDriverVersion()
- Specified by:
getDriverVersion
in interfaceDatabaseMetaData
-
getDriverMajorVersion
public int getDriverMajorVersion()
- Specified by:
getDriverMajorVersion
in interfaceDatabaseMetaData
-
getDriverMinorVersion
public int getDriverMinorVersion()
- Specified by:
getDriverMinorVersion
in interfaceDatabaseMetaData
-
usesLocalFiles
public boolean usesLocalFiles() throws SQLException
Does the database store tables in a local file? No - it stores them in a file on the server.- Specified by:
usesLocalFiles
in interfaceDatabaseMetaData
- Returns:
- true if so
- Throws:
SQLException
- if a database access error occurs
-
usesLocalFilePerTable
public boolean usesLocalFilePerTable() throws SQLException
Does the database use a file for each table? Well, not really, since it doesn't use local files.- Specified by:
usesLocalFilePerTable
in interfaceDatabaseMetaData
- Returns:
- true if so
- Throws:
SQLException
- if a database access error occurs
-
supportsMixedCaseIdentifiers
public boolean supportsMixedCaseIdentifiers() throws SQLException
Does the database treat mixed case unquoted SQL identifiers as case sensitive and as a result store them in mixed case? A JDBC-Compliant driver will always return false.- Specified by:
supportsMixedCaseIdentifiers
in interfaceDatabaseMetaData
- Returns:
- true if so
- Throws:
SQLException
- if a database access error occurs
-
storesUpperCaseIdentifiers
public boolean storesUpperCaseIdentifiers() throws SQLException
- Specified by:
storesUpperCaseIdentifiers
in interfaceDatabaseMetaData
- Throws:
SQLException
-
storesLowerCaseIdentifiers
public boolean storesLowerCaseIdentifiers() throws SQLException
- Specified by:
storesLowerCaseIdentifiers
in interfaceDatabaseMetaData
- Throws:
SQLException
-
storesMixedCaseIdentifiers
public boolean storesMixedCaseIdentifiers() throws SQLException
- Specified by:
storesMixedCaseIdentifiers
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsMixedCaseQuotedIdentifiers
public boolean supportsMixedCaseQuotedIdentifiers() throws SQLException
Does the database treat mixed case quoted SQL identifiers as case sensitive and as a result store them in mixed case? A JDBC compliant driver will always return true.- Specified by:
supportsMixedCaseQuotedIdentifiers
in interfaceDatabaseMetaData
- Returns:
- true if so
- Throws:
SQLException
- if a database access error occurs
-
storesUpperCaseQuotedIdentifiers
public boolean storesUpperCaseQuotedIdentifiers() throws SQLException
- Specified by:
storesUpperCaseQuotedIdentifiers
in interfaceDatabaseMetaData
- Throws:
SQLException
-
storesLowerCaseQuotedIdentifiers
public boolean storesLowerCaseQuotedIdentifiers() throws SQLException
- Specified by:
storesLowerCaseQuotedIdentifiers
in interfaceDatabaseMetaData
- Throws:
SQLException
-
storesMixedCaseQuotedIdentifiers
public boolean storesMixedCaseQuotedIdentifiers() throws SQLException
- Specified by:
storesMixedCaseQuotedIdentifiers
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getIdentifierQuoteString
public String getIdentifierQuoteString() throws SQLException
What is the string used to quote SQL identifiers? This returns a space if identifier quoting isn't supported. A JDBC Compliant driver will always use a double quote character.- Specified by:
getIdentifierQuoteString
in interfaceDatabaseMetaData
- Returns:
- the quoting string
- Throws:
SQLException
- if a database access error occurs
-
getSQLKeywords
public String getSQLKeywords() throws SQLException
From PostgreSQL 9.0+ return the keywords from pg_catalog.pg_get_keywords()
- Specified by:
getSQLKeywords
in interfaceDatabaseMetaData
- Returns:
- a comma separated list of keywords we use
- Throws:
SQLException
- if a database access error occurs
-
getNumericFunctions
public String getNumericFunctions() throws SQLException
- Specified by:
getNumericFunctions
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getStringFunctions
public String getStringFunctions() throws SQLException
- Specified by:
getStringFunctions
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getSystemFunctions
public String getSystemFunctions() throws SQLException
- Specified by:
getSystemFunctions
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getTimeDateFunctions
public String getTimeDateFunctions() throws SQLException
- Specified by:
getTimeDateFunctions
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getSearchStringEscape
public String getSearchStringEscape() throws SQLException
- Specified by:
getSearchStringEscape
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getExtraNameCharacters
public String getExtraNameCharacters() throws SQLException
Postgresql allows any high-bit character to be used in an unquoted identifier, so we can't possibly list them all.
From the file src/backend/parser/scan.l, an identifier is ident_start [A-Za-z\200-\377_] ident_cont [A-Za-z\200-\377_0-9\$] identifier {ident_start}{ident_cont}*
- Specified by:
getExtraNameCharacters
in interfaceDatabaseMetaData
- Returns:
- a string containing the extra characters
- Throws:
SQLException
- if a database access error occurs
-
supportsAlterTableWithAddColumn
public boolean supportsAlterTableWithAddColumn() throws SQLException
- Specified by:
supportsAlterTableWithAddColumn
in interfaceDatabaseMetaData
- Returns:
- true if connected to PostgreSQL 6.1+
- Throws:
SQLException
-
supportsAlterTableWithDropColumn
public boolean supportsAlterTableWithDropColumn() throws SQLException
- Specified by:
supportsAlterTableWithDropColumn
in interfaceDatabaseMetaData
- Returns:
- true if connected to PostgreSQL 7.3+
- Throws:
SQLException
-
supportsColumnAliasing
public boolean supportsColumnAliasing() throws SQLException
- Specified by:
supportsColumnAliasing
in interfaceDatabaseMetaData
- Throws:
SQLException
-
nullPlusNonNullIsNull
public boolean nullPlusNonNullIsNull() throws SQLException
- Specified by:
nullPlusNonNullIsNull
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsConvert
public boolean supportsConvert() throws SQLException
- Specified by:
supportsConvert
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsConvert
public boolean supportsConvert(int fromType, int toType) throws SQLException
- Specified by:
supportsConvert
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsTableCorrelationNames
public boolean supportsTableCorrelationNames() throws SQLException
- Specified by:
supportsTableCorrelationNames
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsDifferentTableCorrelationNames
public boolean supportsDifferentTableCorrelationNames() throws SQLException
- Specified by:
supportsDifferentTableCorrelationNames
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsExpressionsInOrderBy
public boolean supportsExpressionsInOrderBy() throws SQLException
- Specified by:
supportsExpressionsInOrderBy
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsOrderByUnrelated
public boolean supportsOrderByUnrelated() throws SQLException
- Specified by:
supportsOrderByUnrelated
in interfaceDatabaseMetaData
- Returns:
- true if connected to PostgreSQL 6.4+
- Throws:
SQLException
-
supportsGroupBy
public boolean supportsGroupBy() throws SQLException
- Specified by:
supportsGroupBy
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsGroupByUnrelated
public boolean supportsGroupByUnrelated() throws SQLException
- Specified by:
supportsGroupByUnrelated
in interfaceDatabaseMetaData
- Returns:
- true if connected to PostgreSQL 6.4+
- Throws:
SQLException
-
supportsGroupByBeyondSelect
public boolean supportsGroupByBeyondSelect() throws SQLException
- Specified by:
supportsGroupByBeyondSelect
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsLikeEscapeClause
public boolean supportsLikeEscapeClause() throws SQLException
- Specified by:
supportsLikeEscapeClause
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsMultipleResultSets
public boolean supportsMultipleResultSets() throws SQLException
- Specified by:
supportsMultipleResultSets
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsMultipleTransactions
public boolean supportsMultipleTransactions() throws SQLException
- Specified by:
supportsMultipleTransactions
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsNonNullableColumns
public boolean supportsNonNullableColumns() throws SQLException
- Specified by:
supportsNonNullableColumns
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsMinimumSQLGrammar
public boolean supportsMinimumSQLGrammar() throws SQLException
This grammar is defined at: http://www.microsoft.com/msdn/sdk/platforms/doc/odbc/src/intropr.htm
In Appendix C. From this description, we seem to support the ODBC minimal (Level 0) grammar.
- Specified by:
supportsMinimumSQLGrammar
in interfaceDatabaseMetaData
- Returns:
- true
- Throws:
SQLException
-
supportsCoreSQLGrammar
public boolean supportsCoreSQLGrammar() throws SQLException
Does this driver support the Core ODBC SQL grammar. We need SQL-92 conformance for this.- Specified by:
supportsCoreSQLGrammar
in interfaceDatabaseMetaData
- Returns:
- false
- Throws:
SQLException
- if a database access error occurs
-
supportsExtendedSQLGrammar
public boolean supportsExtendedSQLGrammar() throws SQLException
Does this driver support the Extended (Level 2) ODBC SQL grammar. We don't conform to the Core (Level 1), so we can't conform to the Extended SQL Grammar.- Specified by:
supportsExtendedSQLGrammar
in interfaceDatabaseMetaData
- Returns:
- false
- Throws:
SQLException
- if a database access error occurs
-
supportsANSI92EntryLevelSQL
public boolean supportsANSI92EntryLevelSQL() throws SQLException
Does this driver support the ANSI-92 entry level SQL grammar? All JDBC Compliant drivers must return true. We currently report false until 'schema' support is added. Then this should be changed to return true, since we will be mostly compliant (probably more compliant than many other databases) And since this is a requirement for all JDBC drivers we need to get to the point where we can return true.- Specified by:
supportsANSI92EntryLevelSQL
in interfaceDatabaseMetaData
- Returns:
- true if connected to PostgreSQL 7.3+
- Throws:
SQLException
- if a database access error occurs
-
supportsANSI92IntermediateSQL
public boolean supportsANSI92IntermediateSQL() throws SQLException
- Specified by:
supportsANSI92IntermediateSQL
in interfaceDatabaseMetaData
- Returns:
- false
- Throws:
SQLException
-
supportsANSI92FullSQL
public boolean supportsANSI92FullSQL() throws SQLException
- Specified by:
supportsANSI92FullSQL
in interfaceDatabaseMetaData
- Returns:
- false
- Throws:
SQLException
-
supportsIntegrityEnhancementFacility
public boolean supportsIntegrityEnhancementFacility() throws SQLException
- Specified by:
supportsIntegrityEnhancementFacility
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsOuterJoins
public boolean supportsOuterJoins() throws SQLException
- Specified by:
supportsOuterJoins
in interfaceDatabaseMetaData
- Returns:
- true if connected to PostgreSQL 7.1+
- Throws:
SQLException
-
supportsFullOuterJoins
public boolean supportsFullOuterJoins() throws SQLException
- Specified by:
supportsFullOuterJoins
in interfaceDatabaseMetaData
- Returns:
- true if connected to PostgreSQL 7.1+
- Throws:
SQLException
-
supportsLimitedOuterJoins
public boolean supportsLimitedOuterJoins() throws SQLException
- Specified by:
supportsLimitedOuterJoins
in interfaceDatabaseMetaData
- Returns:
- true if connected to PostgreSQL 7.1+
- Throws:
SQLException
-
getSchemaTerm
public String getSchemaTerm() throws SQLException
PostgreSQL doesn't have schemas, but when it does, we'll use the term "schema".
- Specified by:
getSchemaTerm
in interfaceDatabaseMetaData
- Returns:
"schema"
- Throws:
SQLException
-
getProcedureTerm
public String getProcedureTerm() throws SQLException
- Specified by:
getProcedureTerm
in interfaceDatabaseMetaData
- Returns:
"function"
- Throws:
SQLException
-
getCatalogTerm
public String getCatalogTerm() throws SQLException
- Specified by:
getCatalogTerm
in interfaceDatabaseMetaData
- Returns:
"database"
- Throws:
SQLException
-
isCatalogAtStart
public boolean isCatalogAtStart() throws SQLException
- Specified by:
isCatalogAtStart
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getCatalogSeparator
public String getCatalogSeparator() throws SQLException
- Specified by:
getCatalogSeparator
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsSchemasInDataManipulation
public boolean supportsSchemasInDataManipulation() throws SQLException
- Specified by:
supportsSchemasInDataManipulation
in interfaceDatabaseMetaData
- Returns:
- true if connected to PostgreSQL 7.3+
- Throws:
SQLException
-
supportsSchemasInProcedureCalls
public boolean supportsSchemasInProcedureCalls() throws SQLException
- Specified by:
supportsSchemasInProcedureCalls
in interfaceDatabaseMetaData
- Returns:
- true if connected to PostgreSQL 7.3+
- Throws:
SQLException
-
supportsSchemasInTableDefinitions
public boolean supportsSchemasInTableDefinitions() throws SQLException
- Specified by:
supportsSchemasInTableDefinitions
in interfaceDatabaseMetaData
- Returns:
- true if connected to PostgreSQL 7.3+
- Throws:
SQLException
-
supportsSchemasInIndexDefinitions
public boolean supportsSchemasInIndexDefinitions() throws SQLException
- Specified by:
supportsSchemasInIndexDefinitions
in interfaceDatabaseMetaData
- Returns:
- true if connected to PostgreSQL 7.3+
- Throws:
SQLException
-
supportsSchemasInPrivilegeDefinitions
public boolean supportsSchemasInPrivilegeDefinitions() throws SQLException
- Specified by:
supportsSchemasInPrivilegeDefinitions
in interfaceDatabaseMetaData
- Returns:
- true if connected to PostgreSQL 7.3+
- Throws:
SQLException
-
supportsCatalogsInDataManipulation
public boolean supportsCatalogsInDataManipulation() throws SQLException
- Specified by:
supportsCatalogsInDataManipulation
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsCatalogsInProcedureCalls
public boolean supportsCatalogsInProcedureCalls() throws SQLException
- Specified by:
supportsCatalogsInProcedureCalls
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsCatalogsInTableDefinitions
public boolean supportsCatalogsInTableDefinitions() throws SQLException
- Specified by:
supportsCatalogsInTableDefinitions
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsCatalogsInIndexDefinitions
public boolean supportsCatalogsInIndexDefinitions() throws SQLException
- Specified by:
supportsCatalogsInIndexDefinitions
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsCatalogsInPrivilegeDefinitions
public boolean supportsCatalogsInPrivilegeDefinitions() throws SQLException
- Specified by:
supportsCatalogsInPrivilegeDefinitions
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsPositionedDelete
public boolean supportsPositionedDelete() throws SQLException
We support cursors for gets only it seems. I dont see a method to get a positioned delete.- Specified by:
supportsPositionedDelete
in interfaceDatabaseMetaData
- Returns:
- false
- Throws:
SQLException
- if a database access error occurs
-
supportsPositionedUpdate
public boolean supportsPositionedUpdate() throws SQLException
- Specified by:
supportsPositionedUpdate
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsSelectForUpdate
public boolean supportsSelectForUpdate() throws SQLException
- Specified by:
supportsSelectForUpdate
in interfaceDatabaseMetaData
- Returns:
- true if connected to PostgreSQL 6.5+
- Throws:
SQLException
-
supportsStoredProcedures
public boolean supportsStoredProcedures() throws SQLException
- Specified by:
supportsStoredProcedures
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsSubqueriesInComparisons
public boolean supportsSubqueriesInComparisons() throws SQLException
- Specified by:
supportsSubqueriesInComparisons
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsSubqueriesInExists
public boolean supportsSubqueriesInExists() throws SQLException
- Specified by:
supportsSubqueriesInExists
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsSubqueriesInIns
public boolean supportsSubqueriesInIns() throws SQLException
- Specified by:
supportsSubqueriesInIns
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsSubqueriesInQuantifieds
public boolean supportsSubqueriesInQuantifieds() throws SQLException
- Specified by:
supportsSubqueriesInQuantifieds
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsCorrelatedSubqueries
public boolean supportsCorrelatedSubqueries() throws SQLException
- Specified by:
supportsCorrelatedSubqueries
in interfaceDatabaseMetaData
- Returns:
- true if connected to PostgreSQL 7.1+
- Throws:
SQLException
-
supportsUnion
public boolean supportsUnion() throws SQLException
- Specified by:
supportsUnion
in interfaceDatabaseMetaData
- Returns:
- true if connected to PostgreSQL 6.3+
- Throws:
SQLException
-
supportsUnionAll
public boolean supportsUnionAll() throws SQLException
- Specified by:
supportsUnionAll
in interfaceDatabaseMetaData
- Returns:
- true if connected to PostgreSQL 7.1+
- Throws:
SQLException
-
supportsOpenCursorsAcrossCommit
public boolean supportsOpenCursorsAcrossCommit() throws SQLException
In PostgreSQL, Cursors are only open within transactions.- Specified by:
supportsOpenCursorsAcrossCommit
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsOpenCursorsAcrossRollback
public boolean supportsOpenCursorsAcrossRollback() throws SQLException
- Specified by:
supportsOpenCursorsAcrossRollback
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsOpenStatementsAcrossCommit
public boolean supportsOpenStatementsAcrossCommit() throws SQLException
Can statements remain open across commits? They may, but this driver cannot guarantee that. In further reflection. we are talking a Statement object here, so the answer is yes, since the Statement is only a vehicle to ExecSQL()
- Specified by:
supportsOpenStatementsAcrossCommit
in interfaceDatabaseMetaData
- Returns:
- true
- Throws:
SQLException
-
supportsOpenStatementsAcrossRollback
public boolean supportsOpenStatementsAcrossRollback() throws SQLException
Can statements remain open across rollbacks? They may, but this driver cannot guarantee that. In further contemplation, we are talking a Statement object here, so the answer is yes, since the Statement is only a vehicle to ExecSQL() in Connection
- Specified by:
supportsOpenStatementsAcrossRollback
in interfaceDatabaseMetaData
- Returns:
- true
- Throws:
SQLException
-
getMaxCharLiteralLength
public int getMaxCharLiteralLength() throws SQLException
- Specified by:
getMaxCharLiteralLength
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getMaxBinaryLiteralLength
public int getMaxBinaryLiteralLength() throws SQLException
- Specified by:
getMaxBinaryLiteralLength
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getMaxColumnNameLength
public int getMaxColumnNameLength() throws SQLException
- Specified by:
getMaxColumnNameLength
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getMaxColumnsInGroupBy
public int getMaxColumnsInGroupBy() throws SQLException
- Specified by:
getMaxColumnsInGroupBy
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getMaxColumnsInIndex
public int getMaxColumnsInIndex() throws SQLException
- Specified by:
getMaxColumnsInIndex
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getMaxColumnsInOrderBy
public int getMaxColumnsInOrderBy() throws SQLException
- Specified by:
getMaxColumnsInOrderBy
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getMaxColumnsInSelect
public int getMaxColumnsInSelect() throws SQLException
- Specified by:
getMaxColumnsInSelect
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getMaxColumnsInTable
public int getMaxColumnsInTable() throws SQLException
What is the maximum number of columns in a table? From the CREATE TABLE reference page..."The new class is created as a heap with no initial data. A class can have no more than 1600 attributes (realistically, this is limited by the fact that tuple sizes must be less than 8192 bytes)..."
- Specified by:
getMaxColumnsInTable
in interfaceDatabaseMetaData
- Returns:
- the max columns
- Throws:
SQLException
- if a database access error occurs
-
getMaxConnections
public int getMaxConnections() throws SQLException
How many active connection can we have at a time to this database? Well, since it depends on postmaster, which just does a listen() followed by an accept() and fork(), its basically very high. Unless the system runs out of processes, it can be 65535 (the number of aux. ports on a TCP/IP system). I will return 8192 since that is what even the largest system can realistically handle,- Specified by:
getMaxConnections
in interfaceDatabaseMetaData
- Returns:
- the maximum number of connections
- Throws:
SQLException
- if a database access error occurs
-
getMaxCursorNameLength
public int getMaxCursorNameLength() throws SQLException
- Specified by:
getMaxCursorNameLength
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getMaxIndexLength
public int getMaxIndexLength() throws SQLException
- Specified by:
getMaxIndexLength
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getMaxSchemaNameLength
public int getMaxSchemaNameLength() throws SQLException
- Specified by:
getMaxSchemaNameLength
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getMaxProcedureNameLength
public int getMaxProcedureNameLength() throws SQLException
- Specified by:
getMaxProcedureNameLength
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getMaxCatalogNameLength
public int getMaxCatalogNameLength() throws SQLException
- Specified by:
getMaxCatalogNameLength
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getMaxRowSize
public int getMaxRowSize() throws SQLException
- Specified by:
getMaxRowSize
in interfaceDatabaseMetaData
- Throws:
SQLException
-
doesMaxRowSizeIncludeBlobs
public boolean doesMaxRowSizeIncludeBlobs() throws SQLException
- Specified by:
doesMaxRowSizeIncludeBlobs
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getMaxStatementLength
public int getMaxStatementLength() throws SQLException
- Specified by:
getMaxStatementLength
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getMaxStatements
public int getMaxStatements() throws SQLException
- Specified by:
getMaxStatements
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getMaxTableNameLength
public int getMaxTableNameLength() throws SQLException
- Specified by:
getMaxTableNameLength
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getMaxTablesInSelect
public int getMaxTablesInSelect() throws SQLException
- Specified by:
getMaxTablesInSelect
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getMaxUserNameLength
public int getMaxUserNameLength() throws SQLException
- Specified by:
getMaxUserNameLength
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getDefaultTransactionIsolation
public int getDefaultTransactionIsolation() throws SQLException
- Specified by:
getDefaultTransactionIsolation
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsTransactions
public boolean supportsTransactions() throws SQLException
- Specified by:
supportsTransactions
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsTransactionIsolationLevel
public boolean supportsTransactionIsolationLevel(int level) throws SQLException
We only support TRANSACTION_SERIALIZABLE and TRANSACTION_READ_COMMITTED before 8.0; from 8.0 READ_UNCOMMITTED and REPEATABLE_READ are accepted aliases for READ_COMMITTED.
- Specified by:
supportsTransactionIsolationLevel
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsDataDefinitionAndDataManipulationTransactions
public boolean supportsDataDefinitionAndDataManipulationTransactions() throws SQLException
- Specified by:
supportsDataDefinitionAndDataManipulationTransactions
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsDataManipulationTransactionsOnly
public boolean supportsDataManipulationTransactionsOnly() throws SQLException
- Specified by:
supportsDataManipulationTransactionsOnly
in interfaceDatabaseMetaData
- Throws:
SQLException
-
dataDefinitionCausesTransactionCommit
public boolean dataDefinitionCausesTransactionCommit() throws SQLException
Does a data definition statement within a transaction force the transaction to commit? It seems to mean something like:
CREATE TABLE T (A INT); INSERT INTO T (A) VALUES (2); BEGIN; UPDATE T SET A = A + 1; CREATE TABLE X (A INT); SELECT A FROM T INTO X; COMMIT;
Does the CREATE TABLE call cause a commit? The answer is no.
- Specified by:
dataDefinitionCausesTransactionCommit
in interfaceDatabaseMetaData
- Returns:
- true if so
- Throws:
SQLException
- if a database access error occurs
-
dataDefinitionIgnoredInTransactions
public boolean dataDefinitionIgnoredInTransactions() throws SQLException
- Specified by:
dataDefinitionIgnoredInTransactions
in interfaceDatabaseMetaData
- Throws:
SQLException
-
escapeQuotes
protected String escapeQuotes(String s) throws SQLException
Turn the provided value into a valid string literal for direct inclusion into a query. This includes the single quotes needed around it.- Parameters:
s
- input value- Returns:
- string literal for direct inclusion into a query
- Throws:
SQLException
- if something wrong happens
-
getProcedures
public ResultSet getProcedures(String catalog, String schemaPattern, String procedureNamePattern) throws SQLException
- Specified by:
getProcedures
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getProcedureColumns
public ResultSet getProcedureColumns(String catalog, String schemaPattern, String procedureNamePattern, String columnNamePattern) throws SQLException
- Specified by:
getProcedureColumns
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getTables
public ResultSet getTables(String catalog, String schemaPattern, String tableNamePattern, String[] types) throws SQLException
- Specified by:
getTables
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getSchemas
public ResultSet getSchemas() throws SQLException
- Specified by:
getSchemas
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getSchemas
public ResultSet getSchemas(String catalog, String schemaPattern) throws SQLException
- Specified by:
getSchemas
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getCatalogs
public ResultSet getCatalogs() throws SQLException
PostgreSQL does not support multiple catalogs from a single connection, so to reduce confusion we only return the current catalog.- Specified by:
getCatalogs
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getTableTypes
public ResultSet getTableTypes() throws SQLException
- Specified by:
getTableTypes
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getColumns
public ResultSet getColumns(String catalog, String schemaPattern, String tableNamePattern, String columnNamePattern) throws SQLException
- Specified by:
getColumns
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getColumnPrivileges
public ResultSet getColumnPrivileges(String catalog, String schema, String table, String columnNamePattern) throws SQLException
- Specified by:
getColumnPrivileges
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getTablePrivileges
public ResultSet getTablePrivileges(String catalog, String schemaPattern, String tableNamePattern) throws SQLException
- Specified by:
getTablePrivileges
in interfaceDatabaseMetaData
- Throws:
SQLException
-
parseACL
public Map<String,Map<String,List<String[]>>> parseACL(String aclArray, String owner)
Take the a String representing an array of ACLs and return a Map mapping the SQL permission name to a List of usernames who have that permission. For instance:SELECT -> user1 -> list of [grantor, grantable]
- Parameters:
aclArray
- ACL arrayowner
- owner- Returns:
- a Map mapping the SQL permission name
-
getBestRowIdentifier
public ResultSet getBestRowIdentifier(String catalog, String schema, String table, int scope, boolean nullable) throws SQLException
- Specified by:
getBestRowIdentifier
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getVersionColumns
public ResultSet getVersionColumns(String catalog, String schema, String table) throws SQLException
- Specified by:
getVersionColumns
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getPrimaryKeys
public ResultSet getPrimaryKeys(String catalog, String schema, String table) throws SQLException
- Specified by:
getPrimaryKeys
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getImportedExportedKeys
protected ResultSet getImportedExportedKeys(String primaryCatalog, String primarySchema, String primaryTable, String foreignCatalog, String foreignSchema, String foreignTable) throws SQLException
- Parameters:
primaryCatalog
- primary catalogprimarySchema
- primary schemaprimaryTable
- if provided will get the keys exported by this tableforeignCatalog
- foreign catalogforeignSchema
- foreign schemaforeignTable
- if provided will get the keys imported by this table- Returns:
- ResultSet
- Throws:
SQLException
- if something wrong happens
-
getImportedKeys
public ResultSet getImportedKeys(String catalog, String schema, String table) throws SQLException
- Specified by:
getImportedKeys
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getExportedKeys
public ResultSet getExportedKeys(String catalog, String schema, String table) throws SQLException
- Specified by:
getExportedKeys
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getCrossReference
public ResultSet getCrossReference(String primaryCatalog, String primarySchema, String primaryTable, String foreignCatalog, String foreignSchema, String foreignTable) throws SQLException
- Specified by:
getCrossReference
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getTypeInfo
public ResultSet getTypeInfo() throws SQLException
- Specified by:
getTypeInfo
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getIndexInfo
public ResultSet getIndexInfo(String catalog, String schema, String tableName, boolean unique, boolean approximate) throws SQLException
- Specified by:
getIndexInfo
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsResultSetType
public boolean supportsResultSetType(int type) throws SQLException
- Specified by:
supportsResultSetType
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsResultSetConcurrency
public boolean supportsResultSetConcurrency(int type, int concurrency) throws SQLException
- Specified by:
supportsResultSetConcurrency
in interfaceDatabaseMetaData
- Throws:
SQLException
-
ownUpdatesAreVisible
public boolean ownUpdatesAreVisible(int type) throws SQLException
- Specified by:
ownUpdatesAreVisible
in interfaceDatabaseMetaData
- Throws:
SQLException
-
ownDeletesAreVisible
public boolean ownDeletesAreVisible(int type) throws SQLException
- Specified by:
ownDeletesAreVisible
in interfaceDatabaseMetaData
- Throws:
SQLException
-
ownInsertsAreVisible
public boolean ownInsertsAreVisible(int type) throws SQLException
- Specified by:
ownInsertsAreVisible
in interfaceDatabaseMetaData
- Throws:
SQLException
-
othersUpdatesAreVisible
public boolean othersUpdatesAreVisible(int type) throws SQLException
- Specified by:
othersUpdatesAreVisible
in interfaceDatabaseMetaData
- Throws:
SQLException
-
othersDeletesAreVisible
public boolean othersDeletesAreVisible(int i) throws SQLException
- Specified by:
othersDeletesAreVisible
in interfaceDatabaseMetaData
- Throws:
SQLException
-
othersInsertsAreVisible
public boolean othersInsertsAreVisible(int type) throws SQLException
- Specified by:
othersInsertsAreVisible
in interfaceDatabaseMetaData
- Throws:
SQLException
-
updatesAreDetected
public boolean updatesAreDetected(int type) throws SQLException
- Specified by:
updatesAreDetected
in interfaceDatabaseMetaData
- Throws:
SQLException
-
deletesAreDetected
public boolean deletesAreDetected(int i) throws SQLException
- Specified by:
deletesAreDetected
in interfaceDatabaseMetaData
- Throws:
SQLException
-
insertsAreDetected
public boolean insertsAreDetected(int type) throws SQLException
- Specified by:
insertsAreDetected
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsBatchUpdates
public boolean supportsBatchUpdates() throws SQLException
- Specified by:
supportsBatchUpdates
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getUDTs
public ResultSet getUDTs(String catalog, String schemaPattern, String typeNamePattern, int[] types) throws SQLException
- Specified by:
getUDTs
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getConnection
public Connection getConnection() throws SQLException
- Specified by:
getConnection
in interfaceDatabaseMetaData
- Throws:
SQLException
-
createMetaDataStatement
protected Statement createMetaDataStatement() throws SQLException
- Throws:
SQLException
-
getMaxLogicalLobSize
public long getMaxLogicalLobSize() throws SQLException
- Specified by:
getMaxLogicalLobSize
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsRefCursors
public boolean supportsRefCursors() throws SQLException
- Specified by:
supportsRefCursors
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getRowIdLifetime
public RowIdLifetime getRowIdLifetime() throws SQLException
- Specified by:
getRowIdLifetime
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsStoredFunctionsUsingCallSyntax
public boolean supportsStoredFunctionsUsingCallSyntax() throws SQLException
- Specified by:
supportsStoredFunctionsUsingCallSyntax
in interfaceDatabaseMetaData
- Throws:
SQLException
-
autoCommitFailureClosesAllResultSets
public boolean autoCommitFailureClosesAllResultSets() throws SQLException
- Specified by:
autoCommitFailureClosesAllResultSets
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getClientInfoProperties
public ResultSet getClientInfoProperties() throws SQLException
- Specified by:
getClientInfoProperties
in interfaceDatabaseMetaData
- Throws:
SQLException
-
isWrapperFor
public boolean isWrapperFor(Class<?> iface) throws SQLException
- Specified by:
isWrapperFor
in interfaceWrapper
- Throws:
SQLException
-
unwrap
public <T> T unwrap(Class<T> iface) throws SQLException
- Specified by:
unwrap
in interfaceWrapper
- Throws:
SQLException
-
getFunctions
public ResultSet getFunctions(String catalog, String schemaPattern, String functionNamePattern) throws SQLException
- Specified by:
getFunctions
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getFunctionColumns
public ResultSet getFunctionColumns(String catalog, String schemaPattern, String functionNamePattern, String columnNamePattern) throws SQLException
- Specified by:
getFunctionColumns
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getPseudoColumns
public ResultSet getPseudoColumns(String catalog, String schemaPattern, String tableNamePattern, String columnNamePattern) throws SQLException
- Specified by:
getPseudoColumns
in interfaceDatabaseMetaData
- Throws:
SQLException
-
generatedKeyAlwaysReturned
public boolean generatedKeyAlwaysReturned() throws SQLException
- Specified by:
generatedKeyAlwaysReturned
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsSavepoints
public boolean supportsSavepoints() throws SQLException
- Specified by:
supportsSavepoints
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsNamedParameters
public boolean supportsNamedParameters() throws SQLException
- Specified by:
supportsNamedParameters
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsMultipleOpenResults
public boolean supportsMultipleOpenResults() throws SQLException
- Specified by:
supportsMultipleOpenResults
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsGetGeneratedKeys
public boolean supportsGetGeneratedKeys() throws SQLException
- Specified by:
supportsGetGeneratedKeys
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getSuperTypes
public ResultSet getSuperTypes(String catalog, String schemaPattern, String typeNamePattern) throws SQLException
- Specified by:
getSuperTypes
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getSuperTables
public ResultSet getSuperTables(String catalog, String schemaPattern, String tableNamePattern) throws SQLException
- Specified by:
getSuperTables
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getAttributes
public ResultSet getAttributes(String catalog, String schemaPattern, String typeNamePattern, String attributeNamePattern) throws SQLException
- Specified by:
getAttributes
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsResultSetHoldability
public boolean supportsResultSetHoldability(int holdability) throws SQLException
- Specified by:
supportsResultSetHoldability
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getResultSetHoldability
public int getResultSetHoldability() throws SQLException
- Specified by:
getResultSetHoldability
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getDatabaseMajorVersion
public int getDatabaseMajorVersion() throws SQLException
- Specified by:
getDatabaseMajorVersion
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getDatabaseMinorVersion
public int getDatabaseMinorVersion() throws SQLException
- Specified by:
getDatabaseMinorVersion
in interfaceDatabaseMetaData
- Throws:
SQLException
-
getJDBCMajorVersion
public int getJDBCMajorVersion()
- Specified by:
getJDBCMajorVersion
in interfaceDatabaseMetaData
-
getJDBCMinorVersion
public int getJDBCMinorVersion()
- Specified by:
getJDBCMinorVersion
in interfaceDatabaseMetaData
-
getSQLStateType
public int getSQLStateType() throws SQLException
- Specified by:
getSQLStateType
in interfaceDatabaseMetaData
- Throws:
SQLException
-
locatorsUpdateCopy
public boolean locatorsUpdateCopy() throws SQLException
- Specified by:
locatorsUpdateCopy
in interfaceDatabaseMetaData
- Throws:
SQLException
-
supportsStatementPooling
public boolean supportsStatementPooling() throws SQLException
- Specified by:
supportsStatementPooling
in interfaceDatabaseMetaData
- Throws:
SQLException
-
-