Posting

Machbase의 최신 소식을 지금 만나보세요

Visual Studio 를 이용한 Machbase API 적용하기

마크베이스 기술전략본부 이현민

개요

프로그램을 개발하기 위해 전 세계 수많은 사람이 각자 선호하는, 언어에 알맞은 프로그래밍 통합개발 환경 Tool을 사용하고 있습니다. 이번 글에서는 많은 개발자분들이 요청하는 Visual Studio에서 Machbase C/C++ 언어를 통해 응용프로그램을 개발 할 수 있도록 환경을 구성하는 방법에 대해 글을 작성합니다. Visual Studio Version은 2017로 진행을 하게 될 것이며 2017이 아니더라도 2010을 제외한 환경에서 모두 적용이 되니 걱정하지 않아도 됩니다.

이번 페이지에서 사용하는 모든 코드 소스는 https://github.com/MACHBASE/VisualStudio_Connect 에서 다운 받을 수 있습니다. 이 외에 실제 소스코드는 언급되지 않습니다.

프로젝트 생성

Visual Studio 2017을 실행하여 C++ 프로젝트를 만드십시오. 파일(F) -> 새로 만들기(N) -> 프로젝트(P) 또는 Ctrl + Shift + n 으로 만들 수 있습니다.
새프로젝트의 이름은 Machbase_dev로 하고 빈프로젝트로 만듭니다.

소스 파일 생성

프로젝트를 만들었다면 이제 소스 파일을 추가할 차례입니다. 방금 막 Visual Studio를 설치하고 프로젝트를 만드셨다면 Visual Studio 화면 우측에 솔루션 탐색기가 존재합니다. 솔루션 탐색기에서 소스 파일에 마우스 우클릭 -> 추가 -> 새항목 또는 소스 파일 클릭 Ctrl + Shift + A를 하면 새로운 소스 파일을 생성할 수 있습니다. 새로운 소스 파일의 이름은 프로젝트 이름과 동일한 Machbase_dev.cpp로 하겠습니다.

생성한 이후 솔루션 탐색기 상태입니다.

헤더 파일 생성

이번에는 마크베이스 API를 Visual studio에서 사용할 수 있게 해주는 헤더 파일을 생성할 겁니다.  소스 파일을 만드는 것처럼 만들어 주십시오. 결과물로 다음 그림과 같이 만들어져야 합니다.

자 이제 우리는 더는 파일을 생성할 일이 없습니다. 우리는 차근차근 헤더 파일부터 Machbase Database에 접근하는 응용프로그램의 코드를 채워나갈 겁니다.

Machbase API 추가하기

헤더 파일과 소스 파일을 채우기 전에 우리는 Machbase_dev 프로젝트가 Machbase에서 제공하는 API를 인식 할 수 있도록 추가 작업을 해야 합니다. 추가작업 방법은 다음의 그림을 따라 하시면 됩니다.

가장 먼저 빌드환경을 설정해야 합니다. 아래 그림의 빨간 테두리 부분을 보게 되면 x86 또는 x64로 설정이 되어 있습니다. 각각의 운영체제에 맞게 설정을 해주시고 진행을 위해  x64로 설정을 하고 진행하도록 하겠습니다. x86에 대한 내용도 같이 언급되니 알맞게 설정하시면 됩니다.

빌드 환경설정을 끝 맞췄다면, 다음으로 프로젝트를 클릭하고 마우스 우클릭하여 속성에 들어갑니다.

속성을 눌러서 C/C++ -> 일반 항목에서 추가 포함 디렉터리에 MACHBASE_HOME\include 폴더를 포함해 줍니다. 결과 화면은 아래의 이미지처럼 되어야 합니다.

이번에는 링커 -> 일반 -> 추가 라이브러리 디렉터리 항목에 MACHBASE_HOME\lib 폴더를 포함해 줍니다. 결과 화면은 아래의 이미지처럼 되어야 합니다.

이제 마지막으로 링커 -> 입력으로 가서 추가 종속성에 “machbasecli.lib”를 추가할 겁니다.  만약 x64가 아닌 x86을 사용하신다면 “machbasecli_dll_32.lib”를 추가하면 됩니다.

이렇게 추가 종속성을 추가한 이후 적용 버튼을 눌러 마무리해 주십시오.

실행하기

지금까지 잘 따라왔다면 이제 단 한 가지 작업만 하게 된다면 예제소스를 실행 시켜 볼 수 있습니다. 프로젝트의 속성에 들어가서 다음의 항목을 변경해줘야 합니다.

위의 속성은 Const char * 타입과 char * 타입을 서로 호환시켜주는 설정입니다.

예제 소스는 DB 연결 -> Table 생성 -> Data 입력 -> DB 연결종료 순으로 진행됩니다.  “준수 모드” 설정을 적용했다면 이제 Ctrl + f5를 통해 실행하고 machsql을 통해 새로운 테이블과 데이터가 들어왔는지 확인해보면 됩니다. Console 창의 화면은 다음과 같이 보입니다.

멀티바이트와 유니코드

Visual Studio를 통해 각자의 알맞는 언어셋인 멀티바이트와 유니코드을 설정해 줄 수 있다.  설정을 통해 어떤 값을 사용할지 변경을 할 수 있지만 이렇게 할 경우 Code도 당연히 달라지게 됩니다. 우선 아래 이미지와 같이 프로젝트 속성을 통해 원하는 언어셋으로 설정 값을 바꾸어 봅시다. 

멀티바이트 문자 집합을 사용하였다면 https://github.com/MACHBASE/VisualStudio_Connect 사이트로 들어가서 자기에 알맞는 소스코드를 다운받아서 실행하면 됩니다.

멀티바이트 : Visualstudio2017exmaple_multi
유니코드 : Visualstudio2017exmaple_uni

맺으며

지금까지 Visual Studio에서 Machbase API 를 통한 응용프로그램 개발에 대해서 설명을 드렸습니다. 이제 Windows 환경에서 C 또는 C++ 언어를 이용하여 편하게 개발하시길 바랍니다. 감사합니다.

연관 포스트

C언어로 Binary data를 Machbase에 넣기

1.개요 Data를 다루다 보면 numeric, varchar 형 데이터뿐만 아니라 JPG, PNG, MP3와 같은 Binary data도 database에 저장해야 할 때가 존재한다. 그러나 일반 data들과는 달리 Binary

[MACHBASE 연동] Android studio에서 JDBC 연결하기

마크베이스 기술지원본부 이현민 1. 개요 수많은 데이터들이 많은 환경에서 생성되고 있는 오늘날, 우리 현대인들의 동반자인 스마트폰 또한 데이터생성의 주체로써 또는 전달자로서 알게 모르게 그 구실을