Compartilhar via

Método Pull (RDA)

  • Artigo

Baixa dados de um banco de dados do Microsoft SQL Server remoto e os armazena em uma única tabela em um banco de dados do Microsoft SQL Server Compact 3.5 (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)

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.

Aplica-se a

Objeto RemoteDataAccess do SQL Server Compact 3.5

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 TRACKINGONWITHINDEXES for especificado. Para obter mais informações sobre como funciona a tabela de erros, consulte Detecção e relatórios de conflitos RDA.

Consulte também

Referência

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

Ajuda e informações

Obtendo assistência (SQL Server Compact 3.5 Service Pack 1)