GNU Data Access maunal

Michael Lausch

michael.lausch@1012surf.net

Rodrigo Moya

rodrigo@gnome-db.org

Vivien Malerba

malerba@linuxave.net

Sean Allen

zeroone@worldonline.co.za

GNU Data Access (GDA) is an architecture whose purpose is to provide universal access to many different kinds and types of data sources. This goes from traditional relational database systems, to any imaginable kind of data source such as a mail server, a LDAP directory...

This universality is obtained through the use of CORBA as the mechanism for communication between the different components in the architecture.

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license can be found in Appendix A.

Many of the names used by companies to distinguish their products and services are claimed as trademarks. Where those names appear in any GNOME documentation, and those trademarks are made aware to the members of the GNOME Documentation Project, the names have been printed in caps or initial caps.


Table of Contents
1. Introduction
2. libgda architecture
3. Installation
3.1. Introduction
3.2. Installing
3.3. Configuring
3.3.1. Configuration for development
3.3.2. Configuration for accessing a database
3.3.3. Provider's specific information
4. GDA Common Library
4.1. CORBA functions
4.2. Logs
4.3. XML Queries
4.4. XML Databases
5. GDA Client Library
5.1. Introduction
5.2. Overview of the GDA Objects
5.3. Data Types
5.3.1. Available Data Types
5.4. Datasource Meta Information
5.5. Batch Jobs
6. GDA Clients
6.1. Introduction
6.2. Building GDA Clients
6.3. Building GDA CORBA Clients
7. GDA Providers
7.1. Introduction
7.2. Implementation of GDA Providers
7.2.1. Objects in the library
7.2.2. How a query is processed
7.2.3. Actual DBMS customization work
7.3. Actual DBMS implementation
7.3.1. Data type handling
7.3.2. Schemas requests
7.3.3. Functions to implement
7.4. Files & example
7.4.1. Headers
7.4.2. .c files
7.4.3. Sample implementations
8. GDA Report Engine
A. GNU Free Documentation License
A.1. 0. PREAMBLE
A.2. 1. APPLICABILITY AND DEFINITIONS
A.3. 2. VERBATIM COPYING
A.4. 3. COPYING IN QUANTITY
A.5. 4. MODIFICATIONS
A.6. 5. COMBINING DOCUMENTS
A.7. 6. COLLECTIONS OF DOCUMENTS
A.8. 7. AGGREGATION WITH INDEPENDENT WORKS
A.9. 8. TRANSLATION
A.10. 9. TERMINATION
A.11. 10. FUTURE REVISIONS OF THIS LICENSE
A.12. Addendum
List of Tables
5-1. GDA Data Types
5-2. Main standard constraints' meaning
5-3. Standard Schema and supported constraints