YashanDB Docs
search-icon Ctrl K
官网首页 立即体验 文档中心 search-icon Language

#连接数据库

# yashan模式

连接YashanDB服务端（yashan模式）的工具包括YashanDB客户端（yasql）、YashanDB驱动、YashanDB配套的崖山开发者中心YDC以及通用型第三方数据库管理工具（例如DBeaver、Navicat）等。

# 连接信息

YashanDB服务端的连接信息主要包括认证信息和服务端地址，若使用驱动连接，还涉及多IP场景的连接模式。

# 认证信息

认证信息是指用于登录YashanDB的用户名和认证凭据。

格式 说明
username/password 连接并登录数据库的用户名和密码。
如果在yashan模式下创建用户时用户名未使用双引号包围，使用yasql连接时大小写不敏感。
如果用户名或密码中含有OS命令相关的特殊字符（例如@、/、.、!、$、'等）需进行转义改写，详情可查阅yasql使用指导。
/ as sysdba 在数据库服务端所在服务器上通过操作系统认证方式登录时，可以省略用户名和密码，但不能省略/，且需声明as sysdba。

# 服务端地址

服务端地址可以为URL或别名，需正确指向目标服务端的监听地址（即yashandb.toml配置文件中的LISTEN_ADDR）。

信息类型 格式 说明
URL @host:port/pdb_name
* host：数据库所在服务器的网络地址，可以为IPv4地址、IPv6地址或域名。
* port：数据库服务端监听端口，如安装过程中未进行调整，默认为1688。
* pdb_name：仅用于容器数据库，指定连接到具体某个PDB，省略则默认连接至根容器。
无URL 采用UDS本地连接访问$YASDB_DATA环境变量对应的数据库实例。使用该方式连接数据库属于高权限操作，请合理使用。
别名 @别名 使用自定义的别名连接数据库。别名需提前在客户端所在设备的$YASDB_HOME/client/yasc_service.ini文件中定义，格式为alias = host:port[/pdb_name]。例如别名定义为yashan = 192.168.1.2:1688则可直接使用@yashan连接该地址所指向的数据库。

# 连接模式（多IP场景）

连接模式（多IP场景）仅在使用驱动连接YashanDB服务端时可以进行配置，例如JDBC驱动、C驱动、OCI驱动、ODBC驱动，且要求YashanDB服务端存在多个节点。

连接模式 格式 说明
primary模式 PRIMARY:host1:port,host2:port,……,hostn:port
（PRIMARY:可省略）		 轮询连接高可用部署中的主库节点
standby模式 STANDBY:host1:port,host2:port,……,hostn:port 轮询连接高可用部署中的备库节点
loadBalance模式 LOADBALANCE:host1:port,host2:port,……,hostn:port 连接最优节点（连接数最少视为最优）
primaryLoadBalance模式 PRIMARYLOADBALANCE:host1:port,host2:port,……,hostn:port 连接最优主库节点
standbyLoadBalance模式 STANDBYLOADBALANCE:host1:port,host2:port,……,hostn:port 负载均衡连接最优备库节点

# 前提条件

  • 在容器数据库中，指定pdb_name连接指定PDB时，需使用配套的v23.5.1.100及以上版本的客户端。

  • 已完成YashanDB客户端安装和环境变量配置，如在服务端所在服务器的安装用户下连接本地数据库，则无需重复安装yasql。

  • 需确保用户已具有CREATE SESSION权限（或CONNECT角色）。

  • 需确保发起连接的设备IP不在黑名单中。

# 连接操作

本文仅介绍如何使用YashanDB客户端（yasql）连接YashanDB服务端（yashan模式），YashanDB驱动/配套工具的连接方式将在对应文档中详细介绍。

# 一步登录

命令格式如下：

# 一步登录
$ yasql [-S] {认证信息}{服务端地址}  
# 常见写法如下：
$ yasql [-S] username/password@host:port/pdb_name
$ yasql [-S] / as sysdba

- S表示静默登录，需确保-S为首个参数，该参数不区分大小写。使用该方式登录并连接数据库不返回命令行提示、命令回显信息、登录提示信息和版本信息。

