Direct Query 스크립트 변수
스크립트 변수를 사용하여 Direct Query 응용 프로그램의 내부 구조를 설명 및 조작하거나 추가 로드 출력 정보를 활성화할 수 있습니다.
드롭다운을 사용하여 각 변수의 간단한 설명과 구문을 확인하십시오.
이 변수를 사용하면 응용 프로그램에서 캐시된 쿼리 결과가 만료된 것으로 간주되는 기간을 지정할 수 있습니다.
기간은 결과가 처음 캐시된 시점부터 정의됩니다. 캐시된 결과의 기간이 n초 이상인 경우 만료된 것으로 간주되어 일치하는 쿼리에 대한 캐시된 결과로 사용되지 않습니다. 대신 해당 쿼리는 캐시된 결과가 존재하지 않는 것처럼 실행됩니다.
쿼리가 다시 실행되면 현재 캐시 및 메모상태에 따라 새 결과가 캐시될 수 있습니다. 캐시된 경우 n초 후에 만료될 때까지 다시 기간이 경과하기 시작합니다.
이 변수의 기본값은 30입니다. 즉, 캐시된 쿼리 결과는 30초 후에 만료된 것으로 간주됩니다.
| 값 | 설명 |
|---|---|
| -1 |
이 설정은 사용자가 로그인해 있는 동안 캐시가 유지됨을 의미합니다. |
| 0 |
캐싱이 완전히 비활성화됩니다. |
| 1-9,223,372,036,854,775,807 | 캐시된 결과의 만료 기간을 초 단위로 설정합니다. |
| > 9,223,372,036,854,775,807 | 변수를 30으로 설정하는 것과 같습니다. |
DirectQueryResultCacheExpirySeconds=n;
Direct Query를 사용하는 대부분의 차트에 대해 가져오는 최대 행 수의 기본값은 클라이언트 쿼리에 의해 결정되며 256에서 1000까지 다양할 수 있습니다. 예외는 분산형 차트이며, 기본 최대값은 2500으로 고정되어 있습니다. 즉, 차트 콘텐츠에 대한 제한 없는 SQL 쿼리로 인해 n개보다 많은 행이 생성되더라도 일부 Direct Query 지원 차트에는 n개 이상의 행 결과가 표시되지 않습니다.
테이블 차트에 표시할 최대 행 수를 늘리거나 제한하거나, 분산형 차트에 표시되는 최대 결과를 기본 최대값인 2500 미만으로 제한할 수 있도록 DirectQueryRowFetchMaxCount 스크립트 변수가 존재합니다.
또한 DirectQueryRowFetchMaxCount에는 다음과 같은 고려 사항이 있습니다.
-
DirectQueryRowFetchMaxCount의 기본값은 -1입니다(사용되지 않음을 의미함).
-
스크립트 변수 DirectQueryRowFetchMaxCount를 0보다 큰 특정 값으로 설정하면 테이블 차트를 채우는 쿼리가 데이터베이스에서 최대 DirectQueryRowFetchMaxCount개 행(아래 표에 표시된 최대값까지)을 가져올 수 있습니다.
-
DirectQueryRowFetchMaxCount가 0에서 2500 사이로 구성된 경우, DirectQueryRowFetchMaxCount 값은 분산형 차트를 채우기 위해 검색되는 최대 데이터 행을 제한하는 데도 사용됩니다.
-
DirectQueryRowFetchMaxCount 스크립트 변수의 효과를 취소하려면 변수를 정의하지 않거나 명시적으로 -1 값으로 설정할 수 있습니다.
| 값 | 설명 |
|---|---|
| 0 |
0 값은 테이블 차트 행 가져오기에만 영향을 미치는 특별한 값입니다. 이 설정은 테이블 차트를 채우기 위해 (선택 사항의 영향을 받는) 모든 해당 행에 대해 동적으로 페이지를 매깁니다. 페이지 매김을 위한 총 최대 행 수를 결정하기 위해 초기 카운트 쿼리를 수행하여 원격 데이터베이스가 테이블을 채우는 쿼리에 대해 반환할 총 행 수를 결정합니다. 이 변수를 0으로 설정하면 지원되는 다른 모든 Direct Query 차트(테이블 및 분산형 차트 제외)가 클라이언트가 지정한 기본 최대 행 수를 가져옵니다. 분산형 차트는 기본 최대값인 2500행을 가져옵니다. 정보 메모로드 또는 선택할 때마다 하나 대신 두 개의 쿼리를 수행하므로 데이터베이스 성능 및 비용 측면에서 더 많은 비용이 들 수 있습니다.
|
| 1-100,000 | 원격 데이터베이스에서 테이블 또는 분산형 차트에 대해 가져올 최대 행 수를 설정합니다. 분산형 차트는 표시할 행을 2500개 이상 검색하지 않습니다. |
| > 100,000 | 변수를 0으로 설정하는 것과 동일한 효과입니다. |
DirectQueryRowFetchMaxCount=n;
이 변수의 기본값은 0입니다.
이 변수를 0보다 큰 값으로 설정하면 Direct Query 응용 프로그램 데이터 로드(다시 로드) 작업의 출력에 추가 정보가 포함될 수 있습니다.
추가 정보는 테이블의 사용자 지정 SQL 정의 결과를 미리 보기 위해 원격 데이터베이스로 전송된 SQL 쿼리를 보여줍니다. 이 정보는 사용자 지정 SQL 문 결과 예상을 검증, 평가 또는 세분화하는 데 도움이 될 수 있습니다. 관련 정보는 DirectQueryPreviewResp 변수를 참조하십시오.
DirectQueryPreviewSql=1;
이 변수의 기본값은 0입니다.
이 변수를 0보다 큰 값으로 설정하면 Direct Query 응용 프로그램 데이터 로드(다시 로드) 작업의 출력에 추가 정보가 포함될 수 있습니다.
추가 정보는 테이블의 사용자 지정 SQL 정의와 관련하여 원격 데이터베이스로 전송된 SQL 쿼리의 결과를 보여줍니다. 관련 정보는 DirectQueryPreviewSql 변수를 참조하십시오.
DirectQueryPreviewResp=1;