![b479.png](https://developer.qcloudimg.com/http-save/yehe-5642295/342ae6b866135f5ad6d58acbd1deb35b.png)

## 概念
**yasql** 是崖山数据库（YashanDB）官方自带的命令行SQL客户端工具，对标 Oracle 的 `sqlplus`，高度兼容Oracle‑SQL/PLSQL语法，用于登录数据库、执行SQL、PL块、运行脚本、数据库运维操作，支持Linux、Windows客户端部署，默认端口 **1688**。

> 特点：
> 1. 语法、交互习惯高度模仿 Oracle SQL*Plus；
> 2. 支持本地、远程、操作系统认证、连接别名、PDB可插拔数据库登录；
> 3. 支持执行单条SQL、执行SQL脚本、PL/SQL匿名块；
> 4. 提供 `set` 系列格式化输出命令、spool输出结果集等能力。

视频讲解如下：
!video[【赵渝强老师】崖山数据库的命令行客户端工具](https://cloud.tencent.com/developer/video/88195)

## 基础语法
```bash
yasql [-S] username/password@host:port[/pdb]
yasql / as sysdba          # OS操作系统认证登录
yasql /nolog               # 只启动客户端，不连接数据库
```
- `-S`：静默模式，不输出登录banner信息，必须放在第一个参数。

## 实操示例

### 1. 使用管理员用户登录崖山数据库
```bash
yasql yasql / as sysdba
```
登录成功后出现提示符：`SQL>`

### 2. 创建用户
```sql
# 进入yasql环境后创建scott用户，并授予角色
SQL> create user scott identified by tiger;
SQL> grant connect,to scott;
SQL> grant resource to scott;
```

### 3. 切换到scott用户
```sql
SQL> conn scott/tiger
```

### 4. 创建部门表和员工表
```sql
SQL> create table dept
     (deptno int primary key,
     dname varchar(10),
     loc varchar(10)
     );
     
SQL> create table emp 
      (empno int primary key,
      ename varchar(10),
      job varchar(10),
      mgr int,
      hiredate varchar(10),
      sal int,
      comm int,
      deptno int,
      foreign key(deptno) references dept(deptno));
```

### 5. 插入部门数据和员工数据
```sql
--插入部门表数据
SQL> insert into dept values(10,'ACCOUNTING','NEW YORK');
SQL> insert into dept values(20,'RESEARCH','DALLAS');
SQL> insert into dept values(30,'SALES','CHICAGO');
SQL> insert into dept values(40,'OPERATIONS','BOSTON');

--插入员工表数据
SQL> insert into emp values(7369,'SMITH','CLERK',7902,'1980/12/17',800,null,20);
SQL> insert into emp values(7499,'ALLEN','SALESMAN',7698,'1981/2/20',1600,300,30);
SQL> insert into emp values(7521,'WARD','SALESMAN',7698,'1981/2/22',1250,500,30);
SQL> insert into emp values(7566,'JONES','MANAGER',7839,'1981/4/2',2975,null,20);
SQL> insert into emp values(7654,'MARTIN','SALESMAN',7698,'1981/9/28',1250,1400,30);
SQL> insert into emp values(7698,'BLAKE','MANAGER',7839,'1981/5/1',2850,null,30);
SQL> insert into emp values(7782,'CLARK','MANAGER',7839,'1981/6/9',2450,null,10);
SQL> insert into emp values(7788,'SCOTT','ANALYST',7566,'1987/4/19',3000,null,20);
SQL> insert into emp values(7839,'KING','PRESIDENT',-1,'1981/11/17',5000,null,10);
SQL> insert into emp values(7844,'TURNER','SALESMAN',7698,'1981/9/8',1500,null,30);
SQL> insert into emp values(7876,'ADAMS','CLERK',7788,'1987/5/23',1100,null,20);
SQL> insert into emp values(7900,'JAMES','CLERK',7698,'1981/12/3',950,null,30);
SQL> insert into emp values(7902,'FORD','ANALYST',7566,'1981/12/3',3000,null,20);
SQL> insert into emp values(7934,'MILLER','CLERK',7782,'1982/1/23',1300,null,10);

commit;
```

### 6. 执行PL/SQL匿名块（末尾必须写`/`执行）
```sql
SQL> set serveroutput on;
SQL> declare
       --说明部分
     begin
        --程序体
        dbms_output.put_line('Hello World');
     end;
     /
     
# 输出的信息如下：
Hello World

 Succeed.
```

### 7. 创建并调用存储过程
```sql
-- 创建存储过程
SQL> create or replace procedure sayhelloworld
     as
         --说明部分
     begin
         dbms_output.put_line('Hello World');
     end;
     /

-- 调用存储过程（方式1）
SQL> begin
         sayhelloworld();
         sayhelloworld();
     end;
     /

# 输出的信息如下：
Hello World
Hello World

PL/SQL Succeed.

-- 调用存储过程（方式2）
SQL> exec sayhelloworld();

```

### 8. 查看yasql版本、帮助
```bash
yasql -V
yasql -H
```

### 9. 退出yasql客户端
```sql
SQL> exit;
-- 或者
SQL> quit;
```

## 和Oracle SQL*Plus简单对比
|项目|Oracle SQL*Plus|YashanDB yasql|
|---|---|---|
|用途|Oracle命令行客户端|崖山数据库命令行客户端|
|登录格式|`sqlplus user/pass@tns`|`yasql user/pass@ip:port`|
|OS认证|`sqlplus / as sysdba`|`yasql / as sysdba`|
|脚本执行|`@xxx.sql`|`@xxx.sql`|
|输出打印|`set serveroutput on`|`set serveroutput on`|
|退出|exit/quit|exit/quit|

> yasql尽量复刻SQL*Plus的使用习惯，降低Oracle迁移到崖山数据库的学习成本。



yasql 是崖山数据库（YashanDB）官方自带的命令行SQL客户端工具，对标 Oracle 的 sqlplus，高度兼容Oracle‑SQL/PLSQL语法，用于登录数据库、执行SQL、PL块、运行脚本、数据库运维操作，支持Linux、Windows客户端部署，默认端口 1688。

【赵渝强老师】崖山数据库的命令行客户端工具

大数据学院院长

数据库

yasql是崖山数据库官方命令行SQL客户端，高度兼容Oracle SQL*Plus语法，支持本地/远程登录、SQL脚本执行、PL/SQL匿名块及存储过程调用，提供格式化输出和spool功能，显著降低Oracle迁移崖山的学习成本，默认端口1688。

数据库运维

代码解释

Windows

Linux

9.9元起，最快1天搭建自有直播平台


文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

【赵渝强老师】崖山数据库的命令行客户端工具-腾讯云开发者社区-腾讯云

【赵渝强老师】崖山数据库的命令行客户端工具

【赵渝强老师】崖山数据库的命令行客户端工具

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