ViewVC Help
View File | Revision Log | Show Annotations | Download File | View Changeset | Root Listing
root/public/ibx/trunk/changelog
(Generate patch)

Comparing ibx/trunk/changelog (file contents):
Revision 90 by tony, Mon Jan 1 11:31:34 2018 UTC vs.
Revision 267 by tony, Fri Dec 28 10:44:23 2018 UTC

# Line 1 | Line 1
1 + IBX Change Log  version (2.3-3 Build 11288) Fri, 28 Dec 2018 10:04:17 +0000
2 +
3 + 1. New property for TIBDatabase and TIBXServicesConnection. This is "ConfigOverrides"
4 +   and is used to override the default settings in the client side "firebird.conf" This
5 +   includes "WireCompression" and "WireCrypt". The value of this property is a "TStrings".
6 +   Each line of the string list should be a setting in the same format as "firebird.conf".
7 +   For example "WireCompression = true" in order to request wire compression on the client side.
8 +
9 +   Note: explicit settings in the client side "firebird.conf" appear to take precedence
10 +   over settings given in TIBDatabase and TIBXServicesConnection. Many client side settings
11 +   also require a compatible setting in the server side "firebird.conf". For example
12 +   "WireCompression = true" must also be set in the server's "firebird.conf" for wire
13 +   compression to be used.
14 +
15 +   Whether or not WireCompression or WireCrypt are in use can be checked using the information
16 +   returned with the Client/Server protocol version. See ibx/examples/dbadmin and
17 +   ibx/examples/dbinfo for examples of how to display this information.
18 +
19 + 2. New property for TIBDatabase and TIBXServicesConnection: "WireCompression". This
20 +   is a "convenience" property. If set the "WireCompression=true" is added to the
21 +   ConfigOverrides. If unchecked then this setting is removed.
22 +
23 + IBX Change Log  version (2.3-2) Wed, 05 Dec 2018 12:19:23 +0000
24 +
25 + 1. Remove need to check for IsMultiThread by providing access to GUI timers via
26 +   IBGUIInterface. Note: master/detail delay timer does not apply to console
27 +   mode apps.
28 +
29 + 2. TIBCustomDataSet: SQLParser ignored if it does not contain a valid select
30 +   statement. This avoids problems if "Execute Block" is used as the Query.
31 +
32 + 3. IBSQLParser now uses the common SQL tokeniser from fbintf. This replaces the
33 +   internal SQL tokeniser routines.
34 +
35 + 4. IBSQLParser: new property NotaSelectStmt. Set to true if SQL fails to parse
36 +   as a select statement, with or without CTEs.
37 +
38 + 5. IBSQLParser: parser now recognises the "ROWS" clause.
39 +
40 + 6. TIBXScript now uses the common SQL tokeniser from fbintf. This replaces the
41 +   internal SQL tokeniser routines.
42 +
43 + 7.  Fix error in TIBXScript processing of "set" statements. This avoids exceptions
44 +    being raised for valid set statements processed by a data formatter.
45 +
46 + 8. New published property for TIBDatabase and TIBXServicesConnection. This is
47 +   FirebirdLibraryPathName: string. If not empty it is used to explicitly specify
48 +   the path of the Firebird Library used by the database/services connection.
49 +
50 + 9. New read only public property for TIBDatabase and TIBXServicesConnection. This
51 +   is FirebirdAPI and returns the IFirebirdAPI interface used by the database/
52 +   services connection.
53 +
54 + 10.SQL Property editors now quote parameter names if "Quote identifier" is selected
55 +   or param name is not a valid SQL identifier.
56 +
57 + 11. IBLookupComboEditBox: In Lazarus 2.0, TDBLookupComboBox takes a more restrictive
58 +    view of whether the text box should be editable when no DataSource is specified.
59 +    TIBLookupComboEditBox has been updated to workaround this problem. As long as
60 +    ReadOnly is false, the text box is editable when no DataSource is specified.
61 +
62 + 12. AllowUseOfFBLIB is now set to "true" at design time. This is to allow use of
63 +    the FBLIB environment variable. If you do not want to permit this then you
64 +    must modify the Register procedure in the design/IBDBReg.pas unit to remove
65 +    this setting.
66 +
67 + IBX Change Log  version                 (2.3-1) Thu, 25 Oct 2018 14:39:45 +0100
68 +
69 + 1. IBCustomDataset: replace deprecated function ValidUTF8String with call to
70 +   Utf8EscapeControlChars
71 +
72 + IBX Change Log  version                (2.3-0) Mon, 16 Apr 2018 09:48:06 +0100
73 +
74 + IMPORTANT: the source code tree has been re-organised for IBX 2.3. Please remove
75 + all previous copies of the IBX source code tree before installing this release.
76 +
77 + The IBX packages used by most users have not changed, with one exception. The
78 + IBServices unit has been moved to the package iblegacyServices.lpk. To continue
79 + to use the IBServices unit in your applications, please add the iblegacyServices
80 + to the list of dependencies. To do this, open the Project Inspector and select
81 + Add->New Requirement and select "ibLegacyServices" from the list of available
82 + packages.
83 +
84 + 1. New unit IBXServices. The IBXServices unit is a re-architectured update of
85 +   the IBServices unit providing what is intended to be a clearer and easier to
86 +   use set of IB Services components. See Chapter 10 of the IBX User Guide for
87 +   more information and the guide to "Firebird Service Management Using IBX".
88 +   As indicated above, the legacy services components are still available and
89 +   provided in a separate package. There is no need to update working applications
90 +   using the older versions except for an additional package dependency.
91 +
92 + 2. The IBX packages and source code tree have been re-organised in an attempt to
93 +   finally get rid of the "duplicate ppu" warnings. This re-organisation should
94 +   not affect existing users. Section 2.3 of the IBX User Guide describes the
95 +   new set of IBX packages.
96 +
97 + 3. The ibx/examples/DBAdmin and the ibx/examples/services example have been
98 +   updated to use the new Services API components.
99 +
100 + 4. The iblocal package has been updated to use the new Services API components.
101 +
102 + 5. procedure SetAutoAdmin; in the new IBX Services this method is now a member of
103 +   TIBXSecurityService. It had been wrongly classified in the previous version
104 +   as a per database configuration item. It is global to a server and hence
105 +   correctly positioned as part of the Security Package. In the DBAdmin example,
106 +   the setting has moved to the mappings page.
107 +
108 + 6. TIBXScript: IgnoreCreateDatabase added. If true then CREATE DATABASE statements
109 +   are ignored.
110 +
111 + 7. TIBDatabase: DropDatabase now ensures that all transactions have been properly
112 +   closed before the database is dropped. Before and After Disconnect event handlers
113 +   are also fired.
114 +
115 + 8. TIBTransaction: OnStartTransaction event now fires every time the transaction
116 +   is started and not just the first time.
117 +
118 + 9. IBDataOutput: Use FormatFloat for all performance statistics to avoid platform
119 +   depenendency with comp type.
120 +
121 + 10. IBDataOutput: select query data output is now sent to stdout instead of stderr.
122 +
123 + 11. TIBDatabase: Remove regression. If a user login dialog changes the DatabaseName
124 +    then this is recognised and not ignored.
125 +
126 + 12. TIBDataSet, TIBQuery, TIBTable: additions:
127 +    function GetRowsAffected(var SelectCount, InsertCount, UpdateCount, DeleteCount: integer): boolean;
128 +    function GetPerfStatistics(var stats: TPerfCounters): boolean;
129 +    property EnableStatistics: boolean read FEnableStatistics write SetEnableStatistics;
130 +
131 +    GetRowsAffected returns the affected row counts from the last insert/update/delete
132 +    if EnableStatistics = true then GetPerfStatistics returns the current stats
133 +    counters for the select query. Note: stats accumulate after each fetch from
134 +    the database. To get total query cost after open, call the "Last" method
135 +    and then GetPerfStatistics.
136 +
137 +    See ibx/examples/consolemode for an example of the use of GetPerfStatistics
138 +
139 + 13. TIBExtract: Identity columns DDL. "Start with clause" now correctly encapsulated
140 +    in parenthesises.
141 +
142 + 14. TIBExtract: new published property "AlwaysQuoteIdentifiers". If true then in dialect 3
143 +    SQL identifiers are always delimited by double quotes. If false, then they are
144 +    only delimited if the identifier is a reserved word, contains lower case or special
145 +    characters. Set this property to true to retain previous behaviour.
146 +
147 + 15. Insert SQL Property Editor. In Insert Returning Clause, Identity column names
148 +    are now inserted in double quotes if not Reserved Words or valid SQL Identifiers.
149 +
150 + 16. TIBDataSet, TIBQuery, TIBTable: addition:
151 +       property MasterDetailDelay: integer {defaults to zero}
152 +
153 +    When non-zero and the dataset is a detail table referencing a master table
154 +    through either a MasterSource (TIBTable) or a DataSource (TIBDataSet, TIBQuery)
155 +    then a synchronisation delay is added (in milliseconds) between the master
156 +    row changing and the detail dataset being re-opened. If the master dataset
157 +    is scrolled before the delay expires then the delay is reset. This can be used
158 +    to avoid performance overheads when scrolling through a large master dataset.
159 +
160 +    Note: uses fptimer and hence requires a thread manager. Under Linux the
161 +    chreads unit must be included in your project. TTimer is not used in order
162 +    to avoid an LCL dependency. Requires FPC 3.0.2 or later.
163 +
164 + 17. TIBExtract: User role grants now excluded when etGrantsToUser not specified
165 +    with Extract Option eoDatabase.
166 +
167 + 18. TIBLookupComboEditBox: Workaround added for https://bugs.freepascal.org/view.php?id=33428
168 +    When a deLayoutChanged event is reported on the ListSource dataset, the
169 +    combobox text is updated. This allows a listsource (detail) to be in a Master/Detail
170 +    relationship with the control's datasource (master).
171 +
172 + 19. TIBExtract: Full BigInt value range now supported for Generators/Sequences.
173 +
174 + 20. TIBExtract: Select Procedures (Procedure type 1) now include "SUSPEND;" clause in their
175 +    stubs. Pedantic fix really, as procedures output in dependency order anyway.
176 +
177 + 21. TIBExtract: Package Headers and Package Bodies are now included in the extracted
178 +    DDL (Firebird 3 and later only).
179 +
180 + 22. TIBLookupComboBox Autocomplete Fixes:
181 +    i. Only appended text is now selected after autocomplete.
182 +    ii. Uppercase keys no longer ignored for autocomplete.
183 +    iii. Retain Prefix case is now honoured correctly.
184 +    iv. When a DataSource is assigned, typing after autocomplete now extends prefix
185 +        before autocomplete performed. i.e. behaviour now the same as when
186 +        no DataSource assigned.
187 +
188 + 23. TIBXScript: Single Line Comments starting with '--' are now ignored when occurring
189 +    between SQL statements.
190 +
191 + 24. TIBExtract: New published property CaseSensitiveObjectNames. If false (default) then
192 +    ObjectNames are converted to upper case before matching against metadata object
193 +    names, unless the objectname is delimited by double quotes, in which case, the
194 +    double quotes are removed and the remaining string is used (unmodified) to match
195 +    against the metadata object name.
196 +
197 +    If true then the ObjectName is used as is without modification and matched
198 +    against the metadata object name. No attempt is made to remove double quotes.
199 +
200 + 25. TIBExtract: New Extract Types: etDatabaseTriggers and etDDLTriggers. When used
201 +    with eoTrigger, these extract types can be used to select only Database Triggers,
202 +    or DDL Triggers or both. Ignored when etTable or etTrigger included in Extract Types.
203 +
204 + 26. TIBXScript: If an exception occurs during the processing of a statement, the
205 +    statement separate character is now reset to the default (';').
206 +
207 + 27. TIBDatabase: Reconnect method added and used by TIBXScript for reconnect.
208 +
209 + 28. TIBXScript: Transaction is no longer automatically reactivated immediately processing
210 +    a commit or reconnect statement and instead activated only when next SQL statement
211 +    is executed.
212 +
213 + 29. TIBSQL.HasField should no longer generate and exception when the field does not exist.
214 +
215 + 30. TIBXScript: case insensitive regex now used when matching statements instead of
216 +    converting statement to upper case.
217 +
218 + 31. TIBExtract: metadata comments now supported. New published property
219 +    IncludeMetaDataComments (default true). If true then metadata comments included
220 +    in extracted DDL. New Extract Object member eoComments. This may be used with
221 +    ExtractObject method to list all metadata comments.
222 +
223 + 32. TIBExtract: ListObjectNames method added.
224 +
225 + 33. Updated Database component editor to support additional connection string
226 +    types.
227 +
228 + IBX Change Log  version  (2.2-0) Wed, 28 Feb 2018 10:57:45 +0000
229 +
230 + NOTE: THE LOCATIONS OF SOME OF THE UNIT DIRECTORIES HAS CHANGED FROM IBX 2.1. THIS IS TO
231 + AVOID DUPLICATE PPU WARNINGS. PLEASE REMOVE EARLIER VERSIONS OF IBX BEFORE INSTALLING THIS
232 + RELEASE.
233 +
234 + NOTE: THE DBADMIN DEMO REQUIRES THAT THE MemDSLaz PACKAGE IS INSTALLED IN THE LAZARUS IDE.
235 +
236 + 1. IBExtract: Identity columns - add additional check for null column for generator name.
237 +
238 + 2. IBCustomDataSet: Insert and Modify (Update) queries now recognise and process SQL RETURNING clauses.
239 +   The main use for this is for Firebird 3 Identity columns (see IBXDocumentation 6.6.8 for further
240 +   information). However, this is also a very useful mechanism for returning updated computed by
241 +   column values. Values returned as a result of executing an Insert or Update statement
242 +   replace existing values in the current row for each corresponding column.
243 +
244 +   Previously, if a dataset's select query included read only (computed by) fields then
245 +   an automatic row refresh was performed after an insert or update query had been processed,
246 +   irrespective of the setting of the "ForcedUpdates" property. This has changed such
247 +   that an automatic refresh is no longer performed if an insert or update query contains
248 +   a returning clause that updates one or more fields on the current row. A full row
249 +   refresh is only performed if (a) ForcedRefresh is true or (b) the query does not return any
250 +   field values and the select query contains read only fields. Use of Insert/update
251 +   returning should be significantly more efficient than executing a refresh query.
252 +
253 +   This behaviour change is intended to be backwards compatible and there should be no need to change
254 +   existing programs, other than to improve performance by using the new capability.
255 +
256 + 3. IBCustomDataSet: DELETE...RETURNING queries are now also recognised. However, as
257 +   they are called when the dataset row is being deleted, there is no value in
258 +   updating the current record from the query result. Instead, a new event handler
259 +   "OnDeleteReturning" is provided. If a DELETE...RETURNING query is execute and
260 +   an OnDeleteReturning event handler is provided then it is called with the IResults returned
261 +   by the query. The event handler can then interrogate the query results and
262 +   perform whatever action is necessary. For example to confirm, to the user,
263 +   the deletion of a row with the returned values.
264 +
265 + 4. TIBTable: generated Insert and Update SQL now include a RETURNING clause for
266 +   any Computed By or Identity Columns. The IBTables example has been updated to
267 +   illustrate the computation of the employee Full Name on update.
268 +
269 + 5. TIBTable: The GeneratorField property is now published.
270 +
271 + 6. The InsertSQL property editor now shows Firebird 3 Identity columns separate from the Field List.
272 +   When InsertSQL is generated, the Identity columns are not included in the list of values to
273 +   be inserted. A RETURNING clause is added to the insert statement to return the value of
274 +   each Identity column after the insert is executed.
275 +
276 + 7. The Modify Property Editor now generates Update SQL with Computed By fields in Update..Returning clause.
277 +   Similarly Insert Property Editor now generates Insert SQL with Computed By fields in
278 +   Insert..Returning clause.
279 +
280 + 8. TIBGenerator: small performance improvement by not preparing query each time
281 +   a new value is generated.
282 +
283 + 9. TIBSQL: Free resources when transaction changed - ensures new transaction is used.
284 +
285 + 10. Property editors will now sync table name to a System Table when "Include System
286 +    Tables" is selected and the query is for a System Table.
287 +
288 + 11. Minor Performance improvement to handling of Date/Time types in IBX datasets. Field
289 +    values are no longer converted to milliseconds from TDateTime and then back again
290 +    to TDateTime (the conversion to milliseconds is the default TDataset approach).
291 +
292 + 12. Property Editors handling of Stored Procedures.
293 +    * Select and Refresh: only show a list of stored procedures that return multiple rows (proc type 1) and
294 +      which have a non-empty list of output parameters (i.e. stored procedures that may be used in a select
295 +      query).
296 +    * Modify and Insert: only show a list of stored procedures that return at most a singleton row (proc type 2).
297 +
298 + 13. IBStoredProc: Now supports Firebird 3 Package Names. A new published property PackageName
299 +    can be used to select a package. If non-empty, the stored procedure name is
300 +    expected to be a stored procedure defined in the specified package and the
301 +    generated SQL will be as required for a stored procedure located in a package.
302 +
303 + 14. Select, Refresh, Insert, Modify, Delete and TIBSQL SQL Property Editors now include
304 +    a "Package Name" drop down box to allow selection of a Firebird 3 Package from
305 +    which a stored procedure can be selected. With no package name selected, non-package
306 +    stored procedures are listed.
307 +
308 + 15. TIBXScript: turn off database login prompt when reconnecting - this avoids prompting
309 +    for password on reconnect.
310 +
311 + 16. TIBDatabase: use IAttachment for connection default character set id, code page
312 +    and character set name.
313 +
314 + 17. TIBDatabaseInfo: cache ODS Version information on first request in order to minimise
315 +    DB info lookups"
316 +
317 + 18. IBExtract: now supports DDL Triggers and Grants to DDL objects.
318 +
319 + 19. Add a property Editor for TIBUpdate.RefreshSQL.
320 +
321 + 20. IBUpdate: Ignore non-data (e.g. calculated) fields when assembling list of input
322 +    parameters. This stops an exception being raised when the field cannot be
323 +    located in the record buffer.
324 +
325 + 21. Property Editors now automatically include System Tables when opened and when the query table
326 +    is a System Table.
327 +
328 + 22. IBServices: SQRB and SRB buffers are now reset when service query throws an exception.
329 +    This avoids errors due to a stale SQRB or SRB being used for the next query.
330 +
331 + 23. IBServices: Service attach parameters now include "expected_db". This is used to
332 +    add the SPB item isc_spb_expected_db. This names a database using
333 +    an alternative Security Database (FB3 onwards) and allows (e.g. backup/restore) using such a
334 +    database. examples/services re-written to illustrate use of "expected_db".
335 +
336 + 24. IBServices: TIBControlAndQueryService.WriteNextChunk no longer ignores isc_info_svc_timeout.
337 +    This avoids truncated backups when the server returns a timeout (busy) response.
338 +
339 + 25. TIBDatabase: isc_dpb_page_size now supported as a database parameter when using TIBDatabase.CreateDatabase.
340 +
341 + 26. TIBDatabase: DatabaseName property may now be prefixed by $TEMP$ or $DATADIR$ for local
342 +    databasenames. These are respectively expanded to the local system's temp directory
343 +    (including trailing delimiter) or to a prescribed data directory (including
344 +    trailing delimiter). Under Unix systems the data directory is a hidden directory
345 +    in the user's home directory. The hidden directory name is either the string returned
346 +    from the SysUtils "Vendor Name" or "IBX" if empty. In either case prefixed by a '.'.
347 +    Under Windows, the directory is the same as the Data Directory as decribed
348 +    above but instead prefixed by the User's application data path. These may be
349 +    used to improve application portability for Personal Databases.
350 +
351 + 27. TIBTable: FieldDefs property is no longer published. Due to the use of TIBFieldDef
352 +    this has not worked for a long time and is not useful either. FieldDefs should be
353 +    managed using the Fields Editor as with any other dataset. To access the fields
354 +    editor for a TIBTable component, double click on the component. The fields editor
355 +    is then displayed.
356 +
357 + 28. TIBDatabaseInfo: new properties/function
358 +     * DateDBCreated (returns date/time database created)
359 +     * TransactionCount (returns no. of active transactions)
360 +     * GetDatabasePage(PageNo: integer) (returns contents of specified database page - SYSDBA only).
361 +     * PagesFree (Firebird 3 or later)
362 +     * PagesUsed (Firebird 3 or later)
363 +     * Encrypted (returns true if database encrypted. (Firebird 3.0.3 or later only)
364 +     * EncryptionKeyName (returns the name of the encryption key if any (Firebird 3.0.3 or later only)
365 +
366 + 29. IBServices classes now provided the decoded release number in the (array) property ServerVersionNo.
367 +
368 + 30. TIBSecurityService now supports display/modification of the User Admin Role (Firebird 2.5 and later).
369 +
370 + 31. TIBConfigService now has a procedure SetAutoAdmin(Value: boolean) to enable/disable
371 +    the automtic mapping of privileged OS users to the RDB$ADMIN role (Firebird 2.5 and later).
372 +
373 + 32. TIBBackupService: New Option - NoDBTriggers equivalent to -nodbtriggers switch introduced
374 +    in the gbak utility at V.2.1 to prevent database-level and transaction-level triggers from
375 +    firing during backup and restore.
376 +
377 + 33. Both TIBBackupService and TIBRestoreService now support backup/restore statistics options
378 +    for verbose output using the new property "StatisticsRequested".
379 +    see https://firebirdsql.org/file/documentation/release_notes/html/en/2_5/rnfb25-util-gbak.html#rnfb25-util-gbakstats
380 +
381 + 34. TIBRestoreService: now supports new options RestoreMetaDataOnly (Firebird 2.5 and later).
382 +
383 + 35. TIBOnlineValidationService component added to the IBServices and the "Firebird Admin"
384 +    palette. This uses the online validation feature added in Firebird 2.5. The
385 +    services's properties enable inclusion/exclusion of tables and indexes using
386 +    regular expressions. See.
387 +    https://firebirdsql.org/file/documentation/release_notes/html/en/2_5/rnfb25-apiods-api.html#rnfb25-apiods-api-onlinevalidation
388 +
389 + 36. IBServices: procedure TIBConfigService.SetNoLinger added to set no linger
390 +    option on a database.
391 +
392 + 37. TIBCustomService: Assign method implemented to allow copying of service login
393 +    context between service API components. "Detach" method now only detaches
394 +    service when last reference to the service interface detaches. Tidy up of
395 +    code for SetActive and Attach methods including password hiding.
396 +
397 + 38. TIBDatabase: new properties: AuthenticationMethod and RemoteProtocol. Read only
398 +    and used to determine the auth method and protocol used for the connection.
399 +
400 + 39. TIBDatabase: ensure that SQLDialect setting is used when creating a database using
401 +    a Create Database Statement generated by IBX.
402 +
403 + 40. All IBServices now have an additional published property "PortNo". This may
404 +    be set to a non-standard port number when necessary. If zero then the default
405 +    port number is used.
406 +
407 + 41: TIBLookupComboeditBox: Ensure dataset updated when change selected with the keyboard
408 +    and not just the mouse.
409 +
410 + 42. TIBCustomDataset: reopen query if already active when a TIBControlLink is added.
411 +
412 + 43. TIBTreeview: new ImageIndexField and SelectedIndexField Property allows the
413 +    image index and selected image index for each node to be set from a database field.
414 +
415 + 44. TIBExtract: new extract type (etGrantsToUser) for use with eoDatabase. If included
416 +    then database schema includes grants to all users. If not present then the
417 +    only user grants included are those to User PUBLIC.
418 +
419 + 45. TIBTreeView: performance improvement. When expanding include both expanded node
420 +    and child nodes in dataset.
421 +
422 +
423   IBX Change Log  version                            (2.1-0) Fri, 15 Dec 2017 12:20:11 +0000
424  
425   1. IBCustomDataset: Minor change of PChar to PByte for compatibility with fbintf

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines