# Variáveis de script do (DIRECT QUERY \*)

Você pode usar variáveis de script para descrever e manipular a estrutura interna de um aplicativo (DIRECT QUERY \*) ou para permitir informações adicionais de saída de recarga.

Use o menu suspenso para ver uma breve descrição e a sintaxe de cada variável.

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DirectQuery/internal-variables-direct-query.htm)

#### DirectQueryResultCacheExpirySeconds

Essa variável permite que um aplicativo especifique a idade na qual um resultado de consulta em cache será considerado obsoleto.

A idade é definida a partir de quando o resultado foi armazenado em cache pela primeira vez. Se a duração de um resultado armazenado em cache for maior que ou igual a n segundos, ele será considerado obsoleto e não será usado como um resultado armazenado em cache para uma consulta correspondente. Em vez disso, a consulta em questão será executada como se não existisse nenhum resultado armazenado em cache.

Quando a consulta for executada novamente, seu novo resultado poderá ser armazenado em cache, dependendo do cache atual e do estado da memória. Se armazenado em cache, ele começará a envelhecer novamente até ficar obsoleto em n segundos.

O valor padrão para essa variável é 30. Isso significa que o resultado da consulta em cache é considerado obsoleto após 30 segundos.

Valores de variáveis com suporte

| Valor | Descrição |
| --- | --- |
| -1 | Essa configuração significa que o cache é mantido durante o tempo em que o usuário está conectado. |
| 0 | O armazenamento em cache está completamente desativado. |
| 1-9,223,372,036,854,775,807 | Define a idade obsoleta do resultado em cache em segundos. |
| > 9,223,372,036,854,775,807 | O mesmo que definir a variável como 30. |

DirectQueryResultCacheExpirySeconds=n;

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DirectQuery/internal-variables-direct-query.htm)

#### DirectQueryRowFetchMaxCount

O valor padrão para o número máximo de linhas obtidas para a maioria dos gráficos com o (DIRECT QUERY \*) é determinado pela consulta do cliente e pode variar de 256 a 1000. A exceção são os gráficos de dispersão, em que o máximo padrão é fixado em 2500. Isso significa que alguns gráficos compatíveis com o (DIRECT QUERY \*) não mostrarão resultados com mais de n linhas, mesmo que uma consulta SQL não limitada para o conteúdo do gráfico resulte em mais de n linhas.

A variável de script DirectQueryRowFetchMaxCount existe para permitir aumentar ou limitar o número máximo de linhas a serem exibidas em um gráfico de tabela ou para restringir o número máximo de resultados exibidos em um gráfico de dispersão para menos que o máximo padrão de 2500.

Nota informativaO valor de DirectQueryRowFetchMaxCount não afetará as operações de agregação.

Além disso, o DirectQueryRowFetchMaxCount tem as seguintes considerações:

* O valor padrão de DirectQueryRowFetchMaxCount é -1 (o que significa que não é usado).

* A configuração da variável de script DirectQueryRowFetchMaxCount em um valor específico maior que 0 permite que uma consulta de preenchimento de gráfico de tabela busque até DirectQueryRowFetchMaxCount linhas do banco de dados - até os valores máximos mostrados na tabela abaixo.

* Se DirectQueryRowFetchMaxCount estiver configurado para estar entre 0 e 2500, o valor DirectQueryRowFetchMaxCount também será usado para limitar o máximo de linhas de dados recuperadas para preencher um gráfico de dispersão.

* Para desfazer os efeitos da variável do script DirectQueryRowFetchMaxCount, a variável pode ser indefinida ou definida explicitamente como um valor -1.

Valores de variáveis com suporte

| Valor | Descrição |
| --- | --- |
| 0 | Um valor de 0 é um valor especial que afeta apenas a busca de linhas do gráfico da tabela. Essa configuração pagina dinamicamente todas as linhas aplicáveis (conforme influenciado pelas seleções) para preencher um gráfico de tabela. A determinação do número máximo de linhas no total para a paginação é feita executando uma consulta de contagem inicial para determinar quantas linhas no total o banco de dados remoto retornará para a consulta de preenchimento da tabela.<br><br>Definir essa variável como 0 fará com que todos os outros gráficos do (DIRECT QUERY \*) compatíveis (exceto tabelas e gráficos de dispersão) busquem o número máximo de linhas especificado pelo cliente. Os gráficos de dispersão buscarão o máximo padrão de 2500 linhas.<br><br>Nota informativaComo ele executa duas consultas para cada carregamento ou seleção em vez de uma, pode ser mais caro em termos de desempenho e custos do banco de dados. |
| 1-100.000 | Define o número máximo de linhas a serem buscadas para uma tabela ou gráfico de dispersão do banco de dados remoto. Observe que um gráfico de dispersão nunca recuperará mais de 2500 linhas para exibição. |
| &gt; 100.000 | O mesmo efeito que definir a variável como 0. |

DirectQueryRowFetchMaxCount=n;

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DirectQuery/internal-variables-direct-query.htm)

#### DirectQueryPreviewSql

O valor padrão dessa variável é 0.

Definir essa variável com um valor &gt; 0 permite que informações adicionais sejam incluídas na saída de uma ação do aplicativo (DIRECT QUERY \*) Carregar dados (recarga).

As informações adicionais mostram a consulta SQL enviada ao banco de dados remoto para visualizar o resultado de uma definição SQL personalizada de uma tabela. Essas informações podem ser úteis para validar, avaliar ou refinar as expectativas de resultado de instruções SQL personalizadas. Consulte a variável DirectQueryPreviewResp para obter informações relacionadas.

DirectQueryPreviewSql=1;

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DirectQuery/internal-variables-direct-query.htm)

#### DirectQueryPreviewResp

O valor padrão dessa variável é 0.

Definir essa variável com um valor &gt; 0 permite que informações adicionais sejam incluídas na saída de uma ação do aplicativo (DIRECT QUERY \*) Carregar dados (recarga).

As informações adicionais mostram os resultados de uma consulta SQL enviada ao banco de dados remoto relacionada a uma definição SQL personalizada de uma tabela. Consulte a variável DirectQueryPreviewSql para obter informações relacionadas.

DirectQueryPreviewResp=1;