--- ibx/trunk/changelog 2018/01/18 14:37:40 107 +++ ibx/trunk/changelog 2019/01/18 11:10:37 270 @@ -1,4 +1,287 @@ -IBX Change Log version (2.2-0) Mon, 15 Jan 2018 23:43:19 +0000 +IBX Change Log version (2.3-3 Build 11336) Fri, 28 Dec 2018 10:04:17 +0000 + +1. New property for TIBDatabase and TIBXServicesConnection. This is "ConfigOverrides" + and is used to override the default settings in the client side "firebird.conf" This + includes "WireCompression" and "WireCrypt". The value of this property is a "TStrings". + Each line of the string list should be a setting in the same format as "firebird.conf". + For example "WireCompression = true" in order to request wire compression on the client side. + + Note: explicit settings in the client side "firebird.conf" appear to take precedence + over settings given in TIBDatabase and TIBXServicesConnection. Many client side settings + also require a compatible setting in the server side "firebird.conf". For example + "WireCompression = true" must also be set in the server's "firebird.conf" for wire + compression to be used. + + Whether or not WireCompression or WireCrypt are in use can be checked using the information + returned with the Client/Server protocol version. See ibx/examples/dbadmin and + ibx/examples/dbinfo for examples of how to display this information. + +2. New property for TIBDatabase and TIBXServicesConnection: "WireCompression". This + is a "convenience" property. If set the "WireCompression=true" is added to the + ConfigOverrides. If unchecked then this setting is removed. + +3. TIBExtract: 64-bit integer types are now correctly extracted as "BIGINT" and + not "INT64". + +4. New published properties for TIBCSVDataOut, TIBInsertStmtsOut and TIBBlockFormatOut + These are: + property TimestampFormat: string; + property DateFormat: string; + property TimeFormat: string; + + Respectively, these provide the date time format templates for SQL types: TIMESTAMP, + DATETIME and TIME. The format strings use the standard FPC date/time format + characters (see https://www.freepascal.org/docs-html/rtl/sysutils/formatchars.html). + + If any of the above properties are set to an empty string, then the locale default + is used. This uses the ShortDateFormat and the LongTimeFormat. In timestamp, the + locale default is extended by appending '.zzz' to include milliseconds. + + TIBCSVDataOut by default sets these properties to the empty string, while the other + two use: 'yyyy.mm.dd hh:nn:ss.zzz', 'yyyy.mm.dd' and 'hh:nn:ss.zzz' respectively. + +5. New published property for TIBCSVDataOut: + property QuoteStrings: boolean (default true) + + If false then strings are unquoted, otherwise, the QuoteChar property value is + used to delimit each and every string in the output. + +6. New published properties for TIBCSVDataOut: + property FieldSeparator: string; + property HeaderSeparator: string; + + Respectively, these provide the separator character(s) used to separate fields + in data and header rows. Both default to ','. + +7. New published properties for TIBCSVDataOut and TIBBlockFormatOut: + TOnFormatTextString = procedure(sender: TObject; var TextString: string) of object; + property OnFormatTextString; + + This event handler can be used to process text strings before they are included + in the output e.g. to replace unprintable characters with alternative strings. + This only applies to columns with an SQL Type of SQL_VARYING and SQL_TEXT. + +8. TIBDataSet now raises an exception when ParamByName called with an invalid parameter name. + +9. TIBQuery now uses IBX SQL Parser instead of TParams SQL parser in order to ensure + consistency with SQL queries. + +10. CaseSensitiveParameterNames property added to TIBSQL, TIBDataSet and TIBQuery. + When true, SQL statement parameter names are parsed case sensitive. Note for + TIBDataSet only applies to Select query. + +IBX Change Log version (2.3-2) Wed, 05 Dec 2018 12:19:23 +0000 + +1. Remove need to check for IsMultiThread by providing access to GUI timers via + IBGUIInterface. Note: master/detail delay timer does not apply to console + mode apps. + +2. TIBCustomDataSet: SQLParser ignored if it does not contain a valid select + statement. This avoids problems if "Execute Block" is used as the Query. + +3. IBSQLParser now uses the common SQL tokeniser from fbintf. This replaces the + internal SQL tokeniser routines. + +4. IBSQLParser: new property NotaSelectStmt. Set to true if SQL fails to parse + as a select statement, with or without CTEs. + +5. IBSQLParser: parser now recognises the "ROWS" clause. + +6. TIBXScript now uses the common SQL tokeniser from fbintf. This replaces the + internal SQL tokeniser routines. + +7. Fix error in TIBXScript processing of "set" statements. This avoids exceptions + being raised for valid set statements processed by a data formatter. + +8. New published property for TIBDatabase and TIBXServicesConnection. This is + FirebirdLibraryPathName: string. If not empty it is used to explicitly specify + the path of the Firebird Library used by the database/services connection. + +9. New read only public property for TIBDatabase and TIBXServicesConnection. This + is FirebirdAPI and returns the IFirebirdAPI interface used by the database/ + services connection. + +10.SQL Property editors now quote parameter names if "Quote identifier" is selected + or param name is not a valid SQL identifier. + +11. IBLookupComboEditBox: In Lazarus 2.0, TDBLookupComboBox takes a more restrictive + view of whether the text box should be editable when no DataSource is specified. + TIBLookupComboEditBox has been updated to workaround this problem. As long as + ReadOnly is false, the text box is editable when no DataSource is specified. + +12. AllowUseOfFBLIB is now set to "true" at design time. This is to allow use of + the FBLIB environment variable. If you do not want to permit this then you + must modify the Register procedure in the design/IBDBReg.pas unit to remove + this setting. + +IBX Change Log version (2.3-1) Thu, 25 Oct 2018 14:39:45 +0100 + +1. IBCustomDataset: replace deprecated function ValidUTF8String with call to + Utf8EscapeControlChars + +IBX Change Log version (2.3-0) Mon, 16 Apr 2018 09:48:06 +0100 + +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. + +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. @@ -15,54 +298,177 @@ IBX Change Log version 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 excuting a refresh query. + 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. TIBTable: generated Insert and Update SQL now include a RETURNING clause for +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. -4. TIBTable: The GeneratorField property is now published. +5. TIBTable: The GeneratorField property is now published. -5. The InsertSQL property editor now shows Firebird 3 Identity columns separate from the Field List. +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. -6. The Modify Property Editor now generates Update SQL with Computed By fields in Update..Returning clause. +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. -7. TIBGenerator: small performance improvement by not preparing query each time +8. TIBGenerator: small performance improvement by not preparing query each time a new value is generated. -8. TIBSQL: Free resources when transaction changed - ensures new transaction is used. +9. TIBSQL: Free resources when transaction changed - ensures new transaction is used. -9. 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. +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. -10. Minor Performance improvement to handling of Date/Time types in IBX datasets. Field +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). -11. Property Editors handling of Stored Procedures. +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). -12. IBStoredProc: Now supports Firebird 3 Package Names. A new published property PackageName +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. -13. Select, Refresh, Insert, Modify, Delete and TIBSQL SQL Property Editors now include +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