更新时间:2024-07-19 GMT+08:00

连接管理

Data Studio启动后,默认打开“创建数据库连接”对话框。要执行数据库操作,Data Studio需连接至少一个数据库。

输入连接参数,创建Data Studio到数据库服务器的连接。将光标悬停在连接名称上,可查看数据库信息。

添加连接

  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显示所选连接的属性。

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