initialize接口

接口功能

初始化MindIO ACP Client。

接口格式

mindio_acp.initialize(server_info: Dict[str, str] = None) -> int

接口参数

参数	是否必选	说明	取值要求
server_info	可选	自动拉起的Server进程需要配置参数信息，若不传入全部使用默认值。	有效参数集合或None。

表1 server_info参数说明
参数key	默认参数value	是否必选	说明	取值范围
'memfs.data_block_pool_capacity_in_gb'	'128'	可选	MindIO ACP文件系统内存分配大小，单位：GB，根据服务器内存大小来配置，建议不超过系统总内存的25%。	[1, 1024]
'memfs.data_block_size_in_mb'	'128'	可选	文件数据块分配最小粒度，单位：MB，根据使用场景中大多数文件的size决定配置，建议平均每个文件的数据块大小不超过128MB。	[1, 1024]
'memfs.write.parallel.enabled'	'true',	可选	MindIO ACP并发读写性能优化开关配置，用户需结合业务数据模型特征决定是否打开本配置。	false：关闭 true：开启
'memfs.write.parallel.thread_num'	'16'	可选	MindIO ACP并发读写性能优化并发数。	[2, 96]
'memfs.write.parallel.slice_in_mb'	'16'	可选	MindIO ACP并发写性能优化数据切分粒度，单位：MB。	[1, 1024]
'background.backup.thread_num'	'32'	可选	备份线程数量。	[1, 256]

mindio_acp.initialize如果不传入server_info参数，则按照表中默认参数启动Server。

使用样例1

>>> # Initialize with default param
>>> mindio_acp.initialize()

使用样例2

>>> # Initialize with server_info
>>> server_info = {
        'memfs.data_block_pool_capacity_in_gb': '200',
    }
>>> mindio_acp.initialize(server_info=server_info)

返回值

0：成功
-1：失败

父主题： API接口参考