Developer's Guide

Total Page:16

File Type:pdf, Size:1020Kb

Developer's Guide InterBase 6 Developer’s Guide Borland/INPRISE 100 Enterprise Way, Scotts Valley, CA 95066 http://www.interbase.com Inprise/Borland may have patents and/or pending patent applications covering subject matter in this document. The furnishing of this document does not convey any license to these patents. Copyright 1999 Inprise/Borland. All rights reserved. All InterBase products are trademarks or registered trademarks of Inprise/Borland. All Borland products are trademarks or registered trademarks of Inprise/Borland. Other brand and product names are trademarks or registered trademarks of their respective holders. 1INT0050WW21003 6E1R0699 Table of Contents List of Tables.....................................xv List of Figures....................................xvii CHAPTER 1 Using the InterBase Developer’s Guide Who should use this book .....................19 Topics covered in this book .....................20 CHAPTER 2 Client/Server Concepts Definition of a client ........................23 The InterBase client library ....................24 Definition of a server ........................25 Application development ......................26 Borland client tools applications ............... 26 Embedded applications .................... 27 API applications ........................ 28 Multi-database applications .................. 29 CHAPTER 3 Programming Applications with Delphi or C++ Builder Optimizing the InterBase SQL Links driver ............32 Setting the driver flags .................... 32 Setting the SQL pass-through mode ............. 33 Setting the SQL query mode ................. 33 Working with TTable and TQuery .................33 Setting TQuery properties and methods........... 33 Using generators ...........................34 CHAPTER 4 Programming Applications with JBuilder Installing InterClient classes into JBuilder ............38 Database application basics.................. 38 Using JDBC URLs........................ 40 Installing and administering InterServer .............41 Starting InterServer on Windows NT and 95 ........ 41 DEVELOPER’S GUIDE iii Shutting down InterServer .................. 42 Viewing InterServer information and properties ...... 42 Programming with InterClient ...................43 InterClient architecture .................... 43 InterClient communication .................. 44 Developing InterClient programs .................45 Using the JDBC interfaces................... 45 About InterClient drivers ................... 47 Accessing InterClient extensions to the JDBC........ 50 Opening a database connection ............... 50 Executing SQL statements................... 53 Executing stored procedures ................. 59 Troubleshooting InterClient programs ..............61 Handling installation problems................ 61 Debugging your application ................. 61 Deploying InterClient programs ..................62 Deploying InterClient programs as applets ......... 62 Deploying InterClient programs as applications ...... 65 InterClient/JDBC compliance specifications ...........66 InterClient extensions to the JDBC API ........... 66 JDBC features not implemented in InterClient ....... 67 InterClient implementation of JDBC features ........ 68 InterBase features not available through InterClient or JDBC ................. 69 Java SQL datatype support .................. 70 SQL-to-Java type conversions ................. 70 Java-to-SQL type conversion ................. 71 InterClient class references .................. 72 CHAPTER 5 Programming Applications with ODBC Overview of ODBC ..........................73 Programming with the ODBC driver ...............74 Configuring and using ODBC data sources ............74 Configuring data sources ................... 74 iv INTERBASE 6 TABLE OF CONTENTS CHAPTER 6 Working with UDFs and Blob Filters About UDFs ..............................76 UDF overview ............................76 Writing a function module .....................76 Writing a UDF ......................... 77 Thread-safe UDFs ....................... 78 Compiling and linking a function module ............80 Creating a UDF library..................... 81 Modifying a UDF library.................... 81 Declaring a UDF to a database ...................81 Declaring UDFs with FREE_IT ................ 83 UDF library placement .................... 84 Calling a UDF .............................85 Calling a UDF with SELECT .................. 86 Calling a UDF with INSERT .................. 86 Calling a UDF with UPDATE .................. 86 Calling a UDF with DELETE .................. 86 Writing a Blob UDF .........................87 Creating a Blob control structure .............. 87 Declaring a Blob UDF ..................... 88 A Blob UDF example...................... 89 The InterBase UDF library .....................90 Declaring Blob filters ........................92 CHAPTER 7 Using the Install and Licensing APIs About the InterBase Install API ..................94 Files in the Install API ..................... 94 What the Install API does ................... 95 The install handle ....................... 96 Error handling ......................... 96 Callback functions ....................... 97 Datatypes defined for the Install API ............ 99 Writing an InterBase install ....................99 Overview of the process ................... 100 DEVELOPER’S GUIDE v A real-world example .................... 101 The Install API functions ..................... 102 isc_install_clear_options() ................. 103 isc_install_execute() ..................... 104 isc_install_get_info() .................... 106 isc_install_get_message() .................. 107 isc_install_load_external_text() .............. 108 isc_install_precheck() .................... 109 isc_install_set_option() ................... 111 isc_install_unset_option().................. 113 isc_uninstall_execute() ................... 114 isc_uninstall_precheck() .................. 115 Using the License API ....................... 116 Loading the License API................... 116 Preparing the ib_license.dat file .............. 116 Adding server functionality ................. 117 isc_license_add() ....................... 117 isc_license_check() ..................... 118 isc_license_remove()..................... 119 isc_license_display() ..................... 120 isc_license_get_msg() .................... 120 Pseudocode for a typical install ................. 121 CHAPTER 8 Introduction to IBX The InterBase tab ......................... 125 TIBTable ............................ 126 TIBQuery ........................... 126 TIBStoredProc ......................... 127 TIBDatabase .......................... 127 TIBTransaction ........................ 127 TIBUpdateSQL ......................... 127 TIBDataSet ........................... 128 TIBSQL ............................. 128 TIBDatabaseInfo........................ 128 vi INTERBASE 6 TABLE OF CONTENTS TIBSQLMonitor ........................ 128 TIBEvents ........................... 129 The InterBase Admin tab ..................... 129 TIBConfigService....................... 130 TIBBackupService ...................... 130 TIBRestoreService ...................... 130 TIBValidationService..................... 130 TIBStatisticalService ..................... 130 TIBLogService ........................ 131 TIBSecurityService ...................... 131 TIBLicensingService ..................... 131 TIBServerProperties ..................... 131 TIBInstall ........................... 132 TIBUnInstall ......................... 132 CHAPTER 9 Designing Database Applications Using databases .......................... 134 Local InterBase databases.................. 134 Remote InterBase database servers ............ 134 Database security ...................... 135 Transactions ......................... 135 The Data Dictionary ..................... 136 Referential integrity, stored procedures, and triggers . 137 Database architecture ....................... 138 Planning for scalability ................... 139 Single-tiered database applications ............ 140 Two-tiered database applications.............. 141 Multi-tiered database applications ............. 141 Designing the user interface ................... 143 Displaying a single record ................. 144 Displaying multiple records................. 144 Analyzing data ........................ 145 Selecting what data to show ................ 145 DEVELOPER’S GUIDE vii CHAPTER 10 Building One- and Two-tiered Applications Understanding databases and datasets ............. 150 Using transactions ...................... 150 Caching updates ....................... 152 Creating and restructuring database tables ........ 153 Using the briefcase model.................. 153 Scaling up to a three-tiered application ............. 154 Creating multi-tiered applications ................ 155 CHAPTER 11 Connecting to Databases Understanding persistent and temporary database components ................. 157 Using temporary database components .......... 158 Creating database components at design time ...... 158 Controlling connections ...................... 159 Controlling server login ................... 159 Connecting to a database server .............. 160 Working with network protocols .............. 160 Using ODBC ......................... 161 Disconnecting from a database server ........... 161 Iterating through a database component’s datasets ... 161 Requesting information about an attachment ......... 162 Database characteristics................... 162
Recommended publications
  • Firebird 3.0 Developer's Guide
    Firebird 3.0 Developer’s Guide Denis Simonov Version 1.1, 27 June 2020 Preface Author of the written material and creator of the sample project on five development platforms, originally as a series of magazine articles: Denis Simonov Translation of original Russian text to English: Dmitry Borodin (MegaTranslations Ltd) Editor of the translated text: Helen Borrie Copyright © 2017-2020 Firebird Project and all contributing authors, under the Public Documentation License Version 1.0. Please refer to the License Notice in the Appendix This volume consists of chapters that walk through the development of a simple application for several language platforms, notably Delphi, Microsoft Entity Framework and MVC.NET (“Model-View-Controller”) for web applications, PHP and Java with the Spring framework. It is hoped that the work will grow in time, with contributions from authors using other stacks with Firebird. 1 Table of Contents Table of Contents 1. About the Firebird Developer’s Guide: for Firebird 3.0 . 6 1.1. About the Author . 6 1.1.1. Translation… . 6 1.1.2. … and More Translation . 6 1.2. Acknowledgments . 6 2. The examples.fdb Database . 8 2.1. Database Creation Script. 8 2.1.1. Database Aliases . 9 2.2. Creating the Database Objects. 10 2.2.1. Domains . 10 2.2.2. Primary Tables. 11 2.2.3. Secondary Tables . 13 2.2.4. Stored Procedures. 17 2.2.5. Roles and Privileges for Users . 25 2.3. Saving and Running the Script . 26 2.4. Loading Test Data . 27 3. Developing Firebird Applications in Delphi . 28 3.1.
    [Show full text]
  • Language Reference
    InterBase 6 Language Reference Borland/INPRISE 100 Enterprise Way, Scotts Valley, CA 95066 http://www.interbase.com Inprise/Borland may have patents and/or pending patent applications covering subject matter in this document. The furnishing of this document does not convey any license to these patents. Copyright 1999 Inprise/Borland. All rights reserved. All InterBase products are trademarks or registered trademarks of Inprise/Borland. All Borland products are trademarks or registered trademarks of Inprise/Borland. Other brand and product names are trademarks or registered trademarks of their respective holders. 1INT0055WW21004 6E1R0699 Table of Contents List of Tables.....................................xi CHAPTER 1 Using the InterBase Language Reference Who should use this book .....................13 Topics covered in this book .....................14 CHAPTER 2 SQL Statement and Function Reference Database object naming conventions ...............16 Statement list .............................17 Function list .............................18 Datatypes ...............................19 Error handling ............................20 Using statement and function definitions .............21 ALTER DATABASE ..........................22 ALTER DOMAIN ...........................23 ALTER EXCEPTION .........................25 ALTER INDEX ............................26 ALTER PROCEDURE .........................27 ALTER TABLE .............................28 ALTER TRIGGER ...........................35 AVG( ) .................................36 BASED
    [Show full text]
  • Development of Cross-Platform Problem-Oriented Systems Using Specifications of Database Applications ?
    Development of cross-platform problem-oriented systems using specifications of database applications ? Alexei Hmelnov1;2[0000−0002−0125−1130] and Evgeny Fereferov1;2[0000−0002−7316−444X] 1 Matrosov Institute for System Dynamics and Control Theory of Siberian Branch of Russian Academy of Sciences, 134 Lermontov st. Irkutsk, Russia [email protected] http://idstu.irk.ru 2 Institute of Mathematics, Economics and Informatics, Irkutsk State University, Gagarin Blvd. 20, Irkutsk, Russia Abstract. We consider the approach to development of AIS (automated information system) using declarative specifications of database applica- tions (SDA). The specifications of database applications contain all the information about database structure, which is required to build a typical AIS. The information is represented in its pure form, so the specifications are rather concise. The AIS'es are implemented using general algorithms, which are directed by the specifications. We have developed algorithms for such tasks as: user interface generation, query building, report gener- ation, GIS interaction. Using the specifications of database applications and the algorithms the software system GeoARM was implemented. The technology considered was well-tried by use of the system GeoARM for development of several dozens of true-life AIS for different purposes. In this article we'll describe the approach, that we use for creation of several versions of the GeoARM engine, which use different data access libraries, from the common source code base. The resulting versions of the GeoARM engine allow us to create problem-oriented AIS'es for all the supported platforms from the single SDA. Keywords: Specifications of database applications · automated infor- mation systems · rapid application development · data access technology · source code structuring.
    [Show full text]
  • An Overview of the Usage of Default Passwords (Extended Version)
    An Overview of the Usage of Default Passwords (extended version) Brandon Knieriem, Xiaolu Zhang, Philip Levine, Frank Breitinger, and Ibrahim Baggili Cyber Forensics Research and Education Group (UNHcFREG) Tagliatela College of Engineering University of New Haven, West Haven CT, 06516, United States fbknie1, [email protected],fXZhang, FBreitinger, [email protected] Summary. The recent Mirai botnet attack demonstrated the danger of using default passwords and showed it is still a major problem in 2017. In this study we investigated several common applications and their pass- word policies. Specifically, we analyzed if these applications: (1) have default passwords or (2) allow the user to set a weak password (i.e., they do not properly enforce a password policy). In order to understand the developer decision to implement default passwords, we raised this question on many online platforms or contacted professionals. Default passwords are still a significant problem. 61% of applications inspected initially used a default or blank password. When changing the password, 58% allowed a blank password, 35% allowed a weak password of 1 char- acter. Key words: Default passwords, applications, usage, security 1 Introduction Security is often disregarded or perceived as optional to the average consumer which can be a drawback. For instance, in October 2016 a large section of the In- ternet came under attack. This attack was perpetuated by approximately 100,000 Internet of Things (IoT) appliances, refrigerators, and microwaves which were compromised and formed the Mirai botnet. Targets of this attack included Twit- ter, reddit and The New York Times all of which shut down for hours.
    [Show full text]
  • Ibsurgeon Interbase/Firebird Database Information Tool
    IBSurgeon Free Tools: User Guide © IBSurgeon, 2015, www.ib-aid.com IBSurgeon Free Tools: User Guide IBSurgeon Free Tools is a set of 3 tools for Firebird and InterBase administrators and developers, designed to facilitate several typical tasks: 1) measure response time of specific SQL query to find time when query runs slower than usual (“Response Checker”), 2) view how much data, indices, blobs, etc, are stored in your Firebird or InterBase database (“DBInfo”) 3) investigate Firebird log for errors and warnings, (“Log Viewer”) These tools are simple to use, below you can find their short overview and frequently asked questions. IBSurgeon Response Checker 1. Why do you need Response Checker? If you are trying to improve Firebird database performance, the first thing you need to define is criteria of performance optimization. And, Firebird database performance has such criteria: Average response time Maximum response time Response time should be measured with your real-world application and with your production database (or in test environment which simulates production close enough). There is no reason to measure average response time out of the scope of your real application, until you want some abstract «optimization» - or you are using test environment which is proven to be very close or even identical to your production database. Response time is what your end users will refer as «slow», «very slow» or «good enough» (end users never say that your software is «fast»). How to measure the average and maximum response times in real-world production environments running Firebird? For the basic response time measurement you can use IBSurgeon Response Checker.
    [Show full text]
  • Interbase 2020 Award Winning Multi-Device Secure Embeddable Database
    InterBase 2020 Award winning Multi-device Secure Embeddable Database © Embarcadero Technologies, Inc. Embarcadero® InterBase® 2020 is a full-featured, high-performance, encryptable, multiplatform and scalable relational database for developers who are looking to embed a low-cost, zero admin, lightweight secure database into their cross-platform connected applications. With InterBase 2020 you get powerful access control, data change management, disaster recovery and journaling, as well as support for popular database drivers for increased deployment flexibility. SMALL, ULTRAFAST, HIGHLY EFFICIENT, SECURE FireMonkey comes with hundreds of controls and components, covering all of the functionality you need. Responsive UIs can use the platform native style, or a single cross- platform look and feel, letting you rapidly create visually stunning designs perfect for your app that highlight your brand across platforms. CHANGE VIEWS™ Many frameworks mimic controls, but FireMonkey provides pixelperfect, platform-specific styling. Real, platform-native controls on Windows, iOS, and Android are also available. Cross-platform design does not have to mean generic: give your users a real, native look-andfeel. BUILT FOR MODERN CPU ARCHITECTURES Without FireMonkey, other developers recreate their UI for each platform, using a different language and separate IDE. With FireMonkey, you can build a single visually stunning responsive platform aware UI once in a single language and deploy it to every platform. Rapidly design your UI, directly connected to your code and easily make platform and device-specific changes to cut development and maintenance times in half or more! SPEED UP TO LOWER RISK DEVELOPMENT AND DEPLOYMENT A UI should be fast, responsive, and snappy, with awesome rendering quality and smooth animations.
    [Show full text]
  • An Empirical Study of Local Database Usage in Android Applications
    2017 IEEE International Conference on Software Maintenance and Evolution An Empirical Study of Local Database Usage in Android Applications Yingjun Lyu∗, Jiaping Gui∗, Mian Wan, William G.J. Halfond Department of Computer Science University of Southern California Email: {yingjunl, jgui, mianwan, halfond}@usc.edu For example, both local and remote databases can be attacked Abstract—Local databases have become an important compo- using SQL injection (SQLI) attacks, if developers do not nent within mobile applications. Developers use local databases follow best practices for validating user input and interacting to provide mobile users with a responsive and secure service for data storage and access. However, using local databases comes with the databases [4], [5], [6]. However, some of the problems with a cost. Studies have shown that they are one of the most are unique to the context in which mobile devices operate. energy consuming components on mobile devices and misuse Many database operations, such as transactions, require file of their APIs can lead to performance and security problems. locking and rollback capability. This means that the use of In this paper, we report the results of a large scale empirical such operations is resource intensive, requiring CPU time, study on 1,000 top ranked apps from the Google Play app store. Our results present a detailed look into the practices, costs, memory, and I/O access. Unsurprisingly, the use of these and potential problems associated with local database usage in operations means that the use of local databases also comes deployed apps. We distill our findings into actionable guidance with a high energy cost; recent studies have found that they are for developers and motivate future areas of research related to among the top two or three energy consumers of all services on techniques to support mobile app developers.
    [Show full text]
  • Firebird 3 Quick Start Guide
    Firebird 3 Quick Start Guide IBPhoenix Editors, Firebird Project Members Version 5.4, 27 June 2020 Table of Contents Table of Contents 1. About this guide . 3 2. The Firebird licenses . 4 3. Installing Firebird . 5 3.1. Installation kits . 5 3.2. Installing the Firebird server. 5 3.2.1. Before installation. 5 3.2.2. Installation drives . 6 3.2.3. Installation script or program . 6 3.2.4. Server modes . 6 3.2.5. Installing on Windows. 7 3.2.6. Installing on Linux and other Unix-like platforms . 8 3.3. Installing multiple servers . 8 3.4. Testing your installation . 9 3.4.1. Pinging the server . 9 3.4.2. Making sure that the Firebird server is running. 9 3.5. Performing a client-only install . 12 3.5.1. Windows . 12 3.5.2. Linux and some other Posix clients . 12 4. Default disk locations . 14 4.1. Linux . 14 4.2. Windows. 14 5. Server configuration and management . 17 5.1. User management . 17 5.1.1. Changing the SYSDBA password . 17 5.1.2. Adding Firebird user accounts . 18 5.1.3. The security database . 19 5.1.4. Appointing co-administrators . 19 5.2. Security . 21 5.3. Administration tools . 26 6. Working with databases . 27 6.1. Connection strings . 27 6.1.1. Local connection strings . 27 6.1.2. TCP/IP connection strings . 28 6.1.3. NetBEUI connection strings . 29 6.1.4. URL-style connection strings . 30 6.1.5. Third-party programs . 31 6.2. Connecting to an existing database .
    [Show full text]
  • Issn: 2278-6244 a Comparative Analysis of Sql Server And
    International Journal of Advanced Research in IT and Engineering ISSN: 2278-6244 A COMPARATIVE ANALYSIS OF SQL SERVER AND INTERBASE SERVER Ajala F. A.* Emuoyibofarhe O.J* Alamu F.O* Abstract: Data storage, information management and subsequent retrieval constitute one of the ultimate goals in Computing Technology. Choosing the right Database Management System depending on the operation of the Establishment cannot be over emphasized. To select the right server for an application, two things to be considered are how data will be accessed and modified in the application, and how the server will behave in a data access or update situation. This research work compares two Database Management Systems with different architecture; Interbase server with multigenerational architecture and SQL server with classical architecture. The analysis was based on Execution time (Insert time, Update time and Delete time), using Delphi 6 programming language as the platform and Open Database Connectivity (ODBC) as the Application Programming Interface (API). Results obtained revealed that insert time in SQL server was in the range of 95343 µs to 3783171 µs when the record size ranged from 10,000 to 1,000,000 which almost doubled the insert time for Interbase server. Update time for SQL server is about twice that for Interbase for number of records between 10,000 and 100,000, but about three to six times for higher number of records. The delete time for SQL server was about 5 times that of the Interbase server. Keywords: ODBC, Multigenerational Architecture, Classical Architecture, DBMS, SQL Server and Interbase server. *Department of Computer Science and Engineering, Ladoke Akintola University of Technology, Ogbomoso, Nigeria.
    [Show full text]
  • ODBC Driver for Interbase
    Contents I Table of Contents Part I What's New 1 Part II General Information 3 1 Overvie..w... .............................................................................................................................. 4 2 Feature..s.. ............................................................................................................................... 5 3 Compa.t.i.b..i.l.i.t.y.. ........................................................................................................................ 7 4 Requir.e..m...e..n..t.s. ....................................................................................................................... 9 5 Licensi.n..g.. .............................................................................................................................. 9 6 Gettin.g.. .S...u..p..p..o..r.t. .................................................................................................................. 13 Part III Using ODBC Driver 14 1 Install.a..t.i.o..n.. .......................................................................................................................... 14 Window s .......................................................................................................................................................... 15 Window s Sile.n...t. ..................................................................................................................................................... 18 macOS .........................................................................................................................................................
    [Show full text]
  • IBX for Lazarus User Guide
    MWA Software IBX for Lazarus User Guide Issue 1.6, 14 April 2018 McCallum Whyman Associates Ltd EMail: info@ mccallumwhyman.com, http://www.mccallumwhyman.com Registered in England Registration No. 2624328 COPYRIGHT The copyright in this work is vested in McCallum Whyman Associates Ltd. The contents of the document may be freely distributed and copied provided the source is correctly identified as this document. © Copyright McCallum Whyman Associates Ltd (2016) trading as MWA Software. Disclaimer Although our best efforts have been made to ensure that the information contained within is up-to-date and accurate, no warranty whatsover is offered as to its correctness and readers are responsible for ensuring through testing or any other appropriate procedures that the information provided is correct and appropriate for the purpose for which it is used. ii CONTENTS Page 1 INTRODUCTION................................................................................................................................................1 1.1 REFERENCES............................................................................................................................................................2 1.2 CHANGE HISTORY....................................................................................................................................................2 1.2.1 Version 1.1....................................................................................................................................................2 1.2.2 Version
    [Show full text]
  • External Function Summary
    APPENDIX I External Function Summary Conditional Logic Functions FBUDF INULLIF (VALUE1, VALUE2) Linux, Win32 Returns NULL for a sub-expression if it resolves to a non-null value; otherwise, returns the value of the sub-expression. Applicable to flxed numeric types only and should be used only with Firebird l.O.x. With Firebird 1.5 and higher, use internal function NULLIF( ). Arguments valuel: The column or expression that is tobe evaluated. value2: A constant or expression with which valuel is to be compared. Ifthere is a match, the iNulllf expressionwill return NULL. Return value Will be NULL if valuel and value2 resolve to a match; if there is no match, then value l is returned. Notes iNulllf( ) has an effect equivalent to using the internal SQL function NULLIF(), implemented in Firebird 1.5 and higher, with flxed numeric types. The iNulllf() external function comes in three implementations: two for 32-bit and 16-bit types (inullif and dnullif), the other for 64-bit types (i64nullif). Ifyou wanttobe able to use it with any flxed numeric type, declare all implementations. The declarations can be found in the script fbudf.sql, in the /UDF directory ofyour Firebird installation. Do not declare the i64nullif implementation in any database that does not support 64-bit numeries-in an unported InterBase 5 database, for example. Example This Statement will cause the STOCK value in the PRODUCTS table to be set to NULL on all rows where it is currently stored as 0: UPDATE PRODUCTS SET STOCK = iNULLIF(STOCK, o) Related or similar See also NULLIF( ), sNulllf( ).
    [Show full text]