# Variáveis do Direct Discovery

## Variáveis de sistema do Direct Discovery

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/DirectDiscovery/direct-discovery-variables.htm)

#### DirectCacheSeconds

É possível definir um limite de armazenamento em cache para os resultados da consulta do Direct Discovery para visualizações. Depois que este limite for alcançado, o Qlik Sense limpa o cache quando novas consultas do Direct Discovery forem feitas. O Qlik Sense consulta as seleções nos dados de origem e cria o cache novamente com base no limite de tempo designado. O resultado para cada combinação de seleções é armazenado em cache de forma independente. Ou seja, o cache é atualizado para cada seleção de forma independente; portanto, uma seleção atualiza o cache apenas para os campos selecionados e uma segunda seleção atualiza o cache para os seus campos relevantes. Se a segunda seleção incluir campos que foram atualizados na primeira seleção, eles não serão atualizados no cache novamente se o limite de armazenamento em cache não tiver sido atingido.

O cache do Direct Discovery não se aplica às visualizações de Tabela. As seleções de tabela sempre consultam a origem dos dados.

O valor limite deve ser definido em segundos. O limite padrão do cache é de 1.800 segundos (30 minutos).

O valor usado para DirectCacheSeconds é o valor definido no momento em que o comando DIRECT QUERY é executado. O valor não pode ser alterado no tempo de execução.

Exemplo:

```
SET DirectCacheSeconds=1800;
```

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/DirectDiscovery/direct-discovery-variables.htm)

#### DirectConnectionMax

É possível fazer chamadas assíncronas paralelas para o banco de dados usando o recurso de pool de conexão. A sintaxe do script de carga para configurar o recurso de pool é a seguinte:

```
SET DirectConnectionMax=10;  
```

A configuração numérica especifica o número máximo de conexões de banco de dados que o código do Direct Discovery deve usar ao atualizar uma pasta. A configuração padrão é 1.

Nota informativaEsta variável deve ser usada com cautela. Defini-la para maior que 1 é conhecido por causar problemas ao se conectar ao Microsoft SQL Server.

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/DirectDiscovery/direct-discovery-variables.htm)

#### DirectUnicodeStrings

O Direct Discovery pode suportar a seleção de dados Unicode estendidos usando o formato padrão de SQL para literais dos caracteres estendidos (N’<string estendida>’), conforme exigido por alguns bancos de dados (especialmente o SQL Server). O uso dessa sintaxe pode ser ativado para o Direct Discovery com a variável de script DirectUnicodeStrings.

Definir essa variável para "true" habilitará o uso do marcador de caracteres ANSI generalizado e padrão “N” na frente das literais dos caracteres. Nem todos os bancos de dados suportam este padrão. A configuração padrão é "false".

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/DirectDiscovery/direct-discovery-variables.htm)

#### DirectDistinctSupport

Quando um valor do campo DIMENSION é selecionado em um objeto do Qlik Sense, uma consulta é gerada para o banco de dados de origem. Quando a consulta exigir o agrupamento, o Direct Discovery usa a palavra-chave DISTINCT para selecionar apenas valores exclusivos. No entanto, alguns bancos de dados exigem a palavra-chave GROUP BY. Defina DirectDistinctSupport como 'false' para gerar GROUP BY em vez de DISTINCT em consultas para obter valores exclusivos.

```
SET DirectDistinctSupport='false';  
```

Se DirectDistinctSupport for definido para "true", DISTINCTserá usado. Caso contrário, o comportamento padrão é usar DISTINCT.

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/DirectDiscovery/direct-discovery-variables.htm)

#### DirectEnableSubquery

Em cenários multitabela de alta cardinalidade, é possível gerar subconsultas na consulta SQL em vez de gerar uma cláusula IN grande. Essa opção é ativada ao configurar DirectEnableSubquery como 'true'. O valor padrão é 'false'.

Nota informativaQuando DirectEnableSubquery for desabilitado, não será possível carregar tabelas que não estiverem no modo Direct Discovery.

SET DirectEnableSubquery='true';

## Variáveis de agrupamento de consultas do Teradata

O agrupamento de consultas do Teradata é uma função que permite que aplicativos corporativos colaborem com o banco de dados Teradata subjacente para fornecer melhor contabilidade, priorização e gerenciamento de carga de trabalho. Ao usar a marcação da consulta, é possível retornar metadados, como as credenciais do usuário, para uma consulta.

Duas variáveis​estão disponíveis, que são caracteres que são avaliados e enviados para o banco de dados.

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/DirectDiscovery/direct-discovery-variables.htm)

#### SQLSessionPrefix

Estes caracteres são enviados quando uma conexão com o banco de dados é criada.

SET SQLSessionPrefix = 'SET QUERY\_BAND = ' & Chr(39) & 'Who=' & OSuser() & ';' & Chr(39) & ' FOR SESSION;';

Se OSuser(), por exemplo, retornar WA\sbt, isso será avaliado para SET QUERY\_BAND = 'Who=WA\sbt;' FOR SESSION;, que é enviado para o banco de dados quando a conexão é criada.

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/DirectDiscovery/direct-discovery-variables.htm)

#### SQLQueryPrefix

Estes caracteres são enviados para cada consulta individual.

