日本熟妇hd丰满老熟妇,中文字幕一区二区三区在线不卡 ,亚洲成片在线观看,免费女同在线一区二区

AI 助理
備案控制臺
文檔
輸入文檔關鍵字查找
首頁 表格存儲 開發參考 SDK參考 Node.js SDK 表操作 創建數據表

創建數據表

更新時間：
產品詳情
我的收藏

本文將通過參數說明和示例代碼為您介紹如何使用 Node.js SDK 創建數據表。在創建數據表時，您需要指定數據表的結構信息和配置信息。CU 模式（原按量模式）下高性能型實例中的數據表還可以根據需要設置預留讀寫吞吐量。

注意事項

  • 創建數據表后需要幾秒鐘進行加載，在此期間對該數據表的讀寫數據操作均會失敗。請等待數據表加載完畢后再進行數據操作。

  • 如果您有主鍵數據自增的需求，例如電商網站的商品 ID、論壇帖子的 ID 等場景，可以在創建數據時配置主鍵列自增。具體操作，請參見主鍵列自增。

前提條件

接口

/**
 * 說明：根據指定表結構信息創建數據表。
 * 當創建一個數據表后，通常需要等待幾秒鐘時間使partition load完成，才能進行各種操作。
 */
createTable(params, callback)

參數說明

params包含以下參數：

參數

說明

tableMeta（必選）

數據表的結構信息，包括如下內容：

  • tableName（必選）：數據表名稱。

  • primaryKey（必選）：數據表的主鍵定義。更多信息，請參見核心組件。

    • 主鍵數據類型可以為 STRING、INTEGER 或 BINARY。

    • 可以設置 1~4 個主鍵列。表格存儲將按照設置的順序生成主鍵，默認按升序進行排序。

    • 第一個主鍵列將作為分區鍵。

  • definedColumn（可選）：預定義列信息。數據類型可以為 STRING、INTEGER、DOUBLE 或 BOOLEAN。

    說明

    • 預定義列是預先定義的一些非主鍵列，通常被用作二級索引的主鍵列或預定義列，以實現快速查詢數據的需求。

    • 屬性列在創建表時無需定義，您可以在寫入數據時為每行數據指定不同的屬性列和列名。

tableOptions（必選）

數據表的配置信息，包括如下內容：

  • timeToLive（必選）：數據生命周期，即數據的過期時間，單位為秒。

    數據生命周期的取值最低為 86400 秒（一天），也可設置為 -1（永不過期）。

    重要

    如果要使用多元索引或二級索引，必須將數據生命周期設置為 -1，或者將 allowUpdate 參數設置為 false。

  • maxVersions（必選）：最大版本數，即屬性列能夠保留數據的最大版本個數。

    重要

    如果要使用多元索引或二級索引，最大版本數必須設置為 1。

  • maxTimeDeviation（可選）：有效版本偏差，即寫入數據的時間戳與系統當前時間的偏差允許最大值，單位為秒。

    默認值 86400 秒（一天）。屬性列的有效取值范圍是一個左閉右開的區間：[max{數據寫入時間-有效版本偏差,數據寫入時間-數據生命周期}，數據寫入時間+有效版本偏差)。

  • allowUpdate（可選）：是否允許更新。默認為true。

    重要

    如果要使用多元索引的生命周期功能，必須設置此參數為 false。如果您需要更新數據，可使用 PutRow 接口寫入數據。

indexMetas（可選）

索引列表。每個索引包含以下內容：

  • name（必選）：索引名稱。

  • primaryKey（必選）：索引的主鍵列。可以由數據表的主鍵列和預定義列組成。

    重要

    使用本地二級索引時，索引第一個主鍵列必須是數據表的第一個主鍵列。

  • definedColumn（可選）：索引的預定義列。可以由數據表的預定義列組成。

  • indexType（可選）：索引類型。取值范圍如下：

    • IT_GLOBAL_INDEX （默認值）：全局二級索引。

    • IT_LOCAL_INDEX：本地二級索引。

  • indexUpdateMode（可選）：索引更新模式。取值范圍如下：

    • IUM_ASYNC_INDEX（默認值）：異步更新。

      說明

      使用全局二級索引時，索引更新模式必須設置為異步更新。

    • IUM_SYNC_INDEX：同步更新。

      說明

      使用本地二級索引時，索引更新模式必須設置為同步更新。

reservedThroughput（必選）

預留讀寫吞吐量，單位為 CU。默認值為 0。

重要

僅 CU 模式下高性能型實例支持設置數據表的預留讀寫吞吐量為非零值。

streamSpecification（可選）

數據表的 Stream 配置信息，包括如下內容：

  • enableStream（可選）：是否開啟 stream。默認值為 false，即不開啟 stream。

  • expirationTime（可選）：stream 過期時間，表示增量日志過期時長。單位為小時，最大值為 168 小時（7 天）。

    說明

    開啟 stream 時，必須設置 expirationTime 參數。

示例

創建數據表

以下示例用于創建數據表。

