16.7. 创建表

一旦实例化了处理程序，所需的第1个操作很可能是创建表。

你的存储引擎必须实现create()虚拟函数：

virtual int create(const char *name, TABLE *form, HA_CREATE_INFO *info)=0;

该函数应创建所有必须的文件，然后关闭表。MySQL服务器将调用随后需打开的表。

*name参数是表的名称。*form参数是st_table结构，该结构定义了表并与MySQL服务器已创建的tablename.frm文件的内容匹配。在大多数情况下，存储引擎不需要更改tablename.frm文件，也没有支持该操作的预置功能。

*info参数是包含CREATE TABLE语句用于创建表所需信息的结构。该结构定义于handler.h文件中，并为了便于参考列于下面：

typedef struct st_ha_create_information

  {

    CHARSET_INFO *table_charset, *default_table_charset;

    LEX_STRING connect_string;

    const char *comment,*password;

    const char *data_file_name, *index_file_name;

    const char *alias;

    ulonglong max_rows,min_rows;

    ulonglong auto_increment_value;

    ulong table_options;

    ulong avg_row_length;

    ulong raid_chunksize;

    ulong used_fields;

    SQL_LIST merge_list;

    enum db_type db_type;

    enum row_type row_type;

    uint null_bits;       /* NULL bits at start of record */

    uint options;       /* OR of HA_CREATE_ options */

    uint raid_type,raid_chunks;

    uint merge_insert_method;

    uint extra_size;      /* length of extra data segment */

    bool table_existed;     /* 1 in create if table existed */

    bool frm_only;/* 1 if no ha_create_table() */

    bool varchar; /* 1 if table has a VARCHAR */

  } HA_CREATE_INFO;

基本的存储引擎能忽略*form和*info的内容，这是因为，真正所需的是创建存储引擎所使用的数据文件，以及对数据文件的可能初始化操作（假定存储文件是基于文件的）。

下面给出了来自CSV存储引擎的实施示例：

int ha_tina::create(const char *name, TABLE *table_arg,

  HA_CREATE_INFO *create_info)

  {

    char name_buff[FN_REFLEN];

    File create_file;

    DBUG_ENTER("ha_tina::create");

    if ((create_file= my_create(fn_format(name_buff, name, "", ".CSV",

  MY_REPLACE_EXT|MY_UNPACK_FILENAME),0,

  O_RDWR | O_TRUNC,MYF(MY_WME))) < 0)

    DBUG_RETURN(-1);

    my_close(create_file,MYF(0));

    DBUG_RETURN(0);

  }

在前面的例子中，CSV引擎未引用*table_arg或*create_info参数，而是简单地创建了所需的数据文件，关闭它们，并返回。

my_create和my_close函数是定义于src/include/my_sys.h文件中的助手函数。