Método Pull (RDA)

Descarga los datos de una base de datos remota de Microsoft SQL Server y los almacena en una tabla única en una base de datos local de Microsoft SQL Server 2005 Compact Edition (SQL Server Compact Edition).

Antes de llamar al método Pull, se deben establecer las siguientes propiedades del objeto RDA:

• La propiedad InternetURL debe incluir la dirección URL del Agente de servidor de SQL Server Compact Edition.
• La propiedad LocalConnectionString debe incluir la cadena de conexión de OLE DB para la base de datos de SQL Server Compact Edition del dispositivo.
• Deben especificarse las propiedades InternetLogin e InternetPassword si el Agente de servidor de SQL Server Compact Edition está configurado para usar la autenticación básica o integrada.

Sintaxis

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

Parámetros

• LocalTableName
  Nombre de la tabla de SQL Server Compact Edition que recibe los registros extraídos de SQL Server. Se produce un error si la tabla ya existe.

• SQLSelectString
  Cadena que identifica qué tablas, columnas y registros van a extraerse de la base de datos de SQL Server y almacenarse en la base de datos de SQL Server Compact Edition. Esta cadena puede ser cualquier instrucción SQL válida que devuelva filas, incluido SELECT y los procedimientos almacenados.

• OLEDBConnectionString
  Cadena de conexión de OLE DB que se usa al conectarse a la base de datos de SQL Server. Para obtener más información, vea Programación de acceso a datos remotos de SQL Server Compact Edition.

• RDA_TRACKOPTION
  La enumeración RDA_TRACKOPTION indica si se realiza el seguimiento de los cambios efectuados en la tabla extraída. Si se solicitan índices, los que existen en la tabla que se extrae se envían al dispositivo con las restricciones PRIMARY KEY. Para obtener más información, vea RDA_TRACKOPTION.

• ErrorTableName
  Nombre de la tabla de errores local que se crea si se produce un error al llamar al método Push posteriormente para devolver los cambios a SQL Server. Sólo puede especificarse esta opción si RDA_TRACKOPTION se ha establecido en TRACKINGON.

Se aplica a

Objeto RemoteDataAccess de SQL Server Compact Edition

Notas

SQLSelectString

El parámetro SQLSelectString controla qué datos se extraen de la tabla de SQL Server. Tenga en cuenta lo siguiente al usar el parámetro SQLSelectString:

• El parámetro SQLSelectString puede especificar una cláusula WHERE para controlar qué registros se devuelven. Por ejemplo, SELECT * FROM Address WHERE PostalCode='93868' recupera las direcciones sólo con el código postal especificado.
• SQLSelectString admite procedimientos almacenados y vistas que devuelven filas.
• SQLSelectString puede extraer las columnas seleccionadas de varias tablas a una sola tabla, pero sólo si el parámetro RDA_TRACKOPTION está establecido en TRACKINGOFF.
• Se produce un error si el conjunto de resultados resultante contiene un tipo de datos no admitido, como timestamp.

ErrorTableName

El parámetro ErrorTableName especifica el nombre de la tabla en la que se almacenarán los errores que se hayan producido durante una inserción. Si se produce un error cuando la aplicación llama al método Push, SQL Server Compact Edition crea la tabla de errores y agrega un registro a la tabla por cada error que se produzca. Cuando finaliza el método Push, la aplicación puede examinar la tabla de errores para determinar si se ha producido alguno. Sólo se puede especificar ErrorTableName si se ha establecido TRACKINGON o TRACKINGONWITHINDEXES. Para obtener más información acerca del funcionamiento de la tabla de errores, vea Detección e informe de conflictos de RDA.

Vea también

Referencia

Métodos del objeto RDA
Método Push (RDA)

Ayuda e información

Obtener ayuda sobre SQL Server Compact Edition