--- ibx/trunk/changelog 2018/01/22 13:58:14 118 +++ ibx/trunk/changelog 2020/04/17 11:30:36 292 @@ -1,4 +1,363 @@ -IBX Change Log version (2.2-0) Sat, 20 Jan 2018 12:09:59 +0000 +IBX Change Log version (2.3-4 Build 12031) Fri, 17 Apr 2020 11:21:22 +0100 + +1. TIBXDataSet and Generators: Generator Names that are not all upper case or + not SQL Identifiers are now supported. + +2. TIBXScript: Set Generator is no longer rejected as unrecognised SQL and is + passed to the Firebird engine for execution. + +3. TIBDataSet: Unidirectional datasets now give an error message if an attempt + is made to scroll back. + +4. New unit: IBMessages.pas. Contains only messages used by IBX and not FBIntf + +5. TIBLookupComboEditBox: When generating auto-complete SQL, the ListField is now + only enclosed in double quotes in SQL dialect 3 and when it needs to be. + +6. TIBLookupComboEditBox: when the list source opens, the ListField name is now + validated. If no match is found in the list of field names and the database has + been opened in SQL Dialect 3, then the ListField Name is converted to upper case + if it then matches a field name. Otherwise, a Listfield not valid exception occurs. + +7. IBGeneratoreditor.pas: Add missing parenthesis around "IS" statement for compliance + with fpc 3.2. + +IBX Change Log version (2.3-3 Build 11512) 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. + Uses "FindParam" if in order to find out if a parameter with a given name exists + and without raising and exception if it does not. + +9. TIBQuery now uses IBX SQL Parser instead of the 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. + +11. IBEvents: removing a TIBEvent component from a form should no longer result in + an IDE exception. + +12. LocalDBSupport: initial database creation should now work correctly + when the schema source is an sql file. + +13. TIBCMLocalDBSupport: new event handler "property OnProgressEvent: TOnProgressEvent" + when defined, this handler will be called by the internal TIBXScript during + initial database creation when the schema source is an sql file and may be used + to provide a visual indication of progress in console mode. + +14. TCustomIBLocalDBSupport: new public property "InOnCreateDB: boolean". This is set + to true while a new local database is being created and its schema populated. + Useful in (e.g.) TIBDatabase.OnAfterConnect handler to suppress actions + when the database is disconnected/connected during the create DB procedure. + +15. TIBXScript: any User/password parameters found in a CREATE DATABASE statement + are now always ignored and replaced by the user name and password provided as + the login parameters for the TIBDatabase referenced from the TIBXScript. The + IgnoreCreateDatabase property still applies and the CREATE DATABASE statement is + completely ignored if this property is true. + +16. Code tidyup in IBTreeView: Node properties initialisation moved from TIBTreeView.AddNodes + to TIBTreeView.Added. An OnAddition event handler is no longer needed to initialise + ImageIndex and SelectImageIndex values on AddNode. + +17. TIBDatabase.Attachment and TIBXServicesConnection.ServicesIntf properties are now + read/write. This should enabled (e.g.) multiple instances of TIBDatabase to share + the same database connection. + +18. TIBDataSet and TIBQuery now support the TDataSet "Filter" property. + if provided, this should be an conditional SQL expression suitable for + including in an SQL Select statement "where" clause. If non-empty and the + "Filtered" property is true then the SQL expression provided as the value of + the "Filter" property is "ANDed" with any existing condition statement + in the SQL statement's "Where" clause. + + If the "Filter" property is set at run time, the "Filtered" property is true + and the dataset is already open, then the dataset is closed and re-opened automatically. + + The "Filter" condition may include IBX style parameters. In which case, their + value must be set by the dataset's "OnBeforeOpen" event handler. + + This is a public property for TIBDataSet and TIBQuery query and intended for + use at run time. + + Note: The property is a published property of TIBTable. The TIBTable functionality + is unaffected by this change. + +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,7 +374,7 @@ 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. @@ -75,13 +434,116 @@ IBX Change Log version 15. TIBXScript: turn off database login prompt when reconnecting - this avoids prompting for password on reconnect. -16. IBDatabase: use IAttachment for connection default character set id, code page +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. +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