SET SQLSessionPrefix = 'SET QUERY\_BAND = ' & Chr(39) & 'Who=' & OSuser() & ';' & Chr(39) & ' FOR TRANSACTION;';

## Variáveis​de caracteres do [](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/DirectDiscovery/direct-discovery-variables.htm)Direct Discovery

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/DirectDiscovery/direct-discovery-variables.htm)

#### DirectFieldColumnDelimiter

É possível definir o caractere usado como delimitador de campo nos comandos Direct Query para os bancos de dados exigem um caractere diferente de vírgula como o delimitador de campo. O caractere especificado deve estar entre aspas simples no comando SET.

SET DirectFieldColumnDelimiter= '|'

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/DirectDiscovery/direct-discovery-variables.htm)

#### DirectStringQuoteChar

É possível especificar que um caractere use caracteres entre aspas em uma consulta gerada. O padrão são aspas simples. O caractere especificado deve estar entre aspas simples no comando SET.

SET DirectStringQuoteChar= '"';

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/DirectDiscovery/direct-discovery-variables.htm)

#### DirectIdentifierQuoteStyle

Você pode especificar que aspas não-ANSI de identificadores sejam usadas em consultas geradas. Desta vez, as únicas aspas diferentes de ANSI disponíveis é GoogleBQ. O padrão é ANSI. Maiúsculas, minúsculas e letras maiúsculas e minúsculas podem ser usadas (ANSI, ansi, Ansi).

SET DirectIdentifierQuoteStyle="GoogleBQ";

Por exemplo, são usadas aspas ANSI no seguinte comando SELECT:

SELECT [Quarter] FROM [qvTest].[sales] GROUP BY [Quarter]

Quando DirectIdentifierQuoteStyle é definido para "GoogleBQ", o comando SELECT usaria as aspas da seguinte forma:

SELECT [Quarter] FROM [qvTest.sales] GROUP BY [Quarter]

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/DirectDiscovery/direct-discovery-variables.htm)

#### DirectIdentifierQuoteChar

É possível especificar que um caractere controle as aspas de identificadores em uma consulta gerada. Isso pode ser definido para um caractere (como aspas duplas) ou dois (como um par de colchetes). O padrão são aspas duplas.

SET DirectIdentifierQuoteChar='[]';

SET DirectIdentifierQuoteChar='``';

SET DirectIdentifierQuoteChar=' ';

SET DirectIdentifierQuoteChar='""';

[Fontes de dados suportadas no Direct Discovery](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/DirectDiscovery/data-sources-supported-in-direct-discovery.htm)

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/DirectDiscovery/direct-discovery-variables.htm)

#### DirectTableBoxListThreshold

Quando os campos do Direct Discovery são usados em uma visualização de Tabelas, um limite é definido para limitar o número de linhas exibidas. O limite padrão é de 1.000 registros. A configuração do limite padrão pode ser alterada ao definir a variávelDirectTableBoxListThreshold no script de carregamento. Por exemplo:

SET DirectTableBoxListThreshold=5000;

A configuração do limite aplica-se apenas às visualizações de Tabelas que contenham campos do Direct Discovery. Visualizações de tabela que contém apenas campos com memória não estão limitados pela configuração DirectTableBoxListThreshold.

Nenhum campo é exibido na visualização de Tabelas, até que a seleção tenha menos registros do que o limite.

## Variáveis de interpretação numérica do Direct Discovery

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/DirectDiscovery/direct-discovery-variables.htm)

#### DirectMoneyDecimalSep

O separador de decimais definido substitui o símbolo decimal da moeda no comando SQL gerado para carregar dados com o Direct Discovery. Este caractere deve corresponder ao caractere utilizado em DirectMoneyFormat.

O valor padrão é '.'

Exemplo:

Set DirectMoneyDecimalSep='.';

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/DirectDiscovery/direct-discovery-variables.htm)

#### DirectMoneyFormat

O símbolo definido substitui o formato de moeda no comando SQL gerado para carregar os dados com o Direct Discovery. O símbolo de moeda para o separador de milhares não deve ser incluído.

O valor padrão é '#.0000'

Exemplo:

Set DirectMoneyFormat='#.0000';

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/DirectDiscovery/direct-discovery-variables.htm)

#### DirectTimeFormat

O formato de tempo definido substitui o formato de tempo no comando SQL gerado para carregar os dados com o Direct Discovery.

Exemplo:

Set DirectTimeFormat='hh:mm:ss';

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/DirectDiscovery/direct-discovery-variables.htm)

#### DirectDateFormat

O formato de data definido substitui o formato de data no comando SQL gerado para carregar os dados com o Direct Discovery.

Exemplo:

Set DirectDateFormat='MM/DD/YYYY';

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/DirectDiscovery/direct-discovery-variables.htm)

#### DirectTimeStampFormat

O formato definido substitui o formato de data e tempo no comando SQL gerado no comando do SQL gerado para carregar os dados com o Direct Discovery.

Exemplo:

Set DirectTimestampFormat='M/D/YY hh:mm:ss[.fff]';

## Saiba mais

* [Acessando grandes conjuntos de dados com Direct Discovery](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/DirectDiscovery/access-large-data-sets-with-direct-discovery.htm)