更新时间:2023-03-17 GMT+08:00

添加连接

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

  1. 在主菜单中选择“文件 > 新建连接”,或

    单击工具栏上的或按“Ctrl+N”连接到数据库服务器,弹出“新建/选择数据库连接”对话框。

    建立连接时,如果首选项文件损坏或首选项值无效,会显示如下错误信息,提示用户首选项值无效,并恢复默认值。单击“确定”完成建立新数据库连接的操作

  2. 该连接对话框的左侧列表中显示已有连接信息和服务器信息。

    服务器信息在连接成功后方可显示。

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

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

    • 若单击,在数据库不同连接状态下会出现不同提示信息:
      • 如果数据库连接已激活,会弹出“确认删除连接”对话框。单击“”断开所有数据库连接。
      • 如果数据库连接未激活,会弹出“删除连接”对话框。
    • 如果未选择连接名,直接单击,会显示对话框,提示用户至少选择一条连接信息。

  3. 设置如下参数,创建数据库连接:

    • 单击“清除”可清除“创建数据库连接”对话框中的所有字段。
    • 使用快捷键(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”默认选中。

  4. 执行以下步骤启用SSL:

    1. 选中“启用SSL”。
    2. 单击“SSL”页签。

    3. 设置以下信息,提供以下文件以使用安全连接。请参见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实例在后续连接时,不再显示“连接安全告警”对话框。
        • 有关详情,请参见服务器手册。

  5. 按照以下步骤设置“快速加载选项”:

    1. 单击高级选项卡

    2. 建立连接时,在“包含”字段中输入模式名称(使用逗号作为分隔符),以优先加载这些选项。
    3. 建立连接时,在“不包含”字段中输入模式名称,以避免优先加载这些选项。
    4. 为“加载对象”选择以下任意一个值:
      • 所有对象”:加载所有对象。
      • 用户权限范围内的对象”:仅加载用户有权访问的对象。请参阅表1查看对象浏览器中列出的对象所需的最低访问权限。

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

    5. 在“加载上限”字段中输入加载限制。允许的最大值为30,000。该值为数据库对象个数。
      • 如果“包含”字段中输入的模式中对象类型(表、视图等)的数量大于“加载上限”中的值,则将只加载该模式的父对象。这意味着含有大于3个参数的列、约束、索引、函数等子对象将不会被加载。
      • 对“包含”和“不包含”列表中提供的模式名称进行验证。
      • 如果无法访问“包含”字段中指定的模式,则连接期间会显示该模式的错误消息。
      • 如果无法访问“不包含”字段中指定的模式,则建立连接后,模式不会在“对象浏览器”中加载。

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

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

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

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

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

取消连接

执行以下步骤取消连接:

  1. 单击“取消”。

    显示取消连接”对话框。

  2. 单击”。

    显示消息确认会话框。

  3. 单击“确认”。

懒加载

懒加载功能仅在用户有需要时加载对象。

连接到数据库时,仅加载search_path路径下保存的模式子对象,如下所示:

未加载的模式显示为“模式名(…)”。

要加载子对象,请展开模式。模式展开时,会显示模式下的对象正在加载中:

如果有对象正在加载,且用户尝试加载未加载的对象,则会弹出消息告知用户有对象正在加载中。未加载对象旁的会消失。如要加载该对象,在对象或数据库级别进行刷新,该按钮会重新显示。

展开模式来加载和查看子对象。“对象浏览器”一次只能加载一个模式下的子对象。

如果建立连接后修改了search_path,该修改在重新连接数据库后才会生效。自动建议适用于用户有权访问的所有模式对象的关键字、数据类型、模式名称、表名称、视图和表别名。

“对象浏览器”窗格1分钟内最多可加载50000个对象。

数据库连接超时时间默认为3分钟(180秒)。如果在此时间段内未能连接成功,会显示超时错误。

可以在Data Studio.ini文件中设置loginTimeout。该文件的路径为Data Studio\Data Studio.ini。

当用户登录Data Studio时,系统会自动加载pg_catalog。