Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 2 Next »

응용 프로그램 개발

CLI 설치 확인

MACHBASE가 설치된 디렉터리의 include 및 lib에 다음과 같은 파일이 있으면 응용 프로그램을 개발할 수 있는 환경이 완비된 것이다.

Mach@localhost:~/machbase_home$ ls -l include lib install/
include:
total 176
-rwxrwxr-x 1 mach mach 31449 Jun 18 19:26 machbase_sqlcli.h

install/:
total 12
-rw-rw-r-- 1 mach mach 1667 Jun 18 19:26 machbase_env.mk

lib:
total 16196
-rw-rw-r-- 1 mach mach 78603 Jun 18 19:26 machbase.jar
-rw-rw-r-- 1 mach mach 964290 Jun 18 19:26 libmachbasecli.a



Makefile 작성 가이드

mach@localhost:~/machbase_home$ cd sample/
mach@localhost:~/machbase_home/sample$ cd cli/
mach@localhost:~/machbase_home/sample/cli$ ls
Makefile sample1_connect.c
mach@localhost:~/machbase_home/sample/cli$


MACHBASE 패키지를 설치했다면, 다음 경로에 샘플 프로그램이 설치되어 있을 것이다.

include $(MACHBASE_HOME)/install/machbase_env.mk
INCLUDES += $(LIBDIR_OPT)/$(MACHBASE_HOME)/include

all : sample1_connect

sample1_connect : sample1_connect.o
$(LD_CC) $(LD_FLAGS) $(LD_OUT_OPT)$@ $< $(LIB_OPT)machbasecli$(LIB_AFT) $(LIBDIR_OPT)$(MACHBASE_HOME)/lib $(LD_LIBS)

sample1_connect.o : sample1_connect.c
$(COMPILE.cc) $(CC_FLAGS) $(INCLUDES) $(CC_OUT_OPT)$@ $<

clean :
rm -f sample1_connect


컴파일 및 링크

주어진 샘플에 대해 다음과 같이 수행하면 실행파일이 만들어진다.

mach@localhost:~/machbase_home/sample/cli$ make
gcc -c -g -W -Wall -rdynamic -O3 -finline-functions -fno-omit-frame-pointer -fno-strict-aliasing -m64 -mtune=k8 -g -W -Wall -rdynamic -O3 -finline-functions -fno-omit-frame-pointer -fno-strict-aliasing -m64 -mtune=k8 -I/home/machbase/machbase_home/include -I. -L//home/machbase/machbase_home/include -osample1_connect.o sample1_connect.c
gcc -m64 -mtune=k8 -L/home/machbase/machbase_home/lib -osample1_connect sample1_connect.o -lmachbasecli -L/home/machbase/machbase_home/lib -lm -lpthread -ldl -lrt -rdynamic
mach@localhost:~/machbase_home/sample/cli$ ls -al
total 1196
drwxrwxr-x 2 mach mach 4096 Jun 18 20:15 .
drwxrwxr-x 4 mach mach 4096 Jun 18 19:26 ..
-rw-rw-r-- 1 mach mach 483 Jun 18 19:26 Makefile
-rwxrwxr-x 1 mach mach 1196943 Jun 18 20:15 sample1_connect
-rw-rw-r-- 1 mach mach 549 Jun 18 19:26 sample1_connect.c
-rw-rw-r-- 1 mach mach 8168 Jun 18 20:15 sample1_connect.o
mach@localhost:~/machbase_home/sample/cli$


샘플 프로그램

접속 예제

CLI를 이용하여 접속하는 예제 프로그램을 작성해 보기로 한다.

샘플 파일명은 sample1_connect.c 로 한다.

MACHBASE_PORT_NO는 $MACHBASE_HOME/conf/machbase.conf 파일에 있는 PORT_NO 값과 같아야 한다.

