文档首页 > > 工具指南> Data Studio数据库集成开发工具> 安装配置Data Studio

安装配置Data Studio

分享
更新时间: 2019/08/09 GMT+08:00

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

本章包含如下几节内容:

安装Data Studio

配置Data Studio

设置日志文件创建位置

控制故障和错误日志

日志消息描述

不同日志级别类型

安装Data Studio

抽取安装包后即可运行Data Studio。

执行以下步骤安装Data Studio:

  1. 解压所需软件包(32位或64位),分别放至Program Files或Program Files(x86)文件夹中。如果用户需用其他文件夹,管理员应控制用户对该文件夹的访问权限。

    解压后可以获取如下文件和文件夹:

  2. 定位并双击Data Studio.exe,启动Data Studio客户端。

    说明:

    User Data文件夹在首个用户用Data Studio打开实例后创建。打开Data Studio时,如果出现任何错误,请参见快速入门执行启动操作。

要创建新的数据库连接,请参见添加连接

配置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

不适用

设置日志文件创建位置

  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.1中,Data Studio.log.1中的日志将存储在Data Studio.log.2.中。 最新日志一直被写入Data Studio.log文件内。以此类推,此过程将一直持续,直到Data Studio.log.5创建并达到最大文件大小,该循环重新开始。

说明:

如需启用服务器日志文件的性能日志记录功能,需启用配置参数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级别的顺序如下:

表2 日志级别

-

FATAL

ERROR

WARN

INFO

DEBUG

TRACE

OFF

FATAL

ERROR

WARN

INFO

DEBUG

TRACE

ALL

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

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区