Propriedades de SETCONFIGPROPERTY

Consulte este índice para obter uma lista de SETCONFIGPROPERTY propriedades.

A tabela a seguir é um índice de todas as SETCONFIGPROPERTY propriedades para Data Virtualization.

Nome da propriedade Explicação
BATCHSIZE_FOR_LISTSCHEMAS_OR_LISTTABLES Esta propriedade especifica o número máximo de esquemas ou tabelas recuperados por meio das APIs LISTSCHEMAS LISTTABLES e. O padrão é 10000. A propriedade deve ser definida em REMOTENODE.

Consulte LISTSCHEMAS e LISTTABLES.

COLLECT_FETCHPHASE_WARNINGS Use esse parâmetro para ativar ou desativar os avisos de fase de busca.

Para obter mais informações, consulte Ativando e desativando avisos e erros da fase de busca em Data Virtualization.

CONNECTION_DETAILS_CACHE_SIZE Cache de credenciais para melhorar o desempenho dos tempos de resposta. Use essa propriedade para definir o número de solicitações de credenciais retidas no cache. Esse cache permite o compartilhamento de credenciais pré-computadas para vários threads que estão solicitando os mesmos detalhes da fonte de dados.

O valor-padrão é 100. A definição desse valor como zero ou inferior desativa o armazenamento em cache.

CONNECTION_DETAILS_REFRESH_SEC Mantenha as credenciais atualizadas usando essa propriedade para definir o intervalo de atualização (em segundos) para recuperar os detalhes da conexão que são mantidos por componentes externos, como as conexões da plataforma. Essa propriedade também controla a frequência com que as solicitações são enviadas para recuperar credenciais, caso elas tenham sido atualizadas.

O valor padrão é 600 (10 minutos). Definir esse valor como um número baixo, como cinco, pode fazer com que o serviço de conexões da plataforma deixe de responder.

CONNECTION_DETAILS_REQUEST_TIMEOUT_MS Quando você adiciona ou usa uma fonte de dados em um agente remoto que está configurado com credenciais armazenadas em um cofre, você pode ver uma mensagemFailed to update connection detailserro. Para contornar esse problema, você pode aumentar o valor do tempo limite usando essa propriedade.
DATASOURCE_MAX_BINARY_SIZE e <SRCTYPE> _MAX_BINARY_SIZE e <CID>_MAX_BINARY_SIZE Use a propriedade DATASOURCE_MAX_BINARY_SIZE para aprimorar o desempenho do SQL, definindo o tamanho máximo da coluna (em bytes) para tipos binários não limitados em tabelas de origem remota durante operações de lista, visualização ou virtualização no nível do agente.

Você pode substituir o endereço DATASOURCE_MAX_BINARY_SIZE para limitá-lo a todas as conexões de fonte de dados de um determinado tipo usando a propriedade <SRCTYPE>_MAX_STRING_SIZE.
  • Substitua <SRCTYPE> pelo nome da fonte. Por exemplo, Hive data sources é HIVE_MAX_BINARY_SIZE.
Você pode substituir <SRCTYPE>_MAX_BINARY_SIZE em nível de conexão individual usando a propriedade <CID>_MAX_BINARY_SIZE.
  • Substitua <CID> pelo identificador exclusivo da conexão da fonte de dados.

O tamanho padrão dessas propriedades é 32672, o que garante o pushdown eficiente de predicados em consultas contra tabelas virtuais que as contêm. Reduza o tamanho padrão para melhorar ainda mais o desempenho e a eficiência.

DATASOURCE_MAX_STRING_SIZE e <SRCTYPE> _MAX_STRING_SIZE e <CID>_MAX_STRING_SIZE Use a propriedade DATASOURCE_MAX_STRING_SIZE para aprimorar o desempenho do SQL, definindo o tamanho máximo da coluna (em bytes) para tipos de cadeia não limitados em tabelas de origem remota durante operações de lista, visualização ou virtualização.

Você pode substituir o endereço DATASOURCE_MAX_STRING_SIZE para limitá-lo a todas as conexões de fonte de dados de um determinado tipo usando a propriedade <SRCTYPE>_MAX_STRING_SIZE.
  • Substitua <SRCTYPE> pelo nome da fonte. Por exemplo, Hive data sources é HIVE_MAX_STRING_SIZE.
