在第 34.3 节中,您了解了如何从嵌入式 SQL 程序执行 SQL 语句。其中一些语句仅使用固定值,并且没有提供将用户提供的值插入到语句中或让程序处理查询返回的值的方法。这些语句在实际应用中不是很有用。本节详细解释如何使用一个称为宿主变量的简单机制在 C 程序和嵌入式 SQL 语句之间传递数据。在嵌入式 SQL 程序中,我们将 SQL 语句视为 C 程序代码中的客人,而 C 程序代码是宿主语言。因此,C 程序的变量称为宿主变量。
在 PostgreSQL 后端和 ECPG 应用程序之间交换值的另一种方法是使用 SQL 描述符,详见第 34.7 节。
在嵌入式 SQL 中,在 C 程序和 SQL 语句之间传递数据特别简单。您可以直接在 SQL 语句中写入 C 变量的名称,并在其前面加上冒号,而不是让程序将数据粘贴到语句中,这会带来各种复杂性,例如正确引用值。例如
EXEC SQL INSERT INTO sometable VALUES (:v1, 'foo', :v2);
此语句引用了两个名为 v1
和 v2
的 C 变量,并且还使用了一个常规 SQL 字符串字面量,以说明您不局限于使用一种类型的数据。
这种在 SQL 语句中插入 C 变量的方式适用于 SQL 语句中期望使用值表达式的任何地方。
为了将数据从程序传递到数据库,例如作为查询中的参数,或者将数据从数据库传递回程序,需要将打算包含此数据的 C 变量在特别标记的节中声明,以便嵌入式 SQL 预处理器知道它们。
此节以
EXEC SQL BEGIN DECLARE SECTION;
开始,以
EXEC SQL END DECLARE SECTION;
结束。在这些行之间,必须有正常的 C 变量声明,例如
int x = 4; char foo[16], bar[16];
如您所见,您可以选择为变量分配初始值。变量的作用域由其在程序中声明节的位置决定。您还可以使用以下语法声明变量,该语法会隐式创建声明节
EXEC SQL int i = 4;
您可以在程序中拥有任意多个声明节。
声明也会作为正常的 C 变量回显到输出文件中,因此无需再次声明它们。不打算在 SQL 命令中使用的变量可以在这些特殊节之外正常声明。
结构或联合的定义也必须在 DECLARE
节内列出。否则,预处理器无法处理这些类型,因为它不知道定义。
现在,您应该能够将程序生成的数据传递到 SQL 命令中。但是如何获取查询的结果呢?为此,嵌入式 SQL 提供了常用命令 SELECT
和 FETCH
的特殊变体。这些命令有一个特殊的 INTO
子句,该子句指定将检索到的值存储在哪个宿主变量中。SELECT
用于仅返回单行的查询,而 FETCH
用于使用游标返回多行的查询。
以下是一个示例
/* * assume this table: * CREATE TABLE test1 (a int, b varchar(50)); */ EXEC SQL BEGIN DECLARE SECTION; int v1; VARCHAR v2; EXEC SQL END DECLARE SECTION; ... EXEC SQL SELECT a, b INTO :v1, :v2 FROM test;
因此,INTO
子句出现在选择列表和 FROM
子句之间。选择列表中的元素数量和 INTO
之后的列表(也称为目标列表)必须相等。
以下是使用命令 FETCH
的示例
EXEC SQL BEGIN DECLARE SECTION; int v1; VARCHAR v2; EXEC SQL END DECLARE SECTION; ... EXEC SQL DECLARE foo CURSOR FOR SELECT a, b FROM test; ... do { ... EXEC SQL FETCH NEXT FROM foo INTO :v1, :v2; ... } while (...);
此处,INTO
子句出现在所有正常子句之后。
当 ECPG 应用程序在 PostgreSQL 服务器和 C 应用程序之间交换值时,例如从服务器检索查询结果或使用输入参数执行 SQL 语句时,需要在 PostgreSQL 数据类型和宿主语言变量类型(具体而言是 C 语言数据类型)之间转换值。ECPG 的主要优点之一是它在大多数情况下会自动处理此问题。
在这方面,有两种数据类型:一些简单的 PostgreSQL 数据类型,例如 integer
和 text
,可以直接被应用程序读取和写入。其他 PostgreSQL 数据类型,例如 timestamp
和 numeric
,只能通过特殊的库函数访问;请参阅第 34.4.4.2 节。
表 34.1显示了哪些 PostgreSQL 数据类型对应于哪些 C 数据类型。当您希望发送或接收给定 PostgreSQL 数据类型的值时,应在声明节中声明相应 C 数据类型的 C 变量。
表 34.1. PostgreSQL 数据类型和 C 变量类型之间的映射
PostgreSQL 数据类型 | 宿主变量类型 |
---|---|
smallint |
short |
integer |
int |
bigint |
long long int |
decimal |
decimal [a] |
numeric |
numeric [a] |
real |
float |
double precision |
double |
smallserial |
short |
serial |
int |
bigserial |
long long int |
oid |
unsigned int |
character( 、varchar( 、text |
char[ 、VARCHAR[ |
name |
char[NAMEDATALEN] |
timestamp |
timestamp [a] |
interval |
interval [a] |
date |
date [a] |
boolean |
bool [b] |
bytea |
char * 、bytea[ |
[a] 此类型只能通过特殊的库函数访问;请参阅第 34.4.4.2 节。 [b] 如果不是原生类型,则在 |
要处理 SQL 字符串数据类型(例如 varchar
和 text
),有两种方法可以声明宿主变量。
一种方法是使用 char[]
(char
的数组),这是在 C 中处理字符数据的最常见方法。
EXEC SQL BEGIN DECLARE SECTION; char str[50]; EXEC SQL END DECLARE SECTION;
请注意,您必须自己注意长度。如果您使用此宿主变量作为返回字符串超过 49 个字符的查询的目标变量,则会发生缓冲区溢出。
另一种方法是使用 VARCHAR
类型,这是 ECPG 提供的一种特殊类型。类型为 VARCHAR
的数组的定义将转换为每个变量的命名 struct
。如下声明
VARCHAR var[180];
转换为
struct varchar_var { int len; char arr[180]; } var;
成员 arr
存储包含终止零字节的字符串。因此,要在 VARCHAR
主机变量中存储字符串,必须声明主机变量的长度包含零字节终止符。成员 len
保存存储在 arr
中的字符串的长度,不包括终止零字节。当主机变量用作查询的输入时,如果 strlen(arr)
和 len
不同,则使用较短的那个。
VARCHAR
可以用大写或小写书写,但不能大小写混合。
char
和 VARCHAR
主机变量也可以保存其他 SQL 类型的值,这些值将以字符串形式存储。
ECPG 包含一些特殊类型,可帮助您轻松与 PostgreSQL 服务器中的一些特殊数据类型进行交互。特别是,它实现了对 numeric
、decimal
、date
、timestamp
和 interval
类型的支持。这些数据类型不能有效地映射到原始主机变量类型(例如 int
、long long int
或 char[]
),因为它们具有复杂的内部结构。应用程序通过以特殊类型声明主机变量并使用 pgtypes 库中的函数来访问这些类型。pgtypes 库,在第 34.6 节中有详细介绍,包含处理这些类型的基本函数,因此您无需仅为了例如将一个 interval 添加到时间戳而向 SQL 服务器发送查询。
以下小节描述了这些特殊数据类型。有关 pgtypes 库函数的更多详细信息,请参见第 34.6 节。
以下是在 ECPG 主机应用程序中处理 timestamp
变量的模式。
首先,程序必须包含 timestamp
类型的头文件
#include <pgtypes_timestamp.h>
接下来,在声明部分中将主机变量声明为 timestamp
类型
EXEC SQL BEGIN DECLARE SECTION; timestamp ts; EXEC SQL END DECLARE SECTION;
并在读取值到主机变量后,使用 pgtypes 库函数进行处理。在下面的示例中,使用 PGTYPEStimestamp_to_asc()
函数将 timestamp
值转换为文本 (ASCII) 形式
EXEC SQL SELECT now()::timestamp INTO :ts; printf("ts = %s\n", PGTYPEStimestamp_to_asc(ts));
此示例将显示类似以下的结果
ts = 2010-06-27 18:03:56.949343
此外,可以使用相同的方式处理 DATE 类型。程序必须包含 pgtypes_date.h
,将主机变量声明为 date 类型,并使用 PGTYPESdate_to_asc()
函数将 DATE 值转换为文本形式。有关 pgtypes 库函数的更多详细信息,请参见第 34.6 节。
对 interval
类型的处理也类似于 timestamp
和 date
类型。但是,需要显式为 interval
类型值分配内存。换句话说,变量的内存空间必须在堆内存中分配,而不是在栈内存中。
这是一个示例程序
#include <stdio.h> #include <stdlib.h> #include <pgtypes_interval.h> int main(void) { EXEC SQL BEGIN DECLARE SECTION; interval *in; EXEC SQL END DECLARE SECTION; EXEC SQL CONNECT TO testdb; EXEC SQL SELECT pg_catalog.set_config('search_path', '', false); EXEC SQL COMMIT; in = PGTYPESinterval_new(); EXEC SQL SELECT '1 min'::interval INTO :in; printf("interval = %s\n", PGTYPESinterval_to_asc(in)); PGTYPESinterval_free(in); EXEC SQL COMMIT; EXEC SQL DISCONNECT ALL; return 0; }
对 numeric
和 decimal
类型的处理类似于 interval
类型:它需要定义一个指针,在堆上分配一些内存空间,并使用 pgtypes 库函数访问变量。有关 pgtypes 库函数的更多详细信息,请参见第 34.6 节。
没有专门为 decimal
类型提供的函数。应用程序必须使用 pgtypes 库函数将其转换为 numeric
变量以进行进一步处理。
这是一个处理 numeric
和 decimal
类型变量的示例程序。
#include <stdio.h> #include <stdlib.h> #include <pgtypes_numeric.h> EXEC SQL WHENEVER SQLERROR STOP; int main(void) { EXEC SQL BEGIN DECLARE SECTION; numeric *num; numeric *num2; decimal *dec; EXEC SQL END DECLARE SECTION; EXEC SQL CONNECT TO testdb; EXEC SQL SELECT pg_catalog.set_config('search_path', '', false); EXEC SQL COMMIT; num = PGTYPESnumeric_new(); dec = PGTYPESdecimal_new(); EXEC SQL SELECT 12.345::numeric(4,2), 23.456::decimal(4,2) INTO :num, :dec; printf("numeric = %s\n", PGTYPESnumeric_to_asc(num, 0)); printf("numeric = %s\n", PGTYPESnumeric_to_asc(num, 1)); printf("numeric = %s\n", PGTYPESnumeric_to_asc(num, 2)); /* Convert decimal to numeric to show a decimal value. */ num2 = PGTYPESnumeric_new(); PGTYPESnumeric_from_decimal(dec, num2); printf("decimal = %s\n", PGTYPESnumeric_to_asc(num2, 0)); printf("decimal = %s\n", PGTYPESnumeric_to_asc(num2, 1)); printf("decimal = %s\n", PGTYPESnumeric_to_asc(num2, 2)); PGTYPESnumeric_free(num2); PGTYPESdecimal_free(dec); PGTYPESnumeric_free(num); EXEC SQL COMMIT; EXEC SQL DISCONNECT ALL; return 0; }
对 bytea
类型的处理类似于 VARCHAR
的处理。类型为 bytea
的数组的定义会为每个变量转换为一个命名结构体。类似如下的声明
bytea var[180];
转换为
struct bytea_var { int len; char arr[180]; } var;
成员 arr
存储二进制格式的数据。它还可以处理 '\0'
作为数据的一部分,这与 VARCHAR
不同。数据会从/转换为十六进制格式,并由 ecpglib 发送/接收。
只有当 bytea_output 设置为 hex
时,才能使用 bytea
变量。
您还可以使用数组、typedefs、结构体和指针作为主机变量。
数组作为主机变量有两种用例。第一种是在 char[]
或 VARCHAR[]
中存储一些文本字符串,如第 34.4.4.1 节中所述。第二种用例是从查询结果中检索多行,而无需使用游标。如果没有数组,要处理由多行组成的查询结果,则需要使用游标和 FETCH
命令。但是,使用数组主机变量,可以一次接收多行。必须定义数组的长度以能够容纳所有行,否则很可能发生缓冲区溢出。
以下示例扫描 pg_database
系统表,并显示可用数据库的所有 OID 和名称
int main(void) { EXEC SQL BEGIN DECLARE SECTION; int dbid[8]; char dbname[8][16]; int i; EXEC SQL END DECLARE SECTION; memset(dbname, 0, sizeof(char)* 16 * 8); memset(dbid, 0, sizeof(int) * 8); EXEC SQL CONNECT TO testdb; EXEC SQL SELECT pg_catalog.set_config('search_path', '', false); EXEC SQL COMMIT; /* Retrieve multiple rows into arrays at once. */ EXEC SQL SELECT oid,datname INTO :dbid, :dbname FROM pg_database; for (i = 0; i < 8; i++) printf("oid=%d, dbname=%s\n", dbid[i], dbname[i]); EXEC SQL COMMIT; EXEC SQL DISCONNECT ALL; return 0; }
此示例显示以下结果。(确切的值取决于当地情况。)
oid=1, dbname=template1 oid=11510, dbname=template0 oid=11511, dbname=postgres oid=313780, dbname=testdb oid=0, dbname= oid=0, dbname= oid=0, dbname=
其成员名称与查询结果的列名称匹配的结构体可用于一次检索多列。该结构体使您可以在单个主机变量中处理多个列值。
以下示例从 pg_database
系统表和使用 pg_database_size()
函数检索可用数据库的 OID、名称和大小。在此示例中,使用一个结构体变量 dbinfo_t
,其成员的名称与 SELECT
结果中的每个列匹配,以检索一个结果行,而无需在 FETCH
语句中放入多个主机变量。
EXEC SQL BEGIN DECLARE SECTION; typedef struct { int oid; char datname[65]; long long int size; } dbinfo_t; dbinfo_t dbval; EXEC SQL END DECLARE SECTION; memset(&dbval, 0, sizeof(dbinfo_t)); EXEC SQL DECLARE cur1 CURSOR FOR SELECT oid, datname, pg_database_size(oid) AS size FROM pg_database; EXEC SQL OPEN cur1; /* when end of result set reached, break out of while loop */ EXEC SQL WHENEVER NOT FOUND DO BREAK; while (1) { /* Fetch multiple columns into one structure. */ EXEC SQL FETCH FROM cur1 INTO :dbval; /* Print members of the structure. */ printf("oid=%d, datname=%s, size=%lld\n", dbval.oid, dbval.datname, dbval.size); } EXEC SQL CLOSE cur1;
此示例显示以下结果。(确切的值取决于当地情况。)
oid=1, datname=template1, size=4324580 oid=11510, datname=template0, size=4243460 oid=11511, datname=postgres, size=4324580 oid=313780, datname=testdb, size=8183012
结构体主机变量会“吸收”与该结构体字段一样多的列。其他列可以分配给其他主机变量。例如,上面的程序也可以像这样重构,将 size
变量放在结构体之外
EXEC SQL BEGIN DECLARE SECTION; typedef struct { int oid; char datname[65]; } dbinfo_t; dbinfo_t dbval; long long int size; EXEC SQL END DECLARE SECTION; memset(&dbval, 0, sizeof(dbinfo_t)); EXEC SQL DECLARE cur1 CURSOR FOR SELECT oid, datname, pg_database_size(oid) AS size FROM pg_database; EXEC SQL OPEN cur1; /* when end of result set reached, break out of while loop */ EXEC SQL WHENEVER NOT FOUND DO BREAK; while (1) { /* Fetch multiple columns into one structure. */ EXEC SQL FETCH FROM cur1 INTO :dbval, :size; /* Print members of the structure. */ printf("oid=%d, datname=%s, size=%lld\n", dbval.oid, dbval.datname, size); } EXEC SQL CLOSE cur1;
使用 typedef
关键字将新类型映射到已存在的类型。
EXEC SQL BEGIN DECLARE SECTION; typedef char mychartype[40]; typedef long serial_t; EXEC SQL END DECLARE SECTION;
请注意,您也可以使用
EXEC SQL TYPE serial_t IS long;
此声明不需要是声明部分的一部分;也就是说,您也可以编写 typedefs 作为普通的 C 语句。
您声明为 typedef
的任何单词都不能在同一程序后面的 EXEC SQL
命令中用作 SQL 关键字。例如,这将不起作用
EXEC SQL BEGIN DECLARE SECTION; typedef int start; EXEC SQL END DECLARE SECTION; ... EXEC SQL START TRANSACTION;
ECPG 将为 START TRANSACTION
报告语法错误,因为它不再将 START
识别为 SQL 关键字,而仅识别为 typedef。(如果您有此类冲突,并且重命名 typedef 似乎不切实际,则可以使用动态 SQL编写 SQL 命令。)
在 v16 之前的 PostgreSQL 版本中,将 SQL 关键字用作 typedef 名称很可能会导致与 typedef 本身的使用相关的语法错误,而不是将该名称用作 SQL 关键字。当在具有新关键字的新 PostgreSQL 版本中重新编译现有的 ECPG 应用程序时,新行为不太可能导致问题。
本节包含有关如何在 ECPG 应用程序中处理非标量和用户定义的 SQL 级别数据类型的信息。请注意,这与上一节中描述的非原始类型的主机变量的处理方式不同。
ECPG 中不直接支持多维 SQL 级别数组。可以将一维 SQL 级别数组映射到 C 数组主机变量,反之亦然。但是,在创建语句时,ecpg 不知道列的类型,因此它无法检查是否将 C 数组输入到相应的 SQL 级别数组中。在处理 SQL 语句的输出时,ecpg 具有必要的信息,因此会检查两者是否都是数组。
如果查询单独访问数组的元素,则可以避免在 ECPG 中使用数组。然后,应使用具有可以映射到元素类型的类型的主机变量。例如,如果列类型是 integer
的数组,则可以使用 int
类型的主机变量。如果元素类型是 varchar
或 text
,则可以使用 char[]
或 VARCHAR[]
类型的主机变量。
这是一个示例。假设有以下表格
CREATE TABLE t3 ( ii integer[] ); testdb=> SELECT * FROM t3; ii ------------- {1,2,3,4,5} (1 row)
以下示例程序检索数组的第 4 个元素,并将其存储到 int
类型的主机变量中
EXEC SQL BEGIN DECLARE SECTION; int ii; EXEC SQL END DECLARE SECTION; EXEC SQL DECLARE cur1 CURSOR FOR SELECT ii[4] FROM t3; EXEC SQL OPEN cur1; EXEC SQL WHENEVER NOT FOUND DO BREAK; while (1) { EXEC SQL FETCH FROM cur1 INTO :ii ; printf("ii=%d\n", ii); } EXEC SQL CLOSE cur1;
此示例显示以下结果
ii=4
要将多个数组元素映射到数组类型主机变量中的多个元素,必须分别管理数组列的每个元素和主机变量数组的每个元素,例如
EXEC SQL BEGIN DECLARE SECTION; int ii_a[8]; EXEC SQL END DECLARE SECTION; EXEC SQL DECLARE cur1 CURSOR FOR SELECT ii[1], ii[2], ii[3], ii[4] FROM t3; EXEC SQL OPEN cur1; EXEC SQL WHENEVER NOT FOUND DO BREAK; while (1) { EXEC SQL FETCH FROM cur1 INTO :ii_a[0], :ii_a[1], :ii_a[2], :ii_a[3]; ... }
再次注意
EXEC SQL BEGIN DECLARE SECTION; int ii_a[8]; EXEC SQL END DECLARE SECTION; EXEC SQL DECLARE cur1 CURSOR FOR SELECT ii FROM t3; EXEC SQL OPEN cur1; EXEC SQL WHENEVER NOT FOUND DO BREAK; while (1) { /* WRONG */ EXEC SQL FETCH FROM cur1 INTO :ii_a; ... }
在这种情况下无法正常工作,因为您不能将数组类型列直接映射到数组主机变量。
另一种解决方法是将数组以其外部字符串表示形式存储在 char[]
或 VARCHAR[]
类型的主机变量中。有关此表示形式的更多详细信息,请参见第 8.15.2 节。请注意,这意味着无法在主机程序中自然地将数组作为数组访问(无需进一步处理来解析文本表示形式)。
ECPG 中不直接支持复合类型,但可以使用一种简单的解决方法。可用的解决方法类似于上面针对数组描述的解决方法:要么分别访问每个属性,要么使用外部字符串表示形式。
对于以下示例,假设有以下类型和表
CREATE TYPE comp_t AS (intval integer, textval varchar(32)); CREATE TABLE t4 (compval comp_t); INSERT INTO t4 VALUES ( (256, 'PostgreSQL') );
最明显的解决方案是分别访问每个属性。以下程序通过分别选择 comp_t
类型的每个属性来从示例表中检索数据
EXEC SQL BEGIN DECLARE SECTION; int intval; varchar textval[33]; EXEC SQL END DECLARE SECTION; /* Put each element of the composite type column in the SELECT list. */ EXEC SQL DECLARE cur1 CURSOR FOR SELECT (compval).intval, (compval).textval FROM t4; EXEC SQL OPEN cur1; EXEC SQL WHENEVER NOT FOUND DO BREAK; while (1) { /* Fetch each element of the composite type column into host variables. */ EXEC SQL FETCH FROM cur1 INTO :intval, :textval; printf("intval=%d, textval=%s\n", intval, textval.arr); } EXEC SQL CLOSE cur1;
为了增强此示例,可以将存储 FETCH
命令值的宿主变量收集到一个结构中。有关结构形式的宿主变量的更多详细信息,请参阅第 34.4.4.3.2 节。要切换到结构,可以如下修改该示例。两个宿主变量 intval
和 textval
成为 comp_t
结构的成员,并在 FETCH
命令中指定该结构。
EXEC SQL BEGIN DECLARE SECTION; typedef struct { int intval; varchar textval[33]; } comp_t; comp_t compval; EXEC SQL END DECLARE SECTION; /* Put each element of the composite type column in the SELECT list. */ EXEC SQL DECLARE cur1 CURSOR FOR SELECT (compval).intval, (compval).textval FROM t4; EXEC SQL OPEN cur1; EXEC SQL WHENEVER NOT FOUND DO BREAK; while (1) { /* Put all values in the SELECT list into one structure. */ EXEC SQL FETCH FROM cur1 INTO :compval; printf("intval=%d, textval=%s\n", compval.intval, compval.textval.arr); } EXEC SQL CLOSE cur1;
尽管在 FETCH
命令中使用了结构,但 SELECT
子句中的属性名称仍然逐个指定。可以通过使用 *
来请求复合类型值的所有属性来增强这一点。
... EXEC SQL DECLARE cur1 CURSOR FOR SELECT (compval).* FROM t4; EXEC SQL OPEN cur1; EXEC SQL WHENEVER NOT FOUND DO BREAK; while (1) { /* Put all values in the SELECT list into one structure. */ EXEC SQL FETCH FROM cur1 INTO :compval; printf("intval=%d, textval=%s\n", compval.intval, compval.textval.arr); } ...
这样,复合类型几乎可以无缝地映射到结构中,即使 ECPG 本身不理解复合类型。
最后,也可以将复合类型值以其外部字符串表示形式存储在类型为 char[]
或 VARCHAR[]
的宿主变量中。但是那样,从宿主程序中访问该值的字段就不容易了。
ECPG 不直接支持新的用户定义的基类型。您可以使用外部字符串表示形式和类型为 char[]
或 VARCHAR[]
的宿主变量,对于许多类型来说,这种解决方案确实是合适的并且足够了。
这是一个使用第 36.13 节中示例中的 complex
数据类型的示例。该类型的外部字符串表示形式是 (%f,%f)
,它在 第 36.13 节中的函数 complex_in()
和 complex_out()
函数中定义。以下示例将复合类型值 (1,1)
和 (3,3)
插入到列 a
和 b
中,然后从表中选择它们。
EXEC SQL BEGIN DECLARE SECTION; varchar a[64]; varchar b[64]; EXEC SQL END DECLARE SECTION; EXEC SQL INSERT INTO test_complex VALUES ('(1,1)', '(3,3)'); EXEC SQL DECLARE cur1 CURSOR FOR SELECT a, b FROM test_complex; EXEC SQL OPEN cur1; EXEC SQL WHENEVER NOT FOUND DO BREAK; while (1) { EXEC SQL FETCH FROM cur1 INTO :a, :b; printf("a=%s, b=%s\n", a.arr, b.arr); } EXEC SQL CLOSE cur1;
此示例显示以下结果
a=(1,1), b=(3,3)
另一种解决方法是避免在 ECPG 中直接使用用户定义的类型,而是创建一个函数或转换,在用户定义的类型和 ECPG 可以处理的原始类型之间进行转换。但是请注意,类型转换,尤其是隐式转换,应非常谨慎地引入类型系统。
例如,
CREATE FUNCTION create_complex(r double, i double) RETURNS complex LANGUAGE SQL IMMUTABLE AS $$ SELECT $1 * complex '(1,0')' + $2 * complex '(0,1)' $$;
在此定义之后,以下代码
EXEC SQL BEGIN DECLARE SECTION; double a, b, c, d; EXEC SQL END DECLARE SECTION; a = 1; b = 2; c = 3; d = 4; EXEC SQL INSERT INTO test_complex VALUES (create_complex(:a, :b), create_complex(:c, :d));
具有与以下代码相同的效果
EXEC SQL INSERT INTO test_complex VALUES ('(1,2)', '(3,4)');
上面的示例不处理空值。实际上,如果检索示例从数据库中获取一个空值,则会引发错误。为了能够将空值传递给数据库或从数据库中检索空值,您需要向每个包含数据的宿主变量追加第二个宿主变量规范。第二个宿主变量称为指示器,其中包含一个标志,该标志指示数据是否为空值,在这种情况下,将忽略实际宿主变量的值。这是一个正确处理空值检索的示例
EXEC SQL BEGIN DECLARE SECTION; VARCHAR val; int val_ind; EXEC SQL END DECLARE SECTION: ... EXEC SQL SELECT b INTO :val :val_ind FROM test1;
如果该值不为空,则指示器变量 val_ind
将为零;如果该值为空,则为负值。(请参阅第 34.16 节以启用 Oracle 特定的行为。)
指示器还有另一个功能:如果指示器值为正数,则表示该值不为空,但在将其存储在宿主变量中时被截断了。
如果将参数 -r no_indicator
传递给预处理器 ecpg
,它将在“无指示器”模式下工作。在无指示器模式下,如果没有指定指示器变量,则对于字符字符串类型,空值将作为空字符串发出信号,对于整数类型,空值将作为该类型的最低可能值发出信号(例如,int
的 INT_MIN
)。
如果您在文档中发现任何不正确,与您使用特定功能的经验不符或需要进一步澄清的内容,请使用此表单报告文档问题。