All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.postgresql.jdbc.PgDatabaseMetaData Maven / Gradle / Ivy

There is a newer version: 42.7.3
Show newest version
/*-------------------------------------------------------------------------
*
* Copyright (c) 2004-2015, PostgreSQL Global Development Group
*
*
*-------------------------------------------------------------------------
*/
package org.postgresql.jdbc;

import java.sql.*;
import java.util.*;

import org.postgresql.core.*;
import org.postgresql.util.PSQLException;
import org.postgresql.util.PSQLState;
import org.postgresql.Driver;
import org.postgresql.util.GT;

public class PgDatabaseMetaData implements DatabaseMetaData
{

    public PgDatabaseMetaData(PgConnection conn)
    {
        this.connection = conn;
    }


    private static final String keywords = "abort,acl,add,aggregate,append,archive," +
                                           "arch_store,backward,binary,boolean,change,cluster," +
                                           "copy,database,delimiter,delimiters,do,extend," +
                                           "explain,forward,heavy,index,inherits,isnull," +
                                           "light,listen,load,merge,nothing,notify," +
                                           "notnull,oids,purge,rename,replace,retrieve," +
                                           "returns,rule,recipe,setof,stdin,stdout,store," +
                                           "vacuum,verbose,version";

    protected final PgConnection connection; // The connection association

    private int NAMEDATALEN = 0; // length for name datatype
    private int INDEX_MAX_KEYS = 0; // maximum number of keys in an index.

    protected int getMaxIndexKeys() throws SQLException {
        if (INDEX_MAX_KEYS == 0)
        {
            String sql;
            if (connection.haveMinimumServerVersion(ServerVersion.v8_0)) {
                sql = "SELECT setting FROM pg_catalog.pg_settings WHERE name='max_index_keys'";
            } else {
                String from;
                if (connection.haveMinimumServerVersion(ServerVersion.v7_3))
                {
                    from = "pg_catalog.pg_namespace n, pg_catalog.pg_type t1, pg_catalog.pg_type t2 WHERE t1.typnamespace=n.oid AND n.nspname='pg_catalog' AND ";
                }
                else
                {
                    from = "pg_type t1, pg_type t2 WHERE ";
                }
                sql = "SELECT t1.typlen/t2.typlen FROM " + from + " t1.typelem=t2.oid AND t1.typname='oidvector'";
            }
            Statement stmt = connection.createStatement();
            ResultSet rs = stmt.executeQuery(sql);
            if (!rs.next())
            {
                stmt.close();
                throw new PSQLException(GT.tr("Unable to determine a value for MaxIndexKeys due to missing system catalog data."), PSQLState.UNEXPECTED_ERROR);
            }
            INDEX_MAX_KEYS = rs.getInt(1);
            rs.close();
            stmt.close();
        }
        return INDEX_MAX_KEYS;
    }

    protected int getMaxNameLength() throws SQLException {
        if (NAMEDATALEN == 0)
        {
            String sql;
            if (connection.haveMinimumServerVersion(ServerVersion.v7_3))
            {
                sql = "SELECT t.typlen FROM pg_catalog.pg_type t, pg_catalog.pg_namespace n WHERE t.typnamespace=n.oid AND t.typname='name' AND n.nspname='pg_catalog'";
            }
            else
            {
                sql = "SELECT typlen FROM pg_type WHERE typname='name'";
            }
            Statement stmt = connection.createStatement();
            ResultSet rs = stmt.executeQuery(sql);
            if (!rs.next())
            {
                throw new PSQLException(GT.tr("Unable to find name datatype in the system catalogs."), PSQLState.UNEXPECTED_ERROR);
            }
            NAMEDATALEN = rs.getInt("typlen");
            rs.close();
            stmt.close();
        }
        return NAMEDATALEN - 1;
    }


    public boolean allProceduresAreCallable() throws SQLException
    {
        return true;  // For now...
    }

    public boolean allTablesAreSelectable() throws SQLException
    {
        return true;  // For now...
    }

    public String getURL() throws SQLException
    {
        return connection.getURL();
    }

    public String getUserName() throws SQLException
    {
        return connection.getUserName();
    }

    public boolean isReadOnly() throws SQLException
    {
        return connection.isReadOnly();
    }

    public boolean nullsAreSortedHigh() throws SQLException
    {
        return connection.haveMinimumServerVersion(ServerVersion.v7_2);
    }

    public boolean nullsAreSortedLow() throws SQLException
    {
        return false;
    }

    public boolean nullsAreSortedAtStart() throws SQLException
    {
        return false;
    }

    public boolean nullsAreSortedAtEnd() throws SQLException
    {
        return !connection.haveMinimumServerVersion(ServerVersion.v7_2);
    }

    /*
     * What is the name of this database product - we hope that it is
     * PostgreSQL, so we return that explicitly.
     *
     * @return the database product name
     * @exception SQLException if a database access error occurs
     */
    public String getDatabaseProductName() throws SQLException
    {
        return "PostgreSQL";
    }

    public String getDatabaseProductVersion() throws SQLException
    {
        return connection.getDBVersionNumber();
    }

    public String getDriverName() throws SQLException
    {
        return "PostgreSQL Native Driver";
    }

    public String getDriverVersion() throws SQLException
    {
        return Driver.getVersion();
    }

    public int getDriverMajorVersion()
    {
        return Driver.MAJORVERSION;
    }

    public int getDriverMinorVersion()
    {
        return Driver.MINORVERSION;
    }

    /**
     * Does the database store tables in a local file? No - it
     * stores them in a file on the server.
     *
     * @return true if so
     * @exception SQLException if a database access error occurs
     */
    public boolean usesLocalFiles() throws SQLException
    {
        return false;
    }

    /**
     * Does the database use a file for each table?  Well, not really,
     * since it doesnt use local files.
     *
     * @return true if so
     * @exception SQLException if a database access error occurs
     */
    public boolean usesLocalFilePerTable() throws SQLException
    {
        return false;
    }

    /**
     * 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.
     *
     * @return true if so
     * @exception SQLException if a database access error occurs
     */
    public boolean supportsMixedCaseIdentifiers() throws SQLException
    {
        return false;
    }

    public boolean storesUpperCaseIdentifiers() throws SQLException
    {
        return false;
    }

    public boolean storesLowerCaseIdentifiers() throws SQLException
    {
        return true;
    }

    public boolean storesMixedCaseIdentifiers() throws SQLException
    {
        return false;
    }

    /**
     * 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.
     *
     * @return true if so
     * @exception SQLException if a database access error occurs
     */
    public boolean supportsMixedCaseQuotedIdentifiers() throws SQLException
    {
        return true;
    }

    public boolean storesUpperCaseQuotedIdentifiers() throws SQLException
    {
        return false;
    }

    public boolean storesLowerCaseQuotedIdentifiers() throws SQLException
    {
        return false;
    }

    public boolean storesMixedCaseQuotedIdentifiers() throws SQLException
    {
        return false;
    }

    /**
     * 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.
     *
     * @return the quoting string
     * @exception SQLException if a database access error occurs
     */
    public String getIdentifierQuoteString() throws SQLException
    {
        return "\"";
    }

