连接管理

添加连接

1. 在主菜单中选择“文件 > 新建连接”，或单击工具栏上的“新建连接”按钮连接到数据库服务器，弹出“新建/选择数据库连接”对话框。

   

2. “新建/选择数据库连接”对话框的左侧列表中显示已有连接信息和服务器信息。

   双击连接名称，可自动填充“名称”、“主机名”和“端口号”等连接参数。

   

   如果任何现有连接信息的密码或密钥损坏，那么无论使用哪个连接，均需要手动填写连接密码

3. 设置如下参数，创建数据库连接：

   表1 数据库连接信息

   字段名称	说明	举例
   数据库类型	数据库类型	-
   名称	连接名称	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
   用户名	连接所选数据库的用户名	-
   密码	连接数据库的用户名密码。此密码文本以掩码显示。	-
   保存密码	“仅当前会话”：仅在当前会话中保存密码。 “不保存”：不保存密码。	-

   

   • 单击“清除”可清除“创建数据库连接”对话框中的所有字段。
   • 使用快捷键（Ctrl+V）在“新建/选择数据库连接”窗口中粘贴数据。Data Studio的对话框中无法使用右键菜单选项。

4. 选中“启用SSL”，单击“SSL”页签设置SSL证书选项，详情请参见配置SSL连接。
   图1 配置SSL参数
   

5. 按照以下步骤设置“快速加载选项”：
   单击“高级”选项卡进入配置页面。

   图2 配置快速加载选项
   
   • 在“包含”字段中输入模式名称（使用逗号作为分隔符），以优先加载这些选项。
   • 在“不包含”字段中输入模式名称，以避免优先加载这些选项。
   • 为“加载对象”选择以下任意一个值：
     • “所有对象”：加载所有对象。
     • “用户权限范围内的对象”：仅加载用户有权访问的对象。请参阅表2查看对象浏览器中列出的对象所需的最低访问权限。
     

     默认选择“用户权限范围内的对象”。

   • 在“加载上限”字段中输入加载限制。允许的最大值为30,000。该值为数据库对象个数。
     

     • 如果“包含”字段中输入的模式中对象类型（表、视图等）的数量大于“加载上限”中的值，则将只加载该模式的父对象。这意味着含有大于3个参数的列、约束、索引、函数等子对象将不会被加载。
     • 对“包含”和“不包含”列表中提供的模式名称进行验证。

     • 如果无法访问“包含”字段中指定的模式，则连接期间会显示该模式的错误消息。
     • 如果无法访问“不包含”字段中指定的模式，则建立连接后，模式不会在“对象浏览器”中加载。

6. 单击“确定”建立连接。

   状态栏显示已完成操作的状态。

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

   

   一旦建立连接，“对象浏览器”窗格中会显示所有模式。

   

   • 密码失效的情况下也可登录Data Studio，但系统会提示某些操作可能无法正常工作。可参阅表1更改设置。
   • Postgres模式名不在“对象浏览器"窗格显示。

重命名连接

1. 在“对象浏览器”窗格中，右键单击连接名称，然后选择“重命名连接”。

   工具会显示“重命名连接”对话框，提示您输入新的连接名称。

2. 输入新的连接名称。单击“确定”重命名连接。
   状态栏显示已完成操作的状态。

   

   新的连接名称必须唯一，否则重命名操作将失败。

编辑连接

1. 在“对象浏览器”窗格中，右键单击连接名称，然后选择“编辑连接”。弹出“编辑连接”对话框。

   若要编辑活跃连接，需要先关闭该连接，然后重新打开设置了新属性的连接。工具会显示连接重置警告。

2. 编辑连接参数。有关参数详情，请参见表1。
   

   数据库类型和名称字段不支持修改。

3. 单击“确定”保存更新后的连接信息。
   

   • 可单击“清除”清除“编辑连接”对话框中的所有字段。
   • 如果未修改任何连接参数就单击“确定”，会显示对话框，提示用户未保存更改。在修改连接参数后，会显示对话框消息。

4. 如果未启用SSL，工具会显示“连接安全告警”对话框。单击“继续”以继续使用不安全的连接，或单击“取消”返回到“编辑连接”对话框并启用SSL。

   如果勾选“不再显示”字段，当前登录的Data Studio实例在后续连接时，不再显示“连接安全告警”对话框。

   工具会显示“确认删除连接”对话框，询问用户是否确认删除已编辑连接的数据库。

5. 单击“是”继续更新连接信息，并重新连接到已更新参数的连接。

   状态栏显示已完成操作的状态。

删除连接

1. 右键单击连接名称，选择“删除连接”删除该连接。

   Data Studio弹出确认对话框。

2. 单击“是”删除服务器连接。

   状态栏显示已完成操作的状态。

   此操作将从“对象浏览器”中删除与当前服务器的连接。任何未保存的数据将会丢失。

刷新连接数据

1. 在“对象浏览器”窗格中，右键单击连接名称并选择“刷新”，或按“F5”刷新数据库，刷新整个连接。在刷新的过程中，整个连接将更新为服务器上的最新内容。

   状态栏显示已完成操作的状态。

• 完成刷新数据库所需时间完全取决于数据库中存在的对象数量。因此，建议在大规模数据库中尽量在空闲时间段执行此操作。
• 如果刷新整个数据库或连接，search_path中模式下的所有子对象和用户已展开的模式会重新加载。
• 如果重新连接数据库，仅会加载search_path中保存的模式对象。先前展开的对象不会加载。
• 不能同时刷新数据库及其下的多个对象。

查看连接属性

1. 右键单击连接，选择“属性”。

   状态栏显示已完成操作的状态。

   Data Studio显示所选连接的属性。

   

   如果为已创建的连接修改了属性，则需要再次打开连接方可查看更新后的属性。