ViewVC Help
View File | Revision Log | Show Annotations | Download File | View Changeset | Root Listing
root/public/ibx/branches/udr/changelog
Revision: 375
Committed: Sun Jan 9 23:42:58 2022 UTC (2 years, 2 months ago) by tony
File size: 33298 byte(s)
Log Message:
Fixes

File Contents

# Content
1 FBINTF Change Log version (1.4-0 Build 12952) Tue, 07 Dec 2021 11:53:46 +0000
2
3 1. Client side journaling support added. Interface changes
4 IAttachment
5 function JournalingActive: boolean;
6 function GetJournalOptions: TJournalOptions;
7 function StartJournaling(aJournalLogFile: AnsiString): integer; overload;
8 function StartJournaling(aJournalLogFile: AnsiString; Options: TJournalOptions): integer; overload;
9 function StartJournaling(S: TStream; Options: TJournalOptions): integer; overload;
10 procedure StopJournaling(RetainJournal: boolean);
11
12 2. Transactions may now be given a local transaction name:
13 IFirebirdAPI
14 function StartTransaction(Attachments: array of IAttachment;
15 TPB: array of byte; DefaultCompletion: TTransactionCompletion=taCommit): ITransaction; overload;
16 TPB: array of byte; DefaultCompletion: TTransactionCompletion=taCommit;
17 aName: AnsiString=''): ITransaction; overload;
18 function StartTransaction(Attachments: array of IAttachment;
19 TPB: ITPB; DefaultCompletion: TTransactionCompletion=taCommit): ITransaction; overload;
20 TPB: ITPB; DefaultCompletion: TTransactionCompletion=taCommit;
21 aName: AnsiString=''): ITransaction; overload;
22
23 IAttachment
24 function StartTransaction(TPB: array of byte; DefaultCompletion: TTransactionCompletion=taCommit): ITransaction; overload;
25 function StartTransaction(TPB: ITPB; DefaultCompletion: TTransactionCompletion=taCommit): ITransaction; overload;
26 function StartTransaction(TPB: array of byte;
27 DefaultCompletion: TTransactionCompletion=taCommit;
28 aName: AnsiString=''): ITransaction; overload;
29 function StartTransaction(TPB: ITPB;
30 DefaultCompletion: TTransactionCompletion=taCommit;
31 aName: AnsiString=''): ITransaction; overload;
32
33 ITransaction
34 function GetTransactionName: AnsiString;
35 procedure SetTransactionName(aValue: AnsiString);
36
37 3. Additional Transaction information
38 ITPB.function AsText: AnsiString; {Returns TPB as a text string}
39
40 ITransaction
41 function GetDefaultCompletion: TTransactionCompletion;
42 function GetJournalingActive(attachment: IAttachment): boolean; {attachment must be specified when multi-database transaction}
43
44 4. New IAttachment helper functions
45 function HasTable(aTableName: AnsiString): boolean;
46 function HasFunction(aFunctionName: AnsiString): boolean;
47 function HasProcedure(aProcName: AnsiString): boolean;
48 function GetAttachmentID: integer;
49 function GetCharSetID: integer;
50
51 5. IStatement: if the BatchRowLimit is set to maxint, the maximum possible buffer size
52 will be allocted for batch operations.
53
54 6. IStatement, IColumnMetaData and ISQLParam all now consistently provide:
55 function GetStatement: IStatement;
56 function GetTransaction: ITransaction;
57 function GetAttachment: IAttachment;
58
59 7. Internal: a more disciplined approach to the handling of Firebird.IReferenceCounted
60 interfaces.
61
62 8. New interface type: IFBNumeric. IFBNumeric is implemented in the unit FBNumeric
63 and concentrates all handling of Fixed Point numbers. New ISQLItem and ISQLParam
64 functions getAsNumeric and setAsNumeric allow for direct retrival and manipulation
65 of numerics without loss of precision.
66
67 9. TryStrToNumeric and NumericToDouble moved from IBUtils to FBNumeric.
68
69 10. ISQLParams new method "Clear"
70
71 11. Support package fbudr added for support of User Defined Routines (UDRs).
72
73 12. Package layout changed with introduction of udr support. IB*.pas files moved from
74 root directory to "client". IBHeader move to "Client".
75
76 13. Connection Info (e.g. ODS Version, Remote Protocol) now retrieved on first
77 request rather than on attachment connect.
78
79
80 FBINTF Change Log version (1.3-3 Build 12935) Mon, 06 Dec 2021 23:17:13 +0000
81
82 1. Fix compile error with fpc trunk (3.3.1 and later), due to type change to tzname in "unix" unit.
83
84 2. Remove constraint in IAttachment.HasScollableCursors that returned false when
85 using remote protocol. Scrollable cursors with remote database expected to
86 be support for Firebird 4.0.1 onwards. Note: Firebird 4.0.0 will return
87 a not supported error.
88
89 3. IStatement: new function;
90 TStatementFlag = (stHasCursor,stRepeatExecute,stScrollable);
91 TStatementFlags = set of TStatementFlag;
92 function GetFlags: TStatementFlags;
93
94 4. Revised behaviour for IStatement.ExecuteQuery in order to preserve backwards
95 compatibility.
96 In Firebird 5, Update..Returning may returns multiple rows and hence the statemen
97 type changes from ExecProcedure to Select. So that ExecuteQuery can continue
98 to be used with Update...Retruning statements that return a singleton row,
99 instead of raising an exception when ExecuteQuery is used with a (SELECT) statement,
100 it will open the cursor and return the first row only.
101
102 5. ITransaction: new functions:
103 function GetIsReadOnly: boolean;
104 function GetTransactionID: integer;
105 function GetTrInformation(Requests: array of byte): ITrInformation; overload;
106 function GetTrInformation(Request: byte): ITrInformation; overload;
107
108 The latter two return the Transaction Information block. The first two extract
109 information the Transaction Information block
110
111 6. New function TSQLTokeniser.ReadCharacters
112 Used internally.
113
114 7. IStatement: GetProcessedSQL bug fix. No longer raises and error if SQL contains
115 parameter placeholders instead of named parameters.
116
117 8. ITransaction (Firebird 3 and later): An exception raised when freeing an underlying
118 transaction handle is now ignored if Rollback/Commit is called with Force=true
119
120 9. Tidy up of exception handling code. Under the legacy API, fb_interpret is now
121 used to get an IBError Message instead of isc_interprete.
122
123 10. Internal tidyup. Native code now used for decoding integers and the events
124 buffer. Avoids dependencies on fbclient functions isc_portable_integer,
125 isc_event_block and isc_event_counts.
126
127 11. New IAttachment function
128 function GetAttachmentID: integer;
129
130 12. Internal changes to TFBClientAPI, TFBAttachment and TFBTransaction and TFB30
131 subclasses to enable UDR support.
132
133 FBINTF Change Log version (1.3-2 Build 12889) Sun, 24 Oct 2021 13:49:28 +0100
134
135 1. TFBClientAPI.GetProcAddr. Add check for nil reference.
136
137 2. IStatement: new methods:
138 procedure SetStaleReferenceChecks(Enable:boolean); {default true}
139 function GetStaleReferenceChecks: boolean;
140
141 In previous versions, stale reference checks were always enabled. This allows the
142 user to disable them on a per statement basis. Note this can risk out-of-date
143 statement BLR. See User Guide.
144
145 3. IBUtils: TSQLwithNamedParamsTokeniser now recognises a CASE...END block within a
146 stored procedure and hence avoids replacing named parameters within a containing
147 BEGIN..END block.
148
149 4. ISQLParam: using a string value to set an integer field with a scale factor of
150 zero is now treated as a special case to avoid the risk of floating point
151 rounding errors affecting pure integers.
152
153 5. ISQLParam: Review and tidy-up of SetAsString for numeric types.
154
155 6. ISQLParam is now subclassed from IParamMetaData, which provides access to the mutable
156 SQL Parameter metadata (methods moved from ISQLParam).
157
158 7. ISQLParam: new method
159 function getColMetadata: IParamMetaData;
160 This instance of IParamMetaData returns the original column metadata which is unmutable.
161 Note: ISQLParam metadata can change after a parameter value has been set e.g when
162 setting a VARCHAR column to an integer value.
163
164 8. IStatement: can now set cursor name when opening a cursor. New overloaded method:
165 procedure Prepare(CursorName: AnsiString; aTransaction: ITransaction=nil); overload;
166 also IAttachment:
167 function Prepare(transaction: ITransaction; sql: AnsiString; aSQLDialect: integer; CursorName: AnsiString=''): IStatement; overload;
168 function Prepare(transaction: ITransaction; sql: AnsiString; CursorName: AnsiString=''): IStatement; overload;
169 function PrepareWithNamedParameters(transaction: ITransaction; sql: AnsiString;
170 aSQLDialect: integer; GenerateParamNames: boolean=false;
171 CaseSensitiveParams: boolean = false; CursorName: AnsiString=''): IStatement; overload;
172 function PrepareWithNamedParameters(transaction: ITransaction; sql: AnsiString;
173 GenerateParamNames: boolean=false;
174 CaseSensitiveParams: boolean = false; CursorName: AnsiString=''): IStatement; overload;
175
176 9. Support for scrollable cursors added. New/updated methods:
177 IAttachment:
178 function HasScollableCursors: boolean;
179 function OpenCursor(transaction: ITransaction; sql: AnsiString; aSQLDialect: integer;
180 Scrollable: boolean=false): IResultSet; overload;
181 function OpenCursor(transaction: ITransaction; sql: AnsiString; Scrollable: boolean=false): IResultSet; overload;
182 function OpenCursor(transaction: ITransaction; sql: AnsiString; aSQLDialect: integer; Scrollable: boolean;
183 params: array of const): IResultSet; overload;
184 function OpenCursor(transaction: ITransaction; sql: AnsiString; Scrollable: boolean=false;
185 params: array of const): IResultSet; overload;
186 function OpenCursorAtStart(transaction: ITransaction; sql: AnsiString; aSQLDialect: integer; Scrollable: boolean;
187 params: array of const): IResultSet; overload;
188 function OpenCursorAtStart(transaction: ITransaction; sql: AnsiString; aSQLDialect: integer;
189 Scrollable: boolean=false): IResultSet; overload;
190 function OpenCursorAtStart(transaction: ITransaction; sql: AnsiString; Scrollable: boolean=false): IResultSet; overload;
191 function OpenCursorAtStart(transaction: ITransaction; sql: AnsiString; Scrollable: boolean;
192 params: array of const): IResultSet; overload;
193 function OpenCursorAtStart(sql: AnsiString; Scrollable: boolean=false): IResultSet; overload;
194 function OpenCursorAtStart(sql: AnsiString; Scrollable: boolean;
195 params: array of const): IResultSet; overload;
196 IStatement:
197 function OpenCursor(Scrollable: boolean; CursorName: AnsiString =''; aTransaction: ITransaction=nil): IResultSet; overload;
198 IResultSet:
199 function FetchPrior: boolean; {fetch previous record}
200 function FetchFirst:boolean; {fetch first record}
201 function FetchLast: boolean; {fetch last record}
202 function FetchAbsolute(position: Integer): boolean; {fetch record by its absolute position in result set}
203 function FetchRelative(offset: Integer): boolean; {fetch record by position relative to current}
204 function IsBof: boolean;
205
206 10. IArray: tidyup of SetAsString method to ensure correct handling of fixed point numbers.
207
208 11. IBUtils: TSQLTokeniser. CRLF now combined by low level parser into sqltEOL token. This
209 may be noticeable when a line separator occurs inside quoted text. The quoted text
210 output by the tokeniser will now use the platform specific lineEnding regardless
211 of whether the input uses the CRLF or LF as a line separator.
212
213 12. IStatement, IResultsSet: Support for scrollable cursors added (note: local databases only)
214
215
216 FBINTF Change Log version (1.3-1 Build 12776) Mon, 23 Aug 2021 11:09:33 +0100
217
218 1. Integer decodes in information blocks (e.g. IDBInfoItem) widened from 32 bit to 64-bit integers.
219
220 2. Support for inline blob encoding. Blob values pass using the "SetAsString" method
221 will now be encoded inline (i.e. as part of the parameter buffer) if they are
222 shorter than a pre-set limit. Longer values continue to be saved as blobs as a
223 separate server interaction. This is intended as a performance optimisation.
224
225 The pre-set limit defaults to 8192 bytes and can be inspected/modified using the new
226 IAttachment interface functions:
227
228 function GetInlineBlobLimit: integer;
229 procedure SetInlineBlobLimit(limit: integer);
230
231 3. Support for Firebird 4 IBatch interface added. This is largely transparent to the API
232 user as the functionality is embedded in the implementation of the IStatement
233 interface. Three new functions are defined:
234
235 procedure AddToBatch;
236 function ExecuteBatch(aTransaction: ITransaction=nil): IBatchCompletion;
237 procedure CancelBatch;
238 function GetBatchCompletion: IBatchCompletion;
239 function GetBatchRowLimit: integer;
240 procedure SetBatchRowLimit(aLimit: integer);
241
242 Also
243
244 function IsInBatchMode: boolean; {true after call to execute(eaDefer)}
245 function HasBatchMode: boolean; {true if and only if IBatch Supported}
246
247 For more information see the User Guide.
248
249 4. Default error message contents. Now aligned with User Guide section 10.2 i.e. error messages
250 provided with the EIBInterBaseError now include all three parts.
251
252 5. Firebird.pas and include files updated to Firebird 4.0.0
253
254 6. New IStatement method: function GetSQLStatementTypeName: AnsiString;
255 Returns SQL Statement type as a text string;
256
257 7. ISQLData.AsInteger and AsInt64 now use "Round" to convert a float field to
258 an integer instead of "trunc". This is for compatibility with TFloatField.AsInteger.
259
260 FBINTF Change Log version (1.2-1 Build 12552) Wed, 09 Jun 2021 13:05:40 +0100
261
262 1. Big fix for Firebird 4.0. A internal change in Firebird 4.0.0 from RC1 flushed out a
263 typo in FB30Statement.pas that caused an unknown parameter error.
264
265 FBINTF Change Log version (1.2-0 Build 12520) Fri, 19 Feb 2021 13:27:23 +0000
266
267 1. Imported (Firebird) constants updated for Firebird 4.
268
269 2. Firebird.pas from Firebird 4 integrated into source code tree.
270
271 3. Added Support for TIMETAMP WITH TIME ZONE and TIME WITH TIME ZONE data types.
272
273 4. Added Support for SQL_DEC16, SQL_DEC34 and extended NUMERIC precision.
274
275 5. New unit 'FBClientLib.pas' added and provides new interface IFBIMasterProvider.
276 QueryInterface may be used to coerce this interface from IFirebirdAPI. The
277 interface provides a single method "function GetIMasterIntf: IMaster". This provides
278 type safe access to the Firebird IMaster interface and avoids the need to turn
279 off object checks when coercing "function GetIMaster: TObject" to IMaster.
280
281 6. New IFirebirdAPI Calls:
282 function HasLocalTZDB: boolean;
283 function HasTimeZoneSupport: boolean;
284 function HasExtendedTZSupport: boolean;
285 procedure SQLDecFloatEncode(aValue: tBCD; SQLType: cardinal; bufptr: PByte);
286 function SQLDecFloatDecode(SQLType: cardinal; scale: integer; bufptr: PByte): tBCD;
287
288 7. New IAttachment Calls:
289 function HasDecFloatSupport: boolean;
290 function GetTimeZoneServices: ITimeZoneServices;
291 function HasTimeZoneSupport: boolean;
292
293 8. New Interface ITimeZoneServices.
294
295 9. New ISQLData API Calls:
296 procedure GetAsDateTime(var aDateTime: TDateTime; var dstOffset: smallint; var aTimezoneID: TFBTimeZoneID); overload;
297 procedure GetAsDateTime(var aDateTime: TDateTime; var dstOffset: smallint; var aTimezone: AnsiString); overload;
298 procedure GetAsTime(var aTime: TDateTime; var dstOffset: smallint; var aTimezoneID: TFBTimeZoneID; OnDate: TDateTime); overload;
299 procedure GetAsTime(var aTime: TDateTime; var dstOffset: smallint; var aTimezone: AnsiString; OnDate: TDateTime); overload;
300 function GetAsUTCDateTime: TDateTime;
301 function GetAsBCD: tBCD;
302
303 10. New ISQLParam API Calls
304 procedure GetAsDateTime(var aDateTime: TDateTime; var dstOffset: smallint; var aTimezoneID: TFBTimeZoneID); overload;
305 procedure GetAsDateTime(var aDateTime: TDateTime; var dstOffset: smallint; var aTimezone: AnsiString); overload;
306 procedure GetAsTime(var aTime: TDateTime; var dstOffset: smallint; var aTimezoneID: TFBTimeZoneID; OnDate: TDateTime); overload;
307 procedure GetAsTime(var aTime: TDateTime; var dstOffset: smallint; var aTimezone: AnsiString; OnDate: TDateTime); overload;
308 function GetAsUTCDateTime: TDateTime;
309 function GetAsBCD: tBCD;
310 function GetStatement: IStatement;
311 function GetTransaction: ITransaction;
312 procedure SetAsTime(aValue: TDateTime; OnDate: TDateTime; aTimeZoneID: TFBTimeZoneID); overload;
313 procedure SetAsTime(aValue: TDateTime; OnDate: TDateTime; aTimeZone: AnsiString); overload;
314 procedure SetAsDateTime(aValue: TDateTime; aTimeZoneID: TFBTimeZoneID); overload;
315 procedure SetAsDateTime(aValue: TDateTime; aTimeZone: AnsiString); overload;
316 procedure SetAsUTCDateTime(aUTCTime: TDateTime);
317 procedure SetAsBcd(aValue: tBCD);
318
319 11. New IArray API Calls
320 procedure GetAsDateTime(index: array of integer; var aDateTime: TDateTime; var dstOffset: smallint; var aTimezoneID: TFBTimeZoneID); overload;
321 procedure GetAsDateTime(index: array of integer; var aDateTime: TDateTime; var dstOffset: smallint; var aTimezone: AnsiString); overload;
322 procedure GetAsTime(index: array of integer; var aTime: TDateTime; var dstOffset: smallint; var aTimezoneID: TFBTimeZoneID; OnDate: TDateTime); overload;
323 procedure GetAsTime(index: array of integer; var aTime: TDateTime; var dstOffset: smallint; var aTimezone: AnsiString; OnDate: TDateTime); overload;
324 function GetAsUTCDateTime(index: array of integer): TDateTime;
325 procedure SetAsDateTime(index: array of integer; aValue: TDateTime; aTimeZoneID: TFBTimeZoneID); overload;
326 procedure SetAsDateTime(index: array of integer; aValue: TDateTime; aTimeZone: AnsiString); overload;
327 procedure SetAsTime(index: array of integer; aValue: TDateTime; OnDate: TDateTime; aTimeZoneID: TFBTimeZoneID); overload;
328 procedure SetAsTime(index: array of integer; aValue: TDateTime; OnDate: TDateTime; aTimeZone: AnsiString); overload;
329
330 12. Utility functions in IBUtils
331 function ParseDateTimeTZString(aDateTimeStr: Ansistring; var aDateTime: TDateTime;
332 var aTimezone: AnsiString; aFormatSettings: TFormatSettings; TimeOnly: boolean=false): boolean;
333 procedure FBDecodeTime(aTime: TDateTime; var Hour, Minute, Second: word; var DeciMillisecond: cardinal);
334 function FBEncodeTime(Hour, Minute, Second, DeciMillisecond: cardinal): TDateTime;
335 function FBFormatDateTime(fmt: AnsiString; aDateTime: TDateTime): AnsiString;
336 function FormatTimeZoneOffset(EffectiveTimeOffsetMins: integer): AnsiString;
337 function DecodeTimeZoneOffset(TZOffset: AnsiString; var dstOffset: integer): boolean;
338
339 13. IDPB, ITPB and ISPB: new interface method
340 function AddByTypeName(ParamTypeName: AnsiString): IDPBItem/ITPBItem/ISPBItem;
341 This is used to add a parameter block item by the string equivalent of its
342 symbolic type name. e.g. DPB.AddByTypeName('isc_dpb_user_name').AsString := '...'
343
344 14. IDPBItem/ITPBItem/ISPBItem: new interface method:
345 function getParamTypeName: AnsiString;
346
347 15. fb_shutdown now called before unloading Firebird library. This can avoid a
348 SIGEVENT error when a programme using the embeded server is unloaded.
349
350 FBINTF Change Log version (1.1-6 Build 12237) Tue, 21 Jul 2020 08:54:21 +0100
351
352 1. GetImplementationVersion now correctly returns '3.0' for Firebird 3 API
353 with a Firebrid 3 client library.
354
355 2. Linux Only: FIREBIRD environment variable is now checked when loading the client library.
356 If a client library path is not explicitly provided and the FIREBIRD environment
357 variable is set then the directory given by this variable and any 'lib' subdirectory
358 are searched for the Firebird client library. Only if none is found, is the default
359 client library used.
360
361 3. IUtil.FormatStatus now used to format error messages when using new API
362
363 4. Fixed Array SDL: array_desc_scale now correctly encoded as a signed integer.
364
365 5. SQL_TEXT handling changed. When the value of an SQL_TEXT (i.e. fixed width string) column is
366 returned using GetAsString and the string codepage is UTF8, the string is truncated so
367 that the byte length corresponds to the number of characters specified for the column.
368 SQL_TEXT strings are no longer automatically trimmed to remove all trailing white space. This is
369 correct behaviour but may affect some implementations that relied upon automatic
370 trimming of trailing white space.
371
372 6. New IFirebirdAPI Calls:
373 function GetClientMajor: integer;
374 function GetClientMinor: integer;
375
376 7. IColumnMetaData and IArrayMetaData: new method
377 function GetCharSetWidth: integer;
378
379 FBINTF Change Log version (1.1-5 Build 12022) Fri, 17 Apr 2020 10:35:55 +0100
380
381 1. ISQLParams.GetHasCaseSensitiveParams added. Returns true if param names are
382 case sensitive
383
384 2. Single line SQL comments starting with '--' are now recognised by SQL Parser.
385
386 3. New API Calls:
387 IColumnMetaData.GetStatement
388 IColumnMetaData.GetTransaction
389 ISQLData.GetStrDataLength
390 IResults.GetStatement
391 IAttachment.OpenBlob (using Blob metadata)
392 IAttachment.OpenArray (using array metadata)
393
394 4. FBMessages: removal of unused messages
395
396 5. TFBArray.Create (2nd case): ensure that FFirebirdClientAPI is correctly set.
397
398 6. TIBSQLStatementType: SQLSavePoint added to end of enumeration.
399
400 FBINTF Change Log version (1.1-4 Build 11515) Fri, 28 Dec 2018 10:04:19 +0000
401
402 1. Fix a problem with the SQL parameter parser that failed to recognise parameters
403 where the second character of the parameter name is a numeric.
404
405 2. New method for IAttachment: procedure getFBVersion(version: TStrings);
406 This returns the isc_version connection information as one or more lines.
407 This is the same information as returned by isql with the -z option.
408
409 3. If -dFIREBIRD3APIONLY is used as a compiler option then the legacy Firebird API
410 is no longer compiled in. Likewise, if -dLEGACYFIREBIRDAPIONLY is used as a
411 compiler option then the Firebird 3 API is no longer compiled in.
412
413 4. IColumnMetaData: new method.
414
415 TIBDateTimeFormats = (dfTimestamp, {SQL TIMESTAMP}
416 dfDateTime, {SQL DATETIME}
417 dfTime);
418
419 function GetDateTimeStrLength(DateTimeFormat: TIBDateTimeFormats): integer;
420
421 This returns the max. number of characters returned by the "AsString" method
422 when the SQL type of the column is respectively TIMESTAMP, DATETIME or TIME.
423
424 5. Additional argument for IAttachment.PrepareWithNamedParameters -
425 CaseSensitiveParams: boolean = false
426
427 If this argument is set to true then SQL parameter names are assumed to be case
428 sensitive and must be referenced (using ISQLParams.ByName) using the case
429 sensitive name.
430
431 6. Bug fix: when setting a query parameter, it is now possible, when the parameter
432 is of type VarChar or Char to set the parameter to a numeric value (e.g. using
433 .AsCurrency) and then subsequently to update the value to a non-numeric string
434 using .AsString.
435
436
437
438 FBINTF Change Log version (1.1-3) Wed, 05 Dec 2018 14:28:10 +0000
439
440 1. DARWIN only syntax error: fix missing semi-colon in TFBClientAPI.LoadIBLibrary
441
442 2. Restrict IsMultiThread check to Unix only for compatibility with
443 https://bugs.freepascal.org/view.php?id=30535
444
445 3. New SQL Tokeniser added to IBUtils. This is used to pre-process SQL with
446 named parameters and is intended to avoid problems with (e.g.) Execute Block
447 and processing internal parameters as statement parameters.
448
449 4. New interface IFirebirdLibrary provides access to the underlying firebird DLL
450 or shared object. Available via a new member (GetFBLibrary) of IFirebirdAPI.
451
452 5. New function added to IB.pas
453
454 function LoadFBLibrary(aLibPathName: string): IFirebirdLibrary
455
456 This allows a Firebird Library to be loaded from an explicit path. use the
457 IFirebirdLibrary.GetFirebirdAPI member function to get the Firebird API using
458 the library. It is possible to load Firebird libraries from different locations
459 simultaneously, each with a distinct IFirebirdAPI.
460
461 FBINTF Change Log version (1.1-2) Mon, 16 Apr 2018 09:30:32 +0100
462
463 1. Firebird.pas: {$OBJECTCHECKS OFF} added to file to avoid runtime error when
464 program compiled with -CR command line switch.
465
466 2. IServiceManager additions (informational):
467 function getProtocol: TProtocol;
468 function getPortNo: AnsiString;
469
470 3. IServiceManager improved error handling. Interfaces changed:
471 function Start(Request: ISRB; RaiseExceptionOnError: boolean=true): boolean;
472 function Query(SQPB: ISQPB; Request: ISRB; RaiseExceptionOnError: boolean=true) :IServiceQueryResults; overload;
473 function Query(Request: ISRB; RaiseExceptionOnError: boolean=true) :IServiceQueryResults; overload;
474
475 4. IAttachment addition (informational)
476 function GetSecurityDatabase: AnsiString;
477
478 5. IStatement: performance counters now updated after each Fetch. GetPerfStatistics
479 thus now returns accumulated stats for a select statement from opening a cursor
480 up to the last fetch.
481
482 6. DARWIN: uloadlibrary.inc bug fix. Many thanks to Luigi Naimi for correcting
483 the problem.
484
485 7. Type change: "TPerfCounters = array[TPerfStats] of Int64". Note "Int64"
486 replaces deprecated "comp" type.
487
488 10. Testsuite Test10 updated to include thread synchronisation for event reporting.
489
490 11. URL Connection Strings: inet4 and inet6 now recognised.
491
492 12. IBUtils: Parse and Make Connect String now recognise URL style loopback syntax.
493
494 13. IAttachment.CharSetName2CharSetID is now performed case insensitive.
495
496
497 FBINTF Change Log version (1.1-1) Tue, 27 Feb 2018 16:51:16 +0000
498
499 1. IBUtils.QuoteIdentifierIfNeeded: Add check for space character.
500
501 2. IAttachment: add two new methods
502 function HasDefaultCharSet: boolean;
503 function GetDefaultCharSetID: integer;
504
505 These return, respectively, true if a connection default character set was
506 specified and the character set id of the connection default character set.
507 The DefaultCharSetID is cached when the connection is opened and hence does not
508 require a database lookup.
509
510 3. Avoid exception when a text blob is a stored procedure parameter.
511
512 4. Update test suite to include a test for a stored proc returning a text blob.
513
514 5. IAttachment: add
515 function GetRemoteProtocol: AnsiString;
516 function GetODSMajorVersion: integer;
517 function GetODSMinorVersion: integer;
518 function GetAuthenticationMethod: AnsiString;
519
520 These results are cached when the connection is opened and hence do not
521 require a database lookup.
522
523 6. IAttachment: add "function GetConnectString: AnsiString;" This returns the
524 connect string used to create/connect to the database.
525
526 7. IAttachment: Create Database using SQL statement. The username and password
527 are now extracted and used to populate a DPB made available via IAttachment.getDPB.
528 It is now possible to use IAttachment disconnect/connect to reconnect to
529 a database for which the initial connection was established by a create
530 database sql statement. Available in FPC only.
531
532 8. Update Test 1 to test 5, 6 and 7 above.
533
534 9. IBUtils code tidy up.
535
536 10. Parameter Block interfaces "find" method. As documented, this should have
537 returned a nil interface when the item could not be found. Instead, an empty
538 interface item was returned. "Find" now works as documented and will return
539 a nil interface if the item cannot be found.
540
541 11. DBInformation: support added for isc_info_active_tran_count and isc_info_creation_date.
542
543 12. DBInformation: New interfaces: IDIRB and IDIRBItem added to support DB Information
544 requests with additional parameters. This is to enable support for fb_info_page_contents
545 (return of page contents). Response to fb_info_page_contents returned as
546 a string with code page CP_NONE.
547
548 13. DBInformation: Support for fb_info_pages_used and fb_info_pages_free added, plus
549 test suite updated.
550
551 14. DBInformation: Support for fb_info_crypt_key (Firebird 3.0.3 onwards) added as
552 a string type, and fb_info_conn_flags (Firebird 3.0.3 onwards) added as an integer type.
553
554 15. Service Manager: List of protocols supported expanded to include inet, wnet and xnet.
555 An overloaded version of IIFirebirdAPI.GetServiceManager also allows a non
556 default connection port to be specified.
557
558 FBINTF Change Log version (1.1-0) Sun, 07 Jan 2018 15:20:02 +0000
559
560 1. Fix issues with setting SQL Param values using SetAsString with Numeric types.
561 Scale is no longer ignored.
562
563 2. Fix issues with setting SQL Param values using SetAsString with Date values
564 not in locale format but which are recognised by Firebird. Date values that
565 cannot be converted to a string using Pascal library are now passed through
566 to Firebird as Text Strings.
567
568 3. Lookup character set name by codepage amended to ensure that CP_UTF8 returns
569 UTF8 and not UNICODE_FSS.
570
571 4. Charset ID problem. When using Firebird 3, with no default database character set
572 and a column has a non-default collation specified, an incorrect character set
573 id was being reported that could result in a 'division by zero' error when
574 used by IBX. This has now been fixed.
575
576 5. Move GetCharsetName, CharSetID2CodePage, CodePage2CharSetID, CharSetName2CharSetID,
577 CharSetWidth from IFirebirdAPI to IAttachment. This is a better data model as
578 the character sets supported can be updated on a per database basis. That is
579 it is possible to add a (Firebird) user defined character set to a database.
580
581 6. Add RegisterCharSet to IAttachment. This is used to register a user defined character
582 set supported by Firebird with the API.
583
584 7. Add missing isc_info_db_read_only to list of decoded Database Information items
585 in FBOutputBlock.pas and update test suite to include this item.
586
587 8. FB30Client: avoid always using "StartMultiple" when only a single database attachment.
588
589 9. Loading Windows fbclient.dll: when using the FIREBIRD variable to locate the client
590 library or finding it by disk location, the PATH environment variable is now also set to
591 include the FIREBIRD directory. This is to ensure that the correct dlls in the
592 firebird client library dependencies are loaded.
593
594 10. Testsuite: Ensure consistent UTF-8 output on Windows console.
595
596 11. Testsuite: Update Windows script to include FPC 3.0.4 in search path.
597
598 12. FB30Statement: Protect call to "Move" and avoid calling with a nil pointer
599
600 13. FB30Statement: A check has been added to ensure that all SQL Parameters
601 have been given a value (including NULL). Previously, failing to set the
602 value of an SQL Parameter could give rise to unpredictable results or
603 an SQLDA error.
604
605 14. FB30Statement/FB25Statement: Set SQLParam "modified" when string value set.
606
607 15. FBAttachment: Avoid string reference count error when processing an Ansistring
608 parameter in an array of const passed to IAttachment.OpenCursor, etc.
609
610 16. FBAttachment: Allow for WideString and UnicodeString parameters in an array
611 of const passed to IAttachment.OpenCursor, etc.
612
613
614 FBINTF Change Log version (1.0-2) Sat, 04 Mar 2017 14:43:56 +0000
615
616 1. Change syntax to Mode Delphi
617
618 2. Change all uses of string type to explicit AnsiString in order to ensure
619 compatibility between Delphi and FPC.
620
621 3. Various syntax changes to ensure Delphi and FPC compilation including GUIDs
622 defined for each interface.
623
624 4. Generics syntax variations for Delphi added
625
626 5. PChar replaced with PByte expect where an actual string is being referenced,
627 where PAnsiChar is used instead.
628
629 6. Review of type definitions in IBExternals to ensure Delphi compatibility
630
631 7. Testsuite updated for Delphi
632
633 FBINTF Change Log version (1.0-1) Fri, 24 Feb 2017 12:17:57 +0000
634
635 1. Limit maximum Blob segment read/write to MaxuShort. Avoids data loss with
636 large blobs and the FB3 API.
637
638 2. Update Event Handling algorithm to avoid looping due to recreation of the
639 event block.
640
641 3. Avoid invalid XSQLDA error when the only parameter is updated to null
642
643 4. Array Handling: fix problem with text arrays with character set none. When the
644 DB connection has a default character set (e.g. UTF8), an error is raised by
645 Firebird if the space allocated is not enough to allow for transliteration, even
646 though it is not required for character set none.
647
648 5. IBUtils: List of reserved words brought up-to-date
649
650 6. Add ISQL style performance statistics collection to IStatement
651
652 7. Add IFirebirdAPI.CreateDatabase variant to allow execution of user provided
653 CREATE DATABASE statement.
654
655 8. Update SQL Statement parsing to allow for Array Dimensions. That is so that the ':' in
656 an array dimension is not mistaken for a named parameter prefix.
657
658 9. Trim function no longer applied to result of GetAsString for SQL_TEXT
659 when Character set is octets. Avoids loss of non printable characters at start of string.
660
661 10. Add function GetPerfStatistics to IStatement. This returns ISQL like performance
662 statistics for the last action. Requires use of procedure IStatement.EnableStatistics
663 to enable stats gathering.
664
665 11. API Version information added as constants to IB.pas
666
667 12. BlobMetaData character set id should now be the same as that given by IColumnMetaData.GetCharSetID
668
669 13. Firebird Character set "NONE" now interpreted as codepage CP_ACP.
670
671 FBINTF Change Log version (1.0-0) Tue, 06 Dec 2016 10:33:47 +0000
672
673 1. Initial Release
674