--- ibx/trunk/changelog 2016/12/06 10:33:46 45 +++ ibx/trunk/changelog 2018/04/16 08:32:21 231 @@ -1,7 +1,502 @@ +IBX Change Log version (2.3-0) Sat, 14 Apr 2018 16:47:40 +0100 -IBX Change Log version (2.0-0) Tue, 06 Dec 2016 10:33:44 +0000 +IMPORTANT: the source code tree has been re-organised for IBX 2.3. Please remove +all previous copies of the IBX source code tree before installing this release. -See also doc/readme.upgrade-4-x.to.2-0-0.xhtml for important information on +The IBX packages used by most users have not changed, with one exception. The +IBServices unit has been moved to the package iblegacyServices.lpk. To continue +to use the IBServices unit in your applications, please add the iblegacyServices +to the list of dependencies. To do this, open the Project Inspector and select +Add->New Requirement and select "ibLegacyServices" from the list of available +packages. + +1. New unit IBXServices. The IBXServices unit is a re-architectured update of + the IBServices unit providing what is intended to be a clearer and easier to + use set of IB Services components. See Chapter 10 of the IBX User Guide for + more information and the guide to "Firebird Service Management Using IBX". + As indicated above, the legacy services components are still available and + provided in a separate package. There is no need to update working applications + using the older versions except for an additional package dependency. + +2. The IBX packages and source code tree have been re-organised in an attempt to + finally get rid of the "duplicate ppu" warnings. This re-organisation should + not affect existing users. Section 2.3 of the IBX User Guide describes the + new set of IBX packages. + +3. The ibx/examples/DBAdmin and the ibx/examples/services example have been + updated to use the new Services API components. + +4. The iblocal package has been updated to use the new Services API components. + +5. procedure SetAutoAdmin; in the new IBX Services this method is now a member of + TIBXSecurityService. It had been wrongly classified in the previous version + as a per database configuration item. It is global to a server and hence + correctly positioned as part of the Security Package. In the DBAdmin example, + the setting has moved to the mappings page. + +6. TIBXScript: IgnoreCreateDatabase added. If true then CREATE DATABASE statements + are ignored. + +7. TIBDatabase: DropDatabase now ensures that all transactions have been properly + closed before the database is dropped. Before and After Disconnect event handlers + are also fired. + +8. TIBTransaction: OnStartTransaction event now fires every time the transaction + is started and not just the first time. + +9. IBDataOutput: Use FormatFloat for all performance statistics to avoid platform + depenendency with comp type. + +10. IBDataOutput: select query data output is now sent to stdout instead of stderr. + +11. TIBDatabase: Remove regression. If a user login dialog changes the DatabaseName + then this is recognised and not ignored. + +12. TIBDataSet, TIBQuery, TIBTable: additions: + function GetRowsAffected(var SelectCount, InsertCount, UpdateCount, DeleteCount: integer): boolean; + function GetPerfStatistics(var stats: TPerfCounters): boolean; + property EnableStatistics: boolean read FEnableStatistics write SetEnableStatistics; + + GetRowsAffected returns the affected row counts from the last insert/update/delete + if EnableStatistics = true then GetPerfStatistics returns the current stats + counters for the select query. Note: stats accumulate after each fetch from + the database. To get total query cost after open, call the "Last" method + and then GetPerfStatistics. + + See ibx/examples/consolemode for an example of the use of GetPerfStatistics + +13. TIBExtract: Identity columns DDL. "Start with clause" now correctly encapsulated + in parenthesises. + +14. TIBExtract: new published property "AlwaysQuoteIdentifiers". If true then in dialect 3 + SQL identifiers are always delimited by double quotes. If false, then they are + only delimited if the identifier is a reserved word, contains lower case or special + characters. Set this property to true to retain previous behaviour. + +15. Insert SQL Property Editor. In Insert Returning Clause, Identity column names + are now inserted in double quotes if not Reserved Words or valid SQL Identifiers. + +16. TIBDataSet, TIBQuery, TIBTable: addition: + property MasterDetailDelay: integer {defaults to zero} + + When non-zero and the dataset is a detail table referencing a master table + through either a MasterSource (TIBTable) or a DataSource (TIBDataSet, TIBQuery) + then a synchronisation delay is added (in milliseconds) between the master + row changing and the detail dataset being re-opened. If the master dataset + is scrolled before the delay expires then the delay is reset. This can be used + to avoid performance overheads when scrolling through a large master dataset. + + Note: uses fptimer and hence requires a thread manager. Under Linux the + chreads unit must be included in your project. TTimer is not used in order + to avoid an LCL dependency. Requires FPC 3.0.2 or later. + +17. TIBExtract: User role grants now excluded when etGrantsToUser not specified + with Extract Option eoDatabase. + +18. TIBLookupComboEditBox: Workaround added for https://bugs.freepascal.org/view.php?id=33428 + When a deLayoutChanged event is reported on the ListSource dataset, the + combobox text is updated. This allows a listsource (detail) to be in a Master/Detail + relationship with the control's datasource (master). + +19. TIBExtract: Full BigInt value range now supported for Generators/Sequences. + +20. TIBExtract: Select Procedures (Procedure type 1) now include "SUSPEND;" clause in their + stubs. Pedantic fix really, as procedures output in dependency order anyway. + +21. TIBExtract: Package Headers and Package Bodies are now included in the extracted + DDL (Firebird 3 and later only). + +22. TIBLookupComboBox Autocomplete Fixes: + i. Only appended text is now selected after autocomplete. + ii. Uppercase keys no longer ignored for autocomplete. + iii. Retain Prefix case is now honoured correctly. + iv. When a DataSource is assigned, typing after autocomplete now extends prefix + before autocomplete performed. i.e. behaviour now the same as when + no DataSource assigned. + +23. TIBXScript: Single Line Comments starting with '--' are now ignored when occurring + between SQL statements. + +24. TIBExtract: New published property CaseSensitiveObjectNames. If false (default) then + ObjectNames are converted to upper case before matching against metadata object + names, unless the objectname is delimited by double quotes, in which case, the + double quotes are removed and the remaining string is used (unmodified) to match + against the metadata object name. + + If true then the ObjectName is used as is without modification and matched + against the metadata object name. No attempt is made to remove double quotes. + +25. TIBExtract: New Extract Types: etDatabaseTriggers and etDDLTriggers. When used + with eoTrigger, these extract types can be used to select only Database Triggers, + or DDL Triggers or both. Ignored when etTable or etTrigger included in Extract Types. + +26. TIBXScript: If an exception occurs during the processing of a statement, the + statement separate character is now reset to the default (';'). + +27. TIBDatabase: Reconnect method added and used by TIBXScript for reconnect. + +28. TIBXScript: Transaction is no longer automatically reactivated immediately processing + a commit or reconnect statement and instead activated only when next SQL statement + is executed. + +29. TIBSQL.HasField should no longer generate and exception when the field does not exist. + +30. TIBXScript: case insensitive regex now used when matching statements instead of + converting statement to upper case. + +31. TIBExtract: metadata comments now supported. New published property + IncludeMetaDataComments (default true). If true then metadata comments included + in extracted DDL. New Extract Object member eoComments. This may be used with + ExtractObject method to list all metadata comments. + +32. TIBExtract: ListObjectNames method added. + +33. Updated Database component editor to support additional connection string + types. + +IBX Change Log version (2.2-0) Wed, 28 Feb 2018 10:57:45 +0000 + +NOTE: THE LOCATIONS OF SOME OF THE UNIT DIRECTORIES HAS CHANGED FROM IBX 2.1. THIS IS TO +AVOID DUPLICATE PPU WARNINGS. PLEASE REMOVE EARLIER VERSIONS OF IBX BEFORE INSTALLING THIS +RELEASE. + +NOTE: THE DBADMIN DEMO REQUIRES THAT THE MemDSLaz PACKAGE IS INSTALLED IN THE LAZARUS IDE. + +1. IBExtract: Identity columns - add additional check for null column for generator name. + +2. IBCustomDataSet: Insert and Modify (Update) queries now recognise and process SQL RETURNING clauses. + The main use for this is for Firebird 3 Identity columns (see IBXDocumentation 6.6.8 for further + information). However, this is also a very useful mechanism for returning updated computed by + column values. Values returned as a result of executing an Insert or Update statement + replace existing values in the current row for each corresponding column. + + Previously, if a dataset's select query included read only (computed by) fields then + an automatic row refresh was performed after an insert or update query had been processed, + irrespective of the setting of the "ForcedUpdates" property. This has changed such + that an automatic refresh is no longer performed if an insert or update query contains + a returning clause that updates one or more fields on the current row. A full row + refresh is only performed if (a) ForcedRefresh is true or (b) the query does not return any + field values and the select query contains read only fields. Use of Insert/update + returning should be significantly more efficient than executing a refresh query. + + This behaviour change is intended to be backwards compatible and there should be no need to change + existing programs, other than to improve performance by using the new capability. + +3. IBCustomDataSet: DELETE...RETURNING queries are now also recognised. However, as + they are called when the dataset row is being deleted, there is no value in + updating the current record from the query result. Instead, a new event handler + "OnDeleteReturning" is provided. If a DELETE...RETURNING query is execute and + an OnDeleteReturning event handler is provided then it is called with the IResults returned + by the query. The event handler can then interrogate the query results and + perform whatever action is necessary. For example to confirm, to the user, + the deletion of a row with the returned values. + +4. TIBTable: generated Insert and Update SQL now include a RETURNING clause for + any Computed By or Identity Columns. The IBTables example has been updated to + illustrate the computation of the employee Full Name on update. + +5. TIBTable: The GeneratorField property is now published. + +6. The InsertSQL property editor now shows Firebird 3 Identity columns separate from the Field List. + When InsertSQL is generated, the Identity columns are not included in the list of values to + be inserted. A RETURNING clause is added to the insert statement to return the value of + each Identity column after the insert is executed. + +7. The Modify Property Editor now generates Update SQL with Computed By fields in Update..Returning clause. + Similarly Insert Property Editor now generates Insert SQL with Computed By fields in + Insert..Returning clause. + +8. TIBGenerator: small performance improvement by not preparing query each time + a new value is generated. + +9. TIBSQL: Free resources when transaction changed - ensures new transaction is used. + +10. Property editors will now sync table name to a System Table when "Include System + Tables" is selected and the query is for a System Table. + +11. Minor Performance improvement to handling of Date/Time types in IBX datasets. Field + values are no longer converted to milliseconds from TDateTime and then back again + to TDateTime (the conversion to milliseconds is the default TDataset approach). + +12. Property Editors handling of Stored Procedures. + * Select and Refresh: only show a list of stored procedures that return multiple rows (proc type 1) and + which have a non-empty list of output parameters (i.e. stored procedures that may be used in a select + query). + * Modify and Insert: only show a list of stored procedures that return at most a singleton row (proc type 2). + +13. IBStoredProc: Now supports Firebird 3 Package Names. A new published property PackageName + can be used to select a package. If non-empty, the stored procedure name is + expected to be a stored procedure defined in the specified package and the + generated SQL will be as required for a stored procedure located in a package. + +14. Select, Refresh, Insert, Modify, Delete and TIBSQL SQL Property Editors now include + a "Package Name" drop down box to allow selection of a Firebird 3 Package from + which a stored procedure can be selected. With no package name selected, non-package + stored procedures are listed. + +15. TIBXScript: turn off database login prompt when reconnecting - this avoids prompting + for password on reconnect. + +16. TIBDatabase: use IAttachment for connection default character set id, code page + and character set name. + +17. TIBDatabaseInfo: cache ODS Version information on first request in order to minimise + DB info lookups" + +18. IBExtract: now supports DDL Triggers and Grants to DDL objects. + +19. Add a property Editor for TIBUpdate.RefreshSQL. + +20. IBUpdate: Ignore non-data (e.g. calculated) fields when assembling list of input + parameters. This stops an exception being raised when the field cannot be + located in the record buffer. + +21. Property Editors now automatically include System Tables when opened and when the query table + is a System Table. + +22. IBServices: SQRB and SRB buffers are now reset when service query throws an exception. + This avoids errors due to a stale SQRB or SRB being used for the next query. + +23. IBServices: Service attach parameters now include "expected_db". This is used to + add the SPB item isc_spb_expected_db. This names a database using + an alternative Security Database (FB3 onwards) and allows (e.g. backup/restore) using such a + database. examples/services re-written to illustrate use of "expected_db". + +24. IBServices: TIBControlAndQueryService.WriteNextChunk no longer ignores isc_info_svc_timeout. + This avoids truncated backups when the server returns a timeout (busy) response. + +25. TIBDatabase: isc_dpb_page_size now supported as a database parameter when using TIBDatabase.CreateDatabase. + +26. TIBDatabase: DatabaseName property may now be prefixed by $TEMP$ or $DATADIR$ for local + databasenames. These are respectively expanded to the local system's temp directory + (including trailing delimiter) or to a prescribed data directory (including + trailing delimiter). Under Unix systems the data directory is a hidden directory + in the user's home directory. The hidden directory name is either the string returned + from the SysUtils "Vendor Name" or "IBX" if empty. In either case prefixed by a '.'. + Under Windows, the directory is the same as the Data Directory as decribed + above but instead prefixed by the User's application data path. These may be + used to improve application portability for Personal Databases. + +27. TIBTable: FieldDefs property is no longer published. Due to the use of TIBFieldDef + this has not worked for a long time and is not useful either. FieldDefs should be + managed using the Fields Editor as with any other dataset. To access the fields + editor for a TIBTable component, double click on the component. The fields editor + is then displayed. + +28. TIBDatabaseInfo: new properties/function + * DateDBCreated (returns date/time database created) + * TransactionCount (returns no. of active transactions) + * GetDatabasePage(PageNo: integer) (returns contents of specified database page - SYSDBA only). + * PagesFree (Firebird 3 or later) + * PagesUsed (Firebird 3 or later) + * Encrypted (returns true if database encrypted. (Firebird 3.0.3 or later only) + * EncryptionKeyName (returns the name of the encryption key if any (Firebird 3.0.3 or later only) + +29. IBServices classes now provided the decoded release number in the (array) property ServerVersionNo. + +30. TIBSecurityService now supports display/modification of the User Admin Role (Firebird 2.5 and later). + +31. TIBConfigService now has a procedure SetAutoAdmin(Value: boolean) to enable/disable + the automtic mapping of privileged OS users to the RDB$ADMIN role (Firebird 2.5 and later). + +32. TIBBackupService: New Option - NoDBTriggers equivalent to -nodbtriggers switch introduced + in the gbak utility at V.2.1 to prevent database-level and transaction-level triggers from + firing during backup and restore. + +33. Both TIBBackupService and TIBRestoreService now support backup/restore statistics options + for verbose output using the new property "StatisticsRequested". + see https://firebirdsql.org/file/documentation/release_notes/html/en/2_5/rnfb25-util-gbak.html#rnfb25-util-gbakstats + +34. TIBRestoreService: now supports new options RestoreMetaDataOnly (Firebird 2.5 and later). + +35. TIBOnlineValidationService component added to the IBServices and the "Firebird Admin" + palette. This uses the online validation feature added in Firebird 2.5. The + services's properties enable inclusion/exclusion of tables and indexes using + regular expressions. See. + https://firebirdsql.org/file/documentation/release_notes/html/en/2_5/rnfb25-apiods-api.html#rnfb25-apiods-api-onlinevalidation + +36. IBServices: procedure TIBConfigService.SetNoLinger added to set no linger + option on a database. + +37. TIBCustomService: Assign method implemented to allow copying of service login + context between service API components. "Detach" method now only detaches + service when last reference to the service interface detaches. Tidy up of + code for SetActive and Attach methods including password hiding. + +38. TIBDatabase: new properties: AuthenticationMethod and RemoteProtocol. Read only + and used to determine the auth method and protocol used for the connection. + +39. TIBDatabase: ensure that SQLDialect setting is used when creating a database using + a Create Database Statement generated by IBX. + +40. All IBServices now have an additional published property "PortNo". This may + be set to a non-standard port number when necessary. If zero then the default + port number is used. + +41: TIBLookupComboeditBox: Ensure dataset updated when change selected with the keyboard + and not just the mouse. + +42. TIBCustomDataset: reopen query if already active when a TIBControlLink is added. + +43. TIBTreeview: new ImageIndexField and SelectedIndexField Property allows the + image index and selected image index for each node to be set from a database field. + +44. TIBExtract: new extract type (etGrantsToUser) for use with eoDatabase. If included + then database schema includes grants to all users. If not present then the + only user grants included are those to User PUBLIC. + +45. TIBTreeView: performance improvement. When expanding include both expanded node + and child nodes in dataset. + + +IBX Change Log version (2.1-0) Fri, 15 Dec 2017 12:20:11 +0000 + +1. IBCustomDataset: Minor change of PChar to PByte for compatibility with fbintf + changes. + +2. IBCustomDataset: Fixed use of incorrect datasize in TIBStringField.SetAsString. + Bug could result in truncated multi-byte character set values. + +3. Changes consequential on moving fbintf character set utility functions from + IFirebirdAPI to IAttachment. + +4. Avoid "Object is nil" error when opening a database with DefaultSystemCodePage = true + +5. IBLookupComboEditBox: avoid race condition when autocompleting text that occasionally + results in autocomplete ignoring prefix text. + +6. IBLookupComboEditBox: Ensure that cursor is not reset to start of text when + entering a new name into the text box. + +7. IBCustomDataset: ensure that TIBStringField uses the field size reported by + Firebird rather than recomputing it. + +8. Property Editor positioning tidy up: All IBX Property editors should now be + screen centre. Previously some were "poDesigned" which may be inappropriate + for multi monitor desktops. + +10. TIBTreeView.FindNode: protect against error if zero length path or empty tree node. + +11. TIBTransaction: On Force Disconnect do not raise an exception when problem ending + a transaction and always reset the object. + +12. TIBQuery tidyup: remove unnecessary call to GetAffectedRows. + +13. TIBXScript: Allow for override of database filename in Create Database statements. + +14. IBLocaldb: Support initialisation of the database from an SQL script in addition + to a gbak format archive. + +15. IBLocaldb: fix problem that stopped the OnSharedDataDir event from being recognised. + +16. IBLocaldb: Drop database if error creating an empty database. + +17. TIBTreeView: improve performance when selecting node - avoid refreshing dataset + unless selected node not in current dataset. + +18. IBServices: SetDBParams method moved from TCustomIBLocalDBSupport (in IBLocalDB package) + to TIBCustomService, and IBlocalDB code tidy up. + +19. IBTreeView: Initialise TIBTreeNode KeyValue to null to avoid unpredictable + behaviour due to uninitialised variable. + +20. IBServices: Correct encoding of isc_spb_prp_write_mode in TIBConfigService from + integer to byte. Ditto isc_spb_prp_reserve_space and isc_spb_prp_access_mode. + +21. IBSQL: When Database changed ensure that all resources are freed. + +22. IBCustomDataset: When database changed ensure that queries an unprepared. + +23. SQL Property Editors now use SynEdit with SQL Highlighter. New features include: + * Line Wrap on SQL Token boundaries (on user command) + * auto-complete table names in drop down list of table names + * Double click on tablename or field name adds to SQL text + +24. IBDataOutput: print statistics using float (%f) format instead of decimal (%d). + +25. IBTreeView: Call to FindNode: param type change from "array of Variant" to + TVariantArray. Seems to avoid memory corruption in Windows (probably a + workaround for a problem in fpc 3.0.4 win64). + +26. IBDatabaseInfo: Code tidy up. Add check for database not assigned or not open. + +27. IBDatabaseInfo: Remove memory leak when accessing database operation counts. + +IBX Change Log version (2.0-2) Fri, 24 Feb 2017 12:17:53 +0000 + +1. TIBDatabase.CreateDatabase: extract full DB Name from SQL using reg ex in order to + include remote system name. + +2. TIBExtract: No longer include comment header and COMMIT statement for empty + tables when data included in output. + +3. Profiling: IBSQL now has conditional compilation flags to enable query performance + and timing information to be written to stdout. This may be used to locate + performance bottlenecks. + +4. SQLParser: only call "OnChanging" event handler when value is different. + +5. IBDynamicGrid: Update handling of navigation keys for a TDateEdit + +6. IBCustomDataset: Set internalunprepared flag when transaction ends. This ensures + that BindFields is called when the query is next activated. Avoids FieldName + not found error. + +7. IBUpdate: This is a new IBX component similar to TIBUpdateSQL. It is more general + purpose and allows the programmer to define any action they want for Update, Insert + or Delete. This may be complex SQL (similar to a Trigger), application specific + filtering of updates, or use of statements such as Grant or Revoke instead of + normal DML. See User Manual for more information. + +IBX Change Log version (2.0-1) Mon, 09 Jan 2017 15:31:49 +0000 + +1. TIBEvents: Fix uninitialised variable that could result in lost events. + +2. TIBExtract: Added support for FB3 "USAGE" privilege. + +3. TIBExtract: data formatted as Charset set "octets" is now output using + hexadecimal notation. + +4. TIBExtract: Binary Blobs and array data can now be embedded in INSERT statements + using a simple XML format. + +5. TIBExtract: extract of individual Triggers and Stored Procedures can now include + grants to these objects. + +6. TIBExtract: Stored Procedures and Views output in dependency order to avoid + dependency problems restoring complex databases. + +7. TIBXScript: This component has been restructured to allow for the processing of + embedded XML in INSERT statements and to support interactive sources in addition + to non-interactive data sources such as files. + +8. TIBXScript: CREATE DATABASE, DROP DATABASE, CONNECT statements are now supported. + +9. TIBXScript: ISQL compatiable Set statements are now supported: + SET SQL DIALECT + SET TERM + SET AUTODDL + SET BAIL + SET ECHO + SET COUNT + SET STATS + SET NAMES + +10. IBVersion unit added to hold current IBX Version Number information. + +11. TIBExtract: Use character rather than byte length for VarChar procedure arguments., + and domain definitions. + +12. TIBExtract: Triggers now use SQL2003 syntax and database and transaction triggers + fully supported. + +13. TIBExtract: when a database dump includes data, the generator values are now also set. + +14: IBSQLEdit: Unit LCLPlatformDef added to uses clauses for lazarus 1.7 and later. + +IBX Change Log version (2.0-0) Tue, 06 Dec 2016 10:33:44 +0000 + +See also doc/IBX4LazarusGuide.pdf for important information on upgrading to IBX2. 1. Size property of TIBStringField is now the width in characters of the field