添加连接

执行以下步骤创建数据库连接：

在主菜单中选择“文件 > 新建连接”，或
单击工具栏上的或按“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和数据库是否正确。

选择“客户端SSL证书”和“客户端SSL密钥”，可使用安全连接从Data Studio中导出DDL和数据。
如果为“客户端SSL证书”和“客户端SSL密钥”选择了无效的文件，将导致导出失败。有关详情，请参见故障处理。
如果取消选中“启用SSL”复选框并继续操作，则会弹出“连接安全告警”对话框。要设置是否显示该安全告警，请参见安全免责声明。
- “继续”：单击“继续”，继续使用不安全的连接。
- “取消”：单击“取消”并启用SSL。
- “不再显示”：如果勾选该字段，当前登录的Data Studio实例在后续连接时，不再显示“连接安全告警”对话框。
有关详情，请参见服务器手册。

按照以下步骤设置“快速加载选项”：
1. 单击“高级”选项卡。
2. 建立连接时，在“包含”字段中输入模式名称（使用逗号作为分隔符），以优先加载这些选项。
3. 建立连接时，在“不包含”字段中输入模式名称，以避免优先加载这些选项。
4. 为“加载对象”选择以下任意一个值：
  - “所有对象”：加载所有对象。
  - “用户权限范围内的对象”：仅加载用户有权访问的对象。请参阅表1查看对象浏览器中列出的对象所需的最低访问权限。
  默认选择“用户权限范围内的对象”。
5. 在“加载上限”字段中输入加载限制。允许的最大值为30,000。该值为数据库对象个数。
  - 如果“包含”字段中输入的模式中对象类型（表、视图等）的数量大于“加载上限”中的值，则将只加载该模式的父对象。这意味着含有大于3个参数的列、约束、索引、函数等子对象将不会被加载。
  - 对“包含”和“不包含”列表中提供的模式名称进行验证。
  - 如果无法访问“包含”字段中指定的模式，则连接期间会显示该模式的错误消息。
  - 如果无法访问“不包含”字段中指定的模式，则建立连接后，模式不会在“对象浏览器”中加载。
单击“确定”建立连接。
状态栏显示已完成操作的状态。

Data Studio连接数据库时，状态栏显示连接状态，如下图所示：

一旦建立连接，“对象浏览器”窗格中会显示所有模式。
- 密码失效的情况下您也可登录到Data Studio，但系统会提示您某些操作可能无法正常工作。请参阅密码过期获取详细信息。
- 如要取消连接，请参阅“取消连接”。
- Postgres模式名不在“对象浏览器"窗格显示。