Você pode substituir <SRCTYPE>_MAX_STRING_SIZE em nível de conexão individual usando a propriedade <CID>_MAX_STRING_SIZE.
  • Substitua <CID> pelo identificador exclusivo da conexão da fonte de dados.

O tamanho padrão dessas propriedades é 32672, o que garante o pushdown eficiente de predicados em consultas contra tabelas virtuais que as contêm. Reduza o tamanho padrão para melhorar ainda mais o desempenho e a eficiência.

FETCH_BUFFER_SIZE Melhore o desempenho da consulta minimizando os tempos de espera da rede durante a transferência de dados. Use essa propriedade para especificar o número de lotes de linhas que são armazenados em buffer em um agente Data Virtualization quando você está buscando resultados de consulta.

O valor-padrão é 100. O valor mínimo é 20.

Observação: você pode reduzir essa propriedade para 20 para evitar um erro de uso excessivo de memória durante cenários de alta simultaneidade (como 4 Kb), sem afetar negativamente o desempenho.
GAIAN_CONNECTIONS_CHECKER_HEARTBEAT_MS Quando você configura uma conexão de fonte de dados para Data Virtualization e a conexão falhar, use essa propriedade para aumentar o valor do parâmetro de tempo limite.

Para obter mais informações, consulte Não é possível conectar-se a uma fonte de dados em Data Virtualization.

