ops 运维函数库

语法

cancelJobEx(id=NULL)

参数

• id: 字符串，表示后台作业的ID，可通过 getRecentJobs() 获取。

详情

取消集群节点上的后台作业。若指定了参数 id，取消此 id 对应的后台作业，若未指定 id，则取消集群各节点上的所有后台作业。

例子

创建 3 个后台作业：

def testJob(n,id){
   for(i in 0:n){
        writeLog("demo"+id+"is working")
        sleep(1000)
   }
}
submitJob("demo1","just a test",testJob,300,1);
submitJob("demo2","just a test",testJob,300,2);
submitJob("demo3","just a test",testJob,300,3);

取消第 1 个作业后，查询作业情况, 发现第 1 个作业的 errorMsg 显示 The task was cancelled：

 cancelJobEx("demo1")
 pnodeRun(getRecentJobs)

返回：

取消所有作业，查看作业情况，发现第 2、3 个作业的 errorMsg 也显示 The task was cancelled：

cancelJobEx()
pnodeRun(getRecentJobs)

返回：

语法

closeInactiveSessions(hours=12)

参数

• hours: 一个数值，用于判断 session 是否过期的时长。单位为小时，默认值为 12。

返回值

返回一个表，包含所有节点仍活跃 sessions 的信息。其表结构与 getSessionMemoryStat 返回的表结构一致。

详情

若 session 最后一次活跃时间与当前时间的差值大于 hours 指定值，则认为该 session 过期了。调用 closeInactiveSessions 会将所有过期会话关闭。通过 getSessionMemoryStat 方法查看 session 最后一次活跃时间。

例子

getSessionMemoryStat()

返回：

closeInactiveSessions(0.05)

返回：

语法

getDDL(database, tableName)

参数

• database: 字符串，表示数据库的路径，如 "dfs://demodb"。
• tableName: 字符串，表示分布式表名。

返回值

返回数据库创建语句、分布式表中各字段名称及类型、以及创建分布式表的语句。

详情

输出指定分布式表的建表语句。

例子

n=1000000
ID=rand(10, n)
x=rand(1.0, n)
t=table(ID, x)
db=database("dfs://rangedb", RANGE,  0 5 10)
pt=db.createPartitionedTable(t, `pt, `ID)
getDDL("dfs://rangedb", "pt")

返回：

db = database("dfs://rangedb")
colName = `ID`x
colType = [INT,DOUBLE]
tbSchema = table(1:0, colName, colType)
db.createPartitionedTable(table=tbSchema,tableName=`pt,partitionColumns=`ID)

语法

getTableDiskUsage(database, tableName, byNode=false)

参数

• database: 字符串，表示数据库的路径，如 "dfs://demodb"。
• tableName: 字符串，表示分布式表名。
• byNode: 布尔值，表示是否按节点显示磁盘使用量。默认值是 false，表示显示所有节点的磁盘使用总量。

返回值

返回一张记录磁盘占用信息的表，包含字段：

• node: 字符串，表示节点别名。仅在 byNode = true 时显示。
• diskGB: DOUBLE 浮点数，表示指定分布式表占用的磁盘空间。

详情

获取指定分布式表占用的磁盘空间大小。

例子

getTableDiskUsage("dfs://rangedb", "pt", true)

返回：

语法

dropRecoveringPartitions(dbPath , tableName="")

参数

• dbPath: 字符串，表示数据库的路径，如 "dfs://demodb"。
• tableName: 字符串，表示分布式表名，仅当指定分区粒度 chunkGranularity 为 TABLE 时指定。关于 chunkGranularity 的说明参见：database。

详情

强制删除指定数据库的正在恢复的分区。当表的分区粒度 chunkGranularity 为 TABLE 时必须指定 tableName 参数。

例子

首先，查看集群中所有 chunk 的元数据信息。

rpc(getControllerAlias(), getClusterChunksStatus)

由结果表看出，此时数据库 olapDemo 的 2 个分区 /olapDemo/20200904/ 和 /olapDemo/20200905/ 均处于 RECOVERING 状态。
调用 dropRecoveringPartitions 强制删除所有正在恢复的分区：

dropRecoveringPartitions(database("dfs://olapDemo"));

语法

getAllLicenses()

参数

无

返回值

返回一张表，显示各个节点的 license 过期时间，包含字段：

• nodeAlias: 字符串，表示节点别名。
• endDate: 日期值，表示节点 license 过期时间。

详情

获取集群中各个节点的 license 过期时间。

例子

getAllLicenses()

语法

updateAllLicenses()

参数

无

返回值

同 getAllLicenses() 的返回值

详情

在线更新集群中各个节点的 license，并返回 license 过期信息。
注意，调用此函数前，需要先替换 license 文件。

例子

updateAllLicenses()

语法

unsubscribeAll(tbName=NULL)

参数

• tbName: 字符串标量，表示要取消订阅的表名。默认值NULL，即如若不填参数，表示取消所有表的订阅。

详情

取消某个表的订阅，参数为NULL，即如若不填参数时可以取消所有表的订阅。

