docwiki 번역 [DocWiki 번역] FireDAC.Stan.Option.TFDFetchOptions.RecsMax

[Kori]

Docwiki에 있는 "FireDAC.Stan.Option.TFDFetchOptions.RecsMax"를 번역한 글: 번역일: 2022년 3월 29일)

위로 가기: [DocWiki 번역] TFDFetchOptions

(이 글은 "설명" 부분만 번역했음. 클래스 선언, 부모, 메소드, 프로퍼티, 프로퍼티, 유닛 정보 등등은 RecsMax 원문에 정리된 것을 볼것)

 

설명 (Description)

담아올 레코드의 최대 갯수를 제어한다.

결과 세트 하나에 담아올 레코드 갯수를 제한하려면, RecsMax를 사용한다. 이미 준비된 데이터셋에서 RecsMax를 변경하려면, 애플리케이션에서 먼저 Disconnect 메소드를 호출해야 한다.

FireDAC은 RecsMax 갯수 만큼만 레코드를 담아온다. 다른 레코드들은 버린다. 값을 -1로 지정하면 "제한없음"이 된다. Mode = fmExactRecsMax와 함께 사용하는 경우, 결과 세트에 담아온 레코드의 갯수가 FetchOptions.RecsMax에 지정된 숫자와 일치하지 않으면 예외가 일어난다. RecsSkip과 RecsMax를 사용하면 결과 세트 페이지 나누기를 할 수 있어서 웹 애플리케이션에서 유용하다. 또한 애플리케이션에서 escape 함수인 LIMIT를 사용할 수도 있는데, 만약 둘 다 명시되어 있으면, LIMIT가 우선 적용된다.

DBMS에 따라,  RecsMax와 RecsSkip은 SELECT 구문 (TOP, LIMIT, 등)에 반영되어 서버 측에서 쿼리할 때 결과 세트 갯수를 제한할 수 있다. 만약 DBMS에서 이와 같은 구문을 지원하지 않으면, 이 제한은 클라이언트에서 수행된다.

기본 값은 -1이다.

 

기타 자료 (See Also)

• [DocWiki 번역] 행 담아오기(Fetching Rows) (FireDAC)
• System Macro Functions
• [DocWiki 번역] FireDAC.Stan.Option.TFDFetchOptions.RecsSkip
• [DocWiki 번역] FireDAC.Stan.Option.TFDFetchOptions.Mode
• [DocWiki 번역] FireDAC.Stan.Option.TFDFetchOptions.RowsetSize