获取数据库实例
使用get命令获取数据库实例列表、详情或者查询数据库数据。
命令结构
health get database instance <instance-id> [flags] 或者 health get db instance <instance-id> [flags]
参数 |
简写 |
是否必选 |
说明 |
---|---|---|---|
instance-id |
无 |
否 |
数据库实例 id,不填写时表示获取数据库实例列表,填写时表示获取数据库实例详情。 |
--data |
-d |
否 |
是否查询数据库数据,需要和database-id参数一起使用。 |
--limit |
-l |
否 |
限制量,默认为10,取值范围[0,1000],只有在--data参数使用时才生效。 |
--offset |
-o |
否 |
偏移量,默认为0,取值范围[0,100000000],只有在--data参数使用时才生效。 |
--query |
-q |
否 |
查询条件,格式为{column}::{operator}::{number}。`::`分割一个表达式中的列名、操作符和值。不同类型支持的操作符如下:String支持like(模糊搜索)、equal(精确搜索)、notlike(不包含)、notequal(不等于),Double支持gt(大于)、lt(小于),Long支持gte(大于等于)、lte(小于等于)、gt(大于)、lt(小于)。只有在--data参数使用时才生效。 例如查询下图数据库中第2列,数值大于1数据。-q Ace2_H34::gt::1 |
--sort-key |
-k |
否 |
排序字段,只有在--data参数使用时才生效。 |
--sort-dir |
-i |
否 |
排序方向,升序或降序,即ASC 和DESC,默认DESC,只有在--data参数使用时才生效。 |
--columns |
-c |
否 |
当某个数据库实例列数非常多时,查看数据时会由于机器显示界面限制导致换行难以查看,添加此参数可以只显示想要查看数据的列名,多个列名用分号隔开(;),只有在--data参数使用时才生效。 |
--project |
无 |
否 |
指定项目名。未填写则使用配置文件中的项目名。 |
命令示例
本节以Windows为例介绍eihealth-toolkit的使用过程,Linux和macOS环境使用方法基本相同,可参考。
- 获取数据库实例列表
health get db instance # 返回结果如下 Database ID Template Source Project Creator Number of Records Created Modified demo-01 xxx template1 project-01 EIHealth 1234 xxx xxx demo-02 xxx template1 project-02 EIHealth 347 xxx xxx
- 获取模板详情
health get db instance 12345 # 返回结果如下 { "id": "xxxx", "name": "job-1622803262953", "description": "database instance for drug screening, do not delete", "template": { "id": "xxxx", "name": "job-1622803262953-d69d2162", "description": "template for drug screening, study name is study-rbqr5mvgrqm086kz, job name is job-1622803262953", "source_project_name": "drug-screening-demo-01", "source_project_id": "xxxx", "source_template_id": "", "creator": "ei_eihealth_02", "columns": [ { "name": "drugs", "type": "String", "description": "The name of the drug", "nullable": false, "primary": true, "searchable": true, "unique": true, "tips": "" }, { "name": "Nsp10_6zct_pure", "type": "Double", "description": "The binding energy between the ligand and receptor", "nullable": true, "primary": false, "searchable": false, "unique": false, "tips": "" }, { "name": "NSP13_pure", "type": "Double", "description": "The binding energy between the ligand and receptor", "nullable": true, "primary": false, "searchable": false, "unique": false, "tips": "" }, { "name": "Average", "type": "Double", "description": "The average of the binding energy", "nullable": false, "primary": false, "searchable": false, "unique": false, "tips": "" }, { "name": "Standard_Deviation", "type": "Double", "description": "The standard deviation of the binding energy", "nullable": true, "primary": false, "searchable": false, "unique": false, "tips": "" } ], "create_time": "2021-06-04T10:41:32Z", "primary_key": "drugs", "is_prefab": false }, "creator": "ei_eihealth_02", "create_time": "2021-06-04T10:43:25Z", "update_time": "2021-06-04T10:43:26Z", "data_count": 2, "source_project_name": "drug-screening-demo-01", "source_project_id": "xxxx", "source_id": "", "is_prefab": false }
- 查询数据
health get db instance 12345 --data --limit 2 # 返回结果如下 drugs nsp3 mpro average standard_deviation _row_num Pyridoxal-phosphate -5.1 -4.7 -4.9 0.2 8496 Tetrahydrofolic-acid -7.8 -8.3 -8.05 0.25 8495
- 按列查询数据
health get db instance 12345 --data --limit 2 --columns drugs;nsp3;mpro # 返回结果如下 drugs nsp3 mpro _row_num Pyridoxal-phosphate -5.1 -4.7 8496 Tetrahydrofolic-acid -7.8 -8.3 8495