Partager via

Méthode Pull (RDA)

Télécharge des données à partir d'une base de données Microsoft SQL Server distante et les stocke dans une table unique dans une base de données Microsoft SQL Server 2005 Compact Edition (SQL Server Compact Edition) locale.

Avant d'appeler la méthode Pull, vous devez définir les propriétés de l'objet RDA suivantes :

  • La propriété InternetURL doit contenir l'URL de l'Agent serveur SQL Server Compact Edition.
  • La propriété LocalConnectionString doit contenir la chaîne de connexion OLE DB de la base de données SQL Server Compact Edition stockée sur l'appareil.
  • Les propriétés InternetLogin et InternetPassword doivent être spécifiées si l'Agent serveur SQL Server Compact Edition est configuré de manière à utiliser l'authentification de base ou intégrée.

Syntaxe

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

Paramètres

  • LocalTableName
    Nom de la table SQL Server Compact Edition qui reçoit les enregistrements SQL Server extraits. Une erreur se produit si la table existe déjà.
  • SQLSelectString
    Chaîne qui spécifie la table, les colonnes et les enregistrements à extraire de la base de données SQL Server et à stocker dans la base de données SQL Server Compact Edition. Cette chaîne peut être toute instruction SQL valide qui renvoie des lignes, notamment une procédure stockée ou une instruction SELECT.
  • RDA_TRACKOPTION
    L'énumération RDA_TRACKOPTION indique si un suivi doit être effectué pour les modifications apportées à la table dont les données sont extraites. Lorsque des index sont demandés, ceux qui existent sur la table dont les données sont extraites sont transférés vers l'appareil avec les contraintes PRIMARY KEY. Pour plus d'informations, consultez RDA_TRACKOPTION.
  • ErrorTableName
    Nom de la table d'erreurs locale qui est créée si une erreur se produit lorsque la méthode Push est ultérieurement appelée pour renvoyer les modifications à SQL Server. Cette option ne peut être spécifiée que lorsque RDA_TRACKOPTION a pour valeur TRACKINGON.

Application

Objet RemoteDataAccess de SQL Server Compact Edition

Notes

SQLSelectString

Le paramètre SQLSelectString détermine les données à extraire (pull) de la table SQL Server. Tenez compte des éléments suivants lorsque vous utilisez le paramètre SQLSelectString :

  • Le paramètre SQLSelectString peut spécifier une clause WHERE pour déterminer les enregistrements à retourner. Par exemple, l'instruction SELECT * FROM Address WHERE PostalCode='93868' extrait les adresses correspondant uniquement au code postal spécifié.
  • Le paramètre SQLSelectString prend en charge les procédures stockées et les vues qui renvoient des lignes.
  • Le paramètre SQLSelectString peut extraire (pull) des colonnes spécifiques de plusieurs tables et les intégrer dans une même table, à condition que le paramètre RDA_TRACKOPTION ait pour valeur TRACKINGOFF.
  • Une erreur se produit si le jeu d'enregistrements obtenu contient un type de données non pris en charge, tel que timestamp.

ErrorTableName

Le paramètre ErrorTableName spécifie le nom de la table dans laquelle sont stockées les erreurs qui se produisent pendant un envoi de données (push). Si une erreur se produit lorsque l'application appelle la méthode Push, SQL Server Compact Edition crée la table d'erreurs et y ajoute un enregistrement chaque fois qu'une erreur survient. Lorsque la méthode Push prend fin, l'application peut examiner la table d'erreurs pour déterminer si des erreurs se sont produites. Le paramètre ErrorTableName ne peut être défini que lorsque la valeur TRACKINGON ou TRACKINGONWITHINDEXES est spécifiée. Pour plus d'informations sur le fonctionnement de la table d'erreurs, consultez Détection et signalement des conflits RDA.

Voir aussi

Référence

Méthodes de l'objet RDA
Méthode Push (RDA)

Aide et information

Assistance sur SQL Server Compact Edition

  • Last updated on