Pull 메서드(RDA)
원격 Microsoft SQL Server 데이터베이스에서 데이터를 다운로드하여 로컬 Microsoft SQL Server 2005 Compact Edition(SQL Server Compact Edition) 데이터베이스의 단일 테이블에 저장합니다.
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 데이터베이스에 저장할 테이블, 열 및 레코드를 지정하는 문자열입니다. 이 문자열에는 SELECT 문, 저장 프로시저 등의 열을 반환하는 모든 유효한 SQL문을 사용할 수 있습니다.
- OLEDBConnectionString
SQL Server 데이터베이스에 연결할 때 사용하는 OLE DB 연결 문자열입니다. 자세한 내용은 SQL Server Compact Edition RDA(Remote Data Access) 프로그래밍을 참조하십시오.
- RDA_TRACKOPTION
RDA_TRACKOPTION 열거 값은 끌어온 테이블의 변경 내용을 추적할지 여부를 지정합니다. 인덱스를 요청하면 끌어오는 테이블에 존재하는 인덱스는 PRIMARY KEY 제약 조건이 있는 장치로 다운로드됩니다. 자세한 내용은 RDA_TRACKOPTION을 참조하십시오.
- ErrorTableName
Push 메서드를 나중에 호출하여 SQL Server 에 변경 내용을 다시 보낼 때 오류가 발생하는 경우 생성되는 로컬 오류 테이블의 이름입니다. 이 옵션은 RDA_TRACKOPTION을 TRACKINGON으로 설정한 경우에만 지정할 수 있습니다.
적용 대상
SQL Server Compact Edition RemoteDataAccess 개체
주의
SQLSelectString
SQLSelectString 매개 변수는 SQL Server 테이블에서 끌어오는 데이터를 제어합니다. SQLSelectString 매개 변수를 사용하는 경우 다음 사항을 고려하십시오.
- SQLSelectString 매개 변수는 WHERE 절을 지정하여 반환되는 레코드를 제어할 수 있습니다. 예를 들어
SELECT * FROM Address WHERE PostalCode='93868'은 지정한 우편 번호에 해당하는 주소만 검색합니다. - SQLSelectString은 행을 반환하는 뷰 및 저장 프로시저를 지원합니다.
- SQLSelectString은 RDA_TRACKOPTION 매개 변수가 TRACKINGOFF로 설정된 경우에만 여러 개의 테이블에서 단일 테이블로 선택한 열을 끌어올 수 있습니다.
- 결과 레코드 집합에 timestamp 등의 지원되지 않는 데이터 형식이 들어 있으면 오류가 발생합니다.
ErrorTableName
ErrorTableName 매개 변수는 밀어넣기 실행 중 발생하는 오류가 저장될 테이블의 이름을 지정합니다. 응용 프로그램에서 Push 메서드를 호출할 때 오류가 발생하는 경우 SQL Server Compact Edition 에서 오류 테이블을 만들고 발생한 오류마다 테이블에 레코드를 추가합니다. Push 메서드가 종료되면 응용 프로그램에서 오류 테이블을 검사하여 오류 발생 여부를 확인합니다. ErrorTableName은 TRACKINGON 또는 TRACKINGONWITHINDEXES를 지정하는 경우에만 지정할 수 있습니다. 오류 테이블의 작동 방법은 RDA 충돌 감지 및 보고를 참조하십시오.