postgres/src/interfaces/cli/example1.c

/* -*- C -*- */
/* The first example illustrates creating a table, adding some data
 * to it, and selecting the inserted data. The second example shows
 * interactive ad hoc query processing.
 *
 * Actual applications include more complete error checking following
 * calls to SQL/CLI routines. That material is omitted from this
 * Appendix for the sake of clarity.
 *
 * This file is adapted for PostgreSQL
 * from the CLI Annex in the SQL98 August 1994 draft standard.
 * Thomas G. Lockhart 1999-06-16
 */

/*
 * B.1  Create table, insert, select
 *
 * This example function creates a table, inserts data into the table,
 * and selects the inserted data.
 *
 * This example illustrates the execution of SQL statement text
 * both using the Prepare() and Execute()  method and using the
 * ExecDirect() method. The example also illustrates both the case
 * where the application uses the automatically-generated descriptors
 * and the case where the application allocates a descriptor of its
 * own and associates this descriptor with the SQL statement.
 *
 * Code comments include the equivalent statements in embedded SQL
 * to show how embedded SQL operations correspond to SQL/CLI function
 * calls.
 */

#include <sqlcli.h>
#include <string.h>

#ifndef NULL
#define NULL   0
#endif

int print_err(SQLSMALLINT handletype, SQLINTEGER handle);

