Метод Pull (удаленный доступ к данным)
Загрузка данных из удаленной БД Microsoft SQL Server и сохранение их в одной таблице в локальной базе данных Microsoft SQL Server 2005 Compact Edition (SQL Server Compact Edition).
Перед вызовом метода Pull необходимо задать следующие свойства объекта удаленного доступа к данным.
- В свойстве InternetURL должен быть указан URL-адрес агента сервера SQL Server Compact Edition.
- Свойство LocalConnectionString должно содержать строку соединения OLE DB для базы данных SQL Server Compact Edition на устройстве.
- Свойства InternetLogin и InternetPassword задаются, если агент сервера SQL Server Compact Edition настроен на использование базовой или встроенной проверки подлинности.
Синтаксис
object.Pull (localTableName, sqlSelectString, oledbConnectionString, RDA_TRACKOPTION, ErrorTableName)
Параметры
- LocalTableName
Имя таблицы SQL Server Compact Edition, в которой сохраняются извлеченные записи SQL Server. Если таблица уже существует, возникает ошибка.
- SQLSelectString
Строка с указанием таблицы, столбцов и записей, которые следует извлечь из базы данных SQL Server и сохранить в базе данных SQL Server Compact Edition. Это может быть любая допустимая инструкция SQL, которая возвращает строки, в том числе инструкции SELECT или хранимые процедуры.
- OLEDBConnectionString
Строка соединения OLE DB, используемая при установлении соединения с SQL Server. Дополнительные сведения см. в разделе Программирование удаленного доступа к данным в SQL Server Compact Edition.
- RDA_TRACKOPTION
Перечисление RDA_TRACKOPTION служит для указания, следует ли выполнять трассировку изменений в запрошенной таблице. При запросе индексов имеющиеся в запрашиваемой таблице индексы загружаются на устройство с ограничениями по первичному ключу. Дополнительные сведения см. в разделе RDA_TRACKOPTION.
- ErrorTableName
Имя локальной таблицы ошибок, которая создается, если при следующем вызове метода Push для отправки изменений обратно в SQL Server возникает ошибка. Этот параметр указывается, только если для RDA_TRACKOPTION задано значение TRACKINGON.
Объект применения
Объект удаленного доступа к данным SQL Server Compact Edition
Замечания
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 Edition создает таблицу ошибок и добавляет в нее отдельную запись на каждую возникающую ошибку. По завершении метода Push по данным таблицы ошибок приложение может определить наличие ошибок. ErrorTableName указывается, только если задан параметр TRACKINGON или TRACKINGONWITHINDEXES . Дополнительные сведения о функциях таблицы ошибок см. в разделе Обнаружение конфликтов при удаленном доступе к данным и оповещение о конфликтах.
См. также
Справочник
Методы объекта удаленного доступа к данным
Метод Push (удаленный доступ к данным)