以sys用户登录数据库示例：（若当前环境为容器数据库则表示登录根容器）

# 本地登录时可以使用操作系统认证方式登录
$ yasql / as sysdba

# 使用密码认证方式登录
$ yasql sys/********@192.168.1.2:1688

YashanDB SQL Enterprise Edition Release {version_number} x86_64

Connected to:
YashanDB Server Enterprise Edition Release {version_number} x86_64 - Linux

SQL>

以sales用户登录PDB1示例：

$ yasql sales/********@192.168.1.2:1688/pdb1
YashanDB SQL Enterprise Edition Release {version_number} x86_64

Connected to:
YashanDB Server Enterprise Edition Release {version_number} x86_64 - Linux

SQL>

出现SQL命令行提示符表示连接成功，若为静默登录则不会出现SQL提示符。

# 分步登录

命令格式如下：

# 1. 启动yasql，打开登录窗口
$ yasql /nolog

# 2. 使用connect或conn命令连接并登录数据库
SQL> conn {认证信息}{服务端地址}

以sales用户登录示例：

$ yasql /nolog
YashanDB SQL Enterprise Edition Release {version_number} x86_64
SQL> conn sales/********@192.168.1.2:1688

Connected to:
YashanDB Server Enterprise Edition Release {version_number} x86_64 - Linux

SQL>

# 退出登录

命令格式如下：

exit

# mysql模式

连接YashanDB服务端（mysql模式）的工具除了YashanDB客户端（yasql）、YashanDB JDBC驱动、YashanDB C驱动外，还支持MySQL的生态周边配套工具，例如MySQL客户端、MySQL Connector/J等。

本章节仅介绍通过YashanDB客户端（yasql）和MySQL客户端连接崖山数据库。

当通过驱动连接数据库时，可参考JDBC驱动和C驱动了解详细的连接方式。

Note:

以mysql模式安装后，在数据库OPEN阶段新建的所有会话默认为mysql模式，在NOMOUNT或MOUNT阶段创建的会话则仍为yashan模式。

# 使用yasql连接

# 连接信息

YashanDB服务端的连接信息主要包括认证信息和服务端地址，若使用驱动连接，还涉及多IP场景的连接模式。

# 认证信息

认证信息是指用于登录YashanDB的用户名和认证凭据。

格式 说明
username/password 连接并登录数据库的用户名和密码。
如果在yashan模式下创建用户时用户名未使用双引号包围，使用yasql连接时大小写不敏感。
如果用户名或密码中含有OS命令相关的特殊字符（例如@、/、.、!、$、'等）需进行转义改写，详情可查阅yasql使用指导。
/ as sysdba 在数据库服务端所在服务器上通过操作系统认证方式登录时，可以省略用户名和密码，但不能省略/，且需声明as sysdba。

# 服务端地址

服务端地址可以为URL或别名，需正确指向目标服务端的监听地址（即yashandb.toml配置文件中的LISTEN_ADDR）。

信息类型 格式 说明
URL @host:port/pdb_name
* host：数据库所在服务器的网络地址，可以为IPv4地址、IPv6地址或域名。
* port：数据库服务端监听端口，如安装过程中未进行调整，默认为1688。
* pdb_name：仅用于容器数据库，指定连接到具体某个PDB，省略则默认连接至根容器。
无URL 采用UDS本地连接访问$YASDB_DATA环境变量对应的数据库实例。使用该方式连接数据库属于高权限操作，请合理使用。
别名 @别名 使用自定义的别名连接数据库。别名需提前在客户端所在设备的$YASDB_HOME/client/yasc_service.ini文件中定义，格式为alias = host:port[/pdb_name]。例如别名定义为yashan = 192.168.1.2:1688则可直接使用@yashan连接该地址所指向的数据库。

连接模式（多IP场景）仅在使用驱动连接YashanDB服务端时可以进行配置，mysql模式仅支持JDBC驱动和C驱动，且要求YashanDB服务端存在多个节点。

连接模式 格式 说明
primary模式 PRIMARY:host1:port,host2:port,……,hostn:port
（PRIMARY:可省略）		 轮询连接高可用部署中的主库节点
standby模式 STANDBY:host1:port,host2:port,……,hostn:port 轮询连接高可用部署中的备库节点
loadBalance模式 LOADBALANCE:host1:port,host2:port,……,hostn:port 连接最优节点（连接数最少视为最优）
primaryLoadBalance模式 PRIMARYLOADBALANCE:host1:port,host2:port,……,hostn:port 连接最优主库节点
standbyLoadBalance模式 STANDBYLOADBALANCE:host1:port,host2:port,……,hostn:port 负载均衡连接最优备库节点

# 前提条件

  • 已完成YashanDB客户端安装和环境变量配置，如在服务端所在服务器的安装用户下连接本地数据库，则无需重复安装yasql。

  • 需确保发起连接的设备IP不在黑名单中。

# 连接操作

为正确将用户名传递至数据库服务端，使用yasql以mysql模式下创建的用户连接YashanDB服务端（mysql模式）时需要使用双引号将用户名包围。

  • 分步登录

    命令格式如下：

    # 1. 启动yasql，打开登录窗口
$ yasql /nolog

# 2. 使用connect或conn命令连接并登录数据库
SQL> conn {认证信息}{服务端地址}

    以sales用户登录示例：

    $ yasql /nolog
YashanDB SQL Enterprise Edition Release {version_number} x86_64
SQL> conn "sales"/********@192.168.1.2:1688

Connected to:
YashanDB Server Enterprise Edition Release {version_number} x86_64 - Linux

SQL>

  • 一键登录

    命令格式如下：

    # 一步登录
$ yasql [-S] {认证信息}{服务端地址}  
# 常见写法如下：
$ yasql [-S] username/password@host:port  
$ yasql [-S] / as sysdba

    参数介绍：

    • - S：表示静默登录，需确保-S为首个参数，该参数不区分大小写。使用该方式登录并连接数据库不返回命令行提示、命令回显信息、登录提示信息和版本信息。

    • {认证信息}、{服务端地址}：详情请查阅连接信息。

    以sales用户登录示例：

    $ yasql \"sales\"/********@192.168.1.2:1688
YashanDB SQL Enterprise Edition Release {version_number} x86_64

Connected to:
YashanDB Server Enterprise Edition Release {version_number} x86_64 - Linux

SQL>

    出现SQL命令行提示符表示连接成功，若为静默登录则不会出现SQL提示符。

  • 退出登录

    exit

# 使用MySQL客户端连接

使用MySQL客户端连接连接YashanDB（mysql模式）时，无法使用超级管理员sys登录。

# 连接信息

  • 认证信息：同yashan模式。

  • 服务端地址：使用MySQL的生态周边配套工具连接YashanDB时默认使用MySQL协议的监听地址（即yashandb.toml配置文件中的mysql_addr）。

# 前提条件

  • 已完成MySQL客户端安装和环境变量配置。

  • 已创建普通用户。

  • 需确保发起连接的设备IP不在黑名单中。

# 连接操作

  • 登录

    登录命令格式如下：

    $ mysql -h {host} -P {port} -u {username} -p{password} [-D {database_name}]

    参数介绍：

    • -h {host}：数据库所在服务器的IP地址。

    • -P {port}：数据库服务端MySQL协议的监听端口（即yashandb.toml配置文件中mysql_addr的端口部分），如安装过程中未进行调整，端口号默认为1690（单机及单机主备）或1691（共享集群）。

    • -u {username}：数据库用户名。

    • -p{password}：用户名对应的登录密码。

    • {database_name}：可选项，指定连接YashanDB后当前会话中后续操作的默认数据库。如不指定，则不进入任何数据库，连接后可通过USE语句进行指定。

    以sales用户登录示例：

    -- the default port is 1690 (Standalone deployment) or 1691 (YAC deployment)
$ mysql -h 192.168.1.2 -P 1690 -u sales -p********

Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 15
Server version: {版本信息}

……

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

mysql>

  • 退出登录

    exit
pdf-btn 下载文档 copy-btn 复制链接
edit-icon
反馈
coperate-icon
coperate
合作
communication-icon
communicate
交流