Hypertable工具之Hyperspace

亦凉 2022-08-27 07:59 189阅读 0赞

命令：hyperspace  \[hyperspace\_ip:port\]。  
hyperspace命令可连接至hyperspace，并执行下列命令：  
mkdir ............. Creates a directory in Hyperspace  
mkdirs ............ Creates all paths leading upto and including directory in Hyperspace  
delete ............ Delete file/directory  
open .............. Open a file/directory  
create ............ Create a file  
close ............. Close previously opened file/directory  
attrset ........... Set an attribute (key/value pair) for a file/directory  
attrget ........... Retrieve an attribute for a file/directory  
attrincr........... Atomically increment the value of an attribute (assumed uint64)  
attrexists ........ Check if a particular attribute is set for a file/directory  
attrlist .......... Retrieve all attributes (keys only) for a file/directory  
attrdel ........... Delete an attribure for a file/directory  
exists ............ Check if a file/directory exists  
readdir ........... List the contents of a previously opened directory  
readdirattr ....... List the contents of a previously opened directory which has  
            ....... the named attribute set and the value of the attribute  
readpathattr ...... List the values of an attribute for each path component of a  
            ....... previously opened file/directory  
lock .............. Lock access to a file/directory  
trylock ........... Check whether a lock on file/directory would succeed  
release ........... Release previously acquired lock  
getseq ............ Get a lock sequencer for a file/directory  
echo .............. Echo user input  
locate ............ Get the location of Hyperspace Master or all Replicas  
dump .............. Dump contents of hyperspace  
**1MKDIR(S)**  
mkdir <dir> 创建指定的目录  
mkdirs <dir> 创建指定的整个目录层次  
**2Open、close**  
open <fname> flags=\[READ|WRITE|LOCK|CREATE|EXCL|TEMP|LOCK\_SHARED|LOCK\_EXCLUSIVE\] \[event-mask=<mask>\]  
示例：open /hyperspace flags=read  event-mask=attr\_set;  
实验表明：readdir、attr命令族（attrlist、attrset、attrget、attrdel、readdirattr、readpathattr等）使用前必须首先open命令操作指定的文件或者目录。  
  
  
close <file>  
示例：close /hyperspace;  
**3Create、delete、exists**  
create <fname> flags=\[READ|WRITE|LOCK|TEMP|LOCK\_SHARED|LOCK\_EXCLUSIVE\] \[OPTIONS\]  
OPTIONS:  
  attr:<name>=<value>  This can be used to specify extended attributes that should  
                       get created atomically when the file is created  
  event-mask=<mask>  This indicates which events should be delivered on this handle.  
                     The <mask> value can take any combination of the following:  
                     ATTR\_SET|ATTR\_DEL|LOCK\_ACQUIRED|LOCK\_RELEASED  
创建一个文件，并打开该文件。  
示例：create /testdir/newfile flags=write attr: generation ="5" event-mask=attr\_set;  
实验表明：value两边必须加引号。文件创建后，无需open，即可进行attrset等操作。  
  
  
exists <name>  
  
  
delete <dir>  
实验表明：不能删除一个已经open的目录或文件，并且不能删除一个非空的目录。  
**4Attrset、attrget、attrincr、attrexists、attrlist、attrdel**  
attrset <file> <name>=<value> \[i16|i32|i64\]  
示例：attrset /testdir/newfile location ="rs2";  
实验表明：\[i16|i32|i64\]出错，例如attrset /testdir/newfile generation ="2" i16;报错“Error: Hypertable::Exception: parse error at:  i16 - HYPERSPACE CLI parse error”。  
  
  
attrget <file> <name> \[int|short|long\]  
示例：attrget /testdir/newfile generation;  
实验表明：\[int|short|long\]出错，例如attrget /testdir/newfile generation int;报错“Error: Hypertable::Exception: parse error at:  int - HYPERSPACE CLI parse error”。  
  
  
attrincr <file> <name>  
示例：attrincr /testdir/newfile generation;  
实验表明：如果属性值不是数字，将会出错。  
  
  
attrexists <file> <name>  
示例：attrexists /testdir/newfile location;  
  
  
attrlist <file>  
示例：attrlist /testdir/newfile;显示结果为  
generation  
location  
lock.generation  
实验表明：任一文件或者目录都有lock.generation属性，但该属性不能查看，即通过attrget查看该属性时会报错。  
  
  
attrdel <file> <name>  
示例：attrdel /testdir/newfile generation;  
**5Readdir、Readdirattr、readpathattr**  
readdir <dir>  
实验表明：hyperspace上的目录结构为  
hyperspace  
metadata  
hypertable  
master  
namemap  
ids  
namespace编号  
表编号  
names  
namespace名称  
表名称  
root  
servers  
RangeServer标记，例如：rs1  
Tables  
namespace编号  
表编号  
  