    /**
     * {@inheritDoc}
     *
     * 

Within PostgreSQL, the keywords are found in * src/backend/parser/keywords.c * *

For SQL Keywords, I took the list provided at * * http://web.dementia.org/~shadow/sql/sql3bnf.sep93.txt * which is for SQL3, not SQL-92, but it is close enough for * this purpose. * * @return a comma separated list of keywords we use * @exception SQLException if a database access error occurs */ public String getSQLKeywords() throws SQLException { return keywords; } public String getNumericFunctions() throws SQLException { return EscapedFunctions.ABS+','+EscapedFunctions.ACOS+ ','+EscapedFunctions.ASIN+','+EscapedFunctions.ATAN+ ','+EscapedFunctions.ATAN2+','+EscapedFunctions.CEILING+ ','+EscapedFunctions.COS+','+EscapedFunctions.COT+ ','+EscapedFunctions.DEGREES+','+EscapedFunctions.EXP+ ','+EscapedFunctions.FLOOR+','+EscapedFunctions.LOG+ ','+EscapedFunctions.LOG10+','+EscapedFunctions.MOD+ ','+EscapedFunctions.PI+','+EscapedFunctions.POWER+ ','+EscapedFunctions.RADIANS+ ','+EscapedFunctions.ROUND+','+EscapedFunctions.SIGN+ ','+EscapedFunctions.SIN+','+EscapedFunctions.SQRT+ ','+EscapedFunctions.TAN+','+EscapedFunctions.TRUNCATE; } public String getStringFunctions() throws SQLException { String funcs = EscapedFunctions.ASCII+','+EscapedFunctions.CHAR+ ','+EscapedFunctions.CONCAT+ ','+EscapedFunctions.LCASE+','+EscapedFunctions.LEFT+ ','+EscapedFunctions.LENGTH+ ','+EscapedFunctions.LTRIM+','+EscapedFunctions.REPEAT+ ','+EscapedFunctions.RTRIM+ ','+EscapedFunctions.SPACE+','+EscapedFunctions.SUBSTRING+ ','+EscapedFunctions.UCASE; // Currently these don't work correctly with parameterized // arguments, so leave them out. They reorder the arguments // when rewriting the query, but no translation layer is provided, // so a setObject(N, obj) will not go to the correct parameter. //','+EscapedFunctions.INSERT+','+EscapedFunctions.LOCATE+ //','+EscapedFunctions.RIGHT+ if (connection.haveMinimumServerVersion(ServerVersion.v7_3)) { funcs += ','+EscapedFunctions.REPLACE; } return funcs; } public String getSystemFunctions() throws SQLException { if (connection.haveMinimumServerVersion(ServerVersion.v7_3)){ return EscapedFunctions.DATABASE+','+EscapedFunctions.IFNULL+ ','+EscapedFunctions.USER; } else { return EscapedFunctions.IFNULL+ ','+EscapedFunctions.USER; } } public String getTimeDateFunctions() throws SQLException { String timeDateFuncs = EscapedFunctions.CURDATE+','+EscapedFunctions.CURTIME+ ','+EscapedFunctions.DAYNAME+','+EscapedFunctions.DAYOFMONTH+ ','+EscapedFunctions.DAYOFWEEK+','+EscapedFunctions.DAYOFYEAR+ ','+EscapedFunctions.HOUR+','+EscapedFunctions.MINUTE+ ','+EscapedFunctions.MONTH+ ','+EscapedFunctions.MONTHNAME+','+EscapedFunctions.NOW+ ','+EscapedFunctions.QUARTER+','+EscapedFunctions.SECOND+ ','+EscapedFunctions.WEEK+','+EscapedFunctions.YEAR; if (connection.haveMinimumServerVersion(ServerVersion.v8_0)) { timeDateFuncs += ','+EscapedFunctions.TIMESTAMPADD; } //+','+EscapedFunctions.TIMESTAMPDIFF; return timeDateFuncs; } public String getSearchStringEscape() throws SQLException { // This method originally returned "\\\\" assuming that it // would be fed directly into pg's input parser so it would // need two backslashes. This isn't how it's supposed to be // used though. If passed as a PreparedStatement parameter // or fed to a DatabaseMetaData method then double backslashes // are incorrect. If you're feeding something directly into // a query you are responsible for correctly escaping it. // With 8.2+ this escaping is a little trickier because you // must know the setting of standard_conforming_strings, but // that's not our problem. return "\\"; } /** * {@inheritDoc} * *

Postgresql allows any high-bit character to be used * in an unquoted identifer, 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}* * * @return a string containing the extra characters * @exception SQLException if a database access error occurs */ public String getExtraNameCharacters() throws SQLException { return ""; } /** * {@inheritDoc} * @return true if connected to PostgreSQL 6.1+ */ public boolean supportsAlterTableWithAddColumn() throws SQLException { return true; } /** * {@inheritDoc} * @return true if connected to PostgreSQL 7.3+ */ public boolean supportsAlterTableWithDropColumn() throws SQLException { return connection.haveMinimumServerVersion(ServerVersion.v7_3); } public boolean supportsColumnAliasing() throws SQLException { return true; } public boolean nullPlusNonNullIsNull() throws SQLException { return true; } public boolean supportsConvert() throws SQLException { return false; } public boolean supportsConvert(int fromType, int toType) throws SQLException { return false; } public boolean supportsTableCorrelationNames() throws SQLException { return true; } public boolean supportsDifferentTableCorrelationNames() throws SQLException { return false; } public boolean supportsExpressionsInOrderBy() throws SQLException { return true; } /** * {@inheritDoc} * @return true if connected to PostgreSQL 6.4+ */ public boolean supportsOrderByUnrelated() throws SQLException { return connection.haveMinimumServerVersion(ServerVersion.v6_4); } public boolean supportsGroupBy() throws SQLException { return true; } /** * {@inheritDoc} * @return true if connected to PostgreSQL 6.4+ */ public boolean supportsGroupByUnrelated() throws SQLException { return connection.haveMinimumServerVersion(ServerVersion.v6_4); } /* * {@inheritDoc} * @return true if connected to PostgreSQL 6.4+ */ public boolean supportsGroupByBeyondSelect() throws SQLException { return connection.haveMinimumServerVersion(ServerVersion.v6_4); } /* * {@inheritDoc} * @return true if connected to PostgreSQL 7.1+ */ public boolean supportsLikeEscapeClause() throws SQLException { return connection.haveMinimumServerVersion(ServerVersion.v7_1); } public boolean supportsMultipleResultSets() throws SQLException { return true; } public boolean supportsMultipleTransactions() throws SQLException { return true; } public boolean supportsNonNullableColumns() throws SQLException { return true; } /** * {@inheritDoc} * * 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. * * @return true */ public boolean supportsMinimumSQLGrammar() throws SQLException { return true; } /** * Does this driver support the Core ODBC SQL grammar. We need * SQL-92 conformance for this. * * @return false * @exception SQLException if a database access error occurs */ public boolean supportsCoreSQLGrammar() throws SQLException { return false; } /** * 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. * * @return false * @exception SQLException if a database access error occurs */ public boolean supportsExtendedSQLGrammar() throws SQLException { return false; } /** * 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. * * @return true if connected to PostgreSQL 7.3+ * @exception SQLException if a database access error occurs */ public boolean supportsANSI92EntryLevelSQL() throws SQLException { return connection.haveMinimumServerVersion(ServerVersion.v7_3); } /** * {@inheritDoc} * @return false */ public boolean supportsANSI92IntermediateSQL() throws SQLException { return false; } /** * {@inheritDoc} * @return false */ public boolean supportsANSI92FullSQL() throws SQLException { return false; } /* * Is the SQL Integrity Enhancement Facility supported? * Our best guess is that this means support for constraints * * @return true * @exception SQLException if a database access error occurs */ public boolean supportsIntegrityEnhancementFacility() throws SQLException { return true; } /** * {@inheritDoc} * @return true if connected to PostgreSQL 7.1+ */ public boolean supportsOuterJoins() throws SQLException { return connection.haveMinimumServerVersion(ServerVersion.v7_1); } /** * {@inheritDoc} * @return true if connected to PostgreSQL 7.1+ */ public boolean supportsFullOuterJoins() throws SQLException { return connection.haveMinimumServerVersion(ServerVersion.v7_1); } /** * {@inheritDoc} * @return true if connected to PostgreSQL 7.1+ */ public boolean supportsLimitedOuterJoins() throws SQLException { return connection.haveMinimumServerVersion(ServerVersion.v7_1); } /** * {@inheritDoc} *

PostgreSQL doesn't have schemas, but when it does, we'll use the * term "schema". * * @return {@code "schema"} */ public String getSchemaTerm() throws SQLException { return "schema"; } /** * {@inheritDoc} * @return {@code "function"} */ public String getProcedureTerm() throws SQLException { return "function"; } /** * {@inheritDoc} * @return {@code "database"} */ public String getCatalogTerm() throws SQLException { return "database"; } public boolean isCatalogAtStart() throws SQLException { return true; } public String getCatalogSeparator() throws SQLException { return "."; } /** * {@inheritDoc} * @return true if connected to PostgreSQL 7.3+ */ public boolean supportsSchemasInDataManipulation() throws SQLException { return connection.haveMinimumServerVersion(ServerVersion.v7_3); } /** * {@inheritDoc} * @return true if connected to PostgreSQL 7.3+ */ public boolean supportsSchemasInProcedureCalls() throws SQLException { return connection.haveMinimumServerVersion(ServerVersion.v7_3); } /** * {@inheritDoc} * @return true if connected to PostgreSQL 7.3+ */ public boolean supportsSchemasInTableDefinitions() throws SQLException { return connection.haveMinimumServerVersion(ServerVersion.v7_3); } /** * {@inheritDoc} * @return true if connected to PostgreSQL 7.3+ */ public boolean supportsSchemasInIndexDefinitions() throws SQLException { return connection.haveMinimumServerVersion(ServerVersion.v7_3); } /** * {@inheritDoc} * @return true if connected to PostgreSQL 7.3+ */ public boolean supportsSchemasInPrivilegeDefinitions() throws SQLException { return connection.haveMinimumServerVersion(ServerVersion.v7_3); } public boolean supportsCatalogsInDataManipulation() throws SQLException { return false; } public boolean supportsCatalogsInProcedureCalls() throws SQLException { return false; } public boolean supportsCatalogsInTableDefinitions() throws SQLException { return false; } public boolean supportsCatalogsInIndexDefinitions() throws SQLException { return false; } public boolean supportsCatalogsInPrivilegeDefinitions() throws SQLException { return false; } /** * We support cursors for gets only it seems. I dont see a method * to get a positioned delete. * * @return false * @exception SQLException if a database access error occurs */ public boolean supportsPositionedDelete() throws SQLException { return false; // For now... } public boolean supportsPositionedUpdate() throws SQLException { return false; // For now... } /** * {@inheritDoc} * @return true if connected to PostgreSQL 6.5+ */ public boolean supportsSelectForUpdate() throws SQLException { return connection.haveMinimumServerVersion(ServerVersion.v6_5); } public boolean supportsStoredProcedures() throws SQLException { return true; } public boolean supportsSubqueriesInComparisons() throws SQLException { return true; } public boolean supportsSubqueriesInExists() throws SQLException { return true; } public boolean supportsSubqueriesInIns() throws SQLException { return true; } public boolean supportsSubqueriesInQuantifieds() throws SQLException { return true; } /** * {@inheritDoc} * @return true if connected to PostgreSQL 7.1+ */ public boolean supportsCorrelatedSubqueries() throws SQLException { return connection.haveMinimumServerVersion(ServerVersion.v7_1); } /** * {@inheritDoc} * @return true if connected to PostgreSQL 6.3+ */ public boolean supportsUnion() throws SQLException { return true; // since 6.3 } /** * {@inheritDoc} * @return true if connected to PostgreSQL 7.1+ */ public boolean supportsUnionAll() throws SQLException { return connection.haveMinimumServerVersion(ServerVersion.v7_1); } /** * {@inheritDoc} * In PostgreSQL, Cursors are only open within transactions. */ public boolean supportsOpenCursorsAcrossCommit() throws SQLException { return false; } public boolean supportsOpenCursorsAcrossRollback() throws SQLException { return false; } /** * {@inheritDoc} *

Can statements remain open across commits? They may, but * this driver cannot guarentee 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() * * @return true */ public boolean supportsOpenStatementsAcrossCommit() throws SQLException { return true; } /** * {@inheritDoc} *

Can statements remain open across rollbacks? They may, but * this driver cannot guarentee 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 * * @return true */ public boolean supportsOpenStatementsAcrossRollback() throws SQLException { return true; } public int getMaxCharLiteralLength() throws SQLException { return 0; // no limit } public int getMaxBinaryLiteralLength() throws SQLException { return 0; // no limit } public int getMaxColumnNameLength() throws SQLException { return getMaxNameLength(); } public int getMaxColumnsInGroupBy() throws SQLException { return 0; // no limit } public int getMaxColumnsInIndex() throws SQLException { return getMaxIndexKeys(); } public int getMaxColumnsInOrderBy() throws SQLException { return 0; // no limit } public int getMaxColumnsInSelect() throws SQLException { return 0; // no limit } /** * {@inheritDoc} * 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)..." * * @return the max columns * @exception SQLException if a database access error occurs */ public int getMaxColumnsInTable() throws SQLException { return 1600; } /** * {@inheritDoc} * 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, * * @return the maximum number of connections * @exception SQLException if a database access error occurs */ public int getMaxConnections() throws SQLException { return 8192; } public int getMaxCursorNameLength() throws SQLException { return getMaxNameLength(); } public int getMaxIndexLength() throws SQLException { return 0; // no limit (larger than an int anyway) } public int getMaxSchemaNameLength() throws SQLException { return getMaxNameLength(); } public int getMaxProcedureNameLength() throws SQLException { return getMaxNameLength(); } public int getMaxCatalogNameLength() throws SQLException { return getMaxNameLength(); } public int getMaxRowSize() throws SQLException { if (connection.haveMinimumServerVersion(ServerVersion.v7_1)) return 1073741824; // 1 GB else return 8192; // XXX could be altered } public boolean doesMaxRowSizeIncludeBlobs() throws SQLException { return false; } public int getMaxStatementLength() throws SQLException { if (connection.haveMinimumServerVersion(ServerVersion.v7_0)) return 0; // actually whatever fits in size_t else return 16384; } public int getMaxStatements() throws SQLException { return 0; } public int getMaxTableNameLength() throws SQLException { return getMaxNameLength(); } public int getMaxTablesInSelect() throws SQLException { return 0; // no limit } public int getMaxUserNameLength() throws SQLException { return getMaxNameLength(); } public int getDefaultTransactionIsolation() throws SQLException { return Connection.TRANSACTION_READ_COMMITTED; } public boolean supportsTransactions() throws SQLException { return true; } /** * {@inheritDoc} *

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. */ public boolean supportsTransactionIsolationLevel(int level) throws SQLException { if (level == Connection.TRANSACTION_SERIALIZABLE || level == Connection.TRANSACTION_READ_COMMITTED) return true; else if (connection.haveMinimumServerVersion(ServerVersion.v8_0) && (level == Connection.TRANSACTION_READ_UNCOMMITTED || level == Connection.TRANSACTION_REPEATABLE_READ)) return true; else return false; } public boolean supportsDataDefinitionAndDataManipulationTransactions() throws SQLException { return true; } public boolean supportsDataManipulationTransactionsOnly() throws SQLException { return false; } /** * 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. * * @return true if so * @exception SQLException if a database access error occurs */ public boolean dataDefinitionCausesTransactionCommit() throws SQLException { return false; } public boolean dataDefinitionIgnoredInTransactions() throws SQLException { return false; } /** * Turn the provided value into a valid string literal for * direct inclusion into a query. This includes the single quotes * needed around it. * * @param s input value * @throws SQLException if something wrong happens * @return string literal for direct inclusion into a query */ protected String escapeQuotes(String s) throws SQLException { StringBuilder sb = new StringBuilder(); if (!connection.getStandardConformingStrings() && connection.haveMinimumServerVersion(ServerVersion.v8_1)) { sb.append("E"); } sb.append("'"); sb.append(connection.escapeString(s)); sb.append("'"); return sb.toString(); } public java.sql.ResultSet getProcedures(String catalog, String schemaPattern, String procedureNamePattern) throws SQLException { return getProcedures(getJDBCMajorVersion(), catalog, schemaPattern, procedureNamePattern); } protected java.sql.ResultSet getProcedures(int jdbcVersion, String catalog, String schemaPattern, String procedureNamePattern) throws SQLException { String sql; if (connection.haveMinimumServerVersion(ServerVersion.v7_3)) { sql = "SELECT NULL AS PROCEDURE_CAT, n.nspname AS PROCEDURE_SCHEM, p.proname AS PROCEDURE_NAME, NULL, NULL, NULL, d.description AS REMARKS, " + java.sql.DatabaseMetaData.procedureReturnsResult + " AS PROCEDURE_TYPE "; if (jdbcVersion >= 4) { sql += ", p.proname || '_' || p.oid AS SPECIFIC_NAME "; } sql += " FROM pg_catalog.pg_namespace n, pg_catalog.pg_proc p " + " LEFT JOIN pg_catalog.pg_description d ON (p.oid=d.objoid) " + " LEFT JOIN pg_catalog.pg_class c ON (d.classoid=c.oid AND c.relname='pg_proc') " + " LEFT JOIN pg_catalog.pg_namespace pn ON (c.relnamespace=pn.oid AND pn.nspname='pg_catalog') " + " WHERE p.pronamespace=n.oid "; if (schemaPattern != null && !"".equals(schemaPattern)) { sql += " AND n.nspname LIKE " + escapeQuotes(schemaPattern); } if (procedureNamePattern != null) { sql += " AND p.proname LIKE " + escapeQuotes(procedureNamePattern); } sql += " ORDER BY PROCEDURE_SCHEM, PROCEDURE_NAME, p.oid::text "; } else if (connection.haveMinimumServerVersion(ServerVersion.v7_1)) { sql = "SELECT NULL AS PROCEDURE_CAT, NULL AS PROCEDURE_SCHEM, p.proname AS PROCEDURE_NAME, NULL, NULL, NULL, d.description AS REMARKS, " + java.sql.DatabaseMetaData.procedureReturnsResult + " AS PROCEDURE_TYPE "; if (jdbcVersion >= 4) { sql += ", p.proname || '_' || p.oid AS SPECIFIC_NAME "; } sql += " FROM pg_proc p " + " LEFT JOIN pg_description d ON (p.oid=d.objoid) "; if (connection.haveMinimumServerVersion(ServerVersion.v7_2)) { sql += " LEFT JOIN pg_class c ON (d.classoid=c.oid AND c.relname='pg_proc') "; } if (procedureNamePattern != null) { sql += " WHERE p.proname LIKE " + escapeQuotes(procedureNamePattern); } sql += " ORDER BY PROCEDURE_NAME, p.oid::text "; } else { sql = "SELECT NULL AS PROCEDURE_CAT, NULL AS PROCEDURE_SCHEM, p.proname AS PROCEDURE_NAME, NULL, NULL, NULL, NULL AS REMARKS, " + java.sql.DatabaseMetaData.procedureReturnsResult + " AS PROCEDURE_TYPE "; if (jdbcVersion >= 4) { sql += ", p.proname || '_' || p.oid AS SPECIFIC_NAME "; } sql += " FROM pg_proc p "; if (procedureNamePattern != null) { sql += " WHERE p.proname LIKE " + escapeQuotes(procedureNamePattern); } sql += " ORDER BY PROCEDURE_NAME, p.oid::text "; } return createMetaDataStatement().executeQuery(sql); } public java.sql.ResultSet getProcedureColumns(String catalog, String schemaPattern, String procedureNamePattern, String columnNamePattern) throws SQLException { return getProcedureColumns(getJDBCMajorVersion(), catalog, schemaPattern, procedureNamePattern, columnNamePattern); } protected java.sql.ResultSet getProcedureColumns(int jdbcVersion, String catalog, String schemaPattern, String procedureNamePattern, String columnNamePattern) throws SQLException { int columns = 13; if (jdbcVersion >= 4) { columns += 7; } Field f[] = new Field[columns]; List v = new ArrayList(); // The new ResultSet tuple stuff f[0] = new Field("PROCEDURE_CAT", Oid.VARCHAR); f[1] = new Field("PROCEDURE_SCHEM", Oid.VARCHAR); f[2] = new Field("PROCEDURE_NAME", Oid.VARCHAR); f[3] = new Field("COLUMN_NAME", Oid.VARCHAR); f[4] = new Field("COLUMN_TYPE", Oid.INT2); f[5] = new Field("DATA_TYPE", Oid.INT2); f[6] = new Field("TYPE_NAME", Oid.VARCHAR); f[7] = new Field("PRECISION", Oid.INT4); f[8] = new Field("LENGTH", Oid.INT4); f[9] = new Field("SCALE", Oid.INT2); f[10] = new Field("RADIX", Oid.INT2); f[11] = new Field("NULLABLE", Oid.INT2); f[12] = new Field("REMARKS", Oid.VARCHAR); if (jdbcVersion >= 4) { f[13] = new Field("COLUMN_DEF", Oid.VARCHAR); f[14] = new Field("SQL_DATA_TYPE", Oid.INT4); f[15] = new Field("SQL_DATETIME_SUB", Oid.INT4); f[16] = new Field("CHAR_OCTECT_LENGTH", Oid.INT4); f[17] = new Field("ORDINAL_POSITION", Oid.INT4); f[18] = new Field("IS_NULLABLE", Oid.VARCHAR); f[19] = new Field("SPECIFIC_NAME", Oid.VARCHAR); } String sql; if (connection.haveMinimumServerVersion(ServerVersion.v7_3)) { sql = "SELECT n.nspname,p.proname,p.prorettype,p.proargtypes, t.typtype,t.typrelid "; if (connection.haveMinimumServerVersion(ServerVersion.v8_1)) sql += ", p.proargnames, p.proargmodes, p.proallargtypes "; else if (connection.haveMinimumServerVersion(ServerVersion.v8_0)) sql += ", p.proargnames, NULL AS proargmodes, NULL AS proallargtypes "; else sql += ", NULL AS proargnames, NULL AS proargmodes, NULL AS proallargtypes "; sql += ", p.oid " + " FROM pg_catalog.pg_proc p, pg_catalog.pg_namespace n, pg_catalog.pg_type t " + " WHERE p.pronamespace=n.oid AND p.prorettype=t.oid "; if (schemaPattern != null && !"".equals(schemaPattern)) { sql += " AND n.nspname LIKE " + escapeQuotes(schemaPattern); } if (procedureNamePattern != null) { sql += " AND p.proname LIKE " + escapeQuotes(procedureNamePattern); } sql += " ORDER BY n.nspname, p.proname, p.oid::text "; } else { sql = "SELECT NULL AS nspname,p.proname,p.prorettype,p.proargtypes,t.typtype,t.typrelid, NULL AS proargnames, NULL AS proargmodes, NULL AS proallargtypes, p.oid " + " FROM pg_proc p,pg_type t " + " WHERE p.prorettype=t.oid "; if (procedureNamePattern != null) { sql += " AND p.proname LIKE " + escapeQuotes(procedureNamePattern); } sql += " ORDER BY p.proname, p.oid::text "; } byte isnullableUnknown[] = new byte[0]; Statement stmt = connection.createStatement(); ResultSet rs = stmt.executeQuery(sql); while (rs.next()) { byte schema[] = rs.getBytes("nspname"); byte procedureName[] = rs.getBytes("proname"); byte specificName[] = connection.encodeString(rs.getString("proname") + "_" + rs.getString("oid")); int returnType = (int)rs.getLong("prorettype"); String returnTypeType = rs.getString("typtype"); int returnTypeRelid = (int)rs.getLong("typrelid"); String strArgTypes = rs.getString("proargtypes"); StringTokenizer st = new StringTokenizer(strArgTypes); List argTypes = new ArrayList(); while (st.hasMoreTokens()) { argTypes.add(new Long(st.nextToken())); } String argNames[] = null; Array argNamesArray = rs.getArray("proargnames"); if (argNamesArray != null) argNames = (String[])argNamesArray.getArray(); String argModes[] = null; Array argModesArray = rs.getArray("proargmodes"); if (argModesArray != null) argModes = (String[])argModesArray.getArray(); int numArgs = argTypes.size(); Long allArgTypes[] = null; Array allArgTypesArray = rs.getArray("proallargtypes"); if (allArgTypesArray != null) { // Depending on what the user has selected we'll get // either long[] or Long[] back, and there's no // obvious way for the driver to override this for // it's own usage. if (connection.haveMinimumCompatibleVersion(ServerVersion.v8_3)) { allArgTypes = (Long[])allArgTypesArray.getArray(); } else { long tempAllArgTypes[] = (long[])allArgTypesArray.getArray(); allArgTypes = new Long[tempAllArgTypes.length]; for (int i=0; i= 4) { tuple[17] = connection.encodeString(Integer.toString(0)); tuple[18] = isnullableUnknown; tuple[19] = specificName; } v.add(tuple); } // Add a row for each argument. for (int i = 0; i < numArgs; i++) { byte[][] tuple = new byte[columns][]; tuple[0] = null; tuple[1] = schema; tuple[2] = procedureName; if (argNames != null) tuple[3] = connection.encodeString(argNames[i]); else tuple[3] = connection.encodeString("$" + (i + 1)); int columnMode = DatabaseMetaData.procedureColumnIn; if (argModes != null && argModes[i].equals("o")) columnMode = DatabaseMetaData.procedureColumnOut; else if (argModes != null && argModes[i].equals("b")) columnMode = DatabaseMetaData.procedureColumnInOut; else if (argModes != null && argModes[i].equals("t")) columnMode = DatabaseMetaData.procedureColumnReturn; tuple[4] = connection.encodeString(Integer.toString(columnMode)); int argOid; if (allArgTypes != null) argOid = allArgTypes[i].intValue(); else argOid = ((Long)argTypes.get(i)).intValue(); tuple[5] = connection.encodeString(Integer.toString(connection.getTypeInfo().getSQLType(argOid))); tuple[6] = connection.encodeString(connection.getTypeInfo().getPGType(argOid)); tuple[7] = null; tuple[8] = null; tuple[9] = null; tuple[10] = null; tuple[11] = connection.encodeString(Integer.toString(DatabaseMetaData.procedureNullableUnknown)); tuple[12] = null; if (jdbcVersion >= 4) { tuple[17] = connection.encodeString(Integer.toString(i+1)); tuple[18] = isnullableUnknown; tuple[19] = specificName; } v.add(tuple); } // if we are returning a multi-column result. if (returnTypeType.equals("c") || (returnTypeType.equals("p") && argModesArray != null)) { String columnsql = "SELECT a.attname,a.atttypid FROM "; if (connection.haveMinimumServerVersion(ServerVersion.v7_3)) { columnsql += "pg_catalog."; } columnsql += "pg_attribute a WHERE a.attrelid = " + returnTypeRelid + " AND a.attnum > 0 ORDER BY a.attnum "; Statement columnstmt = connection.createStatement(); ResultSet columnrs = columnstmt.executeQuery(columnsql); while (columnrs.next()) { int columnTypeOid = (int)columnrs.getLong("atttypid"); byte[][] tuple = new byte[columns][]; tuple[0] = null; tuple[1] = schema; tuple[2] = procedureName; tuple[3] = columnrs.getBytes("attname"); tuple[4] = connection.encodeString(Integer.toString(java.sql.DatabaseMetaData.procedureColumnResult)); tuple[5] = connection.encodeString(Integer.toString(connection.getTypeInfo().getSQLType(columnTypeOid))); tuple[6] = connection.encodeString(connection.getTypeInfo().getPGType(columnTypeOid)); tuple[7] = null; tuple[8] = null; tuple[9] = null; tuple[10] = null; tuple[11] = connection.encodeString(Integer.toString(java.sql.DatabaseMetaData.procedureNullableUnknown)); tuple[12] = null; if (jdbcVersion >= 4) { tuple[17] = connection.encodeString(Integer.toString(0)); tuple[18] = isnullableUnknown; tuple[19] = specificName; } v.add(tuple); } columnrs.close(); columnstmt.close(); } } rs.close(); stmt.close(); return (ResultSet)((BaseStatement)createMetaDataStatement()).createDriverResultSet(f, v); } public java.sql.ResultSet getTables(String catalog, String schemaPattern, String tableNamePattern, String types[]) throws SQLException { String select; String orderby; String useSchemas; if (connection.haveMinimumServerVersion(ServerVersion.v7_3)) { useSchemas = "SCHEMAS"; select = "SELECT NULL AS TABLE_CAT, n.nspname AS TABLE_SCHEM, c.relname AS TABLE_NAME, " + " CASE n.nspname ~ '^pg_' OR n.nspname = 'information_schema' " + " WHEN true THEN CASE " + " WHEN n.nspname = 'pg_catalog' OR n.nspname = 'information_schema' THEN CASE c.relkind " + " WHEN 'r' THEN 'SYSTEM TABLE' " + " WHEN 'v' THEN 'SYSTEM VIEW' " + " WHEN 'i' THEN 'SYSTEM INDEX' " + " ELSE NULL " + " END " + " WHEN n.nspname = 'pg_toast' THEN CASE c.relkind " + " WHEN 'r' THEN 'SYSTEM TOAST TABLE' " + " WHEN 'i' THEN 'SYSTEM TOAST INDEX' " + " ELSE NULL " + " END " + " ELSE CASE c.relkind " + " WHEN 'r' THEN 'TEMPORARY TABLE' " + " WHEN 'i' THEN 'TEMPORARY INDEX' " + " WHEN 'S' THEN 'TEMPORARY SEQUENCE' " + " WHEN 'v' THEN 'TEMPORARY VIEW' " + " ELSE NULL " + " END " + " END " + " WHEN false THEN CASE c.relkind " + " WHEN 'r' THEN 'TABLE' " + " WHEN 'i' THEN 'INDEX' " + " WHEN 'S' THEN 'SEQUENCE' " + " WHEN 'v' THEN 'VIEW' " + " WHEN 'c' THEN 'TYPE' " + " WHEN 'f' THEN 'FOREIGN TABLE' " + " WHEN 'm' THEN 'MATERIALIZED VIEW' " + " ELSE NULL " + " END " + " ELSE NULL " + " END " + " AS TABLE_TYPE, d.description AS REMARKS " + " FROM pg_catalog.pg_namespace n, pg_catalog.pg_class c " + " LEFT JOIN pg_catalog.pg_description d ON (c.oid = d.objoid AND d.objsubid = 0) " + " LEFT JOIN pg_catalog.pg_class dc ON (d.classoid=dc.oid AND dc.relname='pg_class') " + " LEFT JOIN pg_catalog.pg_namespace dn ON (dn.oid=dc.relnamespace AND dn.nspname='pg_catalog') " + " WHERE c.relnamespace = n.oid "; if (schemaPattern != null && !"".equals(schemaPattern)) { select += " AND n.nspname LIKE " + escapeQuotes(schemaPattern); } orderby = " ORDER BY TABLE_TYPE,TABLE_SCHEM,TABLE_NAME "; } else { useSchemas = "NOSCHEMAS"; String tableType = "" + " CASE c.relname ~ '^pg_' " + " WHEN true THEN CASE c.relname ~ '^pg_toast_' " + " WHEN true THEN CASE c.relkind " + " WHEN 'r' THEN 'SYSTEM TOAST TABLE' " + " WHEN 'i' THEN 'SYSTEM TOAST INDEX' " + " ELSE NULL " + " END " + " WHEN false THEN CASE c.relname ~ '^pg_temp_' " + " WHEN true THEN CASE c.relkind " + " WHEN 'r' THEN 'TEMPORARY TABLE' " + " WHEN 'i' THEN 'TEMPORARY INDEX' " + " WHEN 'S' THEN 'TEMPORARY SEQUENCE' " + " WHEN 'v' THEN 'TEMPORARY VIEW' " + " ELSE NULL " + " END " + " WHEN false THEN CASE c.relkind " + " WHEN 'r' THEN 'SYSTEM TABLE' " + " WHEN 'v' THEN 'SYSTEM VIEW' " + " WHEN 'i' THEN 'SYSTEM INDEX' " + " ELSE NULL " + " END " + " ELSE NULL " + " END " + " ELSE NULL " + " END " + " WHEN false THEN CASE c.relkind " + " WHEN 'r' THEN 'TABLE' " + " WHEN 'i' THEN 'INDEX' " + " WHEN 'S' THEN 'SEQUENCE' " + " WHEN 'v' THEN 'VIEW' " + " WHEN 'c' THEN 'TYPE' " + " ELSE NULL " + " END " + " ELSE NULL " + " END "; orderby = " ORDER BY TABLE_TYPE,TABLE_NAME "; if (connection.haveMinimumServerVersion(ServerVersion.v7_2)) { select = "SELECT NULL AS TABLE_CAT, NULL AS TABLE_SCHEM, c.relname AS TABLE_NAME, " + tableType + " AS TABLE_TYPE, d.description AS REMARKS " + " FROM pg_class c " + " LEFT JOIN pg_description d ON (c.oid=d.objoid AND d.objsubid = 0) " + " LEFT JOIN pg_class dc ON (d.classoid = dc.oid AND dc.relname='pg_class') " + " WHERE true "; } else if (connection.haveMinimumServerVersion(ServerVersion.v7_1)) { select = "SELECT NULL AS TABLE_CAT, NULL AS TABLE_SCHEM, c.relname AS TABLE_NAME, " + tableType + " AS TABLE_TYPE, d.description AS REMARKS " + " FROM pg_class c " + " LEFT JOIN pg_description d ON (c.oid=d.objoid) " + " WHERE true "; } else { select = "SELECT NULL AS TABLE_CAT, NULL AS TABLE_SCHEM, c.relname AS TABLE_NAME, " + tableType + " AS TABLE_TYPE, NULL AS REMARKS " + " FROM pg_class c " + " WHERE true "; } } if (tableNamePattern != null && !"".equals(tableNamePattern)) { select += " AND c.relname LIKE " + escapeQuotes(tableNamePattern); } if (types != null) { select += " AND (false "; for (String type : types) { Map clauses = (Map) tableTypeClauses.get(type); if (clauses != null) { String clause = (String) clauses.get(useSchemas); select += " OR ( " + clause + " ) "; } } select += ") "; } String sql = select + orderby; return createMetaDataStatement().executeQuery(sql); } private static final Map tableTypeClauses; static { tableTypeClauses = new HashMap(); Map ht = new HashMap(); tableTypeClauses.put("TABLE", ht); ht.put("SCHEMAS", "c.relkind = 'r' AND n.nspname !~ '^pg_' AND n.nspname <> 'information_schema'"); ht.put("NOSCHEMAS", "c.relkind = 'r' AND c.relname !~ '^pg_'"); ht = new HashMap(); tableTypeClauses.put("VIEW", ht); ht.put("SCHEMAS", "c.relkind = 'v' AND n.nspname <> 'pg_catalog' AND n.nspname <> 'information_schema'"); ht.put("NOSCHEMAS", "c.relkind = 'v' AND c.relname !~ '^pg_'"); ht = new HashMap(); tableTypeClauses.put("INDEX", ht); ht.put("SCHEMAS", "c.relkind = 'i' AND n.nspname !~ '^pg_' AND n.nspname <> 'information_schema'"); ht.put("NOSCHEMAS", "c.relkind = 'i' AND c.relname !~ '^pg_'"); ht = new HashMap(); tableTypeClauses.put("SEQUENCE", ht); ht.put("SCHEMAS", "c.relkind = 'S'"); ht.put("NOSCHEMAS", "c.relkind = 'S'"); ht = new HashMap(); tableTypeClauses.put("TYPE", ht); ht.put("SCHEMAS", "c.relkind = 'c' AND n.nspname !~ '^pg_' AND n.nspname <> 'information_schema'"); ht.put("NOSCHEMAS", "c.relkind = 'c' AND c.relname !~ '^pg_'"); ht = new HashMap(); tableTypeClauses.put("SYSTEM TABLE", ht); ht.put("SCHEMAS", "c.relkind = 'r' AND (n.nspname = 'pg_catalog' OR n.nspname = 'information_schema')"); ht.put("NOSCHEMAS", "c.relkind = 'r' AND c.relname ~ '^pg_' AND c.relname !~ '^pg_toast_' AND c.relname !~ '^pg_temp_'"); ht = new HashMap(); tableTypeClauses.put("SYSTEM TOAST TABLE", ht); ht.put("SCHEMAS", "c.relkind = 'r' AND n.nspname = 'pg_toast'"); ht.put("NOSCHEMAS", "c.relkind = 'r' AND c.relname ~ '^pg_toast_'"); ht = new HashMap(); tableTypeClauses.put("SYSTEM TOAST INDEX", ht); ht.put("SCHEMAS", "c.relkind = 'i' AND n.nspname = 'pg_toast'"); ht.put("NOSCHEMAS", "c.relkind = 'i' AND c.relname ~ '^pg_toast_'"); ht = new HashMap(); tableTypeClauses.put("SYSTEM VIEW", ht); ht.put("SCHEMAS", "c.relkind = 'v' AND (n.nspname = 'pg_catalog' OR n.nspname = 'information_schema') "); ht.put("NOSCHEMAS", "c.relkind = 'v' AND c.relname ~ '^pg_'"); ht = new HashMap(); tableTypeClauses.put("SYSTEM INDEX", ht); ht.put("SCHEMAS", "c.relkind = 'i' AND (n.nspname = 'pg_catalog' OR n.nspname = 'information_schema') "); ht.put("NOSCHEMAS", "c.relkind = 'v' AND c.relname ~ '^pg_' AND c.relname !~ '^pg_toast_' AND c.relname !~ '^pg_temp_'"); ht = new HashMap(); tableTypeClauses.put("TEMPORARY TABLE", ht); ht.put("SCHEMAS", "c.relkind = 'r' AND n.nspname ~ '^pg_temp_' "); ht.put("NOSCHEMAS", "c.relkind = 'r' AND c.relname ~ '^pg_temp_' "); ht = new HashMap(); tableTypeClauses.put("TEMPORARY INDEX", ht); ht.put("SCHEMAS", "c.relkind = 'i' AND n.nspname ~ '^pg_temp_' "); ht.put("NOSCHEMAS", "c.relkind = 'i' AND c.relname ~ '^pg_temp_' "); ht = new HashMap(); tableTypeClauses.put("TEMPORARY VIEW", ht); ht.put("SCHEMAS", "c.relkind = 'v' AND n.nspname ~ '^pg_temp_' "); ht.put("NOSCHEMAS", "c.relkind = 'v' AND c.relname ~ '^pg_temp_' "); ht = new HashMap(); tableTypeClauses.put("TEMPORARY SEQUENCE", ht); ht.put("SCHEMAS", "c.relkind = 'S' AND n.nspname ~ '^pg_temp_' "); ht.put("NOSCHEMAS", "c.relkind = 'S' AND c.relname ~ '^pg_temp_' "); ht = new HashMap(); tableTypeClauses.put("FOREIGN TABLE", ht); ht.put("SCHEMAS", "c.relkind = 'f'"); ht.put("NOSCHEMAS", "c.relkind = 'f'"); ht = new HashMap(); tableTypeClauses.put("MATERIALIZED VIEW", ht); ht.put("SCHEMAS", "c.relkind = 'm'"); ht.put("NOSCHEMAS", "c.relkind = 'm'"); } public java.sql.ResultSet getSchemas() throws SQLException { return getSchemas(getJDBCMajorVersion(), null, null); } protected ResultSet getSchemas(int jdbcVersion, String catalog, String schemaPattern) throws SQLException { String sql; // Show only the users temp schemas, but not other peoples // because they can't access any objects in them. if (connection.haveMinimumServerVersion(ServerVersion.v7_3)) { // 7.3 can't extract elements from an array returned by // a function, so we've got to coerce it to text and then // hack it up with a regex. String tempSchema = "substring(textin(array_out(pg_catalog.current_schemas(true))) from '{(pg_temp_[0-9]+),')"; if (connection.haveMinimumServerVersion(ServerVersion.v7_4)) { tempSchema = "(pg_catalog.current_schemas(true))[1]"; } sql = "SELECT nspname AS TABLE_SCHEM "; if (jdbcVersion >= 3) sql += ", NULL AS TABLE_CATALOG "; sql += " FROM pg_catalog.pg_namespace WHERE nspname <> 'pg_toast' AND (nspname !~ '^pg_temp_' OR nspname = " + tempSchema + ") AND (nspname !~ '^pg_toast_temp_' OR nspname = replace(" + tempSchema + ", 'pg_temp_', 'pg_toast_temp_')) "; if (schemaPattern != null && !"".equals(schemaPattern)) { sql += " AND nspname LIKE " + escapeQuotes(schemaPattern); } sql += " ORDER BY TABLE_SCHEM"; } else { sql = "SELECT ''::text AS TABLE_SCHEM "; if (jdbcVersion >= 3) { sql += ", NULL AS TABLE_CATALOG "; } if (schemaPattern != null) { sql += " WHERE ''::text LIKE " + escapeQuotes(schemaPattern); } } return createMetaDataStatement().executeQuery(sql); } /** * PostgreSQL does not support multiple catalogs from a single * connection, so to reduce confusion we only return the current * catalog. * {@inheritDoc} */ public java.sql.ResultSet getCatalogs() throws SQLException { Field f[] = new Field[1]; List v = new ArrayList(); f[0] = new Field("TABLE_CAT", Oid.VARCHAR); byte[][] tuple = new byte[1][]; tuple[0] = connection.encodeString(connection.getCatalog()); v.add(tuple); return (ResultSet) ((BaseStatement)createMetaDataStatement()).createDriverResultSet(f, v); } public java.sql.ResultSet getTableTypes() throws SQLException { String types[] = new String[tableTypeClauses.size()]; Iterator e = tableTypeClauses.keySet().iterator(); int i = 0; while (e.hasNext()) { types[i++] = (String)e.next(); } sortStringArray(types); Field f[] = new Field[1]; List v = new ArrayList(); f[0] = new Field("TABLE_TYPE", Oid.VARCHAR); for (i = 0; i < types.length; i++) { byte[][] tuple = new byte[1][]; tuple[0] = connection.encodeString(types[i]); v.add(tuple); } return (ResultSet) ((BaseStatement)createMetaDataStatement()).createDriverResultSet(f, v); } protected java.sql.ResultSet getColumns(int jdbcVersion, String catalog, String schemaPattern, String tableNamePattern, String columnNamePattern) throws SQLException { int numberOfFields; if (jdbcVersion >= 4) { numberOfFields = 23; } else if (jdbcVersion >= 3) { numberOfFields = 22; } else { numberOfFields = 18; } List v = new ArrayList(); // The new ResultSet tuple stuff Field f[] = new Field[numberOfFields]; // The field descriptors for the new ResultSet f[0] = new Field("TABLE_CAT", Oid.VARCHAR); f[1] = new Field("TABLE_SCHEM", Oid.VARCHAR); f[2] = new Field("TABLE_NAME", Oid.VARCHAR); f[3] = new Field("COLUMN_NAME", Oid.VARCHAR); f[4] = new Field("DATA_TYPE", Oid.INT2); f[5] = new Field("TYPE_NAME", Oid.VARCHAR); f[6] = new Field("COLUMN_SIZE", Oid.INT4); f[7] = new Field("BUFFER_LENGTH", Oid.VARCHAR); f[8] = new Field("DECIMAL_DIGITS", Oid.INT4); f[9] = new Field("NUM_PREC_RADIX", Oid.INT4); f[10] = new Field("NULLABLE", Oid.INT4); f[11] = new Field("REMARKS", Oid.VARCHAR); f[12] = new Field("COLUMN_DEF", Oid.VARCHAR); f[13] = new Field("SQL_DATA_TYPE", Oid.INT4); f[14] = new Field("SQL_DATETIME_SUB", Oid.INT4); f[15] = new Field("CHAR_OCTET_LENGTH", Oid.VARCHAR); f[16] = new Field("ORDINAL_POSITION", Oid.INT4); f[17] = new Field("IS_NULLABLE", Oid.VARCHAR); if (jdbcVersion >= 3) { f[18] = new Field("SCOPE_CATLOG", Oid.VARCHAR); f[19] = new Field("SCOPE_SCHEMA", Oid.VARCHAR); f[20] = new Field("SCOPE_TABLE", Oid.VARCHAR); f[21] = new Field("SOURCE_DATA_TYPE", Oid.INT2); } if (jdbcVersion >= 4) { f[22] = new Field("IS_AUTOINCREMENT", Oid.VARCHAR); } String sql; if (connection.haveMinimumServerVersion(ServerVersion.v7_3)) { // a.attnum isn't decremented when preceding columns are dropped, // so the only way to calculate the correct column number is with // window functions, new in 8.4. // // We want to push as much predicate information below the window // function as possible (schema/table names), but must leave // column name outside so we correctly count the other columns. // if (connection.haveMinimumServerVersion(ServerVersion.v8_4)) sql = "SELECT * FROM ("; else sql = ""; sql += "SELECT n.nspname,c.relname,a.attname,a.atttypid,a.attnotnull OR (t.typtype = 'd' AND t.typnotnull) AS attnotnull,a.atttypmod,a.attlen,"; if (connection.haveMinimumServerVersion(ServerVersion.v8_4)) sql += "row_number() OVER (PARTITION BY a.attrelid ORDER BY a.attnum) AS attnum, "; else sql += "a.attnum,"; sql += "pg_catalog.pg_get_expr(def.adbin, def.adrelid) AS adsrc,dsc.description,t.typbasetype,t.typtype " + " FROM pg_catalog.pg_namespace n " + " JOIN pg_catalog.pg_class c ON (c.relnamespace = n.oid) " + " JOIN pg_catalog.pg_attribute a ON (a.attrelid=c.oid) " + " JOIN pg_catalog.pg_type t ON (a.atttypid = t.oid) " + " LEFT JOIN pg_catalog.pg_attrdef def ON (a.attrelid=def.adrelid AND a.attnum = def.adnum) " + " LEFT JOIN pg_catalog.pg_description dsc ON (c.oid=dsc.objoid AND a.attnum = dsc.objsubid) " + " LEFT JOIN pg_catalog.pg_class dc ON (dc.oid=dsc.classoid AND dc.relname='pg_class') " + " LEFT JOIN pg_catalog.pg_namespace dn ON (dc.relnamespace=dn.oid AND dn.nspname='pg_catalog') " + " WHERE c.relkind in ('r','v','f','m') and a.attnum > 0 AND NOT a.attisdropped "; if (schemaPattern != null && !"".equals(schemaPattern)) { sql += " AND n.nspname LIKE " + escapeQuotes(schemaPattern); } if (tableNamePattern != null && !"".equals(tableNamePattern)) { sql += " AND c.relname LIKE " + escapeQuotes(tableNamePattern); } if (connection.haveMinimumServerVersion(ServerVersion.v8_4)) sql += ") c WHERE true "; } else if (connection.haveMinimumServerVersion(ServerVersion.v7_2)) { sql = "SELECT NULL::text AS nspname,c.relname,a.attname,a.atttypid,a.attnotnull,a.atttypmod,a.attlen,a.attnum,pg_get_expr(def.adbin,def.adrelid) AS adsrc,dsc.description,NULL::oid AS typbasetype,t.typtype " + " FROM pg_class c " + " JOIN pg_attribute a ON (a.attrelid=c.oid) " + " JOIN pg_type t ON (a.atttypid = t.oid) " + " LEFT JOIN pg_attrdef def ON (a.attrelid=def.adrelid AND a.attnum = def.adnum) " + " LEFT JOIN pg_description dsc ON (c.oid=dsc.objoid AND a.attnum = dsc.objsubid) " + " LEFT JOIN pg_class dc ON (dc.oid=dsc.classoid AND dc.relname='pg_class') " + " WHERE c.relkind in ('r','v','f','m') and a.attnum > 0 "; } else if (connection.haveMinimumServerVersion(ServerVersion.v7_1)) { sql = "SELECT NULL::text AS nspname,c.relname,a.attname,a.atttypid,a.attnotnull,a.atttypmod,a.attlen,a.attnum,def.adsrc,dsc.description,NULL::oid AS typbasetype, 'b' AS typtype " + " FROM pg_class c " + " JOIN pg_attribute a ON (a.attrelid=c.oid) " + " LEFT JOIN pg_attrdef def ON (a.attrelid=def.adrelid AND a.attnum = def.adnum) " + " LEFT JOIN pg_description dsc ON (a.oid=dsc.objoid) " + " WHERE c.relkind in ('r','v','f','m') and a.attnum > 0 "; } else { // if < 7.1 then don't get defaults or descriptions. sql = "SELECT NULL::text AS nspname,c.relname,a.attname,a.atttypid,a.attnotnull,a.atttypmod,a.attlen,a.attnum,NULL AS adsrc,NULL AS description,NULL AS typbasetype, 'b' AS typtype " + " FROM pg_class c, pg_attribute a " + " WHERE c.relkind in ('r','v','f','m') and a.attrelid=c.oid AND a.attnum > 0 "; } if (!connection.haveMinimumServerVersion(ServerVersion.v7_3) && tableNamePattern != null && !"".equals(tableNamePattern)) { sql += " AND c.relname LIKE " + escapeQuotes(tableNamePattern); } if (columnNamePattern != null && !"".equals(columnNamePattern)) { sql += " AND attname LIKE " + escapeQuotes(columnNamePattern); } sql += " ORDER BY nspname,c.relname,attnum "; Statement stmt = connection.createStatement(); ResultSet rs = stmt.executeQuery(sql); while (rs.next()) { byte[][] tuple = new byte[numberOfFields][]; int typeOid = (int)rs.getLong("atttypid"); int typeMod = rs.getInt("atttypmod"); tuple[0] = null; // Catalog name, not supported tuple[1] = rs.getBytes("nspname"); // Schema tuple[2] = rs.getBytes("relname"); // Table name tuple[3] = rs.getBytes("attname"); // Column name String typtype = rs.getString("typtype"); int sqlType; if ("c".equals(typtype)) { sqlType = Types.STRUCT; } else if ("d".equals(typtype)) { sqlType = Types.DISTINCT; } else if ("e".equals(typtype)) { sqlType = Types.VARCHAR; } else { sqlType = connection.getTypeInfo().getSQLType(typeOid); } tuple[4] = connection.encodeString(Integer.toString(sqlType)); String pgType = connection.getTypeInfo().getPGType(typeOid); tuple[5] = connection.encodeString(pgType); // Type name tuple[7] = null; // Buffer length String defval = rs.getString("adsrc"); if ( defval != null ) { if ( pgType.equals("int4") ) { if (defval.contains("nextval(")) tuple[5] = connection.encodeString("serial"); // Type name == serial } else if ( pgType.equals("int8") ) { if (defval.contains("nextval(")) tuple[5] = connection.encodeString("bigserial"); // Type name == bigserial } } int decimalDigits = connection.getTypeInfo().getScale(typeOid, typeMod); int columnSize = connection.getTypeInfo().getPrecision(typeOid, typeMod); if (columnSize == 0) { columnSize = connection.getTypeInfo().getDisplaySize(typeOid, typeMod); } tuple[6] = connection.encodeString(Integer.toString(columnSize)); tuple[8] = connection.encodeString(Integer.toString(decimalDigits)); // Everything is base 10 unless we override later. tuple[9] = connection.encodeString("10"); if (pgType.equals("bit") || pgType.equals("varbit")) { tuple[9] = connection.encodeString("2"); } tuple[10] = connection.encodeString(Integer.toString(rs.getBoolean("attnotnull") ? java.sql.DatabaseMetaData.columnNoNulls : java.sql.DatabaseMetaData.columnNullable)); // Nullable tuple[11] = rs.getBytes("description"); // Description (if any) tuple[12] = rs.getBytes("adsrc"); // Column default tuple[13] = null; // sql data type (unused) tuple[14] = null; // sql datetime sub (unused) tuple[15] = tuple[6]; // char octet length tuple[16] = connection.encodeString(String.valueOf(rs.getInt("attnum"))); // ordinal position tuple[17] = connection.encodeString(rs.getBoolean("attnotnull") ? "NO" : "YES"); // Is nullable if (jdbcVersion >= 3) { int baseTypeOid = (int) rs.getLong("typbasetype"); tuple[18] = null; // SCOPE_CATLOG tuple[19] = null; // SCOPE_SCHEMA tuple[20] = null; // SCOPE_TABLE tuple[21] = baseTypeOid == 0 ? null : connection.encodeString(Integer.toString(connection.getTypeInfo().getSQLType(baseTypeOid))); // SOURCE_DATA_TYPE } if (jdbcVersion >= 4) { String autoinc = "NO"; if (defval != null && defval.contains("nextval(")) { autoinc = "YES"; } tuple[22] = connection.encodeString(autoinc); } v.add(tuple); } rs.close(); stmt.close(); return (ResultSet) ((BaseStatement)createMetaDataStatement()).createDriverResultSet(f, v); } public java.sql.ResultSet getColumns(String catalog, String schemaPattern, String tableNamePattern, String columnNamePattern) throws SQLException { return getColumns(getJDBCMajorVersion(), catalog, schemaPattern, tableNamePattern, columnNamePattern); } public java.sql.ResultSet getColumnPrivileges(String catalog, String schema, String table, String columnNamePattern) throws SQLException { Field f[] = new Field[8]; List v = new ArrayList(); if (table == null) table = "%"; if (columnNamePattern == null) columnNamePattern = "%"; f[0] = new Field("TABLE_CAT", Oid.VARCHAR); f[1] = new Field("TABLE_SCHEM", Oid.VARCHAR); f[2] = new Field("TABLE_NAME", Oid.VARCHAR); f[3] = new Field("COLUMN_NAME", Oid.VARCHAR); f[4] = new Field("GRANTOR", Oid.VARCHAR); f[5] = new Field("GRANTEE", Oid.VARCHAR); f[6] = new Field("PRIVILEGE", Oid.VARCHAR); f[7] = new Field("IS_GRANTABLE", Oid.VARCHAR); String sql; if (connection.haveMinimumServerVersion(ServerVersion.v8_4)) { sql = "SELECT n.nspname,c.relname,r.rolname,c.relacl,a.attacl,a.attname " + " FROM pg_catalog.pg_namespace n, pg_catalog.pg_class c, pg_catalog.pg_roles r, pg_catalog.pg_attribute a " + " WHERE c.relnamespace = n.oid " + " AND c.relowner = r.oid " + " AND c.oid = a.attrelid " + " AND c.relkind = 'r' " + " AND a.attnum > 0 AND NOT a.attisdropped "; if (schema != null && !"".equals(schema)) { sql += " AND n.nspname = " + escapeQuotes(schema); } } else if (connection.haveMinimumServerVersion(ServerVersion.v7_3)) { sql = "SELECT n.nspname,c.relname,r.rolname,c.relacl,a.attname " + " FROM pg_catalog.pg_namespace n, pg_catalog.pg_class c, pg_catalog.pg_roles r, pg_catalog.pg_attribute a " + " WHERE c.relnamespace = n.oid " + " AND c.relowner = r.oid " + " AND c.oid = a.attrelid " + " AND c.relkind = 'r' " + " AND a.attnum > 0 AND NOT a.attisdropped "; if (schema != null && !"".equals(schema)) { sql += " AND n.nspname = " + escapeQuotes(schema); } } else { sql = "SELECT NULL::text AS nspname,c.relname,u.usename,c.relacl,a.attname " + "FROM pg_class c, pg_user u,pg_attribute a " + " WHERE u.usesysid = c.relowner " + " AND c.oid = a.attrelid " + " AND a.attnum > 0 " + " AND c.relkind = 'r' "; } sql += " AND c.relname = " + escapeQuotes(table); if (columnNamePattern != null && !"".equals(columnNamePattern)) { sql += " AND a.attname LIKE " + escapeQuotes(columnNamePattern); } sql += " ORDER BY attname "; Statement stmt = connection.createStatement(); ResultSet rs = stmt.executeQuery(sql); while (rs.next()) { byte schemaName[] = rs.getBytes("nspname"); byte tableName[] = rs.getBytes("relname"); byte column[] = rs.getBytes("attname"); String owner = rs.getString("rolname"); String relAcl = rs.getString("relacl"); Map permissions = parseACL(relAcl, owner); if (connection.haveMinimumServerVersion(ServerVersion.v8_4)) { String acl = rs.getString("attacl"); Map relPermissions = parseACL(acl, owner); permissions.putAll(relPermissions); } String permNames[] = new String[permissions.size()]; Iterator e = permissions.keySet().iterator(); int i = 0; while (e.hasNext()) { permNames[i++] = (String)e.next(); } sortStringArray(permNames); for (i = 0; i < permNames.length; i++) { byte[] privilege = connection.encodeString(permNames[i]); Map grantees = (Map)permissions.get(permNames[i]); String granteeUsers[] = new String[grantees.size()]; Iterator g = grantees.keySet().iterator(); int k = 0; while (g.hasNext()){ granteeUsers[k++] = (String)g.next(); } for (int j = 0; j < grantees.size(); j++) { List grantor = (List)grantees.get(granteeUsers[j]); String grantee = (String)granteeUsers[j]; for (Object element : grantor) { String[] grants = (String[]) element; String grantable = owner.equals(grantee) ? "YES" : grants[1]; byte[][] tuple = new byte[8][]; tuple[0] = null; tuple[1] = schemaName; tuple[2] = tableName; tuple[3] = column; tuple[4] = connection.encodeString(grants[0]); tuple[5] = connection.encodeString(grantee); tuple[6] = privilege; tuple[7] = connection.encodeString(grantable); v.add(tuple); } } } } rs.close(); stmt.close(); return (ResultSet) ((BaseStatement)createMetaDataStatement()).createDriverResultSet(f, v); } public java.sql.ResultSet getTablePrivileges(String catalog, String schemaPattern, String tableNamePattern) throws SQLException { Field f[] = new Field[7]; List v = new ArrayList(); f[0] = new Field("TABLE_CAT", Oid.VARCHAR); f[1] = new Field("TABLE_SCHEM", Oid.VARCHAR); f[2] = new Field("TABLE_NAME", Oid.VARCHAR); f[3] = new Field("GRANTOR", Oid.VARCHAR); f[4] = new Field("GRANTEE", Oid.VARCHAR); f[5] = new Field("PRIVILEGE", Oid.VARCHAR); f[6] = new Field("IS_GRANTABLE", Oid.VARCHAR); String sql; if (connection.haveMinimumServerVersion(ServerVersion.v7_3)) { sql = "SELECT n.nspname,c.relname,r.rolname,c.relacl " + " FROM pg_catalog.pg_namespace n, pg_catalog.pg_class c, pg_catalog.pg_roles r " + " WHERE c.relnamespace = n.oid " + " AND c.relowner = r.oid " + " AND c.relkind = 'r' "; if (schemaPattern != null && !"".equals(schemaPattern)) { sql += " AND n.nspname LIKE " + escapeQuotes(schemaPattern); } } else { sql = "SELECT NULL::text AS nspname,c.relname,u.usename,c.relacl " + "FROM pg_class c, pg_user u " + " WHERE u.usesysid = c.relowner " + " AND c.relkind = 'r' "; } if (tableNamePattern != null && !"".equals(tableNamePattern)) { sql += " AND c.relname LIKE " + escapeQuotes(tableNamePattern); } sql += " ORDER BY nspname, relname "; Statement stmt = connection.createStatement(); ResultSet rs = stmt.executeQuery(sql); while (rs.next()) { byte schema[] = rs.getBytes("nspname"); byte table[] = rs.getBytes("relname"); String owner = rs.getString("rolname"); String acl = rs.getString("relacl"); Map permissions = parseACL(acl, owner); String permNames[] = new String[permissions.size()]; Iterator e = permissions.keySet().iterator(); int i = 0; while (e.hasNext()) { permNames[i++] = (String)e.next(); } sortStringArray(permNames); for (i = 0; i < permNames.length; i++) { byte[] privilege = connection.encodeString(permNames[i]); Map grantees = (Map)permissions.get(permNames[i]); String granteeUsers[] = new String[grantees.size()]; Iterator g = grantees.keySet().iterator(); int k = 0; while (g.hasNext()){ granteeUsers[k++] = (String)g.next(); } for (String granteeUser : granteeUsers) { List grants = (List) grantees.get(granteeUser); String grantee = (String) granteeUser; for (Object grant : grants) { String[] grantTuple = (String[]) grant; // report the owner as grantor if it's missing String grantor = grantTuple[0] == null ? owner : grantTuple[0]; // owner always has grant privileges String grantable = owner.equals(grantee) ? "YES" : grantTuple[1]; byte[][] tuple = new byte[7][]; tuple[0] = null; tuple[1] = schema; tuple[2] = table; tuple[3] = connection.encodeString(grantor); tuple[4] = connection.encodeString(grantee); tuple[5] = privilege; tuple[6] = connection.encodeString(grantable); v.add(tuple); } } } } rs.close(); stmt.close(); return (ResultSet) ((BaseStatement)createMetaDataStatement()).createDriverResultSet(f, v); } private static void sortStringArray(String s[]) { for (int i = 0; i < s.length - 1; i++) { for (int j = i + 1; j < s.length; j++) { if (s[i].compareTo(s[j]) > 0) { String tmp = s[i]; s[i] = s[j]; s[j] = tmp; } } } } /** * Parse an String of ACLs into a List of ACLs. */ private static List parseACLArray(String aclString) { List acls = new ArrayList(); if (aclString == null || aclString.length() == 0) { return acls; } boolean inQuotes = false; // start at 1 because of leading "{" int beginIndex = 1; char prevChar = ' '; for (int i = beginIndex; i < aclString.length(); i++) { char c = aclString.charAt(i); if (c == '"' && prevChar != '\\') { inQuotes = !inQuotes; } else if (c == ',' && !inQuotes) { acls.add(aclString.substring(beginIndex, i)); beginIndex = i + 1; } prevChar = c; } // add last element removing the trailing "}" acls.add(aclString.substring(beginIndex, aclString.length() - 1)); // Strip out enclosing quotes, if any. for (int i = 0; i < acls.size(); i++) { String acl = (String)acls.get(i); if (acl.startsWith("\"") && acl.endsWith("\"")) { acl = acl.substring(1, acl.length() - 1); acls.set(i, acl); } } return acls; } /** * Add the user described by the given acl to the Lists of users * with the privileges described by the acl. */ private void addACLPrivileges(String acl, Map privileges) { int equalIndex = acl.lastIndexOf("="); int slashIndex = acl.lastIndexOf("/"); if (equalIndex == -1) return; String user = acl.substring(0, equalIndex); String grantor = null; if (user.length() == 0) { user = "PUBLIC"; } String privs; if (slashIndex != -1) { privs = acl.substring(equalIndex + 1, slashIndex); grantor = acl.substring(slashIndex + 1, acl.length()); } else { privs = acl.substring(equalIndex + 1, acl.length()); } for (int i = 0; i < privs.length(); i++) { char c = privs.charAt(i); if (c != '*') { String sqlpriv; String grantable; if ( i < privs.length()-1 && privs.charAt(i + 1) == '*') { grantable = "YES"; } else { grantable = "NO"; } switch (c) { case 'a': sqlpriv = "INSERT"; break; case 'r': sqlpriv = "SELECT"; break; case 'w': sqlpriv = "UPDATE"; break; case 'd': sqlpriv = "DELETE"; break; case 'D': sqlpriv = "TRUNCATE"; break; case 'R': sqlpriv = "RULE"; break; case 'x': sqlpriv = "REFERENCES"; break; case 't': sqlpriv = "TRIGGER"; break; // the following can't be granted to a table, but // we'll keep them for completeness. case 'X': sqlpriv = "EXECUTE"; break; case 'U': sqlpriv = "USAGE"; break; case 'C': sqlpriv = "CREATE"; break; case 'T': sqlpriv = "CREATE TEMP"; break; default: sqlpriv = "UNKNOWN"; } Map usersWithPermission = (Map)privileges.get(sqlpriv); String[] grant = {grantor, grantable}; if (usersWithPermission == null) { usersWithPermission = new HashMap(); List permissionByGrantor = new ArrayList(); permissionByGrantor.add(grant); usersWithPermission.put(user, permissionByGrantor); privileges.put(sqlpriv, usersWithPermission); } else { List permissionByGrantor = (List)usersWithPermission.get(user); if (permissionByGrantor == null) { permissionByGrantor = new ArrayList(); permissionByGrantor.add(grant); usersWithPermission.put(user,permissionByGrantor); } else { permissionByGrantor.add(grant); } } } } } /** * 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. * * @param aclArray ACL array * @param owner owner * @return a Map mapping the SQL permission name */ public Map parseACL(String aclArray, String owner) { if (aclArray == null) { //null acl is a shortcut for owner having full privs String perms = "arwdRxt"; if (connection.haveMinimumServerVersion(ServerVersion.v8_2)) { // 8.2 Removed the separate RULE permission perms = "arwdxt"; } else if (connection.haveMinimumServerVersion(ServerVersion.v8_4)) { // 8.4 Added a separate TRUNCATE permission perms = "arwdDxt"; } aclArray = "{" + owner + "=" + perms + "/" + owner + "}"; } List acls = parseACLArray(aclArray); Map privileges = new HashMap(); for (Object element : acls) { String acl = (String) element; addACLPrivileges(acl, privileges); } return privileges; } public java.sql.ResultSet getBestRowIdentifier(String catalog, String schema, String table, int scope, boolean nullable) throws SQLException { Field f[] = new Field[8]; List v = new ArrayList(); // The new ResultSet tuple stuff f[0] = new Field("SCOPE", Oid.INT2); f[1] = new Field("COLUMN_NAME", Oid.VARCHAR); f[2] = new Field("DATA_TYPE", Oid.INT2); f[3] = new Field("TYPE_NAME", Oid.VARCHAR); f[4] = new Field("COLUMN_SIZE", Oid.INT4); f[5] = new Field("BUFFER_LENGTH", Oid.INT4); f[6] = new Field("DECIMAL_DIGITS", Oid.INT2); f[7] = new Field("PSEUDO_COLUMN", Oid.INT2); /* At the moment this simply returns a table's primary key, * if there is one. I believe other unique indexes, ctid, * and oid should also be considered. -KJ */ String sql; if (connection.haveMinimumServerVersion(ServerVersion.v8_1)) { sql = "SELECT a.attname, a.atttypid, atttypmod " + "FROM pg_catalog.pg_class ct " + " JOIN pg_catalog.pg_attribute a ON (ct.oid = a.attrelid) " + " JOIN pg_catalog.pg_namespace n ON (ct.relnamespace = n.oid) " + " JOIN (SELECT i.indexrelid, i.indrelid, i.indisprimary, " + " information_schema._pg_expandarray(i.indkey) AS keys " + " FROM pg_catalog.pg_index i) i " + " ON (a.attnum = (i.keys).x AND a.attrelid = i.indrelid) " + "WHERE true "; if (schema != null && !"".equals(schema)) { sql += " AND n.nspname = " + escapeQuotes(schema); } } else { String from; String where = ""; if (connection.haveMinimumServerVersion(ServerVersion.v7_3)) { from = " FROM pg_catalog.pg_namespace n, pg_catalog.pg_class ct, pg_catalog.pg_class ci, pg_catalog.pg_attribute a, pg_catalog.pg_index i "; where = " AND ct.relnamespace = n.oid "; if (schema != null && !"".equals(schema)) { where += " AND n.nspname = " + escapeQuotes(schema); } } else { from = " FROM pg_class ct, pg_class ci, pg_attribute a, pg_index i "; } sql = "SELECT a.attname, a.atttypid, a.atttypmod " + from + " WHERE ct.oid=i.indrelid AND ci.oid=i.indexrelid " + " AND a.attrelid=ci.oid " + where; } sql += " AND ct.relname = " + escapeQuotes(table) + " AND i.indisprimary " + " ORDER BY a.attnum "; Statement stmt = connection.createStatement(); ResultSet rs = stmt.executeQuery(sql); while (rs.next()) { byte tuple[][] = new byte[8][]; int typeOid = (int)rs.getLong("atttypid"); int typeMod = rs.getInt("atttypmod"); int decimalDigits = connection.getTypeInfo().getScale(typeOid, typeMod); int columnSize = connection.getTypeInfo().getPrecision(typeOid, typeMod); if (columnSize == 0) { columnSize = connection.getTypeInfo().getDisplaySize(typeOid, typeMod); } tuple[0] = connection.encodeString(Integer.toString(scope)); tuple[1] = rs.getBytes("attname"); tuple[2] = connection.encodeString(Integer.toString(connection.getTypeInfo().getSQLType(typeOid))); tuple[3] = connection.encodeString(connection.getTypeInfo().getPGType(typeOid)); tuple[4] = connection.encodeString(Integer.toString(columnSize)); tuple[5] = null; // unused tuple[6] = connection.encodeString(Integer.toString(decimalDigits)); tuple[7] = connection.encodeString(Integer.toString(java.sql.DatabaseMetaData.bestRowNotPseudo)); v.add(tuple); } rs.close(); stmt.close(); return (ResultSet) ((BaseStatement)createMetaDataStatement()).createDriverResultSet(f, v); } public java.sql.ResultSet getVersionColumns(String catalog, String schema, String table) throws SQLException { Field f[] = new Field[8]; List v = new ArrayList(); // The new ResultSet tuple stuff f[0] = new Field("SCOPE", Oid.INT2); f[1] = new Field("COLUMN_NAME", Oid.VARCHAR); f[2] = new Field("DATA_TYPE", Oid.INT2); f[3] = new Field("TYPE_NAME", Oid.VARCHAR); f[4] = new Field("COLUMN_SIZE", Oid.INT4); f[5] = new Field("BUFFER_LENGTH", Oid.INT4); f[6] = new Field("DECIMAL_DIGITS", Oid.INT2); f[7] = new Field("PSEUDO_COLUMN", Oid.INT2); byte tuple[][] = new byte[8][]; /* Postgresql does not have any column types that are * automatically updated like some databases' timestamp type. * We can't tell what rules or triggers might be doing, so we * are left with the system columns that change on an update. * An update may change all of the following system columns: * ctid, xmax, xmin, cmax, and cmin. Depending on if we are * in a transaction and wether we roll it back or not the * only guaranteed change is to ctid. -KJ */ tuple[0] = null; tuple[1] = connection.encodeString("ctid"); tuple[2] = connection.encodeString(Integer.toString(connection.getTypeInfo().getSQLType("tid"))); tuple[3] = connection.encodeString("tid"); tuple[4] = null; tuple[5] = null; tuple[6] = null; tuple[7] = connection.encodeString(Integer.toString(java.sql.DatabaseMetaData.versionColumnPseudo)); v.add(tuple); /* Perhaps we should check that the given * catalog.schema.table actually exists. -KJ */ return (ResultSet) ((BaseStatement)createMetaDataStatement()).createDriverResultSet(f, v); } public java.sql.ResultSet getPrimaryKeys(String catalog, String schema, String table) throws SQLException { String sql; if (connection.haveMinimumServerVersion(ServerVersion.v8_1)) { sql = "SELECT NULL AS TABLE_CAT, n.nspname AS TABLE_SCHEM, " + " ct.relname AS TABLE_NAME, a.attname AS COLUMN_NAME, " + " (i.keys).n AS KEY_SEQ, ci.relname AS PK_NAME " + "FROM pg_catalog.pg_class ct " + " JOIN pg_catalog.pg_attribute a ON (ct.oid = a.attrelid) " + " JOIN pg_catalog.pg_namespace n ON (ct.relnamespace = n.oid) " + " JOIN (SELECT i.indexrelid, i.indrelid, i.indisprimary, " + " information_schema._pg_expandarray(i.indkey) AS keys " + " FROM pg_catalog.pg_index i) i " + " ON (a.attnum = (i.keys).x AND a.attrelid = i.indrelid) " + " JOIN pg_catalog.pg_class ci ON (ci.oid = i.indexrelid) " + "WHERE true "; if (schema != null && !"".equals(schema)) { sql += " AND n.nspname = " + escapeQuotes(schema); } } else { String select; String from; String where = ""; if (connection.haveMinimumServerVersion(ServerVersion.v7_3)) { select = "SELECT NULL AS TABLE_CAT, n.nspname AS TABLE_SCHEM, "; from = " FROM pg_catalog.pg_namespace n, pg_catalog.pg_class ct, pg_catalog.pg_class ci, pg_catalog.pg_attribute a, pg_catalog.pg_index i "; where = " AND ct.relnamespace = n.oid "; if (schema != null && !"".equals(schema)) { where += " AND n.nspname = " + escapeQuotes(schema); } } else { select = "SELECT NULL AS TABLE_CAT, NULL AS TABLE_SCHEM, "; from = " FROM pg_class ct, pg_class ci, pg_attribute a, pg_index i "; } sql = select + " ct.relname AS TABLE_NAME, " + " a.attname AS COLUMN_NAME, " + " a.attnum AS KEY_SEQ, " + " ci.relname AS PK_NAME " + from + " WHERE ct.oid=i.indrelid AND ci.oid=i.indexrelid " + " AND a.attrelid=ci.oid " + where; } if (table != null && !"".equals(table)) { sql += " AND ct.relname = " + escapeQuotes(table); } sql += " AND i.indisprimary " + " ORDER BY table_name, pk_name, key_seq"; return createMetaDataStatement().executeQuery(sql); } /** * @param primaryCatalog primary catalog * @param primarySchema primary schema * @param primaryTable if provided will get the keys exported by this table * @param foreignCatalog foreign catalog * @param foreignSchema foreign schema * @param foreignTable if provided will get the keys imported by this table * @return ResultSet * @throws SQLException if something wrong happens */ protected java.sql.ResultSet getImportedExportedKeys(String primaryCatalog, String primarySchema, String primaryTable, String foreignCatalog, String foreignSchema, String foreignTable) throws SQLException { Field f[] = new Field[14]; f[0] = new Field("PKTABLE_CAT", Oid.VARCHAR); f[1] = new Field("PKTABLE_SCHEM", Oid.VARCHAR); f[2] = new Field("PKTABLE_NAME", Oid.VARCHAR); f[3] = new Field("PKCOLUMN_NAME", Oid.VARCHAR); f[4] = new Field("FKTABLE_CAT", Oid.VARCHAR); f[5] = new Field("FKTABLE_SCHEM", Oid.VARCHAR); f[6] = new Field("FKTABLE_NAME", Oid.VARCHAR); f[7] = new Field("FKCOLUMN_NAME", Oid.VARCHAR); f[8] = new Field("KEY_SEQ", Oid.INT2); f[9] = new Field("UPDATE_RULE", Oid.INT2); f[10] = new Field("DELETE_RULE", Oid.INT2); f[11] = new Field("FK_NAME", Oid.VARCHAR); f[12] = new Field("PK_NAME", Oid.VARCHAR); f[13] = new Field("DEFERRABILITY", Oid.INT2); String select; String from; String where = ""; /* * The addition of the pg_constraint in 7.3 table should have really * helped us out here, but it comes up just a bit short. * - The conkey, confkey columns aren't really useful without * contrib/array unless we want to issues separate queries. * - Unique indexes that can support foreign keys are not necessarily * added to pg_constraint. Also multiple unique indexes covering * the same keys can be created which make it difficult to determine * the PK_NAME field. */ if (connection.haveMinimumServerVersion(ServerVersion.v7_4)) { String sql = "SELECT NULL::text AS PKTABLE_CAT, pkn.nspname AS PKTABLE_SCHEM, pkc.relname AS PKTABLE_NAME, pka.attname AS PKCOLUMN_NAME, " + "NULL::text AS FKTABLE_CAT, fkn.nspname AS FKTABLE_SCHEM, fkc.relname AS FKTABLE_NAME, fka.attname AS FKCOLUMN_NAME, " + "pos.n AS KEY_SEQ, " + "CASE con.confupdtype " + " WHEN 'c' THEN " + DatabaseMetaData.importedKeyCascade + " WHEN 'n' THEN " + DatabaseMetaData.importedKeySetNull + " WHEN 'd' THEN " + DatabaseMetaData.importedKeySetDefault + " WHEN 'r' THEN " + DatabaseMetaData.importedKeyRestrict + " WHEN 'a' THEN " + DatabaseMetaData.importedKeyNoAction + " ELSE NULL END AS UPDATE_RULE, " + "CASE con.confdeltype " + " WHEN 'c' THEN " + DatabaseMetaData.importedKeyCascade + " WHEN 'n' THEN " + DatabaseMetaData.importedKeySetNull + " WHEN 'd' THEN " + DatabaseMetaData.importedKeySetDefault + " WHEN 'r' THEN " + DatabaseMetaData.importedKeyRestrict + " WHEN 'a' THEN " + DatabaseMetaData.importedKeyNoAction + " ELSE NULL END AS DELETE_RULE, " + "con.conname AS FK_NAME, pkic.relname AS PK_NAME, " + "CASE " + " WHEN con.condeferrable AND con.condeferred THEN " + DatabaseMetaData.importedKeyInitiallyDeferred + " WHEN con.condeferrable THEN " + DatabaseMetaData.importedKeyInitiallyImmediate + " ELSE " + DatabaseMetaData.importedKeyNotDeferrable + " END AS DEFERRABILITY " + " FROM " + " pg_catalog.pg_namespace pkn, pg_catalog.pg_class pkc, pg_catalog.pg_attribute pka, " + " pg_catalog.pg_namespace fkn, pg_catalog.pg_class fkc, pg_catalog.pg_attribute fka, " + " pg_catalog.pg_constraint con, "; if (connection.haveMinimumServerVersion(ServerVersion.v8_0)) { sql += " pg_catalog.generate_series(1, " + getMaxIndexKeys() + ") pos(n), "; } else { sql += " information_schema._pg_keypositions() pos(n), "; } sql += " pg_catalog.pg_depend dep, pg_catalog.pg_class pkic " + " WHERE pkn.oid = pkc.relnamespace AND pkc.oid = pka.attrelid AND pka.attnum = con.confkey[pos.n] AND con.confrelid = pkc.oid " + " AND fkn.oid = fkc.relnamespace AND fkc.oid = fka.attrelid AND fka.attnum = con.conkey[pos.n] AND con.conrelid = fkc.oid " + " AND con.contype = 'f' AND con.oid = dep.objid AND pkic.oid = dep.refobjid AND pkic.relkind = 'i' AND dep.classid = 'pg_constraint'::regclass::oid AND dep.refclassid = 'pg_class'::regclass::oid "; if (primarySchema != null && !"".equals(primarySchema)) { sql += " AND pkn.nspname = " + escapeQuotes(primarySchema); } if (foreignSchema != null && !"".equals(foreignSchema)) { sql += " AND fkn.nspname = " + escapeQuotes(foreignSchema); } if (primaryTable != null && !"".equals(primaryTable)) { sql += " AND pkc.relname = " + escapeQuotes(primaryTable); } if (foreignTable != null && !"".equals(foreignTable)) { sql += " AND fkc.relname = " + escapeQuotes(foreignTable); } if (primaryTable != null) { sql += " ORDER BY fkn.nspname,fkc.relname,con.conname,pos.n"; } else { sql += " ORDER BY pkn.nspname,pkc.relname, con.conname,pos.n"; } return createMetaDataStatement().executeQuery(sql); } else if (connection.haveMinimumServerVersion(ServerVersion.v7_3)) { select = "SELECT DISTINCT n1.nspname as pnspname,n2.nspname as fnspname, "; from = " FROM pg_catalog.pg_namespace n1 " + " JOIN pg_catalog.pg_class c1 ON (c1.relnamespace = n1.oid) " + " JOIN pg_catalog.pg_index i ON (c1.oid=i.indrelid) " + " JOIN pg_catalog.pg_class ic ON (i.indexrelid=ic.oid) " + " JOIN pg_catalog.pg_attribute a ON (ic.oid=a.attrelid), " + " pg_catalog.pg_namespace n2 " + " JOIN pg_catalog.pg_class c2 ON (c2.relnamespace=n2.oid), " + " pg_catalog.pg_trigger t1 " + " JOIN pg_catalog.pg_proc p1 ON (t1.tgfoid=p1.oid), " + " pg_catalog.pg_trigger t2 " + " JOIN pg_catalog.pg_proc p2 ON (t2.tgfoid=p2.oid) "; if (primarySchema != null && !"".equals(primarySchema)) { where += " AND n1.nspname = " + escapeQuotes(primarySchema); } if (foreignSchema != null && !"".equals(foreignSchema)) { where += " AND n2.nspname = " + escapeQuotes(foreignSchema); } } else { select = "SELECT DISTINCT NULL::text as pnspname, NULL::text as fnspname, "; from = " FROM pg_class c1 " + " JOIN pg_index i ON (c1.oid=i.indrelid) " + " JOIN pg_class ic ON (i.indexrelid=ic.oid) " + " JOIN pg_attribute a ON (ic.oid=a.attrelid), " + " pg_class c2, " + " pg_trigger t1 " + " JOIN pg_proc p1 ON (t1.tgfoid=p1.oid), " + " pg_trigger t2 " + " JOIN pg_proc p2 ON (t2.tgfoid=p2.oid) "; } String sql = select + "c1.relname as prelname, " + "c2.relname as frelname, " + "t1.tgconstrname, " + "a.attnum as keyseq, " + "ic.relname as fkeyname, " + "t1.tgdeferrable, " + "t1.tginitdeferred, " + "t1.tgnargs,t1.tgargs, " + "p1.proname as updaterule, " + "p2.proname as deleterule " + from + "WHERE " // isolate the update rule + "(t1.tgrelid=c1.oid " + "AND t1.tgisconstraint " + "AND t1.tgconstrrelid=c2.oid " + "AND p1.proname ~ '^RI_FKey_.*_upd$') " + "AND " // isolate the delete rule + "(t2.tgrelid=c1.oid " + "AND t2.tgisconstraint " + "AND t2.tgconstrrelid=c2.oid " + "AND p2.proname ~ '^RI_FKey_.*_del$') " + "AND i.indisprimary " + where; if (primaryTable != null) { sql += "AND c1.relname=" + escapeQuotes(primaryTable); } if (foreignTable != null) { sql += "AND c2.relname=" + escapeQuotes(foreignTable); } sql += "ORDER BY "; // orderby is as follows getExported, orders by FKTABLE, // getImported orders by PKTABLE // getCrossReference orders by FKTABLE, so this should work for both, // since when getting crossreference, primaryTable will be defined if (primaryTable != null) { if (connection.haveMinimumServerVersion(ServerVersion.v7_3)) { sql += "fnspname,"; } sql += "frelname"; } else { if (connection.haveMinimumServerVersion(ServerVersion.v7_3)) { sql += "pnspname,"; } sql += "prelname"; } sql += ",keyseq"; Statement stmt = connection.createStatement(); ResultSet rs = stmt.executeQuery(sql); // returns the following columns // and some example data with a table defined as follows // create table people ( id int primary key); // create table policy ( id int primary key); // create table users ( id int primary key, people_id int references people(id), policy_id int references policy(id)) // prelname | frelname | tgconstrname | keyseq | fkeyName | tgdeferrable | tginitdeferred // 1 | 2 | 3 | 4 | 5 | 6 | 7 // people | users | | 1 | people_pkey | f | f // | tgnargs | tgargs | updaterule | deleterule // | 8 | 9 | 10 | 11 // | 6 | \000users\000people\000UNSPECIFIED\000people_id\000id\000 | RI_FKey_noaction_upd | RI_FKey_noaction_del List tuples = new ArrayList(); while ( rs.next() ) { byte tuple[][] = new byte[14][]; tuple[1] = rs.getBytes(1); //PKTABLE_SCHEM tuple[5] = rs.getBytes(2); //FKTABLE_SCHEM tuple[2] = rs.getBytes(3); //PKTABLE_NAME tuple[6] = rs.getBytes(4); //FKTABLE_NAME String fKeyName = rs.getString(5); String updateRule = rs.getString(12); if (updateRule != null ) { // Rules look like this RI_FKey_noaction_del so we want to pull out the part between the 'Key_' and the last '_' s String rule = updateRule.substring(8, updateRule.length() - 4); int action = java.sql.DatabaseMetaData.importedKeyNoAction; if ( rule == null || "noaction".equals(rule) ) action = java.sql.DatabaseMetaData.importedKeyNoAction; if ("cascade".equals(rule)) action = java.sql.DatabaseMetaData.importedKeyCascade; else if ("setnull".equals(rule)) action = java.sql.DatabaseMetaData.importedKeySetNull; else if ("setdefault".equals(rule)) action = java.sql.DatabaseMetaData.importedKeySetDefault; else if ("restrict".equals(rule)) action = java.sql.DatabaseMetaData.importedKeyRestrict; tuple[9] = connection.encodeString(Integer.toString(action)); } String deleteRule = rs.getString(13); if ( deleteRule != null ) { String rule = deleteRule.substring(8, deleteRule.length() - 4); int action = java.sql.DatabaseMetaData.importedKeyNoAction; if ("cascade".equals(rule)) action = java.sql.DatabaseMetaData.importedKeyCascade; else if ("setnull".equals(rule)) action = java.sql.DatabaseMetaData.importedKeySetNull; else if ("setdefault".equals(rule)) action = java.sql.DatabaseMetaData.importedKeySetDefault; else if ("restrict".equals(rule)) action = java.sql.DatabaseMetaData.importedKeyRestrict; tuple[10] = connection.encodeString(Integer.toString(action)); } int keySequence = rs.getInt(6); //KEY_SEQ // Parse the tgargs data String fkeyColumn = ""; String pkeyColumn = ""; String fkName = ""; // Note, I am guessing at most of this, but it should be close // if not, please correct // the keys are in pairs and start after the first four arguments // the arguments are seperated by \000 String targs = rs.getString(11); // args look like this //\000ww\000vv\000UNSPECIFIED\000m\000a\000n\000b\000 // we are primarily interested in the column names which are the last items in the string List tokens = tokenize(targs, "\\000"); if (tokens.size() > 0) { fkName = (String)tokens.get(0); } if (fkName.startsWith("")) { fkName = targs; } int element = 4 + (keySequence - 1) * 2; if (tokens.size() > element) { fkeyColumn = (String)tokens.get(element); } element++; if (tokens.size() > element) { pkeyColumn = (String)tokens.get(element); } tuple[3] = connection.encodeString(pkeyColumn); //PKCOLUMN_NAME tuple[7] = connection.encodeString(fkeyColumn); //FKCOLUMN_NAME tuple[8] = rs.getBytes(6); //KEY_SEQ tuple[11] = connection.encodeString(fkName); //FK_NAME this will give us a unique name for the foreign key tuple[12] = rs.getBytes(7); //PK_NAME // DEFERRABILITY int deferrability = java.sql.DatabaseMetaData.importedKeyNotDeferrable; boolean deferrable = rs.getBoolean(8); boolean initiallyDeferred = rs.getBoolean(9); if (deferrable) { if (initiallyDeferred) deferrability = java.sql.DatabaseMetaData.importedKeyInitiallyDeferred; else deferrability = java.sql.DatabaseMetaData.importedKeyInitiallyImmediate; } tuple[13] = connection.encodeString(Integer.toString(deferrability)); tuples.add(tuple); } rs.close(); stmt.close(); return (ResultSet) ((BaseStatement)createMetaDataStatement()).createDriverResultSet(f, tuples); } public java.sql.ResultSet getImportedKeys(String catalog, String schema, String table) throws SQLException { return getImportedExportedKeys(null, null, null, catalog, schema, table); } public java.sql.ResultSet getExportedKeys(String catalog, String schema, String table) throws SQLException { return getImportedExportedKeys(catalog, schema, table, null, null, null); } public java.sql.ResultSet getCrossReference(String primaryCatalog, String primarySchema, String primaryTable, String foreignCatalog, String foreignSchema, String foreignTable) throws SQLException { return getImportedExportedKeys(primaryCatalog, primarySchema, primaryTable, foreignCatalog, foreignSchema, foreignTable); } public java.sql.ResultSet getTypeInfo() throws SQLException { Field f[] = new Field[18]; List v = new ArrayList(); // The new ResultSet tuple stuff f[0] = new Field("TYPE_NAME", Oid.VARCHAR); f[1] = new Field("DATA_TYPE", Oid.INT2); f[2] = new Field("PRECISION", Oid.INT4); f[3] = new Field("LITERAL_PREFIX", Oid.VARCHAR); f[4] = new Field("LITERAL_SUFFIX", Oid.VARCHAR); f[5] = new Field("CREATE_PARAMS", Oid.VARCHAR); f[6] = new Field("NULLABLE", Oid.INT2); f[7] = new Field("CASE_SENSITIVE", Oid.BOOL); f[8] = new Field("SEARCHABLE", Oid.INT2); f[9] = new Field("UNSIGNED_ATTRIBUTE", Oid.BOOL); f[10] = new Field("FIXED_PREC_SCALE", Oid.BOOL); f[11] = new Field("AUTO_INCREMENT", Oid.BOOL); f[12] = new Field("LOCAL_TYPE_NAME", Oid.VARCHAR); f[13] = new Field("MINIMUM_SCALE", Oid.INT2); f[14] = new Field("MAXIMUM_SCALE", Oid.INT2); f[15] = new Field("SQL_DATA_TYPE", Oid.INT4); f[16] = new Field("SQL_DATETIME_SUB", Oid.INT4); f[17] = new Field("NUM_PREC_RADIX", Oid.INT4); String sql; if (connection.haveMinimumServerVersion(ServerVersion.v7_3)) { sql = "SELECT t.typname,t.oid FROM pg_catalog.pg_type t" + " JOIN pg_catalog.pg_namespace n ON (t.typnamespace = n.oid) " + " WHERE n.nspname != 'pg_toast'"; } else { sql = "SELECT typname,oid FROM pg_type" + " WHERE NOT (typname ~ '^pg_toast_') "; } Statement stmt = connection.createStatement(); ResultSet rs = stmt.executeQuery(sql); // cache some results, this will keep memory useage down, and speed // things up a little. byte bZero[] = connection.encodeString("0"); byte b10[] = connection.encodeString("10"); byte bf[] = connection.encodeString("f"); byte bt[] = connection.encodeString("t"); byte bliteral[] = connection.encodeString("'"); byte bNullable[] = connection.encodeString(Integer.toString(java.sql.DatabaseMetaData.typeNullable)); byte bSearchable[] = connection.encodeString(Integer.toString(java.sql.DatabaseMetaData.typeSearchable)); while (rs.next()) { byte[][] tuple = new byte[18][]; String typname = rs.getString(1); int typeOid = (int)rs.getLong(2); tuple[0] = connection.encodeString(typname); tuple[1] = connection.encodeString(Integer.toString(connection.getTypeInfo().getSQLType(typname))); tuple[2] = connection.encodeString(Integer.toString(connection.getTypeInfo().getMaximumPrecision(typeOid))); if (connection.getTypeInfo().requiresQuoting(typeOid)) { tuple[3] = bliteral; tuple[4] = bliteral; } tuple[6] = bNullable; // all types can be null tuple[7] = connection.getTypeInfo().isCaseSensitive(typeOid) ? bt : bf; tuple[8] = bSearchable; // any thing can be used in the WHERE clause tuple[9] = connection.getTypeInfo().isSigned(typeOid) ? bf : bt; tuple[10] = bf; // false for now - must handle money tuple[11] = bf; // false - it isn't autoincrement tuple[13] = bZero; // min scale is zero // only numeric can supports a scale. tuple[14] = (typeOid == Oid.NUMERIC) ? connection.encodeString("1000") : bZero; // 12 - LOCAL_TYPE_NAME is null // 15 & 16 are unused so we return null tuple[17] = b10; // everything is base 10 v.add(tuple); // add pseudo-type serial, bigserial if ( typname.equals("int4") ) { byte[][] tuple1 = (byte[][])tuple.clone(); tuple1[0] = connection.encodeString("serial"); tuple1[11] = bt; v.add(tuple1); } else if ( typname.equals("int8") ) { byte[][] tuple1 = (byte[][])tuple.clone(); tuple1[0] = connection.encodeString("bigserial"); tuple1[11] = bt; v.add(tuple1); } } rs.close(); stmt.close(); return (ResultSet) ((BaseStatement)createMetaDataStatement()).createDriverResultSet(f, v); } public java.sql.ResultSet getIndexInfo(String catalog, String schema, String tableName, boolean unique, boolean approximate) throws SQLException { /* This is a complicated function because we have three possible * situations: * <= 7.2 no schemas, single column functional index * 7.3 schemas, single column functional index * >= 7.4 schemas, multi-column expressional index * >= 8.3 supports ASC/DESC column info * >= 9.0 no longer renames index columns on a table column rename, * so we must look at the table attribute names * * with the single column functional index we need an extra * join to the table's pg_attribute data to get the column * the function operates on. */ String sql; if (connection.haveMinimumServerVersion(ServerVersion.v8_3)) { sql = "SELECT NULL AS TABLE_CAT, n.nspname AS TABLE_SCHEM, " + " ct.relname AS TABLE_NAME, NOT i.indisunique AS NON_UNIQUE, " + " NULL AS INDEX_QUALIFIER, ci.relname AS INDEX_NAME, " + " CASE i.indisclustered " + " WHEN true THEN " + java.sql.DatabaseMetaData.tableIndexClustered + " ELSE CASE am.amname " + " WHEN 'hash' THEN " + java.sql.DatabaseMetaData.tableIndexHashed + " ELSE " + java.sql.DatabaseMetaData.tableIndexOther + " END " + " END AS TYPE, " + " (i.keys).n AS ORDINAL_POSITION, " + " trim(both '\"' from pg_catalog.pg_get_indexdef(ci.oid, (i.keys).n, false)) AS COLUMN_NAME, " + " CASE am.amcanorder " + " WHEN true THEN CASE i.indoption[(i.keys).n - 1] & 1 " + " WHEN 1 THEN 'D' " + " ELSE 'A' " + " END " + " ELSE NULL " + " END AS ASC_OR_DESC, " + " ci.reltuples AS CARDINALITY, " + " ci.relpages AS PAGES, " + " pg_catalog.pg_get_expr(i.indpred, i.indrelid) AS FILTER_CONDITION " + "FROM pg_catalog.pg_class ct " + " JOIN pg_catalog.pg_namespace n ON (ct.relnamespace = n.oid) " + " JOIN (SELECT i.indexrelid, i.indrelid, i.indoption, " + " i.indisunique, i.indisclustered, i.indpred, " + " i.indexprs, " + " information_schema._pg_expandarray(i.indkey) AS keys " + " FROM pg_catalog.pg_index i) i " + " ON (ct.oid = i.indrelid) " + " JOIN pg_catalog.pg_class ci ON (ci.oid = i.indexrelid) " + " JOIN pg_catalog.pg_am am ON (ci.relam = am.oid) " + "WHERE true "; if (schema != null && !"".equals(schema)) { sql += " AND n.nspname = " + escapeQuotes(schema); } } else { String select; String from; String where = ""; if (connection.haveMinimumServerVersion(ServerVersion.v7_3)) { select = "SELECT NULL AS TABLE_CAT, n.nspname AS TABLE_SCHEM, "; from = " FROM pg_catalog.pg_namespace n, pg_catalog.pg_class ct, pg_catalog.pg_class ci, pg_catalog.pg_attribute a, pg_catalog.pg_am am "; where = " AND n.oid = ct.relnamespace "; if (!connection.haveMinimumServerVersion(ServerVersion.v7_4)) { from += ", pg_catalog.pg_attribute ai, pg_catalog.pg_index i LEFT JOIN pg_catalog.pg_proc ip ON (i.indproc = ip.oid) "; where += " AND ai.attnum = i.indkey[0] AND ai.attrelid = ct.oid "; } else { from += ", pg_catalog.pg_index i "; } if (schema != null && ! "".equals(schema)) { where += " AND n.nspname = " + escapeQuotes(schema); } } else { select = "SELECT NULL AS TABLE_CAT, NULL AS TABLE_SCHEM, "; from = " FROM pg_class ct, pg_class ci, pg_attribute a, pg_am am, pg_attribute ai, pg_index i LEFT JOIN pg_proc ip ON (i.indproc = ip.oid) "; where = " AND ai.attnum = i.indkey[0] AND ai.attrelid = ct.oid "; } sql = select + " ct.relname AS TABLE_NAME, NOT i.indisunique AS NON_UNIQUE, NULL AS INDEX_QUALIFIER, ci.relname AS INDEX_NAME, " + " CASE i.indisclustered " + " WHEN true THEN " + java.sql.DatabaseMetaData.tableIndexClustered + " ELSE CASE am.amname " + " WHEN 'hash' THEN " + java.sql.DatabaseMetaData.tableIndexHashed + " ELSE " + java.sql.DatabaseMetaData.tableIndexOther + " END " + " END AS TYPE, " + " a.attnum AS ORDINAL_POSITION, "; if( connection.haveMinimumServerVersion(ServerVersion.v7_4)) { sql += " CASE WHEN i.indexprs IS NULL THEN a.attname ELSE pg_catalog.pg_get_indexdef(ci.oid,a.attnum,false) END AS COLUMN_NAME, "; } else { sql += " CASE i.indproc WHEN 0 THEN a.attname ELSE ip.proname || '(' || ai.attname || ')' END AS COLUMN_NAME, "; } sql += " NULL AS ASC_OR_DESC, " + " ci.reltuples AS CARDINALITY, " + " ci.relpages AS PAGES, "; if( connection.haveMinimumServerVersion(ServerVersion.v7_3)) { sql += " pg_catalog.pg_get_expr(i.indpred, i.indrelid) AS FILTER_CONDITION "; } else if( connection.haveMinimumServerVersion(ServerVersion.v7_2)) { sql += " pg_get_expr(i.indpred, i.indrelid) AS FILTER_CONDITION "; } else { sql += " NULL AS FILTER_CONDITION "; } sql += from + " WHERE ct.oid=i.indrelid AND ci.oid=i.indexrelid AND a.attrelid=ci.oid AND ci.relam=am.oid " + where; } sql += " AND ct.relname = " + escapeQuotes(tableName); if (unique) { sql += " AND i.indisunique "; } sql += " ORDER BY NON_UNIQUE, TYPE, INDEX_NAME, ORDINAL_POSITION "; return createMetaDataStatement().executeQuery(sql); } /** * Tokenize based on words not on single characters. */ private static List tokenize(String input, String delimiter) { List result = new ArrayList(); int start = 0; int end = input.length(); int delimiterSize = delimiter.length(); while (start < end) { int delimiterIndex = input.indexOf(delimiter, start); if (delimiterIndex < 0) { result.add(input.substring(start)); break; } else { String token = input.substring(start, delimiterIndex); result.add(token); start = delimiterIndex + delimiterSize; } } return result; } // ** JDBC 2 Extensions ** public boolean supportsResultSetType(int type) throws SQLException { // The only type we don't support return type != java.sql.ResultSet.TYPE_SCROLL_SENSITIVE; } public boolean supportsResultSetConcurrency(int type, int concurrency) throws SQLException { // These combinations are not supported! if (type == java.sql.ResultSet.TYPE_SCROLL_SENSITIVE) return false; // We do support Updateable ResultSets if (concurrency == java.sql.ResultSet.CONCUR_UPDATABLE) return true; // Everything else we do return true; } /* lots of unsupported stuff... */ public boolean ownUpdatesAreVisible(int type) throws SQLException { return true; } public boolean ownDeletesAreVisible(int type) throws SQLException { return true; } public boolean ownInsertsAreVisible(int type) throws SQLException { // indicates that return true; } public boolean othersUpdatesAreVisible(int type) throws SQLException { return false; } public boolean othersDeletesAreVisible(int i) throws SQLException { return false; } public boolean othersInsertsAreVisible(int type) throws SQLException { return false; } public boolean updatesAreDetected(int type) throws SQLException { return false; } public boolean deletesAreDetected(int i) throws SQLException { return false; } public boolean insertsAreDetected(int type) throws SQLException { return false; } public boolean supportsBatchUpdates() throws SQLException { return true; } public java.sql.ResultSet getUDTs(String catalog, String schemaPattern, String typeNamePattern, int[] types ) throws SQLException { String sql = "select " + "null as type_cat, n.nspname as type_schem, t.typname as type_name, null as class_name, " + "CASE WHEN t.typtype='c' then " + java.sql.Types.STRUCT + " else " + java.sql.Types.DISTINCT + " end as data_type, pg_catalog.obj_description(t.oid, 'pg_type') " + "as remarks, CASE WHEN t.typtype = 'd' then (select CASE"; for (Iterator i = connection.getTypeInfo().getPGTypeNamesWithSQLTypes(); i.hasNext();) { String pgType = (String)i.next(); int sqlType = connection.getTypeInfo().getSQLType(pgType); sql += " when typname = " + escapeQuotes(pgType) + " then " + sqlType; } sql += " else " + java.sql.Types.OTHER + " end from pg_type where oid=t.typbasetype) " + "else null end as base_type " + "from pg_catalog.pg_type t, pg_catalog.pg_namespace n where t.typnamespace = n.oid and n.nspname != 'pg_catalog' and n.nspname != 'pg_toast'"; String toAdd = ""; if ( types != null ) { toAdd += " and (false "; for (int type : types) { switch (type) { case Types.STRUCT: toAdd += " or t.typtype = 'c'"; break; case Types.DISTINCT: toAdd += " or t.typtype = 'd'"; break; } } toAdd += " ) "; } else { toAdd += " and t.typtype IN ('c','d') "; } // spec says that if typeNamePattern is a fully qualified name // then the schema and catalog are ignored if (typeNamePattern != null) { // search for qualifier int firstQualifier = typeNamePattern.indexOf('.') ; int secondQualifier = typeNamePattern.lastIndexOf('.'); if ( firstQualifier != -1 ) // if one of them is -1 they both will be { if ( firstQualifier != secondQualifier ) { // we have a catalog.schema.typename, ignore catalog schemaPattern = typeNamePattern.substring(firstQualifier + 1, secondQualifier); } else { // we just have a schema.typename schemaPattern = typeNamePattern.substring(0, firstQualifier); } // strip out just the typeName typeNamePattern = typeNamePattern.substring(secondQualifier + 1); } toAdd += " and t.typname like " + escapeQuotes(typeNamePattern); } // schemaPattern may have been modified above if ( schemaPattern != null) { toAdd += " and n.nspname like " + escapeQuotes(schemaPattern); } sql += toAdd; sql += " order by data_type, type_schem, type_name"; java.sql.ResultSet rs = createMetaDataStatement().executeQuery(sql); return rs; } public java.sql.Connection getConnection() throws SQLException { return (java.sql.Connection)connection; } /* I don't find these in the spec!?! */ public boolean rowChangesAreDetected(int type) throws SQLException { return false; } public boolean rowChangesAreVisible(int type) throws SQLException { return false; } protected java.sql.Statement createMetaDataStatement() throws SQLException { return connection.createStatement(java.sql.ResultSet.TYPE_SCROLL_INSENSITIVE, java.sql.ResultSet.CONCUR_READ_ONLY); } public long getMaxLogicalLobSize() throws SQLException { return 0; } public boolean supportsRefCursors() throws SQLException { return false; } public RowIdLifetime getRowIdLifetime() throws SQLException { throw org.postgresql.Driver.notImplemented(this.getClass(), "getRowIdLifetime()"); } public ResultSet getSchemas(String catalog, String schemaPattern) throws SQLException { return getSchemas(getJDBCMajorVersion(), catalog, schemaPattern); } public boolean supportsStoredFunctionsUsingCallSyntax() throws SQLException { return true; } public boolean autoCommitFailureClosesAllResultSets() throws SQLException { return false; } public ResultSet getClientInfoProperties() throws SQLException { Field f[] = new Field[4]; f[0] = new Field("NAME", Oid.VARCHAR); f[1] = new Field("MAX_LEN", Oid.INT4); f[2] = new Field("DEFAULT_VALUE", Oid.VARCHAR); f[3] = new Field("DESCRIPTION", Oid.VARCHAR); List v = new ArrayList(); if (connection.haveMinimumServerVersion(ServerVersion.v9_0)) { byte[][] tuple = new byte[4][]; tuple[0] = connection.encodeString("ApplicationName"); tuple[1] = connection.encodeString(Integer.toString(getMaxNameLength())); tuple[2] = connection.encodeString(""); tuple[3] = connection.encodeString("The name of the application currently utilizing the connection."); v.add(tuple); } return (ResultSet) ((BaseStatement) createMetaDataStatement()).createDriverResultSet(f, v); } public boolean providesQueryObjectGenerator() throws SQLException { return false; } public boolean isWrapperFor(Class iface) throws SQLException { return iface.isAssignableFrom(getClass()); } public T unwrap(Class iface) throws SQLException { if (iface.isAssignableFrom(getClass())) { return iface.cast(this); } throw new SQLException("Cannot unwrap to " + iface.getName()); } public ResultSet getFunctions(String catalog, String schemaPattern, String functionNamePattern) throws SQLException { return getProcedures(getJDBCMajorVersion(), catalog, schemaPattern, functionNamePattern); } public ResultSet getFunctionColumns(String catalog, String schemaPattern, String functionNamePattern, String columnNamePattern) throws SQLException { return getProcedureColumns(getJDBCMajorVersion(), catalog, schemaPattern, functionNamePattern, columnNamePattern); } public int getJDBCMajorVersion() throws SQLException { // FIXME: dependent on JDBC version return 4; } public ResultSet getPseudoColumns(String catalog, String schemaPattern, String tableNamePattern, String columnNamePattern) throws SQLException { throw org.postgresql.Driver.notImplemented(this.getClass(), "getPseudoColumns(String, String, String, String)"); } public boolean generatedKeyAlwaysReturned() throws SQLException { return true; } public boolean supportsSavepoints() throws SQLException { return connection.haveMinimumServerVersion(ServerVersion.v8_0); } public boolean supportsNamedParameters() throws SQLException { return false; } public boolean supportsMultipleOpenResults() throws SQLException { return false; } public boolean supportsGetGeneratedKeys() throws SQLException { // We don't support returning generated keys by column index, // but that should be a rarer case than the ones we do support. // return connection.haveMinimumServerVersion(ServerVersion.v8_2); } public ResultSet getSuperTypes(String catalog, String schemaPattern, String typeNamePattern) throws SQLException { throw org.postgresql.Driver.notImplemented(this.getClass(), "getSuperTypes(String,String,String)"); } public ResultSet getSuperTables(String catalog, String schemaPattern, String tableNamePattern) throws SQLException { throw org.postgresql.Driver.notImplemented(this.getClass(), "getSuperTables(String,String,String,String)"); } public ResultSet getAttributes(String catalog, String schemaPattern, String typeNamePattern, String attributeNamePattern) throws SQLException { throw org.postgresql.Driver.notImplemented(this.getClass(), "getAttributes(String,String,String,String)"); } public boolean supportsResultSetHoldability(int holdability) throws SQLException { return true; } public int getResultSetHoldability() throws SQLException { return ResultSet.HOLD_CURSORS_OVER_COMMIT; } public int getDatabaseMajorVersion() throws SQLException { return connection.getServerMajorVersion(); } public int getDatabaseMinorVersion() throws SQLException { return connection.getServerMinorVersion(); } public int getJDBCMinorVersion() throws SQLException { return 0; // This class implements JDBC 3.0 } public int getSQLStateType() throws SQLException { return sqlStateSQL99; } public boolean locatorsUpdateCopy() throws SQLException { /* * Currently LOB's aren't updateable at all, so it doesn't * matter what we return. We don't throw the notImplemented * Exception because the 1.5 JDK's CachedRowSet calls this * method regardless of wether large objects are used. */ return true; } public boolean supportsStatementPooling() throws SQLException { return false; } }




© 2015 - 2024 Weber Informatics LLC | Privacy Policy