DBMCreateTable

DBMCreateTable

Description
주어진 스키마를 가진 테이블을 생성한다.

Syntax
DBMErr DBMCreateTable(P_U8 tableName, S32 numFieldInfos, FieldInfo *fieldInfo, FieldId secondaryKeyFieldId, TableId* tableId );

Parameters

tableName	테이블의 이름. 최대 길이는 TABLE_NAME_LEN이다. 이름의 끝은 '\0'으로 식별
numFieldInfos	필드의 개수
fieldInfo	테이블의 스키마 정보. 각 필드에 대해 이름, ID, 타입을 저장
secondaryKeyFieldId	secondary key 필드의 ID. secondary key가 필요하지 않은 경우 NULL_FIELD_ID로 지정하면 된다.
tableId	성공적으로 생성된 경우, unique tableId 값을 반환

Returns

value	설명
DBM_OK	성공적으로 수행된 경우
DBM_INVALID_TABLE_NAME	tableName의 길이가 적절하지 않은 경우 (0 < tableName의 길이 < TABLE_NAME_LEN이어야함)
DBM_TABLE_NAME_EXIST	주어진 테이블 이름이 이미 존재하는 경우
DBM_INVALID_FIELD_INFO	numFieldInfos가 적절하지 않은 경우 (0 < numFieldInfos <= NUM_FIELDS이어야 함) 0 <= 필드 id < NUM_FIELDS가 아닌 경우 필드의 타입이 적절하지 않은 경우 필드이름의 길이가 적절하지 않은 경우 (0 < 필드이름 길이 < FIELD_NAME_LEN) key 필드의 데이타 타입이 DBM_BLOB인 경우 필드 id가 서로 중복되는 경우 필드 이름이 서로 중복되는 경우 primary key 필드(id가 PRIM_KEY인 필드)가 존재하지 않는 경우 secondary key 필드id로 지정된 필드에 대한 fieldInfo가 없을때
DBM_MEM_ALLOC_ERR	필요한 메모리를 할당받지 못한 경우
DBM_DB_NOT_INITED	데이타베이스가 초기화되어 있지 않은 경우
DBM_FAIL	데이타베이스 상태에 모순이 있는 경우

Comments
테이블 이름은 전체 데이타베이스에서 unique해야 한다.
매개변수에서 사용되는 fieldInfo의 자료구조는 다음과 같다.

typedef struct {
  S8 name[FIELD_NAME_LEN+1];
  FieldId id;
  FieldDataType type;
} FieldInfo;

필드의 ID는 응용 프로그램이 설정하는데, 이때 다음 사항을 지켜야 한다.

0 : primary key field
0부터 29 : BLOB이 아닌 필드
30부터 31 : BLOB 필드

Example
#include "dbm.h"
#include <string.h>

void main(void)
{
   DBMErr ret;
   S8 table_name[TABLE_NAME_LEN+1];
   S32 num_fields;
   FieldInfo fieldInfo;
   FieldId secondaryFieldId;
   TableId tableId;

   strcpy(table_name, "table1");
   fieldInfo.id = 0;
   strcpy(fieldInfo.name, "first_name");
   fieldInfo.type = DBM_STRING;
   fieldInfo.id = 1;
   strcpy(fieldInfo.name, "age");
   fieldInfo.type = DBM_INT2;
   secondaryFieldId = 1;
   num_fields = 2;

   ret = DBMCreateTable(table_name, num_fields, fieldInfo, secondaryFieldId, &tableId);
   if (ret == DBM_OK)
     // Success!
   else
     // Failed!
}