例子

share streamTable(10:0, `id`val, [INT, INT]) as st
t = table(10:0, `id`val, [INT, INT])
subscribeTable(tableName=`st, actionName=`sub_st, handler=append!{t})
undef(st, SHARED)
#error
All subscriptions to the shared stream table [st] must be cancelled before it can be undefined.

unsubscribeAll()
undef(st, SHARED)

取消某个表的订阅：

share streamTable(10:0, `id`val, [INT, DOUBLE]) as test_1
res = table(10:0, `id`val, [INT, DOUBLE])
subscribeTable(tableName=`test_1,handler=append!{res},actionName="sub_test_1")
unsubscribeAll("test_1")

语法

gatherClusterPerf(monitoringPeriod=60, scrapeInterval=15, dir="/tmp")

参数

• monitoringPeriod: 整数值，表示监控时间，单位为秒，默认为 60。
• scrapeInterval: 整数值，表示抓取间隔，单位为秒，默认为 15。
• dir: 字符串，表示保存路径，默认为 "/tmp"。

详情

根据指定的监控时间和抓取间隔获取集群中各个节点的性能监控信息，并将结果保存至指定目录的 statis.csv 文件。输出内容说明见 getClusterPerf。

例子

gatherClusterPerf(30, 3, "/tmp")
// 30s 后查看 /tmp/statis.csv 里的结果

语法

gatherStreamingStat(subNode, monitoringPeriod=60, scrapeInterval=15, dir="/tmp")

参数

• subNode: 字符串，表示订阅节点的别名。
• monitoringPeriod: 整数值，表示监控时间，单位为秒，默认为 60。
• scrapeInterval: 整数值，表示抓取间隔，单位为秒，默认为 15。
• dir: 字符串，表示保存路径，默认为 "/tmp"。

详情

根据指定的监控时间和抓取间隔获取指定订阅节点的工作线程的状态信息，并将结果保存至指定目录的 sub_worker_statis.csv 文件。输出内容说明见 getStreamingStat。

例子

gatherStreamingStat(30, 3, "/tmp")
// 30s 后查看 /tmp/sub_worker_statis.csv 里的结果

语法

getDifferentData(t1, t2)

参数

• t1: 内存表句柄。
• t2: 内存表句柄。

返回值

若存在不同行，返回不同的行；否则打印 "Both tables are identical"。

详情

使用 eqObj 比较两张内存表的每一行是否相同。比较的两张表的长度必须相同。

例子

t1=table(1 2 3 as id, 4 5 6 as val)
t2=table(1 8 9 as id, 4 8 9 as val)
t3=table(1 2 3 as id, 4 5 6 as val)
for (row in getDifferentData(t1, t2))
  print row

返回：

id val
-- ---
2  5
3  6
id val
-- ---
8  8
9  9

getDifferentData(t1, t3)

返回：

Both tables are identical

语法

checkChunkReplicas(dbName, tableName, targetChunkId)

参数

• dbName: 字符串，表示数据库的路径，如 "dfs://demodb"。
• tableName: 字符串，表示分布式表名。
• targetChunkId: 字符串，表示要检查的 chunk 的 ID，可通过 getTabletsMeta() 查看。

返回值

布尔值，表示指定分区的副本数据是否一致。

详情

检查数据库表指定分区的两个副本的数据是否一致。仅当控制节点配置 dfsReplicationFactor 值为 2 时有效。

例子

n=1000000
ID=rand(10, n)
x=rand(1.0, n)
t=table(ID, x)
db=database("dfs://rangedb", RANGE,  0 5 10)
pt=db.createPartitionedTable(t, `pt, `ID)
pt.append!(t)
checkChunkReplicas("dfs://rangedb", "pt", "af8268f0-151e-c18b-a84c-a77560b721e6") // chunk ID 可通过 getTabletsMeta() 查看

返回：true

使用 kill -9 PID 杀死其中一个数据节点，执行如下脚本：

pt.append!(t)
checkChunkReplicas("dfs://rangedb", "pt", "af8268f0-151e-c18b-a84c-a77560b721e6") // chunk ID 可通过 getTabletsMeta() 查看

返回：

checkChunkReplicas: throw "colFiles on two replicas are not same" => colFiles on two replicas are not same

重新启动杀死的数据节点，待副本数据同步后，再次执行 checkChunkReplicas()：

checkChunkReplicas("dfs://rangedb", "pt", "af8268f0-151e-c18b-a84c-a77560b721e6") // chunk ID 可通过 getTabletsMeta() 查看

返回：true

语法

clearAllSubscriptions()

参数

• 该函数无参数

返回值

返回取消订阅的流数据表名称和句柄名称，并打印"All subscriptions have been cleared !"。

详情

取消当前节点所有的流数据表订阅。

例子

clearAllSubscriptions()

返回：

unsub: st, sub1  
All subscriptions have been cleared !

语法

dropAllEngines()

参数

• 该函数无参数

返回值

返回：

All engines have been dropped !

详情

释放当前节点所有的流数据引擎的定义。

例子

dropAllEngines()

返回：

All engines have been dropped !

语法

existsShareVariable(names)

参数

• names: 可以是字符串标量或向量，表示对象名。

返回值

返回一个标量/向量，表示names中的每个元素是否为共享变量。

详情

判断一个字符串标量或向量中的每个元素是否为共享变量。

例子

share streamTable(10000:0, `timestamp`sym`val, [TIMESTAMP, SYMBOL, INT]) as variable1
existsShareVariable("variable1")

