Método Pull (RDA)
Baixa dados de um banco de dados do Microsoft SQL Server remoto e armazena-os em uma única tabela em um banco de dados do Microsoft SQL Server Compact 3.5 local.
Antes de chamar o método Pull, você deve definir as propriedades do objeto RDA a seguir:
A propriedade InternetURL deve conter a URL do Agente de Servidor do SQL Server Compact 3.5.
A propriedade LocalConnectionString deve conter a cadeia de caracteres da conexão do banco de dados OLE do SQL Server Compact 3.5 no dispositivo.
As propriedades InternetLogin e InternetPassword devem ser especificadas se o Agente de Servidor do SQL Server Compact 3.5 estiver configurado para usar a autenticação Básica ou Integrada.
Sintaxe
object.Pull (localTableName, sqlSelectString, oledbConnectionString, RDA_TRACKOPTION, ErrorTableName)
Aplica-se a
Objeto RemoteDataAccess do SQL Server Compact 3.5
Parâmetros
LocalTableName
O nome da tabela do SQL Server Compact 3.5 que recebe os registros extraídos do SQL Server. Se a tabela já existir, ocorrerá um erro.SQLSelectString
Uma cadeia de caracteres que especifica que tabela, colunas e registros devem ser extraídos do banco de dados do SQL Server e armazenados no banco de dados do SQL Server Compact 3.5. Essa cadeia de caracteres pode ser qualquer instrução SQL válida que retorne linhas, como instruções SELECT ou produtos armazenados.OLEDBConnectionString
Uma cadeia de caracteres de conexão do banco de dados OLE usada para conectar-se ao banco de dados do SQL Server.RDA_TRACKOPTION
A enumeração RDA_TRACKOPTION indica se é necessário rastrear as alterações feitas à tabela puxada. Quando índices são solicitados, os índices que existem na tabela sendo puxada são trazidos para o dispositivo com as restrições de PRIMARY KEY. Para obter mais informações, consulte RDA_TRACKOPTION.ErrorTableName
O nome da tabela de erros local que será criada se ocorrer um erro quando o método Push for chamado posteriormente para enviar as alterações de volta ao SQL Server. Esta opção só poderá ser especificada quando RDA_TRACKOPTION estiver definido como TRACKINGON.
Comentários
SQLSelectString
A parâmetro SQLSelectString controla quais dados são puxados da tabela SQL Server. Quando usar o parâmetro SQLSelectString, considere o seguinte:
O parâmetro SQLSelectString pode especificar uma cláusula WHERE para controlar quais registros serão retornados. Por exemplo, SELECT * FROM Address WHERE PostalCode='93868' recupera os endereços apenas do código postal especificado.
SQLSelectString oferece suporte a procedimentos e modos de exibição armazenados que retornam linhas.
SQLSelectString pode efetuar pull de colunas selecionadas de várias tabelas para uma única tabela, mas apenas se o parâmetro RDA_TRACKOPTION estiver definido como TRACKINGOFF.
Ocorrerá um erro se o conjunto de registros resultante contiver um tipo de dados sem suporte, como timestamp.
ErrorTableName
O parâmetro ErrorTableName especifica o nome da tabela onde os erros que ocorrem durante um envio devem ser armazenados. Se ocorrer um erro quando o aplicativo chamar o método Push, o SQL Server Compact 3.5 cria a tabela de erros e adiciona um registro à tabela para cada erro ocorrido. Quando o método Push for concluído, o aplicativo poderá examinar a tabela de erros para determinar se ocorreram erros. ErrorTableName poderá ser especificado somente quando TRACKINGON ou TRACKINGONWITHINDEXESfor especificado. Para obter mais informações sobre como funciona a tabela de erros, consulte Detecção e relatórios de conflitos RDA.