Skip to content
≡

Administrator

Developer

Tools

External Tools

About This Manual#

This manual describes the concept of C/C++ external procedures and functions (hereafter C/C++ external procedures or other procedures) and how to use them.

Audience#

This manual has been prepared for the following Altibase users:

  • Database administrators
  • Performance administrators
  • Database users
  • Application developers
  • Technical Supporters

It is recommended for those reading this manual possess the following background knowledge:

  • Basic knowledge in the use of computers, operating systems, and operating system utilities
  • Experience in using relational database and an understanding of database concepts
  • Computer programming experience
  • Experience in database server management, operating system management, or network administration


Organization#

This manual is organized as follows:

  • Chapter 1: Introduction
    This chapter introduces C/C++ external procedures and functions. Circumstances in which the use of external procedures is necessary are explained and an overview of Altibase external procedures is provided.

  • Chapter 2: How to Use External Procedures
    This chapter describes how to use external procedures in Altibase.

  • Chapter 3: SQL Statements for External Procedures
    This chapter describes SQL statements supported by Altibase for the use of external procedures.


Documentation Conventions#

This section describes the conventions used in this manual. Understanding these conventions will make it easier to find information in this manual and in the other manuals in the series.

There are two sets of conventions:

  • Syntax diagram conventions
  • Sample code conventions

Syntax Diagram Conventions#

This manual describes command syntax using diagrams composed of the following elements:

Elements Meaning
Indicates the start of a command.
If a syntactic element starts with an arrow, it is not a complete command.
Indicates that the command continues to the next line.
If a syntactic element ends with this symbol, it is not a complete command.
Indicates that the command continues from the previous line.
If a syntactic element starts with this symbol, it is not a complete command.
Indicates the end of a statement.
Indicates a mandatory element.
Indicates an optional element.
Indicates a mandatory element comprised of options.
One, and only one, option must be specified.
Indicates an optional element comprised of options
Indicates an optional element in which multiple elements may be specified.
A comma must precede all but the first element.

Sample Code Conventions#

The code examples explain SQL statements, stored procedures, iSQL statements, and other command line syntax.

The following table describes the printing conventions used in the code examples.

Rules Meaning <Example>
[ ] Indicates an optional item VARCHAR [(size)] [[FIXED |] VARIABLE]
{ } Indicates a mandatory field for which one or more items must be selected. { ENABLE | DISABLE | COMPILE }
| A delimiter between optional or mandatory arguments. { ENABLE | DISABLE | COMPILE }
[ ENABLE | DISABLE | COMPILE ]
. . . Indicates that the previous argument is repeated, or that sample code has been omitted. iSQL> SELECT e_lastname FROM employees;
E_LASTNAME
------------------------
Moon
Davenport
Kobain
. . .
20 rows selected.
Other Symbols Symbols other than those shown above are part of the actual code. EXEC :p1 := 1;
acc NUMBER(11,2)
Italics Statement elements in italics indicate variables and special values specified by the user. SELECT * FROM table_name;
CONNECT userID/password;
Lower case words Indicate program elements set by the user, such as table names, column names, file names, etc. SELECT ename FROM employee;
Upper case words Keywords and all elements provided by the system appear in upper case. DESC SYSTEM.SYS_INDICES;


Sample Schema#

Some of the examples in this manual are based on sample tables, including the employees, departments and orders tables. These tables can be created using the schema.sql file in the $ALTIBASE_HOME/sample/APRE/schema directory. For complete information on the sample schema, please refer to the Altibase General Reference.


For more detailed information, please refer to the following documents.

  • Installation Guide

  • Getting Started Guide

  • SQL Reference

  • iSQL User's Manual

  • Error Message Reference


Altibase Welcomes Your Comments and Feedbacks#

We welcome your feedback on this manual. Your input is valuable in helping us improve future versions of the manual.

If you find any errors, omissions, or other technical issues in the Altibase manual, please report them through the Technical Support Portal, and we will address them with care. For immediate assistance with technical matters, you may also request support through the Technical Support Portal.

Thank you for your continued interest and valuable feedback.