Tablestore Client是表格存储的客户端,它提供了一系列的方法,可以用来操作表格存储的表和数据。本文介绍如何在 .NET中进行Tablestore Client的初始化。
重要
本文以阿里云账号的AccessKey为例为您介绍如何初始化Tablestore Client,如果您想使用RAM用户的访问密钥或STS临时访问凭证进行初始化,请参见使用RAM用户访问密钥访问表格存储和使用STS临时访问凭证访问表格存储。
注意事项
表格存储 .NET SDK支持使用多线程。使用多线程时,建议共用一个Tablestore Client对象。
准备工作
初始化Tablestore Client前,您需要获取实例的相关信息、安装Tablestore SDK并配置访问凭证。
获取实例信息
安装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的方法来访问表格存储服务。表格存储 .NET SDK提供了宽表模型客户端OTSClient。
宽表模型
以下示例代码用于初始化Tablestore Client,获取实例中的所有数据表名称并打印到控制台。
using Aliyun.OTS.Request;
using Aliyun.OTS.Response;
using System;
namespace Aliyun.OTS.Samples
{
public class Sample
{
public static void Main()
{
// yourEndpoint 填写您的实例访问地址
string endpoint = "yourEndpoint";
// yourInstanceName 填写您的实例名称
string instanceName = "yourInstanceName";
// 获取环境变量里的 AccessKey ID 和 AccessKey Secret
string accessKeyId = Environment.GetEnvironmentVariable("TABLESTORE_ACCESS_KEY_ID");
string accessKeySecret = Environment.GetEnvironmentVariable("TABLESTORE_ACCESS_KEY_SECRET");
OTSClientConfig config = new OTSClientConfig(endpoint, accessKeyId, accessKeySecret, instanceName)
{
OTSDebugLogHandler = null,
OTSErrorLogHandler = null
};
try
{
// 初始化Tablestore Client
OTSClient otsClient = new OTSClient(config);
// 列出实例中的数据表列表并打印
ListTableResponse response = otsClient.ListTable(new ListTableRequest());
foreach (var tableName in response.TableNames)
{
Console.WriteLine(tableName);
}
}
catch (Exception ex)
{
Console.WriteLine("List table failed, exception:{0}", ex.Message);
}
}
}
}
常见问题
该文章对您有帮助吗?