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.5
Show newest version
/*-------------------------------------------------------------------------
*
* Copyright (c) 2004-2015, PostgreSQL Global Development Group
*
*
*-------------------------------------------------------------------------
*/

package org.postgresql.jdbc;

import org.postgresql.Driver;
import org.postgresql.core.BaseStatement;
import org.postgresql.core.Field;
import org.postgresql.core.Oid;
import org.postgresql.core.ServerVersion;
import org.postgresql.util.GT;
import org.postgresql.util.JdbcBlackHole;
import org.postgresql.util.PSQLException;
import org.postgresql.util.PSQLState;

import java.sql.Array;
import java.sql.Connection;
import java.sql.DatabaseMetaData;
import java.sql.ResultSet;
import java.sql.RowIdLifetime;
import java.sql.SQLException;
import java.sql.Statement;
import java.sql.Types;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.Iterator;
import java.util.List;
import java.util.Map;
import java.util.StringTokenizer;

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 = null;
      try {
        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);
      } finally {
        JdbcBlackHole.close(rs);
        JdbcBlackHole.close(stmt);
      }
    }
    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 = null;
      try {
        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");
      } finally {
        JdbcBlackHole.close(rs);
        JdbcBlackHole.close(stmt);
      }
    }
    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
   * @throws 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 doesn't use local files.
   *
   * @return true if so
   * @throws 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
   * @throws 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
   * @throws 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
   * @throws 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 * @throws 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 identifier, so we can't * possibly list them all. * * From the file src/backend/parser/scan.l, an identifier is ident_start [A-Za-z\200-\377_] * ident_cont [A-Za-z\200-\377_0-9\$] identifier {ident_start}{ident_cont}* * * @return a string containing the extra characters * @throws 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 * @throws 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 * @throws 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+ * @throws 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 * @throws 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 guarantee that. In * further reflection. we are talking a Statement object here, so the answer is yes, since the * Statement is only a vehicle to ExecSQL() * * @return true */ public boolean supportsOpenStatementsAcrossCommit() throws SQLException { return true; } /** * {@inheritDoc} *

