Переменные скрипта 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 диаграммы не будут показывать более n строк результатов, даже если неограниченный SQL-запрос для содержимого диаграммы вернет более 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;