int example1(SQLCHAR *server, SQLCHAR *uid, SQLCHAR *authen)
{
  SQLHENV     henv;
  SQLHDBC     hdbc;
  SQLHDESC    hdesc;
  SQLHDESC    hdesc1;
  SQLHDESC    hdesc2;
  SQLHSTMT    hstmt;
  SQLINTEGER  id;
  SQLSMALLINT idind;
  SQLCHAR     name[51];
  SQLINTEGER  namelen;
  SQLSMALLINT nameind;

  /* EXEC SQL CONNECT TO :server USER :uid; */

  /* allocate an environment handle */
  SQLAllocHandle(SQL_HANDLE_ENV, SQL_NULL_HANDLE, &henv);
  /* allocate a connection handle */
  SQLAllocHandle(SQL_HANDLE_DBC, henv, &hdbc);

  /* connect to database */
  if (SQLConnect(hdbc, server, SQL_NTS, uid, SQL_NTS,
		 authen, SQL_NTS)
      != SQL_SUCCESS)
    return(print_err(SQL_HANDLE_DBC, hdbc));

  /* allocate a statement handle */
  SQLAllocHandle(SQL_HANDLE_STMT, hdbc, &hstmt);

  /* EXEC SQL CREATE TABLE NAMEID (ID integer, NAME varchar(50));  */
  {
    SQLCHAR create[]  ="CREATE TABLE NAMEID (ID integer,"
      " NAME varchar(50))";

    /* execute the CREATE TABLE statement */
    if (SQLExecDirect(hstmt, create, SQL_NTS) != SQL_SUCCESS)
      return(print_err(SQL_HANDLE_STMT, hstmt));
  }

  /* EXEC SQL COMMIT WORK; */
  /* commit CREATE TABLE */
  SQLEndTran(SQL_HANDLE_ENV, henv, SQL_COMMIT);
  /* EXEC SQL INSERT INTO NAMEID VALUES ( :id, :name ); */
  {
    SQLCHAR insert[]=  "INSERT INTO NAMEID VALUES (?, ?)";

    /* show the use of SQLPrepare/SQLExecute method */
    /* prepare the INSERT */
    if (SQLPrepare(hstmt, insert, SQL_NTS) != SQL_SUCCESS)
      return(print_err(SQL_HANDLE_STMT, hstmt));
    /* application parameter descriptor */
    SQLGetStmtAttr(hstmt, SQL_ATTR_APP_PARAM_
		   DESC, &hdesc1, 0L,
		   (SQLINTEGER *)NULL);
    SQLSetDescRec(hdesc1, 1, SQL_INTEGER, 0, 0L, 0, 0,
		  (SQLPOINTER)&id, (SQLINTEGER *)NULL, (SQLSMALLINT *)NULL);
    SQLSetDescRec(hdesc1, 2, SQL_CHAR, 0, 0L, 0, 0,
		  (SQLPOINTER)name, (SQLINTEGER *)NULL,
		  (SQLSMALLINT *)NULL);
    /* implementation parameter descriptor */
    SQLGetStmtAttr(hstmt, SQL_ATTR_IMP_PARAM_
		   DESC, &hdesc2, 0L,
		   (SQLINTEGER *)NULL);
    SQLSetDescRec(hdesc2, 1, SQL_INTEGER, 0, 0L, 0, 0,
		  (SQLPOINTER)NULL, (SQLINTEGER *)NULL,
		  (SQLSMALLINT *)NULL);
    SQLSetDescRec(hdesc2, 2, SQL_VARCHAR, 0, 50L, 0, 0,
		  (SQLPOINTER)NULL, (SQLINTEGER *)NULL,
		  (SQLSMALLINT *)NULL);

    /* assign parameter values and execute the INSERT */
    id=500;
    (void)strcpy(name, "Babbage");
    if (SQLExecute(hstmt) != SQL_SUCCESS)
      return(print_err(SQL_HANDLE_STMT, hstmt));
  }
  /* EXEC SQL COMMIT WORK; */
  SQLEndTran(SQL_HANDLE_ENV, henv, SQL_COMMIT);
  /* commit inserts */

  /* EXEC SQL DECLARE c1 CURSOR FOR SELECT ID, NAME FROM NAMEID; */
  /* EXEC SQL OPEN c1; */
  /* The application doesn't specify "declare c1 cursor for" */
  {
    SQLCHAR select[]=  "select ID, NAME from NAMEID";
    if (SQLExecDirect(hstmt, select, SQL_NTS) != SQL_SUCCESS)
      return(print_err(SQL_HANDLE_STMT, hstmt));
  }

  /* EXEC SQL FETCH c1 INTO :id, :name; */
  /* this time, explicitly allocate an application row descriptor */
  SQLAllocHandle(SQL_HANDLE_DESC, hdbc, &hdesc);
  SQLSetDescRec(hdesc, 1, SQL_INTEGER, 0, 0L, 0, 0,
		(SQLPOINTER)&id, (SQLINTEGER *)NULL, (SQLSMALLINT *)&idind);

  SQLSetDescRec(hdesc, 2, SQL_
		CHAR, 0, (SQLINTEGER)sizeof(name),
		0, 0, (SQLPOINTER)&name, (SQLINTEGER *)&namelen,
		(SQLSMALLINT *)&nameind);
  /* associate descriptor with statement handle */
  SQLSetStmtAttr(hstmt, SQL_ATTR_APP_ROW_DESC, &hdesc, 0);
  /* execute the fetch */
  SQLFetch(hstmt);

  /* EXEC SQL COMMIT WORK; */
  /* commit the transaction  */
  SQLEndTran(SQL_HANDLE_ENV, henv, SQL_COMMIT);

  /* EXEC SQL CLOSE c1; */
  SQLClose(hstmt);
  /* free the statement handle */
  SQLFreeHandle(SQL_HANDLE_STMT, hstmt);

  /* EXEC SQL DISCONNECT; */
  /* disconnect from the database */
  SQLDisconnect(hdbc);
  /* free descriptor handle */
  SQLFreeHandle(SQL_HANDLE_DESC, hdesc);
  /* free descriptor handle */
  SQLFreeHandle(SQL_HANDLE_DESC, hdesc1);
  /* free descriptor handle */
  SQLFreeHandle(SQL_HANDLE_DESC, hdesc2);
  /* free connection handle */
  SQLFreeHandle(SQL_HANDLE_DBC,  hdbc);
  /* free environment handle */
  SQLFreeHandle(SQL_HANDLE_ENV,  henv);

  return(0);
}