ViewVC Help
View File | Revision Log | Show Annotations | Download File | View Changeset | Root Listing
root/public/ibx/branches/udr/changelog
Revision: 381
Committed: Sat Jan 15 00:06:22 2022 UTC (2 years, 2 months ago) by tony
File size: 33595 byte(s)
Log Message:
Release Candidate 1

File Contents

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

Properties

Name Value
svn:eol-style native