Jaybird 2.1 JDBC driver Java Programmer's Manual - Firebird

More documents

Recommendations

Info

commit or rollback and eventually release the resource. More information on transaction locking modes can be found in Chapter 6, Using transactions. 335544345L isc_lock_conflict "lock conflict on no wait transaction" This error happens when a “no wait” transaction needs to acquire a lock but finds another concurrent transaction holding a lock. Instead of waiting the predefined timeout hoping that concurrent transaction will either commit or rollback, an error is returned to notify an application about the situation. 335544510L isc_lock_timeout "lock time-out on wait transaction" 335544336L isc_deadlock "deadlock" Similar to the isc_deadlock, but is returned when the lock timeout that was specified for the current transaction expired while waiting for a lock. Another source of this error are DDL operations that try to obtain a lock on a database object that is currently used in some other place. Two transactions experience a deadlock when each of them has a lock on a resource on which another one is trying to obtain a lock. Referential Integrity Errors Referential integrity constrains ensure that database remains in a consistent state after the DML operation and/or whole transaction is completed. Three primary error codes are returned when the defined constraints are violated. The error messages are self-explanatory. 335544665L isc_unique_key_viola tion violation of PRIMARY or UNIQUE KEY constraint "{0}" on table "{1}" 335544558L isc_check_constraint Operation violates CHECK constraint {0} on view or table {1} 335544466L isc_foreign_key violation of FOREIGN KEY constraint "{0}" on table "{1}" DSQL Errors This group contains secondary codes for the primary error code isc_dsql_error (335544569L), that has a message "Dynamic SQL Error". 335544573L isc_dsql_datatype_err "Data type unknown" Usually this error is reported during DDL operation when the specified data type is either unknown or cannot be used in the specified statement. However it also can happen in DML operation, e.g. when an ORDER BY clause contains unknown Chapter 3. Handling exceptions 29
collation. isc_dsql_command_err "Invalid command" Error happens either during parsing the specified SQL request or by handling the DDL command. Other Errors This table contains other errors that might be interesting to the application developer, however they do not fall into any of the previous categories. 335544321L isc_arith_except "arithmetic exception, numeric overflow, or string truncation" Happens at runtime when an arithmetic exception happens, like division by zero or the numeric overflow (e.g. number does not fit the 64 bits limit). Another source of these errors are all string operations, like string concatenation producing too long string, impossibility to transliterate characters between character sets, etc. Future versions of Firebird will provide a secondary code to distinguish the exact reason of an error. 335544348L isc_no_cur_rec "no current record for fetch operation" Happens when application asks Firebird to fetch a record, but no record is available for fetching. Java applications should never get this error, since checks in the JDBC driver prevent application from executing fetch operation on the server side. 335544374L isc_stream_eof "attempt to fetch past the last record in a record stream" 335544517L isc_except "exception {0}" Application tries to execute fetch operation after all records had been already fetched. Similar to the previous error, Java application should not get this error due to the checks that happen before issuing the fetch request to the server. An custom exception has been raised on the server. Java application can examine the underlying GDSException to extract the exception message. 335544721L isc_network_error Unable to complete network request to host "{0}" This error is thrown when Java application cannot establish connection to the database server due to a network issues, e.g. host name is specified incorrectly, Firebird had not been started on the remote host, firewall configuration prevents client Chapter 3. Handling exceptions 30
Page 1 and 2: Jaybird 2.1 JDBC driver Java Progra
Page 3 and 4: Table Of Contents Table of Contents
Page 5 and 6: 1. Introduction Chapter 1. Jaybird
Page 7 and 8: Specification Details JDBC 3.0 Driv
Page 9 and 10: 2. Obtaining a connection Chapter 2
Page 11 and 12: uns. On Windows it must include the
Page 13 and 14: this purpose showed on Illustration
Page 15 and 16: jdbc:firebirdsql:embedded: jdbc:fir
Page 17 and 18: will close the physical connection
Page 19 and 20: Illustration 2.10 Shows how to acce
Page 21 and 22: Chapter 2. Obtaining a connection 2
Page 23 and 24: checking the error code which is se
Page 25 and 26: application will always use the min
Page 27: Constant name Constant value SQL_ST
Page 31 and 32: 4. Executing statements Chapter 4.
Page 33 and 34: It is also allowed to use the same
Page 35 and 36: Statement behind the scenes The exa
Page 37 and 38: dynamics” chapter, it allows to g
Page 39 and 40: code. So, the refactoring on the Il
Page 41 and 42: Therefore, if structure modificatio
Page 43 and 44: CREATE PROCEDURE factorial( max_val
Page 45 and 46: PreparedStatement stmt = connection
Page 47 and 48: import java.sql.*; import org.fireb
Page 49 and 50: Using batch updates with a prepared
Page 51 and 52: 5. Working with result sets Chapter
Page 53 and 54: Note, current implementation does n
Page 55 and 56: Statement selectStmt = connection.c
Page 57 and 58: 1 2 3 4 Connection connection = ...
Page 59 and 60: 1 2 3 Statement selectStmt = connec
Page 61 and 62: ead-committed mode sees all committ
Page 63 and 64: FirebirdConnection fbConnection = (
Page 65 and 66: Read-committed Concurrency Consiste
Page 67 and 68: 7. Working with Services Chapter 7.
Page 69 and 70: e created, use addBackupPath(String
Page 71 and 72: specified via the properties of thi
Page 73 and 74: Constant Description RESTORE_ONE_AT
Page 75 and 76: The database shutdown is performed
Page 77 and 78: gfix -mend command. After this oper
Page 79 and 80:
Method Description ● PAGE_FILL_RE
Page 81 and 82:
It can also happen that multiple tr
Page 83 and 84:
EventManager eventManager = new FBE
Page 85 and 86:
DPB Parameter and its Alias(es) isc
Page 87 and 88:
JDBC Type Firebird Type Java Object
Page 89 and 90:
This group of properties are specif
Page 91 and 92:
specialized use, because there's no
Page 93 and 94:
Firebird uses following algorithm w
Page 95 and 96:
It is clear that the conversion usi
Page 97 and 98:
Firebird encoding Java encoding Siz
Page 99 and 100:
JDBC Jaybird built-in UDF mode Nume
Page 101 and 102:
JDBC Jaybird REPLACE(strin g1, stri
Page 103:
JDBC Jaybird (interval, timestamp1,
show all

Jaybird 2.1 JDBC driver Java Programmer's Manual - Firebird

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?