ops-6: beginners guide to openedge ® sql via odbc or jdbc brian werne sr. engineering manager...

OPS-6: Beginners Guide to OpenEdge® SQL via ODBC or JDBC

Brian WerneSr. Engineering Manager

OpenEdge SQL and OpenEdge Management

© 2008 Progress Software Corporation2 OPS-6: Beginners Guide to OpenEdge SQL via ODBC or JDBC

Agenda:

OpenEdge SQL component overview and your initial connection

Setup and maintenance of the OpenEdge database for control and performance

Specifics of the OpenEdge with the SQL based tools and applications

Goal: Make you successful with SQL applications!

© 2008 Progress Software Corporation3

OpenEdge is Open

SSL HTTP

HTTP/S HTML

.NETJava

HTML Open Clients

(Non-OpenEdge)OpenEdge

ABL ClientsODBCClients

ServiceInterfaces

OpenEdgeRDBMS

OpenEdgeDataServer

s

OpenEdgeABL Server

OpenEdgeSQL Server

JDBCClients

Oracle®

MSSQLODBC

ABL: Open Clients:Java™

.NET™

Web services

(ABL works with relational DBs)

OpenEdge SQL

Crystal ReportsWebSphere®

JBOSS / JRunJava / JDBC appsJ2EE™ / JTA.NET / ODBC appsADO.NET / VB

Data is fully interoperable: ABL & SQL

(works with OpenEdge RDBMS)


Getting Connected – Client side: ODBC and JDBC drivers


CLASSPATH ( run ‘sql_env’)

Class loader

URL

JDBC driver

Type 4 JDBC driver (10.1a+)

com.ddtek.jdbc.openedge.OpenEdgeDriver

jdbc:datadirect:openedge://localhost:6748;databaseName=db1

$DLC/java: openedge.jar, util.jar, base.jar


ODBC DSN – single connection


ODBC DSN Advanced Tab


Isolation Level Affect on Lock Type

Isolation Level

Update Fetch

Table Lock

Record Lock

Table Lock

Record Lock

Read Uncommitted

--- --- NoLock NoLock

Read

Committed IX Exclusive IS Share

Repeatable Read

IX Exclusive IS Share

Serializable SIX Exclusive Share None


ODBC : Multi-DataBase configuration


Connection – server side


Default server settings

SQL Servers

SQL & ABLBroker

SQL client

ABL client

Sh

ared M

emo

ry Database

ABL Servers

ABL client

SQL client


“Recommended” server setup

SQL Servers

SQL client

ABL client ABL onlyBroker

SQL onlyBroker

SQL client

ABL client

Sh

ared M

emo

ry Database

ABL Servers


Recommended parameters example

Example: Start a ABL Primary broker

Example: Start a Secondary SQL broker

Separating ABL and SQL brokers/servers … examples

proserve Sports2000 -S 6000 -H localhost -n 45 -Mn 8 -Mpb 4 -ServerType 4GL -Mi 1 -Ma 5 -minport 6100 -maxport 6300

proserve Sports2000 -S 5000 -H localhost -m3 –Mpb 3 -ServerType SQL –Mi 5 –Ma 5 -minport 5100 -maxport 5300


Security

Who am I?

Authentication Authorization

What am I allowed to do?


Security Considerations

Database authentication• SQL

– Always requires a user ID and password to establish a connection

• ABL– Does not specifically require a user ID and

password to establish a connection

ID and passwords


SQL Authentication (Who am I?)

Case 1: Users have not been created

(no rows in _User table)

• Password validation is not enabled

• No check is performed at connection time

• No error message at connection time

ID and passwords scenarios


SQL Authentication (Who am I?)

Case 2: Users exist in the OpenEdge RDBMS

(rows exist in _User table)

• Password Validation is enabled

• Check is performed at connection time

• Valid users defined by a DBA

• Error message if login is incorrect / invalid:– “Access Denied (8933)”

ID and passwords scenarios…cont’d


Comparing ABL & SQL Security Systems

ABL SQL

Security model GRANT GRANT

Default DBA n/a <db-owner>SYSPROGRESS

Default security administrator

“*” n/a

Default table access “*” <none>

Default field access “*” <none>


Encountering errors

Possible reason for this:• No authorization privileges

• Schema scope

Access denied (Authorization failed) (7512)


Authorization – What can I do?

SQL follows GRANT security model By default, a connected userid is not allowed

to do anything. Exceptions: - the DBA account (full operations)

- the TABLE owner

DBA controls operation privileges with GRANT / REVOKE syntax


Authorization – What can I do?

Database wide (system admin or general creation)

For specified Tables or Views

– Where ‘privilege’ is:

{ SELECT | INSERT | DELETE | INDEX | UPDATE [ ( column , column , ... ) ] | REFERENCES [ ( column , column , ... ) ] }

Privileges – Syntax: GRANT (2 types)

GRANT { DBA, RESOURCE }TO user_name [, user_name ] , …;

GRANT { privilege [, privilege ], … | ALL }ON table_nameTO { user_name [, user_name ] , … | PUBLIC }[ WITH GRANT OPTION ];


Encountering errors

Possible reasons for this:• Not authorized

• Schema scope

Table/View/Synonym not found (7519)


What is a Schema?

PUB schema PUB

Customer table Inventory

bwerne

Mysports database

AuxCat Database


What is a default Schema?• A user has by default a schema attached to their ID

SET SCHEMA { 'string_literal'}

OpenEdge ABL uses one schema – ‘PUB’

Another option: Synonyms:

Schemas

CREATE PUBLIC SYNONYM customer FOR pub.customer;

