SQL:自定义记录集的 SQL 语句 (ODBC)

更新:2007 年 11 月

本主题阐释:

  • 框架如何构造 SQL 语句

  • 如何重写 SQL 语句

说明:

此信息适用于 MFC ODBC 类。如果使用的是 MFC DAO 类,请参见 DAO 帮助中的“Microsoft Jet 数据库引擎 SQL 和 ANSI SQL 比较”主题。

SQL 语句结构

记录集将记录选择主要建立在 SQL SELECT 语句的基础上。当用向导声明类时,向导编写 GetDefaultSQL 成员函数的重写版本,类似于下面的语句(用于一个称为 CAuthors 的记录集):

CString CAuthors::GetDefaultSQL()
{
    return "AUTHORS";
}

默认情况下,该重写返回用向导指定的表名。此示例中,表名是“AUTHORS”。以后调用记录集的 Open 成员函数时,Open 构造的最终 SELECT 语句的形式如下:

SELECT rfx-field-list FROM table-name [WHERE m_strFilter] 
       [ORDER BY m_strSort]

在此语句中,通过调用 GetDefaultSQL 获取 table-name,从 DoFieldExchange 中的 RFX 函数调用获取 rfx-field-list。虽然也可以用参数或筛选器修改默认语句,但这就是为 SELECT 语句所获取的内容,除非在运行时用重写版本替换它。

说明:

如果指定的列名包含(或可能包含)空格,则必须将名称括在方括号内。例如,名称“First Name”应为“[First Name]”。

若要重写默认 SELECT 语句,请在调用 Open 时传递包含完整 SELECT 语句的字符串。记录集并不构造它自己的默认字符串,而是使用您提供的字符串。如果替换语句包含 WHERE 子句,则不要在 m_strFilter 中指定筛选器,因为如果指定,则将有两个筛选语句。同样,如果替换语句包含 ORDER BY 子句,则不要在 m_strSort 中指定排序,这样才不会有两个排序语句。

说明:

如果在筛选器(或 SQL 语句的其他部分)中使用字符串,则必须用 DBMS 特定的文本前缀和文本后缀字符(或多个字符)“括住”(包含在指定的分隔符之间)这些字符串。

根据所使用的 DBMS,对外部联接这样的操作可能还有特殊的语法要求。使用 ODBC 函数从用于 DBMS 的驱动程序中获取该信息。例如,为某一数据类型(如 SQL_VARCHAR)调用 ::SQLGetTypeInfo 来请求 LITERAL_PREFIXLITERAL_SUFFIX 字符。如果正在写与数据库无关的代码,请参见 MSDN Library 光盘上 ODBC SDK Programmer's Reference(ODBC SDK 程序员参考)中的附录 C 以了解详细的语法信息。

记录集对象构造用于选择记录的 SQL 语句,除非您传递自定义 SQL 语句。该操作的完成方式主要取决于您在 Open 成员函数的 lpszSQL 参数中传递的值。

SQL SELECT 语句的一般形式为:

SELECT [ALL | DISTINCT] column-list FROM table-list
    [WHERE search-condition][ORDER BY column-list [ASC | DESC]]

DISTINCT 关键字添加到记录集的 SQL 语句的一种方法是将关键字嵌入 DoFieldExchange 的第一个 RFX 函数调用中。例如:

...
    RFX_Text(pFX, "DISTINCT CourseID", m_strCourseID);
...
说明:

只对以只读形式打开的记录集使用该方法。

重写 SQL 语句

下表对要 Open(打开)的 lpszSQL 参数的几种可能情形进行了说明。表后对表中的情况做了解释。

lpszSQL 参数和结果 SQL 字符串

情况

在 lpszSQL 中传递的内容

结果 SELECT 语句

1

NULL

SELECTrfx-field-listFROMtable-name

CRecordset::Open 调用 GetDefaultSQL 以获取表名。结果字符串是情况 2 到情况 5 中的一种,具体取决于 GetDefaultSQL 的返回内容。

2

表名

SELECTrfx-field-listFROMtable-name

字段列表取自 DoFieldExchange 中的 RFX 语句。如果 m_strFilterm_strSort 不为空,则添加 WHERE 和/或 ORDER BY 子句。

3 *

完整的 SELECT 语句,但没有 WHEREORDER BY 子句

如所传递的内容。如果 m_strFilterm_strSort 不为空,则添加 WHERE 和/或 ORDER BY 子句。