var params = {
  tableMeta: {
    //設置數據表名稱。
    tableName: '<TABLE_NAME>',
    //設置數據表主鍵列。主鍵為pk1（String類型）和pk2（Integer類型），其中pk1主鍵列為分區鍵，pk2主鍵列為自增列。
    primaryKey: [
      {
        name: 'pk1',
        type: 'STRING'
      },
      {
        name: 'pk2',
        type: 'INTEGER',
        option: 'AUTO_INCREMENT'
      }
    ]
  },
  tableOptions: {
    //數據的過期時間，-1表示永不過期。
    timeToLive: -1,
    //最大版本數，屬性列值最多保留1個版本，即保存最新的版本。
    maxVersions: 1,
    //有效版本偏差，即寫入數據的時間戳與系統當前時間的偏差允許最大值為86400秒（1天）。
    maxTimeDeviation: 86400
  },
  //設置預留讀寫吞吐量，容量型實例下的數據表只能設置為0，高性能型實例下的數據表可以設置為非零值。
  reservedThroughput: {
    capacityUnit: {
      read: 0,
      write: 0
    }
  }
};

client.createTable(params, function (err, data) {
  if (err) {
    console.log('error:', err);
    return;
  }
  console.log('success:', data);
});

創建數據表時配置二級索引

創建數據表時配置全局二級索引

以下示例用于同時創建數據表和全局二級索引。

var params = {
  tableMeta: {
    //設置數據表名稱。  
    tableName: '<TABLE_NAME>',
    //設置數據表主鍵列。主鍵為pk1（String類型）和pk2（Integer類型）。
    primaryKey: [
      {
        name: 'pk1',
        type: 'STRING'
      },
      {
        name: 'pk2',
        type: 'INTEGER'
      }
    ],
    //設置數據表預定義列。預定義列為defcol1（String類型）和defcol2（Integer類型）。
    definedColumn: [
      {
        name: 'defcol1',
        type: TableStore.DefinedColumnType.DCT_STRING
      },
      {
        name: 'defcol2',
        type: TableStore.DefinedColumnType.DCT_INTEGER
      }
    ],
  },
  tableOptions: {
    //數據的過期時間，-1表示永不過期。
    timeToLive: -1,
    //最大版本數，屬性列值最多保留1個版本，即保存最新的版本。
    maxVersions: 1
  },
  //設置預留讀寫吞吐量，容量型實例下的數據表只能設置為0，高性能型實例下的數據表可以設置為非零值。
  reservedThroughput: {
    capacityUnit: {
      read: 0,
      write: 0
    }
  },
  indexMetas: [
    //索引類型默認為全局二級索引
    {
      //設置索引名稱。
      name: '<INDEX_NAME>',
      //為索引添加主鍵。主鍵列為defcol1、pk1和pk2。
      primaryKey: ['defcol1', 'pk1', 'pk2'],
      //為索引添加預定義列。預定義列為defcol2。
      definedColumn: ['defcol2']
    }
  ]
};

client.createTable(params, function (err, data) {
  if (err) {
    console.log('error:', err);
    return;
  }
  console.log('success:', data);
});

創建數據表時配置本地二級索引

以下示例用于同時創建數據表和本地二級索引。

var params = {
  tableMeta: {
    //設置數據表名稱。  
    tableName: '<TABLE_NAME>',
    //設置數據表主鍵列。主鍵為pk1（String類型）和pk2（Integer類型）。
    primaryKey: [
      {
        name: 'pk1',
        type: 'STRING'
      },
      {
        name: 'pk2',
        type: 'INTEGER'
      }
    ],
    //設置數據表預定義列。預定義列為defcol1（String類型）和defcol2（Integer類型）。
    definedColumn: [
      {
        name: 'defcol1',
        type: TableStore.DefinedColumnType.DCT_STRING
      },
      {
        name: 'defcol2',
        type: TableStore.DefinedColumnType.DCT_INTEGER
      }
    ],
  },
  tableOptions: {
    //數據的過期時間，-1表示永不過期。
    timeToLive: -1,
    //最大版本數，屬性列值最多保留1個版本，即保存最新的版本。
    maxVersions: 1,
  },
  //設置預留讀寫吞吐量，容量型實例下的數據表只能設置為0，高性能型實例下的數據表可以設置為非零值。
  reservedThroughput: {
    capacityUnit: {
      read: 0,
      write: 0
    }
  },
  indexMetas: [
    //本地二級索引
    {
      //設置索引名稱。
      name: '<INDEX_NAME>',
      //為索引添加主鍵。主鍵列為pk1、defcol1和pk2。
      primaryKey: ['pk1', 'defcol1', 'pk2'],
      //為索引添加預定義列。預定義列為defcol2。
      definedColumn: ['defcol2'],
      //設置索引類型為本地二級索引（IT_LOCAL_INDEX）。
      indexType: TableStore.IndexType.IT_LOCAL_INDEX,
      //設置索引更新模式為同步更新（IUM_SYNC_INDEX）。當索引類型為本地二級索引時，索引更新模式必須為同步更新。
      indexUpdateMode: TableStore.IndexUpdateMode.IUM_SYNC_INDEX
    }
  ]
};

client.createTable(params, function (err, data) {
  if (err) {
    console.log('error:', err);
    return;
  }
  console.log('success:', data);
});

相關文檔