SET SCHEMA ‘pub’


Solutions:

or

Schema example

SELECT count(*) FROM pub.customer;

SET SCHEMA ‘pub’;SELECT count(*) FROM customer;

Table/View/Synonym not found (7519)

SELECT count(*) FROM customer;SELECT count(*) FROM customer;


Four level naming convention

Example

ABL has 3 level naming convention

4 Part Naming – Multi-Database Query

Fully Qualified Names

catalog.schema.table.column-name

SELECT Pub.Customer.CustNum,

SportsPrimary.Pub.Customer.Name,

SportsAux1.Pub.Order.OrderNum …

catalog.table.column-name


OpenEdge Specifics

SQL is a standard,

but each vendor has it’s own dialect


OpenEdge Specifics - Quoting

Hyphenated names:

Solution: quoting

Non-SQLStandard names

SELECT cust-num FROM PUB.Customer;

SELECT “cust-num” FROM PUB.Customer;

Column CUST cannot be found (13865)


Overstuffed fields - error

ABL allows more data than column definition

Column abc in table PUB.Ranking has value exceeding it’s max length.

SELECT abc from PUB.Ranking;


OpenEdge Specifics - Overstuffed fields

Strategies for managing: Dbtool : percentage option ($DLC/bin/dbtool)

1. SQL Width & Date Scan w/Report Option

2. SQL Width Scan w/Fix Option

Choice: 2

<connect>: (0=single-user 1=self-service >1=#threads)? 3

Padding % above current max: 25

<table>: (Table number or all)? all

<area>: (Area number or all)? all


OpenEdge Specifics - Overstuffed fields

Strategies for managing ABL client startup parameter -checkwidth

<progress-client>.exe –checkwidth n

where "n" can be one of the following:

0 — Ignore _width value. Default.

1 — Store the data and generate a warning.

2 — Do not store data and generate an error.


OpenEdge Specifics – Arrays / Extents

Selecting array columns as a whole

Result: semi-colon separated varchar value

102332.67;330002.77;443434.55;333376.50

Selecting array column individually – SQL99

Result: numeric value

102332.67

SELECT quarterlySales from PUB.MySales;

SELECT quarterlySales[1] from PUB.MySales;


OpenEdge Specifics – Arrays / Extents

Strategies: Using views to break out array elements

Result: numeric values

102332.67 330002.77 443434.55 333376.50

CREATE VIEW PUB.QuarterSales AS SELECT quarterlySales[1], quarterlySales[2],quarterlySales[3], quarterlySales[4] FROM PUB.MySales;

SELECT * FROM PUB.QuarterSales;


Q: What’s it gonna cost to run my query?

Query Performance

TIME =


What is the cost?

Database without statistics

Customers Orders

SalesHist

Distributors

Parts

Suppliers

OrderLines

Employees

ABC Corp DB


Basic Performance - What is the cost?

Database with Update Statistics

Customers

Orders

SalesHist

Distributors

Parts

Suppliers

OrderLines

Employees

ABC Corp DB


All Statistics: Table Cardinality, indexes and all columns

Statistics - particular table

Query Performance: Update Statistics

UPDATE TABLE STATISTICS AND INDEX STATISTICS AND [ALL] COLUMN STATISTICS;

UPDATE STATISTICS syntax

UPDATE TABLE STATISTICS AND INDEX STATISTICS AND [ALL] COLUMN STATISTICS FOR pub.customer;


Query trees : Defined

relational algebraic tree representation(query tree / execution tree )

Result set

Database access

Data


Basic Performance – Query Plans

Query Plans Located in VST _SQL_QPLAN

SELECT SUBSTRING("_Description",1,80)

FROM pub."_Sql_Qplan“WHERE "_Pnumber" =

(SELECT MAX( "_Pnumber" )FROM pub."_Sql_Qplan" WHERE "_Ptype" > 0 );

Viewing query plan constructed by cost-based optimizer


Simple single table select• “select … from pub.customer where custnum between 1000 and 1100 [NoExecute]”

Query plan – what to look for

SELECT COMMAND. PROJECT [66] (| PROJECT [64] ( | | PUB.CUSTOMER. [0](| | | INDEX SCAN OF ( | | | | CustNum, | | | | | (PUB.CUSTOMER.CustNum) between (1000,1100))

table

index

index keys, predicates


In Summary

Initial SQL connection

Setup and maintenance in OpenEdge database for security and performance

Specifics of OpenEdge with SQL applications


For More Information, go to…

PSDN• Developing Performance-Oriented ODBC/JDBC OpenEdge

Applications • OpenEdge SQL: Authorization Explained• OpenEdge SQL in a 10.1B Multi-Database Environment • OpenEdge® Database Run-time Security Revealed

OpenEdge Technical Support - KBases• Basic Guide to Defining Progress SQL Database Permissions &

Security

Progress eLearning Community• Using OpenEdge SQL

Documentation• 10.1C OpenEdge Data Management: SQL Development • 10.1C OpenEdge Data Management: SQL Reference


Relevant Exchange Sessions

OPS-27: Understanding Record and Table Locking In OpenEdge SQL

OPS-10: Moving V8/V9 RDBMS to OpenEdge 10 OPS-15: What was Happening with My Database,

AppServer, Operating System OPS-18: Data Management and Platforms Roadmap OPS-24: Success with OpenEdge Replication


Questions?


Thank You

ops-6: beginners guide to openedge ® sql via odbc or jdbc brian werne sr. engineering manager...

Documents

progress software corporation

sql authentication

sql applications

openedge database

servertype sql mi

openedge management

abl sql security systems

openedge rdbms rows