org.hsqldb.DatabaseInformationFull Maven / Gradle / Ivy
Show all versions of hsqldb Show documentation
/* Copyright (c) 2001-2008, The HSQL Development Group
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
* Redistributions of source code must retain the above copyright notice, this
* list of conditions and the following disclaimer.
*
* Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* Neither the name of the HSQL Development Group nor the names of its
* contributors may be used to endorse or promote products derived from this
* software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL HSQL DEVELOPMENT GROUP, HSQLDB.ORG,
* OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
* EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
package org.hsqldb;
import java.lang.reflect.Method;
import org.hsqldb.lib.FileUtil;
import org.hsqldb.lib.HashMap;
import org.hsqldb.lib.HashSet;
import org.hsqldb.lib.HsqlArrayList;
import org.hsqldb.lib.Iterator;
import org.hsqldb.persist.DataFileCache;
import org.hsqldb.persist.HsqlDatabaseProperties;
import org.hsqldb.persist.TextCache;
import org.hsqldb.scriptio.ScriptWriterBase;
import org.hsqldb.store.ValuePool;
// fredt@users - 1.7.2 - structural modifications to allow inheritance
// boucherb@users - 1.7.2 - 20020225
// - factored out all reusable code into DIXXX support classes
// - completed Fred's work on allowing inheritance
// boucherb@users - 1.7.2 - 20020304 - bug fixes, refinements, better java docs
// fredt@users - 1.8.0 - updated to report latest enhancements and changes
// boucherb@users - 1.8.0 - 20050515 - furhter SQL 2003 metadata support
/**
* Extends DatabaseInformationMain to provide additional system table
* support.
*
* @author boucherb@users
* @version 1.8.0
* @since 1.7.2
*/
final class DatabaseInformationFull
extends org.hsqldb.DatabaseInformationMain {
/** Provides SQL function/procedure reporting support. */
protected DIProcedureInfo pi;
/**
* Constructs a new DatabaseInformationFull instance.
*
* @param db the database for which to produce system tables.
* @throws HsqlException if a database access error occurs.
*/
DatabaseInformationFull(Database db) throws HsqlException {
super(db);
pi = new DIProcedureInfo(ns);
}
/**
* Retrieves the system table corresponding to the specified index.
*
* @param tableIndex index identifying the system table to generate
* @throws HsqlException if a database access error occurs
* @return the system table corresponding to the specified index
*/
protected Table generateTable(int tableIndex) throws HsqlException {
switch (tableIndex) {
case SYSTEM_PROCEDURECOLUMNS :
return SYSTEM_PROCEDURECOLUMNS();
case SYSTEM_PROCEDURES :
return SYSTEM_PROCEDURES();
case SYSTEM_SUPERTABLES :
return SYSTEM_SUPERTABLES();
case SYSTEM_SUPERTYPES :
return SYSTEM_SUPERTYPES();
case SYSTEM_UDTATTRIBUTES :
return SYSTEM_UDTATTRIBUTES();
case SYSTEM_UDTS :
return SYSTEM_UDTS();
case SYSTEM_VERSIONCOLUMNS :
return SYSTEM_VERSIONCOLUMNS();
// HSQLDB-specific
case SYSTEM_ALIASES :
return SYSTEM_ALIASES();
case SYSTEM_CACHEINFO :
return SYSTEM_CACHEINFO();
case SYSTEM_CLASSPRIVILEGES :
return SYSTEM_CLASSPRIVILEGES();
case SYSTEM_SESSIONINFO :
return SYSTEM_SESSIONINFO();
case SYSTEM_PROPERTIES :
return SYSTEM_PROPERTIES();
case SYSTEM_SESSIONS :
return SYSTEM_SESSIONS();
case SYSTEM_TRIGGERCOLUMNS :
return SYSTEM_TRIGGERCOLUMNS();
case SYSTEM_TRIGGERS :
return SYSTEM_TRIGGERS();
case SYSTEM_VIEWS :
return SYSTEM_VIEWS();
case SYSTEM_TEXTTABLES :
return SYSTEM_TEXTTABLES();
case SYSTEM_USAGE_PRIVILEGES :
return SYSTEM_USAGE_PRIVILEGES();
case SYSTEM_CHECK_COLUMN_USAGE :
return SYSTEM_CHECK_COLUMN_USAGE();
case SYSTEM_CHECK_ROUTINE_USAGE :
return SYSTEM_CHECK_ROUTINE_USAGE();
case SYSTEM_CHECK_TABLE_USAGE :
return SYSTEM_CHECK_TABLE_USAGE();
case SYSTEM_TABLE_CONSTRAINTS :
return SYSTEM_TABLE_CONSTRAINTS();
case SYSTEM_VIEW_TABLE_USAGE :
return SYSTEM_VIEW_TABLE_USAGE();
case SYSTEM_VIEW_COLUMN_USAGE :
return SYSTEM_VIEW_COLUMN_USAGE();
case SYSTEM_VIEW_ROUTINE_USAGE :
return SYSTEM_VIEW_ROUTINE_USAGE();
case SYSTEM_AUTHORIZATIONS : {
return SYSTEM_AUTHORIZATIONS();
}
case SYSTEM_ROLE_AUTHORIZATION_DESCRIPTORS : {
return SYSTEM_ROLE_AUTHORIZATION_DESCRIPTORS();
}
case SYSTEM_SCHEMATA : {
return SYSTEM_SCHEMATA();
}
case SYSTEM_COLLATIONS : {
return SYSTEM_COLLATIONS();
}
default :
return super.generateTable(tableIndex);
}
}
/**
* Retrieves a Table object describing the aliases defined
* within this database.
*
* Currently two types of alias are reported: DOMAIN alaises (alternate
* names for column data types when issuing "CREATE TABLE" DDL) and
* ROUTINE aliases (alternate names that can be used when invoking
* routines as SQL functions or stored procedures).
*
* Each row is an alias description with the following columns:
*
*
* OBJECT_TYPE VARCHAR type of the aliased object
* OBJECT_CAT VARCHAR catalog of the aliased object
* OBJECT_SCHEM VARCHAR schema of the aliased object
* OBJECT_NAME VARCHAR simple identifier of the aliased object
* ALIAS_CAT VARCHAR catalog in which alias is defined
* ALIAS_SCHEM VARCHAR schema in which alias is defined
* ALIAS VARCHAR alias for the indicated object
*
*
* Note: Up to and including HSQLDB 1.7.2, user-defined aliases
* are supported only for SQL function and stored procedure calls
* (indicated by the value "ROUTINE" in the OBJECT_TYPE
* column), and there is no syntax for dropping aliases, only for
* creating them.
* @return a Table object describing the accessisble
* aliases in the context of the calling session
* @throws HsqlException if an error occurs while producing the table
*/
Table SYSTEM_ALIASES() throws HsqlException {
Table t = sysTables[SYSTEM_ALIASES];
if (t == null) {
t = createBlankTable(sysTableHsqlNames[SYSTEM_ALIASES]);
addColumn(t, "OBJECT_TYPE", Types.VARCHAR, 32, false); // not null
addColumn(t, "OBJECT_CAT", Types.VARCHAR);
addColumn(t, "OBJECT_SCHEM", Types.VARCHAR);
addColumn(t, "OBJECT_NAME", Types.VARCHAR, false); // not null
addColumn(t, "ALIAS_CAT", Types.VARCHAR);
addColumn(t, "ALIAS_SCHEM", Types.VARCHAR);
addColumn(t, "ALIAS", Types.VARCHAR, false); // not null
// order: OBJECT_TYPE, OBJECT_NAME, ALIAS.
// true PK.
t.createPrimaryKey(null, new int[] {
0, 3, 6
}, true);
return t;
}
// Holders for calculated column values
String cat;
String schem;
String alias;
String objName;
String objType;
// Intermediate holders
String className;
HashMap hAliases;
Iterator aliases;
Object[] row;
int pos;
// Column number mappings
final int ialias_object_type = 0;
final int ialias_object_cat = 1;
final int ialias_object_schem = 2;
final int ialias_object_name = 3;
final int ialias_cat = 4;
final int ialias_schem = 5;
final int ialias = 6;
// Initialization
hAliases = database.getAliasMap();
aliases = hAliases.keySet().iterator();
objType = "ROUTINE";
// Do it.
while (aliases.hasNext()) {
row = t.getEmptyRowData();
alias = (String) aliases.next();
objName = (String) hAliases.get(alias);
// must have class grant to see method call aliases
pos = objName.lastIndexOf('.');
if (pos <= 0) {
// should never occur in practice, as this is typically a Java
// method name, but there's nothing preventing a user from
// creating an alias entry that is not in method FQN form;
// such entries are not illegal, only useless. Probably,
// we should eventually try to disallow them.
continue;
}
className = objName.substring(0, pos);
if (!session.isAccessible(className)) {
continue;
}
cat = ns.getCatalogName(objName);
schem = ns.getSchemaName(className);
row[ialias_object_type] = objType;
row[ialias_object_cat] = cat;
row[ialias_object_schem] = schem;
row[ialias_object_name] = objName;
row[ialias_cat] = cat;
row[ialias_schem] = schem;
row[ialias] = alias;
t.insertSys(row);
}
// must have create/alter table rights to see domain aliases
if (session.isAdmin()) {
Iterator typeAliases = Types.typeAliases.keySet().iterator();
objType = "DOMAIN";
while (typeAliases.hasNext()) {
row = t.getEmptyRowData();
alias = (String) typeAliases.next();
int tn = Types.typeAliases.get(alias, Integer.MIN_VALUE);
objName = Types.getTypeString(tn);
if (alias.equals(objName)) {
continue;
}
cat = ns.getCatalogName(objName);
schem = ns.getSchemaName(objName);
row[ialias_object_type] = objType;
row[ialias_object_cat] = cat;
row[ialias_object_schem] = schem;
row[ialias_object_name] = objName;
row[ialias_cat] = cat;
row[ialias_schem] = schem;
row[ialias] = alias;
t.insertSys(row);
}
}
t.setDataReadOnly(true);
return t;
}
/**
* Retrieves a Table object describing the current
* state of all row caching objects for the accessible
* tables defined within this database.
*
* Currently, the row caching objects for which state is reported are:
*
*
* - the system-wide
Cache object used by CACHED tables.
* - any
TextCache objects in use by [TEMP] TEXT tables.
*
*
* Each row is a cache object state description with the following
* columns:
*
*
* CACHE_FILE VARCHAR absolute path of cache data file
* MAX_CACHE_SIZE INTEGER maximum allowable cached Row objects
* MAX_CACHE_BYTE_SIZE INTEGER maximum allowable size of cached Row objects
* CACHE_LENGTH INTEGER number of data bytes currently cached
* CACHE_SIZE INTEGER number of rows currently cached
* FREE_BYTES INTEGER total bytes in available file allocation units
* FREE_COUNT INTEGER total # of allocation units available
* FREE_POS INTEGER largest file position allocated + 1
*
*
* Notes:
*
* TextCache objects do not maintain a free list because
* deleted rows are only marked deleted and never reused. As such, the
* columns FREE_BYTES, SMALLEST_FREE_ITEM, LARGEST_FREE_ITEM, and
* FREE_COUNT are always reported as zero for rows reporting on
* TextCache objects.
*
* Currently, CACHE_SIZE, FREE_BYTES, SMALLEST_FREE_ITEM, LARGEST_FREE_ITEM,
* FREE_COUNT and FREE_POS are the only dynamically changing values.
* All others are constant for the life of a cache object. In a future
* release, other column values may also change over the life of a cache
* object, as SQL syntax may eventually be introduced to allow runtime
* modification of certain cache properties.
*
* @return a description of the current state of all row caching
* objects associated with the accessible tables of the database
* @throws HsqlException if an error occurs while producing the table
*/
Table SYSTEM_CACHEINFO() throws HsqlException {
Table t = sysTables[SYSTEM_CACHEINFO];
if (t == null) {
t = createBlankTable(sysTableHsqlNames[SYSTEM_CACHEINFO]);
addColumn(t, "CACHE_FILE", Types.VARCHAR, false); // not null
addColumn(t, "MAX_CACHE_COUNT", Types.INTEGER, false); // not null
addColumn(t, "MAX_CACHE_BYTES", Types.BIGINT, false); // not null
addColumn(t, "CACHE_SIZE", Types.INTEGER, false); // not null
addColumn(t, "CACHE_BYTES", Types.BIGINT, false); // not null
addColumn(t, "FILE_FREE_BYTES", Types.INTEGER, false); // not null
addColumn(t, "FILE_FREE_COUNT", Types.INTEGER, false); // not null
addColumn(t, "FILE_FREE_POS", Types.BIGINT, false); // not null
t.createPrimaryKey(null, new int[]{ 0 }, true);
return t;
}
DataFileCache cache;
Object[] row;
HashSet cacheSet;
Iterator caches;
Iterator tables;
Table table;
int iFreeBytes;
int iLargestFreeItem;
long lSmallestFreeItem;
// column number mappings
final int icache_file = 0;
final int imax_cache_sz = 1;
final int imax_cache_bytes = 2;
final int icache_size = 3;
final int icache_length = 4;
final int ifree_bytes = 5;
final int ifree_count = 6;
final int ifree_pos = 7;
// Initialization
cacheSet = new HashSet();
// dynamic system tables are never cached
tables = database.schemaManager.allTablesIterator();
while (tables.hasNext()) {
table = (Table) tables.next();
if (table.isFileBased() && isAccessibleTable(table)) {
cache = table.getCache();
if (cache != null) {
cacheSet.add(cache);
}
}
}
caches = cacheSet.iterator();
// Do it.
while (caches.hasNext()) {
cache = (DataFileCache) caches.next();
row = t.getEmptyRowData();
row[icache_file] =
FileUtil.getDefaultInstance().canonicalOrAbsolutePath(
cache.getFileName());
row[imax_cache_sz] = ValuePool.getInt(cache.capacity());
row[imax_cache_bytes] = ValuePool.getLong(cache.bytesCapacity());
row[icache_size] = ValuePool.getInt(cache.getCachedObjectCount());
row[icache_length] =
ValuePool.getLong(cache.getTotalCachedBlockSize());
row[ifree_bytes] = ValuePool.getInt(cache.getTotalFreeBlockSize());
row[ifree_count] = ValuePool.getInt(cache.getFreeBlockCount());
row[ifree_pos] = ValuePool.getLong(cache.getFileFreePos());
t.insertSys(row);
}
t.setDataReadOnly(true);
return t;
}
/**
* Retrieves a Table object describing the visible
* access rights for all accessible Java Class objects defined
* within this database.
*
* Each row is a Class privilege description with the following
* columns:
*
*
* CLASS_CAT VARCHAR catalog in which the class is defined
* CLASS_SCHEM VARCHAR schema in which the class is defined
* CLASS_NAME VARCHAR fully qualified name of class
* GRANTOR VARCHAR grantor of access
* GRANTEE VARCHAR grantee of access
* PRIVILEGE VARCHAR name of access: {"EXECUTE" | "TRIGGER"}
* IS_GRANTABLE VARCHAR grantable?: {"YES" | "NO" | NULL (unknown)}
*
*
* Note: Users with the administrative privilege implicily have
* full and unrestricted access to all Classes available to the database
* class loader. However, only explicitly granted rights are reported
* in this table. Explicit Class grants/revokes to admin users have no
* effect in reality, but are reported in this table anyway for
* completeness.
*
* @return a Table object describing the visible
* access rights for all accessible Java Class
* objects defined within this database
* @throws HsqlException if an error occurs while producing the table
*/
Table SYSTEM_CLASSPRIVILEGES() throws HsqlException {
Table t = sysTables[SYSTEM_CLASSPRIVILEGES];
if (t == null) {
t = createBlankTable(sysTableHsqlNames[SYSTEM_CLASSPRIVILEGES]);
addColumn(t, "CLASS_CAT", Types.VARCHAR);
addColumn(t, "CLASS_SCHEM", Types.VARCHAR);
addColumn(t, "CLASS_NAME", Types.VARCHAR, false); // not null
addColumn(t, "GRANTOR", Types.VARCHAR, false); // not null
addColumn(t, "GRANTEE", Types.VARCHAR, false); // not null
addColumn(t, "PRIVILEGE", Types.VARCHAR, 7, false); // not null
addColumn(t, "IS_GRANTABLE", Types.VARCHAR, 3, false); // not null
t.createPrimaryKey(null, new int[] {
2, 4, 5
}, true);
return t;
}
// calculated column values
String clsCat;
String clsSchem;
String clsName;
String grantorName;
String granteeName;
String privilege;
String isGrantable;
// intermediate holders
UserManager um;
HsqlArrayList users;
HashSet classNameSet;
Iterator classNames;
User granteeUser;
Object[] row;
// column number mappings
final int icls_cat = 0;
final int icls_schem = 1;
final int icls_name = 2;
final int igrantor = 3;
final int igrantee = 4;
final int iprivilege = 5;
final int iis_grntbl = 6;
// Initialization
grantorName = GranteeManager.DBA_ADMIN_ROLE_NAME;
um = database.getUserManager();
users = um.listVisibleUsers(session, true);
// Do it.
for (int i = 0; i < users.size(); i++) {
granteeUser = (User) users.get(i);
granteeName = granteeUser.getName();
isGrantable = granteeUser.isAdmin() ? "YES"
: "NO";
classNameSet = granteeUser.getGrantedClassNames(false);
if (granteeUser.isPublic()) {
ns.addBuiltinToSet(classNameSet);
}
classNames = classNameSet.iterator();
// boucherb@users 20030305 - TODO completed.
// "EXECUTE" is closest to correct (from: SQL 200n ROUTINE_PRIVILEGES)
// There is nothing even like CLASS_PRIVILEGES table under SQL 200n spec.
privilege = "EXECUTE";
while (classNames.hasNext()) {
clsName = (String) classNames.next();
clsCat = ns.getCatalogName(clsName);
clsSchem = ns.getSchemaName(clsName);
row = t.getEmptyRowData();
row[icls_cat] = clsCat;
row[icls_schem] = clsSchem;
row[icls_name] = clsName;
row[igrantor] = grantorName;
row[igrantee] = granteeName;
row[iprivilege] = privilege;
row[iis_grntbl] = isGrantable;
t.insertSys(row);
}
classNames = ns.iterateAccessibleTriggerClassNames(granteeUser);
// boucherb@users 20030305 - TODO completed.
// "TRIGGER" is closest to correct. (from: SQL 200n TABLE_PRIVILEGES)
// There is nothing even like CLASS_PRIVILEGES table under SQL 200n spec.
privilege = "TRIGGER";
while (classNames.hasNext()) {
clsName = (String) classNames.next();
clsCat = ns.getCatalogName(clsName);
clsSchem = ns.getSchemaName(clsName);
row = t.getEmptyRowData();
row[icls_cat] = clsCat;
row[icls_schem] = clsSchem;
row[icls_name] = clsName;
row[igrantor] = grantorName;
row[igrantee] = granteeName;
row[iprivilege] = privilege;
row[iis_grntbl] = isGrantable;
t.insertSys(row);
}
}
t.setDataReadOnly(true);
return t;
}
/**
* Retrieves a Table object describing attributes
* for the calling session context.
*
* The rows report the following {key,value} pairs:
*
*
* KEY (VARCHAR) VALUE (VARCHAR)
* ------------------- ---------------
* SESSION_ID the id of the calling session
* AUTOCOMMIT YES: session is in autocommit mode, else NO
* USER the name of user connected in the calling session
* (was READ_ONLY)
* SESSION_READONLY TRUE: session is in read-only mode, else FALSE
* (new)
* DATABASE_READONLY TRUE: database is in read-only mode, else FALSE
* MAXROWS the MAXROWS setting in the calling session
* DATABASE the name of the database
* IDENTITY the last identity value used by calling session
*
*
* Note: This table may become deprecated in a future
* release, as the information it reports now duplicates information
* reported in the newer SYSTEM_SESSIONS and SYSTEM_PROPERTIES
* tables.
*
* @return a Table object describing the
* attributes of the connection associated
* with the current execution context
* @throws HsqlException if an error occurs while producing the table
*/
Table SYSTEM_SESSIONINFO() throws HsqlException {
Table t = sysTables[SYSTEM_SESSIONINFO];
if (t == null) {
t = createBlankTable(sysTableHsqlNames[SYSTEM_SESSIONINFO]);
addColumn(t, "KEY", Types.VARCHAR, false); // not null
addColumn(t, "VALUE", Types.VARCHAR, false); // not null
t.createPrimaryKey(null);
return t;
}
Object[] row;
row = t.getEmptyRowData();
row[0] = "SESSION_ID";
row[1] = String.valueOf(session.getId());
t.insertSys(row);
row = t.getEmptyRowData();
row[0] = "AUTOCOMMIT";
row[1] = session.isAutoCommit() ? "TRUE"
: "FALSE";
t.insertSys(row);
row = t.getEmptyRowData();
row[0] = "USER";
row[1] = session.getUsername();
t.insertSys(row);
row = t.getEmptyRowData();
row[0] = "SESSION_READONLY";
row[1] = session.isReadOnly() ? "TRUE"
: "FALSE";
t.insertSys(row);
row = t.getEmptyRowData();
row[0] = "DATABASE_READONLY";
row[1] = database.databaseReadOnly ? "TRUE"
: "FALSE";
t.insertSys(row);
// fredt - value set by SET MAXROWS in SQL, not Statement.setMaxRows()
row = t.getEmptyRowData();
row[0] = "MAXROWS";
row[1] = String.valueOf(session.getSQLMaxRows());
t.insertSys(row);
row = t.getEmptyRowData();
row[0] = "DATABASE";
row[1] = database.getURI();
t.insertSys(row);
row = t.getEmptyRowData();
row[0] = "IDENTITY";
row[1] = String.valueOf(session.getLastIdentity());
t.insertSys(row);
row = t.getEmptyRowData();
row[0] = "SCHEMA";
row[1] = String.valueOf(session.getSchemaName(null));
t.insertSys(row);
t.setDataReadOnly(true);
return t;
}
/**
* Retrieves a Table object describing the capabilities
* and operating parameter properties for the engine hosting this
* database, as well as their applicability in terms of scope and
* name space.
*
* Reported properties include certain predefined Database
* properties file values as well as certain database scope
* attributes.
*
* It is intended that all Database attributes and
* properties that can be set via the database properties file,
* JDBC connection properties or SQL SET/ALTER statements will
* eventually be reported here or, where more applicable, in an
* ANSI/ISO conforming feature info base table in the defintion
* schema.
*
* Currently, the database properties reported are:
*
*
* - hsqldb.cache_file_scale - the scaling factor used to translate data and index structure file pointers
*
- hsqldb.cache_scale - base-2 exponent scaling allowable cache row count
*
- hsqldb.cache_size_scale - base-2 exponent scaling allowable cache byte count
*
- hsqldb.cache_version -
*
- hsqldb.catalogs - whether to report the database catalog (database uri)
*
- hsqldb.compatible_version -
*
- hsqldb.files_readonly - whether the database is in files_readonly mode
*
- hsqldb.gc_interval - # new records forcing gc ({0|NULL}=>never)
*
- hsqldb.max_nio_scale - scale factor for cache nio mapped buffers
*
- hsqldb.nio_data_file - whether cache uses nio mapped buffers
*
- hsqldb.original_version -
*
- sql.enforce_strict_size - column length specifications enforced strictly (raise exception on overflow)?
*
- textdb.all_quoted - default policy regarding whether to quote all character field values
*
- textdb.cache_scale - base-2 exponent scaling allowable cache row count
*
- textdb.cache_size_scale - base-2 exponent scaling allowable cache byte count
*
- textdb.encoding - default TEXT table file encoding
*
- textdb.fs - default field separator
*
- textdb.vs - default varchar field separator
*
- textdb.lvs - default long varchar field separator
*
- textdb.ignore_first - default policy regarding whether to ignore the first line
*
- textdb.quoted - default policy regarding treatement character field values that _may_ require quoting
*
- IGNORECASE - create table VARCHAR_IGNORECASE?
*
- LOGSIZSE - # bytes to which REDO log grows before auto-checkpoint
*
- REFERENTIAL_INTEGITY - currently enforcing referential integrity?
*
- SCRIPTFORMAT - 0 : TEXT, 1 : BINARY, ...
*
- WRITEDELAY - does REDO log currently use buffered write strategy?
*
*
* @return table describing database and session operating parameters
* and capabilities
* @throws HsqlException if an error occurs while producing the table
*/
Table SYSTEM_PROPERTIES() throws HsqlException {
Table t = sysTables[SYSTEM_PROPERTIES];
if (t == null) {
t = createBlankTable(sysTableHsqlNames[SYSTEM_PROPERTIES]);
addColumn(t, "PROPERTY_SCOPE", Types.VARCHAR, false);
addColumn(t, "PROPERTY_NAMESPACE", Types.VARCHAR, false);
addColumn(t, "PROPERTY_NAME", Types.VARCHAR, false);
addColumn(t, "PROPERTY_VALUE", Types.VARCHAR);
addColumn(t, "PROPERTY_CLASS", Types.VARCHAR, false);
// order PROPERTY_SCOPE, PROPERTY_NAMESPACE, PROPERTY_NAME
// true PK
t.createPrimaryKey(null, new int[] {
0, 1, 2
}, true);
return t;
}
// calculated column values
String scope;
String nameSpace;
// intermediate holders
Object[] row;
HsqlDatabaseProperties props;
// column number mappings
final int iscope = 0;
final int ins = 1;
final int iname = 2;
final int ivalue = 3;
final int iclass = 4;
// First, we want the names and values for
// all JDBC capabilities constants
scope = "SESSION";
props = database.getProperties();
nameSpace = "database.properties";
// boolean properties
Iterator it = props.getUserDefinedPropertyData().iterator();
while (it.hasNext()) {
Object[] metaData = (Object[]) it.next();
row = t.getEmptyRowData();
row[iscope] = scope;
row[ins] = nameSpace;
row[iname] = metaData[HsqlDatabaseProperties.indexName];
row[ivalue] = props.getProperty((String) row[iname]);
row[iclass] = metaData[HsqlDatabaseProperties.indexClass];
t.insertSys(row);
}
row = t.getEmptyRowData();
row[iscope] = scope;
row[ins] = nameSpace;
row[iname] = "SCRIPTFORMAT";
try {
row[ivalue] =
ScriptWriterBase
.LIST_SCRIPT_FORMATS[database.logger.getScriptType()];
} catch (Exception e) {}
row[iclass] = "java.lang.String";
t.insertSys(row);
// write delay
row = t.getEmptyRowData();
row[iscope] = scope;
row[ins] = nameSpace;
row[iname] = "WRITE_DELAY";
row[ivalue] = "" + database.logger.getWriteDelay();
row[iclass] = "int";
t.insertSys(row);
// ignore case
row = t.getEmptyRowData();
row[iscope] = scope;
row[ins] = nameSpace;
row[iname] = "IGNORECASE";
row[ivalue] = database.isIgnoreCase() ? "true"
: "false";
row[iclass] = "boolean";
t.insertSys(row);
// referential integrity
row = t.getEmptyRowData();
row[iscope] = scope;
row[ins] = nameSpace;
row[iname] = "REFERENTIAL_INTEGRITY";
row[ivalue] = database.isReferentialIntegrity() ? "true"
: "false";
row[iclass] = "boolean";
t.insertSys(row);
t.setDataReadOnly(true);
return t;
}
/**
* Retrieves a Table object describing all visible
* sessions. ADMIN users see *all* sessions
* while non-admin users see only their own session.
*
* Each row is a session state description with the following columns:
*
*
* SESSION_ID INTEGER session identifier
* CONNECTED TIMESTAMP time at which session was created
* USER_NAME VARCHAR db user name of current session user
* IS_ADMIN BOOLEAN is session user an admin user?
* AUTOCOMMIT BOOLEAN is session in autocommit mode?
* READONLY BOOLEAN is session in read-only mode?
* MAXROWS INTEGER session's MAXROWS setting
* LAST_IDENTITY INTEGER last identity value used by this session
* TRANSACTION_SIZE INTEGER # of undo items in current transaction
* SCHEMA VARCHAR current schema for session
*
*
* @return a Table object describing all visible
* sessions
* @throws HsqlException if an error occurs while producing the table
*/
Table SYSTEM_SESSIONS() throws HsqlException {
Table t = sysTables[SYSTEM_SESSIONS];
if (t == null) {
t = createBlankTable(sysTableHsqlNames[SYSTEM_SESSIONS]);
addColumn(t, "SESSION_ID", Types.INTEGER, false);
addColumn(t, "CONNECTED", Types.TIMESTAMP, false);
addColumn(t, "USER_NAME", Types.VARCHAR, false);
addColumn(t, "IS_ADMIN", Types.BOOLEAN, false);
addColumn(t, "AUTOCOMMIT", Types.BOOLEAN, false);
addColumn(t, "READONLY", Types.BOOLEAN, false);
addColumn(t, "MAXROWS", Types.INTEGER, false);
// Note: some sessions may have a NULL LAST_IDENTITY value
addColumn(t, "LAST_IDENTITY", Types.BIGINT);
addColumn(t, "TRANSACTION_SIZE", Types.INTEGER, false);
addColumn(t, "SCHEMA", Types.VARCHAR, false);
// order: SESSION_ID
// true primary key
t.createPrimaryKey(null, new int[]{ 0 }, true);
return t;
}
// intermediate holders
Session[] sessions;
Session s;
Object[] row;
// column number mappings
final int isid = 0;
final int ict = 1;
final int iuname = 2;
final int iis_admin = 3;
final int iautocmt = 4;
final int ireadonly = 5;
final int imaxrows = 6;
final int ilast_id = 7;
final int it_size = 8;
final int it_schema = 9;
// Initialisation
sessions = ns.listVisibleSessions(session);
// Do it.
for (int i = 0; i < sessions.length; i++) {
s = sessions[i];
row = t.getEmptyRowData();
row[isid] = ValuePool.getInt(s.getId());
row[ict] = HsqlDateTime.getTimestamp(s.getConnectTime());
row[iuname] = s.getUsername();
row[iis_admin] = ValuePool.getBoolean(s.isAdmin());
row[iautocmt] = ValuePool.getBoolean(s.isAutoCommit());
row[ireadonly] = ValuePool.getBoolean(s.isReadOnly());
row[imaxrows] = ValuePool.getInt(s.getSQLMaxRows());
row[ilast_id] = ValuePool.getLong(s.getLastIdentity().longValue());
row[it_size] = ValuePool.getInt(s.getTransactionSize());
row[it_schema] = s.getSchemaName(null);
t.insertSys(row);
}
t.setDataReadOnly(true);
return t;
}
/**
* Retrieves a Table object describing the accessible
* direct super table (if any) of each accessible table defined
* within this database.
*
* Each row is a super table description with the following columns:
*
*
* TABLE_CAT VARCHAR the table's catalog
* TABLE_SCHEM VARCHAR table schema
* TABLE_NAME VARCHAR table name
* SUPERTABLE_NAME VARCHAR the direct super table's name
*
* @return a Table object describing the accessible
* direct supertable (if any) of each accessible
* table defined within this database
* @throws HsqlException if an error occurs while producing the table
*/
Table SYSTEM_SUPERTABLES() throws HsqlException {
Table t = sysTables[SYSTEM_SUPERTABLES];
if (t == null) {
t = createBlankTable(sysTableHsqlNames[SYSTEM_SUPERTABLES]);
addColumn(t, "TABLE_CAT", Types.VARCHAR);
addColumn(t, "TABLE_SCHEM", Types.VARCHAR);
addColumn(t, "TABLE_NAME", Types.VARCHAR, false); // not null
addColumn(t, "SUPERTABLE_NAME", Types.VARCHAR, false); // not null
t.createPrimaryKey(null);
return t;
}
t.setDataReadOnly(true);
return t;
}
/**
* Retrieves a Table object describing the accessible
* direct super type (if any) of each accessible user-defined type (UDT)
* defined within this database.
*
* Each row is a super type description with the following columns:
*
*
* TYPE_CAT VARCHAR the UDT's catalog
* TYPE_SCHEM VARCHAR UDT's schema
* TYPE_NAME VARCHAR type name of the UDT
* SUPERTYPE_CAT VARCHAR the direct super type's catalog
* SUPERTYPE_SCHEM VARCHAR the direct super type's schema
* SUPERTYPE_NAME VARCHAR the direct super type's name
*
* @return a Table object describing the accessible
* direct supertype (if any) of each accessible
* user-defined type (UDT) defined within this database
* @throws HsqlException if an error occurs while producing the table
*/
Table SYSTEM_SUPERTYPES() throws HsqlException {
Table t = sysTables[SYSTEM_SUPERTYPES];
if (t == null) {
t = createBlankTable(sysTableHsqlNames[SYSTEM_SUPERTYPES]);
addColumn(t, "TYPE_CAT", Types.VARCHAR);
addColumn(t, "TYPE_SCHEM", Types.VARCHAR);
addColumn(t, "TYPE_NAME", Types.VARCHAR, false); // not null
addColumn(t, "SUPERTYPE_CAT", Types.VARCHAR);
addColumn(t, "SUPERTYPE_SCHEM", Types.VARCHAR);
addColumn(t, "SUPERTYPE_NAME", Types.VARCHAR, false); // not null
t.createPrimaryKey(null);
return t;
}
t.setDataReadOnly(true);
return t;
}
/**
* Retrieves a Table object describing the TEXT TABLE objects
* defined within this database. The table contains one row for each row
* in the SYSTEM_TABLES table with a HSQLDB_TYPE of TEXT .
*
* Each row is a description of the attributes that defines its TEXT TABLE,
* with the following columns:
*
*
* TABLE_CAT VARCHAR table's catalog name
* TABLE_SCHEM VARCHAR table's simple schema name
* TABLE_NAME VARCHAR table's simple name
* DATA_SOURCE_DEFINITION VARCHAR the "spec" proption of the table's
* SET TABLE ... SOURCE DDL declaration
* FILE_PATH VARCHAR absolute file path.
* FILE_ENCODING VARCHAR endcoding of table's text file
* FIELD_SEPARATOR VARCHAR default field separator
* VARCHAR_SEPARATOR VARCAHR varchar field separator
* LONGVARCHAR_SEPARATOR VARCHAR longvarchar field separator
* IS_IGNORE_FIRST BOOLEAN ignores first line of file?
* IS_QUOTED BOOLEAN fields are quoted if necessary?
* IS_ALL_QUOTED BOOLEAN all fields are quoted?
* IS_DESC BOOLEAN read rows starting at end of file?
*
*
* @return a Table object describing the text attributes
* of the accessible text tables defined within this database
* @throws HsqlException if an error occurs while producing the table
*
*/
Table SYSTEM_TEXTTABLES() throws HsqlException {
Table t = sysTables[SYSTEM_TEXTTABLES];
if (t == null) {
t = createBlankTable(sysTableHsqlNames[SYSTEM_TEXTTABLES]);
addColumn(t, "TABLE_CAT", Types.VARCHAR);
addColumn(t, "TABLE_SCHEM", Types.VARCHAR);
addColumn(t, "TABLE_NAME", Types.VARCHAR, false); // not null
addColumn(t, "DATA_SOURCE_DEFINTION", Types.VARCHAR);
addColumn(t, "FILE_PATH", Types.VARCHAR);
addColumn(t, "FILE_ENCODING", Types.VARCHAR);
addColumn(t, "FIELD_SEPARATOR", Types.VARCHAR);
addColumn(t, "VARCHAR_SEPARATOR", Types.VARCHAR);
addColumn(t, "LONGVARCHAR_SEPARATOR", Types.VARCHAR);
addColumn(t, "IS_IGNORE_FIRST", Types.BOOLEAN);
addColumn(t, "IS_ALL_QUOTED", Types.BOOLEAN);
addColumn(t, "IS_QUOTED", Types.BOOLEAN);
addColumn(t, "IS_DESC", Types.BOOLEAN);
// ------------------------------------------------------------
t.createPrimaryKey();
return t;
}
// intermediate holders
Iterator tables;
Table table;
Object[] row;
// DITableInfo ti;
TextCache tc;
// column number mappings
final int itable_cat = 0;
final int itable_schem = 1;
final int itable_name = 2;
final int idsd = 3;
final int ifile_path = 4;
final int ifile_enc = 5;
final int ifs = 6;
final int ivfs = 7;
final int ilvfs = 8;
final int iif = 9;
final int iiq = 10;
final int iiaq = 11;
final int iid = 12;
// Initialization
tables = database.schemaManager.allTablesIterator();
// Do it.
while (tables.hasNext()) {
table = (Table) tables.next();
if (!table.isText() || !isAccessibleTable(table)) {
continue;
}
row = t.getEmptyRowData();
row[itable_cat] = ns.getCatalogName(table);
row[itable_schem] = table.getSchemaName();
row[itable_name] = table.getName().name;
row[idsd] = table.getDataSource();
if (table.getCache() instanceof TextCache) {
tc = (TextCache) table.getCache();
row[ifile_path] =
FileUtil.getDefaultInstance().canonicalOrAbsolutePath(
tc.getFileName());
row[ifile_enc] = tc.stringEncoding;
row[ifs] = tc.fs;
row[ivfs] = tc.vs;
row[ilvfs] = tc.lvs;
row[iif] = ValuePool.getBoolean(tc.ignoreFirst);
row[iiq] = ValuePool.getBoolean(tc.isQuoted);
row[iiaq] = ValuePool.getBoolean(tc.isAllQuoted);
row[iid] = ValuePool.getBoolean(table.isDescDataSource());
}
t.insertSys(row);
}
t.setDataReadOnly(true);
return t;
}
/**
* Retrieves a Table object describing the usage
* of accessible columns in accessible triggers defined within
* the database.
*
* Each column usage description has the following columns:
*
*
* TRIGGER_CAT VARCHAR Trigger catalog.
* TRIGGER_SCHEM VARCHAR Trigger schema.
* TRIGGER_NAME VARCHAR Trigger name.
* TABLE_CAT VARCHAR Catalog of table on which the trigger is defined.
* TABLE_SCHEM VARCHAR Schema of table on which the trigger is defined.
* TABLE_NAME VARCHAR Table on which the trigger is defined.
* COLUMN_NAME VARCHAR Name of the column used in the trigger.
* COLUMN_LIST VARCHAR Specified in UPDATE clause?: ("Y" | "N"}
* COLUMN_USAGE VARCHAR {"NEW" | "OLD" | "IN" | "OUT" | "IN OUT"}
*
* @return a Table object describing of the usage
* of accessible columns in accessible triggers
* defined within this database
* @throws HsqlException if an error occurs while producing the table
*/
Table SYSTEM_TRIGGERCOLUMNS() throws HsqlException {
Table t = sysTables[SYSTEM_TRIGGERCOLUMNS];
if (t == null) {
t = createBlankTable(sysTableHsqlNames[SYSTEM_TRIGGERCOLUMNS]);
addColumn(t, "TRIGGER_CAT", Types.VARCHAR);
addColumn(t, "TRIGGER_SCHEM", Types.VARCHAR);
addColumn(t, "TRIGGER_NAME", Types.VARCHAR);
addColumn(t, "TABLE_CAT", Types.VARCHAR);
addColumn(t, "TABLE_SCHEM", Types.VARCHAR);
addColumn(t, "TABLE_NAME", Types.VARCHAR);
addColumn(t, "COLUMN_NAME", Types.VARCHAR);
addColumn(t, "COLUMN_LIST", Types.VARCHAR);
addColumn(t, "COLUMN_USAGE", Types.VARCHAR);
// order: all columns, in order, as each column
// of each table may eventually be listed under various capacities
// (when a more comprehensive trugger system is put in place)
// false PK, as cat and schem may be null
t.createPrimaryKey(null, new int[] {
0, 1, 2, 3, 4, 5, 6, 7, 8
}, false);
return t;
}
Result rs;
// - used appends to make class file constant pool smaller
// - saves ~ 100 bytes jar space
rs = session.sqlExecuteDirectNoPreChecks(
"select a.TRIGGER_CAT,a.TRIGGER_SCHEM,a.TRIGGER_NAME, "
+ "a.TABLE_CAT,a.TABLE_SCHEM,a.TABLE_NAME,b.COLUMN_NAME,'Y',"
+ "'IN' from INFORMATION_SCHEMA.SYSTEM_TRIGGERS a, "
+ "INFORMATION_SCHEMA.SYSTEM_COLUMNS b where "
+ "a.TABLE_NAME=b.TABLE_NAME and a.TABLE_SCHEM=b.TABLE_SCHEM");
/*
(new StringBuffer(185)).append("SELECT").append(' ').append(
"a.").append("TRIGGER_CAT").append(',').append("a.").append(
"TRIGGER_SCHEM").append(',').append("a.").append(
"TRIGGER_NAME").append(',').append("a.").append(
"TABLE_CAT").append(',').append("a.").append(
"TABLE_SCHEM").append(',').append("a.").append(
"TABLE_NAME").append(',').append("b.").append(
"COLUMN_NAME").append(',').append("'Y'").append(',').append(
"'IN'").append(' ').append("from").append(' ').append(
"INFORMATION_SCHEMA").append('.').append(
"SYSTEM_TRIGGERS").append(" a,").append(
"INFORMATION_SCHEMA").append('.').append(
"SYSTEM_COLUMNS").append(" b ").append("where").append(
' ').append("a.").append("TABLE_NAME").append('=').append(
"b.").append("TABLE_NAME").toString();
*/
t.insertSys(rs);
t.setDataReadOnly(true);
return t;
}
/**
* Retrieves a Table object describing the accessible
* triggers defined within the database.
*
* Each row is a trigger description with the following columns:
*
*
* TRIGGER_CAT VARCHAR Trigger catalog.
* TRIGGER_SCHEM VARCHAR Trigger Schema.
* TRIGGER_NAME VARCHAR Trigger Name.
* TRIGGER_TYPE VARCHAR {("BEFORE" | "AFTER") + [" EACH ROW"] }
* TRIGGERING_EVENT VARCHAR {"INSERT" | "UPDATE" | "DELETE"}
* (future?: "INSTEAD OF " + ("SELECT" | ...))
* TABLE_CAT VARCHAR Table's catalog.
* TABLE_SCHEM VARCHAR Table's schema.
* BASE_OBJECT_TYPE VARCHAR "TABLE"
* (future?: "VIEW" | "SCHEMA" | "DATABASE")
* TABLE_NAME VARCHAR Table on which trigger is defined
* COLUMN_NAME VARCHAR NULL (future?: nested table column name)
* REFERENCING_NAMES VARCHAR ROW, OLD, NEW, etc.
* WHEN_CLAUSE VARCHAR Condition firing trigger (NULL => always)
* STATUS VARCHAR {"ENABLED" | "DISABLED"}
* DESCRIPTION VARCHAR typically, the trigger's DDL
* ACTION_TYPE VARCHAR "CALL" (future?: embedded language name)
* TRIGGER_BODY VARCHAR Statement(s) executed
*
*
* @return a Table object describing the accessible
* triggers defined within this database.
* @throws HsqlException if an error occurs while producing the table
*/
Table SYSTEM_TRIGGERS() throws HsqlException {
Table t = sysTables[SYSTEM_TRIGGERS];
if (t == null) {
t = createBlankTable(sysTableHsqlNames[SYSTEM_TRIGGERS]);
addColumn(t, "TRIGGER_CAT", Types.VARCHAR);
addColumn(t, "TRIGGER_SCHEM", Types.VARCHAR);
addColumn(t, "TRIGGER_NAME", Types.VARCHAR, false);
addColumn(t, "TRIGGER_TYPE", Types.VARCHAR, 15, false);
addColumn(t, "TRIGGERING_EVENT", Types.VARCHAR, 10, false);
addColumn(t, "TABLE_CAT", Types.VARCHAR);
addColumn(t, "TABLE_SCHEM", Types.VARCHAR);
addColumn(t, "BASE_OBJECT_TYPE", Types.VARCHAR, 8, false);
addColumn(t, "TABLE_NAME", Types.VARCHAR, false);
addColumn(t, "COLUMN_NAME", Types.VARCHAR);
addColumn(t, "REFERENCING_NAMES", Types.VARCHAR, false);
addColumn(t, "WHEN_CLAUSE", Types.VARCHAR);
addColumn(t, "STATUS", Types.VARCHAR, 8, false);
addColumn(t, "DESCRIPTION", Types.VARCHAR, false);
addColumn(t, "ACTION_TYPE", Types.VARCHAR, false);
addColumn(t, "TRIGGER_BODY", Types.VARCHAR, false);
// order: TRIGGER_TYPE, TRIGGER_SCHEM, TRIGGER_NAME
// added for unique: TRIGGER_CAT
// false PK, as TRIGGER_SCHEM and/or TRIGGER_CAT may be null
t.createPrimaryKey(null, new int[] {
3, 1, 2, 0
}, false);
return t;
}
// calculated column values
String triggerCatalog;
String triggerSchema;
String triggerName;
String triggerType;
String triggeringEvent;
String tableCatalog;
String tableSchema;
String baseObjectType;
String tableName;
String columnName;
String referencingNames;
String whenClause;
String status;
String description;
String actionType;
String triggerBody;
// Intermediate holders
Iterator tables;
Table table;
HsqlArrayList[] vTrigs;
HsqlArrayList triggerList;
TriggerDef def;
Object[] row;
// column number mappings
final int itrigger_cat = 0;
final int itrigger_schem = 1;
final int itrigger_name = 2;
final int itrigger_type = 3;
final int itriggering_event = 4;
final int itable_cat = 5;
final int itable_schem = 6;
final int ibase_object_type = 7;
final int itable_name = 8;
final int icolumn_name = 9;
final int ireferencing_names = 10;
final int iwhen_clause = 11;
final int istatus = 12;
final int idescription = 13;
final int iaction_type = 14;
final int itrigger_body = 15;
// Initialization
tables = database.schemaManager.allTablesIterator();
// these are the only values supported, currently
actionType = "CALL";
baseObjectType = "TABLE";
columnName = null;
referencingNames = "ROW";
whenClause = null;
// Do it.
while (tables.hasNext()) {
table = (Table) tables.next();
vTrigs = table.triggerLists;
// faster test first
if (vTrigs == null) {
continue;
}
if (!isAccessibleTable(table)) {
continue;
}
tableCatalog = ns.getCatalogName(table);
triggerCatalog = tableCatalog;
tableSchema = table.getSchemaName();
triggerSchema = tableSchema;
tableName = table.getName().name;
for (int i = 0; i < vTrigs.length; i++) {
triggerList = vTrigs[i];
if (triggerList == null) {
continue;
}
for (int j = 0; j < triggerList.size(); j++) {
def = (TriggerDef) triggerList.get(j);
if (def == null) {
continue;
}
triggerName = def.name.name;
description = def.getDDL().toString();
status = def.valid ? "ENABLED"
: "DISABLED";
triggerBody = def.triggerClassName;
triggerType = def.when;
if (def.forEachRow) {
triggerType += " EACH ROW";
}
triggeringEvent = def.operation;
row = t.getEmptyRowData();
row[itrigger_cat] = triggerCatalog;
row[itrigger_schem] = triggerSchema;
row[itrigger_name] = triggerName;
row[itrigger_type] = triggerType;
row[itriggering_event] = triggeringEvent;
row[itable_cat] = tableCatalog;
row[itable_schem] = tableSchema;
row[ibase_object_type] = baseObjectType;
row[itable_name] = tableName;
row[icolumn_name] = columnName;
row[ireferencing_names] = referencingNames;
row[iwhen_clause] = whenClause;
row[istatus] = status;
row[idescription] = description;
row[iaction_type] = actionType;
row[itrigger_body] = triggerBody;
t.insertSys(row);
}
}
}
t.setDataReadOnly(true);
return t;
}
/**
* Retrieves a Table object describing the accessible
* attributes of the accessible user-defined type (UDT) objects
* defined within this database.
*
* This description does not contain inherited attributes.
*
* Each row is a user-defined type attributes description with the
* following columns:
*
*
* TYPE_CAT VARCHAR type catalog
* TYPE_SCHEM VARCHAR type schema
* TYPE_NAME VARCHAR type name
* ATTR_NAME VARCHAR attribute name
* DATA_TYPE SMALLINT attribute's SQL type from DITypes
* ATTR_TYPE_NAME VARCHAR UDT: fully qualified type name
* REF: fully qualified type name of target type of
* the reference type.
* ATTR_SIZE INTEGER column size.
* char or date types => maximum number of characters;
* numeric or decimal types => precision.
* DECIMAL_DIGITS INTEGER # of fractional digits (scale) of number type
* NUM_PREC_RADIX INTEGER Radix of number type
* NULLABLE INTEGER whether NULL is allowed
* REMARKS VARCHAR comment describing attribute
* ATTR_DEF VARCHAR default attribute value
* SQL_DATA_TYPE INTEGER expected value of SQL CLI SQL_DESC_TYPE in the SQLDA
* SQL_DATETIME_SUB INTEGER DATETIME/INTERVAL => datetime/interval subcode
* CHAR_OCTET_LENGTH INTEGER for char types: max bytes in column
* ORDINAL_POSITION INTEGER index of column in table (starting at 1)
* IS_NULLABLE VARCHAR "NO" => strictly no NULL values;
* "YES" => maybe NULL values;
* "" => unknown.
* SCOPE_CATALOG VARCHAR catalog of REF attribute scope table or NULL
* SCOPE_SCHEMA VARCHAR schema of REF attribute scope table or NULL
* SCOPE_TABLE VARCHAR name of REF attribute scope table or NULL
* SOURCE_DATA_TYPE SMALLINT For DISTINCT or user-generated REF DATA_TYPE:
* source SQL type from DITypes
* For other DATA_TYPE values: NULL
*
*
* Note: Currently, neither the HSQLDB engine or the JDBC driver
* support UDTs, so an empty table is returned.
* @return a Table object describing the accessible
* attrubutes of the accessible user-defined type
* (UDT) objects defined within this database
* @throws HsqlException if an error occurs while producing the table
*/
Table SYSTEM_UDTATTRIBUTES() throws HsqlException {
Table t = sysTables[SYSTEM_UDTATTRIBUTES];
if (t == null) {
t = createBlankTable(sysTableHsqlNames[SYSTEM_UDTATTRIBUTES]);
addColumn(t, "TYPE_CAT", Types.VARCHAR);
addColumn(t, "TYPE_SCHEM", Types.VARCHAR);
addColumn(t, "TYPE_NAME", Types.VARCHAR, false); // not null
addColumn(t, "ATTR_NAME", Types.VARCHAR, false); // not null
addColumn(t, "DATA_TYPE", Types.SMALLINT, false); // not null
addColumn(t, "ATTR_TYPE_NAME", Types.VARCHAR, false); // not null
addColumn(t, "ATTR_SIZE", Types.INTEGER);
addColumn(t, "DECIMAL_DIGITS", Types.INTEGER);
addColumn(t, "NUM_PREC_RADIX", Types.INTEGER);
addColumn(t, "NULLABLE", Types.INTEGER);
addColumn(t, "REMARKS", Types.VARCHAR);
addColumn(t, "ATTR_DEF", Types.VARCHAR);
addColumn(t, "SQL_DATA_TYPE", Types.INTEGER);
addColumn(t, "SQL_DATETIME_SUB", Types.INTEGER);
addColumn(t, "CHAR_OCTET_LENGTH", Types.INTEGER);
addColumn(t, "ORDINAL_POSITION", Types.INTEGER, false); // not null
addColumn(t, "IS_NULLABLE", Types.VARCHAR, false); // not null
addColumn(t, "SCOPE_CATALOG", Types.VARCHAR);
addColumn(t, "SCOPE_SCHEMA", Types.VARCHAR);
addColumn(t, "SCOPE_TABLE", Types.VARCHAR);
addColumn(t, "SOURCE_DATA_TYPE", Types.SMALLINT);
t.createPrimaryKey(null);
return t;
}
t.setDataReadOnly(true);
return t;
}
/**
* Retrieves a Table object describing the accessible
* user-defined types defined in this database.
*
* Schema-specific UDTs may have type JAVA_OBJECT, STRUCT, or DISTINCT.
*
*
Each row is a UDT descripion with the following columns:
*
* - TYPE_CAT
VARCHAR => the type's catalog
* - TYPE_SCHEM
VARCHAR => type's schema
* - TYPE_NAME
VARCHAR => type name
* - CLASS_NAME
VARCHAR => Java class name
* - DATA_TYPE
VARCHAR =>
* type value defined in DITypes;
* one of JAVA_OBJECT, STRUCT, or
* DISTINCT
* - REMARKS
VARCHAR =>
* explanatory comment on the type
* - BASE_TYPE
SMALLINT =>
* type code of the source type of a DISTINCT type or the
* type that implements the user-generated reference type of the
* SELF_REFERENCING_COLUMN of a structured type as defined in
* DITypes (null if DATA_TYPE is not DISTINCT or not
* STRUCT with REFERENCE_GENERATION = USER_DEFINED)
*
*
*
* Note: Currently, neither the HSQLDB engine or the JDBC driver
* support UDTs, so an empty table is returned.
*
* @return a Table object describing the accessible
* user-defined types defined in this database
* @throws HsqlException if an error occurs while producing the table
*/
Table SYSTEM_UDTS() throws HsqlException {
Table t = sysTables[SYSTEM_UDTS];
if (t == null) {
t = createBlankTable(sysTableHsqlNames[SYSTEM_UDTS]);
addColumn(t, "TYPE_CAT", Types.VARCHAR);
addColumn(t, "TYPE_SCHEM", Types.VARCHAR);
addColumn(t, "TYPE_NAME", Types.VARCHAR, false); // not null
addColumn(t, "CLASS_NAME", Types.VARCHAR, false); // not null
addColumn(t, "DATA_TYPE", Types.VARCHAR, false); // not null
addColumn(t, "REMARKS", Types.VARCHAR);
addColumn(t, "BASE_TYPE", Types.SMALLINT);
t.createPrimaryKey(null);
return t;
}
t.setDataReadOnly(true);
return t;
}
/**
* Retrieves a Table object describing the accessible
* columns that are automatically updated when any value in a row
* is updated.
*
* Each row is a version column description with the following columns:
*
*
* - SCOPE
SMALLINT => is not used
* - COLUMN_NAME
VARCHAR => column name
* - DATA_TYPE
SMALLINT =>
* SQL data type from java.sql.Types
* - TYPE_NAME
SMALLINT =>
* Data source dependent type name
* - COLUMN_SIZE
INTEGER => precision
* - BUFFER_LENGTH
INTEGER =>
* length of column value in bytes
* - DECIMAL_DIGITS
SMALLINT => scale
* - PSEUDO_COLUMN
SMALLINT =>
* is this a pseudo column like an Oracle ROWID:
* (as defined in java.sql.DatabaseMetadata)
*
* versionColumnUnknown - may or may not be
* pseudo column
* versionColumnNotPseudo - is NOT a pseudo column
* versionColumnPseudo - is a pseudo column
*
*
*
* Note: Currently, the HSQLDB engine does not support version
* columns, so an empty table is returned.
*
* @return a Table object describing the columns
* that are automatically updated when any value
* in a row is updated
* @throws HsqlException if an error occurs while producing the table
*/
Table SYSTEM_VERSIONCOLUMNS() throws HsqlException {
Table t = sysTables[SYSTEM_VERSIONCOLUMNS];
if (t == null) {
t = createBlankTable(sysTableHsqlNames[SYSTEM_VERSIONCOLUMNS]);
// ----------------------------------------------------------------
// required by DatabaseMetaData.getVersionColumns result set
// ----------------------------------------------------------------
addColumn(t, "SCOPE", Types.INTEGER);
addColumn(t, "COLUMN_NAME", Types.VARCHAR, false); // not null
addColumn(t, "DATA_TYPE", Types.SMALLINT, false); // not null
addColumn(t, "TYPE_NAME", Types.VARCHAR, false); // not null
addColumn(t, "COLUMN_SIZE", Types.SMALLINT);
addColumn(t, "BUFFER_LENGTH", Types.INTEGER);
addColumn(t, "DECIMAL_DIGITS", Types.SMALLINT);
addColumn(t, "PSEUDO_COLUMN", Types.SMALLINT, false); // not null
// -----------------------------------------------------------------
// required by DatabaseMetaData.getVersionColumns filter parameters
// -----------------------------------------------------------------
addColumn(t, "TABLE_CAT", Types.VARCHAR);
addColumn(t, "TABLE_SCHEM", Types.VARCHAR);
addColumn(t, "TABLE_NAME", Types.VARCHAR, false); // not null
// -----------------------------------------------------------------
t.createPrimaryKey(null);
return t;
}
t.setDataReadOnly(true);
return t;
}
/**
* Retrieves a Table object describing the VIEW objects
* defined within this database. The table contains one row for each row
* in the SYSTEM_TABLES table with a TABLE_TYPE of VIEW .
*
* Each row is a description of the query expression that defines its view,
* with the following columns:
*
*
* TABLE_CATALOG VARCHAR name of view's defining catalog.
* TABLE_SCHEMA VARCHAR unqualified name of view's defining schema.
* TABLE_NAME VARCHAR the simple name of the view.
* VIEW_DEFINITION VARCHAR the character representation of the
* <query expression> contained in the
* corresponding <view descriptor>.
* CHECK_OPTION VARCHAR {"CASCADED" | "LOCAL" | "NONE"}
* IS_UPDATABLE VARCHAR {"YES" | "NO"}
* VALID BOOLEAN Always TRUE: VIEW_DEFINITION currently
* represents a valid <query expression>.
*
*
*
* @return a tabular description of the text source of all
* View objects accessible to
* the user.
* @throws HsqlException if an error occurs while producing the table
*/
Table SYSTEM_VIEWS() throws HsqlException {
Table t = sysTables[SYSTEM_VIEWS];
if (t == null) {
t = createBlankTable(sysTableHsqlNames[SYSTEM_VIEWS]);
addColumn(t, "TABLE_CATALOG", Types.VARCHAR);
addColumn(t, "TABLE_SCHEMA", Types.VARCHAR);
addColumn(t, "TABLE_NAME", Types.VARCHAR, true); // not null
addColumn(t, "VIEW_DEFINITION", Types.VARCHAR, true); // not null
addColumn(t, "CHECK_OPTION", Types.VARCHAR, 8, true); // not null
addColumn(t, "IS_UPDATABLE", Types.VARCHAR, 3, true); // not null
addColumn(t, "VALID", Types.BOOLEAN, true); // not null
// order TABLE_NAME
// added for unique: TABLE_SCHEMA, TABLE_CATALOG
// false PK, as TABLE_SCHEMA and/or TABLE_CATALOG may be null
t.createPrimaryKey(null, new int[] {
1, 2, 0
}, false);
return t;
}
String defn;
Iterator tables;
Table table;
Object[] row;
final int icat = 0;
final int ischem = 1;
final int iname = 2;
final int idefn = 3;
final int icopt = 4;
final int iiupd = 5;
final int ivalid = 6;
tables = database.schemaManager.allTablesIterator();
while (tables.hasNext()) {
table = (Table) tables.next();
if (!table.isView() || !isAccessibleTable(table)) {
continue;
}
row = t.getEmptyRowData();
defn = ((View) table).getStatement();
row[icat] = ns.getCatalogName(table);
row[ischem] = table.getSchemaName();
row[iname] = table.getName().name;
row[idefn] = defn;
row[icopt] = "NONE";
row[iiupd] = "NO";
row[ivalid] = Boolean.TRUE;
t.insertSys(row);
}
t.setDataReadOnly(true);
return t;
}
/**
* Retrieves a Table object describing the
* return, parameter and result columns of the accessible
* routines defined within this database.
*
* Each row is a procedure column description with the following
* columns:
*
*
* PROCEDURE_CAT VARCHAR routine catalog
* PROCEDURE_SCHEM VARCHAR routine schema
* PROCEDURE_NAME VARCHAR routine name
* COLUMN_NAME VARCHAR column/parameter name
* COLUMN_TYPE SMALLINT kind of column/parameter
* DATA_TYPE SMALLINT SQL type from DITypes
* TYPE_NAME VARCHAR SQL type name
* PRECISION INTEGER precision (length) of type
* LENGTH INTEGER transfer size, in bytes, if definitely known
* (roughly equivalent to BUFFER_SIZE for table
* columns)
* SCALE SMALLINT scale
* RADIX SMALLINT radix
* NULLABLE SMALLINT can column contain NULL?
* REMARKS VARCHAR explanatory comment on column
* SPECIFIC_NAME VARCHAR typically (but not restricted to) a
* fully qulified Java Method name and signature
* SEQ INTEGER The JDBC-specified order within
* runs of PROCEDURE_SCHEM, PROCEDURE_NAME,
* SPECIFIC_NAME, which is:
*
* return value (0), if any, first, followed
* by the parameter descriptions in call order
* (1..n1), followed by the result column
* descriptions in column number order
* (n1 + 1..n1 + n2)
*
*
* @return a Table object describing the
* return, parameter and result columns
* of the accessible routines defined
* within this database.
* @throws HsqlException if an error occurs while producing the table
*/
Table SYSTEM_PROCEDURECOLUMNS() throws HsqlException {
Table t = sysTables[SYSTEM_PROCEDURECOLUMNS];
if (t == null) {
return super.SYSTEM_PROCEDURECOLUMNS();
}
// calculated column values
String procedureCatalog;
String procedureSchema;
String procedureName;
String columnName;
Integer columnType;
Integer dataType;
String dataTypeName;
Integer precision;
Integer length;
Integer scale;
Integer radix;
Integer nullability;
String remark;
String specificName;
int colSequence;
int colCount;
// intermediate holders
HsqlArrayList aliasList;
Object[] info;
Method method;
Iterator methods;
Object[] row;
DITypeInfo ti;
// Initialization
methods = ns.iterateAllAccessibleMethods(session, true); // and aliases
ti = new DITypeInfo();
// no such thing as identity or ignorecase return/parameter
// procedure columns. Future: may need to worry about this if
// result columns are ever reported
ti.setTypeSub(Types.TYPE_SUB_DEFAULT);
// Do it.
while (methods.hasNext()) {
info = (Object[]) methods.next();
method = (Method) info[0];
aliasList = (HsqlArrayList) info[1];
procedureCatalog = ns.getCatalogName(method);
procedureSchema = ns.getSchemaName(method);
pi.setMethod(method);
specificName = pi.getSpecificName();
procedureName = pi.getFQN();
colCount = pi.getColCount();
for (int i = 0; i < colCount; i++) {
ti.setTypeCode(pi.getColTypeCode(i));
columnName = pi.getColName(i);
columnType = pi.getColUsage(i);
dataType = pi.getColDataType(i);
dataTypeName = ti.getTypeName();
precision = ti.getPrecision();
length = pi.getColLen(i);
scale = ti.getDefaultScale();
radix = ti.getNumPrecRadix();
nullability = pi.getColNullability(i);
remark = pi.getColRemark(i);
colSequence = pi.getColSequence(i);
addPColRows(t, aliasList, procedureCatalog, procedureSchema,
procedureName, columnName, columnType, dataType,
dataTypeName, precision, length, scale, radix,
nullability, remark, specificName, colSequence);
}
}
t.setDataReadOnly(true);
return t;
}
/**
* Retrieves a Table object describing the accessible
* routines defined within this database.
*
* Each row is a procedure description with the following
* columns:
*
*
* PROCEDURE_CAT VARCHAR catalog in which routine is defined
* PROCEDURE_SCHEM VARCHAR schema in which routine is defined
* PROCEDURE_NAME VARCHAR simple routine identifier
* NUM_INPUT_PARAMS INTEGER number of input parameters
* NUM_OUTPUT_PARAMS INTEGER number of output parameters
* NUM_RESULT_SETS INTEGER number of result sets returned
* REMARKS VARCHAR explanatory comment on the routine
* PROCEDURE_TYPE SMALLINT { Unknown | No Result | Returns Result }
* ORIGIN VARCHAR {ALIAS |
* [BUILTIN | USER DEFINED] ROUTINE |
* [BUILTIN | USER DEFINED] TRIGGER |
* ...}
* SPECIFIC_NAME VARCHAR typically (but not restricted to) a
* a fully qualified Java Method name
* and signature
*
*
* @return a Table object describing the accessible
* routines defined within the this database
* @throws HsqlException if an error occurs while producing the table
*/
Table SYSTEM_PROCEDURES() throws HsqlException {
Table t = sysTables[SYSTEM_PROCEDURES];
if (t == null) {
return super.SYSTEM_PROCEDURES();
}
// calculated column values
// ------------------------
// required
// ------------------------
String catalog;
String schema;
String procName;
Integer numInputParams;
Integer numOutputParams;
Integer numResultSets;
String remarks;
Integer procRType;
// -------------------
// extended
// -------------------
String procOrigin;
String specificName;
// intermediate holders
String alias;
HsqlArrayList aliasList;
Iterator methods;
Object[] methodInfo;
Method method;
String methodOrigin;
Object[] row;
// Initialization
methods = ns.iterateAllAccessibleMethods(session, true); //and aliases
// Do it.
while (methods.hasNext()) {
methodInfo = (Object[]) methods.next();
method = (Method) methodInfo[0];
aliasList = (HsqlArrayList) methodInfo[1];
methodOrigin = (String) methodInfo[2];
pi.setMethod(method);
catalog = ns.getCatalogName(method);
schema = ns.getSchemaName(method);
procName = pi.getFQN();
numInputParams = pi.getInputParmCount();
numOutputParams = pi.getOutputParmCount();
numResultSets = pi.getResultSetCount();
remarks = pi.getRemark();
procRType = pi.getResultType(methodOrigin);
procOrigin = pi.getOrigin(methodOrigin);
specificName = pi.getSpecificName();
addProcRows(t, aliasList, catalog, schema, procName,
numInputParams, numOutputParams, numResultSets,
remarks, procRType, procOrigin, specificName);
}
t.setDataReadOnly(true);
return t;
}
/**
* The SYSTEM_USAGE_PRIVILEGES table has one row for each usage privilege
* descriptor.
*
* It effectively contains a representation of the usage privilege
* descriptors.
*
* Definition:
*
*
* CREATE TABLE SYSTEM_USAGE_PRIVILEGES (
* GRANTOR VARCHAR NOT NULL,
* GRANTEE VARCHAR NOT NULL,
* OBJECT_CATALOG VARCHAR NULL,
* OBJECT_SCHEMA VARCHAR NULL,
* OBJECT_NAME VARCHAR NOT NULL,
* OBJECT_TYPE VARCHAR NOT NULL
*
* CHECK ( OBJECT_TYPE IN (
* 'DOMAIN',
* 'CHARACTER SET',
* 'COLLATION',
* 'TRANSLATION',
* 'SEQUENCE' ) ),
*
* IS_GRANTABLE VARCHAR NOT NULL
*
* CHECK ( IS_GRANTABLE IN ( 'YES', 'NO' ) ),
*
* UNIQUE( GRANTOR, GRANTEE, OBJECT_CATALOG,
* OBJECT_SCHEMA, OBJECT_NAME, OBJECT_TYPE )
* )
*
*
* Description:
*
*
* - The value of GRANTOR is the <authorization identifier> of the
* user or role who granted usage privileges on the object of the type
* identified by OBJECT_TYPE that is identified by OBJECT_CATALOG,
* OBJECT_SCHEMA, and OBJECT_NAME, to the user or role identified by the
* value of GRANTEE forthe usage privilege being described.
*
*
- The value of GRANTEE is the <authorization identifier> of some
* user or role, or PUBLIC to indicate all users, to whom the usage
* privilege being described is granted.
*
*
- The values of OBJECT_CATALOG, OBJECT_SCHEMA, and OBJECT_NAME are the
* catalog name, unqualified schema name, and qualified identifier,
* respectively, of the object to which the privilege applies.
*
*
- The values of OBJECT_TYPE have the following meanings:
*
*
*
* DOMAIN
* The object to which the privilege applies is
* a domain.
*
*
* CHARACTER SET
* The object to which the privilege applies is a
* character set.
*
*
* COLLATION
* The object to which the privilege applies is a
* collation.
*
*
* TRANSLATION
* The object to which the privilege applies is a
* transliteration.
*
*
* SEQUENCE
* The object to which the privilege applies is a
* sequence generator.
*
*
*
*
- The values of IS_GRANTABLE have the following meanings:
*
*
*
* YES
* The privilege being described was granted
* WITH GRANT OPTION and is thus grantable.
*
*
* NO
* The privilege being described was not granted
* WITH GRANT OPTION and is thus not grantable.
*
*
*
*/
Table SYSTEM_USAGE_PRIVILEGES() throws HsqlException {
Table t = sysTables[SYSTEM_USAGE_PRIVILEGES];
if (t == null) {
t = createBlankTable(sysTableHsqlNames[SYSTEM_USAGE_PRIVILEGES]);
addColumn(t, "GRANTOR", Types.VARCHAR, false); // not null
addColumn(t, "GRANTEE", Types.VARCHAR, false); // not null
addColumn(t, "OBJECT_CATALOG", Types.VARCHAR);
addColumn(t, "OBJECT_SCHEMA", Types.VARCHAR);
addColumn(t, "OBJECT_NAME", Types.VARCHAR, false); // not null
addColumn(t, "OBJECT_TYPE", Types.VARCHAR, 32, false); // not null
addColumn(t, "IS_GRANTABLE", Types.VARCHAR, 3, false); // not null
// order: COLUMN_NAME, PRIVILEGE
// for unique: GRANTEE, GRANTOR, TABLE_NAME, TABLE_SCHEM, TABLE_CAT
// false PK, as TABLE_SCHEM and/or TABLE_CAT may be null
t.createPrimaryKey(null, new int[] {
0, 1, 2, 3, 4, 5
}, false);
return t;
}
Result rs;
rs = session.sqlExecuteDirectNoPreChecks(
"SELECT '" + GranteeManager.SYSTEM_AUTHORIZATION_NAME
+ "', 'PUBLIC', SEQUENCE_CATALOG, SEQUENCE_SCHEMA, "
+ "SEQUENCE_NAME, 'SEQUENCE', 'FALSE' FROM INFORMATION_SCHEMA.SYSTEM_SEQUENCES");
t.insertSys(rs);
rs = session.sqlExecuteDirectNoPreChecks(
"SELECT '" + GranteeManager.SYSTEM_AUTHORIZATION_NAME
+ "', 'PUBLIC', COLLATION_CATALOG, COLLATION_SCHEMA, "
+ "COLLATION_NAME, 'COLLATION', 'FALSE' FROM INFORMATION_SCHEMA.SYSTEM_COLLATIONS");
t.insertSys(rs);
t.setDataReadOnly(true);
return t;
}
/**
* The CHECK_COLUMN_USAGE table has one row for each column identified by
* a <column reference> contained in the <search condition>
* of a check constraint, domain constraint, or assertion.
*
* Definition:
*
*
* CREATE TABLE CHECK_COLUMN_USAGE (
* CONSTRAINT_CATALOG VARCHAR NULL,
* CONSTRAINT_SCHEMA VARCHAR NULL,
* CONSTRAINT_NAME VARCHAR NOT NULL,
* TABLE_CATALOG VARCHAR NULL,
* TABLE_SCHEMA VARCHAR NULL,
* TABLE_NAME VARCHAR NOT NULL,
* COLUMN_NAME VARCHAR NOT NULL,
* UNIQUE( CONSTRAINT_CATALOG, CONSTRAINT_SCHEMA, CONSTRAINT_NAME,
* TABLE_CATALOG, TABLE_SCHEMA, TABLE_NAME, COLUMN_NAME )
* )
*
*
* Description:
*
*
* - The values of CONSTRAINT_CATALOG, CONSTRAINT_SCHEMA, and
* CONSTRAINT_NAME are the catalog name, unqualified schema name,
* and qualified identifier, respectively, of the constraint being
* described.
*
*
- The values of TABLE_CATALOG, TABLE_SCHEMA, TABLE_NAME, and
* COLUMN_NAME are the catalog name, unqualified schema name,
* qualified identifier, and column name, respectively, of a column
* identified by a <column reference> explicitly or implicitly
* contained in the <search condition> of the constraint
* being described.
*
*/
Table SYSTEM_CHECK_COLUMN_USAGE() throws HsqlException {
Table t = sysTables[SYSTEM_CHECK_COLUMN_USAGE];
if (t == null) {
t = createBlankTable(sysTableHsqlNames[SYSTEM_CHECK_COLUMN_USAGE]);
addColumn(t, "CONSTRAINT_CATALOG", Types.VARCHAR);
addColumn(t, "CONSTRAINT_SCHEMA", Types.VARCHAR);
addColumn(t, "CONSTRAINT_NAME", Types.VARCHAR, false); // not null
addColumn(t, "TABLE_CATALOG", Types.VARCHAR);
addColumn(t, "TABLE_SCHEMA", Types.VARCHAR);
addColumn(t, "TABLE_NAME", Types.VARCHAR, false); // not null
addColumn(t, "COLUMN_NAME", Types.VARCHAR, false); // not null
t.createPrimaryKey(null, new int[] {
0, 1, 2, 3, 4, 5, 6
}, false);
return t;
}
// calculated column values
String constraintCatalog;
String constraintSchema;
String constraintName;
// Intermediate holders
Iterator tables;
Table table;
Constraint[] constraints;
int constraintCount;
Constraint constraint;
Expression.Collector collector;
Expression expression;
TableFilter tableFilter;
Table columnTable;
Iterator iterator;
Result result;
Object[] resultRow;
Object[] row;
// column number mappings
final int icons_cat = 0;
final int icons_schem = 1;
final int icons_name = 2;
final int itab_cat = 3;
final int itab_schem = 4;
final int itab_name = 5;
final int itab_col = 6;
// Initialization
tables = database.schemaManager.allTablesIterator();
collector = new Expression.Collector();
result = new Result(ResultConstants.DATA, 4);
result.metaData.colTypes[0] = result.metaData.colTypes[1] =
result.metaData.colTypes[2] = result.metaData.colTypes[3] =
Types.VARCHAR;
// Do it.
while (tables.hasNext()) {
table = (Table) tables.next();
if (!isAccessibleTable(table)) {
continue;
}
constraints = table.getConstraints();
constraintCount = constraints.length;
constraintCatalog = ns.getCatalogName(table);
constraintSchema = table.getSchemaName();
// process constraints
for (int i = 0; i < constraintCount; i++) {
constraint = (Constraint) constraints[i];
if (constraint.getType() != Constraint.CHECK) {
continue;
}
constraintName = constraint.getName().name;
result.setRows(null);
collector.clear();
collector.addAll(constraint.core.check, Expression.COLUMN);
iterator = collector.iterator();
// calculate distinct column references
while (iterator.hasNext()) {
expression = (Expression) iterator.next();
tableFilter = expression.getFilter();
columnTable = tableFilter.getTable();
if (columnTable.getTableType() == Table.SYSTEM_SUBQUERY
|| !isAccessibleTable(columnTable)) {
continue;
}
result.add(new Object[] {
ns.getCatalogName(columnTable),
columnTable.getSchemaName(),
columnTable.getName().name, expression.getColumnName()
});
}
/*
result.removeDuplicates(
database.sessionManager.getSysSession(
database.schemaManager.INFORMATION_SCHEMA));
*/
result.removeDuplicates(session);
iterator = result.iterator();
while (iterator.hasNext()) {
row = t.getEmptyRowData();
resultRow = (Object[]) iterator.next();
row[icons_cat] = constraintCatalog;
row[icons_schem] = constraintSchema;
row[icons_name] = constraintName;
row[itab_cat] = resultRow[0];
row[itab_schem] = resultRow[1];
row[itab_name] = resultRow[2];
row[itab_col] = resultRow[3];
t.insertSys(row);
}
}
}
t.setDataReadOnly(true);
return t;
}
/**
* The CHECK_ROUTINE_USAGE base table has one row for each
* SQL-invoked routine identified as the subject routine of either a
* <routine invocation>, a <method reference>, a
* <method invocation>, or a <static method invocation>
* contained in an <assertion definition>, a <domain
* constraint>, or a <table constraint definition>.
*
* Definition:
*
*
* CREATE TABLE SYSTEM_CHECK_ROUTINE_USAGE (
* CONSTRAINT_CATALOG VARCHAR NULL,
* CONSTRAINT_SCHEMA VARCHAR NULL,
* CONSTRAINT_NAME VARCHAR NOT NULL,
* SPECIFIC_CATALOG VARCHAR NULL,
* SPECIFIC_SCHEMA VARCHAR NULL,
* SPECIFIC_NAME VARCHAR NOT NULL,
* UNIQUE( CONSTRAINT_CATALOG, CONSTRAINT_SCHEMA, CONSTRAINT_NAME,
* SPECIFIC_CATALOG, SPECIFIC_SCHEMA, SPECIFIC_NAME )
* )
*
*
* Description:
*
*
* - The CHECK_ROUTINE_USAGE table has one row for each
* SQL-invoked routine R identified as the subject routine of either a
* <routine invocation>, a <method reference>, a <method
* invocation>, or a <static method invocation> contained in
* an <assertion definition> or in the <check constraint
* definition> contained in either a <domain constraint> or a
* <table constraint definition>.
*
*
- The values of CONSTRAINT_CATALOG, CONSTRAINT_SCHEMA, and
* CONSTRAINT_NAME are the catalog name, unqualified schema name, and
* qualified identifier, respectively, of the assertion or check
* constraint being described.
*
*
- The values of SPECIFIC_CATALOG, SPECIFIC_SCHEMA, and SPECIFIC_NAME
* are the catalog name, unqualified schema name, and qualified
* identifier, respectively, of the specific name of R.
*
*
*/
Table SYSTEM_CHECK_ROUTINE_USAGE() throws HsqlException {
Table t = sysTables[SYSTEM_CHECK_ROUTINE_USAGE];
if (t == null) {
t = createBlankTable(
sysTableHsqlNames[SYSTEM_CHECK_ROUTINE_USAGE]);
addColumn(t, "CONSTRAINT_CATALOG", Types.VARCHAR);
addColumn(t, "CONSTRAINT_SCHEMA", Types.VARCHAR);
addColumn(t, "CONSTRAINT_NAME", Types.VARCHAR, false); // not null
addColumn(t, "SPECIFIC_CATALOG", Types.VARCHAR);
addColumn(t, "SPECIFIC_SCHEMA", Types.VARCHAR);
addColumn(t, "SPECIFIC_NAME", Types.VARCHAR, false); // not null
t.createPrimaryKey(null, new int[] {
0, 1, 2, 3, 4, 5
}, false);
return t;
}
// calculated column values
String constraintCatalog;
String constraintSchema;
String constraintName;
// Intermediate holders
Iterator tables;
Table table;
Constraint[] constraints;
int constraintCount;
Constraint constraint;
Expression.Collector collector;
Expression expression;
Function function;
Iterator iterator;
HashSet methodSet;
Method method;
Object[] row;
// column number mappings
final int icons_cat = 0;
final int icons_schem = 1;
final int icons_name = 2;
final int ir_cat = 3;
final int ir_schem = 4;
final int ir_name = 5;
tables = database.schemaManager.allTablesIterator();
collector = new Expression.Collector();
while (tables.hasNext()) {
collector.clear();
table = (Table) tables.next();
if (!isAccessibleTable(table)) {
continue;
}
constraints = table.getConstraints();
constraintCount = constraints.length;
constraintCatalog = ns.getCatalogName(table);
constraintSchema = table.getSchemaName();
for (int i = 0; i < constraintCount; i++) {
constraint = (Constraint) constraints[i];
if (constraint.getType() != Constraint.CHECK) {
continue;
}
constraintName = constraint.getName().name;
collector.addAll(constraint.core.check, Expression.FUNCTION);
methodSet = new HashSet();
iterator = collector.iterator();
while (iterator.hasNext()) {
expression = (Expression) iterator.next();
function = expression.function;
if (!session
.isAccessible(function.getMethod()
.getDeclaringClass().getName())) {
continue;
}
methodSet.add(function.getMethod());
}
iterator = methodSet.iterator();
while (iterator.hasNext()) {
method = (Method) iterator.next();
row = t.getEmptyRowData();
row[icons_cat] = constraintCatalog;
row[icons_schem] = constraintSchema;
row[icons_name] = constraintName;
row[ir_cat] = ns.getCatalogName(method);
row[ir_schem] = ns.getSchemaName(method);
row[ir_name] = DINameSpace.getMethodSpecificName(method);
t.insertSys(row);
}
}
}
t.setDataReadOnly(true);
return t;
}
/**
* The CHECK_TABLE_USAGE table has one row for each table identified by a
* <table name> simply contained in a <table reference>
* contained in the <search condition> of a check constraint,
* domain constraint, or assertion.
*
* Definition:
*
*
* CREATE STABLE SYSTEM_CHECK_TABLE_USAGE (
* CONSTRAINT_CATALOG VARCHAR NULL,
* CONSTRAINT_SCHEMA VARCHAR NULL,
* CONSTRAINT_NAME VARCHAR NOT NULL,
* TABLE_CATALOG VARCHAR NULL,
* TABLE_SCHEMA VARCHAR NOT NULL,
* TABLE_NAME INFORMATION_SCHEMA.SQL_IDENTIFIER,
* UNIQUE( CONSTRAINT_CATALOG, CONSTRAINT_SCHEMA, CONSTRAINT_NAME,
* TABLE_CATALOG, TABLE_SCHEMA, TABLE_NAME )
* )
*
*
* Description:
*
*
* - The values of CONSTRAINT_CATALOG, CONSTRAINT_SCHEMA, and
* CONSTRAINT_NAME are the catalog name, unqualified schema name,
* and qualified identifier, respectively, of the constraint being
* described.
*
*
- The values of TABLE_CATALOG, TABLE_SCHEMA, and TABLE_NAME are the
* catalog name, unqualified schema name, and qualified identifier,
* respectively, of a table identified by a <table name>
* simply contained in a <table reference> contained in the
* *lt;search condition> of the constraint being described.
*
*/
Table SYSTEM_CHECK_TABLE_USAGE() throws HsqlException {
Table t = sysTables[SYSTEM_CHECK_TABLE_USAGE];
if (t == null) {
t = createBlankTable(sysTableHsqlNames[SYSTEM_CHECK_TABLE_USAGE]);
addColumn(t, "CONSTRAINT_CATALOG", Types.VARCHAR);
addColumn(t, "CONSTRAINT_SCHEMA", Types.VARCHAR);
addColumn(t, "CONSTRAINT_NAME", Types.VARCHAR, false); // not null
addColumn(t, "TABLE_CATALOG", Types.VARCHAR);
addColumn(t, "TABLE_SCHEMA", Types.VARCHAR);
addColumn(t, "TABLE_NAME", Types.VARCHAR, false); // not null
t.createPrimaryKey(null, new int[] {
0, 1, 2, 3, 4, 5
}, false);
return t;
}
//
Result rs = session.sqlExecuteDirectNoPreChecks(
"select DISTINCT CONSTRAINT_CATALOG, CONSTRAINT_SCHEMA, "
+ "CONSTRAINT_NAME, TABLE_CATALOG, TABLE_SCHEMA, TABLE_NAME "
+ "from INFORMATION_SCHEMA.SYSTEM_CHECK_COLUMN_USAGE");
t.insertSys(rs);
t.setDataReadOnly(true);
return t;
}
/**
* The TABLE_CONSTRAINTS table has one row for each table constraint
* associated with a table.
*
* It effectively contains a representation of the table constraint
* descriptors.
*
* Definition:
*
*
* CREATE TABLE SYSTEM_TABLE_CONSTRAINTS (
* CONSTRAINT_CATALOG VARCHAR NULL,
* CONSTRAINT_SCHEMA VARCHAR NULL,
* CONSTRAINT_NAME VARCHAR NOT NULL,
* CONSTRAINT_TYPE VARCHAR NOT NULL,
* TABLE_CATALOG VARCHAR NULL,
* TABLE_SCHEMA VARCHAR NULL,
* TABLE_NAME VARCHAR NOT NULL,
* IS_DEFERRABLE VARCHAR NOT NULL,
* INITIALLY_DEFERRED VARCHAR NOT NULL,
*
* CHECK ( CONSTRAINT_TYPE IN
* ( 'UNIQUE', 'PRIMARY KEY',
* 'FOREIGN KEY', 'CHECK' ) ),
*
* CHECK ( ( IS_DEFERRABLE, INITIALLY_DEFERRED ) IN
* ( VALUES ( 'NO', 'NO' ),
* ( 'YES', 'NO' ),
* ( 'YES', 'YES' ) ) )
* )
*
*
* Description:
*
*
* - The values of CONSTRAINT_CATALOG, CONSTRAINT_SCHEMA, and
* CONSTRAINT_NAME are the catalog name, unqualified schema
* name, and qualified identifier, respectively, of the
* constraint being described. If the <table constraint
* definition> or <add table constraint definition>
* that defined the constraint did not specify a
* <constraint name>, then the values of CONSTRAINT_CATALOG,
* CONSTRAINT_SCHEMA, and CONSTRAINT_NAME are
* implementation-defined.
*
*
- The values of CONSTRAINT_TYPE have the following meanings:
*
*
* FOREIGN KEY
* The constraint being described is a
* foreign key constraint.
*
*
* UNIQUE
* The constraint being described is a
* unique constraint.
*
*
* PRIMARY KEY
* The constraint being described is a
* primary key constraint.
*
*
* CHECK
* The constraint being described is a
* check constraint.
*
*
*
*
- The values of TABLE_CATALOG, TABLE_SCHEMA, and TABLE_NAME are
* the catalog name, the unqualified schema name, and the
* qualified identifier of the name of the table to which the
* table constraint being described applies.
*
*
- The values of IS_DEFERRABLE have the following meanings:
*
*
*
* YES
* The table constraint is deferrable.
*
*
* NO
* The table constraint is not deferrable.
*
*
*
*
- The values of INITIALLY_DEFERRED have the following meanings:
*
*
*
* YES
* The table constraint is initially deferred.
*
*
* NO
* The table constraint is initially immediate.
*
*
*
*/
Table SYSTEM_TABLE_CONSTRAINTS() throws HsqlException {
Table t = sysTables[SYSTEM_TABLE_CONSTRAINTS];
if (t == null) {
t = createBlankTable(sysTableHsqlNames[SYSTEM_TABLE_CONSTRAINTS]);
addColumn(t, "CONSTRAINT_CATALOG", Types.VARCHAR);
addColumn(t, "CONSTRAINT_SCHEMA", Types.VARCHAR);
addColumn(t, "CONSTRAINT_NAME", Types.VARCHAR, false); // not null
addColumn(t, "CONSTRAINT_TYPE", Types.VARCHAR, 11, false); // not null
addColumn(t, "TABLE_CATALOG", Types.VARCHAR);
addColumn(t, "TABLE_SCHEMA", Types.VARCHAR);
addColumn(t, "TABLE_NAME", Types.VARCHAR, false); // not null
addColumn(t, "IS_DEFERRABLE", Types.VARCHAR, 3, false); // not null
addColumn(t, "INITIALLY_DEFERRED", Types.VARCHAR, 3, false); // not null
// false PK, as CONSTRAINT_CATALOG, CONSTRAINT_SCHEMA,
// TABLE_CATALOG and/or TABLE_SCHEMA may be null
t.createPrimaryKey(null, new int[] {
0, 1, 2, 4, 5, 6
}, false);
return t;
}
// Intermediate holders
Iterator tables;
Table table;
Constraint[] constraints;
int constraintCount;
Constraint constraint;
String cat;
String schem;
HashSet constraintSet;
Object[] row;
// column number mappings
final int icons_cat = 0;
final int icons_schem = 1;
final int icons_name = 2;
final int icons_type = 3;
final int itab_cat = 4;
final int itab_schem = 5;
final int itab_name = 6;
final int iis_defr = 7;
final int iinit_defr = 8;
// initialization
tables = database.schemaManager.allTablesIterator();
constraintSet = new HashSet();
table = null; // else complier complains
// do it
while (tables.hasNext()) {
table = (Table) tables.next();
if (table.isView() || !isAccessibleTable(table)) {
continue;
}
constraints = table.getConstraints();
constraintCount = constraints.length;
for (int i = 0; i < constraintCount; i++) {
constraint = constraints[i];
if (constraint.getType() == Constraint.FOREIGN_KEY
&& !isAccessibleTable(constraint.getRef())) {
continue;
}
constraintSet.add(constraint);
}
}
for (Iterator it = constraintSet.iterator(); it.hasNext(); ) {
row = t.getEmptyRowData();
constraint = (Constraint) it.next();
switch (constraint.getType()) {
case Constraint.CHECK : {
row[icons_type] = "CHECK";
table = constraint.getMain();
break;
}
case Constraint.UNIQUE : {
row[icons_type] = "UNIQUE";
table = constraint.getMain();
break;
}
case Constraint.FOREIGN_KEY : {
row[icons_type] = "FOREIGN KEY";
table = constraint.getRef();
break;
}
case Constraint.PRIMARY_KEY : {
row[icons_type] = "PRIMARY KEY";
table = constraint.getMain();
break;
}
case Constraint.MAIN :
default : {
continue;
}
}
cat = ns.getCatalogName(table);
schem = table.getSchemaName();
row[icons_cat] = cat;
row[icons_schem] = schem;
row[icons_name] = constraint.constName.name;
row[itab_cat] = cat;
row[itab_schem] = schem;
row[itab_name] = table.getName().name;
row[iis_defr] = "NO";
row[iinit_defr] = "NO";
t.insertSys(row);
}
t.setDataReadOnly(true);
return t;
}
/**
* The SYSTEM_VIEW_TABLE_USAGE table has one row for each table identified
* by a <table name> simply contained in a <table reference>
* that is contained in the <query expression> of a view.
*
* Definition
*
*
* CREATE TABLE SYSTEM_VIEW_TABLE_USAGE (
* VIEW_CATALOG VARCHAR NULL,
* VIEW_SCHEMA VARCHAR NULL,
* VIEW_NAME VARCHAR NULL,
* TABLE_CATALOG VARCHAR NULL,
* TABLE_SCHEMA VARCHAR NULL,
* TABLE_NAME VARCHAR NULL,
* UNIQUE( VIEW_CATALOG, VIEW_SCHEMA, VIEW_NAME,
* TABLE_CATALOG, TABLE_SCHEMA, TABLE_NAME )
* )
*
*
* Description:
*
*
* - The values of VIEW_CATALOG, VIEW_SCHEMA, and VIEW_NAME are the
* catalog name, unqualified schema name, and qualified identifier,
* respectively, of the view being described.
*
*
- The values of TABLE_CATALOG, TABLE_SCHEMA, and TABLE_NAME are the
* catalog name, unqualified schema name, and qualified identifier,
* respectively, of a table identified by a <table name>
* simply contained in a <table reference> that is contained in
* the <query expression> of the view being described.
*
*/
Table SYSTEM_VIEW_TABLE_USAGE() throws HsqlException {
Table t = sysTables[SYSTEM_VIEW_TABLE_USAGE];
if (t == null) {
t = createBlankTable(sysTableHsqlNames[SYSTEM_VIEW_TABLE_USAGE]);
addColumn(t, "VIEW_CATALOG", Types.VARCHAR);
addColumn(t, "VIEW_SCHEMA", Types.VARCHAR);
addColumn(t, "VIEW_NAME", Types.VARCHAR, true); // not null
addColumn(t, "TABLE_CATALOG", Types.VARCHAR);
addColumn(t, "TABLE_SCHEMA", Types.VARCHAR);
addColumn(t, "TABLE_NAME", Types.VARCHAR, true); // not null
// false PK, as VIEW_CATALOG, VIEW_SCHEMA, TABLE_CATALOG, and/or
// TABLE_SCHEMA may be NULL
t.createPrimaryKey(null, new int[] {
0, 1, 2, 3, 4, 5
}, false);
return t;
}
//
Result rs = session.sqlExecuteDirectNoPreChecks(
"select DISTINCT VIEW_CATALOG, VIEW_SCHEMA, "
+ "VIEW_NAME, TABLE_CATALOG, TABLE_SCHEMA, TABLE_NAME "
+ "from INFORMATION_SCHEMA.SYSTEM_VIEW_COLUMN_USAGE");
t.insertSys(rs);
t.setDataReadOnly(true);
return t;
}
/**
* The SYSTEM_VIEW_COLUMN_USAGE table has one row for each column of a
* table that is explicitly or implicitly referenced in the
* <query expression> of the view being described.
*
* Definition:
*
*
* CREATE TABLE SYSTEM_VIEW_COLUMN_USAGE (
* VIEW_CATALOG VARCHAR NULL,
* VIEW_SCHEMA VARCHAR NULL,
* VIEW_NAME VARCHAR NOT NULL,
* TABLE_CATALOG VARCHAR NULL,
* TABLE_SCHEMA VARCHAR NULL,
* TABLE_NAME VARCHAR NOT NULL,
* COLUMN_NAME VARCHAR NOT NULL,
* UNIQUE ( VIEW_CATALOG, VIEW_SCHEMA, VIEW_NAME,
* TABLE_CATALOG, TABLE_SCHEMA, TABLE_NAME,
* COLUMN_NAME )
* )
*
*
* Description:
*
*
* - The values of VIEW_CATALOG, VIEW_SCHEMA, and VIEW_NAME are the
* catalog name, unqualified schema name, and qualified identifier,
* respectively, of the view being described.
*
*
- The values of TABLE_CATALOG, TABLE_SCHEMA, TABLE_NAME, and
* COLUMN_NAME are the catalog name, unqualified schema name,
* qualified identifier, and column name, respectively, of a column
* of a table that is explicitly or implicitly referenced in the
* <query expression> of the view being described.
*
*/
Table SYSTEM_VIEW_COLUMN_USAGE() throws HsqlException {
Table t = sysTables[SYSTEM_VIEW_COLUMN_USAGE];
if (t == null) {
t = createBlankTable(sysTableHsqlNames[SYSTEM_VIEW_COLUMN_USAGE]);
addColumn(t, "VIEW_CATALOG", Types.VARCHAR);
addColumn(t, "VIEW_SCHEMA", Types.VARCHAR);
addColumn(t, "VIEW_NAME", Types.VARCHAR, true); // not null
addColumn(t, "TABLE_CATALOG", Types.VARCHAR);
addColumn(t, "TABLE_SCHEMA", Types.VARCHAR);
addColumn(t, "TABLE_NAME", Types.VARCHAR, true); // not null
addColumn(t, "COLUMN_NAME", Types.VARCHAR, true); // not null
// false PK, as VIEW_CATALOG, VIEW_SCHEMA, TABLE_CATALOG, and/or
// TABLE_SCHEMA may be NULL
t.createPrimaryKey(null, new int[] {
0, 1, 2, 3, 4, 5, 6
}, false);
return t;
}
// Calculated column values
String viewCatalog;
String viewSchema;
String viewName;
// Intermediate holders
Iterator tables;
View view;
Table table;
Object[] row;
SubQuery[] subqueries;
Select select;
Expression expression;
TableFilter tableFilter;
Table columnTable;
Result result;
Object[] resultRow;
Iterator iterator;
Expression.Collector collector;
// Column number mappings
final int iv_cat = 0;
final int iv_schem = 1;
final int iv_name = 2;
final int it_cat = 3;
final int it_schem = 4;
final int it_name = 5;
final int it_cname = 6;
// Initialization
tables = database.schemaManager.allTablesIterator();
collector = new Expression.Collector();
result = new Result(ResultConstants.DATA, 4);
result.metaData.colTypes[0] = result.metaData.colTypes[1] =
result.metaData.colTypes[2] = result.metaData.colTypes[3] =
Types.VARCHAR;
// Do it.
while (tables.hasNext()) {
collector.clear();
result.setRows(null);
table = (Table) tables.next();
if (table.isView() && isAccessibleTable(table)) {
// fall through
} else {
continue;
}
viewCatalog = ns.getCatalogName(table);
viewSchema = table.getSchemaName();
viewName = table.getName().name;
view = (View) table;
subqueries = view.viewSubqueries;
collector.addAll(view.viewSelect, Expression.COLUMN);
for (int i = 0; i < subqueries.length; i++) {
collector.addAll(subqueries[i].select, Expression.COLUMN);
}
iterator = collector.iterator();
while (iterator.hasNext()) {
expression = (Expression) iterator.next();
tableFilter = expression.getFilter();
columnTable = tableFilter.getTable();
if (columnTable.getTableType() == Table.SYSTEM_SUBQUERY
|| !isAccessibleTable(columnTable)) {
continue;
}
result.add(new Object[] {
ns.getCatalogName(columnTable),
columnTable.getSchemaName(), columnTable.getName().name,
expression.getColumnName()
});
}
/*
result.removeDuplicates(
database.sessionManager.getSysSession(
database.schemaManager.INFORMATION_SCHEMA));
*/
result.removeDuplicates(session);
iterator = result.iterator();
while (iterator.hasNext()) {
row = t.getEmptyRowData();
resultRow = (Object[]) iterator.next();
row[iv_cat] = viewCatalog;
row[iv_schem] = viewSchema;
row[iv_name] = viewName;
row[it_cat] = resultRow[0];
row[it_schem] = resultRow[1];
row[it_name] = resultRow[2];
row[it_cname] = resultRow[3];
t.insertSys(row);
}
}
t.setDataReadOnly(true);
return t;
}
/**
* The SYSTEM_VIEW_ROUTINE_USAGE table has one row for each SQL-invoked
* routine identified as the subject routine of either a <routine
* invocation>, a <method reference>, a <method invocation>,
* or a <static method invocation> contained in a <view
* definition>.
*
* Definition
*
*
* CREATE TABLE VIEW_ROUTINE_USAGE (
* TABLE_CATALOG VARCHAR NULL,
* TABLE_SCHEMA VARCHAR NULL,
* TABLE_NAME VARCHAR NOT NULL,
* SPECIFIC_CATALOG VARCHAR NULL,
* SPECIFIC_SCHEMA VARCHAR NULL,
* SPECIFIC_NAME VARCHAR NOT NULL,
* UNIQUE( TABLE_CATALOG, TABLE_SCHEMA, TABLE_NAME,
* SPECIFIC_CATALOG, SPECIFIC_SCHEMA,
* SPECIFIC_NAME )
* )
*
*
* Description
*
*
* - The values of TABLE_CATALOG, TABLE_SCHEMA, and TABLE_NAME are the
* catalog name, unqualified schema name, and qualified identifier,
* respectively, of the viewed table being described.
*
*
- The values of SPECIFIC_CATALOG, SPECIFIC_SCHEMA, and SPECIFIC_NAME are
* the catalog name, unqualified schema name, and qualified identifier,
* respectively, of the specific name of R.
*
*/
Table SYSTEM_VIEW_ROUTINE_USAGE() throws HsqlException {
Table t = sysTables[SYSTEM_VIEW_ROUTINE_USAGE];
if (t == null) {
t = createBlankTable(sysTableHsqlNames[SYSTEM_VIEW_ROUTINE_USAGE]);
addColumn(t, "TABLE_CATALOG", Types.VARCHAR);
addColumn(t, "TABLE_SCHEMA", Types.VARCHAR);
addColumn(t, "TABLE_NAME", Types.VARCHAR, true); // not null
addColumn(t, "SPECIFIC_CATALOG", Types.VARCHAR);
addColumn(t, "SPECIFIC_SCHEMA", Types.VARCHAR);
addColumn(t, "SPECIFIC_NAME", Types.VARCHAR, true); // not null
// false PK, as VIEW_CATALOG, VIEW_SCHEMA, TABLE_CATALOG, and/or
// TABLE_SCHEMA may be NULL
t.createPrimaryKey(null, new int[] {
0, 1, 2, 3, 4, 5
}, false);
return t;
}
// Calculated column values
String viewCat;
String viewSchem;
String viewName;
// Intermediate holders
Iterator tables;
View view;
Table table;
Object[] row;
SubQuery[] subqueries;
Select select;
Expression expression;
Function function;
Expression.Collector collector;
Method method;
HashSet methodSet;
Iterator iterator;
// Column number mappings
final int iv_cat = 0;
final int iv_schem = 1;
final int iv_name = 2;
final int ir_cat = 3;
final int ir_schem = 4;
final int ir_name = 5;
final int ir_sig = 6;
// Initialization
tables = database.schemaManager.allTablesIterator();
collector = new Expression.Collector();
// Do it.
while (tables.hasNext()) {
collector.clear();
table = (Table) tables.next();
if (table.isView() && isAccessibleTable(table)) {
// fall through
} else {
continue;
}
viewCat = ns.getCatalogName(table);
viewSchem = table.getSchemaName();
viewName = table.getName().name;
view = (View) table;
subqueries = view.viewSubqueries;
collector.addAll(view.viewSelect, Expression.FUNCTION);
for (int i = 0; i < subqueries.length; i++) {
collector.addAll(subqueries[i].select, Expression.FUNCTION);
}
methodSet = new HashSet();
iterator = collector.iterator();
while (iterator.hasNext()) {
expression = (Expression) iterator.next();
function = expression.function;
if (session.isAccessible(
function.getMethod().getDeclaringClass().getName())) {
methodSet.add(function.getMethod());
}
}
iterator = methodSet.iterator();
while (iterator.hasNext()) {
method = (Method) iterator.next();
row = t.getEmptyRowData();
row[iv_cat] = viewCat;
row[iv_schem] = viewSchem;
row[iv_name] = viewName;
row[ir_cat] = ns.getCatalogName(method);
row[ir_schem] = ns.getSchemaName(method);
row[ir_name] = DINameSpace.getMethodSpecificName(method);
t.insertSys(row);
}
}
t.setDataReadOnly(true);
return t;
}
/**
* Inserts a set of procedure column description rows into the
* Table specified by the t argument.
*
* @param t the table in which the rows are to be inserted
* @param l the list of procedure name aliases to which the
* specified column values apply
* @param cat the procedure's catalog name
* @param schem the procedure's schema name
* @param pName the procedure's simple base (non-alias) name
* @param cName the procedure column name
* @param cType the column type (return, parameter, result)
* @param dType the column's data type code
* @param tName the column's canonical data type name
* @param prec the column's precision
* @param len the column's buffer length
* @param scale the column's scale (decimal digits)
* @param radix the column's numeric precision radix
* @param nullability the column's java.sql.DatbaseMetaData
* nullabiliy code
* @param remark a human-readable remark regarding the column
* @param specificName the specific name of the procedure
* (typically but not limited to
* a fully qualified Java Method name and signature)
* @param seq helper value to back JDBC contract sort order
* @throws HsqlException if there is problem inserting the specified rows
* in the table
*
*/
protected void addPColRows(Table t, HsqlArrayList l, String cat,
String schem, String pName, String cName,
Integer cType, Integer dType, String tName,
Integer prec, Integer len, Integer scale,
Integer radix, Integer nullability,
String remark, String specificName,
int seq) throws HsqlException {
// column number mappings
final int icat = 0;
final int ischem = 1;
final int iname = 2;
final int icol_name = 3;
final int icol_type = 4;
final int idata_type = 5;
final int itype_name = 6;
final int iprec = 7;
final int ilength = 8;
final int iscale = 9;
final int iradix = 10;
final int inullable = 11;
final int iremark = 12;
final int isn = 13;
final int iseq = 14;
Object[] row = t.getEmptyRowData();
Integer sequence = ValuePool.getInt(seq);
row[icat] = cat;
row[ischem] = schem;
row[iname] = pName;
row[icol_name] = cName;
row[icol_type] = cType;
row[idata_type] = dType;
row[itype_name] = tName;
row[iprec] = prec;
row[ilength] = len;
row[iscale] = scale;
row[iradix] = radix;
row[inullable] = nullability;
row[iremark] = remark;
row[isn] = specificName;
row[iseq] = sequence;
t.insertSys(row);
if (l != null) {
int size = l.size();
for (int i = 0; i < size; i++) {
row = t.getEmptyRowData();
pName = (String) l.get(i);
row[icat] = cat;
row[ischem] = schem;
row[iname] = pName;
row[icol_name] = cName;
row[icol_type] = cType;
row[idata_type] = dType;
row[itype_name] = tName;
row[iprec] = prec;
row[ilength] = len;
row[iscale] = scale;
row[iradix] = radix;
row[inullable] = nullability;
row[iremark] = remark;
row[isn] = specificName;
row[iseq] = sequence;
t.insertSys(row);
}
}
}
/**
* Inserts a set of procedure description rows into the Table
* object specified by the t argument.
*
* @param t the table into which the specified rows will eventually
* be inserted
* @param l the list of procedure name aliases to which the specified column
* values apply
* @param cat the procedure catalog name
* @param schem the procedure schema name
* @param pName the base (non-alias) procedure name
* @param ip the procedure input parameter count
* @param op the procedure output parameter count
* @param rs the procedure result column count
* @param remark a human-readable remark regarding the procedure
* @param pType the procedure type code, indicating whether it is a
* function, procedure, or uncatagorized (i.e. returns
* a value, does not return a value, or it is unknown
* if it returns a value)
* @param origin origin of the procedure, e.g.
* (["BUILTIN" | "USER DEFINED"] "ROUTINE" | "TRIGGER") | "ALIAS", etc.
* @param specificName the specific name of the procedure
* (typically but not limited to a
* fully qualified Java Method name and signature)
* @throws HsqlException if there is problem inserting the specified rows
* in the table
*
*/
protected void addProcRows(Table t, HsqlArrayList l, String cat,
String schem, String pName, Integer ip,
Integer op, Integer rs, String remark,
Integer pType, String origin,
String specificName) throws HsqlException {
// column number mappings
final int icat = 0;
final int ischem = 1;
final int ipname = 2;
final int iinput_parms = 3;
final int ioutput_parms = 4;
final int iresult_sets = 5;
final int iremark = 6;
final int iptype = 7;
final int iporigin = 8;
final int isn = 9;
Object[] row = t.getEmptyRowData();
row[icat] = cat;
row[ischem] = schem;
row[ipname] = pName;
row[iinput_parms] = ip;
row[ioutput_parms] = op;
row[iresult_sets] = rs;
row[iremark] = remark;
row[iptype] = pType;
row[iporigin] = origin;
row[isn] = specificName;
t.insertSys(row);
if (l != null) {
int size = l.size();
for (int i = 0; i < size; i++) {
row = t.getEmptyRowData();
pName = (String) l.get(i);
row[icat] = cat;
row[ischem] = schem;
row[ipname] = pName;
row[iinput_parms] = ip;
row[ioutput_parms] = op;
row[iresult_sets] = rs;
row[iremark] = remark;
row[iptype] = pType;
row[iporigin] = "ALIAS";
row[isn] = specificName;
t.insertSys(row);
}
}
}
//------------------------------------------------------------------------------
// boucherb@users 20050515 further SQL2003 metadata support
/**
* SYSTEM_AUTHORIZATIONS
*
* Function
*
* The AUTHORIZATIONS table has one row for each <role name> and
* one row for each <authorization identifier > referenced in the
* Information Schema. These are the <role name>s and
* <authorization identifier>s that may grant privileges as well as
* those that may create a schema, or currently own a schema created
* through a <schema definition>.
*
* Definition
*
*
* CREATE TABLE AUTHORIZATIONS (
* AUTHORIZATION_NAME INFORMATION_SCHEMA.SQL_IDENTIFIER,
* AUTHORIZATION_TYPE INFORMATION_SCHEMA.CHARACTER_DATA
* CONSTRAINT AUTHORIZATIONS_AUTHORIZATION_TYPE_NOT_NULL
* NOT NULL
* CONSTRAINT AUTHORIZATIONS_AUTHORIZATION_TYPE_CHECK
* CHECK ( AUTHORIZATION_TYPE IN ( 'USER', 'ROLE' ) ),
* CONSTRAINT AUTHORIZATIONS_PRIMARY_KEY
* PRIMARY KEY (AUTHORIZATION_NAME)
* )
*
*
* Description
*
*
* - The values of AUTHORIZATION_TYPE have the following meanings:
*
*
*
* USER
* The value of AUTHORIZATION_NAME is a known
* <user identifier>.
*
*
* NO
* The value of AUTHORIZATION_NAME is a <role
* name> defined by a <role definition>.
*
*
*
*/
Table SYSTEM_AUTHORIZATIONS() throws HsqlException {
Table t = sysTables[SYSTEM_AUTHORIZATIONS];
if (t == null) {
t = createBlankTable(sysTableHsqlNames[SYSTEM_AUTHORIZATIONS]);
addColumn(t, "AUTHORIZATION_NAME", Types.VARCHAR, true); // not null
addColumn(t, "AUTHORIZATION_TYPE", Types.VARCHAR, true); // not null
// true PK
t.createPrimaryKey(null, new int[]{ 0 }, true);
return t;
}
// Intermediate holders
HsqlArrayList users;
Iterator roles;
User user;
int userCount;
Object[] row;
// Initialization
users = database.getUserManager().listVisibleUsers(session, false);
userCount = users.size();
// Do it.
for (int i = 0; i < users.size(); i++) {
row = t.getEmptyRowData();
user = (User) users.get(i);
row[0] = user.getName();
row[1] = "USER";
t.insertSys(row);
}
roles = database.getGranteeManager().getRoleNames().iterator();
while (roles.hasNext()) {
row = t.getEmptyRowData();
row[0] = roles.next().toString();
row[1] = "ROLE";
t.insertSys(row);
}
t.setDataReadOnly(true);
return t;
}
/**
* SYSTEM_COLLATIONS
*
* Function
*
* The COLLATIONS table has one row for each character collation
* descriptor.
*
* Definition
*
*
* CREATE TABLE COLLATIONS (
* COLLATION_CATALOG INFORMATION_SCHEMA.SQL_IDENTIFIER,
* COLLATION_SCHEMA INFORMATION_SCHEMA.SQL_IDENTIFIER,
* COLLATION_NAME INFORMATION_SCHEMA.SQL_IDENTIFIER,
* PAD_ATTRIBUTE INFORMATION_SCHEMA.CHARACTER_DATA
* CONSTRAINT COLLATIONS_PAD_ATTRIBUTE_CHECK
* CHECK ( PAD_ATTRIBUTE IN
* ( 'NO PAD', 'PAD SPACE' ) ),
* COLLATION_TYPE INFORMATION_SCHEMA.SQL_IDENTIFIER,
* COLLATION_DEFINITION INFORMATION_SCHEMA.CHARACTER_DATA,
* COLLATION_DICTIONARY INFORMATION_SCHEMA.CHARACTER_DATA,
* CHARACTER_REPERTOIRE_NAME INFORMATION_SCHEMA.SQL_IDENTIFIER
* CONSTRAINT CHARACTER_REPERTOIRE_NAME_NOT_NULL
* NOT NULL,
* CONSTRAINT COLLATIONS_PRIMARY_KEY
* PRIMARY KEY ( COLLATION_CATALOG, COLLATION_SCHEMA, COLLATION_NAME ),
* CONSTRAINT COLLATIONS_FOREIGN_KEY_SCHEMATA
* FOREIGN KEY ( COLLATION_CATALOG, COLLATION_SCHEMA )
* REFERENCES SCHEMATA
* )
*
*
* Description
*
*
* - The values of COLLATION_CATALOG, COLLATION_SCHEMA, and
* COLLATION_NAME are the catalog name, unqualified schema name,
* and qualified identifier, respectively, of the collation being
* described.
*
*
- The values of COLLATION_TYPE, COLLATION_DICTIONARY, and
* COLLATION_DEFINITION are the null value (deprectated).
*
*
- The values of PAD_ATTRIBUTE have the following meanings:
*
*
*
* NO PAD
* The collation being described has the NO PAD
* characteristic.
*
*
* PAD
* The collation being described has the PAD SPACE
* characteristic.
*
*
*
*
- The value of CHARACTER_REPERTOIRE_NAME is the name of the
* character repertoire to which the collation being described
* is applicable.
*
*/
Table SYSTEM_COLLATIONS() throws HsqlException {
Table t = sysTables[SYSTEM_COLLATIONS];
if (t == null) {
t = createBlankTable(sysTableHsqlNames[SYSTEM_COLLATIONS]);
addColumn(t, "COLLATION_CATALOG", Types.VARCHAR);
addColumn(t, "COLLATION_SCHEMA", Types.VARCHAR, true);
addColumn(t, "COLLATION_NAME", Types.VARCHAR, true);
addColumn(t, "PAD_ATTRIBUTE", Types.VARCHAR, 9, true);
addColumn(t, "COLLATION_TYPE", Types.VARCHAR, true);
addColumn(t, "COLLATION_DEFINITION", Types.VARCHAR);
addColumn(t, "COLLATION_DICTIONARY", Types.VARCHAR);
addColumn(t, "CHARACTER_REPERTOIRE_NAME", Types.VARCHAR, true);
// false PK, as rows may have NULL COLLATION_CATALOG
t.createPrimaryKey(null, new int[] {
0, 1, 2
}, false);
return t;
}
Iterator collations;
String collation;
String collationSchema = SchemaManager.PUBLIC_SCHEMA;
String padAttribute = "NO PAD";
String characterRepertoireName = "UNICODE";
Object[] row;
final int icolcat = 0;
final int icolschem = 1;
final int icolname = 2;
final int ipadattr = 3;
final int icoltype = 4;
final int icoldef = 5;
final int icoldict = 6;
final int icharrep = 7;
collations = Collation.nameToJavaName.keySet().iterator();
while (collations.hasNext()) {
row = t.getEmptyRowData();
collation = (String) collations.next();
row[icolcat] = ns.getCatalogName(collation);
row[icolschem] = collationSchema;
row[icolname] = collation;
row[ipadattr] = padAttribute;
row[icharrep] = characterRepertoireName;
t.insertSys(row);
}
t.setDataReadOnly(true);
return t;
}
/**
* SYSTEM_ENABLED_ROLES
*
* Function
*
* Identify the enabled roles for the current SQL-session.
*
* Definition
*
*
* CREATE RECURSIVE VIEW ENABLED_ROLES ( ROLE_NAME ) AS
* VALUES ( CURRENT_ROLE )
* UNION
* SELECT RAD.ROLE_NAME
* FROM DEFINITION_SCHEMA.ROLE_AUTHORIZATION_DESCRIPTORS RAD
* JOIN ENABLED_ROLES R
* ON RAD.GRANTEE = R.ROLE_NAME;
*
* GRANT SELECT ON TABLE ENABLED_ROLES
* TO PUBLIC WITH GRANT OPTION;
*
*/
/**
* SYSTEM_APPLICABLE_ROLES
*
* Function
*
* Identifies the applicable roles for the current user.
*
* Definition
*
*
* CREATE RECURSIVE VIEW APPLICABLE_ROLES ( GRANTEE, ROLE_NAME, IS_GRANTABLE ) AS
* ( ( SELECT GRANTEE, ROLE_NAME, IS_GRANTABLE
* FROM DEFINITION_SCHEMA.ROLE_AUTHORIZATION_DESCRIPTORS
* WHERE ( GRANTEE IN ( CURRENT_USER, 'PUBLIC' )
* OR GRANTEE IN ( SELECT ROLE_NAME
* FROM ENABLED_ROLES ) ) )
* UNION
* ( SELECT RAD.GRANTEE, RAD.ROLE_NAME, RAD.IS_GRANTABLE
* FROM DEFINITION_SCHEMA.ROLE_AUTHORIZATION_DESCRIPTORS RAD
* JOIN APPLICABLE_ROLES R
* ON RAD.GRANTEE = R.ROLE_NAME ) );
*
* GRANT SELECT ON TABLE APPLICABLE_ROLES
* TO PUBLIC WITH GRANT OPTION;
*
*/
/**
* SYSTEM_ROLE_AUTHORIZATION_DESCRIPTORS
*
* Function
*
* Contains a representation of the role authorization descriptors.
*
* Definition
*
*
* CREATE TABLE ROLE_AUTHORIZATION_DESCRIPTORS (
* ROLE_NAME INFORMATION_SCHEMA.SQL_IDENTIFIER,
* GRANTEE INFORMATION_SCHEMA.SQL_IDENTIFIER,
* GRANTOR INFORMATION_SCHEMA.SQL_IDENTIFIER,
* IS_GRANTABLE INFORMATION_SCHEMA.CHARACTER_DATA
* CONSTRAINT ROLE_AUTHORIZATION_DESCRIPTORS_IS_GRANTABLE_CHECK
* CHECK ( IS_GRANTABLE IN
* ( 'YES', 'NO' ) ),
* CONSTRAINT ROLE_AUTHORIZATION_DESCRIPTORS_PRIMARY_KEY
* PRIMARY KEY ( ROLE_NAME, GRANTEE ),
* CONSTRAINT ROLE_AUTHORIZATION_DESCRIPTORS_CHECK_ROLE_NAME
* CHECK ( ROLE_NAME IN
* ( SELECT AUTHORIZATION_NAME
* FROM AUTHORIZATIONS
* WHERE AUTHORIZATION_TYPE = 'ROLE' ) ),
* CONSTRAINT ROLE_AUTHORIZATION_DESCRIPTORS_FOREIGN_KEY_AUTHORIZATIONS_GRANTOR
* FOREIGN KEY ( GRANTOR )
* REFERENCES AUTHORIZATIONS,
* CONSTRAINT ROLE_AUTHORIZATION_DESCRIPTORS_FOREIGN_KEY_AUTHORIZATIONS_GRANTEE
* FOREIGN KEY ( GRANTEE )
* REFERENCES AUTHORIZATIONS
* )
*
*
* Description
*
*
* - The value of ROLE_NAME is the <role name> of some
* <role granted> by the <grant role statement> or
* the <role name> of a <role definition>.
*
*
- The value of GRANTEE is an <authorization identifier>,
* possibly PUBLIC, or <role name> specified as a
* <grantee> contained in a <grant role statement>,
* or the <authorization identifier> of the current
* SQLsession when the <role definition> is executed.
*
*
- The value of GRANTOR is the <authorization identifier>
* of the user or role who granted the role identified by
* ROLE_NAME to the user or role identified by the value of
* GRANTEE.
*
*
- The values of IS_GRANTABLE have the following meanings:
*
*
*
* YES
* The described role is grantable.
*
*
* NO
* The described role is not grantable.
*
*
*
*/
Table SYSTEM_ROLE_AUTHORIZATION_DESCRIPTORS() throws HsqlException {
Table t = sysTables[SYSTEM_ROLE_AUTHORIZATION_DESCRIPTORS];
if (t == null) {
t = createBlankTable(
sysTableHsqlNames[SYSTEM_ROLE_AUTHORIZATION_DESCRIPTORS]);
addColumn(t, "ROLE_NAME", Types.VARCHAR, true); // not null
addColumn(t, "GRANTEE", Types.VARCHAR, true); // not null
addColumn(t, "GRANTOR", Types.VARCHAR, true); // not null
addColumn(t, "IS_GRANTABLE", Types.VARCHAR, true); // not null
// true PK
t.createPrimaryKey(null, new int[] {
0, 1
}, true);
return t;
}
// Intermediate holders
String grantorName = GranteeManager.SYSTEM_AUTHORIZATION_NAME;
Iterator grantees;
Grantee grantee;
String granteeName;
Iterator roles;
String roleName;
String isGrantable;
Object[] row;
final int irole = 0;
final int igrantee = 1;
final int igrantor = 2;
final int igrantable = 3;
// Initialization
grantees = database.getGranteeManager().getGrantees().iterator();
// Do it.
while (grantees.hasNext()) {
grantee = (Grantee) grantees.next();
granteeName = grantee.getName();
roles = grantee.getDirectRoles().iterator();
while (roles.hasNext()) {
row = t.getEmptyRowData();
roleName = (String) roles.next();
isGrantable =
grantee.hasRole(GranteeManager.DBA_ADMIN_ROLE_NAME) ? "YES"
: "NO";
row[irole] = roleName;
row[igrantee] = granteeName;
row[igrantor] = grantorName;
row[igrantable] = isGrantable;
t.insertSys(row);
}
}
t.setDataReadOnly(true);
return t;
}
/**
* SYSTEM_SCHEMATA
*
* Function
*
* The SCHEMATA table has one row for each schema.
*
* Definition
*
*
* CREATE TABLE SCHEMATA (
* CATALOG_NAME INFORMATION_SCHEMA.SQL_IDENTIFIER,
* SCHEMA_NAME INFORMATION_SCHEMA.SQL_IDENTIFIER,
* SCHEMA_OWNER INFORMATION_SCHEMA.SQL_IDENTIFIER
* CONSTRAINT SCHEMA_OWNER_NOT_NULL
* NOT NULL,
* DEFAULT_CHARACTER_SET_CATALOG INFORMATION_SCHEMA.SQL_IDENTIFIER
* CONSTRAINT DEFAULT_CHARACTER_SET_CATALOG_NOT_NULL
* NOT NULL,
* DEFAULT_CHARACTER_SET_SCHEMA INFORMATION_SCHEMA.SQL_IDENTIFIER
* CONSTRAINT DEFAULT_CHARACTER_SET_SCHEMA_NOT_NULL
* NOT NULL,
* DEFAULT_CHARACTER_SET_NAME INFORMATION_SCHEMA.SQL_IDENTIFIER
* CONSTRAINT DEFAULT_CHARACTER_SET_NAME_NOT_NULL
* NOT NULL,
* SQL_PATH INFORMATION_SCHEMA.CHARACTER_DATA,
*
* CONSTRAINT SCHEMATA_PRIMARY_KEY
* PRIMARY KEY ( CATALOG_NAME, SCHEMA_NAME ),
* CONSTRAINT SCHEMATA_FOREIGN_KEY_AUTHORIZATIONS
* FOREIGN KEY ( SCHEMA_OWNER )
* REFERENCES AUTHORIZATIONS,
* CONSTRAINT SCHEMATA_FOREIGN_KEY_CATALOG_NAMES
* FOREIGN KEY ( CATALOG_NAME )
* REFERENCES CATALOG_NAMES
* )
*
*
* Description
*
*
* - The value of CATALOG_NAME is the name of the catalog of the
* schema described by this row.
*
*
- The value of SCHEMA_NAME is the unqualified schema name of
* the schema described by this row.
*
*
- The values of SCHEMA_OWNER are the authorization identifiers
* that own the schemata.
*
*
- The values of DEFAULT_CHARACTER_SET_CATALOG,
* DEFAULT_CHARACTER_SET_SCHEMA, and DEFAULT_CHARACTER_SET_NAME
* are the catalog name, unqualified schema name, and qualified
* identifier, respectively, of the default character set for
* columns and domains in the schemata.
*
*
- Case:
*
* - If <schema path specification> was specified in
* the <schema definition> that defined the schema
* described by this row and the character representation
* of the <schema path specification> can be
* represented without truncation, then the value of
* SQL_PATH is that character representation.
*
*
- Otherwise, the value of SQL_PATH is the null value.
*
*
*/
Table SYSTEM_SCHEMATA() throws HsqlException {
Table t = sysTables[SYSTEM_SCHEMATA];
if (t == null) {
t = createBlankTable(sysTableHsqlNames[SYSTEM_SCHEMATA]);
addColumn(t, "CATALOG_NAME", Types.VARCHAR);
addColumn(t, "SCHEMA_NAME", Types.VARCHAR, true);
addColumn(t, "SCHEMA_OWNER", Types.VARCHAR, true);
addColumn(t, "DEFAULT_CHARACTER_SET_CATALOG", Types.VARCHAR);
addColumn(t, "DEFAULT_CHARACTER_SET_SCHEMA", Types.VARCHAR, true);
addColumn(t, "DEFAULT_CHARACTER_SET_NAME", Types.VARCHAR);
addColumn(t, "SQL_PATH", Types.VARCHAR);
// order: CATALOG_NAME, SCHEMA_NAME
// false PK, as rows may have NULL CATALOG_NAME
t.createPrimaryKey(null, new int[] {
0, 1
}, false);
return t;
}
Iterator schemas;
String schema;
String schemaOwner = GranteeManager.DBA_ADMIN_ROLE_NAME;
String dcsSchema = SchemaManager.INFORMATION_SCHEMA;
String dcsName = ValuePool.getString("UTF16");
String sqlPath = null;
Object[] row;
final int ischema_catalog = 0;
final int ischema_name = 1;
final int ischema_owner = 2;
final int idef_charset_cat = 3;
final int idef_charset_schem = 4;
final int idef_charset_name = 5;
final int isql_path = 6;
// Initialization
schemas = database.schemaManager.fullSchemaNamesIterator();
// Do it.
while (schemas.hasNext()) {
row = t.getEmptyRowData();
schema = (String) schemas.next();
row[ischema_catalog] = ns.getCatalogName(schema);
row[ischema_name] = schema;
row[ischema_owner] = schemaOwner;
row[idef_charset_cat] = ns.getCatalogName(dcsSchema);
row[idef_charset_schem] = dcsSchema;
row[idef_charset_name] = dcsName;
row[isql_path] = sqlPath;
t.insertSys(row);
}
t.setDataReadOnly(true);
return t;
}
}