Download IBM Informix DataBlade Developers Kit User's Guide

Transcript
Contents
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
In This Introduction. . . . . . . .
About This Publication. . . . . . .
Types of Users . . . . . . . .
Software Dependencies . . . . . .
Example Code Conventions . . . . .
Additional Documentation. . . . . .
Compliance with Industry Standards . .
How to Provide Documentation Feedback
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. ix
. ix
. ix
. . . . . . . . . . . . . . . . . . . . . . . . . x
. . . . . . . . . . . . . . . . . . . . . . . . . x
. . . . . . . . . . . . . . . . . . . . . . . . . x
. . . . . . . . . . . . . . . . . . . . . . . . . xi
. . . . . . . . . . . . . . . . . . . . . . . . . xi
Chapter 1. Getting Started with DataBlade Module Development
In This Chapter . . . . . . . . . . . . . . . . . . . .
What is a DataBlade Module? . . . . . . . . . . . . . . .
DataBlade Developers Kit Tools . . . . . . . . . . . . . .
Preparing to Develop DataBlade Modules . . . . . . . . . . .
Becoming Familiar with IBM Informix Software and Documentation .
Designing Your DataBlade Module . . . . . . . . . . . .
Developing Your DataBlade Module . . . . . . . . . . . . .
Editing and Compiling DataBlade Module Code . . . . . . . .
Debugging Your DataBlade Module . . . . . . . . . . . .
Packaging Your DataBlade Module . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. . . . . . . . . . 1-1
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
1-1
1-1
1-1
1-2
1-2
1-3
1-5
1-7
1-7
1-8
Chapter 2. Designing DataBlade Modules . . . . . . . . . . . . . . . . . . . . 2-1
In This Chapter . . . . . . . . .
Data Model . . . . . . . . . .
Data Type Design . . . . . . . .
Object Accessibility . . . . . .
Handling Large Objects . . . . .
Query Language Interface . . . . .
SQL Query Structure . . . . . .
The Target List . . . . . . . .
The Qualification . . . . . . .
Query Processing . . . . . . . .
Predicate Evaluation . . . . . .
Grouping . . . . . . . . .
Casts . . . . . . . . . . .
Access Path Selection . . . . .
Planning for Transaction Semantics .
Interoperability . . . . . . . .
Orthogonality . . . . . . . .
Simple, Clean Interfaces . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 2-1
. 2-1
. 2-3
. 2-3
. 2-4
. 2-5
. 2-5
. 2-6
. 2-7
. 2-8
. 2-8
. 2-12
. 2-13
. 2-14
. 2-15
. 2-15
. 2-15
. 2-16
Chapter 3. Programming Guidelines . . . . . . . . . . . . . . . . . . . . . . . 3-1
In This Chapter . . . . . . . . . .
Programming Language Options . . . .
Options for Opaque Data Types . . .
Options for Routines . . . . . . .
Multilanguage DataBlade Module Issues
C Programming Guidelines . . . . . .
C++ Programming Guidelines . . . . .
Java Programming Guidelines . . . . .
DataBlade API Programming Tips . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
3-1
3-1
3-2
3-5
3-5
3-6
3-7
3-7
3-8
Chapter 4. Creating DataBlade Objects Using BladeSmith . . . . . . . . . . . . . 4-1
© Copyright IBM Corp. 1996, 2010
iii