次の方法で共有

Pull メソッド (RDA)

  • [アーティクル]

リモートの MicrosoftSQL Server データベースからデータをダウンロードし、そのデータをローカルの MicrosoftSQL Server Compact 3.5 データベースの 1 つのテーブルに格納します。

Pull メソッドを呼び出す前に、次の RDA オブジェクト プロパティを設定する必要があります。

  • InternetURL プロパティには、SQL Server Compact 3.5 サーバー エージェントの URL を設定する必要があります。

  • LocalConnectionString プロパティには、デバイス上の SQL Server Compact 3.5 データベースに接続するための OLE DB 接続文字列を設定する必要があります。

  • 基本認証または統合認証を使用するように SQL Server Compact 3.5 サーバー エージェントが構成されている場合は、InternetLogin プロパティおよび InternetPassword プロパティを指定する必要があります。

構文

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

適用対象

SQL Server Compact 3.5 RemoteDataAccess オブジェクト

パラメーター

  • LocalTableName
    抽出された SQL Server レコードを受け取る SQL Server Compact 3.5 テーブルの名前。同名のテーブルが既に存在する場合、エラーが発生します。

  • SQLSelectString
    SQL Server データベースから抽出して SQL Server Compact 3.5 データベースに格納するテーブル、列、およびレコードを指定する文字列。行を返す有効な SQL ステートメントであれば、SELECT ステートメントやストアド プロシージャなど、任意の SQL ステートメントを表す文字列を指定できます。

  • OLEDBConnectionString
    SQL Server データベースに接続する場合に使用される OLE DB 接続文字列。

  • RDA_TRACKOPTION
    RDA_TRACKOPTION 列挙値は、プルしたテーブルへの変更を監視するかどうかを示します。インデックスを要求した場合、プルしたテーブルの既存のインデックスが PRIMARY KEY 制約付きでデバイスに取り込まれます。詳細については、「RDA_TRACKOPTION」を参照してください。

  • ErrorTableName
    ローカル エラー テーブルの名前。後で Push メソッドを呼び出して変更内容を SQL Server に戻そうとしたときにエラーが発生すると、このローカル エラー テーブルが作成され、エラー情報が格納されます。RDA_TRACKOPTION が TRACKINGON に設定された場合は、このオプションを指定できます。

説明

SQLSelectString

SQL Server テーブルからデータがプルされた SQLSelectString パラメータ コントロール。SQLSelectString パラメータを使用する場合は、次の点を考慮します。

  • SQLSelectString では、WHERE 句を使用することによって取得するレコードを限定できます。たとえば、SELECT * FROM Address WHERE PostalCode='93868' は、特定の郵便番号の住所のみを取得します。

  • また、SQLSelectString では、行を返すものであれば、ストアド プロシージャおよびビューも使用できます。

  • SQLSelectString は、RDA_TRACKOPTION パラメータが TRACKINGOFF に設定された場合にのみ、複数のテーブルから選択された列を 1 つのテーブルにプルすることができます。

  • プルしたレコードセットの中に timestamp 型などサポートされていないデータ型が含まれていると、エラーが発生します。

ErrorTableName

ErrorTableName パラメータには、プッシュの間に発生したエラーを格納するテーブルの名前を指定します。アプリケーションが Push メソッドを呼び出したときにエラーが発生した場合は、SQL Server Compact 3.5 によってエラー テーブルが作成され、発生した各エラーのテーブルにレコードが追加されます。Push メソッドが完了すると、アプリケーションではエラー テーブルを検査して、エラーが発生したかどうかを調べることができます。TRACKINGON または TRACKINGONWITHINDEXESが指定された場合にのみ、ErrorTableName を指定できます。エラー テーブルがどのように動作するかについては、「RDA の競合の検出と報告」を参照してください。

関連項目

その他の技術情報

RDA オブジェクトのメソッド

Push メソッド (RDA)