RELEASE-NOTES.html 63 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950
  1. <html lang="en">
  2. <title>Release Notes for Apache Derby 10.11.1.1</title>
  3. <body>
  4. <h1>
  5. <a name="Release Notes for Apache Derby 10.11.1.1"></a>Release Notes for Apache Derby 10.11.1.1</h1>
  6. <div>
  7. <p>These notes describe the difference between Apache Derby release 10.11.1.1 and the preceding release 10.10.2.0.</p>
  8. </div>
  9. <ul>
  10. <li>
  11. <a href="#Overview">Overview</a>
  12. </li>
  13. <li>
  14. <a href="#New Features">New Features</a>
  15. </li>
  16. <li>
  17. <a href="#Bug Fixes">Bug Fixes</a>
  18. </li>
  19. <li>
  20. <a href="#Issues">Issues</a>
  21. </li>
  22. <li>
  23. <a href="#Build Environment">Build Environment</a>
  24. </li>
  25. <li>
  26. <a href="#Verifying Releases">Verifying Releases</a>
  27. </li>
  28. </ul>
  29. <h2>
  30. <a name="Overview"></a>Overview</h2>
  31. <div>
  32. <p>
  33. The most up to date information about Derby releases can be found on the
  34. <a href="http://db.apache.org/derby/derby_downloads.html">Derby download page</a>.
  35. </p>
  36. <p>
  37. Apache Derby is a pure Java relational database engine using standard SQL and
  38. JDBC as its APIs. More information about Derby can be found on the
  39. <a href="http://db.apache.org/derby/">Apache web site</a>.
  40. Derby functionality includes:
  41. </p>
  42. <ul>
  43. <li>Embedded engine with JDBC drivers</li>
  44. <li>Network Server</li>
  45. <li>Network client JDBC drivers</li>
  46. <li>Command line tools: ij (SQL scripting), dblook (schema dump) and sysinfo (system info)</li>
  47. </ul>
  48. <p>
  49. Java and JDBC versions supported:
  50. </p>
  51. <ul>
  52. <li>Java SE 6 and higher with JDBC 4.0, 4.1, and 4.2.</li>
  53. <li>Java SE 8 compact profile 2.</li>
  54. </ul>
  55. </div>
  56. <h2>
  57. <a name="New Features"></a>New Features</h2>
  58. <div>
  59. <p>
  60. This is a feature release. The following new features were added:
  61. </p>
  62. <ul>
  63. <li>
  64. <b>MERGE statement</b> - MERGE is a single, join-driven statement which INSERTs, UPDATEs, and DELETEs rows. See the section on this statement in the Derby Reference Manual. See also features F312, F313, and F314 of the SQL Standard.</li>
  65. <li>
  66. <b>Deferrable constraints</b> - Constraint enforcement can now be deferred, typically to the end of a transaction. See the section on "constraintCharacteristics" in the Derby Reference Manual. See also features F721 and F492 of the SQL Standard.</li>
  67. <li>
  68. <b>WHEN clause in CREATE TRIGGER</b> - An optional WHEN clause has been added which determines which rows fire a trigger. See the section on this clause in the Derby Reference Manual. See also feature T211-05 of the SQL Standard.</li>
  69. <li>
  70. <b>Rolling log file</b> - The Derby diagnostic log can now be split across a sequence of files. See the section on the derby.stream.error.style property in the Derby Reference Manual.</li>
  71. <li>
  72. <b>Experimental Lucene support</b> - Derby text columns can now be indexed and queried via Apache Lucene. See the section on the optional luceneSupport tool in the Derby Tools and Utilities Guide.</li>
  73. <li>
  74. <b>Simple case expression</b> - The "simple" and "extended" syntax for CASE expressions has been added. See the section on the CASE expression in the Derby Reference Manual. See also features F261-01, F262, and F263 of the SQL Standard.</li>
  75. <li>
  76. <b>Better concurrency for identity columns</b> - The concurrency of identity columns has been boosted. See the detailed release note for DERBY-6542 below.</li>
  77. <li>
  78. <b>New ij HoldForConnection command</b> - A new ij command has been added to change the default cursor holdability to "keep cursors open after commit." See the section on the HoldForConnection command in the Derby Tools and Utilities Guide.</li>
  79. <li>
  80. <b>Standard syntax for altering column nullability</b> - Standard syntax has been added for altering the nullability of columns. See the section on ALTER TABLE in the Derby Reference Manual. See also feature F383 of the SQL Standard.</li>
  81. </ul>
  82. </div>
  83. <h2>
  84. <a name="Bug Fixes"></a>Bug Fixes</h2>
  85. <div>
  86. <p>The following issues are addressed by Derby release 10.11.1.1. These issues are not addressed in the preceding 10.10.2.0 release.</p>
  87. <table border="2">
  88. <tr>
  89. <th>
  90. <div style="width:110px;">Issue Id</div>
  91. </th><th>Description</th>
  92. </tr>
  93. <tr>
  94. <td><a href="https://issues.apache.org/jira/browse/DERBY-6693">DERBY-6693</a></td><td>Assert failure/ArrayIndexOutOfBoundsException when using COUNT in MERGE matching clause</td>
  95. </tr>
  96. <tr>
  97. <td><a href="https://issues.apache.org/jira/browse/DERBY-6692">DERBY-6692</a></td><td>Self-deadlock when inserting row with identity column in soft-upgraded database</td>
  98. </tr>
  99. <tr>
  100. <td><a href="https://issues.apache.org/jira/browse/DERBY-6691">DERBY-6691</a></td><td>ROW_NUMBER should not be allowed as argument in a procedure call</td>
  101. </tr>
  102. <tr>
  103. <td><a href="https://issues.apache.org/jira/browse/DERBY-6690">DERBY-6690</a></td><td>ROW_NUMBER should not be allowed in generation clause</td>
  104. </tr>
  105. <tr>
  106. <td><a href="https://issues.apache.org/jira/browse/DERBY-6689">DERBY-6689</a></td><td>Assert failure/NPE when using ROW_NUMBER in MERGE ... INSERT</td>
  107. </tr>
  108. <tr>
  109. <td><a href="https://issues.apache.org/jira/browse/DERBY-6688">DERBY-6688</a></td><td>NPE (or sane: ASSERT failure) with ROW_NUMBER in some subqueries</td>
  110. </tr>
  111. <tr>
  112. <td><a href="https://issues.apache.org/jira/browse/DERBY-6677">DERBY-6677</a></td><td>Correct Reference Manual RENAME TABLE topic to remove foreign key prohibition</td>
  113. </tr>
  114. <tr>
  115. <td><a href="https://issues.apache.org/jira/browse/DERBY-6674">DERBY-6674</a></td><td>Cleanup brittle code in ValidateCheckConstraintResultSet</td>
  116. </tr>
  117. <tr>
  118. <td><a href="https://issues.apache.org/jira/browse/DERBY-6672">DERBY-6672</a></td><td>Allow Derby to rename tables referenced by foreign keys</td>
  119. </tr>
  120. <tr>
  121. <td><a href="https://issues.apache.org/jira/browse/DERBY-6670">DERBY-6670</a></td><td>Rollback to savepoint allows violation of deferrable constraints</td>
  122. </tr>
  123. <tr>
  124. <td><a href="https://issues.apache.org/jira/browse/DERBY-6668">DERBY-6668</a></td><td>Truncating a table may silently violate a deferred foreign key.</td>
  125. </tr>
  126. <tr>
  127. <td><a href="https://issues.apache.org/jira/browse/DERBY-6667">DERBY-6667</a></td><td>Redundant word "referencing" in error message for deferred constraints.</td>
  128. </tr>
  129. <tr>
  130. <td><a href="https://issues.apache.org/jira/browse/DERBY-6666">DERBY-6666</a></td><td>Deferred constraint validation fails with "dead statement" when query plan logging is enabled</td>
  131. </tr>
  132. <tr>
  133. <td><a href="https://issues.apache.org/jira/browse/DERBY-6665">DERBY-6665</a></td><td>Violation of deferred constraints not detected when conglomerates are erroneously shared</td>
  134. </tr>
  135. <tr>
  136. <td><a href="https://issues.apache.org/jira/browse/DERBY-6664">DERBY-6664</a></td><td>Schema 'null' does not exist when trigger inserts into table with deferred foreign key</td>
  137. </tr>
  138. <tr>
  139. <td><a href="https://issues.apache.org/jira/browse/DERBY-6663">DERBY-6663</a></td><td>NPE when a trigger tries to insert into a table with a foreign key</td>
  140. </tr>
  141. <tr>
  142. <td><a href="https://issues.apache.org/jira/browse/DERBY-6661">DERBY-6661</a></td><td>dblook does not recognize the deferrability of deferrable constraints</td>
  143. </tr>
  144. <tr>
  145. <td><a href="https://issues.apache.org/jira/browse/DERBY-6659">DERBY-6659</a></td><td>The Reference Guide should state how long a SET CONSTRAINTS command is good for</td>
  146. </tr>
  147. <tr>
  148. <td><a href="https://issues.apache.org/jira/browse/DERBY-6658">DERBY-6658</a></td><td>Update list of tested Lucene versions</td>
  149. </tr>
  150. <tr>
  151. <td><a href="https://issues.apache.org/jira/browse/DERBY-6657">DERBY-6657</a></td><td>Need to document the fact that views can't be the source data sets of MERGE statements</td>
  152. </tr>
  153. <tr>
  154. <td><a href="https://issues.apache.org/jira/browse/DERBY-6653">DERBY-6653</a></td><td>Data type limitations on indexes should be in Reference Manual</td>
  155. </tr>
  156. <tr>
  157. <td><a href="https://issues.apache.org/jira/browse/DERBY-6649">DERBY-6649</a></td><td>Meaningless permissions granted to sysinfo.</td>
  158. </tr>
  159. <tr>
  160. <td><a href="https://issues.apache.org/jira/browse/DERBY-6647">DERBY-6647</a></td><td>The ij.driver property is obsolete and need not be documented</td>
  161. </tr>
  162. <tr>
  163. <td><a href="https://issues.apache.org/jira/browse/DERBY-6644">DERBY-6644</a></td><td>Support standard syntax for altering column nullability</td>
  164. </tr>
  165. <tr>
  166. <td><a href="https://issues.apache.org/jira/browse/DERBY-6643">DERBY-6643</a></td><td>ALTER TABLE columnAlteration syntax needs fixing</td>
  167. </tr>
  168. <tr>
  169. <td><a href="https://issues.apache.org/jira/browse/DERBY-6638">DERBY-6638</a></td><td>Remove unnecessary use of reflection in SignatureChecker</td>
  170. </tr>
  171. <tr>
  172. <td><a href="https://issues.apache.org/jira/browse/DERBY-6633">DERBY-6633</a></td><td>Remove DOM level 3 XPath requirement from description of XML operators</td>
  173. </tr>
  174. <tr>
  175. <td><a href="https://issues.apache.org/jira/browse/DERBY-6629">DERBY-6629</a></td><td>Restrict privileged operation in CreateXMLFile</td>
  176. </tr>
  177. <tr>
  178. <td><a href="https://issues.apache.org/jira/browse/DERBY-6626">DERBY-6626</a></td><td>Check type of user-supplied modules before creating instances</td>
  179. </tr>
  180. <tr>
  181. <td><a href="https://issues.apache.org/jira/browse/DERBY-6624">DERBY-6624</a></td><td>Use javax.xml.xpath interfaces for XPath support</td>
  182. </tr>
  183. <tr>
  184. <td><a href="https://issues.apache.org/jira/browse/DERBY-6615">DERBY-6615</a></td><td>Remove unused newInstance() method in BaseMonitor</td>
  185. </tr>
  186. <tr>
  187. <td><a href="https://issues.apache.org/jira/browse/DERBY-6611">DERBY-6611</a></td><td>Broken link in API docs to derby.drda.keepAlive documentation</td>
  188. </tr>
  189. <tr>
  190. <td><a href="https://issues.apache.org/jira/browse/DERBY-6609">DERBY-6609</a></td><td>Documentation for SQL features should reflect current standard</td>
  191. </tr>
  192. <tr>
  193. <td><a href="https://issues.apache.org/jira/browse/DERBY-6605">DERBY-6605</a></td><td>"Derby support for SQL-92 features" topic in Reference Manual needs updating</td>
  194. </tr>
  195. <tr>
  196. <td><a href="https://issues.apache.org/jira/browse/DERBY-6602">DERBY-6602</a></td><td>LuceneQueryVTI handles NULL key values inconsistently</td>
  197. </tr>
  198. <tr>
  199. <td><a href="https://issues.apache.org/jira/browse/DERBY-6601">DERBY-6601</a></td><td>Clean up Java EE compliance section of Reference Manual</td>
  200. </tr>
  201. <tr>
  202. <td><a href="https://issues.apache.org/jira/browse/DERBY-6599">DERBY-6599</a></td><td>Incorrect quoting of 42ZB4 message</td>
  203. </tr>
  204. <tr>
  205. <td><a href="https://issues.apache.org/jira/browse/DERBY-6598">DERBY-6598</a></td><td>Document permissions recommendations for JAR procedures</td>
  206. </tr>
  207. <tr>
  208. <td><a href="https://issues.apache.org/jira/browse/DERBY-6597">DERBY-6597</a></td><td>LUCENESUPPORT.LISTINDEXES() fails with FileNotFoundException</td>
  209. </tr>
  210. <tr>
  211. <td><a href="https://issues.apache.org/jira/browse/DERBY-6596">DERBY-6596</a></td><td>LUCENESUPPORT routines should check for NULL arguments</td>
  212. </tr>
  213. <tr>
  214. <td><a href="https://issues.apache.org/jira/browse/DERBY-6595">DERBY-6595</a></td><td>CheckToursDBTest failed while updating sequence value on disk</td>
  215. </tr>
  216. <tr>
  217. <td><a href="https://issues.apache.org/jira/browse/DERBY-6594">DERBY-6594</a></td><td>Typos in "Listing indexes" topic of the tools guide</td>
  218. </tr>
  219. <tr>
  220. <td><a href="https://issues.apache.org/jira/browse/DERBY-6591">DERBY-6591</a></td><td>Minor tweaks needed on new ij commands</td>
  221. </tr>
  222. <tr>
  223. <td><a href="https://issues.apache.org/jira/browse/DERBY-6587">DERBY-6587</a></td><td>Foreign Key constraint not matched when using UUID in a composite foreign key when using SYSCS_UTIL.SYSCS_IMPORT_TABLE</td>
  224. </tr>
  225. <tr>
  226. <td><a href="https://issues.apache.org/jira/browse/DERBY-6585">DERBY-6585</a></td><td>add HoldForConnection ij command to match NoHoldForConnection</td>
  227. </tr>
  228. <tr>
  229. <td><a href="https://issues.apache.org/jira/browse/DERBY-6581">DERBY-6581</a></td><td>Document simple case syntax</td>
  230. </tr>
  231. <tr>
  232. <td><a href="https://issues.apache.org/jira/browse/DERBY-6580">DERBY-6580</a></td><td>Document the new SYSCS_UTIL.SYSCS_PEEK_AT_IDENTITY function</td>
  233. </tr>
  234. <tr>
  235. <td><a href="https://issues.apache.org/jira/browse/DERBY-6577">DERBY-6577</a></td><td>Quantified comparison returns wrong result in CASE, COALESCE, IN and BETWEEN</td>
  236. </tr>
  237. <tr>
  238. <td><a href="https://issues.apache.org/jira/browse/DERBY-6576">DERBY-6576</a></td><td>A immediate Fk constraint blows up iff its referenced PK is deferred and we modify a duplicate key column</td>
  239. </tr>
  240. <tr>
  241. <td><a href="https://issues.apache.org/jira/browse/DERBY-6571">DERBY-6571</a></td><td>Document deferrable constraints</td>
  242. </tr>
  243. <tr>
  244. <td><a href="https://issues.apache.org/jira/browse/DERBY-6567">DERBY-6567</a></td><td>Incorrect nullability for CASE expression with parameter</td>
  245. </tr>
  246. <tr>
  247. <td><a href="https://issues.apache.org/jira/browse/DERBY-6566">DERBY-6566</a></td><td>Simplify handling of untyped nulls in CASE and NULLIF expressions</td>
  248. </tr>
  249. <tr>
  250. <td><a href="https://issues.apache.org/jira/browse/DERBY-6565">DERBY-6565</a></td><td>ROW_NUMBER function throws NullPointerException in UPDATE statement</td>
  251. </tr>
  252. <tr>
  253. <td><a href="https://issues.apache.org/jira/browse/DERBY-6564">DERBY-6564</a></td><td>Document the experimental, optional LuceneSupport tool.</td>
  254. </tr>
  255. <tr>
  256. <td><a href="https://issues.apache.org/jira/browse/DERBY-6563">DERBY-6563</a></td><td>NOT elimination for CASE expressions is broken</td>
  257. </tr>
  258. <tr>
  259. <td><a href="https://issues.apache.org/jira/browse/DERBY-6561">DERBY-6561</a></td><td>Organization topics of some manuals need updating</td>
  260. </tr>
  261. <tr>
  262. <td><a href="https://issues.apache.org/jira/browse/DERBY-6560">DERBY-6560</a></td><td>Reference manual says ELSE clause is required in CASE expressions</td>
  263. </tr>
  264. <tr>
  265. <td><a href="https://issues.apache.org/jira/browse/DERBY-6559">DERBY-6559</a></td><td>A immediate Fk constraint blows up iff its referenced PK is deferred and we delete a duplicate</td>
  266. </tr>
  267. <tr>
  268. <td><a href="https://issues.apache.org/jira/browse/DERBY-6554">DERBY-6554</a></td><td>Too much contention followed by assert failure when accessing sequence in transaction that created it</td>
  269. </tr>
  270. <tr>
  271. <td><a href="https://issues.apache.org/jira/browse/DERBY-6553">DERBY-6553</a></td><td>Sequence generator makes CREATE TRIGGER fail with internal error</td>
  272. </tr>
  273. <tr>
  274. <td><a href="https://issues.apache.org/jira/browse/DERBY-6552">DERBY-6552</a></td><td>The public api includes methods inherited from superclasses which aren't in the public api and so have no javadoc comments</td>
  275. </tr>
  276. <tr>
  277. <td><a href="https://issues.apache.org/jira/browse/DERBY-6545">DERBY-6545</a></td><td>Should not be able to add a default to an identity column</td>
  278. </tr>
  279. <tr>
  280. <td><a href="https://issues.apache.org/jira/browse/DERBY-6543">DERBY-6543</a></td><td>Syntax error when reference to transition variable has whitespace around it</td>
  281. </tr>
  282. <tr>
  283. <td><a href="https://issues.apache.org/jira/browse/DERBY-6542">DERBY-6542</a></td><td>Improve the concurrency of identity columns by using SYS.SYSSEQUENCES</td>
  284. </tr>
  285. <tr>
  286. <td><a href="https://issues.apache.org/jira/browse/DERBY-6540">DERBY-6540</a></td><td>Schema-qualified table names could be mistaken for transition tables</td>
  287. </tr>
  288. <tr>
  289. <td><a href="https://issues.apache.org/jira/browse/DERBY-6537">DERBY-6537</a></td><td>StringUtil.fromHexString is used to convert encryptionKey to byte[]</td>
  290. </tr>
  291. <tr>
  292. <td><a href="https://issues.apache.org/jira/browse/DERBY-6535">DERBY-6535</a></td><td>Remove storageFactory field from subclasses of InputStreamFile</td>
  293. </tr>
  294. <tr>
  295. <td><a href="https://issues.apache.org/jira/browse/DERBY-6534">DERBY-6534</a></td><td>Remove StorageFile.getURL() and its implementations</td>
  296. </tr>
  297. <tr>
  298. <td><a href="https://issues.apache.org/jira/browse/DERBY-6527">DERBY-6527</a></td><td>Fix errors in foreign keys documentation</td>
  299. </tr>
  300. <tr>
  301. <td><a href="https://issues.apache.org/jira/browse/DERBY-6526">DERBY-6526</a></td><td>Document the MERGE statement</td>
  302. </tr>
  303. <tr>
  304. <td><a href="https://issues.apache.org/jira/browse/DERBY-6505">DERBY-6505</a></td><td>Clean up dead code in FileUtil</td>
  305. </tr>
  306. <tr>
  307. <td><a href="https://issues.apache.org/jira/browse/DERBY-6504">DERBY-6504</a></td><td>change AllocPage.ReadContainerInfo to catch ArrayIndexOutOfBoundsException and turn it into Derby error.</td>
  308. </tr>
  309. <tr>
  310. <td><a href="https://issues.apache.org/jira/browse/DERBY-6503">DERBY-6503</a></td><td>Starting network server on a network drive fails with JDK 7 on Windows</td>
  311. </tr>
  312. <tr>
  313. <td><a href="https://issues.apache.org/jira/browse/DERBY-6496">DERBY-6496</a></td><td>Optional tool registration may fail because the CompilerContext is not always available at execution time.</td>
  314. </tr>
  315. <tr>
  316. <td><a href="https://issues.apache.org/jira/browse/DERBY-6493">DERBY-6493</a></td><td>Improve reporting of exceptions wrapped in InvocationTargetException</td>
  317. </tr>
  318. <tr>
  319. <td><a href="https://issues.apache.org/jira/browse/DERBY-6488">DERBY-6488</a></td><td>Get rid of the EmbedSQLException class</td>
  320. </tr>
  321. <tr>
  322. <td><a href="https://issues.apache.org/jira/browse/DERBY-6484">DERBY-6484</a></td><td>Include SQLState in client exception messages</td>
  323. </tr>
  324. <tr>
  325. <td><a href="https://issues.apache.org/jira/browse/DERBY-6480">DERBY-6480</a></td><td>Oracle Java documentation URLs need updating</td>
  326. </tr>
  327. <tr>
  328. <td><a href="https://issues.apache.org/jira/browse/DERBY-6478">DERBY-6478</a></td><td>Fix language about supported DataSources for Compact Profiles</td>
  329. </tr>
  330. <tr>
  331. <td><a href="https://issues.apache.org/jira/browse/DERBY-6469">DERBY-6469</a></td><td>Change the documentation to reflect new RDBNAM limit of 1024 bytes</td>
  332. </tr>
  333. <tr>
  334. <td><a href="https://issues.apache.org/jira/browse/DERBY-6467">DERBY-6467</a></td><td>Document context-aware table functions.</td>
  335. </tr>
  336. <tr>
  337. <td><a href="https://issues.apache.org/jira/browse/DERBY-6464">DERBY-6464</a></td><td>Improve the encapsulation of various compiler classes</td>
  338. </tr>
  339. <tr>
  340. <td><a href="https://issues.apache.org/jira/browse/DERBY-6462">DERBY-6462</a></td><td>Provide more information about database name and path syntax</td>
  341. </tr>
  342. <tr>
  343. <td><a href="https://issues.apache.org/jira/browse/DERBY-6459">DERBY-6459</a></td><td>Remove Class.forName calls that load JDBC driver from Derby samples/demos</td>
  344. </tr>
  345. <tr>
  346. <td><a href="https://issues.apache.org/jira/browse/DERBY-6458">DERBY-6458</a></td><td>The Reference Manual should state that the year, month, and day components of a timestamp must be positive integers.</td>
  347. </tr>
  348. <tr>
  349. <td><a href="https://issues.apache.org/jira/browse/DERBY-6454">DERBY-6454</a></td><td>DROP TABLE documentation could clarify how triggers are handled</td>
  350. </tr>
  351. <tr>
  352. <td><a href="https://issues.apache.org/jira/browse/DERBY-6453">DERBY-6453</a></td><td>Remove dead code in InsertResultSet and flag skipCheckConstraints</td>
  353. </tr>
  354. <tr>
  355. <td><a href="https://issues.apache.org/jira/browse/DERBY-6447">DERBY-6447</a></td><td>Use StrictMath for more functions in SYSFUN</td>
  356. </tr>
  357. <tr>
  358. <td><a href="https://issues.apache.org/jira/browse/DERBY-6440">DERBY-6440</a></td><td>Connections opened by ForeignTableVTI never get released</td>
  359. </tr>
  360. <tr>
  361. <td><a href="https://issues.apache.org/jira/browse/DERBY-6434">DERBY-6434</a></td><td>Incorrect privileges may be required for INSERT and DELETE statements.</td>
  362. </tr>
  363. <tr>
  364. <td><a href="https://issues.apache.org/jira/browse/DERBY-6432">DERBY-6432</a></td><td>INSERT/UPDATE incorrectly require user to have privilege to execute CHECK constraints on the target table.</td>
  365. </tr>
  366. <tr>
  367. <td><a href="https://issues.apache.org/jira/browse/DERBY-6431">DERBY-6431</a></td><td>Update Developer's Guide topic to include generated columns</td>
  368. </tr>
  369. <tr>
  370. <td><a href="https://issues.apache.org/jira/browse/DERBY-6429">DERBY-6429</a></td><td>Privilege checks for UPDATE statements are wrong.</td>
  371. </tr>
  372. <tr>
  373. <td><a href="https://issues.apache.org/jira/browse/DERBY-6424">DERBY-6424</a></td><td>Document thenExpression</td>
  374. </tr>
  375. <tr>
  376. <td><a href="https://issues.apache.org/jira/browse/DERBY-6423">DERBY-6423</a></td><td>The expression syntax in CASE's THEN clause doesn't accept boolean value expression</td>
  377. </tr>
  378. <tr>
  379. <td><a href="https://issues.apache.org/jira/browse/DERBY-6421">DERBY-6421</a></td><td>Cast to UDT in CHECK constraint causes NPE or assert failure</td>
  380. </tr>
  381. <tr>
  382. <td><a href="https://issues.apache.org/jira/browse/DERBY-6420">DERBY-6420</a></td><td>Clarify how DROP statements work on trigger dependencies</td>
  383. </tr>
  384. <tr>
  385. <td><a href="https://issues.apache.org/jira/browse/DERBY-6419">DERBY-6419</a></td><td>Make BTree scan honor OPENMODE_LOCK_NOWAIT for row locks.</td>
  386. </tr>
  387. <tr>
  388. <td><a href="https://issues.apache.org/jira/browse/DERBY-6410">DERBY-6410</a></td><td>ClassCastException when launching derby from windows subst drive</td>
  389. </tr>
  390. <tr>
  391. <td><a href="https://issues.apache.org/jira/browse/DERBY-6390">DERBY-6390</a></td><td>Document the WHEN clause in the CREATE TRIGGER statement</td>
  392. </tr>
  393. <tr>
  394. <td><a href="https://issues.apache.org/jira/browse/DERBY-6386">DERBY-6386</a></td><td>Errors in jdbc4.LobStreamTest if derbyclient.jar is first in the classpath</td>
  395. </tr>
  396. <tr>
  397. <td><a href="https://issues.apache.org/jira/browse/DERBY-6379">DERBY-6379</a></td><td>Manuals are inconsistent in their use of the &lt;shortdesc&gt; element</td>
  398. </tr>
  399. <tr>
  400. <td><a href="https://issues.apache.org/jira/browse/DERBY-6378">DERBY-6378</a></td><td>OFFSET/FETCH NEXT ignored when query is enclosed in parentheses</td>
  401. </tr>
  402. <tr>
  403. <td><a href="https://issues.apache.org/jira/browse/DERBY-6370">DERBY-6370</a></td><td>dblook doesn't schema-qualify identifiers in trigger actions</td>
  404. </tr>
  405. <tr>
  406. <td><a href="https://issues.apache.org/jira/browse/DERBY-6362">DERBY-6362</a></td><td>CHECK constraint uses wrong schema for unqualified routine invocations</td>
  407. </tr>
  408. <tr>
  409. <td><a href="https://issues.apache.org/jira/browse/DERBY-6359">DERBY-6359</a></td><td>Document rolling derby.log file feature</td>
  410. </tr>
  411. <tr>
  412. <td><a href="https://issues.apache.org/jira/browse/DERBY-6350">DERBY-6350</a></td><td>Provide a rolling file implementation of derby.log</td>
  413. </tr>
  414. <tr>
  415. <td><a href="https://issues.apache.org/jira/browse/DERBY-6330">DERBY-6330</a></td><td>Simplify StringBuffer use, as they are mutable</td>
  416. </tr>
  417. <tr>
  418. <td><a href="https://issues.apache.org/jira/browse/DERBY-6322">DERBY-6322</a></td><td>Remove erreoneous warning in NetBeans: superfluous use of super to access inherited member variable</td>
  419. </tr>
  420. <tr>
  421. <td><a href="https://issues.apache.org/jira/browse/DERBY-6321">DERBY-6321</a></td><td>NetBeans project file: add XML api to source classpath</td>
  422. </tr>
  423. <tr>
  424. <td><a href="https://issues.apache.org/jira/browse/DERBY-6318">DERBY-6318</a></td><td>Simplify setting of possibly null parameters in XPLAIN descriptors</td>
  425. </tr>
  426. <tr>
  427. <td><a href="https://issues.apache.org/jira/browse/DERBY-6315">DERBY-6315</a></td><td>Improve test coverage of org.apache.derby.impl.io.InputStreamFile</td>
  428. </tr>
  429. <tr>
  430. <td><a href="https://issues.apache.org/jira/browse/DERBY-6304">DERBY-6304</a></td><td>Remove unused methods in Predicate</td>
  431. </tr>
  432. <tr>
  433. <td><a href="https://issues.apache.org/jira/browse/DERBY-6296">DERBY-6296</a></td><td>Simplify PropertyUtil using Properties.stringPropertyNames()</td>
  434. </tr>
  435. <tr>
  436. <td><a href="https://issues.apache.org/jira/browse/DERBY-6292">DERBY-6292</a></td><td>Use Arrays.copyOf() in FormatableArrayHolder.getArray()</td>
  437. </tr>
  438. <tr>
  439. <td><a href="https://issues.apache.org/jira/browse/DERBY-6291">DERBY-6291</a></td><td>Improve code coverage of org.apache.derby.iapi.jdbc.BrokeredCallableStatement</td>
  440. </tr>
  441. <tr>
  442. <td><a href="https://issues.apache.org/jira/browse/DERBY-6287">DERBY-6287</a></td><td>Don't use reflection to call Java 6 methods in FileUtil</td>
  443. </tr>
  444. <tr>
  445. <td><a href="https://issues.apache.org/jira/browse/DERBY-6285">DERBY-6285</a></td><td>Use factory method to create thread pool for timed login</td>
  446. </tr>
  447. <tr>
  448. <td><a href="https://issues.apache.org/jira/browse/DERBY-6284">DERBY-6284</a></td><td>Improve test coverage of org.apache.derby.iapi.db.ConnectionInfo</td>
  449. </tr>
  450. <tr>
  451. <td><a href="https://issues.apache.org/jira/browse/DERBY-6276">DERBY-6276</a></td><td>Convert lang/DB2IsolationLevels.sql to JUnit</td>
  452. </tr>
  453. <tr>
  454. <td><a href="https://issues.apache.org/jira/browse/DERBY-6266">DERBY-6266</a></td><td>Add ability to print a Derby execution ResultSet as xml.</td>
  455. </tr>
  456. <tr>
  457. <td><a href="https://issues.apache.org/jira/browse/DERBY-6262">DERBY-6262</a></td><td>Simplify message-generating methods using varargs</td>
  458. </tr>
  459. <tr>
  460. <td><a href="https://issues.apache.org/jira/browse/DERBY-6259">DERBY-6259</a></td><td>Collapse the level 2 optimizer into its parent module.</td>
  461. </tr>
  462. <tr>
  463. <td><a href="https://issues.apache.org/jira/browse/DERBY-6254">DERBY-6254</a></td><td>Reduce number of factory methods in StandardException</td>
  464. </tr>
  465. <tr>
  466. <td><a href="https://issues.apache.org/jira/browse/DERBY-6253">DERBY-6253</a></td><td>Collapse SQLException factories</td>
  467. </tr>
  468. <tr>
  469. <td><a href="https://issues.apache.org/jira/browse/DERBY-6248">DERBY-6248</a></td><td>nightly regression test failure: testDerby966(org.apache.derbyTesting.functionTests.tests.jdbcapi.XATest)java.sql.SQLFeatureNotSupportedException: The DDM object 0x2408 is not supported. The connection has been terminated.</td>
  470. </tr>
  471. <tr>
  472. <td><a href="https://issues.apache.org/jira/browse/DERBY-6243">DERBY-6243</a></td><td>Fold Java5ClassFactory into ReflectClassesJava2</td>
  473. </tr>
  474. <tr>
  475. <td><a href="https://issues.apache.org/jira/browse/DERBY-6242">DERBY-6242</a></td><td>Merge ConcurrentXactFactory into XactFactory</td>
  476. </tr>
  477. <tr>
  478. <td><a href="https://issues.apache.org/jira/browse/DERBY-6241">DERBY-6241</a></td><td>Remove SinglePool from trunk</td>
  479. </tr>
  480. <tr>
  481. <td><a href="https://issues.apache.org/jira/browse/DERBY-6240">DERBY-6240</a></td><td>Remove Clock cache manager from trunk</td>
  482. </tr>
  483. <tr>
  484. <td><a href="https://issues.apache.org/jira/browse/DERBY-6236">DERBY-6236</a></td><td>Remove references to old JVMs (pre-Java 6) from the user guides</td>
  485. </tr>
  486. <tr>
  487. <td><a href="https://issues.apache.org/jira/browse/DERBY-6234">DERBY-6234</a></td><td>Remove references to BUILTIN authentication from the user guides</td>
  488. </tr>
  489. <tr>
  490. <td><a href="https://issues.apache.org/jira/browse/DERBY-6231">DERBY-6231</a></td><td>Remove unnecessary checks for UnsupportedEncodingException in the client</td>
  491. </tr>
  492. <tr>
  493. <td><a href="https://issues.apache.org/jira/browse/DERBY-6230">DERBY-6230</a></td><td>Use the JVM's cache of Number instances in ReuseFactory</td>
  494. </tr>
  495. <tr>
  496. <td><a href="https://issues.apache.org/jira/browse/DERBY-6227">DERBY-6227</a></td><td>Distinct aggregates don't work well with territory-based collation</td>
  497. </tr>
  498. <tr>
  499. <td><a href="https://issues.apache.org/jira/browse/DERBY-6217">DERBY-6217</a></td><td>Put all of the security documentation in a single, separate user guide</td>
  500. </tr>
  501. <tr>
  502. <td><a href="https://issues.apache.org/jira/browse/DERBY-6213">DERBY-6213</a></td><td>Deprecate support for Java 5 and CDC</td>
  503. </tr>
  504. <tr>
  505. <td><a href="https://issues.apache.org/jira/browse/DERBY-6207">DERBY-6207</a></td><td>Update policy files in java/drda/org/apache/derby/drda</td>
  506. </tr>
  507. <tr>
  508. <td><a href="https://issues.apache.org/jira/browse/DERBY-6206">DERBY-6206</a></td><td>Cleanup suspect coding practices in misc Derby packages</td>
  509. </tr>
  510. <tr>
  511. <td><a href="https://issues.apache.org/jira/browse/DERBY-6202">DERBY-6202</a></td><td>Cleanup suspect coding practices in the org.apache.derby.iapi.sql.dictionary package</td>
  512. </tr>
  513. <tr>
  514. <td><a href="https://issues.apache.org/jira/browse/DERBY-6201">DERBY-6201</a></td><td>Cleanup suspect coding practices in the org.apache.derby.impl.sql.execute.rts package</td>
  515. </tr>
  516. <tr>
  517. <td><a href="https://issues.apache.org/jira/browse/DERBY-6200">DERBY-6200</a></td><td>Cleanup suspect coding practices in the org.apache.derby.iapi.types package</td>
  518. </tr>
  519. <tr>
  520. <td><a href="https://issues.apache.org/jira/browse/DERBY-6199">DERBY-6199</a></td><td>Cleanup suspect coding practices in the org.apache.derby.vti package</td>
  521. </tr>
  522. <tr>
  523. <td><a href="https://issues.apache.org/jira/browse/DERBY-6198">DERBY-6198</a></td><td>Cleanup suspect coding practices in the org.apache.derby.tools package</td>
  524. </tr>
  525. <tr>
  526. <td><a href="https://issues.apache.org/jira/browse/DERBY-6197">DERBY-6197</a></td><td>Cleanup suspect coding practices in the org.apache.derby.impl.tools.planexporter package</td>
  527. </tr>
  528. <tr>
  529. <td><a href="https://issues.apache.org/jira/browse/DERBY-6195">DERBY-6195</a></td><td>Cleanup suspect coding practices in the org.apache.derby.impl.tools.ij package.</td>
  530. </tr>
  531. <tr>
  532. <td><a href="https://issues.apache.org/jira/browse/DERBY-6192">DERBY-6192</a></td><td>Cleanup suspect coding practices in org.apache.derby.iapi.services.property package</td>
  533. </tr>
  534. <tr>
  535. <td><a href="https://issues.apache.org/jira/browse/DERBY-6188">DERBY-6188</a></td><td>Cleanup suspect coding practices in org.apache.derby.iapi.services.io package</td>
  536. </tr>
  537. <tr>
  538. <td><a href="https://issues.apache.org/jira/browse/DERBY-6186">DERBY-6186</a></td><td>SYSTRIGGERSRowFactory should use DataDescriptorGenerator to build descriptor</td>
  539. </tr>
  540. <tr>
  541. <td><a href="https://issues.apache.org/jira/browse/DERBY-6184">DERBY-6184</a></td><td>Clean up warnings in XA transaction id classes</td>
  542. </tr>
  543. <tr>
  544. <td><a href="https://issues.apache.org/jira/browse/DERBY-6182">DERBY-6182</a></td><td>Cleanup suspect coding practices in org.apache.derby.iapi.error package</td>
  545. </tr>
  546. <tr>
  547. <td><a href="https://issues.apache.org/jira/browse/DERBY-6177">DERBY-6177</a></td><td>Cleanup suspect coding practices in org.apache.derby.catalog.types</td>
  548. </tr>
  549. <tr>
  550. <td><a href="https://issues.apache.org/jira/browse/DERBY-6169">DERBY-6169</a></td><td>Reduce visibility of classes and methods under impl/sql</td>
  551. </tr>
  552. <tr>
  553. <td><a href="https://issues.apache.org/jira/browse/DERBY-6168">DERBY-6168</a></td><td>Clean up registered format ids</td>
  554. </tr>
  555. <tr>
  556. <td><a href="https://issues.apache.org/jira/browse/DERBY-6163">DERBY-6163</a></td><td>Reduce visibility of methods in subclasses of PageBasicOperation</td>
  557. </tr>
  558. <tr>
  559. <td><a href="https://issues.apache.org/jira/browse/DERBY-6161">DERBY-6161</a></td><td>Simplify code that handles LOB files</td>
  560. </tr>
  561. <tr>
  562. <td><a href="https://issues.apache.org/jira/browse/DERBY-6138">DERBY-6138</a></td><td>org.apache.derbyTesting.functionTests.tests.store.ClassLoaderBootTest fails with sealing violation: package org.apache.derby.iapi.services.sanity is sealed depending on classpath order</td>
  563. </tr>
  564. <tr>
  565. <td><a href="https://issues.apache.org/jira/browse/DERBY-6133">DERBY-6133</a></td><td>simple array index typo</td>
  566. </tr>
  567. <tr>
  568. <td><a href="https://issues.apache.org/jira/browse/DERBY-6128">DERBY-6128</a></td><td>Examine Derby classes to determine if we need to add serialVersionUID to any of them</td>
  569. </tr>
  570. <tr>
  571. <td><a href="https://issues.apache.org/jira/browse/DERBY-6125">DERBY-6125</a></td><td>Code clean up in client driver.</td>
  572. </tr>
  573. <tr>
  574. <td><a href="https://issues.apache.org/jira/browse/DERBY-6096">DERBY-6096</a></td><td>OutOfMemoryError with Clob or Blob hash join: DataTypeDescriptor.estimatedMemoryUsage() has no case for BLOB or CLOB so would underestimate memory usage for those types at zero</td>
  575. </tr>
  576. <tr>
  577. <td><a href="https://issues.apache.org/jira/browse/DERBY-6075">DERBY-6075</a></td><td>Use modern collections in impl/sql/compile</td>
  578. </tr>
  579. <tr>
  580. <td><a href="https://issues.apache.org/jira/browse/DERBY-5840">DERBY-5840</a></td><td>Clean up compiler warnings introduced by using Java 5 language features</td>
  581. </tr>
  582. <tr>
  583. <td><a href="https://issues.apache.org/jira/browse/DERBY-5615">DERBY-5615</a></td><td>NPE in Store when running SELECT in a read-only database accessed via the classpath subprotocol when authentication, authorization, and Java security are turned on</td>
  584. </tr>
  585. <tr>
  586. <td><a href="https://issues.apache.org/jira/browse/DERBY-5317">DERBY-5317</a></td><td>NullPointerException in org.apache.derby.client.net.Request.sendBytes() with client</td>
  587. </tr>
  588. <tr>
  589. <td><a href="https://issues.apache.org/jira/browse/DERBY-5313">DERBY-5313</a></td><td>Assert failure with CASE expression in GROUP BY clause</td>
  590. </tr>
  591. <tr>
  592. <td><a href="https://issues.apache.org/jira/browse/DERBY-5196">DERBY-5196</a></td><td>Correct the layout of log.ctrl as described on the Derby web site</td>
  593. </tr>
  594. <tr>
  595. <td><a href="https://issues.apache.org/jira/browse/DERBY-5111">DERBY-5111</a></td><td>NullPointerException on unique constraint violation with unique index</td>
  596. </tr>
  597. <tr>
  598. <td><a href="https://issues.apache.org/jira/browse/DERBY-4805">DERBY-4805</a></td><td>Increase the length of the RDBNAM field in the DRDA implementation</td>
  599. </tr>
  600. <tr>
  601. <td><a href="https://issues.apache.org/jira/browse/DERBY-4750">DERBY-4750</a></td><td>add documentation to declare global temporary tables to explain expected behavior when used with XA transactions.</td>
  602. </tr>
  603. <tr>
  604. <td><a href="https://issues.apache.org/jira/browse/DERBY-4478">DERBY-4478</a></td><td>Use AtomicLong for XactFactory.tranId</td>
  605. </tr>
  606. <tr>
  607. <td><a href="https://issues.apache.org/jira/browse/DERBY-4403">DERBY-4403</a></td><td>Assert failure (sane) or NullPointerException (insane) when attempting to GROUP BY expression containing scalar subquery</td>
  608. </tr>
  609. <tr>
  610. <td><a href="https://issues.apache.org/jira/browse/DERBY-4381">DERBY-4381</a></td><td>Connection to Derby database using jar subprotocol doesn't work if the path has round bracket in it</td>
  611. </tr>
  612. <tr>
  613. <td><a href="https://issues.apache.org/jira/browse/DERBY-3573">DERBY-3573</a></td><td>Argument checking for ResultSet.setFetchSize(int) is incorrect</td>
  614. </tr>
  615. <tr>
  616. <td><a href="https://issues.apache.org/jira/browse/DERBY-3476">DERBY-3476</a></td><td>Permissions and Principal objects added by this feature need to be final and have serialization identifiers</td>
  617. </tr>
  618. <tr>
  619. <td><a href="https://issues.apache.org/jira/browse/DERBY-3155">DERBY-3155</a></td><td>Support for SQL:2003 MERGE statement</td>
  620. </tr>
  621. <tr>
  622. <td><a href="https://issues.apache.org/jira/browse/DERBY-2438">DERBY-2438</a></td><td>Remove JDBC20Translation and JDBC30Translation classes</td>
  623. </tr>
  624. <tr>
  625. <td><a href="https://issues.apache.org/jira/browse/DERBY-2423">DERBY-2423</a></td><td>Embedded and client differ on ResultSetMetaData.isCurrency() value for DECIMAL and NUMERIC columns</td>
  626. </tr>
  627. <tr>
  628. <td><a href="https://issues.apache.org/jira/browse/DERBY-2041">DERBY-2041</a></td><td>Trigger should register a dependency on tables and columns used in its body</td>
  629. </tr>
  630. <tr>
  631. <td><a href="https://issues.apache.org/jira/browse/DERBY-2002">DERBY-2002</a></td><td>Case expression allows NULL in all parts of &lt;result&gt;</td>
  632. </tr>
  633. <tr>
  634. <td><a href="https://issues.apache.org/jira/browse/DERBY-1997">DERBY-1997</a></td><td>Misleading text in WwdEmbedded demo source file for Working With Derby</td>
  635. </tr>
  636. <tr>
  637. <td><a href="https://issues.apache.org/jira/browse/DERBY-1984">DERBY-1984</a></td><td>Re-factor JDBC classes to remove support for JDBC 2</td>
  638. </tr>
  639. <tr>
  640. <td><a href="https://issues.apache.org/jira/browse/DERBY-1576">DERBY-1576</a></td><td>Extend the CASE expression syntax for "simple case"</td>
  641. </tr>
  642. <tr>
  643. <td><a href="https://issues.apache.org/jira/browse/DERBY-1028">DERBY-1028</a></td><td>Change constructors in NetConnection classes to use LogWriter instead of NetLogWriter</td>
  644. </tr>
  645. <tr>
  646. <td><a href="https://issues.apache.org/jira/browse/DERBY-673">DERBY-673</a></td><td>Get rid of the NodeFactory</td>
  647. </tr>
  648. <tr>
  649. <td><a href="https://issues.apache.org/jira/browse/DERBY-534">DERBY-534</a></td><td>Support use of the WHEN clause in CREATE TRIGGER statements</td>
  650. </tr>
  651. <tr>
  652. <td><a href="https://issues.apache.org/jira/browse/DERBY-532">DERBY-532</a></td><td>Support deferrable constraints</td>
  653. </tr>
  654. </table>
  655. </div>
  656. <h2>
  657. <a name="Issues"></a>Issues</h2>
  658. <div>
  659. <p>Compared with the previous release (10.10.2.0), Derby release 10.11.1.1 introduces the following new features and incompatibilities. These merit your special attention.</p>
  660. <ul>
  661. <li>
  662. <a href="#Note for DERBY-6566"><span>Note for DERBY-6566:
  663. More type mismatches are detected in THEN and ELSE clauses of CASE
  664. expressions.
  665. </span></a>
  666. </li>
  667. <li>
  668. <a href="#Note for DERBY-6545"><span>Note for DERBY-6545:
  669. You can no longer add a default to an identity column.
  670. </span></a>
  671. </li>
  672. <li>
  673. <a href="#Note for DERBY-6542"><span>Note for DERBY-6542:
  674. Identity columns are now backed by internal sequence generators.
  675. </span></a>
  676. </li>
  677. <li>
  678. <a href="#Note for DERBY-6447"><span>Note for DERBY-6447: Implementation of LOG10, COSH, SINH and TANH changed.</span></a>
  679. </li>
  680. <li>
  681. <a href="#Note for DERBY-6434"><span>Note for DERBY-6434:
  682. Privileges required for INSERT and DELETE statements have changed.
  683. </span></a>
  684. </li>
  685. <li>
  686. <a href="#Note for DERBY-6429"><span>Note for DERBY-6429:
  687. Privileges required for UPDATE statements have changed.
  688. </span></a>
  689. </li>
  690. <li>
  691. <a href="#Note for DERBY-6213"><span>Note for DERBY-6213:
  692. Derby no longer runs on Java 5 and CDC.
  693. </span></a>
  694. </li>
  695. <li>
  696. <a href="#Note for DERBY-6128"><span>Note for DERBY-6128:
  697. Due to a bug introduced in Derby 10.8, the serialized version number
  698. of the class EmbeddedConnectionPoolDataSource40 has changed in Derby 10.8 and later.
  699. </span></a>
  700. </li>
  701. <li>
  702. <a href="#Note for DERBY-6096"><span>Note for DERBY-6096:
  703. Estimates have changed for the memory needed when hash-joining LOB-bearing tables.
  704. </span></a>
  705. </li>
  706. <li>
  707. <a href="#Note for DERBY-2041"><span>Note for DERBY-2041:
  708. Dropping objects mentioned by triggers now fails.
  709. </span></a>
  710. </li>
  711. <li>
  712. <a href="#Note for DERBY-2002"><span>Note for DERBY-2002: CASE expressions require at least one result expression with a
  713. known type.</span></a>
  714. </li>
  715. </ul>
  716. <hr>
  717. <h3>
  718. <a name="Note for DERBY-6566"></a>Note for DERBY-6566</h3>
  719. <div>
  720. <!--
  721. SUMMARIZE THE ISSUE. This is a one line, one sentence summary of the
  722. issue. It serves as the title for the issue in the Issues section of
  723. the full Release Notes.
  724. For instance:
  725. Applications may no longer open two InputStreams on the same ResultSet column.
  726. -->
  727. <h4>Summary of Change</h4>
  728. <p>
  729. More type mismatches are detected in THEN and ELSE clauses of CASE
  730. expressions.
  731. </p>
  732. <!--
  733. DESCRIBE WHAT IT IS THAT THE USER ACTUALLY SEES WHEN THE PROBLEM OCCURS.
  734. For instance:
  735. In the previous release, applications were able to open two
  736. InputStreams on the same column. Depending on how these streams
  737. interacted, the value siphoned out of the column was erratic. Now
  738. Derby raises a SQLException when the application attempts to create
  739. the second InputStream.
  740. -->
  741. <h4>Symptoms Seen by Applications Affected by Change</h4>
  742. <p>
  743. If a CASE expression has a THEN clause or an ELSE clause that consists
  744. of an explicitly typed NULL, and the type is not compatible with all
  745. the other THEN and ELSE clauses of the CASE expression, an exception
  746. will be thrown.
  747. </p>
  748. <p>
  749. For example, the following CASE expression
  750. </p>
  751. <pre>
  752. CASE
  753. WHEN a=b THEN 1
  754. ELSE CAST(NULL AS CHAR(10))
  755. END
  756. </pre>
  757. <p>
  758. will cause the following error
  759. </p>
  760. <pre>
  761. ERROR 42X89: Types 'CHAR' and 'INTEGER' are not type compatible.
  762. Neither type is assignable to the other type.
  763. </pre>
  764. <p>
  765. In Derby versions from 10.3 to 10.10, the same expression would have
  766. succeeded, and it would have evaluated either to 1 or to NULL with
  767. type INTEGER.
  768. </p>
  769. <!--
  770. OPTIONAL: DESCRIBE INCOMPATIBILITIES WITH PREVIOUS RELEASE, IF ANY.
  771. For instance:
  772. Applications which open two InputStreams on the ResultSet column now
  773. fail.
  774. -->
  775. <!--h4>Incompatibilities with Previous Release</h4>
  776. <p>
  777. ????
  778. </p-->
  779. <!--
  780. DESCRIBE WHY THE CHANGE WAS MADE.
  781. For instance:
  782. The previous behavior violated the JDBC standard. The new behavior
  783. is correct.
  784. -->
  785. <h4>Rationale for Change</h4>
  786. <p>
  787. The old behaviour was unintended and could hide bugs in SQL statements.
  788. </p>
  789. <!--
  790. OPTIONAL: DESCRIBE HOW TO REVERT TO THE PREVIOUS BEHAVIOR OR
  791. OTHERWISE AVOID THE INCOMPATIBILITIES INTRODUCED BY THIS CHANGE.
  792. For instance:
  793. Users must recode applications which open multiple streams on the same column.
  794. -->
  795. <h4>Application Changes Required</h4>
  796. <p>
  797. Applications that cast NULL to an incorrect type in a THEN or ELSE
  798. clause, should rewrite that clause to use either an implicitly typed
  799. NULL or an explicitly typed null of a type compatible with the other
  800. THEN or ELSE clauses.
  801. </p>
  802. <p>
  803. For example, the failing expression mentioned above could be rewritten
  804. to the following:
  805. </p>
  806. <pre>
  807. CASE
  808. WHEN a=b THEN 1
  809. ELSE NULL
  810. END
  811. </pre>
  812. <p>
  813. The NULL in the ELSE clause will get its type inferred from the type
  814. of the THEN clause. That is, INTEGER.
  815. </p>
  816. <p>
  817. If an explicitly typed NULL is preferred, the expression could also be
  818. rewritten to the following:
  819. </p>
  820. <pre>
  821. CASE
  822. WHEN a=b THEN 1
  823. ELSE CAST(NULL AS INTEGER)
  824. END
  825. </pre>
  826. </div>
  827. <hr>
  828. <h3>
  829. <a name="Note for DERBY-6545"></a>Note for DERBY-6545</h3>
  830. <div>
  831. <h4>Summary of Change</h4>
  832. <p>
  833. You can no longer add a default to an identity column.
  834. </p>
  835. <!--
  836. DESCRIBE WHAT IT IS THAT THE USER ACTUALLY SEES WHEN THE PROBLEM OCCURS.
  837. For instance:
  838. In the previous release, applications were able to open two
  839. InputStreams on the same column. Depending on how these streams
  840. interacted, the value siphoned out of the column was erratic. Now
  841. Derby raises a SQLException when the application attempts to create
  842. the second InputStream.
  843. -->
  844. <h4>Symptoms Seen by Applications Affected by Change</h4>
  845. <p>
  846. You can no longer change an identity column as follows:
  847. </p>
  848. <pre>
  849. <b>
  850. alter table MyTable alter column MyIdentityColumn default 99;
  851. </b>
  852. </pre>
  853. <h4>Incompatibilities with Previous Release</h4>
  854. <p>
  855. Previously, that statement would have added a default to
  856. MyTable.MyIdentityColumn and the column would have ceased to be an
  857. identity column.
  858. </p>
  859. <h4>Rationale for Change</h4>
  860. <p>
  861. The previous behavior violated the SQL Standard.
  862. </p>
  863. <h4>Application Changes Required</h4>
  864. <p>
  865. Applications which need to change an identity column into a non-identity
  866. column with a default should be re-coded to do something like this:
  867. </p>
  868. <pre>
  869. <b>
  870. alter table MyTable add column dummy int default 99;
  871. update MyTable set dummy = MyIdentityColumn;
  872. alter table MyTable drop column MyIdentityColumn;
  873. rename column MyTable.dummy to MyIdentityColumn;
  874. </b>
  875. </pre>
  876. </div>
  877. <hr>
  878. <h3>
  879. <a name="Note for DERBY-6542"></a>Note for DERBY-6542</h3>
  880. <div>
  881. <h4>Summary of Change</h4>
  882. <p>
  883. Identity columns are now backed by internal sequence generators.
  884. </p>
  885. <h4>Symptoms Seen by Applications Affected by Change</h4>
  886. <p>
  887. In previous releases, identity values were managed in the heavily used
  888. SYS.SYSCOLUMNS table. This caused lock contention among insert
  889. statements.
  890. </p>
  891. <h4>Incompatibilities with Previous Release</h4>
  892. <p>
  893. After hard-upgrading to 10.11, identity columns will now be backed by
  894. internal sequence generators. This should reduce lock contention among
  895. insert statements. It also means that identity
  896. columns now pre-allocate ranges of upcoming values, just as sequences do. Applications
  897. should take extra care to shutdown databases gracefully before
  898. exiting. If an application crashes or does not close its databases
  899. gracefully, then the unused, pre-allocated identity values will
  900. leak; the user will see a gap between the last identity value
  901. inserted before the crash and the first identity value inserted after
  902. restarting the application.
  903. </p>
  904. <p>
  905. In addition, after hard-upgrading to 10.11, users will no longer be
  906. able to query the SYS.SYSCOLUMNS table in order to discover the next
  907. value which will be inserted into an identity column. Instead, users
  908. should use the new SYSCS_UTIL.SYSCS_PEEK_AT_IDENTITY() system function.
  909. Users should never directly query SYS.SYSCOLUMNS or
  910. SYS.SYSSEQUENCES. Directly querying these catalogs will acquire read locks
  911. which may throttle application throughput.
  912. </p>
  913. <h4>Rationale for Change</h4>
  914. <p>
  915. This change was made in order to improve the throughput/performance of inserts
  916. into tables which have identity columns.
  917. </p>
  918. <h4>Application Changes Required</h4>
  919. <p>
  920. After hard-upgrading to 10.11, be sure that your application closes
  921. its databases gracefully so that you do not leak unused, pre-allocated
  922. identity values. Individual databases may be closed
  923. via the <i>shutdown=true</i> attribute:
  924. </p>
  925. <pre>
  926. <b>
  927. DriverManager.getConnection( "jdbc:derby:myDatabase;shutdown=true" );
  928. </b>
  929. </pre>
  930. <p>
  931. Alternatively, all open databases may be closed by shutting down the engine:
  932. </p>
  933. <pre>
  934. <b>
  935. DriverManager.getConnection( "jdbc:derby:;shutdown=true" );
  936. </b>
  937. </pre>
  938. <p>
  939. If your application is prone to ungraceful crashes and you cannot
  940. tolerate leaking unused, pre-allocated identity values, then you can
  941. adjust the maximum number of unused values per identity column. You
  942. can do this be setting the <i>derby.language.sequence.preallocator</i>
  943. database property. The default setting for this property is 100:
  944. </p>
  945. <pre>
  946. <b>
  947. call syscs_util.syscs_set_database_property( 'derby.language.sequence.preallocator', '10' );
  948. </b>
  949. </pre>
  950. <p>
  951. In addition, after hard-upgrading to 10.11, applications should be
  952. adjusted so that they call
  953. SYSCS_UTIL.SYSCS_PEEK_AT_IDENTITY() in order to discover the next value which
  954. will be inserted into an identity column. Applications should no
  955. longer directly query SYS.SYSCOLUMNS for this information:
  956. </p>
  957. <pre>
  958. <b>
  959. values SYSCS_UTIL.SYSCS_PEEK_AT_IDENTITY( 'APP', 'MYTABLE' );
  960. </b>
  961. </pre>
  962. </div>
  963. <hr>
  964. <h3>
  965. <a name="Note for DERBY-6447"></a>Note for DERBY-6447</h3>
  966. <div>
  967. <!--
  968. SUMMARIZE THE ISSUE. This is a one line summary of the issue.
  969. For instance:
  970. Applications may no longer open two InputStreams on the same ResultSet column.
  971. -->
  972. <h4>Summary of Change</h4>
  973. <p>Implementation of LOG10, COSH, SINH and TANH changed.</p>
  974. <!--
  975. DESCRIBE WHAT IT IS THAT THE USER ACTUALLY SEES WHEN THE PROBLEM OCCURS.
  976. For instance:
  977. In the previous release, applications were able to open two
  978. InputStreams on the same column. Depending on how these streams
  979. interacted, the value siphoned out of the column was erratic. Now
  980. Derby raises a SQLException when the application attempts to create
  981. the second InputStream.
  982. -->
  983. <h4>Symptoms Seen by Applications Affected by Change</h4>
  984. <p>
  985. Apache Derby has built-in logarithmic and hyperbolic functions that
  986. live in the SYSFUN schema. Most, but not all, of these functions are
  987. implemented as calls to the corresponding methods in
  988. the <tt>java.lang.StrictMath</tt> class. In this release, more
  989. functions than before use the methods in
  990. the <tt>java.lang.StrictMath</tt> class.
  991. </p>
  992. <p>
  993. Specifically, the implementation of the LOG10, COSH, SINH and TANH
  994. functions have changed, and for some input values the values returned
  995. by those methods have changed.
  996. </p>
  997. <p>
  998. For example, the function call <tt>LOG10(1000)</tt> would return
  999. <tt>2.9999999999999996</tt> in the previous versions. In this version,
  1000. it will return <tt>3.0</tt>.
  1001. </p>
  1002. <p>
  1003. The function call <tt>TANH(1000)</tt> would fail with
  1004. </p>
  1005. <pre>
  1006. ERROR 22003: The resulting value is outside the range for the data type DOUBLE.
  1007. </pre>
  1008. <p>
  1009. in previous versions. In this version, it will succeed and
  1010. return <tt>1.0</tt>.
  1011. </p>
  1012. <!--
  1013. OPTIONAL: DESCRIBE INCOMPATIBILITIES WITH PREVIOUS RELEASE, IF ANY.
  1014. For instance:
  1015. Applications which open two InputStreams on the ResultSet column now
  1016. fail.
  1017. -->
  1018. <!-- h4>Incompatibilities with Previous Release</h4 -->
  1019. <!--
  1020. DESCRIBE WHY THE CHANGE WAS MADE.
  1021. For instance:
  1022. The previous behavior violated the JDBC standard. The new behavior
  1023. is correct.
  1024. -->
  1025. <h4>Rationale for Change</h4>
  1026. <p>
  1027. Using the <tt>java.lang.StrictMath</tt> class instead of custom
  1028. implementations makes the functions return more accurate results. It
  1029. also fixes issues where the custom implementations experienced
  1030. overflow in intermediate results and failed instead of returning a
  1031. result.
  1032. </p>
  1033. <!--
  1034. OPTIONAL: DESCRIBE HOW TO REVERT TO THE PREVIOUS BEHAVIOR OR
  1035. OTHERWISE AVOID THE INCOMPATIBILITIES INTRODUCED BY THIS CHANGE.
  1036. For instance:
  1037. Users must recode applications which open multiple streams on the same column.
  1038. -->
  1039. <h4>Application Changes Required</h4>
  1040. <p>
  1041. The new implementations are used automatically after upgrade without
  1042. any changes to the application. If your application uses any of the
  1043. affected functions, you should check that it doesn't depend on these
  1044. functions returning the exact same results before and after the
  1045. upgrade.
  1046. </p>
  1047. <p>
  1048. If one of the affected functions is used in the generation expression
  1049. of a generated column, the value of the generated column will not be
  1050. recalculated automatically on upgrade. It will be recalculated when a
  1051. column referenced in the generation expression is updated, or if the
  1052. generated column is updated to its <tt>DEFAULT</tt> value. To force
  1053. the generated values to be recalculated sooner after upgrade, you can
  1054. issue an UPDATE statement such as:
  1055. </p>
  1056. <pre>
  1057. UPDATE t SET generated_column = DEFAULT
  1058. </pre>
  1059. </div>
  1060. <hr>
  1061. <h3>
  1062. <a name="Note for DERBY-6434"></a>Note for DERBY-6434</h3>
  1063. <div>
  1064. <h4>Summary of Change</h4>
  1065. <p>
  1066. Privileges required for INSERT and DELETE statements have changed.
  1067. </p>
  1068. <h4>Symptoms Seen by Applications Affected by Change</h4>
  1069. <p>
  1070. Fewer privileges are now required to execute INSERT and DELETE statements.
  1071. </p>
  1072. <h4>Incompatibilities with Previous Release</h4>
  1073. <p>
  1074. In previous versions, INSERT and DELETE statements demanded that the
  1075. user enjoy EXECUTE privilege on functions and USAGE privilege on types
  1076. mentioned by the target table's check constraints, generated columns, and triggers.
  1077. Those privileges are no longer required by INSERT and DELETE statements.
  1078. INSERT and DELETE statements which previously failed due to
  1079. insufficient privileges may succeed now.
  1080. </p>
  1081. <h4>Rationale for Change</h4>
  1082. <p>
  1083. This change makes Derby conform better to the SQL Standard.
  1084. </p>
  1085. <h4>Application Changes Required</h4>
  1086. <p>
  1087. Security may now be tightened for applications which run with SQL authorization enabled.
  1088. Those applications may revoke EXECUTE and USAGE privileges which are no longer necessary in order
  1089. to run INSERT and DELETE statements.
  1090. </p>
  1091. </div>
  1092. <hr>
  1093. <h3>
  1094. <a name="Note for DERBY-6429"></a>Note for DERBY-6429</h3>
  1095. <div>
  1096. <h4>Summary of Change</h4>
  1097. <p>
  1098. Privileges required for UPDATE statements have changed.
  1099. </p>
  1100. <h4>Symptoms Seen by Applications Affected by Change</h4>
  1101. <p>
  1102. In previous versions, UPDATE statements demanded that the user enjoy
  1103. UPDATE privilege on all columns from the target table which were
  1104. mentioned in the WHERE clause. Now Derby requires SELECT privilege on
  1105. those columns, instead.
  1106. </p>
  1107. <h4>Incompatibilities with Previous Release</h4>
  1108. <p>
  1109. In previous versions, UPDATE statements demanded more privileges than
  1110. the SQL Standard required. In particular, UPDATE statements required...
  1111. </p>
  1112. <ul>
  1113. <li>...UPDATE privilege on columns from the target table which
  1114. were mentioned in the WHERE clause.</li>
  1115. <li>...EXECUTE privilege on functions and USAGE privilege on
  1116. types mentioned by the table's generation clauses, CHECK
  1117. constraints, and UPDATE triggers.</li>
  1118. </ul>
  1119. <p>
  1120. Now Derby no longer demands these overbroad privileges. However, Derby
  1121. does require SELECT privilege instead of UPDATE privilege on columns
  1122. from the target table which are mentioned in the WHERE clause.
  1123. </p>
  1124. <h4>Rationale for Change</h4>
  1125. <p>
  1126. This change makes Derby conform better to the SQL
  1127. Standard.
  1128. </p>
  1129. <h4>Application Changes Required</h4>
  1130. <p>
  1131. In applications which run with SQL authorization enabled, an UPDATE
  1132. statement may now fail because the application has not granted the
  1133. user SELECT privilege on all target table columns mentioned in the
  1134. statement's WHERE clause. Those applications should grant users the
  1135. appropriate SELECT privileges.
  1136. </p>
  1137. <p>
  1138. In addition, applications may now tighten their security by revoking
  1139. UPDATE, EXECUTE, and USAGE privileges which are no longer necessary in
  1140. order to run UPDATE statements.
  1141. </p>
  1142. </div>
  1143. <hr>
  1144. <h3>
  1145. <a name="Note for DERBY-6213"></a>Note for DERBY-6213</h3>
  1146. <div>
  1147. <h4>Summary of Change</h4>
  1148. <p>
  1149. Derby no longer runs on Java 5 and CDC.
  1150. </p>
  1151. <h4>Symptoms Seen by Applications Affected by Change</h4>
  1152. <p>
  1153. Previous releases of Derby ran on Java 5 and on the small device CDC
  1154. platform. The 10.11 release family only runs on Java 6 and higher JVMs.
  1155. </p>
  1156. <h4>Incompatibilities with Previous Release</h4>
  1157. <p>
  1158. Applications currently running on Java 5 or CDC will not be able to
  1159. use Derby 10.11. Customers must upgrade their Java platform before
  1160. installing Derby 10.11.
  1161. </p>
  1162. <p>
  1163. Previously, Derby's public javadoc included two branches: one for
  1164. applications which ran on Java 5 and CDC, and another for applications
  1165. which ran on Java 6 and higher. Now there is one set of public javadoc
  1166. intended for use on all supported JVMs.
  1167. Applications are encouraged to use the following Derby DataSources
  1168. when running on a full Java SE/EE JVM:
  1169. </p>
  1170. <ul>
  1171. <li>ClientConnectionPoolDataSource</li>
  1172. <li>ClientDataSource</li>
  1173. <li>ClientXADataSource</li>
  1174. <li>EmbeddedConnectionPoolDataSource</li>
  1175. <li>EmbeddedDataSource</li>
  1176. <li>EmbeddedXADataSource</li>
  1177. </ul>
  1178. <p>
  1179. ...and the following DataSources when running on Java 8's
  1180. small-device compact profile 2:
  1181. </p>
  1182. <ul>
  1183. <li>BasicClientConnectionPoolDataSource40</li>
  1184. <li>BasicClientDataSource40</li>
  1185. <li>BasicClientXADataSource40</li>
  1186. <li>BasicEmbeddedConnectionPoolDataSource40</li>
  1187. <li>BasicEmbeddedDataSource40</li>
  1188. <li>BasicEmbeddedXADataSource40</li>
  1189. </ul>
  1190. <p>
  1191. For backward compatibility reasons, Derby continues to include the
  1192. following DataSources. However, they are vacuous extensions of their
  1193. superclasses now and may be removed in the future. Applications are
  1194. encouraged to migrate away from these DataSources and to use the
  1195. DataSources listed above instead:
  1196. </p>
  1197. <ul>
  1198. <li>ClientConnectionPoolDataSource40</li>
  1199. <li>ClientDataSource40</li>
  1200. <li>ClientXADataSource40</li>
  1201. <li>EmbeddedConnectionPoolDataSource40</li>
  1202. <li>EmbeddedDataSource40</li>
  1203. <li>EmbeddedXADataSource40</li>
  1204. </ul>
  1205. <h4>Rationale for Change</h4>
  1206. <p>
  1207. The older Java platforms are no longer being actively developed and
  1208. they may contain well-known security vulnerabilities. The
  1209. Java community is encouraged to migrate to modern, more secure JVMs which are
  1210. being actively developed. Users interested in running Derby on small
  1211. devices are encouraged to use Java 8's compact profile 2.
  1212. </p>
  1213. <h4>Application Changes Required</h4>
  1214. <p>
  1215. Customers who use Java 5 or CDC will need to upgrade their
  1216. Java platform if they want to use features introduced by Derby
  1217. 10.11. Applications are encouraged to migrate to the supported
  1218. DataSources listed above.
  1219. </p>
  1220. </div>
  1221. <hr>
  1222. <h3>
  1223. <a name="Note for DERBY-6128"></a>Note for DERBY-6128</h3>
  1224. <div>
  1225. <h4>Summary of Change</h4>
  1226. <p>
  1227. Due to a bug introduced in Derby 10.8, the serialized version number
  1228. of the class EmbeddedConnectionPoolDataSource40 has changed in Derby 10.8 and later.
  1229. </p>
  1230. <h4>Symptoms Seen by Applications Affected by Change</h4>
  1231. <p>
  1232. Serialized objects for the class EmbeddedConnectionPoolDataSource40
  1233. produced by a Derby version 10.7 or older would not be readable with
  1234. this version of Derby.
  1235. </p>
  1236. <h4>Incompatibilities with Previous Release</h4>
  1237. Derby releases newer than 10.8 can't read serialized data source
  1238. objects of the class EmbeddedConnectionPoolDataSource40 if those
  1239. objects were produced by Derby version 10.7 or older.
  1240. <h4>Rationale for Change</h4>
  1241. Accidental change.
  1242. <h4>Application Changes Required</h4>
  1243. N/A.
  1244. </div>
  1245. <hr>
  1246. <h3>
  1247. <a name="Note for DERBY-6096"></a>Note for DERBY-6096</h3>
  1248. <div>
  1249. <h4>Summary of Change</h4>
  1250. <p>
  1251. Estimates have changed for the memory needed when hash-joining LOB-bearing tables.
  1252. </p>
  1253. <h4>Symptoms Seen by Applications Affected by Change</h4>
  1254. <p>
  1255. In previous releases, BLOBs and CLOBs held in memory were estimated to
  1256. take zero bytes. This would mean that hash joins with many objects of
  1257. type BLOB or CLOB could use a large amount of memory. That might improve
  1258. performance. However, it could cause OutOfMemory errors. After the
  1259. change for DERBY-6096, hash joins may spill to disk earlier and thus
  1260. run slower.
  1261. </p>
  1262. <h4>Incompatibilities with Previous Release</h4>
  1263. <p>
  1264. BLOBs and CLOBs did not have a maximum memory limit for hash
  1265. joins. Now they have the default limit of 1048576 (1MB). This limit
  1266. can be overridden by setting the derby.language.maxMemoryPerTable property.
  1267. </p>
  1268. <h4>Rationale for Change</h4>
  1269. <p>
  1270. Hash joins of LOB-bearing tables were raising OutOfMemory errors and
  1271. crashing the engine.
  1272. </p>
  1273. <h4>Application Changes Required</h4>
  1274. <p>
  1275. To allow BLOB/CLOB (and all) hash joins to use more memory, set
  1276. the Derby property derby.language.maxMemoryPerTable to be the number of bytes you would like to allow for each hash join.
  1277. </p>
  1278. </div>
  1279. <hr>
  1280. <h3>
  1281. <a name="Note for DERBY-2041"></a>Note for DERBY-2041</h3>
  1282. <div>
  1283. <h4>Summary of Change</h4>
  1284. <p>
  1285. Dropping objects mentioned by triggers now fails.
  1286. </p>
  1287. <h4>Symptoms Seen by Applications Affected by Change</h4>
  1288. <p>
  1289. When <tt>DROP TABLE/VIEW/PROCEDURE/FUNCTION/SYNONYM</tt> is invoked on
  1290. an object which is used by a trigger in a triggered SQL statement, the
  1291. <tt>DROP</tt> operation now fails and the object is not dropped. In previous releases, those operations would have succeeded, and an exception would have been thrown the next time the dependent trigger fired.
  1292. </p>
  1293. <p>
  1294. The message text of the new <tt>SQLException</tt> looks like this:
  1295. </p>
  1296. <pre>
  1297. ERROR X0Y25: Operation 'DROP TABLE' cannot be performed on object 'T' because TRIGGER 'TR' is dependent on that object.
  1298. </pre>
  1299. <p>
  1300. The new exception is thrown only if the trigger was created with
  1301. version 10.11 or higher. If the dependent trigger was created with an older version, the <tt>DROP</tt> operation will succeed, and an exception will be thrown the next time the trigger fires.
  1302. </p>
  1303. <!--h4>Incompatibilities with Previous Release</h4>
  1304. <p>
  1305. </p-->
  1306. <!--
  1307. DESCRIBE WHY THE CHANGE WAS MADE.
  1308. For instance:
  1309. The previous behavior violated the JDBC standard. The new behavior
  1310. is correct.
  1311. -->
  1312. <h4>Rationale for Change</h4>
  1313. <p>
  1314. The previous behavior dropped objects and made other objects invalid. That caused subsequent errors. The new behavior helps prevent such problems.
  1315. </p>
  1316. <p>
  1317. Also, the new behavior makes
  1318. <tt>DROP TABLE/VIEW/PROCEDURE/FUNCTION/SYNONYM</tt> consistent with
  1319. <tt>DROP TYPE/SEQUENCE/DERBY AGGREGATE</tt>, <tt>ALTER TABLE ... DROP
  1320. COLUMN</tt> and <tt>REVOKE</tt>. Those statements already failed when there was a dependent trigger.
  1321. </p>
  1322. <!--
  1323. OPTIONAL: DESCRIBE HOW TO REVERT TO THE PREVIOUS BEHAVIOR OR
  1324. OTHERWISE AVOID THE INCOMPATIBILITIES INTRODUCED BY THIS CHANGE.
  1325. For instance:
  1326. Users must recode applications which open multiple streams on the same column.
  1327. -->
  1328. <h4>Application Changes Required</h4>
  1329. <p>
  1330. Applications that drop objects used in triggered SQL statements, must drop the dependent trigger before dropping the dependency.
  1331. </p>
  1332. </div>
  1333. <hr>
  1334. <h3>
  1335. <a name="Note for DERBY-2002"></a>Note for DERBY-2002</h3>
  1336. <div>
  1337. <!--
  1338. SUMMARIZE THE ISSUE. This is a one line summary of the issue.
  1339. For instance:
  1340. Applications may no longer open two InputStreams on the same ResultSet column.
  1341. -->
  1342. <h4>Summary of Change</h4>
  1343. <p>CASE expressions require at least one result expression with a
  1344. known type.</p>
  1345. <!--
  1346. DESCRIBE WHAT IT IS THAT THE USER ACTUALLY SEES WHEN THE PROBLEM OCCURS.
  1347. For instance:
  1348. In the previous release, applications were able to open two
  1349. InputStreams on the same column. Depending on how these streams
  1350. interacted, the value siphoned out of the column was erratic. Now
  1351. Derby raises a SQLException when the application attempts to create
  1352. the second InputStream.
  1353. -->
  1354. <h4>Symptoms Seen by Applications Affected by Change</h4>
  1355. <p>
  1356. Earlier versions allowed CASE expressions where all the result
  1357. expressions (then THEN and ELSE clauses) were untyped <tt>NULL</tt>s
  1358. or a mix of untyped <tt>NULL</tt>s and untyped parameters. Now the
  1359. following error will be raised when an application evaluates such an
  1360. expression:
  1361. </p>
  1362. <pre>
  1363. ERROR 42X87: At least one result expression (THEN or ELSE) of the CASE expression must have a known type.
  1364. </pre>
  1365. <!--
  1366. OPTIONAL: DESCRIBE INCOMPATIBILITIES WITH PREVIOUS RELEASE, IF ANY.
  1367. For instance:
  1368. Applications which open two InputStreams on the ResultSet column now
  1369. fail.
  1370. -->
  1371. <h4>Incompatibilities with Previous Release</h4>
  1372. <p>
  1373. Applications that use a CASE expression with unknown return type now fail.
  1374. </p>
  1375. <!--
  1376. DESCRIBE WHY THE CHANGE WAS MADE.
  1377. For instance:
  1378. The previous behavior violated the JDBC standard. The new behavior
  1379. is correct.
  1380. -->
  1381. <h4>Rationale for Change</h4>
  1382. <p>
  1383. The SQL standard requires that at least one of the result expressions
  1384. is not an untyped <tt>NULL</tt>.
  1385. </p>
  1386. <p>
  1387. The previous behavior was inconsistent, as it accepted CASE statements
  1388. where all result expressions were untyped if they were
  1389. all <tt>NULL</tt>s or if they were a mix of <tt>NULL</tt>s and
  1390. parameters, but it failed if they all were parameters.
  1391. </p>
  1392. <p>
  1393. Also, it arbitrarily chose the type <tt>CHAR(1)</tt> if it could not
  1394. determine the type of the CASE expression. That type may or may not be
  1395. the type the application wants. It is safer to fail when the type
  1396. cannot be determined, and let the application specify explicitly which
  1397. type it wants.
  1398. </p>
  1399. <!--
  1400. OPTIONAL: DESCRIBE HOW TO REVERT TO THE PREVIOUS BEHAVIOR OR
  1401. OTHERWISE AVOID THE INCOMPATIBILITIES INTRODUCED BY THIS CHANGE.
  1402. For instance:
  1403. Users must recode applications which open multiple streams on the same column.
  1404. -->
  1405. <h4>Application Changes Required</h4>
  1406. <p>
  1407. If an application has a CASE expression that fails because of this
  1408. change, it should change the CASE expression so that at least one of
  1409. the THEN or ELSE expressions has a known type.
  1410. </p>
  1411. <p>
  1412. For example, the following expression
  1413. </p>
  1414. <pre>
  1415. CASE
  1416. WHEN a = b THEN ?
  1417. ELSE NULL
  1418. END
  1419. </pre>
  1420. <p>could be changed to</p>
  1421. <pre>
  1422. CASE
  1423. WHEN a = b THEN CAST(? AS CHAR(1))
  1424. ELSE NULL
  1425. END
  1426. </pre>
  1427. <p>to make it clear to the compiler that it actually wants the
  1428. expression to return a value of type <tt>CHAR(1)</tt>.</p>
  1429. </div>
  1430. </div>
  1431. <h2>
  1432. <a name="Build Environment"></a>Build Environment</h2>
  1433. <div>
  1434. <p>Derby release 10.11.1.1 was built using the following environment:</p>
  1435. <ul>
  1436. <li>
  1437. <b>Branch</b> - Source code came from the 10.11 branch.</li>
  1438. <li>
  1439. <b>Machine</b> - Mac OSX 10.7.5.</li>
  1440. <li>
  1441. <b>Ant</b> - Apache Ant(TM) version 1.9.2 compiled on July 8 2013.</li>
  1442. <li>
  1443. <b>Compiler</b> - All classes were compiled by the javac from the 1.8.0-b132 JDK, Java HotSpot(TM) 64-Bit Server VM (build 25.0-b70, mixed mode).</li>
  1444. <li>
  1445. <b>JSR 169</b> - Support for JSR 169 has been deprecated.</li>
  1446. </ul>
  1447. </div>
  1448. <h2>
  1449. <a name="Verifying Releases"></a>Verifying Releases</h2>
  1450. <div>
  1451. <p>It is essential that you verify the integrity of the downloaded
  1452. files using the PGP and MD5 signatures. MD5 verification ensures the
  1453. file was not corrupted during the download process. PGP verification
  1454. ensures that the file came from a certain person.</p>
  1455. <p>The PGP signatures can be verified using
  1456. <a href="http://www.pgpi.org/">PGP</a> or
  1457. <a href="http://www.gnupg.org/">GPG</a>.
  1458. First download the Apache Derby
  1459. <a href="http://svn.apache.org/repos/asf/db/derby/code/trunk/KEYS">KEYS</a>
  1460. as well as the <code>asc</code> signature file for the particular
  1461. distribution. It is important that you get these files from the ultimate
  1462. trusted source - the main ASF distribution site, rather than from a mirror.
  1463. Then verify the signatures using ...</p>
  1464. <pre>
  1465. % pgpk -a KEYS
  1466. % pgpv db-derby-X.Y.tar.gz.asc
  1467. <em>or</em>
  1468. % pgp -ka KEYS
  1469. % pgp db-derby-X.Y.tar.gz.asc
  1470. <em>or</em>
  1471. % gpg --import KEYS
  1472. % gpg --verify db-derby-X.Y.tar.gz.asc
  1473. </pre>
  1474. <p>To verify the MD5 signature on the files, you need to use a program
  1475. called <code>md5</code> or <code>md5sum</code>, which is
  1476. included in many unix distributions. It is also available as part of
  1477. <a href="http://www.gnu.org/software/textutils/textutils.html">GNU
  1478. Textutils</a>. Windows users can get binary md5 programs from <a href="http://www.fourmilab.ch/md5/">here</a>, <a href="http://www.pc-tools.net/win32/freeware/console/">here</a>, or
  1479. <a href="http://www.slavasoft.com/fsum/">here</a>.</p>
  1480. <p>We strongly recommend that you verify your downloads with both PGP and MD5.</p>
  1481. </div>
  1482. </body>
  1483. </html>