SETCONFIGPROPERTY 属性

有关 "SETCONFIGPROPERTY属性的列表，请参阅此索引。

下表是所有 SETCONFIGPROPERTY 属性的索引。 Data Virtualization

属性名称 解释
BATCHSIZE_FOR_LISTSCHEMAS_OR_LISTTABLES 此属性指定通过 和 LISTTABLES LISTSCHEMAS API 检索的架构或表的最大数量。 默认为 10000。 该属性必须设置为 REMOTENODE。

请参阅 LISTSCHEMAS 和 LISTTABLES。
COLLECT_FETCHPHASE_WARNINGS 使用此参数可以启用或禁用获取阶段警告。

更多信息，请参阅 Data Virtualization 中的启用和禁用获取阶段警告和错误。
CONNECTION_DETAILS_CACHE_SIZE 缓存证书，以提高响应时间的性能。 使用此属性可定义缓存中保留的凭证请求数量。 该缓存可为请求相同数据源详细信息的多个线程提供共享的预计算凭据。

缺省值为 100。 将此值设置为零或更低，则禁用缓存。
CONNECTION_DETAILS_REFRESH_SEC 使用此属性设置刷新间隔（秒），以检索由 Platform 连接等外部组件维护的连接详细信息，从而保持凭证最新。 该属性还可控制在凭证已更新的情况下发送请求以检索凭证的频率。

缺省值为 600（10 分钟）。 将此值设为较低的数字（如 5）可能会导致 Platform 连接服务反应迟钝。
CONNECTION_DETAILS_REQUEST_TIMEOUT_MS 当您在配置了存储在保管库中的凭据的远程代理上添加或使用数据源时，您可能会看到Failed to update connection details错误。 要解决此问题，您可以使用此属性来增加超时值。

有关更多信息，请参阅 Data Virtualization 中的 "添加具有保管凭证的远程数据源失败"。
DATASOURCE_MAX_BINARY_SIZE和<SRCTYPE>"_MAX_BINARY_SIZE"和<CID>_MAX_BINARY_SIZE 使用 "DATASOURCE_MAX_BINARY_SIZE属性，可在代理级进行列表、预览或虚拟化操作时，为远程源表中的无限制二进制类型设置最大列大小（以字节为单位），从而提高 SQL 性能。

您可以通过使用属性<SRCTYPE>_MAX_STRING_SIZE 来覆盖'DATASOURCE_MAX_BINARY_SIZE，以对所有给定类型的数据源连接进行限制。
  • 将<SRCTYPE>替换为源名称。 例如，Hive数据源为 "HIVE_MAX_BINARY_SIZE。
通过使用属性 "<CID"_MAX_BINARY_SIZE，您可以在单个连接级别覆盖 "<SRCTYPE>"_MAX_BINARY_SIZE。
  • 将<CID>替换为数据源连接的唯一标识符。

这些属性的默认大小为 32672，以确保在对包含这些属性的虚拟表进行查询时，谓词能高效推送。 缩小默认大小，进一步提高性能和效率。
DATASOURCE_MAX_STRING_SIZE和<SRCTYPE>"_MAX_STRING_SIZE"和<CID>_MAX_STRING_SIZE 使用 "DATASOURCE_MAX_STRING_SIZE属性，可在列表、预览或虚拟化操作期间，为远程源表中的无限制字符串类型设置最大列大小（以字节为单位），从而提高 SQL 性能。

您可以通过使用属性<SRCTYPE>_MAX_STRING_SIZE 来覆盖'DATASOURCE_MAX_STRING_SIZE，以对所有给定类型的数据源连接进行限制。
  • 将<SRCTYPE>替换为源名称。 例如，Hive数据源为 "HIVE_MAX_STRING_SIZE。
通过使用属性 "<CID"_MAX_STRING_SIZE，您可以在单个连接级别覆盖 "<SRCTYPE>"_MAX_STRING_SIZE。
  • 将<CID>替换为数据源连接的唯一标识符。

这些属性的默认大小为 32672，以确保在对包含这些属性的虚拟表进行查询时，谓词能高效推送。 缩小默认大小，进一步提高性能和效率。
FETCH_BUFFER_SIZE 最大限度地缩短数据传输过程中的网络等待时间，从而提高查询性能。 使用此属性可指定Data Virtualization代理在获取查询结果时缓冲的批次行数。

缺省值为 100。 最小值为 20。

注意：可以将此属性减小到 20，以防止在高并发情况下（如 4 Kb）出现内存使用过度错误，而不会对性能产生负面影响。
GAIAN_CONNECTIONS_CHECKER_HEARTBEAT_MS 当您配置数据源连接以Data Virtualization并且连接失败，请使用此属性来增加超时参数值。

