ODBC 핸들
우선 sql.h와 sqlext.h헤더를 포함시켜줘야한다. 그리고 odbc32.lib와 연결을 시켜줘야한다.
SQLRETURN SQLAllocHandle(SQLSMALLINT HandleType, SQLHANDLE InputHandle, SQLHANDLE *OutputHandlePtr);
SQL핸들을 할당한다.
HandleType에는 4가지가 있다. SQL_HANDLE_ENV, SQL_HANDLE_DBC, SQL_HANDLE_STMT, SQL_HANDLE_DESC중 하나를 선택할수 있다.
InputHandle에는 만들어질 핸들에 연결되는 핸들이다. 환경핸들은 처음 설정되므로 SQL_NULL_HANDLE을 넣어준다.
OutputHandlePtr에는 새로 만들어질 핸들의 주소를 넣어준다.
SQLRETURN SQLFreeHandle(SQLSMALLINT HandleType, SQLHANDLE InputHandle);
SQL핸들을 해제한다.
환경 핸들
데이터 액세스에 필요한 여러 가지 정보들이 저장된다. 환경의 현재 상태, 진단 정보, 환경의 속성, 연결에 관련된 정보등이다.
SQLAllocHandle(SQL_HANDLE_DBC,SQL_NULL_HANDLE,환경 핸들의 주소);
SQLRETURN SQLSetEnvAttr(SQLHENV EnvironmentHandles, SQLINTEGER Attribute, SQLPOINTER ValuePtr, SQLINTEGER StringLength);
EnvironmentHandles은 환경 핸들, Attribute는 설정하고자 하는 속성의 종류, ValuePtr은 속성값, StringLength는 속성값의 길이이다.
환경속성중 가장 중요한 값은 SQL_ATTR_ODBC_VERSION 속성인데 3.0버젼은 SQL_OV_ODBC3을 넣어준다.
연결 핸들
연결핸들은 데이터 소스와 드라이버에 대한 정보를 가진다. 연결의 상태, 진단 정보, 명령 핸들과 설명자 핸들의 목록, 연결의 속성등의
정보가 포함된다.
연결 핸들을 할당할때 우선 환경핸들의 속성이 필요하다
SQLAllocHandle(SQL_HANDLE_DBC,환경핸들,연결핸들의 주소);
SQLRETURN SQLDriverConnect(
SQLHDBC ConnectionHandle, // 할당한 연결핸들
SQLHWND WindowHandle, // 윈도우 핸들
SQLCHAR *InConnectionString, // 연결 문자열(연결을 위한 정보를 가지는 문자열로 일반적으로 일련의 키 = 값으로 구성된다.)
SQLSMALLINT StringLength1, // 연결 문자열의 길이
SQLCHAR *OutConnectionString, // 입력되는 데이터에 따라 완성된 문자열이 생성된다. 그 문자열을 얻을 수 있다.
SQLSMALLINT BufferLength, // 출력 연결 문자열의 버퍼의 길이
SQLSMALLINT *StringLength2Ptr, // 출력되는 문자열의 총 길이
SQLUSMALLINT DriverCompletion); // 기본은 SQL_DRIVER_NOPROMPT이다. SQL_DRIVER_COMPLETE로 필수적인 정보중에 누락된 정보를 입력받고 진행한다.
연결되는 타입에 따른 InConnectionString의 값.
MDB는 엑세스인데 파일로 존재하는 DB이다.
들어가는 문자열은 "DRIVER={Microsoft Access Driver (*.mdb)};DBQ=파일이름" 이렇게 들어간다.
FileDSN을 사용하는 경우는 문자열로 "FileDsn=경로" 가 들어간다.
SQL서버를 사용하는 경우는 밑의 함수를 사용하자. 간편하다.
SQLRETURN SQLConnect(
SQLHDBC ConnectionHandle, // 연결 핸들
SQLCHAR *ServerName, // 서버 이름
SQLSMALLINT NameLength1, // 서버 이름의 길이. SQL_NTS를 사용하면 편하다.
SQLCHAR *UserName, // 유저 ID.
SQLSMALLINT NameLength2, // 유저 ID의 길이. SQL_NTS를 사용하면 편하다.
SQLCHAR *Authentication, // 패스워드.
SQLSMALLINT NameLenght3 // 패스워드의 길이. SQL_NTS를 사용하면 편하다.
);
SQLRETURN SQLDisconnect(SQLHDBC ConnectionHandle);
연결 핸들의 연결을 끊어준다.
명령 실행
SQLRETURN SQLExecDirect(SQLHSTMT StatementHandle, SQLCHAR *StatementText, SQLINEGER TextLength);
StatementHandle는 명령핸들, StatementText는 SQL문, TextLength은 SQL문의 길이
여기서 SQL문의 길이를 넣을때 문자열이 널문자로 끝나는 경우 SQL_NTS로 지정하면 된다.
SQLRETURN SQLBindCol(
SQLHSTMT StatementHandle, // 명령 핸들
SQLUSMALLINT ColumnNumber, // 바인딩될 컬럼의 번호. 컬럼의 번호는 1부터 시작한다.
SQLSMALLINT TargetType, // 바인딩될 데이터 타입. 위의 C형식의 데이터 타입.
SQLPOINTER TargetValuePtr, // 결과값을 받을 버퍼
SQLINTEGER BufferLength, // 버퍼의 길이
SQLLEN *StrLen_or_Ind // 길이 또는 상태값을 받는데 컬럼의 길이나 상태를 반환한다. 아무칼럼이 없을때 SQL_NULL_DATA를 반환한다.
);
결과값 처리를 위해 바인딩이 필요하다.
insert문이나 update문이 아닌 select문일 경우 결과를 받는 데이터 타입으로 변환을 한다.
SQLRETURN SQL_Fetch(SQLHSTMT StatementHandle);
바인딩된 변수에 결과값을 채워주고 행(row)에 따라 다음으로 이동한다.
아무 값도 없을 경우 SQL_NO_DATA를 반환한다.
StatementHandle에는 명령 핸들이 들어간다.
SQLRETURN SQL_CloseCursor(SQLHSTMT StateHandle);
명령 핸들에 열려진 커서를 닫고 결과셋을 버린다. 명령 핸들을 삭제하기 전에 이루어 진다.
파라미터 사용
등록된 SQL문자열에 ?(Parameter Market)된 부분에 실행중에 바인딩된 변수값으로 대체할 수 있다.
그냥 문자열 조합도 할 수 있겠지만 이렇게 하는 편이 속도가 빠르다.
SQLRETURN SQLBindParameter(
SQLHSTMT StatementHandle, // 명령 핸들
SQLUSMALLINT ParameterNumber, // 파라미터 번호. ?가 나타내는 시점에서 1부터 시작한다.
SQLSMALLINT InputOutputType, // 파라미터의 용도를 설정한다. 입력용(SQL_PARAM_INPUT), 출력용, 입출력겸용으로 사용할 수 있다.
SQLSMALLINT ValueType, // 파라미터의 데이터 타입. C형
SQLSMALLINT ParameterType, // 파라미터의 데이터 타입. SQL형
SQLUINTEGER ColumnSize, // 변수의 크기. 그냥 문자열만 길이를 아님 0으로..
SQLSMALLINT DecimalDigits, // 자리수. 그냥 0으로..
SQLPOINTER ParameterValuePtr, // 파라미터와 연결될 변수의 번지
SQLINTEGER BufferLength, // 파라미터 문자열이나 이진형일 때 버퍼의 크기를 지정. 그냥 0으로..
SQLINTEGER *Strlen_or_IndPtr // 길이나 상태. 길이는 역시 SQL_NTS를 사용하면 된다.
);
SQLRETURN SQLPrepare(SQLHSTMT StatementHandle, SQLCHAR *StatementText, SQLINTEGER TextLength);
이름 그대로 SQL실행을 준비한다. 여기서 준비라는 것은 미리 컴파일해 놓는다는 뜻인데 주로 파라미터와 같이 사용된다.
여기서 파라미터로 바인딩되는 변수의 내용을 바꿔주면서 반복할 경우 동일한 문자열 조합보다 빠르다.
StatementHandle은 명령 핸들이고 StatementText는 SQL문장이다. TextLength는 문자열의 길이로 역시나 SQL_NTS를 사용시 간편하다.
SQLRETURN SQLExecute(SQLHSTMT StatementHandle);
실행한다. StatementHandle은 연결핸들이고 위의 함수와 연결되서 사용된다.
진단 정보
SQLRETURN 형이다.
-----------------------------------------------------------------------------------------------------------------------
에러 실제값 의미
-----------------------------------------------------------------------------------------------------------------------
SQL_SUCCESS 0 함수 호출이 성공.
SQL_SUCCESS_WITH_INFO 1 함수 호출은 성공했으나 경고가 발생. 경우에 따라 무시할수도 있고 그렇지 않을수도 있음
SQL_ERROR -1 일반적인 에러이다.
SQL_INVALID_HANDLE -2 핸들이 무효하다. 이건 100%코드를 잘못 사용하였기 때문이다. 반드시 수정.
SQL_NO_DATA 100 더이상 읽어올 데이터가 없다. 모든 레코드를 다 읽은 EOF상황이다.
SQL_NEED_DATA 99 추가적인 정보가 필요하다. 실행중에 더 많은 필요한 파라미터 데이터를 보내야 하는 경우다.
SQL_STILL_EXECUTING 2 함수가 비동기적으로 실행되었고 아직 실행중이다.
-----------------------------------------------------------------------------------------------------------------------
윈도우의 GetLastError와 같은 역활을 하는 SQLGetDiagField함수
정보는 헤더레코드와 상태레코드가 있다.
헤더레코드(Header Record)는 함수의 성공유무랑은 상관없이 리턴코드, 리턴된 레코드개수, 상태 레코드의 개수, 실행된 명령어의 종류등이 포함된다.
상태레코드(Status Record)는 보통 하나가 리턴되나 여러 개의 에러가 동시에 생겼을때는 상태레코드의 개수도 그만큼 리턴된다.
SQLRETURN SQLGetDiagField(
SQLSMALLINT HandleType, // 핸들 타입이다.
SQLHANDLE Handle, // 핸들이다.
SQLSMALLINT RecNumber, // 0번 헤더 레코드, 1번 이상 상태 레코드
SQLSMALLINT DiagIdentifier, // 읽고자 하는 필드의 이름. 레퍼런스 참조 하시오.
SQLPOINTER DiagInfoPtr, // 정보를 얻기위한 출력용 변수
SQLSMALLINT BufferLength, // 위의 변수의 버퍼의 크기
SQLSMALLINT *StringLengthPtr // 출력 되고자 하는 내용의 크기
);
이 함수는 레코드의 내용을 필드단위로 읽을 수 있다.
SQLRETURN SQLGetDiagRec(
SQLSMALLINT HandleType, // 핸들 타입
SQLHANDLE Handle, // 핸들
SQLSMALLINT RecNumber, // 0번 헤더 레코드, 1번 이상 상태 레코드
SQLCHAR *SqlState, // 다섯자로된 문자열로 구성 밑에 대표적인 몇가지이다.
SQLINTEGER *NativeErrorPtr, // 고유 에러 코드. DBMS마다 다름. 그러므로 잘 안쓰임.
SQLCHAR *MessageText, // 에러 발생 원인의 텍스트. 예를 들면 "테이블이 없네요." "컬럼 이름이 틀렸어요" 이런-_-
SQLSMALLINT BufferLength, // 위의 변수의 버퍼의 크기
SQLSMALLINT *TextLengthPtr // 출력 되고자 하는 내용의 크기
);
이 함수는 레코드의 내용인 모든 필드를 한번에 읽어 온다.
-------------------------------------------------------------
SQLSTATE 설명
-------------------------------------------------------------
01000 일반적인 에러
01004 문자열의 오른쪽이 잘렸다. 바인딩된 버퍼의 길이가 짧다.
01S02 옵션이 변경되었다.
22003 숫자의 범위가 넘었다.
42000 문법에러 또는 액세스 위반
42S02 테이블 또는 뷰가 존재하지 않는다.
HY000 일반적인 에러
HYC00 옵션으로 제공되는 기능이 구현되지 않었음.
HYT00 제한시간 초과
-------------------------------------------------------------
EditText
of this page
(last modified 2008-11-05 11:01:00)
FindPage
by browsing, searching, or an index
Or try one of these actions:
DeletePage,
DeleteUploadedFile,
LikePages,
SpellCheck,
UploadFile
