공간사랑

1. 참고링크

•Open_Database_Connectivity - http://en.wikipedia.org/wiki/Open_Database_Connectivity
•Microsoft Open Database Connectivity (ODBC) - http://msdn2.microsoft.com/en-us/library/ms710252.aspx
•ODBC Programmer's Reference - http://msdn2.microsoft.com/en-us/library/ms714177.aspx
•ODBC API Reference - http://msdn2.microsoft.com/en-us/library/ms714562.aspx
•C Data Types - http://msdn2.microsoft.com/en-us/library/ms714556.aspx
•ODBC Technical Articles
•OLE DB for the ODBC Programmer - http://msdn2.microsoft.com/en-us/library/ms810892.aspx
•Using ODBC with Microsoft SQL Server - http://msdn2.microsoft.com/en-us/library/ms811006.aspx
•ODBC 함수 요약 정리 http://synch3d.com/wiki/moin/moin.cgi/ODBC

2. ODBC 관련 데이터 타입

날짜/시간의 C 데이터 타입 구조

typedef struct tagDATE_STRUCT
{
        SQLSMALLINT     year;
        SQLUSMALLINT    month;
        SQLUSMALLINT    day;
} DATE_STRUCT;

typedef struct tagTIME_STRUCT
{
        SQLUSMALLINT    hour;
        SQLUSMALLINT    minute;
        SQLUSMALLINT    second;
} TIME_STRUCT;

typedef struct tagTIMESTAMP_STRUCT
{
        SQLSMALLINT     year;
        SQLUSMALLINT    month;
        SQLUSMALLINT    day;
        SQLUSMALLINT    hour;
        SQLUSMALLINT    minute;
        SQLUSMALLINT    second;
        SQLUINTEGER     fraction;
} TIMESTAMP_STRUCT;

3. ODBC API 주요 함수

3.1. ODBC 핸들

•SQL_HANDLE_ENV
•SQL_HANDLE_DBC
•SQL_HANDLE_STMT
•SQL_HANDLE_DESC

SQLRETURN SQLAllocHandle(
        SQLSMALLINT     HandleType,             // 핸들 타입 (
        SQLHANDLE       InputHandle,            // 새로 만들어질 핸들의 부모 핸들.
        SQLHANDLE *     OutputHandlePtr         // 새로 만들어질 핸들을 저장할 핸들 변수의 주소.
);

SQLRETURN SQLFreeHandle(
        SQLSMALLINT     HandleType,
        SQLHANDLE       Handle
);

3.2. ODBC 연결

// Local DB/File 연결 함수
SQLRETURN SQLDriverConnect(
        SQLHDBC         ConnectionHandle,       // DB 연결 핸들
        SQLHWND         WindowHandle,           // 윈도우 핸들 (사용안함)
        SQLCHAR *       InConnectionString,     // 전체/부분 연결 문자열(파일 지정)
        SQLSMALLINT     StringLength1,          // 연결 문자열의 길이
        SQLCHAR *       OutConnectionString,    //   연결 완료된 문자열
        SQLSMALLINT     BufferLength,           //   연결 완료된 문자열의 크기 (할당된 크기: 최소 1024)
        SQLSMALLINT *   StringLength2Ptr,       //   연결 완료된 문자열의 길이 (반환값)
        SQLUSMALLINT    DriverCompletion        // 연결 옵션 (주로 SQL_DRIVER_NOPROMPT 사용)
);

3.3. 쿼리 실행

// SQL Query 즉시 실행 함수 (SQL 문 준비 과정 없음)
SQLRETURN SQLExecDirect(
        SQLHSTMT        StatementHandle,        // SQL 명령문 핸들
        SQLCHAR *       StatementText,          // 실행될 SQL 문
        SQLINTEGER      TextLength              // 실행될 SQL 문의 길이
);

// SQL 문에 대한 다음 결과 값을 가져오는 함수
SQLRETURN SQLFetch(
        SQLHSTMT        StatementHandle         // SQL 명령문 핸들
);