LISTSCHEMAS_MODE Essa propriedade permite que você melhore o desempenho das listagens de esquemas. Você pode optar por listar o número total de esquemas na visualização Explore usando uma consulta personalizada ou a API getSchemas no tipo de origem ou no nível do Identificador de conexão (CID).
  • Liste os esquemas no tipo de origem substituindo os parâmetros e executando esse procedimento armazenado:
    call dvsys.SETCONFIGPROPERTY('LISTSCHEMAS_MODE_<source_type>', '<mode>,'<qpendpoint>', ?, ?) 
    • Substitua <source_type> pela fonte (ou seja, DB2, ORACLE, HIVE e assim por diante).
    • Substitua <mode> por QUERY para usar uma consulta personalizada ou API para usar a API getSchemas.
    • Substitua <qpendpoint> pelo endpoint do queryplex. Por exemplo: qpendpoint_1:6415.

  • Liste os esquemas no nível do CID substituindo os parâmetros e executando esse procedimento armazenado:
    call dvsys.SETCONFIGPROPERTY('LISTSCHEMAS_MODE_<CID>', '<mode>,'<qpendpoint>', ?, ?)
    • Substitua <CID> pelo identificador de conexão. O CID pode ser encontrado na página Fontes de dados, em Dados > Data virtualization.
    • Substitua <mode> por QUERY para usar uma consulta personalizada ou API para usar a API getSchemas.
    • Substitua <qpendpoint> pelo endpoint do queryplex. Por exemplo: qpendpoint_1:6415.
LOGFILE_MAX_SIZE_MB Gerencie o tamanho dos arquivos de registro para garantir o uso eficiente do espaço em disco. Use essa propriedade para definir o tamanho máximo (em megabytes) de cada arquivo de registro rotativo que é mantido e armazenado por cada Data Virtualization agente.

O valor-padrão é 100. O valor mínimo necessário é 1.

LOGLEVEL

Defina o nível de registro para todos os nós.

As configurações de nível de registro incluem as seguintes opções:
  • NENHUM
  • LESS (configuração padrão)
  • MORE (registro em nível de depuração)
  • ALL (registro em nível de depuração)
MAX_DS_JDBC_CONNECTION_TIMEOUT_MS Reduza o tempo de inatividade de conexões lentas com fontes de dados usando essa propriedade para definir o tempo limite (em milissegundos) para estabelecer conexões com fontes de dados com as quais você já tem conexões ativas.

O valor padrão é 120000 (2 minutos). O valor mínimo deve ser definido de acordo com o tempo que leva para se conectar à fonte de dados mais lenta. Definir o valor como zero pode fazer com que a conexão falhe.

MAX_DS_POOLSIZES

Essa propriedade é uma configuração global que especifica o tamanho máximo do pool de conexões para gateways e fontes de dados definidos.

O mecanismo permite a criação do número especificado de conexões.

O valor padrão para o tamanho máximo do pool de conexões é 10.

Use essa propriedade para resolver consultas simultâneas lentas ou com falha em Data Virtualization.

MAX_INBOUND_CONNECTION_THREADS Garanta um desempenho estável quando estiver em uso intenso usando essa propriedade para especificar o número máximo de conexões de entrada permitidas pelo banco de dados Derby subjacente.

O valor padrão é 1000. Definir esse valor mais baixo pode reduzir o consumo de memória, mas afetar negativamente o desempenho.

MAX_JDBC_CONNECTION_QUEUE_TIMEOUT_MS

Essa propriedade é uma configuração global que especifica o intervalo de tempo limite (em milissegundos) que uma consulta aguarda na fila para obter uma conexão.

Se o pool de conexões da fonte de dados de destino atingir sua capacidade máxima, as consultas ficarão na fila e aguardarão o retorno de uma conexão ao pool antes de falhar.

O valor máximo padrão para o intervalo de tempo é 600.000 milissegundos (ou 10 minutos).

MAX_POOLSIZES

Essa propriedade é uma configuração global que especifica o tamanho máximo do pool de conexões intranode.

O mecanismo permite a criação do número especificado de conexões entre quaisquer dois agentes, incluindo AdminNode, FMP, QPEndpoints e agentes remotos. Os agentes remotos adicionados por meio do uso de DEFINEGATEWAYS não estão incluídos.

O valor padrão para o número máximo de conexões intranode é 20.

Use essa propriedade para resolver consultas simultâneas lentas ou com falha em Data Virtualization.

MAX_QUERY_STATS_MAP_QUEUE_SIZE Acompanhe o desempenho recente da consulta para aprimorar a otimização da consulta usando essa propriedade para controlar o número máximo de chamadas retidas para cada instância de instrução SQL. Quando o limite especificado é atingido, a entrada usada menos recentemente é removida para adicionar a nova instrução.

O valor-padrão é 100. A definição desse valor como zero desativa a coleta de estatísticas.

MIN_DS_JDBC_CONNECTION_TIMEOUT_MS Reduzir atrasos prolongados no acesso aos dados pela primeira vez durante uma sessão. Use essa propriedade para definir o intervalo de tempo limite (em milissegundos) para estabelecer a primeira conexão com uma fonte de dados.

O valor padrão é 60000 (um minuto).

MIN_DS_POOLSIZES

Essa propriedade é uma configuração global que especifica o tamanho mínimo do pool de conexões para gateways e fontes de dados definidos.

O mecanismo preenche previamente e mantém o número especificado de conexões enquanto a fonte de dados está ativa.

O valor padrão para o tamanho mínimo do pool de conexões é dois.

MIN_POOLSIZES

Essa propriedade é uma configuração global que especifica o tamanho mínimo do pool de conexões intranode.

O mecanismo preenche previamente e mantém o número especificado de conexões entre quaisquer dois agentes, incluindo AdminNode, FMP, QPEndpoints e agentes remotos. Os agentes remotos adicionados por meio do uso de DEFINEGATEWAYS não estão incluídos.

O valor padrão para o tamanho mínimo do pool de conexões intranode é cinco.

NUMTABSREMOTE_MODE Essa propriedade pode melhorar o desempenho da resolução do número de tabelas em uma fonte de dados remota. Você pode optar por listar o número total de tabelas na página Fontes de dados usando uma consulta personalizada ou a API getTables no tipo de fonte ou no nível do Identificador de conexão (CID).
  • Liste as tabelas no tipo de origem substituindo os parâmetros e executando esse procedimento armazenado:
    call dvsys.SETCONFIGPROPERTY('NUMTABSREMOTE_MODE_<source type>', '<mode>,'<qpendpoint>', ?, ?)
    • Substitua <source_type> pela fonte (ou seja, DB2, ORACLE, HIVE e assim por diante).
    • Substitua <mode> por QUERY para usar uma consulta personalizada ou API para usar a API getTables.
    • Substitua <qpendpoint> pelo endpoint do queryplex. Por exemplo: qpendpoint_1:6415.

  • Liste as tabelas no nível do CID substituindo os parâmetros e executando esse procedimento armazenado:
    call dvsys.SETCONFIGPROPERTY('NUMTABSREMOTE_MODE_<CID>', '<mode>,'<qpendpoint>', ?, ?)
    • Substitua <CID> pelo identificador de conexão. O CID pode ser encontrado na página Fontes de dados, em Dados > Data virtualization.
    • Substitua <mode> por QUERY para usar uma consulta personalizada ou API para usar a API getTables.
    • Substitua <qpendpoint> pelo endpoint do queryplex. Por exemplo: qpendpoint_1:6415.
QUERY_STATS_MAP_NUM_QUEUES Identifique padrões de consulta usando essa propriedade para determinar o número de instruções SQL distintas para as quais as estatísticas de consulta são mantidas.

A definição dessa propriedade como zero desativa a coleta de estatísticas.

RDB_CONNECTION_IDLE_DEACTIVATE_TIMEOUT_SEC

Essa propriedade é uma configuração global que especifica o intervalo de tempo (em segundos) após o qual uma fonte de dados ociosa é desativada.

A desativação de uma fonte de dados inativa fecha todas as conexões restantes e altera o status da fonte de dados para Inativo na página Fontes de dados.

O intervalo de tempo padrão é de 120 segundos (dois minutos).

RDB_CONNECTION_IDLE_SHRINK_TIMEOUT_SEC

Essa propriedade é uma configuração global que especifica o intervalo de tempo (em segundos) após o qual uma conexão ociosa é fechada e descartada do pool. A conexão permanece descartada até que o tamanho do pool seja maior que o valor especificado na propriedade MIN_DS_POOLSIZES. Depois disso, a conexão é fechada quando o tempo limite de desativação é atingido.

O valor padrão do intervalo de tempo é 20 segundos.

Use essa propriedade para contornar o problema A consulta falha devido ao encerramento inesperado da conexão com a fonte de dados.

RELOADTABLES_ALLCOLS_<CID>
Use essa propriedade para especificar filtros na recuperação de nomes de colunas para uma fonte específica.
  • Substitua <CID> pelo identificador exclusivo da conexão da fonte de dados.

Use essa propriedade para resolver o problema Acelere o carregamento de tabelas ao virtualizar em Data Virtualization.

RELOADTABLES_ALLTABS_<CID>
Use essa propriedade para especificar filtros na recuperação de nomes de tabelas para uma fonte específica.
  • Substitua <CID> pelo identificador exclusivo da conexão da fonte de dados.

Use essa propriedade para resolver o problema Acelere o carregamento de tabelas ao virtualizar em Data Virtualization.

RELOADTABLES_SCHEMAS_REVEALED_<CID>
Use essa propriedade para especificar a lista de esquemas a serem revelados que, de outra forma, seriam excluídos por padrão.
  • Substitua <CID> pelo identificador exclusivo da conexão da fonte de dados.

Para obter mais informações, consulte Revelar tabelas ocultas ao virtualizar em Data Virtualization.

SETRDBC_NON_RDBMS_CONNECTION_TIMEOUT_MS Evite atrasos prolongados ao se conectar a mapas de esquemas. Use essa propriedade para especificar o intervalo de tempo limite (em milissegundos) para estabelecer conexões com mapas de esquemas.

O valor padrão é um.

SOURCE_CATALOG_API_CACHED_FOREGROUND_TIMEOUT_MS Use automaticamente os valores em cache durante as consultas ao catálogo para melhorar os tempos de resposta das fontes de dados lentas. Use essa propriedade para definir o intervalo de tempo limite (em milissegundos) antes que o Data Virtualization use como padrão um valor armazenado em cache para a API NUMTABSREMOTE .

O valor padrão é 5000 ms (cinco segundos).

SOURCE_CATALOG_API_FOREGROUND_TIMEOUT_MS Evite tempos de espera prolongados devido a fontes de dados que não respondem. Use essa propriedade para definir o intervalo de tempo limite (em milissegundos) antes que o Data Virtualization retorne um resultado vazio para as chamadas à API do catálogo de origem, incluindo LISTSCHEMAS e LISTTABLES.

O valor padrão é 30.000 ms (30 segundos).

SOURCE_CATALOG_API_MAX_CONCURRENCY Equilibrar o desempenho do sistema com restrições de recursos durante cenários de alta carga. Use essa propriedade para definir o número máximo de threads de conexão simultâneos permitidos para a execução de APIs do sistema, incluindo LISTSCHEMAS e LISTTABLES em uma fonte de dados.

O valor padrão é quatro.

TRANSACTION_ISOLATION_LEVEL Escolha o nível de isolamento adequado com base nas necessidades de um aplicativo. Use essa propriedade para definir o nível de isolamento de transação usado para consultas que são executadas em fontes de dados.

O valor padrão é UR (leitura não comprometida). Para obter mais informações, consulte Níveis de isolamento.