SurrealDB 服务器启动以后,会提供一些接口,使用 sql 这个接口可以执行 surrealQL 处理数据库里的数据。我们可以先在一个 HTTP 客户端里测试一下 sql 这个接口。这里我用的是 Insomnia 。
先创建一个请求集合,名字是 ninghao-surrealdb ,在这个集合里创建一个创建一个请求,名字设置成 SQL(管理员)
配置一下这个请求,请求的方法是 POST,地址是 http://localhost:8000/sql,请求这个接口可以执行 surrealQL。
请求的主体数据就是要执行的 sql 查询,配置一下主体,类型可以选择 Other,输入 INFO FOR DB; 直接发送请求,得到了一个状态码是415的响应,提示 “Unsupported media type”,在请求里需要配置一下请求的头部。
添加一个 Accept ,对应的值设置成 application/json,表示我们在客户端这里可以接收 JSON 格式的数据。发送一下请求,这次又会提示“Specify a namespace to use”,需要指定一个命名空间。
添加一个头部,名字是 NS,表示 namespace ,设置成 ninghao。发送请求,又会提示 “Specify a database to use” ,指定要使用的数据库。
在请求头部里再添加一个 DB,它的值是要使用的数据库的名字,比如 xuanwu。发送请求,这次得到的响应提示 “You don't have permission to perform this query type” ,说当前没有权限执行这条查询。
在这个请求里配置一下身份验证,类型是 Basic,在用户名这里输入 root,密码 258369。 发送一下请求,这回就正常得到了响应的数据,
INFO
再试一下,执行 INFO FOR KV,可以显示 surrealDB 系统相关的信息,INFO FOR NS,可以查看命名空间相关的数据,当前使用的命名空间是 ninghao,所以这里显示的就是 ninghao 这个命名空间相关的数据 ,INFO FOR DB 查看的是数据库相关的信息,当前使用的是 xuanwu 这个数据库,这里得到的就是 xuanwu 这个数据库的相关信息。