更新时间:2024-04-28 GMT+08:00

配置Data Studio

本节介绍使用Data Studio时要遵循的配置步骤,以及配置服务器以调试PL/SQL函数的步骤。

配置Data Studio

通过Data Studio.ini文件来配置Data Studio:

参数如有修改,需重新启动Data Studio方可查看。配置文件中添加的无效参数会被Data Studio忽略。

下表为Data Studio相关的配置参数(可选参数)列表。

表1 配置参数

参数

说明

取值范围

默认值

-startup

加载Data Studio所需的.jar文件。各版本所需的文件不同。

不适用

plugins/org.eclipse.equinox.launcher_1.3.100.v20150511-1540.jar

--launcher.library

加载Data Studio所需的库。各版本所需的库不同。

不适用

取决于所使用安装包,可能为plugins/org.eclipse.equinox.launcher.win32.win32.x86_1.1.300.v20150602-1417plugins/org.eclipse.equinox.launcher.win32.win32.x86_64_1.1.300.v20150602-1417

-clearPersistedState

删除当前用户界面上的所有缓存内容,重新加载Data Studio。

不适用

不适用

说明:

建议增加该参数。

-consoleLineCount

“消息”窗口显示的最大行数。

1-5000

1000

-logfolder

创建日志文件夹。用户可指定日志文件的保存路径,如果使用默认值“.”,则在Data Studio\User data\<用户名>\logs创建文件夹。有关详情,请参见“设置日志文件创建位置”。

不适用

-

-loginTimeout

定义创建连接的等待时间,单位为秒。在该参数指定的时长内,Data Studio会不断尝试连接数据库。如果超时,会提示超时或连接失败。

不适用

180

-data

会话的实例数据位置。

不适用

@none

@user.home/MyAppWorkspace

启动Data Studio时,在此位置创建Eclipse工作区。

其中,@user.home指的是C:/Users/<username>路径。

Eclipse日志文件保存在以下位置:

@user.home/MyAppWorkspace/.metadata

不适用

不适用

-detailLogging

日志记录错误消息。如果设为True,则日志记录所有错误消息。如果设为False,则日志仅记录Data Studio中明确指定的错误消息。有关详情,请参见“控制故障和错误日志”。

默认情况下不添加此参数,如需记录日志,可以手动设置此参数。

True/False

False

-logginglevel

基于指定的值创建日志文件。如果该值设为取值范围外的任意值或为空,则使用默认值WARN。有关详情,请参见“不同日志级别类型”。

默认情况下不添加此参数,如需记录日志,可以手动设置此参数。

FATAL、 ERROR、WARN、INFO、DEBUG TRACE、ALL和OFF

WARN

-focusOnFirstResult

自动定位“结果”页签。

如果设为false,则自动定位到最新打开的“结果”页签。

如果设为true,则禁用自动定位功能。

True/False

False

说明:
  • 以上所有参数必须配置在-vmargs参数之前。
  • -startup和--launcher.library参数必须分别配置为第一和第二个参数。

-vmargs

虚拟机参数的起始位置。

说明:

-vmargs参数必须配置于配置文件的末尾。

不适用

不适用

-vm

<file name (javaw.exe) with relative path to Java executable>

定义文件名(javaw.exe)和Java的相对路径。

不适用

不适用

-Dosgi.requiredJavaVersion

运行Data Studio所需的最低Java版本。请勿修改该参数值。

不适用

1.5

说明:

推荐的Java版本为1.8.0_141。

-Xms

Data Studio消耗的初始堆空间。该值必须是1024的倍数,大于40 MB,且小于或等于-Xmx。在值的末尾加上字母k或K可表示千字节,加上m或M表示可表示兆字节,g或G可表示千兆字节。例如:

-Xms40m

-Xms120m

有关详情,请参见Java文档。

不适用

-Xms40m

-Xmx

Data Studio消耗的最大堆空间。可根据可用的RAM空间调整该值。在值的末尾加上字母k或K可表示千字节,加上m或M表示可表示兆字节,g或G可表示千兆字节。例如:

-Xmx1200m

-Xmx1000m

有关详情,请参见Java文档。

不适用

-Xmx1200m

-OLTPVersionOldST

用于用户配置老版本的OLTP版本,用户可以通过登录gsql,运行SELECT VERSION(),将获取到的版本号更新ini文件中的OLTPVersionOldST参数值。

-

-

-OLTPVersionNewST

用于用户配置新版本的OLTP版本,用户可以通过登录gsql,运行SELECT VERSION(),将获取到的版本号更新ini文件中的OLTPVersionNewST参数值。

-

-

-testability

开启可测试性需求特性。在该版本中,该功能启用后:

  • 用户可使用“Ctrl+空格”快捷键复制最近触发的自动建议操作。
  • 在选择了“包含ANALYZE结果”的场景下,“执行计划和开销”将以树形样式和图形化样式展示。