readdirattr \[-r\] <dir> <name>  
列出dir所指定的目录结构，并显示name所指定的属性值。-r表示对子目录也递归的进行类似操作。  
示例：  
readdirattr /testdir generation;显示结果为  
(dir) abd  
      newfile, generation=2  
      newfile1  
(dir) newfolder, generation=3  
readdirattr -r /testdir generation; 显示结果为  
(dir) abd  
      newfile, generation=2  
      newfile1  
(dir) newfolder, generation=3  
      + newfile, generation=1  
  
  
readpathattr <dir> <name>  
自dir所指定目录或文件，逐层向上，列出name属性的值。  
示例：readpathattr /testdir/newfolder/newfile generation; 显示结果为  
(dir) /  
(dir) /testdir/  
(dir) /testdir/newfolder/, generation=3  
      /testdir/newfolder/newfile, generation=1  
**6Lock、trylock、release、getseq**  
lock <file> <mode>   
trylock <file> <mode>   
The <mode> argument may be either SHARED or EXCLUSIVE.  
示例：  
open /testdir/newfile flags=WRITE|LOCK\_SHARED;  
lock /testdir/newfile shared;  
输出结果：SEQUENCER name=/testdir/newfile mode=1 generation=22  
试验表明：如果要lock或者trylock一个文件或者目录，必须首先open这个文件或者目录，并且open命令的flags参数必须至少包含：WRITE|LOCK（也可用LOCK\_SHARED或LOCK\_EXCLUSIVE替代LOCK）。  
当测试获取EXCLUSIVE锁时，不但操作长久不能响应，而且导致整个集群的所有非Hyperspace机器提示“hyperspace session expired”，必须重启集群才可以恢复正常。  
对于前文提及的“lock. Generation”，从此处的测试中推断应该为输出结果中的generation，例如上例中的“generation=22”。  
  
  
release <file>  
试验表明：对于已经lock或者trylock一个文件或者目录，如果再次lock或者trylock，则会提示“HYPERSPACE already locked”。必须执行release操作后，才能再次加锁。当然，如果是对同一个文件或者目录的再次open，则可直接进行加锁。  
  
  
getseq <file>  
试验表明：该命令输出的结果类似于“SEQUENCER name=/testdir/newfile mode=1 generation=22”格式。  
**7dump**  
dump <path> \[AS\_COMMANDS\] \[output\_file\]  
导出Hyperspace指定路径下所有的内容到output\_file，如果没有指定output\_file，则默认导出到标准输出设备。AS\_COMMANDS选项将使输出的内容中附带Hyperspace shell命令，从而使得可以方便的重新导入到hyperspace中。导入时为了保持属性中的空格，可以使用类似“hyperspace  --command-file  dump\_file”的命令格式。  
示例：  
dump  /hyperspace;输出结果为  
/hyperspace  
/hyperspace/metadata  
dump  /hyperspace  AS\_COMMANDS; 输出结果为  
MKDIRS /hyperspace;  
OPEN /hyperspace FLAGS=READ|WRITE|CREATE ;  
OPEN /hyperspace/metadata FLAGS=READ|WRITE|CREATE ;  
dump /hyperspace AS\_COMMANDS "/tmp/1.tsv"; 导出内容到文件，文件必须用引号进行限定。