Connecting to Your Database Appeon PowerBuilder® 2019 R2 FOR WINDOWS DOCUMENT ID: DC37776-01-1900-01 LAST REVISED: March 24, 2020 Copyright © 2019 Appeon. All rights reserved. This publication pertains to Appeon software and to any subsequent release until otherwise indicated in new editions or technical notes. Information in this document is subject to change without notice. The software described herein is furnished under a license agreement, and it may be used or copied only in accordance with the terms of that agreement. Upgrades are provided only at regularly scheduled software release dates. No part of this publication may be reproduced, transmitted, or translated in any form or by any means, electronic, mechanical, manual, optical, or otherwise, without the prior written permission of Appeon Inc. Appeon and other Appeon products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of Appeon Inc. SAP and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP and SAP affiliate company. Java and all Java-based marks are trademarks or registered trademarks of Oracle and/or its affiliates in the U.S. and other countries. Unicode and the Unicode Logo are registered trademarks of Unicode, Inc. All other company and product names mentioned may be trademarks of the respective companies with which they are associated. Use, duplication, or disclosure by the government is subject to the restrictions set forth in subparagraph (c)(1)(ii) of DFARS 52.227-7013 for the DOD and as set forth in FAR 52.227-19(a)-(d) for civilian agencies. Appeon Inc., 1/F, Shell Industrial Building, 12 Lee Chung Street, Chai Wan District, Hong Kong Contents I Introduction to Database Connections .................................................................... 1 1 Understanding Data Connections ................................................................... 2 1.1 How to find the information you need .................................................. 2 1.2 Accessing data in PowerBuilder ........................................................... 3 1.3 Accessing the Demo Database ............................................................ 5 1.4 Using database profiles ........................................................................ 5 1.4.1 About creating database profiles ................................................ 5 1.4.2 Creating a database profile ........................................................ 8 1.5 What to do next .................................................................................... 9 II Working with Standard Database Interfaces ....................................................... 10 2 Using the ODBC Interface ............................................................................ 11 2.1 About the ODBC interface .................................................................. 11 2.1.1 What is ODBC? ........................................................................ 11 2.1.2 Using ODBC in PowerBuilder .................................................. 12 2.1.3 Components of an ODBC connection ...................................... 12 2.1.4 Types of ODBC drivers ............................................................ 14 2.1.5 Ensuring the proper ODBC driver conformance levels ............. 15 2.1.5.1 What are ODBC conformance levels? ........................... 16 2.1.6 Obtaining ODBC drivers ........................................................... 17 2.1.7 Using ODBC drivers with PowerBuilder ................................... 17 2.1.8 Getting help with ODBC drivers ............................................... 17 2.2 Preparing ODBC data sources ........................................................... 18 2.3 Defining ODBC data sources ............................................................. 18 2.3.1 How PowerBuilder accesses the data source .......................... 19 2.3.1.1 PBODB190 initialization file ............................................ 19 2.3.1.2 ODBCINST registry entries ............................................ 19 2.3.1.3 ODBC registry entries .................................................... 20 2.3.1.4 Database profiles registry entry ...................................... 20 2.3.2 Defining multiple data sources for the same data .................... 21 2.3.3 Displaying Help for ODBC drivers ............................................ 21 2.3.3.1 Help for any ODBC driver .............................................. 22 2.3.4 Selecting an ODBC translator .................................................. 22 2.4 Defining the ODBC interface .............................................................. 22 2.5 SAP SQL Anywhere ........................................................................... 22 2.5.1 Supported versions for SQL Anywhere .................................... 23 2.5.2 Basic software components for SQL Anywhere ....................... 23 2.5.3 Preparing to use the SQL Anywhere data source .................... 24 2.5.4 Defining the SQL Anywhere data source ................................. 25 2.5.5 Support for Transact-SQL special timestamp columns ............. 27 2.5.6 What to do next ........................................................................ 28 2.6 PostgreSQL ........................................................................................ 28 2.6.1 Limited support for stored procedure ....................................... 28 2.6.2 Support for auto-increment column .......................................... 29 3 Using the JDBC Interface ............................................................................. 30 3.1 About the JDBC interface ................................................................... 30 3.1.1 What is JDBC? ......................................................................... 30 3.1.2 Using the JDBC interface ......................................................... 31 3.1.3 Components of a JDBC connection ......................................... 31 3.1.4 JDBC registry entries ............................................................... 33 3.1.5 Supported versions for JDBC ................................................... 33 3.1.6 Supported JDBC datatypes ...................................................... 34 3.2 Preparing to use the JDBC interface .................................................. 34 3.3 Defining the JDBC interface ............................................................... 35 4 Using the OLE DB Interface ......................................................................... 37 4.1 About the OLE DB interface ............................................................... 37 4.1.1 What is OLE DB? ..................................................................... 37 4.1.2 Components of an OLE DB connection ................................... 39 4.1.3 Obtaining OLE DB data providers ............................................ 40 4.1.4 Supported versions for OLE DB ............................................... 40 4.2 Preparing to use the OLE DB interface .............................................. 41 4.3 Defining the OLE DB interface ........................................................... 42 5 Using the ADO.NET Interface ...................................................................... 44 5.1 About ADO.NET ................................................................................. 44 5.2 About the PowerBuilder ADO.NET database interface ...................... 45 5.2.1 Components of an ADO.NET connection ................................. 45 5.2.2 OLE DB data providers ............................................................ 47 5.3 Preparing to use the ADO.NET interface ........................................... 48 5.4 Defining the ADO.NET interface ........................................................ 49 5.4.1 Getting identity column values ................................................. 50 5.5 Sharing ADO.NET Database Connections ......................................... 52 5.5.1 Importing an ADO.NET Connection from a Third-Party .NET Assembly ............................................................................................ 53 5.5.2 Exporting an ADO.NET Connection to a Third-Party .NET Assembly ............................................................................................ 54 6 Using the OData Interface (Obsolete) .......................................................... 56 6.1 Database Profile Setup - OData Dialog Box ...................................... 56 6.1.1 Connection Tab ........................................................................ 56 6.1.2 Certificate Tab .......................................................................... 57 6.1.3 Proxy Server Tab ..................................................................... 57 6.1.4 Preview Tab ............................................................................. 57 6.2 Database Painter ................................................................................ 57 6.3 Create a DataWindow Using an OData Service ................................. 58 6.4 Set the Connection Information for the OData Service ....................... 59 6.5 A known issue with OData ................................................................. 59 III Working with Native Database Interfaces ........................................................... 60 7 Using Native Database Interfaces ...............................................................