该参数默认不可用,需手动添加。

True/False

False

-Duser.language

定义Data Studio的语言设置。在语言设置更改后添加此参数。

zh/en

不适用

-Duser.country

定义Data Studio的国家/地区设置。在语言设置更改后添加此参数。

CN/IN

不适用

-Dorg.osgi.framework.bundle.parent=ext

指定boot delegation使用的类加载器。

boot/app/ext

boot

-Dosgi.framework.extensions=org.eclipse.fx.osgi

指定框架扩展名称列表。框架扩展bundle是系统bundle(org.eclipse.osgi)的fragment。作为fragment,用户可以提供使用该框架的其他类。

不适用

不适用

  • 用户不允许修改以下设置:

    Dorg.osgi.framework.bundle.parent=ext

    Dosgi.framework.extensions=org.eclipse.fx.osgi

  • 如果用户收到SocketException : Bad Address: Connect消息:

    则用户需检查客户端是否通过IPv6或IPv4协议建立到服务器的连接。用户还可以根据通过在.ini文件中配置以下参数来建立连接:

    -Djava.net.preferIPv4Stack=true

    -Djava.net.preferIPv6Stack=false

    表2列举支持的通信场景。

    第一行和第一列分别代表尝试通信的不同节点类型,x表示相关节点可以互相通信。

表2 通信场景

节点

仅V4

V4/V6

仅V6

仅V4

x

x

无通信可能

V4/V6

x

x

x

仅V6

无通信可能

x

x

设置日志文件创建位置

  1. 打开Data Studio.ini文件。
  2. 用-logfolder指定日志文件路径。

    例如:

    -logfolder=c:\test1

    示例中,Data Studio.log文件创建在c:\test1\<用户名>\logs路径下。

    如果用户没有Data Studio.ini文件中指定路径的访问权限,则Data Studio会关闭,并弹框显示以下信息。

出现以下情况时,Data Studio.log文件在Data Studio\User Data\<用户名>\logs文件夹中创建:

  • Data Studio.ini文件中没有指定路径。

    例如:-logfolder=.

  • 提供的路径不存在。

有关服务器日志详情,请参见服务器手册。

可使用任何文本编辑器打开并查看Data Studio.log文件。

控制故障和错误日志

基于程序参数控制错误、异常或者throw-able的堆栈运行详情。该参数在Data Studio.ini中配置。

-detailLogging=false

如果标志值为‘true’,错误、异常或者throw-able的堆栈运行详情将记录在日志文件中。

如果标志值为‘false’,错误、异常或者throw-able的堆栈运行详情将不会记录在日志文件中。

日志消息描述

日志消息描述如下图所示:

Data Studio.log文件大小达到最大值10000 KB时,系统会自动创建一个文件并另存为Data Studio.log.1。Data Studio.log中的日志将存储在Data Studio.log.1文件中。当Data Studio.log文件再次达到最大值,系统继续自动创建一个文件并另存为Data Studio.log.2。最新日志持续写入Data Studio.log文件。以此类推,此过程将一直持续,直到Data Studio.log.5文件达到最大值,该循环重新开始。Data Studio将删除最早的日志文件,即Data Studio.log.1。例如,Data Studio.log.5重命名为Data Studio.log.4,Data Studio.log.4重命名为Data Studio.log.3,以此类推。

如需启用服务器日志文件的性能日志记录功能,需启用配置参数log_min_messages,且设置为data/postgresql.conf配置文件中的debug1,即log_min_messages = debug1。

不同日志级别类型

Data Studio.log文件中所显示的不同类型的日志级别如下:

  • TRACE:相比DEBUG级别,TRACE级别提供更为详细的信息。
  • DEBUG:DEBUG级别指粒状信息事件,对调试应用程序最为有用。
  • INFO:INFO级别指着重显示应用进程的消息。
  • WARN:WARN级别指潜在的有害情况。
  • ERROR:ERROR级别指错误事件。
  • FATAL:FATAL级别指事件造成应用终止。
  • ALL:ALL级别指启用所有日志级别。
  • OFF:OFF级别指禁用所有日志级别和ALL级别相反。
    • 如果用户输入无效的日志级别值,日志级别会设置为WARN。
    • 如果用户未指定日志级别,日志级别会设置为WARN。

日志记录会输出高于或等于其日志级别的所有消息。

标准log4j级别的顺序如下:

表3 日志级别

-

FATAL

ERROR

WARN

INFO

DEBUG

TRACE

OFF

x

x

x

x

x

x

FATAL

x

x

x

x

x

ERROR

x

x

x

x

WARN

x

x

x

INFO

x

x

DEBUG

x

TRACE

ALL

√ - 创建日志文件 x- 不创建日志文件