GaussDB 基于ODBC开发--典型应用程序开发示例

获取和处理数据库中的数据

• Windows环境下ODBC应用代码可以使用MinGW（Minimalist GNU for Windows）编译器进行编译。编译命令如下：

  gcc  odbctest.c -o odbctest -lodbc32

   

   

  执行命令为：

  ./odbctest.exe

   

   

• 在Linux环境下ODBC应用代码可以使用GCC（GNU Compiler Collection）编译器进行编译。编译命令如下：

  gcc odbctest.c -o odbctest -lodbc

   

   

  执行命令为：

  ./odbctest

   

   

  如果编译找不到sql.h或者API接口， 尝试手动连接unixodbc的头文件和动态库，即：

  gcc -I /home/omm/unixodbc/include -L /home/omm/unixodbc/lib odbctest.c -o odbctest -lodbc

   

   

此示例完整演示如何通过ODBC获取和处理GaussDB中的数据。

前提条件：数据源已配置成功。Linux系统请参考Linux下配置数据源；Windows系统请参考Windows下配置数据源。

// DBtest.c (compile with: libodbc.so)
// 本示例以用户名和密码保存在环境变量中为例，运行此示例前请先在本地环境中设置环境变量（环境变量名称请根据需求进行设置）EXAMPLE_USERNAME_ENV和EXAMPLE_PASSWORD_ENV。   
#ifdef WIN32
#include <windows.h>
#endif
#include <stdio.h> 
#include <stdlib.h> 
#include <sql.h> 
#include <sqlext.h> 
SQLHENV       V_OD_Env;        // Handle ODBC environment 
SQLHSTMT      V_OD_hstmt;      // Handle statement 
SQLHDBC       V_OD_hdbc;       // Handle connection     
char          typename[100];
SQLINTEGER    value = 100;
SQLINTEGER    V_OD_erg,V_OD_buffer,V_OD_err,V_OD_id;
int main(int argc,char *argv[]) 
{         
      // 1. 申请环境句柄。       
      V_OD_erg = SQLAllocHandle(SQL_HANDLE_ENV,SQL_NULL_HANDLE,&V_OD_Env);     
      if ((V_OD_erg != SQL_SUCCESS) && (V_OD_erg != SQL_SUCCESS_WITH_INFO))        
      {           
           printf("Error AllocHandle\n");           
           exit(0);        
      }

      // 2. 设置版本信息（环境属性）。         
      SQLSetEnvAttr(V_OD_Env, SQL_ATTR_ODBC_VERSION, (void*)SQL_OV_ODBC3, 0);

      // 3. 申请连接句柄。      
      V_OD_erg = SQLAllocHandle(SQL_HANDLE_DBC, V_OD_Env, &V_OD_hdbc);     
      if ((V_OD_erg != SQL_SUCCESS) && (V_OD_erg != SQL_SUCCESS_WITH_INFO))      
      {                     
           SQLFreeHandle(SQL_HANDLE_ENV, V_OD_Env);          
           exit(0);       
      }

      // 获取用户名和用户密码。
      char *userName;
      userName = getenv("EXAMPLE_USERNAME_ENV");
      char *password;
      password = getenv("EXAMPLE_PASSWORD_ENV");

      // 4. 设置连接属性。
      SQLSetConnectAttr(V_OD_hdbc, SQL_ATTR_AUTOCOMMIT,(SQLPOINTER *)SQL_AUTOCOMMIT_ON, 0);
          
      // 5. 连接数据库，这里的userName与password分别表示连接数据库的用户名和用户密码。
      // 如果odbc.ini文件中已经配置了用户名密码，那么这里可以留空（""）；但是不建议这么做，因为一旦odbc.ini权限管理不善，将导致数据库用户密码泄露。    
      V_OD_erg = SQLConnect(V_OD_hdbc, (SQLCHAR*) "MPPODBC", SQL_NTS,  
                           (SQLCHAR*) userName, SQL_NTS,  (SQLCHAR*) password, SQL_NTS);        
      if ((V_OD_erg != SQL_SUCCESS) && (V_OD_erg != SQL_SUCCESS_WITH_INFO))      
      {           
          printf("Error SQLConnect %d\n",V_OD_erg);            
          SQLFreeHandle(SQL_HANDLE_ENV, V_OD_Env);       
          exit(0);        
      }     
      printf("Connected !\n"); 

      // 6. 设置语句属性。
      SQLSetStmtAttr(V_OD_hstmt, SQL_ATTR_QUERY_TIMEOUT, (SQLPOINTER *)3,0);

      // 7. 申请语句句柄。
      SQLAllocHandle(SQL_HANDLE_STMT, V_OD_hdbc, &V_OD_hstmt);   
    
      // 8. 直接执行SQL语句。
      SQLExecDirect(V_OD_hstmt, "drop table IF EXISTS customer_t1", SQL_NTS);
      SQLExecDirect(V_OD_hstmt, "CREATE TABLE customer_t1(c_customer_sk INTEGER, c_customer_name VARCHAR(32));", SQL_NTS);
      SQLExecDirect(V_OD_hstmt, "insert into customer_t1 values(25,'li')", SQL_NTS);

      // 9. 准备执行。
      SQLPrepare(V_OD_hstmt,"insert into customer_t1 values(?)",SQL_NTS); 

      // 10. 绑定参数。
      SQLBindParameter(V_OD_hstmt,1,SQL_PARAM_INPUT,SQL_C_SLONG,SQL_INTEGER,0,0,
                       &value,0,NULL);

      // 11. 执行准备好的语句。
      SQLExecute(V_OD_hstmt);
      SQLExecDirect(V_OD_hstmt,"select c_customer_sk from customer_t1",SQL_NTS);

      // 12. 获取结果集某一列的属性。
      SQLColAttribute(V_OD_hstmt,1, SQL_DESC_TYPE,typename,100, NULL, NULL);               
      printf("SQLColAtrribute %s\n",typename);

      // 13. 绑定结果集。
      SQLBindCol(V_OD_hstmt,1,SQL_C_SLONG, (SQLPOINTER)&V_OD_buffer,150,
                (SQLLEN *)&V_OD_err);

      // 14. 通过SQLFetch取结果集中数据。
      V_OD_erg=SQLFetch(V_OD_hstmt);

      // 15. 通过SQLGetData获取并返回数据。
      while(V_OD_erg != SQL_NO_DATA)
      {
          SQLGetData(V_OD_hstmt,1,SQL_C_SLONG,(SQLPOINTER)&V_OD_id,0,NULL);
          printf("SQLGetData ----ID = %d\n",V_OD_id);
          V_OD_erg=SQLFetch(V_OD_hstmt);
      };
      printf("Done !\n");

      // 16. 断开数据源连接并释放句柄资源。
      SQLFreeHandle(SQL_HANDLE_STMT,V_OD_hstmt);    
      SQLDisconnect(V_OD_hdbc);         
      SQLFreeHandle(SQL_HANDLE_DBC,V_OD_hdbc);       
      SQLFreeHandle(SQL_HANDLE_ENV, V_OD_Env);  
      return(0);
 }

 

 

运行结果如下：

Connected !  
SQLColAtrribute  
SQLGetData ----ID = 25  
SQLGetData ----ID = 100  
Done!

 

 

 

更多详情请参考GaussDB 文档中心：https://doc.hcs.huawei.com/db/zh-cn/gaussdbqlh/24.1.30/productdesc/qlh_03_0001.html