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;