Pull メソッド (RDA)

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

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

• InternetURL プロパティには、SQL Server Compact Edition サーバー エージェントの URL を設定する必要があります。
• LocalConnectionString プロパティには、デバイス上の SQL Server Compact Edition データベースに接続するための OLE DB 接続文字列を設定する必要があります。
• 基本認証または統合認証を使用するように SQL Server Compact Edition サーバー エージェントが構成されている場合は、InternetLogin プロパティおよび InternetPassword プロパティを指定する必要があります。

構文

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

パラメータ

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

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

• OLEDBConnectionString
  SQL Server データベースに接続する場合に使用される OLE DB 接続文字列。詳細については、「SQL Server Compact Edition リモート データ アクセスのプログラミング」を参照してください。

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

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

適用対象

SQL Server Compact Edition RemoteDataAccess オブジェクト

解説

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 Edition によってエラー テーブルが作成され、発生した各エラーのテーブルにレコードが追加されます。Push メソッドが完了すると、アプリケーションではエラー テーブルを検査して、エラーが発生したかどうかを調べることができます。TRACKINGON または TRACKINGONWITHINDEXES が指定された場合にのみ、ErrorTableName を指定できます。エラー テーブルがどのように動作するかについては、「RDA の競合の検出と報告」を参照してください。

参照

関連項目

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

ヘルプおよび情報

SQL Server Compact Edition のサポートについて