4 *

完整的 SELECT 语句,具有 WHERE 和/或 ORDER BY 子句

如所传递的语句。m_strFilter 和/或 m_strSort 必须保持为空,否则将产生两个筛选器和/或排序语句。

5 *

对存储过程的调用

如所传递的内容。

* m_nFields 必须少于或等于 SELECT 语句中指定的列数。在 SELECT 语句中指定的每列的数据类型必须与相应的 RFX 输出列的数据类型相同。

情况 1   lpszSQL = NULL

记录集选择取决于当 CRecordset::Open 调用 GetDefaultSQL 时,GetDefaultSQL 所返回的内容。情况 2 到情况 5 描述了可能的字符串。

情况 2   lpszSQL = 表名

记录集使用记录字段交换 (RFX) 从列名生成列列表,列名是在记录集类的 DoFieldExchange 重写中的 RFX 函数调用中提供的。如果使用了向导来声明记录集类,则该情况的结果与情况 1 相同(前提是传递的表名与在向导中指定的相同)。如果不使用向导来编写类,则情况 2 是构造 SQL 语句的最简单方法。

下面的示例构造一个 SQL 语句,该语句从 MFC 数据库应用程序选择记录。当框架调用 GetDefaultSQL 成员函数时,函数返回表名 SECTION。

CString CEnrollSet::GetDefaultSQL()
{
    return "SECTION";
}

为获取 SQL SELECT 语句的列名,框架调用 DoFieldExchange 成员函数。

void CEnrollSet::DoFieldExchange(CFieldExchange* pFX)
{
    pFX->SetFieldType(CFieldExchange::outputColumn);
    RFX_Text(pFX, "CourseID", m_strCourseID);
    RFX_Text(pFX, "InstructorID", m_strInstructorID);
    RFX_Text(pFX, "RoomNo", m_strRoomNo);
    RFX_Text(pFX, "Schedule", m_strSchedule);
    RFX_Text(pFX, "SectionNo", m_strSectionNo);
}

完成后,SQL 语句类似于:

SELECT CourseID, InstructorID, RoomNo, Schedule, SectionNo 
    FROM SECTION

情况 3   lpszSQL = SELECT/FROM 语句

手动指定列列表,而不是依赖 RFX 自动构造该列表。可能要在以下时间执行该操作:

  • 想在 SELECT 后指定 DISTINCT 关键字。

    列列表应按列名和类型在 DoFieldExchange 中列出的同一顺序来匹配列名和类型。

  • 有理由使用 ODBC 函数 ::SQLGetData 手动检索列值,而不是依赖 RFX 为您绑定和检索列。

    例如,您可能想要为新列提供空间,而这些新列是分发应用程序后您的应用程序客户添加到数据库表的。您需要添加这些额外的字段数据成员,它们在使用向导声明类时是未知的。

    列列表应按列名和类型在 DoFieldExchange 中列出的顺序来匹配列名和类型,后接手动绑定的列的名称。有关更多信息,请参见记录集:动态绑定数据列 (ODBC)

  • 希望通过在 FROM 子句中指定多个表来联接表。

    有关信息及示例,请参见 记录集:执行联接 (ODBC)

情况 4   lpszSQL = SELECT/FROM 加 WHERE 和/或 ORDER BY

指定全部内容:列列表(基于 DoFieldExchange 中的 RFX 调用)、表列表以及 WHERE 和/或 ORDER BY 子句的内容。如果用这种方法指定 WHERE 和/或 ORDER BY 子句,则不使用 m_strFilter 和/或 m_strSort

情况 5   lpszSQL = 存储过程调用

如果需要调用预定义查询(如 Microsoft SQL Server 数据库中的存储过程),必须在传递到 lpszSQL 的字符串中写 CALL 语句。向导不支持为调用预定义查询声明记录集类。并非所有的预定义查询都返回记录。

如果预定义查询不返回记录,则可以直接使用 CDatabase 成员函数 ExecuteSQL。对于确实返回记录的预定义查询,还必须在 DoFieldExchange 中为过程返回的任何列手动写 RFX 调用。RFX 调用的顺序和返回的类型都必须与预定义查询相同。有关更多信息,请参见 记录集:为预定义查询声明一个类 (ODBC)

请参见

概念

SQL:SQL 和 C++ 数据类型 (ODBC)

SQL:进行直接 SQL 调用 (ODBC)