Переменные скрипта Direct Query
Вы можете использовать переменные скрипта для описания внутренней структуры приложения Direct Query и управления ей или для включения дополнительной информации о выводе перезагрузки.
Используйте раскрывающийся список, чтобы просмотреть краткое описание и синтаксис каждой переменной.
Эта переменная позволяет приложению указать время, по истечении которого кэшированный результат запроса будет считаться устаревшим.
Время отсчитывается с момента первого кэширования результата. Если возраст кэшированного результата больше или равен n секунд, он считается устаревшим и не используется в качестве кэшированного результата для соответствующего запроса. Вместо этого данный запрос будет выполнен так, как если бы кэшированного результата не существовало.
При повторном выполнении запроса его новый результат может быть кэширован в зависимости от текущего состояния кэша и памяти. В случае кэширования отсчет времени начинается заново, пока результат не устареет через n секунд.
Значение по умолчанию для этой переменной — 30. Это означает, что кэшированный результат запроса считается устаревшим через 30 секунд.
| Value | Description |
|---|---|
| -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.
| Value | Description |
|---|---|
| 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;