Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 12.0.1 » SQL Anywhere 服务器 - 编程 » 嵌入式 SQL

 

嵌入式 SQL 数据类型

要在程序和数据库服务器间传送信息,每个数据都必须有一个数据类型。嵌入式 SQL 数据类型常量以 DT_ 为前缀,并且可以在 sqldef.h 头文件中找到。您可以创建任何一种受支持类型的主机变量。您还可以在 SQLDA 结构中使用这些类型向数据库中传入和从中传出数据。

可以使用 sqlca.h 中列出的 DECL_ 宏定义这些数据类型的变量。例如,可使用 DECL_BIGINT 来声明保存 BIGINT 值的变量。

以下数据类型受嵌入式 SQL 编程接口的支持:

  • DT_BIT   8 位有符号整数。

  • DT_SMALLINT   16 位有符号整数。

  • DT_UNSSMALLINT   16 位无符号整数。

  • DT_TINYINT   8 位有符号整数。

  • DT_BIGINT   64 位有符号整数。

  • DT_UNSBIGINT   64 位无符号整数。

  • DT_INT   32 位有符号整数。

  • DT_UNSINT   32 位无符号整数。

  • DT_FLOAT   4 字节浮点数。

  • DT_DOUBLE   8 字节浮点数。

  • DT_DECIMAL   压缩十进制数(专有格式)。
    typedef struct TYPE_DECIMAL {
      char array[1];
    } TYPE_DECIMAL;

  • DT_STRING   在 CHAR 字符集中以空值终止的字符串。如果数据库是使用填补空白的字符串进行的初始化,则该字符串便是用空白填补的。

  • DT_NSTRING   在 NCHAR 字符集中以空值终止的字符串。如果数据库是使用填补空白的字符串进行的初始化,则该字符串便是用空白填补的。

  • DT_DATE   以空值终止的字符串,是一个有效日期。

  • DT_TIME   以空值终止的字符串,是一个有效时间。

  • DT_TIMESTAMP   以空值终止的字符串,是一个有效时间戳。

  • DT_FIXCHAR   在 CHAR 字符集中填补空白的定长字符串。最大长度为 32767(以字节为单位)。该数据不以空值终止。

  • DT_NFIXCHAR   在 NCHAR 字符集中填补空白的定长字符串。最大长度为 32767(以字节为单位)。该数据不以空值终止。

  • DT_VARCHAR   在 CHAR 字符集中具有双字节长度字段的变长字符串。最大长度为 32765 个字节。发送数据时,必须设置长度字段。读取数据时,数据库服务器设置长度字段。该数据不是以空值终止或以空白填补的。
    typedef struct VARCHAR {
     a_sql_ulen len;
     char       array[1];
    } VARCHAR;

  • DT_NVARCHAR   在 NCHAR 字符集中具有双字节长度字段的变长字符串。最大长度为 32765 个字节。发送数据时,必须设置长度字段。读取数据时,数据库服务器设置长度字段。该数据不是以空值终止或以空白填补的。
    typedef struct NVARCHAR {
     a_sql_ulen len;
     char       array[1];
    } NVARCHAR;

  • DT_LONGVARCHAR   在 CHAR 字符集中长变长字符串。
    typedef struct LONGVARCHAR {
     a_sql_uint32 array_len;  /* number of allocated bytes in array */
     a_sql_uint32 stored_len; /* number of bytes stored in array
                               * (never larger than array_len) */
     a_sql_uint32 untrunc_len;/* number of bytes in untruncated expression
                               * (may be larger than array_len) */
     char         array[1];   /* the data */
    } LONGVARCHAR, LONGNVARCHAR, LONGBINARY;

    LONGVARCHAR 结构可用于大于 32767 个字节的数据。对于较大的数据,可以一次全部读取,也可以使用 GET DATA 语句逐段读取。对于较大的数据,可以一次就全部提供给服务器,也可以通过使用 SET 语句附加到数据库变量中来逐段提供。该数据不是以空值终止或以空白填补的。

  • DT_LONGNVARCHAR   在 NCHAR 字符集中长变长字符串。该宏定义一个如下结构:
    typedef struct LONGVARCHAR {
     a_sql_uint32 array_len;  /* number of allocated bytes in array */
     a_sql_uint32 stored_len; /* number of bytes stored in array
                               * (never larger than array_len) */
     a_sql_uint32 untrunc_len;/* number of bytes in untruncated expression
                               * (may be larger than array_len) */
     char         array[1];   /* the data */
    } LONGVARCHAR, LONGNVARCHAR, LONGBINARY;

    LONGNVARCHAR 结构可用于大于 32767 个字节的数据。对于较大的数据,可以一次全部读取,也可以使用 GET DATA 语句逐段读取。对于较大的数据,可以一次就全部提供给服务器,也可以通过使用 SET 语句附加到数据库变量中来逐段提供。该数据不是以空值终止或以空白填补的。

  • DT_BINARY   具有双字节长度字段的变长二进制数据。最大长度为 32765 个字节。在向数据库服务器提供信息时,您必须设置长度字段。在从数据库服务器读取信息时,服务器设置长度字段。
    typedef struct BINARY {
     a_sql_ulen len;
     char       array[1];
    } BINARY;

  • DT_LONGBINARY   长二进制数据。该宏定义一个如下结构:
    typedef struct LONGVARCHAR {
     a_sql_uint32 array_len;  /* number of allocated bytes in array */
     a_sql_uint32 stored_len; /* number of bytes stored in array
                               * (never larger than array_len) */
     a_sql_uint32 untrunc_len;/* number of bytes in untruncated expression
                               * (may be larger than array_len) */
     char         array[1];   /* the data */
    } LONGVARCHAR, LONGNVARCHAR, LONGBINARY;

    LONGBINARY 结构可用于大于 32767 个字节的数据。对于较大的数据,可以一次全部读取,也可以使用 GET DATA 语句逐段读取。对于较大的数据,可以一次就全部提供给服务器,也可以通过使用 SET 语句附加到数据库变量中来逐段提供。

  • DT_TIMESTAMP_STRUCT   SQLDATETIME 结构,对于时间戳的每一部分都有一个字段。


    typedef struct sqldatetime {
     unsigned short year; /* for example 1999 */
     unsigned char  month; /* 0-11 */
     unsigned char  day_of_week; /* 0-6 0=Sunday */
     unsigned short day_of_year; /* 0-365 */
     unsigned char  day; /* 1-31 */
     unsigned char  hour; /* 0-23 */
     unsigned char  minute; /* 0-59 */
     unsigned char  second; /* 0-59 */
     unsigned long  microsecond; /* 0-999999 */
    } SQLDATETIME;

    SQLDATETIME 结构可用于检索 DATE、TIME 和 TIMESTAMP 类型(或者可转换为这些类型之一的任意类型)的字段。应用程序常常具有它们自己的格式和日期操作代码。在该结构中读取数据可为操作该数据提供更多方便。注意,您也可以使用任何字符类型来读取和更新 DATE、TIME 和 TIMESTAMP 字段。

    如果您使用 SQLDATETIME 结构将日期、时间或时间戳输入到数据库中,则会忽略 day_of_year 和 day_of_week 成员。

  • DT_VARIABLE   以空值终止的字符串。字符串必须是 SQL 变量的名称,数据库服务器使用该变量的值。此数据类型仅用于为数据库服务器提供数据。在从数据库服务器读取数据时,不能使用它。

这些结构在 sqlca.h 文件中定义。由于 VARCHAR、NVARCHAR、BINARY、DECIMAL 和 LONG 数据类型包含一个单字符数组,因此,它们对于声明主机变量没有帮助。但是,它们对于动态分配变量或强制转换其它变量的类型十分有用。

 DATE 和 TIME 数据库类型
 另请参见