3.3.1. 정적 바인딩

// 결과 값의 열을 바인딩하는 함수
SQLRETURN SQLBindCol(
        SQLHSTMT        StatementHandle,        // SQL 명령문 핸들
        SQLUSMALLINT    ColumnNumber,           // 열 값의 순서 (1부터 시작)
        SQLSMALLINT     TargetType,             // 열 값의 데이터형 (C Data Type)
        SQLPOINTER      TargetValuePtr,         // 바인딩될 변수
        SQLINTEGER      BufferLength,           // 바인딩될 변수의 크기 (고정길이형(정수형,논리형):0)
        SQLLEN *        StrLen_or_Ind           // 열 값의 길이/상태값을 반환 받을 변수
);

3.3.2. 동적 바인딩

SQLRETURN SQLMoreResults(
        SQLHSTMT        StatementHandle         // SQL 명령문 핸들
);

SQLRETURN SQLGetData(
        SQLHSTMT        StatementHandle,        // SQL 명령문 핸들
        SQLUSMALLINT    ColumnNumber,           // 열 값의 순서 (1부터 시작)
        SQLSMALLINT     TargetType,             // 열 값의 데이터형 (C Data Type)
        SQLPOINTER      TargetValuePtr,         // 바인딩될 변수
        SQLLEN          BufferLength,           // 바인딩될 변수의 크기 (고정길이형(정수형,논리형):0)
        SQLLEN *        StrLen_or_IndPtr        // 열 값의 길이/상태값을 반환 받을 변수
);

3.4. ODBC 연결 종료

SQLRETURN SQLCloseCursor(
        SQLHSTMT        StatementHandle
);

SQLRETURN SQLDisconnect(
        SQLHDBC         ConnectionHandle
);

SQLRETURN SQLFreeHandle(
        SQLSMALLINT     HandleType,
        SQLHANDLE       Handle
);

SQLCloseCursor( hStmt );                        // STEP 1
SQLFreeHandle( SQL_HANDLE_STMT, hStmt );        // STEP 2
SQLDisconnect( hDBC );                          // STEP 3
SQLFreeHandle( SQL_HANDLE_DBC, hDBC );          // STEP 4
SQLFreeHandle( SQL_HANDLE_ENV, hENV );          // STEP 5

4. ODBC 고급

4.1. ODBC 확장열 사용

4.2. SQL 최적화 (준비: Prepare)

SQLRETURN SQLPrepare(
        SQLHSTMT        StatementHandle,
        SQLCHAR *       StatementText,
        SQLINTEGER      TextLength
);

SQLRETURN SQLExecute(
        SQLHSTMT        StatementHandle
);

4.3. 파라미터 사용

// 매개변수를 바인딩하는 함수
SQLRETURN SQLBindParameter(
        SQLHSTMT        StatementHandle,        // SQL 명령문 핸들
        SQLUSMALLINT    ParameterNumber,        // 매개변수의 순서 (1부터 시작)
        SQLSMALLINT     InputOutputType,        // 매개변수의 용도 (입력/출력/입출력)
        SQLSMALLINT     ValueType,              // 매개변수의 데이터형 (C Data Type)
        SQLSMALLINT     ParameterType,          // 매개변수의 데이터형 (SQL data type )
        SQLUINTEGER     ColumnSize,             // 매개변수의 크기
        SQLSMALLINT     DecimalDigits,          // 매개변수의 자리 수 (정수형일 경우)
        SQLPOINTER      ParameterValuePtr,      // 매개변수에 바인딩될 변수
        SQLINTEGER      BufferLength,           // 매개변수에 바인딩될 변수의 크기 (문자열,이진데이터 크기)
        SQLINTEGER *    StrLen_or_IndPtr        // 매개변수의 길이/상태값을 반환 받을 변수
);

4.4. ODBC 진단 정보