赛尔校园公共服务平台 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
赛尔校园公共服务平台 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 表格存储
  4. 开发参考
  5. SDK参考
  6. Node.js SDK
  7. 初始化Tablestore Client

初始化Tablestore Client

  • Node.js SDK
  • 发布于 2025-04-22
  • 0 次阅读
文档编辑
文档编辑

Tablestore Client是表格存储的客户端,它提供了一系列的方法,可以用来操作表格存储的表和数据。本文介绍如何在Node.js中进行Tablestore Client的初始化。

重要

本文以阿里云账号的AccessKey为例为您介绍如何初始化Tablestore Client,如果您想使用RAM用户的访问密钥或STS临时访问凭证进行初始化,请参见使用RAM用户访问密钥访问表格存储和使用STS临时访问凭证访问表格存储。

准备工作

初始化Tablestore Client前,您需要获取实例的相关信息、安装Tablestore SDK并配置访问凭证。

获取实例信息

  • 地域ID:实例所在地域的ID,例如华东1(杭州)的地域ID为cn-hangzhou。

  • 实例名称和访问地址:每个表格存储实例对应一个访问地址(Endpoint),应用程序进行表和数据操作时需要指定访问地址,获取方式如下。

    1. 登录表格存储控制台。

    2. 在页面上方,选择资源组和地域。

    3. 在概览页面,单击实例别名或在操作列单击实例管理。

    4. 在实例详情页签,查看实例的名称和访问地址。

      重要

      新创建的实例默认未启用公网访问功能。如果您需要通过公网访问实例中的资源,则必须开启实例的公网访问功能。

安装Tablestore SDK

通过npm执行如下命令安装表格存储Node.js SDK。

npm install tablestore
说明

如果使用npm遇到网络问题,您可以使用淘宝提供的npm镜像。具体网址请参见cnpm。

更多关于安装Tablestore SDK的信息,请参见安装Tablestore SDK

配置访问凭证

使用Tablestore SDK发起请求访问表格存储,您需要配置访问凭证,阿里云服务会通过访问凭证验证您的身份信息和访问权限。

本文以阿里云账号的AccessKey为例为您介绍如何配置访问凭证。AccessKey的获取方式,请参见如何获取AccessKey。

直接在代码中保存访问凭证容易导致信息泄露,建议您将访问凭证保存在系统环境变量中。

Windows

以管理员身份运行命令提示符,执行以下命令。

# 配置 AccessKey ID
setx TABLESTORE_ACCESS_KEY_ID your_access_key_id /m
# 配置 AccessKey Secret
setx TABLESTORE_ACCESS_KEY_SECRET your_access_key_secret /m

macOS/Linux/Unix

# 配置 AccessKey ID
export TABLESTORE_ACCESS_KEY_ID=your_access_key_id
# 配置 AccessKey Secret
export TABLESTORE_ACCESS_KEY_SECRET=your_access_key_secret

更多关于配置访问凭证的信息,请参见配置访问凭证。

初始化Client

您需要先初始化一个Client,然后调用该Client的方法来访问表格存储服务。表格存储Node.js SDK提供了宽表模型客户端。

宽表模型

以下示例代码用于初始化Tablestore Client,获取实例中的所有数据表名称并打印到控制台。

// 此处为相对路径,请根据实际情况进行调整。
var TableStore = require('../index.js');

// yourInstanceName 填写您的实例名称
var instancename = 'yourInstanceName';
// yourEndpoint 填写您的实例访问地址
var endpoint = 'yourEndpoint';
// 获取环境变量里的 AccessKey ID 和 AccessKey Secret
var accessKeyId = process.env.TABLESTORE_ACCESS_KEY_ID;
var secretAccessKey = process.env.TABLESTORE_ACCESS_KEY_SECRET;

// 初始化 Tablestore Client
var client = new TableStore.Client({
  accessKeyId: accessKeyId,
  secretAccessKey: secretAccessKey,
  endpoint: endpoint,
  instancename: instancename 
});

// 列出实例中的数据表列表并打印到控制台
client.listTable({}, function (err, data) {
    if (err) {
        console.log('error:', err);
        return;
    }
    console.log('success:', data);
});  

常见问题

  • 使用表格存储SDK时出现Signature mismatch异常

  • 使用SDK访问表格存储时出现Request denied by instance ACL policies异常

  • 使用SDK访问表格存储时出现Request denied because this instance can only be accessed from the binded VPC异常

相关文章

安装表格存储Node.js SDK 2025-04-22 14:23

安装表格存储Node.js SDK后,即可在编写代码时调用

配置访问凭证 2025-04-22 14:23

使用Node.js SDK发起请求访问Tablestore,您需要配置访问凭证。阿里云服务会通过访问凭证验证您的身份信息和访问权限。您可以根据使用场景对认证和授权的要求,配置不同类型的访问凭证。 前提条件 配置访问凭证前,您需要完成安装

初始化Tablestore Client 2025-04-22 14:23

Tablestore Client是表格存储的客户端,它提供了一系列的方法,可以用来操作

数据类型 2025-04-22 14:23

本文介绍表格存储提供的五种数据类型与Node.js SDK数据类型的对应关系。 说明 表格存储的数据类型请参见

创建数据表 2025-04-22 14:23

本文将通过参数说明和示例代码为您介绍如何使用 Node.js SDK 创建数据表。在创建数据表时,您需要指定数据表的结构信息和配置信息。CU 模式(原按量模式)下高性能型实例中的数据表还可以根据需要设置预留读写吞吐量。

更新表配置 2025-04-22 14:23

本文将通过参数说明和示例代码为您介绍如何使用 Node.js SDK 更新表配置。在更新数据表时,您可以修改表的配置信息(例如数据生命周期、最大版本数、有效版本偏差等)和 Stream 配置。此外,您还可以为 CU 模式(原按量模式)下高性能型实例中数据表调整预留读写吞吐量。

目录
Copyright © 2025 your company All Rights Reserved. Powered by 赛尔网络.
京ICP备14022346号-15
gongan beian 京公网安备11010802041014号