Ns_DbOpenDb

Overview

Obtain a database handle

Syntax

    Ns_DbHandle *Ns_DbOpenDb(
    	char *driver,
    	char *datasource,
    	char *user,
    	char *password
    );

Description

The Ns_DbOpenDb function is a lower-level function that actually opens a database connection. This can be an expensive operation. The recommended way to get database handles is to use database pools and the function Ns_DbPoolGetHandle.

The driver parameter corresponds to a database driver name as defined in the AOLserver configuration file. The datasource is a string describing the data source to be opened. It's format depends on the database driver. The Illustra database driver expects data sources to be the name of the Illustra server and the Illustra database separated by a colon (:) (e.g., default:nsdb).