返回：true

语法

clearAllSharedTables()

参数

• 该函数无参数

返回值

返回删除的共享表的表名，并打印"All shared table have been cleared !"。

详情

删除当前节点所有的共享表。

例子

clearAllSharedTables()

返回：

Drop Shared Table: st  
All shared table have been cleared !

语法

clearAllStreamEnv()

参数

• 该函数无参数

返回值

同clearAllSubscriptions()、dropAllEngines()、sclearAllSharedTables()三个函数的返回值汇总。

详情

清除当前节点所有的流数据环境，包括流数据表订阅、流数据引擎和共享表。

例子

clearAllStreamEnv()

返回：

unsub: st, sub1  
All subscriptions have been cleared !  
All engines have been dropped !  
Drop Stream Table: dummyTable1  
All stream table have been cleared !  

语法

getPersistenceTableNames()

参数

• 该函数无参数

返回值

所有共享持久化流表的表名。

详情

获得所有共享持久化流表的表名。

例子

getPersistenceTableNames()

返回：[st1,st2]

语法

getNonPersistenceTableNames()

参数

• 该函数无参数

返回值

所有非持久化共享流表名。

详情

获取所有非持久化共享流表名。

例子

getNonPersistenceTableNames()

返回：[st1,st2]

语法

getPersistenceStat()

参数

• 该函数无参数

返回值

返回所有启用了持久化的共享流数据表的元数据。

详情

获取所有持久化共享流表的状态。

例子

getPersistenceStat()

返回：

语法

getNonPersistenceTableStat()

参数

• 该函数无参数

返回值

返回所有非持久化的共享流数据表的元数据。

详情

获取所有非持久化共享流表状态。

例子

getNonPersistenceTableStat()

语法

clearAllPersistenceTables()

参数

• 该函数无参数

返回值

该函数无返回值。

详情

删除所有持久化流表。

例子

clearAllPersistenceTables()

语法

getDatabaseDDL(dbName)

参数

• dbName : 库名（字符串标量）

返回值

建库语句（字符串标量）

详情

获得目标库的建库语句。

例子

dbName = "dfs://testDatabaseRANGE"
db1 = database(dbName, RANGE, 1985.01.01 1990.01.01 1995.01.01 2000.01.01 2005.01.01 2010.01.01)
getDatabaseDDL(dbName)

返回：

database(directory = 'dfs://testDatabaseRANGE', partitionType = RANGE, partitionScheme =[1985.01.01,1990.01.01,1995.01.01,2000.01.01,2005.01.01,2010.01.01], engine= `OLAP, atomic = `TRANS)

语法

getDBTableDDL(dbName,tbName)

参数

• dbName : 库名（字符串标量）
• tbName : 表名（字符串标量）

返回值

数据库中的建表语句（字符串标量）

详情

获得目标库内的表的建表语句。

例子

dbName = "dfs://test_OLAP_RANGE"
tbName1 = "partition1"
tbName2= "dimension1"
db1 = database(dbName, RANGE, 1985.01.01 1990.01.01 1995.01.01 2000.01.01 2005.01.01 2010.01.01)
tbSchema = table(1:0, `SecurityID`DateTime`Open`High`Low`Close, [SYMBOL, DATETIME, DOUBLE, DOUBLE, DOUBLE, DOUBLE])
db = database(dbName)
tb1 = createPartitionedTable(db, tbSchema, tbName1, ["DateTime"])
tb2 = createTable(db, tbSchema, tbName2)
getDBTableDDL(dbName,tbName1)
getDBTableDDL(dbName,tbName2)

返回：

createPartitionedTable(dbHandle = database('dfs://test_OLAP_RANGE'),table = table(1:0, ["SecurityID","DateTime","Open","High","Low","Close"],["SYMBOL","DATETIME","DOUBLE","DOUBLE","DOUBLE","DOUBLE"]),tableName = 'partition1',partitionColumns =["DateTime"],compressMethods = dict(["SecurityID","DateTime","Open","High","Low","Close"],["lz4","lz4","lz4","lz4","lz4","lz4"]))

createTable(dbHandle = database('dfs://test_OLAP_RANGE'),table = table(1:0, ["SecurityID","DateTime","Open","High","Low","Close"],["SYMBOL","DATETIME","DOUBLE","DOUBLE","DOUBLE","DOUBLE"]),tableName = 'dimension1',compressMethods = dict(["SecurityID","DateTime","Open","High","Low","Close"],["lz4","lz4","lz4","lz4","lz4","lz4"]))