Freigeben über

Pull-Methode (RDA)

Downloadet Daten aus einer Microsoft SQL Server-Remotedatenbank und speichert diese Daten in einer einzelnen Tabelle einer lokalen Datenbank von Microsoft SQL Server 2005 Compact Edition (SQL Server Compact Edition).

Vor dem Aufrufen der Pull-Methode müssen folgende RDA-Objekteigenschaften festgelegt werden:

  • Die InternetURL-Eigenschaft muss den URL des Server-Agents für SQL Server Compact Edition enthalten.
  • Die LocalConnectionString-Eigenschaft muss die OLE DB-Verbindungszeichenfolge für die SQL Server Compact Edition-Datenbank auf dem Gerät enthalten.
  • Die Eigenschaften InternetLogin und InternetPassword müssen angegeben sein, wenn die Konfiguration des Server-Agents für SQL Server Compact Edition die Verwendung der Standardauthentifizierung oder der integrierten Authentifizierung vorsieht.

Syntax

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

Parameter

  • LocalTableName
    Der Name der SQL Server Compact Edition-Tabelle, die die extrahierten SQL Server-Datensätze empfängt. Wenn die Tabelle bereits vorhanden ist, tritt ein Fehler auf.
  • SQLSelectString
    Eine Zeichenfolge, die angibt, welche Tabelle, Spalten und Datensätze aus der SQL Server-Datenbank extrahiert und in der SQL Server Compact Edition-Datenbank gespeichert werden sollen. Diese Zeichenfolge kann jeder beliebigen gültigen SQL-Anweisung entsprechen, die Zeilen zurückgibt, einschließlich SELECT-Anweisungen oder gespeicherter Prozeduren.
  • RDA_TRACKOPTION
    Die RDA_TRACKOPTION-Enumeration zeigt an, ob Änderungen an der Tabelle, für die ein Pull-Vorgang ausgeführt wird, nachverfolgt werden sollen. Wenn Indizes angefordert werden, werden in der Tabelle, für die ein Pull-Vorgang ausgeführt wird, vorhandene Indizes zu dem Gerät mit den PRIMARY KEY-Einschränkungen übertragen. Weitere Informationen finden Sie unter RDA_TRACKOPTION.
  • ErrorTableName
    Der Name der lokalen Fehlertabelle, die erstellt wird, falls beim späteren Aufrufen der Push-Methode zum Zurücksenden der Änderungen an SQL Server ein Fehler auftritt. Diese Option kann nur angegeben werden, wenn RDA_TRACKOPTION auf TRACKINGON festgelegt ist.

Betrifft

RemoteDataAccess-Objekt von SQL Server Compact Edition

Hinweise

SQLSelectString

Der SQLSelectString-Parameter steuert, für welche Daten aus der SQL Server-Tabelle ein Pull-Vorgang ausgeführt wird. Beachten Sie folgende Punkte, wenn Sie den SQLSelectString-Parameter verwenden:

  • Der SQLSelectString-Parameter kann eine WHERE-Klausel enthalten, um zu steuern, welche Datensätze zurückgegeben werden. Beispielsweise ruft SELECT * FROM Address WHERE PostalCode='93868' nur Adressen für die angegebene Postleitzahl ab.
  • SQLSelectString unterstützt gespeicherte Prozeduren und Sichten, die Zeilen zurückgeben.
  • SQLSelectString kann einen Pull-Vorgang für ausgewählte Spalten aus mehreren Tabellen in eine einzige Tabelle ausführen, allerdings nur, wenn der RDA_TRACKOPTION-Parameter auf TRACKINGOFF festgelegt ist.
  • Ein Fehler tritt auf, wenn das resultierende Recordset einen nicht unterstützten Datentyp enthält, z. B. timestamp.

ErrorTableName

Der ErrorTableName-Parameter gibt den Namen der Tabelle an, in der während eines Push-Vorgangs auftretende Fehler gespeichert werden. Falls ein Fehler auftritt, wenn die Anwendung die Push-Methode aufruft, erstellt SQL Server Compact Edition die Fehlertabelle und fügt der Tabelle einen Datensatz für jeden auftretenden Fehler hinzu. Wenn die Push-Methode beendet ist, kann die Anwendung die Fehlertabelle untersuchen, um festzustellen, ob Fehler aufgetreten sind. ErrorTableName kann nur angegeben werden, wenn TRACKINGON oder TRACKINGONWITHINDEXES angegeben ist. Weitere Informationen zur Funktionsweise der Fehlertabelle finden Sie unter Konflikterkennung und -berichterstellung für RDA.

Siehe auch

Referenz

RDA-Objektmethoden
Push-Methode (RDA)

Hilfe und Information

Informationsquellen für SQL Server Compact Edition

  • Last updated on