{code:language=

Makefile에 sample1_connect.c를 등록하고 컴파일하여 실행하면 다음과 같이 나온다. 

{code:language=

데이터 입력 및 출력 예제

아래의 예제소스는 create table 을 이용하여 table을 생성, 간단한 data값들을 임의로 생성해서 INSERT 구문을 사용해서 이용하여 데이터를 직접 입력하는 것과 SELECT 구문을 이용하여 데이터를 출력한다. 이를 활용하여 직접 값을 입력하고 확인할때 각 타입별로 어떻게 설정을 해야 하는지 알수 있을 것이다.

샘플 파일명은 sample2_insert.c 라고 한다.

{code:language=

Makefile에 sample2_insert.c를 등록하고 컴파일하여 실행하면 다음과 같이 나온다. 

{code:language=

Prepare Execute 예제

데이터를 binding하여 INSERT하는 예제 프로그램을 작성해 보자.

MACHBASE에서 데이터를 binding 하는 방식으로 값을 입력할수 있는데 이를 이용할시에는 데이터의 값들의 타입들을 명확히 지정해주고, 긴 문자열 타입들의 경우에는 length 값들을 반드시 지정해줘야 한다.

아래의 예제를 통해서 각 타입별로 데이터를 binding하는 방법을 알수 있다.

파일명은 sample3_prepare.c 라고 한다.

{code:language=

Makefile에 sample3_prepare.c를 등록하고 컴파일하여 실행하면 다음과 같이 나온다.

{code:language=

확장 함수 Append 예제

MACHBASE에서는 대량의 데이터를 파일로 부터 읽어서 고속으로 입력하는 방법으로 append protocol을 제공하고 있다. 이 append protocol을 이용하는 예제 프로그램을 작성해 보자.

먼저 MACHBASE에서 제공하는 다양한 타입별로 append 하는 방식의 예제를 살펴보자. Append 방식은 각 타입별로 편리하게 입력해 줄수 있도록 각각의 설정값들이 정해져있다. 그러므로 모든 방법별로 사용하는 입력하는 방식에 대한 숙지를 한다면 더욱더 효율적으로 프로그램을 작성 할 수 있을 것이다. 아래쪽에 있는 예제 코드에 그 방법들이 모두 나와있다.

파일명은 sample4_append1.c 라고 한다.

{code:language=

Makefile에 sample4_append1.c를 등록하고 컴파일하여 실행하면 다음과 같이 나온다.

{code:language=

이제 파일을 이용해서 고속으로 append하는 방식을 사용해 보자. 실제로 업무에서 사용되는 많은 양의 로그, 패킷등의 값들을 고속으로 입력하는 데 유용한 예제이다. 파일명은 sample4_append2.c 라고 한다.

미리 입력할 데이터를 data.txt에 저장해 두어야 한다. ./make_data

미리 주어진 make_data.c 를 수정하면 상황에 맞게 data.txt 파일을 생성할 수 있다.

{code:language=

Makefile에 sample4_append2.c를 등록하고 컴파일하여 실행하면 다음과 같이 나온다.

{code:language=

테이블 열 정보 획득 예제

테이블 열 정보를 획득하는 방법은 다양하지만 그중에 SQLDescribeCol과 SQLColumns를 이용한 방법을 살펴본다.

SQLDescribeCol

SQLDescribeCol은 테이블 열의 번호, 이름, 버퍼크기, 길이, 타입등을 가져오는 함수로 이를 이용해서 데이터베이스 내부에서 원하는 내용을 손쉽게 가져올수 있다.

예제 파일명은 sample5_describe.c 라고 한다.

{code:language=

위의 파일을 추가하고 make를 실행하면 아래와 같이 원하는 열의 내용들 값이 나타나는 것을 볼수 있다.

{code:language=

SQLColumns

SQLColumns은 현재 테이블내에서 존재하는 컬럼들의 정보를 알아 낼수 있는 함수이다. MACHBASE에서도 위와 같은 함수를 지원하고 있으며 이를 이용하여 컬럼 각각의 정보들을 알아내고 분석에 용이하다.

파일이름은 sample6_columns.c라고 한다.

{code:language=

위의 파일을 추가하고 make를 실행한다. 결과는 다음과 같다.

{code:language=

멀티 쓰레드 append 예제

하나의 프로그램에서 multi thread를 이용해 여러 테이블에 append하는 예제이다. 파일 이름은 sample8_multi_session_multi_table.c로 한다.

{code:language=

make 코드를 추가하고 실행파일을 실행해본다. 쓰레드를 이용하므로 출력 순서가 다를 수 있다. 실행 결과는 다음과 같다.

{code:language=


machsql을 통해 아래와 같이 결과를 확인할 수 있다.

{code:language=

  • No labels