从远程 Microsoft SQL Server 数据库下载数据,并将该数据存储在位于本地 Microsoft SQL Server Compact 3.5 数据库内的单个表中。
在调用 Pull 方法前,必须设置下列 RDA 对象属性:
InternetURL 属性必须包含 SQL Server Compact 3.5 服务器代理的 URL。
LocalConnectionString 属性必须包含设备上 SQL Server Compact 3.5 数据库的 OLE DB 连接字符串。
如果 SQL Server Compact 3.5 服务器代理配置为使用基本身份验证或集成身份验证,则必须指定 InternetLogin 和 InternetPassword 属性。
语法
object.Pull (localTableName, sqlSelectString, oledbConnectionString, RDA_TRACKOPTION, ErrorTableName)
适用范围
SQL Server Compact 3.5 RemoteDataAccess 对象
参数
LocalTableName
接收被提取 SQL Server 记录的 SQL Server Compact 3.5 表的名称。如果该表已存在,将出现错误。SQLSelectString
一个字符串,指定要从 SQL Server 数据库中提取并存储到 SQL Server Compact 3.5 数据库中的表、列和记录。该字符串可以是返回行的任意有效 SQL 语句,包括 SELECT 语句或存储过程。OLEDBConnectionString
连接到 SQL Server 数据库时使用的 OLE DB 连接字符串。RDA_TRACKOPTION
RDA_TRACKOPTION 枚举指示是否跟踪对所请求表进行的更改。当请求索引时,正在请求的表上的索引将被传递到具有 PRIMARY KEY 约束的设备。有关详细信息,请参阅 RDA_TRACKOPTION。ErrorTableName
本地错误表的名称。在以后调用 Push 方法将更改发送回 SQL Server 时,如果出现错误则会创建该表。只有在 RDA_TRACKOPTION 设置为 TRACKINGON 时,才可以指定该选项。
注释
SQLSelectString
SQLSelectString 参数控制从 SQL Server 表中请求哪些数据。在使用 SQLSelectString 参数时,请考虑以下问题:
SQLSelectString 参数可以指定 WHERE 子句来控制返回哪些记录。例如,SELECT * FROM Address WHERE PostalCode='93868' 只检索指定邮政编码的地址。
SQLSelectString 支持返回行的存储过程和视图。
SQLSelectString 可以将所选列从多个表中请求到一个表中,但前提是 RDA_TRACKOPTION 参数设置为 TRACKINGOFF。
如果结果记录集包含不支持的数据类型(例如 timestamp),将出现错误。
ErrorTableName
ErrorTableName 参数指定将要存储错误的表名称,这些错误是在推送期间遇到的。如果在应用程序调用 Push 方法时出现错误,SQL Server Compact 3.5 将创建错误表并向表中添加发生的每个错误的记录。在 Push 方法完成后,应用程序可以检查错误表来确定是否已出现错误。只有在指定 TRACKINGON 或 TRACKINGONWITHINDEXES时,才可以指定 ErrorTableName。有关错误表工作方式的详细信息,请参阅RDA 冲突检测和报告。