Tablestore:.NET SDK

前提条件

この SDK は .NET Standard 2.0 をベースに構築されており、次のプラットフォームとランタイムをサポートしています。

SDK のインストール

Tablestore .NET SDK を NuGet またはソースコードからインストールします。

dotnet add package Aliyun.TableStore.SDK

アクセス認証情報の設定

Alibaba Cloud アカウントまたは RAM ユーザーの AccessKey を作成できます。次に、以下に示すように環境変数に AccessKey を設定します。環境変数に AccessKey を設定すると、機密情報がコードにハードコーディングされるのを防ぐことができるため、セキュリティが向上します。

設定が完了したら、IDE、コマンドラインインターフェイス、その他のデスクトップアプリケーション、バックグラウンドサービスなど、開発環境を再起動またはリフレッシュする必要があります。これにより、最新のシステム環境変数が確実に読み込まれます。他の種類のアクセス認証情報の詳細については、「アクセス認証情報の設定」をご参照ください。

クライアントの初期化

Tablestore .NET SDK はスレッドセーフです。複数のスレッドを使用する場合は、単一の OTSClient インスタンスを共有してください。クライアントを初期化した後、インスタンス内のすべてのテーブルをリスト表示して、接続を確認します。

using System;
using Aliyun.OTS;
using Aliyun.OTS.Request;
using Aliyun.OTS.Response;

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 クライアントを初期化します
                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("テーブルのリスト表示に失敗しました。例外：{0}", ex.Message);
            }
        }
    }
}