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으로 고정되어 있습니다. 즉, 일부 Direct Query 지원 차트는 차트 콘텐츠에 대한 제한 없는 SQL 쿼리가 n개 이상의 행을 반환하더라도 n개 이상의 행 결과를 표시하지 않습니다.
DirectQueryRowFetchMaxCount 스크립트 변수는 테이블 차트에 표시할 수 있는 최대 행 수를 늘리거나 제한하거나 스캐터 차트에 표시되는 최대 결과를 기본 최댓값인 2500개 미만으로 제한하기 위해 존재합니다.
또한, 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;