* Can statements remain open across rollbacks? They may, but this driver cannot guarantee that. * In further contemplation, we are talking a Statement object here, so the answer is yes, since * the Statement is only a vehicle to ExecSQL() in Connection * * @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 * @throws 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 * @throws 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 * @throws 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 * @return string literal for direct inclusion into a query * @throws SQLException if something wrong happens */ 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 ResultSet getProcedures(String catalog, String schemaPattern, String procedureNamePattern) throws SQLException { return getProcedures(getJDBCMajorVersion(), catalog, schemaPattern, procedureNamePattern); } protected 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 ResultSet getProcedureColumns(String catalog, String schemaPattern, String procedureNamePattern, String columnNamePattern) throws SQLException { return getProcedureColumns(getJDBCMajorVersion(), catalog, schemaPattern, procedureNamePattern, columnNamePattern); } protected 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 < tempAllArgTypes.length; i++) { allArgTypes[i] = tempAllArgTypes[i]; } } numArgs = allArgTypes.length; } // decide if we are returning a single column result. if (returnTypeType.equals("b") || returnTypeType.equals("d") || returnTypeType.equals("e") || (returnTypeType.equals("p") && argModesArray == null)) { byte[][] tuple = new byte[columns][]; tuple[0] = null; tuple[1] = schema; tuple[2] = procedureName; tuple[3] = connection.encodeString("returnValue"); tuple[4] = connection .encodeString(Integer.toString(java.sql.DatabaseMetaData.procedureColumnReturn)); tuple[5] = connection .encodeString(Integer.toString(connection.getTypeInfo().getSQLType(returnType))); tuple[6] = connection.encodeString(connection.getTypeInfo().getPGType(returnType)); 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); } // 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 = 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 ((BaseStatement) createMetaDataStatement()).createDriverResultSet(f, v); } public 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 = tableTypeClauses.get(type); if (clauses != null) { String clause = 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 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 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 ((BaseStatement) createMetaDataStatement()).createDriverResultSet(f, v); } public ResultSet getTableTypes() throws SQLException { String types[] = new String[tableTypeClauses.size()]; Iterator e = tableTypeClauses.keySet().iterator(); int i = 0; while (e.hasNext()) { types[i++] = 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 ((BaseStatement) createMetaDataStatement()).createDriverResultSet(f, v); } protected 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 // Is nullable tuple[17] = connection.encodeString(rs.getBoolean("attnotnull") ? "NO" : "YES"); 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 ((BaseStatement) createMetaDataStatement()).createDriverResultSet(f, v); } public ResultSet getColumns(String catalog, String schemaPattern, String tableNamePattern, String columnNamePattern) throws SQLException { return getColumns(getJDBCMajorVersion(), catalog, schemaPattern, tableNamePattern, columnNamePattern); } public 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++] = e.next(); } sortStringArray(permNames); for (i = 0; i < permNames.length; i++) { byte[] privilege = connection.encodeString(permNames[i]); Map> grantees = permissions.get(permNames[i]); String granteeUsers[] = new String[grantees.size()]; Iterator g = grantees.keySet().iterator(); int k = 0; while (g.hasNext()) { granteeUsers[k++] = g.next(); } for (int j = 0; j < grantees.size(); j++) { List grantor = grantees.get(granteeUsers[j]); String grantee = granteeUsers[j]; for (String[] grants : grantor) { 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 ((BaseStatement) createMetaDataStatement()).createDriverResultSet(f, v); } public 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++] = e.next(); } sortStringArray(permNames); for (i = 0; i < permNames.length; i++) { byte[] privilege = connection.encodeString(permNames[i]); Map> grantees = permissions.get(permNames[i]); String granteeUsers[] = new String[grantees.size()]; Iterator g = grantees.keySet().iterator(); int k = 0; while (g.hasNext()) { granteeUsers[k++] = g.next(); } for (String granteeUser : granteeUsers) { List grants = grantees.get(granteeUser); for (String[] grantTuple : grants) { // 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(granteeUser) ? "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(granteeUser); tuple[5] = privilege; tuple[6] = connection.encodeString(grantable); v.add(tuple); } } } } rs.close(); stmt.close(); return ((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.isEmpty()) { 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 = 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 static 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.isEmpty()) { 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 = 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 = 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 (String acl : acls) { addACLPrivileges(acl, privileges); } return privileges; } public 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 ((BaseStatement) createMetaDataStatement()).createDriverResultSet(f, v); } public 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 * whether 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 ((BaseStatement) createMetaDataStatement()).createDriverResultSet(f, v); } public 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 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 separated 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.isEmpty()) { fkName = tokens.get(0); } if (fkName.startsWith("")) { fkName = targs; } int element = 4 + (keySequence - 1) * 2; if (tokens.size() > element) { fkeyColumn = tokens.get(element); } element++; if (tokens.size() > element) { pkeyColumn = tokens.get(element); } tuple[3] = connection.encodeString(pkeyColumn); // PKCOLUMN_NAME tuple[7] = connection.encodeString(fkeyColumn); // FKCOLUMN_NAME tuple[8] = rs.getBytes(6); // KEY_SEQ // FK_NAME this will give us a unique name for the foreign key tuple[11] = connection.encodeString(fkName); 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 ((BaseStatement) createMetaDataStatement()).createDriverResultSet(f, tuples); } public ResultSet getImportedKeys(String catalog, String schema, String table) throws SQLException { return getImportedExportedKeys(null, null, null, catalog, schema, table); } public ResultSet getExportedKeys(String catalog, String schema, String table) throws SQLException { return getImportedExportedKeys(catalog, schema, table, null, null, null); } public 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 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 usage 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); int sqlType = connection.getTypeInfo().getSQLType(typname); tuple[1] = connection.encodeString(Integer.toString(sqlType)); tuple[2] = connection .encodeString(Integer.toString(connection.getTypeInfo().getMaximumPrecision(typeOid))); // Using requiresQuoting(oid) would might trigger select statements that might fail with NPE // if oid in question is being dropped. // requiresQuotingSqlType is not bulletproof, however, it solves the most visible NPE. if (connection.getTypeInfo().requiresQuotingSqlType(sqlType)) { 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 = tuple.clone(); tuple1[0] = connection.encodeString("serial"); tuple1[11] = bt; v.add(tuple1); } else if (typname.equals("int8")) { byte[][] tuple1 = tuple.clone(); tuple1[0] = connection.encodeString("bigserial"); tuple1[11] = bt; v.add(tuple1); } } rs.close(); stmt.close(); return ((BaseStatement) createMetaDataStatement()).createDriverResultSet(f, v); } public 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, " // TODO: Implement ASC_OR_DESC for PostgreSQL 9.6+ + (connection.haveMinimumServerVersion(ServerVersion.v9_6) ? " CASE am.amname " + " WHEN 'btree' THEN CASE i.indoption[(i.keys).n - 1] & 1 " + " WHEN 1 THEN 'D' " + " ELSE 'A' " + " END " + " ELSE NULL " + " END AS ASC_OR_DESC, " : " 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 != ResultSet.TYPE_SCROLL_SENSITIVE; } public boolean supportsResultSetConcurrency(int type, int concurrency) throws SQLException { // These combinations are not supported! if (type == ResultSet.TYPE_SCROLL_SENSITIVE) { return false; } // We do support Updateable ResultSets if (concurrency == 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 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 = 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"; return createMetaDataStatement().executeQuery(sql); } public java.sql.Connection getConnection() throws SQLException { return 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(ResultSet.TYPE_SCROLL_INSENSITIVE, ResultSet.CONCUR_READ_ONLY); } public long getMaxLogicalLobSize() throws SQLException { return 0; } public boolean supportsRefCursors() throws SQLException { return true; } 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 ((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 whether large objects are used. */ return true; } public boolean supportsStatementPooling() throws SQLException { return false; } }




© 2015 - 2025 Weber Informatics LLC | Privacy Policy