Oracle® TimesTen In-Memory Database Release Notes 11g Release 2 (11.2.2) E21630-12 December 2011 This document provides late-breaking information for TimesTen release 11.2.2.2.0, as well as information that is not yet part of the formal documentation. The latest version of this document is the readme.html file in your installation directory. Release notes may also be updated from time to time in the documentation library at http://www.oracle.com/technetwork/database/timesten/documentation/ To install the Oracle TimesTen In-Memory Database, run setup from the installation media pack. For installation information, see Oracle TimesTen In-Memory Database Installation Guide. This guide can be accessed from install_dir/doc/ in the installation. This document contains the following sections: ■ Changes in this release ■ Platforms and configurations ■ Software requirements ■ Deliverables ■ Advance notice ■ Known problems and limitations ■ Documentation Accessibility 1 Changes in this release This section lists changes between releases: ■ Changes for Release 11.2.2.2.0 from Release 11.2.2.1.0 ■ Changes for Release 11.2.2.1.0 from Release 11.2.1 1.1 Changes for Release 11.2.2.2.0 from Release 11.2.2.1.0 Changes in this release include: ■ New features ■ Behavior changes 1 1.1.1 New features ■ The new Automatic parallel replication allows for the parallel replication and application of transactions changes to the receiving nodes in a replication scheme. See the Oracle TimesTen In-Memory Database Replication Guide for more details. ■ The ttIsql utility now supports autovariables, showcurrenttime as a set/show attribute, the IF command, WHENEVER error handling and SQLCancel. ■ Added support for ODBC SQLCancel. 1.1.2 Behavior changes ■ Passthrough levels other than 0 are not supported with the utilities ttMigrate, ttBulkCp and ttSchema. Now an error is returned if the PassThrough connection attribute is set to a level other than 0. ■ In Release 11.2.2.1.0, we documented the requirement that unique or foreign key constraints on Oracle must have a corresponding TimesTen unique or foreign key constraint. If the constraint cannot be added to TimesTen, then Parallel AWT should not be enabled. In Release 11.2.2.2.0, TimesTen checks if there are any cached columns within an AWT table that belong to an Oracle unique index or a unique constraint that don't have a corresponding unique index on TimesTen. If any columns are found when creating a cache group, TimesTen returns a warning, at which time the user can fix this issue. If any columns are found when the replication agent is started, TimesTen returns an error and shuts down the replication agent. ■ The SQLCancel ODBC function can now perform a statement cancel on an hstmt from a different thread. In this case, the SQLCancel issues the cancel request and returns immediately. Previously, SQLCancel would block, waiting for the original SQL operation to complete. TimesTen still does not support an asynchronous cancel on an hstmt executed with the SQL_ASYNC_ENABLE flag set. ■ When the ttIsql utility receives the signal SIGINT while running an ODBC statement, ttIsql attempts to interrupt the statement using SQLCancel. Previously ttIsql needed to wait until the statement completed before ttIsql could interrupt the given command. The ttIsql utility no longer exits if it receives two SIGINT signals during an ODBC call. ■ Some mixes of DML and DDL statements in the same transaction while using DDLCommitBehavior=1 are no longer allowed. For example, transactions that update rows in a table and then create an index on that same table, or that update rows in a table and then resize that table's hash index with an ALTER TABLE ... PAGES = n now return an error. The error can be prevented if you do not mix DML and DDL statements in the same transaction. 1.2 Changes for Release 11.2.2.1.0 from Release 11.2.1 Changes in this release include: ■ New features ■ Behavior changes ■ Bug Fixes 2 1.2.1 New features ■ In-memory columnar compression of tables. ■ Large objects (LOBs), including CLOBs (character LOBs), NCLOBs (national character LOBs), and BLOBs (binary LOBs). ■ Associative arrays, formerly known as index-by tables or PL/SQL tables, are supported as bind parameters in TimesTen PL/SQL, such as from an OCI, Pro*C, or JDBC application. ■ TimesTen now supports some wide-character ("W") versions of ODBC functions. For example, SQLGetConnectOptionW is supported in addition to SQLGetConnectOption. See the Oracle TimesTen In-Memory Database C Developer's Guide for more details. ■ PL/SQL anonymous blocks and procedure or function calls, in addition to SQL statements, are supported in an EXECUTE IMMEDIATE statement or DBMS_SQL procedure or function call. ■ A global query (a query executed on multiple members of an Oracle In-Memory Database Cache grid) can reference more than one table. ■ The ability to determine the current space usage of a table using the ttComputeTabSizes built-in procedure. ■ The maximum number of indexes per table has increased to 500. The previous maximum was 32. ■ You can configure parallel propagation of changes in AWT cache tables to the corresponding Oracle tables. ■ The maximum value of the LogBufMB and LogFileSize connection attributes has increased to 64GB on 64-bit systems. ■ You have additional control over TimesTen application failover behavior when Oracle Clusterware is managing a TimesTen active standby pair. The AppFailureInterval, AppRestartAttempts and AppUptimeThreshold Clusterware attributes are new. See the Oracle TimesTen In-Memory Database Replication Guide for more information. 1.2.1.1 Additional SQL functionality for analytics workloads and complex queries See Oracle TimesTen In-Memory Database SQL Reference for more information. ■ Analytic functions and clauses: - Analytic functions: AVG, SUM, COUNT, MAX, MIN, DENSE_RANK, RANK, ROW_NUMBER, FIRST_VALUE and LAST_VALUE - Analytic clauses: OVER PARTITION BY and OVER ORDER BY ■ Multidimensional grouping operators: - Grouping clauses: GROUP BY CUBE, GROUP BY ROLLUP, GROUP BY GROUPING SETS - Grouping functions: GROUP, GROUPING_ID, GROUP_ID ■ WITH clause, which allows repeated references to a named subquery block ■ Aggregate expressions over DISTINCT expressions ■ General expressions that return a character string in the source or a pattern within the LIKE predicate 3 ■ Ability to order nulls first or last in a sort result (NULLS FIRST or NULLS LAST in the ORDER BY clause) 1.2.1.2 Implicit data type conversion See Oracle TimesTen In-Memory Database SQL Reference for more information. ■ TimesTen implicitly converts data types in many cases. For example: SELECT 1 + '1' FROM dual; 1.2.1.3 Support for arithmetic operations on date and time values See Oracle TimesTen In-Memory Database SQL Reference for more information. ■ TimesTen allows arithmetic operations on date and timestamp expressions. For example: SELECT SYSDATE + 1 FROM dual; 1.2.1.4 New SQL scalar functions See Oracle TimesTen In-Memory Database SQL Reference for more information. ■ LOBs: EMPTY_CLOB, EMPTY_BLOB, TO_BLOB, TO_CLOB, TO_LOB, TO_NCLOB ■ National Language Support (NLS) properties: NLS_CHARSET_ID and NLS_CHARSET_NAME ■ Cache grid properties: TTGRIDMEMBERID, TTGRIDNODENAME, TTGRIDUSERASSIGNEDNAME ■ Timestamp arithmetic: TIMESTAMPADD and TIMESTAMPDIFF ■ Other SQL scalar functions: SOUNDEX, REPLACE, MONTHS_BETWEEN, NULLIF 1.2.1.5 New system views See Oracle TimesTen In-Memory Database System Tables and Views Reference for more information. ■ SYS.ALL_TABLES, SYS.DBA_TABLES, SYS.USER_TABLES ■ SYS.ALL_VIEWS, SYS.DBA_VIEWS, SYS.USER_VIEWS ■ SYS.ALL_TAB_SIZES, SYS.DBA_TAB_SIZES, SYS.USER_TAB_SIZES 1.2.1.6 New built-in procedures See Oracle TimesTen In-Memory Database Reference for more information. ■ ttComputeTabSizes computes the current size of a table. 1.2.1.7 Utility enhancements See Oracle TimesTen In-Memory Database Reference for more information. ■ ttStatus has a new option for displaying the status of a single database. ■ ttIsql has new commands to support LOBs, table compression, table size reporting and PL/SQL associative binds. ■ ttsize has been enhanced to report more information. ■ ttVersion has a new option to generate information only about a specified attribute. 4 1.2.2 Behavior changes ■ PreparedStatement.setBoolean(int parameter, false) sets the column to 0 regardless of the data type. In previous releases, PreparedStatement.setBoolean(int parameter, false) set CHAR, VARCHAR, NCHAR, and NVARCHAR columns to null. ■ When DURABLE COMMITS ON is specified as part of the return services STORE clause for a replication scheme, durable commits are issued when return service blocking is disabled regardless of whether the replication agent is running or stopped. They are also issued for an active standby pair in which the ttRepStateSave built-in procedure has marked the standby database as failed. ■ When creating a cache group, a WHERE clause must be placed on an individual table. In previous releases, the WHERE clause could reference any table within the cache group. In the current release, it can only reference a specific table. ■ The default setting for the DDLReplicationLevel general connection attribute has changed from 1 to 2. See Oracle TimesTen In-Memory Database Reference for more details. ■ The default value for the CacheAWTMethod first connection attribute is changed. 1 (PL/SQL method) is the default now. ■ In this release, WITH is a reserved word. ■ The Connections attribute is changed in this release. The default value is the lesser of 2000 or the number of semaphores specified in the SEMMSL kernel parameter. The value of this attribute specifies only the number of user connections. Previously, the value needed to include the user connections and the connections by the subdaemon, replication agent, etc. In previous releases, TimesTen returned a warning if the number of connections exceeded the value of the Connections attribute. In this release, TimesTen returns an error and the connection fails. See the Oracle TimesTen In-Memory Database Reference for more details. ■ The prefix of daemon log messages for IMDB Cache has changed from ORA to CAC. ■ Hex literals with odd lengths are now prefixed with 0.