FUJITSU Enterprise Postgres 11 Application Development Guide Windows/Linux J2UL-2433-01ENZ0(00) May 2019 Preface Purpose of this document This is a guide for the developers of FUJITSU Enterprise Postgres applications. Intended readers This document is intended for developers of applications that use FUJITSU Enterprise Postgres. Of the interfaces provided by FUJITSU Enterprise Postgres, this guide describes the PostgreSQL extended interface. Readers of this document are also assumed to have general knowledge of: - PostgreSQL - SQL - Linux - PostgreSQL - SQL - Windows - PostgreSQL - SQL - Oracle Solaris Structure of this document This document is structured as follows: Chapter 1 Overview of the Application Development Function Provides an overview of FUJITSU Enterprise Postgres application development. Chapter 2 JDBC Driver Explains how to use JDBC drivers. Chapter 3 ODBC Driver Explains how to use ODBC drivers. Chapter 4 .NET Data Provider Explains how to use .NET Data Provider. Chapter 5 C Library (libpq) Explains how to use C applications. Chapter 6 Embedded SQL in C Explains how to use embedded SQL in C. Chapter 7 Embedded SQL in COBOL Explains how to use embedded SQL in COBOL. Chapter 8 SQL References Explains the SQL statements which were extended in FUJITSU Enterprise Postgres development. Chapter 9 Compatibility with Oracle Databases Explains features that are compatible with Oracle databases. Chapter 10 Application Connection Switch Feature Explains the application connection switch feature. - i - Chapter 11 Performance Tuning Explains how to tune application performance. Chapter 12 Scan Using a Vertical Clustered Index (VCI) Explains how to perform scan using a Vertical Clustered Index (VCI). Appendix A Precautions when Developing Applications Provides some points to note about application development. Appendix B Conversion Procedures Required due to Differences from Oracle Database Explains how to convert from an Oracle database to FUJITSU Enterprise Postgres, within the scope noted in "Compatibility with Oracle Databases" from the following perspectives. Appendix C Tables Used by the Features Compatible with Oracle Databases Explains the tables used by the features compatible with Oracle databases. Appendix D ECOBPG - Embedded SQL in COBOL Explains application development using embedded SQL in COBOL. Appendix E Quantitative Limits This appendix explains limitations. Appendix F Reference Provides a reference for each interface. Export restrictions Exportation/release of this document may require necessary procedures in accordance with the regulations of your resident country and/or US export control laws. Issue date and version Edition 1.0: May 2019 Copyright Copyright 2015-2019 FUJITSU LIMITED - ii - Contents Chapter 1 Overview of the Application Development Function................................................................................................ 1 1.1 Support for National Characters.......................................................................................................................................................... 2 1.1.1 Literal............................................................................................................................................................................................2 1.1.2 Data Type......................................................................................................................................................................................3 1.1.3 Functions and Operator.................................................................................................................................................................3 1.2 Integration with Visual Studio.............................................................................................................................................................3 1.2.1 Relationship between .NET Framework and FUJITSU Enterprise Postgres............................................................................... 4 1.2.2 Automatic Application Generation...............................................................................................................................................5 1.3 Compatibility with Oracle Database....................................................................................................................................................6 1.4 Application Connection Switch Feature..............................................................................................................................................6 1.4.1 Integration with Database Multiplexing....................................................................................................................................... 7 1.5 Notes on Application Compatibility....................................................................................................................................................7 1.5.1 Checking Execution Results......................................................................................................................................................... 7 1.5.2 Referencing System Catalogs....................................................................................................................................................... 7 1.5.3 Using Functions............................................................................................................................................................................ 8 Chapter 2 JDBC Driver.............................................................................................................................................................9 2.1 Development Environment..................................................................................................................................................................9 2.1.1 Combining with JDK or JRE........................................................................................................................................................9 2.2 Setup.................................................................................................................................................................................................... 9 2.2.1 Environment Settings....................................................................................................................................................................9 2.2.2 Message Language and Encoding System Used by Applications Settings................................................................................ 10 2.2.3 Settings for Encrypting Communication Data............................................................................................................................11 2.3 Connecting to the Database............................................................................................................................................................... 12 2.3.1 Using the DriverManager Class..................................................................................................................................................12 2.3.2 Using the PGConnectionPoolDataSource Class.........................................................................................................................13 2.3.3 Using the PGXADataSource Class.............................................................................................................................................13 2.4 Application Development..................................................................................................................................................................14 2.4.1 Relationship between the Application Data Types and Database Data Types........................................................................... 14 2.4.2 Statement Caching Feature......................................................................................................................................................... 16 2.4.3 Creating Applications while in Database Multiplexing Mode................................................................................................... 16 2.4.3.1 Errors when an Application Connection Switch Occurs and Corresponding Actions........................................................ 16 Chapter 3 ODBC Driver..........................................................................................................................................................18 3.1 Development Environment................................................................................................................................................................18 3.2 Setup.................................................................................................................................................................................................. 18 3.2.1 Registering ODBC Drivers.........................................................................................................................................................18 3.2.2 Registering ODBC Data Sources(for Windows(R))...................................................................................................................21 3.2.2.1 Registering Using GUI........................................................................................................................................................ 21 3.2.2.2 Registering Using Commands............................................................................................................................................