全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
表格存储

表操作

更新时间:2017-09-08 17:16:34

表格存储的 SDK 提供了 CreateTable、ListTable、DeleteTable、UpdateTable 和 DescribeTable 等表级别的操作接口。

创建表(CreateTable)

根据给定的表的结构信息创建相应的表。

创建表格存储的表时必须指定表的主键。主键包含 1~4 个主键列,每一个主键列都有名字和类型。

接口

  1. /**
  2. * 根据给定的表结构信息创建相应的表。
  3. */
  4. createTable(params, callback)

说明:表格存储的表在被创建之后需要几秒钟进行加载,创建成功后需要等待几秒钟后再做其他操作。

示例

创建一个有 2 个主键列,预留读/写吞吐量为 (0,0) 的表。

  1. var client = require('./client');
  2. var params = {
  3. tableMeta: {
  4. tableName: 'sampleTable',
  5. primaryKey: [
  6. {
  7. name: 'gid',
  8. type: 'INTEGER'
  9. },
  10. {
  11. name: 'uid',
  12. type: 'INTEGER'
  13. }
  14. ]
  15. },
  16. reservedThroughput: {
  17. capacityUnit: {
  18. read: 0,
  19. write: 0
  20. }
  21. },
  22. tableOptions: {
  23. timeToLive: -1,// 数据的过期时间, 单位秒, -1代表永不过期. 假如设置过期时间为一年, 即为 365 * 24 * 3600.
  24. maxVersions: 1// 保存的最大版本数, 设置为1即代表每列上最多保存一个版本(保存最新的版本).
  25. }
  26. };
  27. client.createTable(params, function (err, data) {
  28. if (err) {
  29. console.log('error:', err);
  30. return;
  31. }
  32. console.log('success:', data);
  33. });

说明:详细代码可在 createTable@GitHub 获取。

列出表名称(ListTable)

获取当前实例下已创建的所有表的表名。

接口

  1. /**
  2. * 获取当前实例下已创建的所有表的表名。
  3. */
  4. listTable(params, callback)

示例

获取实例下的所有表名。

  1. var client = require('./client');
  2. client.listTable({}, function (err, data) {
  3. if (err) {
  4. console.log('error:', err);
  5. return;
  6. }
  7. console.log('success:', data);
  8. });

说明:详细代码可在 listTable@GitHub 获取。

更新表(UpdateTable)

更新指定表的最大版本数,预留读吞吐量或预留写吞吐量的设置。

接口

  1. /**
  2. * 更新指定表的预留读吞吐量或预留写吞吐量设置。
  3. */
  4. updateTable(params, callback)

示例

更新表的最大版本数为5。

  1. var client = require('./client');
  2. var params = {
  3. tableName: 'sampleTable',
  4. tableOptions: {
  5. maxVersions: 5,
  6. }
  7. };
  8. client.updateTable(params, function (err, data) {
  9. if (err) {
  10. console.log('error:', err);
  11. return;
  12. }
  13. console.log('success:', data);
  14. });

说明:详细代码可在 updateTable@GitHub 获取。

查询表描述信息(DescribeTable)

查询指定表的结构信息和预留读/写吞吐量的设置信息。

接口

  1. /**
  2. * 查询指定表的结构信息和预留读/写吞吐量设置信息。
  3. */
  4. describeTable(params, callback)

示例

  1. var client = require('./client');
  2. var params = {
  3. tableName: 'sampleTable'
  4. };
  5. client.describeTable(params, function (err, data) {
  6. if (err) {
  7. console.log('error:', err);
  8. return;
  9. }
  10. console.log('success:', data);
  11. });

说明:详细代码可在 describeTable@GitHub 获取。

删除表(DeleteTable)

删除本实例下指定的表。

接口

  1. /**
  2. * 删除本实例下指定的表。
  3. */
  4. deleteTable(params, callback)

示例

删除表。

  1. var client = require('./client');
  2. var params = {
  3. tableName: 'sampleTable'
  4. };
  5. client.deleteTable(params, function (err, data) {
  6. if (err) {
  7. console.log('error:', err);
  8. return;
  9. }
  10. console.log('success:', data);
  11. });

说明:详细代码可在 deleteTable@GitHub 获取。

本文导读目录