1 安装
pip install fate-client
如果觉得下载速度太慢可以考虑指定国内源,例:
pip install fate-client -i https://pypi.tuna.tsinghua.edu.cn/simple
2 初始化
init
介绍 : Fate Flow 命令行初始化命令。用户可选择提供fate服务器配置文件路径或指定fate服务器ip地址及端口进行初始化。注意:若用户同时使用上述两种方式进行初始化,CLI将优先读取配置文件内容,而用户所配置的服务器ip地址及端口信息将被忽略。参数 :
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 conf_path -c
--server-conf-path
否 FATE服务器配置文件路径 2 ip --ip
否 FATE服务器ip地址 3 port --port
否 FATE服务器端口 4 reset --reset
否 如果指定,初始化信息将被重置
# configure values in conf/service_conf.yaml
flow init -c /data/projects/fate/conf/service_conf.yaml
# alternatively, input real ip address and port info to initialize cli
flow init --ip 127.0.0.1 --port 9380
单机版没有.yaml文件,所以只能使用第二种初始化方式,我在集群部署时,使用第二种初始化后,flow命令一直无法使用,所以使用第一种初始化方式。
upload
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 conf_path -c
--conf-path
是 任务配置文件路径 2 verbose --verbose
否 如果指定,用户将在控制台获得上传进度(默认不开启) 3 drop --drop
否 如果指定,旧版已上传数据将被新上传的同名数据替换(默认不替换)
flow data upload -c fate_flow/examples/upload_guest.json
flow data upload -c fate_flow/examples/upload_host.json --verbose --drop
3 Data
download
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 conf_path -c
--conf-path
是 任务配置文件路径
flow data download -c fate_flow/examples/download_host.json
upload
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 conf_path -c
--conf-path
是 任务配置文件路径 2 verbose --verbose
否 如果指定,用户将在控制台获得上传进度(默认不开启) 3 drop --drop
否 如果指定,旧版已上传数据将被新上传的同名数据替换(默认不替换)
flow data upload -c fate_flow/examples/upload_guest.json
flow data upload -c fate_flow/examples/upload_host.json --verbose --drop
upload_guest.json的内容:
{
"file" : "examples/data/breast_homo_guest.csv" ,
"head" : 1 ,
"partition" : 10 ,
"work_mode" : 0 ,
"namespace" : "experiment" ,
"table_name" : "breast_homo_guest"
}
字段说明:
file: 文件路径
table_name&namespace: 存储数据表的标识符号
head: 指定数据文件是否包含表头
partition: 指定用于存储数据的分区数
work_mode: 指定工作模式,0代表单机版,1代表集群版
backend: 指定后端,0代表EGGROLL, 1代表SPARK加RabbitMQ, 2代表SPARK加Pulsar
upload-history
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 limit -l
--limit
否 返回结果数量限制(默认:10) 2 job_id -j
--job_id
否 Job ID
flow data upload-history -l 20
flow data upload-history --job-id $JOB_ID
3 Job
submit
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 conf_path -c
--conf-path
是 任务配置文件路径 2 dsl_path -d
--dsl-path
否 DSL文件路径. 如果任务为预测任务,该字段可以不输入。另外,用户可以提供可用的自定义DSL文件用于执行预测任务。
flow job submit -c test_homolr_train_job_conf.json -d test_homolr_train_job_dsl.json
stop
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 job_id -j
--job_id
是 Job ID
示例 :
flow job stop -j $JOB_ID
query
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 job_id -j
--job_id
否 Job ID 2 role -r
--role
否 角色 3 party_id -p
--party_id
否 Party ID 4 status -s
--status
否 任务状态
view
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 job_id -j
--job_id
是 Job ID 2 role -r
--role
否 角色 3 party_id -p
--party_id
否 Party ID 4 status -s
--status
否 任务状态
config
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 job_id -j
--job_id
是 Job ID 2 role -r
--role
是 角色 3 party_id -p
--party_id
是 Party ID 4 output_path -o
--output-path
是 输出目录
log
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 job_id -j
--job_id
是 Job ID 2 output_path -o
--output-path
是 输出目录
list
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 limit -l
--limit
否 返回数量限制(默认:10)
flow job list
flow job list -l 30
dsl
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 cpn_list --cpn-list
否 用户指定组件名列表 2 cpn_path --cpn-path
否 用户指定带有组件名列表的文件路径 3 train_dsl_path --train-dsl-path
是 训练dsl文件路径 4 output_path -o
--output-path
否 输出目录路径
flow job dsl --cpn-path fate_flow/examples/component_list.txt --train-dsl-path fate_flow/examples/test_hetero_lr_job_dsl.json
flow job dsl --cpn-path fate_flow/examples/component_list.txt --train-dsl-path fate_flow/examples/test_hetero_lr_job_dsl.json -o fate_flow/examples/
flow job dsl --cpn-list "dataio_0, hetero_feature_binning_0, hetero_feature_selection_0, evaluation_0" --train-dsl-path fate_flow/examples/test_hetero_lr_job_dsl.json -o fate_flow/examples/
flow job dsl --cpn-list [dataio_0,hetero_feature_binning_0,hetero_feature_selection_0,evaluation_0] --train-dsl-path fate_flow/examples/test_hetero_lr_job_dsl.json -o fate_flow/examples/
4 Model
load
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 conf_path -c
--conf-path
否 任务配置文件路径 2 job_id -j
--job_id
否 Job ID
flow model load -c fate_flow/examples/publish_load_model.json
flow model load -j $JOB_ID
bind
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 conf_path -c
--conf-path
是 任务配置文件路径 2 job_id -j
--job_id
否 Job ID
flow model bind -c fate_flow/examples/bind_model_service.json
flow model bind -c fate_flow/examples/bind_model_service.json -j $JOB_ID
import
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 conf_path -c
--conf-path
是 任务配置文件路径 2 from-database –from-database 否 如果指定且有可用的数据库环境,fate flow将从根据任务配置文件从数据库中导入模型。
flow model import -c fate_flow/examples/import_model.json
flow model import -c fate_flow/examples/restore_model.json --from-database
export
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 conf_path -c
--conf-path
是 任务配置文件路径 2 to-database --to-database
否 如果指定且有可用的数据库环境,fate flow将从根据任务配置文件将模型导出到数据库中。
flow model export -c fate_flow/examples/export_model.json
flow model export -c fate_flow/examplse/store_model.json --to-database
migrate
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 conf_path -c
--conf-path
是 任务配置文件路径
flow model migrate -c fate_flow/examples/migrate_model.json
tag-list
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 job_id -j
--job_id
是 Job ID
flow model tag-list -j $JOB_ID
tag-model
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 job_id -j
--job_id
是 Job ID 2 tag_name -t
--tag-name
是 标签名 3 remove --remove
否 如果指定,带有指定标签名的标签将被模型的标签列表中移除
flow model tag-model -j $JOB_ID -t $TAG_NAME
flow model tag-model -j $JOB_ID -t $TAG_NAME --remove
deploy
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 model_id --model-id
是 模型ID 2 model_version --model-version
是 模型版本 3 cpn_list --cpn-list
否 组件列表 4 cpn_path --cpn-path
否 组件列表文件路径 5 dsl_path --dsl-path
否 用户指定预测DSL文件路径
flow model deploy --model-id $MODEL_ID --model-version $MODEL_VERSION
get-predict-dsl
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 model_id --model-id
是 模型ID 2 model_version --model-version
是 模型版本 3 output_path -o
--output-path
是 输出路径
flow model get-predict-dsl --model-id $MODEL_ID --model-version $MODEL_VERSION -o ./examples/
get-predict-conf
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 model_id --model-id
是 模型ID 2 model_version --model-version
是 模型版本 3 output_path -o
--output-path
是 输出路径
flow model get-predict-conf --model-id $MODEL_ID --model-version $MODEL_VERSION -o ./examples/
get-model-info
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 model_id --model-id
否 模型ID 2 model_version --model-version
是 模型版本 2 role -r
--role
否 角色 3 party_id -p
--party-id
否 Party ID 3 detail --detail
否 若指定,详细信息将被展示
flow model get-model-info --model-id $MODEL_ID --model-version $MODEL_VERSION
flow model get-model-info --model-id $MODEL_ID --model-version $MODEL_VERSION --detail
5 Component (TRACKING)
parameters
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 job_id -j
--job_id
是 Job ID 2 role -r
--role
是 角色 3 party_id -p
--party_id
是 Party ID 4 component_name -cpn
--component_name
是 组件名
flow component parameters -j $JOB_ID -r host -p 10000 -cpn hetero_feature_binning_0
metric-all
介绍 : 检索指定任务的所有metric数据。参数 :
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 job_id -j
--job_id
是 Job ID 2 role -r
--role
是 角色 3 party_id -p
--party_id
是 Party ID 4 component_name -cpn
--component_name
是 组件名
metrics
介绍 : 检索指定任务指定组件的metric数据。参数 :
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 job_id -j
--job_id
是 Job ID 2 role -r
--role
是 角色 3 party_id -p
--party_id
是 Party ID 4 component_name -cpn
--component_name
是 组件名
metric-delete
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 date -d
--date
否 8位日期, 形如 ‘YYYYMMDD’ 2 job_id -j
--job_id
否 Job ID
# 注意:如果同时键入date参数与job_id参数,CLI将优先检测date参数数据,job_id参数将被忽略。
flow component metric-delete -d 20200101
flow component metric-delete -j $JOB_ID
output-model
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 job_id -j
--job_id
是 Job ID 2 role -r
--role
是 角色 3 party_id -p
--party_id
是 Party ID 4 component_name -cpn
--component_name
是 组件名
output-data
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 job_id -j
--job_id
是 Job ID 2 role -r
--role
是 角色 3 party_id -p
--party_id
是 Party ID 4 component_name -cpn
--component_name
是 组件名 5 output_path -o
--output-path
是 输出目录 6 limit -l
--limit
否 默认返回全部
output-data-table
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 job_id -j
--job_id
是 Job ID 2 role -r
--role
是 角色 3 party_id -p
--party_id
是 Party ID 4 component_name -cpn
--component_name
是 组件名
list
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 job_id -j
--job_id
是 Job ID
flow component list -j $JOB_ID
get-summary
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 job_id -j
--job_id
是 Job ID 2 role -r
--role
是 角色 3 party_id -p
--party_id
是 Party ID 4 component_name -cpn
--component_name
是 组件名 5 output_path -o
--output-path
否 输出目录路径
flow component get-summary -j $JOB_ID -r host -p 10000 -cpn hetero_feature_binning_0
flow component get-summary -j $JOB_ID -r host -p 10000 -cpn hetero_feature_binning_0 -o ./examples/
6 Task
query
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 job_id -j
--job_id
否 Job ID 2 role -r
--role
否 角色 3 party_id -p
--party_id
否 Party ID 4 component_name -cpn
--component_name
否 组件名 5 status -s
--status
否 任务状态
flow task query -j $JOB_ID -p 9999 -r guest
flow task query -cpn hetero_feature_binning_0 -s complete
list
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 limit -l
--limit
否 返回结果数量限制(默认:10)
flow task list
flow task list -l 25
7 Table
info
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 namespace -n
--namespace
是 命名空间 2 table_name -t
--table-name
是 数据表名
flow table info -n $NAMESPACE -t $TABLE_NAME
delete
编号 参数 Flag_1 Flag_2 必要参数 参数介绍 1 namespace -n
--namespace
否 命名空间 2 table_name -t
--table_name
否 数据表名
flow table delete -n $NAMESPACE -t $TABLE_NAME
8 Queue
clean
介绍 : 取消所有在队列中的Job。参数 : 无示例 :
flow queue clean
| -------- | -------- |
| 1 | namespace | `-n` | `--namespace` | 是 | 命名空间 |
| 2 | table_name | `-t` | `--table-name` | 是 | 数据表名 |
- *示例*:
flow table info -n $NAMESPACE -t $TABLE_NAME
### `delete`
- *介绍*: 删除指定数据表。
- *参数*:
| 编号 | 参数 | Flag_1 | Flag_2 | 必要参数 | 参数介绍 |
| ---- | ---------- | ------ | -------------- | -------- | -------- |
| 1 | namespace | `-n` | `--namespace` | 否 | 命名空间 |
| 2 | table_name | `-t` | `--table_name` | 否 | 数据表名 |
- *示例*:
flow table delete -n $NAMESPACE -t $TABLE_NAME
# 8 Queue
### `clean`
- *介绍*: 取消所有在队列中的Job。
- *参数*: 无
- *示例*:
flow queue clean