| 1 |
< |
IBX Change Log version (2.1-0) Fri, 15 Dec 2017 12:20:11 +0000 |
| 1 |
> |
IBX Change Log version (2.4-1 Build 12550) Wed, 23 Jun 2021 13:59:14 +0100 |
| 2 |
> |
|
| 3 |
> |
1. -c command line option added to fbsql example program. Used to set connection |
| 4 |
> |
character set. |
| 5 |
> |
|
| 6 |
> |
IBX Change Log version (2.4-0 Build 12543) Mon, 22 Feb 2021 11:00:08 +0000 |
| 7 |
> |
|
| 8 |
> |
1. Firebird 4 support added. |
| 9 |
> |
|
| 10 |
> |
2. New FB4 data types TIME WITH TIME ZONE, TIMESTAMP WITH TIME ZONE, DECFLOAT and |
| 11 |
> |
extended precision NUMERIC fields are supported. |
| 12 |
> |
|
| 13 |
> |
3. TFmtBCDField is used to support access to DECFLOAT and extended precision NUMERIC fields. |
| 14 |
> |
|
| 15 |
> |
4. TIBDateTimeField and TIBTimeField are introduced in support of TIMESTAMP WITH TIME ZONE |
| 16 |
> |
and TIME WITH TIME ZONE fields. These inherit from TDateTimeField. |
| 17 |
> |
|
| 18 |
> |
5. IBExtract now supports FB4 enhancements: |
| 19 |
> |
- new data types as above |
| 20 |
> |
- Identity column extensions |
| 21 |
> |
- Default user role |
| 22 |
> |
- SQL Security clause for Database, Tables, Procedures, Functions and Triggers |
| 23 |
> |
- Internal Functions |
| 24 |
> |
|
| 25 |
> |
6. IBExtract: new event: OnExtractLines. |
| 26 |
> |
|
| 27 |
> |
7. IBExtract: revert create trigger to legacy syntax see Firebird CORE-6243, CORE-5545 and DOC-145 |
| 28 |
> |
|
| 29 |
> |
8. IBXServices: Server version no. parsing now allows any letter before major version number |
| 30 |
> |
and is no longer restricted to 'V' e.g. "LI-T4.0.0.1436 Firebird 4.0 Beta 1" |
| 31 |
> |
|
| 32 |
> |
9. TIBDataSet and TIBQuery: new property TZTextOption. Used to determine the default |
| 33 |
> |
format for rendering a time zone. |
| 34 |
> |
|
| 35 |
> |
10. TIBDataSet and TIBQuery: new property DefaultTZDate. Used to provide the default date |
| 36 |
> |
to convert TIME WITH TIME ZONE data type values to and from GMT. |
| 37 |
> |
|
| 38 |
> |
11. Unit name IBTypes changed to IBInternals. Internal interfaces TIBGUIInterface and TIBTimerInf renamed to |
| 39 |
> |
IIBGUIInterface and IIBTimerInf respectively. |
| 40 |
> |
|
| 41 |
> |
12. Constants: DPBPrefix and TPBPrefix moved to IB unit. DPBConstantNames and TPBConstantNames |
| 42 |
> |
now accessible as properties of TIBDatabase and TIBTransaction respectively. |
| 43 |
> |
|
| 44 |
> |
13. String Fields: when a fixed character with (CHAR) field is returned, it is now |
| 45 |
> |
truncated to its fixed character width rather than being right padded with |
| 46 |
> |
white space to the maximum data size. |
| 47 |
> |
|
| 48 |
> |
14. TIBTable.Empty table. In additional to deleting all records in the underlying |
| 49 |
> |
table, the internal buffers are now also flushed ensuring that the TIBTable is |
| 50 |
> |
also empty. |
| 51 |
> |
|
| 52 |
> |
15. TBatchSQLStatementReader: Line buffer is now cleared on call to reset. |
| 53 |
> |
|
| 54 |
> |
16. TIBXControlService descendents: DatabaseName may now be set using a database |
| 55 |
> |
connect string. The database name is extracted from the connect string. |
| 56 |
> |
|
| 57 |
> |
17. DBControlGrid: Minor bug fixes. avoid AV on form closure, avoid black panel |
| 58 |
> |
|
| 59 |
> |
18. TIBExtract: Data type of COMPUTED By columns is no longer included in SQL. |
| 60 |
> |
|
| 61 |
> |
19. Local database on Linux and with legacy API and FB 2.5 embedded server: fixed problem with password |
| 62 |
> |
not being present as required. |
| 63 |
> |
|
| 64 |
> |
20. IBTreeView split into DBTreeView and IBTreeView. This former is an IBX indepedent |
| 65 |
> |
version that can be customised to work with other database drivers. |
| 66 |
> |
|
| 67 |
> |
21. ISQLMonitor: use platform specific LineEnding to delimit messages. Avoids |
| 68 |
> |
unnecessary CR at end of line on Unix platforms. |
| 69 |
> |
|
| 70 |
> |
22. ISQLMonitor: Unix: Default semaphore timeout increased from 1 second to 10 |
| 71 |
> |
seconds in order to reduce risk of message loss. |
| 72 |
> |
|
| 73 |
> |
23. ISQLMonitor: read and write count statistics now available via: |
| 74 |
> |
property TIBSQLMonitor.ReadCount; |
| 75 |
> |
IIBSQLMonitorHook.GetWriteCount: integer; |
| 76 |
> |
|
| 77 |
> |
24. ISQLMonitor tidy up and unit split. IPC functions moved to new unit IBIPC. |
| 78 |
> |
|
| 79 |
> |
IBX Change Log version (2.3-5 Build 12350) Tue, 25 Aug 2020 16:11:02 +0100 |
| 80 |
> |
|
| 81 |
> |
1. TIBStringField: when a string value is read from a dataset buffer, if the |
| 82 |
> |
number of UTF8 characters exceeds the string size then string is truncated |
| 83 |
> |
to the maximum string size. This is usually a problem with fixed width columns |
| 84 |
> |
right padded with white space. |
| 85 |
> |
|
| 86 |
> |
2. SQLFiltered and SQLFilterParams added to TIBQuery, TIBTable and TIBDataset. |
| 87 |
> |
If SQLFiltered is set then when a dataset is opened, each line in the |
| 88 |
> |
SQLFilterParams property is assumed to be a SQL condition clause and |
| 89 |
> |
ANDed into the Where clause of the SQL Select statement provided as a |
| 90 |
> |
dataset property. Each such SQL condition thus acts as an additional filter |
| 91 |
> |
on the dataset. |
| 92 |
> |
|
| 93 |
> |
3. The Filtered property inherited from TDataset is no longer used for SQL (server |
| 94 |
> |
side filters). |
| 95 |
> |
|
| 96 |
> |
4. IBLookupComboEditBox: Selection should no longer reset to start of text when |
| 97 |
> |
text matches complete entry. |
| 98 |
> |
|
| 99 |
> |
5. TIBDataLink: Detail Dataset params not refreshed unless both master and detail |
| 100 |
> |
dataset are active (avoids risk of access violation if master is inactive) |
| 101 |
> |
|
| 102 |
> |
6. TIBEvents: Registered property can now be set at design time even if database not open |
| 103 |
> |
|
| 104 |
> |
7. TIBEvents: component now correctly re-initialised after call to UnregisterEvents. |
| 105 |
> |
This should prevent "spillover" of events between sessions. |
| 106 |
> |
|
| 107 |
> |
8. TIBCustomDataset: GetNextRecord now called when reseting to first record of a unidirectional dataset. |
| 108 |
> |
This should ensure that the internal buffer is set up correctly and avoids |
| 109 |
> |
a duplicate initial row. |
| 110 |
> |
|
| 111 |
> |
9. TIBStringField: DataSize now given as byte size of string less trailing any zero character. |
| 112 |
> |
That is, the DataSize should be the field size * character set width. The |
| 113 |
> |
value returned by DataSize is now the same as the Dataset buffer size reserved |
| 114 |
> |
for the field. |
| 115 |
> |
|
| 116 |
> |
10. IBExtract: Tidyup of SQL generation. Avoid unnecessary double quotes. |
| 117 |
> |
|
| 118 |
> |
11. TIBCustomDataset: Add checks on buffer sizes when copying data from row to field buffer |
| 119 |
> |
and vice-versa. This may result in an exception being raised (correctly) for |
| 120 |
> |
older programs when using dataset fields added to a form and the database has been |
| 121 |
> |
upgraded. For example, computed fields can change from 32-bit to 64-bit integers. |
| 122 |
> |
In such cases, the field needs to be deleted in the IDE fields editor and then |
| 123 |
> |
added back in. |
| 124 |
> |
|
| 125 |
> |
12. IBCustomDataSet: CanInsert, CanEdit, CanDelete and CanRefresh updated to return |
| 126 |
> |
false if query contains only white space and not just empty. |
| 127 |
> |
|
| 128 |
> |
12. IBCustomDataset: Blob data is now cleared when TDataSet.Cancel is called. This |
| 129 |
> |
should ensure that (e.g.) a TDBMemo is correctly refreshed after a dataset edit |
| 130 |
> |
is cancelled. |
| 131 |
> |
|
| 132 |
> |
13. IBCustomDataset: SetArrayIntf should no longer cause an access violation if |
| 133 |
> |
called on a null field. |
| 134 |
> |
|
| 135 |
> |
14. IBCustomDataSet: An access violation should no longer occur when calling CancelUpdates |
| 136 |
> |
results in an empty dataTC86 Client side Filtered Dataset 1 X |
| 137 |
> |
set. |
| 138 |
> |
|
| 139 |
> |
15. IBCustomDataSet: OnUpdateError should now be called in all circumstances when |
| 140 |
> |
a cached update is applied and an exception is raised. |
| 141 |
> |
|
| 142 |
> |
16. IBCustomDataSet: Avoid access violation when SetBookmarkData called with nil pointer. |
| 143 |
> |
|
| 144 |
> |
17. Console Mode Local Database support: backup/restore should now work correctly. |
| 145 |
> |
|
| 146 |
> |
18. Local Database Support: if an upgrade fails, a downgrade is now performed if |
| 147 |
> |
possible and an exception raised. |
| 148 |
> |
|
| 149 |
> |
19. MinimumVersionNo added to Local Database Support. Database will not open if |
| 150 |
> |
below this version no. and upgrade not possible. |
| 151 |
> |
|
| 152 |
> |
IBX Change Log version (2.3-4 Build 12041) Fri, 17 Apr 2020 14:00:32 +0100 |
| 153 |
> |
|
| 154 |
> |
1. TIBXDataSet and Generators: Generator Names that are not all upper case or |
| 155 |
> |
not SQL Identifiers are now supported. |
| 156 |
> |
|
| 157 |
> |
2. TIBXScript: Set Generator is no longer rejected as unrecognised SQL and is |
| 158 |
> |
passed to the Firebird engine for execution. |
| 159 |
> |
|
| 160 |
> |
3. TIBDataSet: Unidirectional datasets now give an error message if an attempt |
| 161 |
> |
is made to scroll back. |
| 162 |
> |
|
| 163 |
> |
4. New unit: IBMessages.pas. Contains only messages used by IBX and not FBIntf |
| 164 |
> |
|
| 165 |
> |
5. TIBLookupComboEditBox: When generating auto-complete SQL, the ListField is now |
| 166 |
> |
only enclosed in double quotes in SQL dialect 3 and when it needs to be. |
| 167 |
> |
|
| 168 |
> |
6. TIBLookupComboEditBox: when the list source opens, the ListField name is now |
| 169 |
> |
validated. If no match is found in the list of field names and the database has |
| 170 |
> |
been opened in SQL Dialect 3, then the ListField Name is converted to upper case |
| 171 |
> |
if it then matches a field name. Otherwise, a Listfield not valid exception occurs. |
| 172 |
> |
|
| 173 |
> |
7. IBGeneratoreditor.pas: Add missing parenthesis around "IS" statement for compliance |
| 174 |
> |
with fpc 3.2. |
| 175 |
> |
|
| 176 |
> |
IBX Change Log version (2.3-3 Build 11512) Fri, 28 Dec 2018 10:04:17 +0000 |
| 177 |
> |
|
| 178 |
> |
|
| 179 |
> |
1. New property for TIBDatabase and TIBXServicesConnection. This is "ConfigOverrides" |
| 180 |
> |
and is used to override the default settings in the client side "firebird.conf" This |
| 181 |
> |
includes "WireCompression" and "WireCrypt". The value of this property is a "TStrings". |
| 182 |
> |
Each line of the string list should be a setting in the same format as "firebird.conf". |
| 183 |
> |
For example "WireCompression = true" in order to request wire compression on the client side. |
| 184 |
> |
|
| 185 |
> |
Note: explicit settings in the client side "firebird.conf" appear to take precedence |
| 186 |
> |
over settings given in TIBDatabase and TIBXServicesConnection. Many client side settings |
| 187 |
> |
also require a compatible setting in the server side "firebird.conf". For example |
| 188 |
> |
"WireCompression = true" must also be set in the server's "firebird.conf" for wire |
| 189 |
> |
compression to be used. |
| 190 |
> |
|
| 191 |
> |
Whether or not WireCompression or WireCrypt are in use can be checked using the information |
| 192 |
> |
returned with the Client/Server protocol version. See ibx/examples/dbadmin and |
| 193 |
> |
ibx/examples/dbinfo for examples of how to display this information. |
| 194 |
> |
|
| 195 |
> |
2. New property for TIBDatabase and TIBXServicesConnection: "WireCompression". This |
| 196 |
> |
is a "convenience" property. If set the "WireCompression=true" is added to the |
| 197 |
> |
ConfigOverrides. If unchecked then this setting is removed. |
| 198 |
> |
|
| 199 |
> |
3. TIBExtract: 64-bit integer types are now correctly extracted as "BIGINT" and |
| 200 |
> |
not "INT64". |
| 201 |
> |
|
| 202 |
> |
4. New published properties for TIBCSVDataOut, TIBInsertStmtsOut and TIBBlockFormatOut |
| 203 |
> |
These are: |
| 204 |
> |
property TimestampFormat: string; |
| 205 |
> |
property DateFormat: string; |
| 206 |
> |
property TimeFormat: string; |
| 207 |
> |
|
| 208 |
> |
Respectively, these provide the date time format templates for SQL types: TIMESTAMP, |
| 209 |
> |
DATETIME and TIME. The format strings use the standard FPC date/time format |
| 210 |
> |
characters (see https://www.freepascal.org/docs-html/rtl/sysutils/formatchars.html). |
| 211 |
> |
|
| 212 |
> |
If any of the above properties are set to an empty string, then the locale default |
| 213 |
> |
is used. This uses the ShortDateFormat and the LongTimeFormat. In timestamp, the |
| 214 |
> |
locale default is extended by appending '.zzz' to include milliseconds. |
| 215 |
> |
|
| 216 |
> |
TIBCSVDataOut by default sets these properties to the empty string, while the other |
| 217 |
> |
two use: 'yyyy.mm.dd hh:nn:ss.zzz', 'yyyy.mm.dd' and 'hh:nn:ss.zzz' respectively. |
| 218 |
> |
|
| 219 |
> |
5. New published property for TIBCSVDataOut: |
| 220 |
> |
property QuoteStrings: boolean (default true) |
| 221 |
> |
|
| 222 |
> |
If false then strings are unquoted, otherwise, the QuoteChar property value is |
| 223 |
> |
used to delimit each and every string in the output. |
| 224 |
> |
|
| 225 |
> |
6. New published properties for TIBCSVDataOut: |
| 226 |
> |
property FieldSeparator: string; |
| 227 |
> |
property HeaderSeparator: string; |
| 228 |
> |
|
| 229 |
> |
Respectively, these provide the separator character(s) used to separate fields |
| 230 |
> |
in data and header rows. Both default to ','. |
| 231 |
> |
|
| 232 |
> |
7. New published properties for TIBCSVDataOut and TIBBlockFormatOut: |
| 233 |
> |
TOnFormatTextString = procedure(sender: TObject; var TextString: string) of object; |
| 234 |
> |
property OnFormatTextString; |
| 235 |
> |
|
| 236 |
> |
This event handler can be used to process text strings before they are included |
| 237 |
> |
in the output e.g. to replace unprintable characters with alternative strings. |
| 238 |
> |
This only applies to columns with an SQL Type of SQL_VARYING and SQL_TEXT. |
| 239 |
> |
|
| 240 |
> |
8. TIBDataSet now raises an exception when ParamByName called with an invalid parameter name. |
| 241 |
> |
Uses "FindParam" if in order to find out if a parameter with a given name exists |
| 242 |
> |
and without raising and exception if it does not. |
| 243 |
> |
|
| 244 |
> |
9. TIBQuery now uses IBX SQL Parser instead of the TParams SQL parser in order to ensure |
| 245 |
> |
consistency with SQL queries. |
| 246 |
> |
|
| 247 |
> |
10. CaseSensitiveParameterNames property added to TIBSQL, TIBDataSet and TIBQuery. |
| 248 |
> |
When true, SQL statement parameter names are parsed case sensitive. Note for |
| 249 |
> |
TIBDataSet only applies to Select query. |
| 250 |
> |
|
| 251 |
> |
11. IBEvents: removing a TIBEvent component from a form should no longer result in |
| 252 |
> |
an IDE exception. |
| 253 |
> |
|
| 254 |
> |
12. LocalDBSupport: initial database creation should now work correctly |
| 255 |
> |
when the schema source is an sql file. |
| 256 |
> |
|
| 257 |
> |
13. TIBCMLocalDBSupport: new event handler "property OnProgressEvent: TOnProgressEvent" |
| 258 |
> |
when defined, this handler will be called by the internal TIBXScript during |
| 259 |
> |
initial database creation when the schema source is an sql file and may be used |
| 260 |
> |
to provide a visual indication of progress in console mode. |
| 261 |
> |
|
| 262 |
> |
14. TCustomIBLocalDBSupport: new public property "InOnCreateDB: boolean". This is set |
| 263 |
> |
to true while a new local database is being created and its schema populated. |
| 264 |
> |
Useful in (e.g.) TIBDatabase.OnAfterConnect handler to suppress actions |
| 265 |
> |
when the database is disconnected/connected during the create DB procedure. |
| 266 |
> |
|
| 267 |
> |
15. TIBXScript: any User/password parameters found in a CREATE DATABASE statement |
| 268 |
> |
are now always ignored and replaced by the user name and password provided as |
| 269 |
> |
the login parameters for the TIBDatabase referenced from the TIBXScript. The |
| 270 |
> |
IgnoreCreateDatabase property still applies and the CREATE DATABASE statement is |
| 271 |
> |
completely ignored if this property is true. |
| 272 |
> |
|
| 273 |
> |
16. Code tidyup in IBTreeView: Node properties initialisation moved from TIBTreeView.AddNodes |
| 274 |
> |
to TIBTreeView.Added. An OnAddition event handler is no longer needed to initialise |
| 275 |
> |
ImageIndex and SelectImageIndex values on AddNode. |
| 276 |
> |
|
| 277 |
> |
17. TIBDatabase.Attachment and TIBXServicesConnection.ServicesIntf properties are now |
| 278 |
> |
read/write. This should enabled (e.g.) multiple instances of TIBDatabase to share |
| 279 |
> |
the same database connection. |
| 280 |
> |
|
| 281 |
> |
18. TIBDataSet and TIBQuery now support the TDataSet "Filter" property. |
| 282 |
> |
if provided, this should be an conditional SQL expression suitable for |
| 283 |
> |
including in an SQL Select statement "where" clause. If non-empty and the |
| 284 |
> |
"Filtered" property is true then the SQL expression provided as the value of |
| 285 |
> |
the "Filter" property is "ANDed" with any existing condition statement |
| 286 |
> |
in the SQL statement's "Where" clause. |
| 287 |
> |
|
| 288 |
> |
If the "Filter" property is set at run time, the "Filtered" property is true |
| 289 |
> |
and the dataset is already open, then the dataset is closed and re-opened automatically. |
| 290 |
> |
|
| 291 |
> |
The "Filter" condition may include IBX style parameters. In which case, their |
| 292 |
> |
value must be set by the dataset's "OnBeforeOpen" event handler. |
| 293 |
> |
|
| 294 |
> |
This is a public property for TIBDataSet and TIBQuery query and intended for |
| 295 |
> |
use at run time. |
| 296 |
> |
|
| 297 |
> |
Note: The property is a published property of TIBTable. The TIBTable functionality |
| 298 |
> |
is unaffected by this change. |
| 299 |
> |
|
| 300 |
> |
IBX Change Log version (2.3-2) Wed, 05 Dec 2018 12:19:23 +0000 |
| 301 |
> |
|
| 302 |
> |
1. Remove need to check for IsMultiThread by providing access to GUI timers via |
| 303 |
> |
IBGUIInterface. Note: master/detail delay timer does not apply to console |
| 304 |
> |
mode apps. |
| 305 |
> |
|
| 306 |
> |
2. TIBCustomDataSet: SQLParser ignored if it does not contain a valid select |
| 307 |
> |
statement. This avoids problems if "Execute Block" is used as the Query. |
| 308 |
> |
|
| 309 |
> |
3. IBSQLParser now uses the common SQL tokeniser from fbintf. This replaces the |
| 310 |
> |
internal SQL tokeniser routines. |
| 311 |
> |
|
| 312 |
> |
4. IBSQLParser: new property NotaSelectStmt. Set to true if SQL fails to parse |
| 313 |
> |
as a select statement, with or without CTEs. |
| 314 |
> |
|
| 315 |
> |
5. IBSQLParser: parser now recognises the "ROWS" clause. |
| 316 |
> |
|
| 317 |
> |
6. TIBXScript now uses the common SQL tokeniser from fbintf. This replaces the |
| 318 |
> |
internal SQL tokeniser routines. |
| 319 |
> |
|
| 320 |
> |
7. Fix error in TIBXScript processing of "set" statements. This avoids exceptions |
| 321 |
> |
being raised for valid set statements processed by a data formatter. |
| 322 |
> |
|
| 323 |
> |
8. New published property for TIBDatabase and TIBXServicesConnection. This is |
| 324 |
> |
FirebirdLibraryPathName: string. If not empty it is used to explicitly specify |
| 325 |
> |
the path of the Firebird Library used by the database/services connection. |
| 326 |
> |
|
| 327 |
> |
9. New read only public property for TIBDatabase and TIBXServicesConnection. This |
| 328 |
> |
is FirebirdAPI and returns the IFirebirdAPI interface used by the database/ |
| 329 |
> |
services connection. |
| 330 |
> |
|
| 331 |
> |
10.SQL Property editors now quote parameter names if "Quote identifier" is selected |
| 332 |
> |
or param name is not a valid SQL identifier. |
| 333 |
> |
|
| 334 |
> |
11. IBLookupComboEditBox: In Lazarus 2.0, TDBLookupComboBox takes a more restrictive |
| 335 |
> |
view of whether the text box should be editable when no DataSource is specified. |
| 336 |
> |
TIBLookupComboEditBox has been updated to workaround this problem. As long as |
| 337 |
> |
ReadOnly is false, the text box is editable when no DataSource is specified. |
| 338 |
> |
|
| 339 |
> |
12. AllowUseOfFBLIB is now set to "true" at design time. This is to allow use of |
| 340 |
> |
the FBLIB environment variable. If you do not want to permit this then you |
| 341 |
> |
must modify the Register procedure in the design/IBDBReg.pas unit to remove |
| 342 |
> |
this setting. |
| 343 |
> |
|
| 344 |
> |
IBX Change Log version (2.3-1) Thu, 25 Oct 2018 14:39:45 +0100 |
| 345 |
> |
|
| 346 |
> |
1. IBCustomDataset: replace deprecated function ValidUTF8String with call to |
| 347 |
> |
Utf8EscapeControlChars |
| 348 |
> |
|
| 349 |
> |
IBX Change Log version (2.3-0) Mon, 16 Apr 2018 09:48:06 +0100 |
| 350 |
> |
|
| 351 |
> |
IMPORTANT: the source code tree has been re-organised for IBX 2.3. Please remove |
| 352 |
> |
all previous copies of the IBX source code tree before installing this release. |
| 353 |
> |
|
| 354 |
> |
The IBX packages used by most users have not changed, with one exception. The |
| 355 |
> |
IBServices unit has been moved to the package iblegacyServices.lpk. To continue |
| 356 |
> |
to use the IBServices unit in your applications, please add the iblegacyServices |
| 357 |
> |
to the list of dependencies. To do this, open the Project Inspector and select |
| 358 |
> |
Add->New Requirement and select "ibLegacyServices" from the list of available |
| 359 |
> |
packages. |
| 360 |
> |
|
| 361 |
> |
1. New unit IBXServices. The IBXServices unit is a re-architectured update of |
| 362 |
> |
the IBServices unit providing what is intended to be a clearer and easier to |
| 363 |
> |
use set of IB Services components. See Chapter 10 of the IBX User Guide for |
| 364 |
> |
more information and the guide to "Firebird Service Management Using IBX". |
| 365 |
> |
As indicated above, the legacy services components are still available and |
| 366 |
> |
provided in a separate package. There is no need to update working applications |
| 367 |
> |
using the older versions except for an additional package dependency. |
| 368 |
> |
|
| 369 |
> |
2. The IBX packages and source code tree have been re-organised in an attempt to |
| 370 |
> |
finally get rid of the "duplicate ppu" warnings. This re-organisation should |
| 371 |
> |
not affect existing users. Section 2.3 of the IBX User Guide describes the |
| 372 |
> |
new set of IBX packages. |
| 373 |
> |
|
| 374 |
> |
3. The ibx/examples/DBAdmin and the ibx/examples/services example have been |
| 375 |
> |
updated to use the new Services API components. |
| 376 |
> |
|
| 377 |
> |
4. The iblocal package has been updated to use the new Services API components. |
| 378 |
> |
|
| 379 |
> |
5. procedure SetAutoAdmin; in the new IBX Services this method is now a member of |
| 380 |
> |
TIBXSecurityService. It had been wrongly classified in the previous version |
| 381 |
> |
as a per database configuration item. It is global to a server and hence |
| 382 |
> |
correctly positioned as part of the Security Package. In the DBAdmin example, |
| 383 |
> |
the setting has moved to the mappings page. |
| 384 |
> |
|
| 385 |
> |
6. TIBXScript: IgnoreCreateDatabase added. If true then CREATE DATABASE statements |
| 386 |
> |
are ignored. |
| 387 |
> |
|
| 388 |
> |
7. TIBDatabase: DropDatabase now ensures that all transactions have been properly |
| 389 |
> |
closed before the database is dropped. Before and After Disconnect event handlers |
| 390 |
> |
are also fired. |
| 391 |
> |
|
| 392 |
> |
8. TIBTransaction: OnStartTransaction event now fires every time the transaction |
| 393 |
> |
is started and not just the first time. |
| 394 |
> |
|
| 395 |
> |
9. IBDataOutput: Use FormatFloat for all performance statistics to avoid platform |
| 396 |
> |
depenendency with comp type. |
| 397 |
> |
|
| 398 |
> |
10. IBDataOutput: select query data output is now sent to stdout instead of stderr. |
| 399 |
> |
|
| 400 |
> |
11. TIBDatabase: Remove regression. If a user login dialog changes the DatabaseName |
| 401 |
> |
then this is recognised and not ignored. |
| 402 |
> |
|
| 403 |
> |
12. TIBDataSet, TIBQuery, TIBTable: additions: |
| 404 |
> |
function GetRowsAffected(var SelectCount, InsertCount, UpdateCount, DeleteCount: integer): boolean; |
| 405 |
> |
function GetPerfStatistics(var stats: TPerfCounters): boolean; |
| 406 |
> |
property EnableStatistics: boolean read FEnableStatistics write SetEnableStatistics; |
| 407 |
> |
|
| 408 |
> |
GetRowsAffected returns the affected row counts from the last insert/update/delete |
| 409 |
> |
if EnableStatistics = true then GetPerfStatistics returns the current stats |
| 410 |
> |
counters for the select query. Note: stats accumulate after each fetch from |
| 411 |
> |
the database. To get total query cost after open, call the "Last" method |
| 412 |
> |
and then GetPerfStatistics. |
| 413 |
> |
|
| 414 |
> |
See ibx/examples/consolemode for an example of the use of GetPerfStatistics |
| 415 |
> |
|
| 416 |
> |
13. TIBExtract: Identity columns DDL. "Start with clause" now correctly encapsulated |
| 417 |
> |
in parenthesises. |
| 418 |
> |
|
| 419 |
> |
14. TIBExtract: new published property "AlwaysQuoteIdentifiers". If true then in dialect 3 |
| 420 |
> |
SQL identifiers are always delimited by double quotes. If false, then they are |
| 421 |
> |
only delimited if the identifier is a reserved word, contains lower case or special |
| 422 |
> |
characters. Set this property to true to retain previous behaviour. |
| 423 |
> |
|
| 424 |
> |
15. Insert SQL Property Editor. In Insert Returning Clause, Identity column names |
| 425 |
> |
are now inserted in double quotes if not Reserved Words or valid SQL Identifiers. |
| 426 |
> |
|
| 427 |
> |
16. TIBDataSet, TIBQuery, TIBTable: addition: |
| 428 |
> |
property MasterDetailDelay: integer {defaults to zero} |
| 429 |
> |
|
| 430 |
> |
When non-zero and the dataset is a detail table referencing a master table |
| 431 |
> |
through either a MasterSource (TIBTable) or a DataSource (TIBDataSet, TIBQuery) |
| 432 |
> |
then a synchronisation delay is added (in milliseconds) between the master |
| 433 |
> |
row changing and the detail dataset being re-opened. If the master dataset |
| 434 |
> |
is scrolled before the delay expires then the delay is reset. This can be used |
| 435 |
> |
to avoid performance overheads when scrolling through a large master dataset. |
| 436 |
> |
|
| 437 |
> |
Note: uses fptimer and hence requires a thread manager. Under Linux the |
| 438 |
> |
chreads unit must be included in your project. TTimer is not used in order |
| 439 |
> |
to avoid an LCL dependency. Requires FPC 3.0.2 or later. |
| 440 |
> |
|
| 441 |
> |
17. TIBExtract: User role grants now excluded when etGrantsToUser not specified |
| 442 |
> |
with Extract Option eoDatabase. |
| 443 |
> |
|
| 444 |
> |
18. TIBLookupComboEditBox: Workaround added for https://bugs.freepascal.org/view.php?id=33428 |
| 445 |
> |
When a deLayoutChanged event is reported on the ListSource dataset, the |
| 446 |
> |
combobox text is updated. This allows a listsource (detail) to be in a Master/Detail |
| 447 |
> |
relationship with the control's datasource (master). |
| 448 |
> |
|
| 449 |
> |
19. TIBExtract: Full BigInt value range now supported for Generators/Sequences. |
| 450 |
> |
|
| 451 |
> |
20. TIBExtract: Select Procedures (Procedure type 1) now include "SUSPEND;" clause in their |
| 452 |
> |
stubs. Pedantic fix really, as procedures output in dependency order anyway. |
| 453 |
> |
|
| 454 |
> |
21. TIBExtract: Package Headers and Package Bodies are now included in the extracted |
| 455 |
> |
DDL (Firebird 3 and later only). |
| 456 |
> |
|
| 457 |
> |
22. TIBLookupComboBox Autocomplete Fixes: |
| 458 |
> |
i. Only appended text is now selected after autocomplete. |
| 459 |
> |
ii. Uppercase keys no longer ignored for autocomplete. |
| 460 |
> |
iii. Retain Prefix case is now honoured correctly. |
| 461 |
> |
iv. When a DataSource is assigned, typing after autocomplete now extends prefix |
| 462 |
> |
before autocomplete performed. i.e. behaviour now the same as when |
| 463 |
> |
no DataSource assigned. |
| 464 |
> |
|
| 465 |
> |
23. TIBXScript: Single Line Comments starting with '--' are now ignored when occurring |
| 466 |
> |
between SQL statements. |
| 467 |
> |
|
| 468 |
> |
24. TIBExtract: New published property CaseSensitiveObjectNames. If false (default) then |
| 469 |
> |
ObjectNames are converted to upper case before matching against metadata object |
| 470 |
> |
names, unless the objectname is delimited by double quotes, in which case, the |
| 471 |
> |
double quotes are removed and the remaining string is used (unmodified) to match |
| 472 |
> |
against the metadata object name. |
| 473 |
> |
|
| 474 |
> |
If true then the ObjectName is used as is without modification and matched |
| 475 |
> |
against the metadata object name. No attempt is made to remove double quotes. |
| 476 |
> |
|
| 477 |
> |
25. TIBExtract: New Extract Types: etDatabaseTriggers and etDDLTriggers. When used |
| 478 |
> |
with eoTrigger, these extract types can be used to select only Database Triggers, |
| 479 |
> |
or DDL Triggers or both. Ignored when etTable or etTrigger included in Extract Types. |
| 480 |
> |
|
| 481 |
> |
26. TIBXScript: If an exception occurs during the processing of a statement, the |
| 482 |
> |
statement separate character is now reset to the default (';'). |
| 483 |
> |
|
| 484 |
> |
27. TIBDatabase: Reconnect method added and used by TIBXScript for reconnect. |
| 485 |
> |
|
| 486 |
> |
28. TIBXScript: Transaction is no longer automatically reactivated immediately processing |
| 487 |
> |
a commit or reconnect statement and instead activated only when next SQL statement |
| 488 |
> |
is executed. |
| 489 |
> |
|
| 490 |
> |
29. TIBSQL.HasField should no longer generate and exception when the field does not exist. |
| 491 |
> |
|
| 492 |
> |
30. TIBXScript: case insensitive regex now used when matching statements instead of |
| 493 |
> |
converting statement to upper case. |
| 494 |
> |
|
| 495 |
> |
31. TIBExtract: metadata comments now supported. New published property |
| 496 |
> |
IncludeMetaDataComments (default true). If true then metadata comments included |
| 497 |
> |
in extracted DDL. New Extract Object member eoComments. This may be used with |
| 498 |
> |
ExtractObject method to list all metadata comments. |
| 499 |
> |
|
| 500 |
> |
32. TIBExtract: ListObjectNames method added. |
| 501 |
> |
|
| 502 |
> |
33. Updated Database component editor to support additional connection string |
| 503 |
> |
types. |
| 504 |
> |
|
| 505 |
> |
IBX Change Log version (2.2-0) Wed, 28 Feb 2018 10:57:45 +0000 |
| 506 |
> |
|
| 507 |
> |
NOTE: THE LOCATIONS OF SOME OF THE UNIT DIRECTORIES HAS CHANGED FROM IBX 2.1. THIS IS TO |
| 508 |
> |
AVOID DUPLICATE PPU WARNINGS. PLEASE REMOVE EARLIER VERSIONS OF IBX BEFORE INSTALLING THIS |
| 509 |
> |
RELEASE. |
| 510 |
> |
|
| 511 |
> |
NOTE: THE DBADMIN DEMO REQUIRES THAT THE MemDSLaz PACKAGE IS INSTALLED IN THE LAZARUS IDE. |
| 512 |
> |
|
| 513 |
> |
1. IBExtract: Identity columns - add additional check for null column for generator name. |
| 514 |
> |
|
| 515 |
> |
2. IBCustomDataSet: Insert and Modify (Update) queries now recognise and process SQL RETURNING clauses. |
| 516 |
> |
The main use for this is for Firebird 3 Identity columns (see IBXDocumentation 6.6.8 for further |
| 517 |
> |
information). However, this is also a very useful mechanism for returning updated computed by |
| 518 |
> |
column values. Values returned as a result of executing an Insert or Update statement |
| 519 |
> |
replace existing values in the current row for each corresponding column. |
| 520 |
> |
|
| 521 |
> |
Previously, if a dataset's select query included read only (computed by) fields then |
| 522 |
> |
an automatic row refresh was performed after an insert or update query had been processed, |
| 523 |
> |
irrespective of the setting of the "ForcedUpdates" property. This has changed such |
| 524 |
> |
that an automatic refresh is no longer performed if an insert or update query contains |
| 525 |
> |
a returning clause that updates one or more fields on the current row. A full row |
| 526 |
> |
refresh is only performed if (a) ForcedRefresh is true or (b) the query does not return any |
| 527 |
> |
field values and the select query contains read only fields. Use of Insert/update |
| 528 |
> |
returning should be significantly more efficient than executing a refresh query. |
| 529 |
> |
|
| 530 |
> |
This behaviour change is intended to be backwards compatible and there should be no need to change |
| 531 |
> |
existing programs, other than to improve performance by using the new capability. |
| 532 |
> |
|
| 533 |
> |
3. IBCustomDataSet: DELETE...RETURNING queries are now also recognised. However, as |
| 534 |
> |
they are called when the dataset row is being deleted, there is no value in |
| 535 |
> |
updating the current record from the query result. Instead, a new event handler |
| 536 |
> |
"OnDeleteReturning" is provided. If a DELETE...RETURNING query is execute and |
| 537 |
> |
an OnDeleteReturning event handler is provided then it is called with the IResults returned |
| 538 |
> |
by the query. The event handler can then interrogate the query results and |
| 539 |
> |
perform whatever action is necessary. For example to confirm, to the user, |
| 540 |
> |
the deletion of a row with the returned values. |
| 541 |
> |
|
| 542 |
> |
4. TIBTable: generated Insert and Update SQL now include a RETURNING clause for |
| 543 |
> |
any Computed By or Identity Columns. The IBTables example has been updated to |
| 544 |
> |
illustrate the computation of the employee Full Name on update. |
| 545 |
> |
|
| 546 |
> |
5. TIBTable: The GeneratorField property is now published. |
| 547 |
> |
|
| 548 |
> |
6. The InsertSQL property editor now shows Firebird 3 Identity columns separate from the Field List. |
| 549 |
> |
When InsertSQL is generated, the Identity columns are not included in the list of values to |
| 550 |
> |
be inserted. A RETURNING clause is added to the insert statement to return the value of |
| 551 |
> |
each Identity column after the insert is executed. |
| 552 |
> |
|
| 553 |
> |
7. The Modify Property Editor now generates Update SQL with Computed By fields in Update..Returning clause. |
| 554 |
> |
Similarly Insert Property Editor now generates Insert SQL with Computed By fields in |
| 555 |
> |
Insert..Returning clause. |
| 556 |
> |
|
| 557 |
> |
8. TIBGenerator: small performance improvement by not preparing query each time |
| 558 |
> |
a new value is generated. |
| 559 |
> |
|
| 560 |
> |
9. TIBSQL: Free resources when transaction changed - ensures new transaction is used. |
| 561 |
> |
|
| 562 |
> |
10. Property editors will now sync table name to a System Table when "Include System |
| 563 |
> |
Tables" is selected and the query is for a System Table. |
| 564 |
> |
|
| 565 |
> |
11. Minor Performance improvement to handling of Date/Time types in IBX datasets. Field |
| 566 |
> |
values are no longer converted to milliseconds from TDateTime and then back again |
| 567 |
> |
to TDateTime (the conversion to milliseconds is the default TDataset approach). |
| 568 |
> |
|
| 569 |
> |
12. Property Editors handling of Stored Procedures. |
| 570 |
> |
* Select and Refresh: only show a list of stored procedures that return multiple rows (proc type 1) and |
| 571 |
> |
which have a non-empty list of output parameters (i.e. stored procedures that may be used in a select |
| 572 |
> |
query). |
| 573 |
> |
* Modify and Insert: only show a list of stored procedures that return at most a singleton row (proc type 2). |
| 574 |
> |
|
| 575 |
> |
13. IBStoredProc: Now supports Firebird 3 Package Names. A new published property PackageName |
| 576 |
> |
can be used to select a package. If non-empty, the stored procedure name is |
| 577 |
> |
expected to be a stored procedure defined in the specified package and the |
| 578 |
> |
generated SQL will be as required for a stored procedure located in a package. |
| 579 |
> |
|
| 580 |
> |
14. Select, Refresh, Insert, Modify, Delete and TIBSQL SQL Property Editors now include |
| 581 |
> |
a "Package Name" drop down box to allow selection of a Firebird 3 Package from |
| 582 |
> |
which a stored procedure can be selected. With no package name selected, non-package |
| 583 |
> |
stored procedures are listed. |
| 584 |
> |
|
| 585 |
> |
15. TIBXScript: turn off database login prompt when reconnecting - this avoids prompting |
| 586 |
> |
for password on reconnect. |
| 587 |
> |
|
| 588 |
> |
16. TIBDatabase: use IAttachment for connection default character set id, code page |
| 589 |
> |
and character set name. |
| 590 |
> |
|
| 591 |
> |
17. TIBDatabaseInfo: cache ODS Version information on first request in order to minimise |
| 592 |
> |
DB info lookups" |
| 593 |
> |
|
| 594 |
> |
18. IBExtract: now supports DDL Triggers and Grants to DDL objects. |
| 595 |
> |
|
| 596 |
> |
19. Add a property Editor for TIBUpdate.RefreshSQL. |
| 597 |
> |
|
| 598 |
> |
20. IBUpdate: Ignore non-data (e.g. calculated) fields when assembling list of input |
| 599 |
> |
parameters. This stops an exception being raised when the field cannot be |
| 600 |
> |
located in the record buffer. |
| 601 |
> |
|
| 602 |
> |
21. Property Editors now automatically include System Tables when opened and when the query table |
| 603 |
> |
is a System Table. |
| 604 |
> |
|
| 605 |
> |
22. IBServices: SQRB and SRB buffers are now reset when service query throws an exception. |
| 606 |
> |
This avoids errors due to a stale SQRB or SRB being used for the next query. |
| 607 |
> |
|
| 608 |
> |
23. IBServices: Service attach parameters now include "expected_db". This is used to |
| 609 |
> |
add the SPB item isc_spb_expected_db. This names a database using |
| 610 |
> |
an alternative Security Database (FB3 onwards) and allows (e.g. backup/restore) using such a |
| 611 |
> |
database. examples/services re-written to illustrate use of "expected_db". |
| 612 |
> |
|
| 613 |
> |
24. IBServices: TIBControlAndQueryService.WriteNextChunk no longer ignores isc_info_svc_timeout. |
| 614 |
> |
This avoids truncated backups when the server returns a timeout (busy) response. |
| 615 |
> |
|
| 616 |
> |
25. TIBDatabase: isc_dpb_page_size now supported as a database parameter when using TIBDatabase.CreateDatabase. |
| 617 |
> |
|
| 618 |
> |
26. TIBDatabase: DatabaseName property may now be prefixed by $TEMP$ or $DATADIR$ for local |
| 619 |
> |
databasenames. These are respectively expanded to the local system's temp directory |
| 620 |
> |
(including trailing delimiter) or to a prescribed data directory (including |
| 621 |
> |
trailing delimiter). Under Unix systems the data directory is a hidden directory |
| 622 |
> |
in the user's home directory. The hidden directory name is either the string returned |
| 623 |
> |
from the SysUtils "Vendor Name" or "IBX" if empty. In either case prefixed by a '.'. |
| 624 |
> |
Under Windows, the directory is the same as the Data Directory as decribed |
| 625 |
> |
above but instead prefixed by the User's application data path. These may be |
| 626 |
> |
used to improve application portability for Personal Databases. |
| 627 |
> |
|
| 628 |
> |
27. TIBTable: FieldDefs property is no longer published. Due to the use of TIBFieldDef |
| 629 |
> |
this has not worked for a long time and is not useful either. FieldDefs should be |
| 630 |
> |
managed using the Fields Editor as with any other dataset. To access the fields |
| 631 |
> |
editor for a TIBTable component, double click on the component. The fields editor |
| 632 |
> |
is then displayed. |
| 633 |
> |
|
| 634 |
> |
28. TIBDatabaseInfo: new properties/function |
| 635 |
> |
* DateDBCreated (returns date/time database created) |
| 636 |
> |
* TransactionCount (returns no. of active transactions) |
| 637 |
> |
* GetDatabasePage(PageNo: integer) (returns contents of specified database page - SYSDBA only). |
| 638 |
> |
* PagesFree (Firebird 3 or later) |
| 639 |
> |
* PagesUsed (Firebird 3 or later) |
| 640 |
> |
* Encrypted (returns true if database encrypted. (Firebird 3.0.3 or later only) |
| 641 |
> |
* EncryptionKeyName (returns the name of the encryption key if any (Firebird 3.0.3 or later only) |
| 642 |
> |
|
| 643 |
> |
29. IBServices classes now provided the decoded release number in the (array) property ServerVersionNo. |
| 644 |
> |
|
| 645 |
> |
30. TIBSecurityService now supports display/modification of the User Admin Role (Firebird 2.5 and later). |
| 646 |
> |
|
| 647 |
> |
31. TIBConfigService now has a procedure SetAutoAdmin(Value: boolean) to enable/disable |
| 648 |
> |
the automtic mapping of privileged OS users to the RDB$ADMIN role (Firebird 2.5 and later). |
| 649 |
> |
|
| 650 |
> |
32. TIBBackupService: New Option - NoDBTriggers equivalent to -nodbtriggers switch introduced |
| 651 |
> |
in the gbak utility at V.2.1 to prevent database-level and transaction-level triggers from |
| 652 |
> |
firing during backup and restore. |
| 653 |
> |
|
| 654 |
> |
33. Both TIBBackupService and TIBRestoreService now support backup/restore statistics options |
| 655 |
> |
for verbose output using the new property "StatisticsRequested". |
| 656 |
> |
see https://firebirdsql.org/file/documentation/release_notes/html/en/2_5/rnfb25-util-gbak.html#rnfb25-util-gbakstats |
| 657 |
> |
|
| 658 |
> |
34. TIBRestoreService: now supports new options RestoreMetaDataOnly (Firebird 2.5 and later). |
| 659 |
> |
|
| 660 |
> |
35. TIBOnlineValidationService component added to the IBServices and the "Firebird Admin" |
| 661 |
> |
palette. This uses the online validation feature added in Firebird 2.5. The |
| 662 |
> |
services's properties enable inclusion/exclusion of tables and indexes using |
| 663 |
> |
regular expressions. See. |
| 664 |
> |
https://firebirdsql.org/file/documentation/release_notes/html/en/2_5/rnfb25-apiods-api.html#rnfb25-apiods-api-onlinevalidation |
| 665 |
> |
|
| 666 |
> |
36. IBServices: procedure TIBConfigService.SetNoLinger added to set no linger |
| 667 |
> |
option on a database. |
| 668 |
> |
|
| 669 |
> |
37. TIBCustomService: Assign method implemented to allow copying of service login |
| 670 |
> |
context between service API components. "Detach" method now only detaches |
| 671 |
> |
service when last reference to the service interface detaches. Tidy up of |
| 672 |
> |
code for SetActive and Attach methods including password hiding. |
| 673 |
> |
|
| 674 |
> |
38. TIBDatabase: new properties: AuthenticationMethod and RemoteProtocol. Read only |
| 675 |
> |
and used to determine the auth method and protocol used for the connection. |
| 676 |
> |
|
| 677 |
> |
39. TIBDatabase: ensure that SQLDialect setting is used when creating a database using |
| 678 |
> |
a Create Database Statement generated by IBX. |
| 679 |
> |
|
| 680 |
> |
40. All IBServices now have an additional published property "PortNo". This may |
| 681 |
> |
be set to a non-standard port number when necessary. If zero then the default |
| 682 |
> |
port number is used. |
| 683 |
> |
|
| 684 |
> |
41: TIBLookupComboeditBox: Ensure dataset updated when change selected with the keyboard |
| 685 |
> |
and not just the mouse. |
| 686 |
> |
|
| 687 |
> |
42. TIBCustomDataset: reopen query if already active when a TIBControlLink is added. |
| 688 |
> |
|
| 689 |
> |
43. TIBTreeview: new ImageIndexField and SelectedIndexField Property allows the |
| 690 |
> |
image index and selected image index for each node to be set from a database field. |
| 691 |
> |
|
| 692 |
> |
44. TIBExtract: new extract type (etGrantsToUser) for use with eoDatabase. If included |
| 693 |
> |
then database schema includes grants to all users. If not present then the |
| 694 |
> |
only user grants included are those to User PUBLIC. |
| 695 |
> |
|
| 696 |
> |
45. TIBTreeView: performance improvement. When expanding include both expanded node |
| 697 |
> |
and child nodes in dataset. |
| 698 |
> |
|
| 699 |
> |
|
| 700 |
> |
IBX Change Log version (2.1-0) Fri, 15 Dec 2017 12:20:11 +0000 |
| 701 |
|
|
| 702 |
|
1. IBCustomDataset: Minor change of PChar to PByte for compatibility with fbintf |
| 703 |
|
changes. |
