Tablestore Client是表格存储的客户端，它提供了一系列的方法，可以用来操作表格存储的表和数据。本文介绍如何在 .NET中进行Tablestore Client的初始化。
本文以阿里云账号的AccessKey为例为您介绍如何初始化Tablestore Client，如果您想使用RAM用户的访问密钥或STS临时访问凭证进行初始化，请参见使用RAM用户访问密钥访问表格存储和使用STS临时访问凭证访问表格存储。
注意事项
表格存储 .NET SDK支持使用多线程。使用多线程时，建议共用一个Tablestore Client对象。
准备工作
初始化Tablestore Client前，您需要获取实例的相关信息、安装Tablestore SDK并配置访问凭证。
获取实例信息
地域ID：实例所在地域的ID，例如华东1（杭州）的地域ID为cn-hangzhou。
实例名称和访问地址：每个表格存储实例对应一个访问地址（Endpoint），应用程序进行表和数据操作时需要指定访问地址，获取方式如下。
登录表格存储控制台。
在页面上方，选择资源组和地域。
在概览页面，单击实例别名或在操作列单击实例管理。
在实例详情页签，查看实例的名称和访问地址。
重要新创建的实例默认未启用公网访问功能。如果您需要通过公网访问实例中的资源，则必须开启实例的公网访问功能。
安装Tablestore SDK
具体操作，请参见安装Tablestore SDK。
配置访问凭证
您需要为阿里云账号或RAM用户创建AccessKey，并按如下方式将AccessKey配置到环境变量中。
配置完成后请重启或刷新您的编译运行环境，包括 IDE、命令行界面、其它桌面应用程序及后台服务，确保最新的系统环境变量成功加载。更多关于配置访问凭证的信息，请参见配置访问凭证。
Linux
在命令行界面执行以下命令来将环境变量设置追加到
~/.bashrc文件中。echo "export TABLESTORE_ACCESS_KEY_ID='YOUR_ACCESS_KEY_ID'" >> ~/.bashrc echo "export TABLESTORE_ACCESS_KEY_SECRET='YOUR_ACCESS_KEY_SECRET'" >> ~/.bashrc执行以下命令使变更生效。
source ~/.bashrc执行以下命令检查环境变量是否生效。
echo $TABLESTORE_ACCESS_KEY_ID echo $TABLESTORE_ACCESS_KEY_SECRET
macOS
在终端中执行以下命令，查看默认 Shell 类型。
echo $SHELL根据默认 Shell 类型进行操作。
Zsh
执行以下命令来将环境变量设置追加到
~/.zshrc文件中。echo "export TABLESTORE_ACCESS_KEY_ID='YOUR_ACCESS_KEY_ID'" >> ~/.zshrc echo "export TABLESTORE_ACCESS_KEY_SECRET='YOUR_ACCESS_KEY_SECRET'" >> ~/.zshrc执行以下命令使变更生效。
source ~/.zshrc执行以下命令检查环境变量是否生效。
echo $TABLESTORE_ACCESS_KEY_ID echo $TABLESTORE_ACCESS_KEY_SECRET
Bash
执行以下命令来将环境变量设置追加到
~/.bash_profile文件中。echo "export TABLESTORE_ACCESS_KEY_ID='YOUR_ACCESS_KEY_ID'" >> ~/.bash_profile echo "export TABLESTORE_ACCESS_KEY_SECRET='YOUR_ACCESS_KEY_SECRET'" >> ~/.bash_profile执行以下命令使变更生效。
source ~/.bash_profile执行以下命令检查环境变量是否生效。
echo $TABLESTORE_ACCESS_KEY_ID echo $TABLESTORE_ACCESS_KEY_SECRET
Windows
CMD
在CMD中运行以下命令设置环境变量。
setx TABLESTORE_ACCESS_KEY_ID "YOUR_ACCESS_KEY_ID" setx TABLESTORE_ACCESS_KEY_SECRET "YOUR_ACCESS_KEY_SECRET"重启CMD后，运行以下命令，检查环境变量是否生效。
echo %TABLESTORE_ACCESS_KEY_ID% echo %TABLESTORE_ACCESS_KEY_SECRET%
PowerShell
在PowerShell中运行以下命令。
[Environment]::SetEnvironmentVariable("TABLESTORE_ACCESS_KEY_ID", "YOUR_ACCESS_KEY_ID", [EnvironmentVariableTarget]::User) [Environment]::SetEnvironmentVariable("TABLESTORE_ACCESS_KEY_SECRET", "YOUR_ACCESS_KEY_SECRET", [EnvironmentVariableTarget]::User)运行以下命令，检查环境变量是否生效。
[Environment]::GetEnvironmentVariable("TABLESTORE_ACCESS_KEY_ID", [EnvironmentVariableTarget]::User) [Environment]::GetEnvironmentVariable("TABLESTORE_ACCESS_KEY_SECRET", [EnvironmentVariableTarget]::User)
初始化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 InitializeClient()
{
// 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 client = new OTSClient(config);
// 列出实例中的数据表列表并打印
ListTableResponse response = client.ListTable(new ListTableRequest());
foreach (var tableName in response.TableNames)
{
Console.WriteLine(tableName);
}
}
catch (Exception ex)
{
Console.WriteLine("List table failed, exception:{0}", ex.Message);
}
}
}
}