有关更多信息，请参阅 Data Virtualization 中的 "无法连接到数据源 "。
LISTSCHEMAS_MODE 该属性可让您提高模式列表的性能。 您可以选择使用自定义查询或源类型或连接标识符（CID）级别的 "getSchemas应用程序接口，在 "探索 "视图中列出模式总数。
  • 通过替换参数并运行此存储过程，列出源类型的模式：
    call dvsys.SETCONFIGPROPERTY('LISTSCHEMAS_MODE_<source_type>', '<mode>,'<qpendpoint>', ?, ?)
    • 将<source_type>替换为源代码（即 "DB2、"ORACLE、"HIVE等）。
    • Replace <模式 with QUERY to use a custom query, or API to use the getSchemas API.
    • 将<qpendpoint>替换为 queryplex 端点。 例如：qpendpoint_1:6415。

  • 通过替换参数并运行存储过程，在 CID 层列出模式：
    call dvsys.SETCONFIGPROPERTY('LISTSCHEMAS_MODE_<CID>', '<mode>,'<qpendpoint>', ?, ?)
    • 将<CID>替换为连接标识符。 CID 可在数据源页面的数据 > Data virtualization 中找到。
    • Replace <模式 with QUERY to use a custom query, or API to use the getSchemas API.
    • 将<qpendpoint>替换为 queryplex 端点。 例如：qpendpoint_1:6415。
LOGFILE_MAX_SIZE_MB 管理日志文件大小，确保有效利用磁盘空间。 使用此属性可定义每个Data Virtualization代理维护和存储的每个旋转日志文件的最大大小（单位：兆字节）。

缺省值为 100。 所需的最小值为 1。
LOGLEVEL

设置所有节点的日志级别。

日志级别设置包括以下选项：
  • 无
  • LESS（默认设置）
  • 更多（调试级别日志记录）
  • 全部（调试级别日志记录）
MAX_DS_JDBC_CONNECTION_TIMEOUT_MS 使用此属性可设置与已有活动连接的数据源建立连接的超时（以毫秒为单位），从而减少与数据源的慢速连接所造成的停机时间。

默认值为 120000（2 分钟）。 最小值应根据连接最慢数据源所需的时间来设置。 将该值设为零可能会导致连接失败。
MAX_DS_POOLSIZES

此属性是一个全局设置，用于指定定义的网关和数据源的最大连接池大小。

该引擎允许创建指定数量的连接。

最大连接池大小的默认值为 10。

使用此属性可解决并发查询速度慢或在 Data Virtualization 中失败的问题。
MAX_INBOUND_CONNECTION_THREADS 使用此属性指定底层 Derby 数据库允许的最大传入连接数，以确保在大量使用时性能稳定。

缺省值为 1000。 降低该值可能会减少内存消耗，但会对性能产生负面影响。
MAX_JDBC_CONNECTION_QUEUE_TIMEOUT_MS

该属性是一个全局设置，用于指定查询在队列中等待连接的超时时间间隔（以毫秒为单位）。

如果目标数据源的连接池达到其最大容量，则查询队列并等待连接在失败之前返回池。

时间间隔的默认最大值为 600,000 毫秒（或 10 分钟）。
MAX_POOLSIZES

此属性是一个全局设置，指定最大节点内连接池大小。

该引擎允许在任意两个代理之间创建指定数量的连接，包括AdminNode, FMP、QPEndpoints 和远程代理。 不包括使用 DEFINEGATEWAYS 添加的远程代理。

节点内连接的最大数量默认值为 20。

使用此属性可解决并发查询速度慢或在 Data Virtualization 中失败的问题。
MAX_QUERY_STATS_MAP_QUEUE_SIZE 使用此属性控制每个 SQL 语句实例所保留的最大调用次数，从而跟踪最近的查询性能，加强查询优化。 当达到指定限制时，将删除最近使用最少的条目，以添加新语句。

缺省值为 100。 将此值设为零将禁用统计数据收集功能。
MIN_DS_JDBC_CONNECTION_TIMEOUT_MS 减少会话期间首次访问数据时的长时间延迟。 使用此属性可定义与数据源建立首次连接的超时时间间隔（以毫秒为单位）。

默认值为 60000（一分钟）。
MIN_DS_POOLSIZES

此属性是一个全局设置，用于指定定义的网关和数据源的最小连接池大小。

当数据源处于活动状态时，引擎会预先填充并维护指定数量的连接。

最小连接池大小的默认值为 2。
MIN_POOLSIZES

此属性是一个全局设置，指定最小节点内连接池大小。

引擎会预先填充并维护任意两个代理之间的指定数量的连接，包括AdminNode, FMP、QPEndpoints 和远程代理。 不包括使用 DEFINEGATEWAYS 添加的远程代理。

节点内最小连接池大小的默认值为五。
NUMTABSREMOTE_MODE 该属性可提高解析远程数据源中表数量的性能。 You can choose to list the total number of tables in the 数据来源 page by using a custom query or the getTables API at the source type or the Connection Identifier (CID) level.
  • 通过替换参数并运行此存储过程，列出源类型的表格：
    call dvsys.SETCONFIGPROPERTY('NUMTABSREMOTE_MODE_<source type>', '<mode>,'<qpendpoint>', ?, ?)
    • 将<source_type>替换为源代码（即 "DB2、"ORACLE、"HIVE等）。
    • Replace <模式 with QUERY to use a custom query, or API to use the getTables API.
    • 将<qpendpoint>替换为 queryplex 端点。 例如：qpendpoint_1:6415。

  • 通过替换参数并运行此存储过程，在 CID 级别列出表格：
    call dvsys.SETCONFIGPROPERTY('NUMTABSREMOTE_MODE_<CID>', '<mode>,'<qpendpoint>', ?, ?)
    • 将<CID>替换为连接标识符。 CID 可在数据源页面的数据 > Data virtualization 中找到。
    • Replace <模式 with QUERY to use a custom query, or API to use the getTables API.
    • 将<qpendpoint>替换为 queryplex 端点。 例如：qpendpoint_1:6415。
QUERY_STATS_MAP_NUM_QUEUES 使用此属性确定保留查询统计信息的不同 SQL 语句的数量，从而识别查询模式。

将此属性设置为零将禁用统计数据收集功能。
RDB_CONNECTION_IDLE_DEACTIVATE_TIMEOUT_SEC

该属性是一个全局设置，用于指定闲置数据源停用的时间间隔（以秒为单位）。

停用空闲数据源将关闭所有剩余连接，并将数据源状态更改为闲置的在数据源页。

默认时间间隔为 120 秒（两分钟）。
RDB_CONNECTION_IDLE_SHRINK_TIMEOUT_SEC

此属性为全局设置，用于指定闲置连接关闭并从池中删除的时间间隔（以秒为单位）。 连接将保持断开状态，直到池大小大于 MIN_DS_POOLSIZES 属性中指定的值为止。 此后，当达到停用超时时，连接将关闭。

时间间隔的默认值为 20 秒。

使用此属性可解决因意外关闭数据源连接而导致查询失败的问题。
RELOADTABLES_ALLCOLS_<来电显示>
使用此属性可指定特定来源的列名检索过滤器。
  • 对于使用通配符的架构、表或列，请确保使用两个反斜杠（\）转义通配符。例如：架构名称 gosales_1021 应为 gosales\\_1021。
  • 将<CID>替换为数据源连接的唯一标识符。

使用此属性可解决在虚拟化环境中加速表格加载 Data Virtualization 的问题。
RELOADTABLES_ALLTABS_<来电显示>
使用此属性可指定特定源的表名检索过滤器。
  • 对于使用通配符的架构、表或列，请确保使用两个反斜杠（\）转义通配符。例如：架构名称 gosales_1021 应为 gosales\\_1021。
  • 将<CID>替换为数据源连接的唯一标识符。

使用此属性可解决在虚拟化环境中加速表格加载 Data Virtualization 的问题。
RELOADTABLES_SCHEMAS_REVEALED_<来电显示>
使用此属性可指定要显示的模式列表，否则默认情况下将排除在外。
  • 将<CID>替换为数据源连接的唯一标识符。

有关详细信息，请参阅 《在 Data Virtualization 中虚拟化时显示隐藏表 》。
SETRDBC_NON_RDBMS_CONNECTION_TIMEOUT_MS 连接模式映射时避免长时间延迟。 使用此属性可指定与模式映射建立连接的超时间隔（毫秒）。

默认值为 1。
SOURCE_CATALOG_API_CACHED_FOREGROUND_TIMEOUT_MS 在目录查询过程中自动使用缓存值，以提高慢速数据源的响应速度。 使用此属性可定义Data Virtualization默认使用 "NUMTABSREMOTEAPI 缓存值之前的超时时间间隔（以毫秒为单位）。

默认值为 5000 毫秒（5 秒）。
SOURCE_CATALOG_API_FOREGROUND_TIMEOUT_MS 避免因数据源反应迟钝而延长等待时间。 使用此属性可定义Data Virtualization为源目录 API 调用（包括 "LISTSCHEMAS和 "LISTTABLES）返回空结果前的超时间隔（以毫秒为单位）。

默认值为 30,000 毫秒（30 秒）。
SOURCE_CATALOG_API_MAX_CONCURRENCY 在高负载情况下，平衡系统性能与资源限制。 使用此属性可定义在数据源上运行系统 API（包括 "LISTSCHEMAS和 "LISTTABLES）时允许的最大并发连接线程数。

默认值为 4。
TRANSACTION_ISOLATION_LEVEL 根据应用程序的需要选择适当的隔离级别。 使用此属性可定义在数据源上运行的查询所使用的事务隔离级别。

默认值为 UR（未提交读取）。 有关更多信息，请参阅隔离级别。