添加连接
执行以下步骤创建数据库连接:
- 在主菜单中选择“文件 > 新建连接”,或
单击工具栏上的或按“Ctrl+N”连接到数据库服务器,弹出“新建/选择数据库连接”对话框。
建立连接时,如果首选项文件损坏或首选项值无效,会显示如下错误信息,提示用户首选项值无效,并恢复默认值。单击“确定”完成建立新数据库连接的操作
- 该连接对话框的左侧列表中显示已有连接信息和服务器信息。
服务器信息在连接成功后方可显示。
- 双击连接名称,可自动填充“名称”、“主机名”和“端口号”等连接参数。
如果任何现有连接信息的密码或密钥损坏,那么无论使用哪个连接,均需要手动填写连接密码。
- 若单击,在数据库不同连接状态下会出现不同提示信息:
- 如果数据库连接已激活,会弹出“确认删除连接”对话框。单击“是”断开所有数据库连接。
- 如果数据库连接未激活,会弹出“删除连接”对话框。
- 如果未选择连接名,直接单击,会显示对话框,提示用户至少选择一条连接信息。
- 设置如下参数,创建数据库连接:
- 单击“清除”可清除“创建数据库连接”对话框中的所有字段。
- 使用快捷键(Ctrl+V)在“新建/选择数据库连接”窗口中粘贴数据。Data Studio的对话框中无法使用右键菜单选项。
字段名称
说明
举例
数据库类型
数据库类型
-
名称
连接名称
My_Connection_DB
主机
主机IP地址(IPv4)或数据库域名
说明:- 如果域名长度大于25个字符,则域名将不会完整显示。
例如:test1(db.dws…com:25xxx)
- 一旦建立连接,将鼠标悬停在连接名称上将显示服务器IP地址和版本。
- 如果此字段中的条目含有带三个分隔符(.)的数字格式,则该条目会被视为IP地址。不符合该格式的条目会被视为域名。
- 域名必须满足以下条件:
- 以字母开头。
- 可包含字母、数字、连字符(-)和英文句点(.)。不允许出现其他任何特殊字符。
- 不得出现空格或制表符。
- 长度不能超过253个字符,在两个句点之间最多可出现63个字符。
db.dws.mycloud.com
10.xx.xx.xx
端口号
端口地址
8000
数据库
数据库名称。
gaussdb
用户名
连接所选数据库的用户名
-
密码
连接数据库的用户名密码。此密码文本以掩码显示。
-
- 从“保存密码”中选择一个选项。可选项包括:
- “永久保存”:退出数据库后仍然保存密码。首次建立连接时,此选项将不可用。要隐藏或查看该下拉选项,请参见“密码”小节。
- “仅当前会话”:仅在当前会话中保存密码。
- “不保存”:不保存密码。如果选择该选项,Data Studio会在用户进行如下操作时要求输入密码:
- “启用SSL”默认选中。
- 执行以下步骤启用SSL:
- 选中“启用SSL”。
- 单击“SSL”页签。
- 设置以下信息,提供以下文件以使用安全连接。请参见SSL证书。
- 选择“客户端SSL证书”,单击,选择客户端SSL证书。
- 选择“客户端SSL密钥”,单击并选择客户端SSL密钥。
- 如需选择“根证书”,单击并选择根证书。
- 可从“SSL模式”中选择SSL模式。有关各模式的详情,请参见下表。
- 如果将“SSL模式”设为verify-ca或verify-full,则必须选择根证书。
- Data Studio首次访问gs-dump特性时,会弹框要求输入客户端秘钥。
SSL模式
说明
require
如果选择require,则不会验证证书有效性,因为所使用的SSL factory无需验证。
verify-ca
如果选择verify-ca,则会使用相应的SSL factory检查CA是否正确。
verify-full
如果选择verify-full,则会使用相应的SSL factory检查CA和数据库是否正确。
- 按照以下步骤设置“快速加载选项”:
- 单击“高级”选项卡。
- 建立连接时,在“包含”字段中输入模式名称(使用逗号作为分隔符),以优先加载这些选项。
- 建立连接时,在“不包含”字段中输入模式名称,以避免优先加载这些选项。
- 为“加载对象”选择以下任意一个值:
- “所有对象”:加载所有对象。
- “用户权限范围内的对象”:仅加载用户有权访问的对象。请参阅表1查看对象浏览器中列出的对象所需的最低访问权限。
默认选择“用户权限范围内的对象”。
- 在“加载上限”字段中输入加载限制。允许的最大值为30,000。该值为数据库对象个数。
- 如果“包含”字段中输入的模式中对象类型(表、视图等)的数量大于“加载上限”中的值,则将只加载该模式的父对象。这意味着含有大于3个参数的列、约束、索引、函数等子对象将不会被加载。
- 对“包含”和“不包含”列表中提供的模式名称进行验证。
- 如果无法访问“包含”字段中指定的模式,则连接期间会显示该模式的错误消息。
- 如果无法访问“不包含”字段中指定的模式,则建立连接后,模式不会在“对象浏览器”中加载。
- 单击“高级”选项卡。
- 单击“确定”建立连接。
状态栏显示已完成操作的状态。
Data Studio连接数据库时,状态栏显示连接状态,如下图所示:
一旦建立连接,“对象浏览器”窗格中会显示所有模式。
懒加载
懒加载功能仅在用户有需要时加载对象。
连接到数据库时,仅加载search_path路径下保存的模式子对象,如下所示:
未加载的模式显示为“模式名(…)”。
要加载子对象,请展开模式。模式展开时,会显示模式下的对象正在加载中:
如果有对象正在加载,且用户尝试加载未加载的对象,则会弹出消息告知用户有对象正在加载中。未加载对象旁的会消失。如要加载该对象,在对象或数据库级别进行刷新,该按钮会重新显示。
展开模式来加载和查看子对象。“对象浏览器”一次只能加载一个模式下的子对象。
如果建立连接后修改了search_path,该修改在重新连接数据库后才会生效。自动建议适用于用户有权访问的所有模式对象的关键字、数据类型、模式名称、表名称、视图和表别名。
“对象浏览器”窗格1分钟内最多可加载50000个对象。
数据库连接超时时间默认为3分钟(180秒)。如果在此时间段内未能连接成功,会显示超时错误。
可以在Data Studio.ini文件中设置loginTimeout。该文件的路径为Data Studio\Data Studio.ini。
当用户登录Data Studio时,系统会自动加载pg_catalog。