Метод Pull (удаленный доступ к данным)

Загрузка данных из удаленной БД MicrosoftSQL Server и сохранение их в одной таблице в локальной базе данных MicrosoftSQL Server Compact 3.5.

Перед вызовом метода Pull необходимо задать следующие свойства объекта удаленного доступа к данным.

  • В свойстве InternetURL должен быть указан URL-адрес агента сервера SQL Server Compact 3.5.

  • Свойство LocalConnectionString должно содержать строку соединения OLE DB для базы данных SQL Server Compact 3.5 на устройстве.

  • Свойства InternetLogin и InternetPassword задаются, если агент сервера SQL Server Compact 3.5 настроен на использование базовой или встроенной проверки подлинности.

Синтаксис

object.Pull (localTableName, sqlSelectString, oledbConnectionString,  RDA_TRACKOPTION, ErrorTableName)

Объект применения

Объект удаленного доступа к данным SQL Server Compact 3.5

Параметры

  • LocalTableName
    Имя таблицы SQL Server Compact 3.5, в которой сохраняются извлеченные записи SQL Server. Если таблица уже существует, возникает ошибка.

  • SQLSelectString
    Строка с указанием таблицы, столбцов и записей, которые следует извлечь из базы данных SQL Server и сохранить в базе данных SQL Server Compact 3.5. Это может быть любая допустимая инструкция SQL, которая возвращает строки, в том числе инструкции SELECT или хранимые процедуры.

  • OLEDBConnectionString
    Строка соединения OLE DB, используемая при установлении соединения с SQL Server.

  • RDA_TRACKOPTION
    Перечисление RDA_TRACKOPTION служит для указания, следует ли выполнять трассировку изменений в запрошенной таблице. При запросе индексов имеющиеся в запрашиваемой таблице индексы загружаются на устройство с ограничениями по первичному ключу. Дополнительные сведения см. в разделе 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 по данным таблицы ошибок приложение может определить наличие ошибок. ErrorTableName указывается, только если задан параметр TRACKINGON или TRACKINGONWITHINDEXES. Дополнительные сведения о функциях таблицы ошибок см. в разделе Обнаружение конфликтов при удаленном доступе к данным и оповещение о конфликтах.

См. также

Другие ресурсы

Методы объекта удаленного доступа к данным

Метод Push (удаленный доступ к данным)