列举指定命名空间下的所有表。
注意事项
-
当表数量较多时，可以通过--max-tables参数限制单次返回的最大数量，并使用--continuation-token参数进行分页查询。
-
如果返回结果中包含continuation-token，说明还有更多表未列出，可以将该值作为下一次请求的--continuation-token参数以继续列举。
-
可以使用--prefix参数按前缀过滤表名。
命令格式
ossutil tables-api list-tables --table-bucket-arn value --namespace value [--prefix value] [--max-tables value] [--continuation-token value] [flags]|
参数 |
类型 |
说明 |
|
--continuation-token |
string |
分页标记，用于继续列举上一次未列完的表。首次请求无需指定，后续请求使用上一次返回的token值。 |
|
--max-tables |
int |
单次查询返回的最大表数量。默认值和最大值取决于服务端限制。 |
|
--namespace |
string |
要列举表的命名空间名称。 |
|
--prefix |
string |
按前缀过滤，仅返回名称以指定前缀开头的表。 |
|
--table-bucket-arn |
string |
Table Bucket的ARN，格式为 |
说明
-
list-tables命令对应API接口ListTables。关于API中的具体参数含义，请参见ListTables。
-
关于支持的全局命令行选项，请参见ossutil全局选项。
使用示例
-
列举指定命名空间下的所有表。
ossutil tables-api list-tables --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket --namespace my_namespace -
按前缀过滤表名，仅返回名称以
test_开头的表。ossutil tables-api list-tables --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket --namespace my_namespace --prefix test_ -
列举表，限制单次最多返回10条结果。
ossutil tables-api list-tables --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket --namespace my_namespace --max-tables 10