.NET 用 Tablestore SDK を使用して Tablestore クライアントを初期化する - Tablestore

Tablestore クライアントは Tablestore のクライアントであり、Tablestore のテーブルとデータに対する操作を実行するために使用できるさまざまなメソッドを提供します。このトピックでは、.NET 用 Tablestore SDK を使用して Tablestore クライアントを初期化する方法について説明します。

重要

このトピックでは、Alibaba Cloud アカウントの AccessKey ペアを例として使用します。他の認証情報を使用してクライアントを初期化する方法については、「RAM ユーザーの AccessKey ペアを使用して Tablestore にアクセスする」および「STS からの一時的なアクセス認証情報を使用して Tablestore にアクセスする」をご参照ください。

使用上の注意

.NET 用 Tablestore SDK はマルチスレッドをサポートしています。複数のスレッドで同じ Tablestore クライアントオブジェクトを共有することを推奨します。

準備

Tablestore クライアントを初期化する前に、インスタンス情報を取得し、Tablestore SDK をインストールし、アクセス認証情報を設定します。

アクセスするインスタンスに関する情報の取得

リージョン ID: インスタンスのリージョン ID。たとえば、中国 (杭州) のリージョン ID は cn-hangzhou です。
インスタンス名とエンドポイント: 各 Tablestore インスタンスには一意のエンドポイントがあります。アプリケーションは、テーブルとデータに対する操作を実行するためにエンドポイントを指定する必要があります。エンドポイントを取得するには、次の手順を実行します。
1. Tablestore コンソールにログインします。
2. 上部のナビゲーションバーで、リソースグループとリージョンを選択します。
3. [概要] ページで、インスタンスのエイリアスをクリックするか、[アクション] 列の [インスタンスの管理] をクリックします。
4. [インスタンス詳細] タブで、インスタンス名とエンドポイントを表示します。
  重要
  デフォルトでは、新しいインスタンスのインターネットアクセスは無効になっています。インターネット経由でインスタンス内のリソースにアクセスするには、インスタンスのインターネットアクセスを有効にする必要があります。

.NET 用 Tablestore SDK のインストール

詳細については、「.NET 用 Tablestore SDK のインストール」をご参照ください。

アクセス認証情報の設定

Alibaba Cloud アカウントまたは 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

ターミナルで次のコマンドを実行して、デフォルトのシェルタイプを確認します。
```
echo $SHELL
```
デフォルトのシェルタイプに基づいて操作を実行します。
Zsh
1. 次のコマンドを実行して、環境変数の設定を ~/.zshrc ファイルに追加します。
```
echo "export TABLESTORE_ACCESS_KEY_ID='YOUR_ACCESS_KEY_ID'" >> ~/.zshrc
echo "export TABLESTORE_ACCESS_KEY_SECRET='YOUR_ACCESS_KEY_SECRET'" >> ~/.zshrc
```
2. 次のコマンドを実行して、変更を有効にします。
```
source ~/.zshrc
```
3. 次のコマンドを実行して、環境変数が有効になっているか確認します。
```
echo $TABLESTORE_ACCESS_KEY_ID
echo $TABLESTORE_ACCESS_KEY_SECRET
```
Bash
1. 次のコマンドを実行して、環境変数の設定を ~/.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
```
2. 次のコマンドを実行して、変更を有効にします。
```
source ~/.bash_profile
```
3. 次のコマンドを実行して、環境変数が有効になっているか確認します。
```
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)

クライアントの初期化

クライアントを初期化し、クライアントが提供するメソッドを呼び出して Tablestore にアクセスする必要があります。.NET 用の Tablestore SDK は、Wide Column モデル用のクライアントを提供します。

Wide Column モデル

次のサンプルコードは、Tablestore クライアントを初期化し、インスタンス内のデータテーブルのリストをクエリし、そのリストを Tablestore コンソールに表示する方法の例を示しています。

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

namespace Aliyun.OTS.Samples
{
    public class Sample
    {
        public static void InitializeClient()
        {
            // インスタンスのエンドポイントを指定します。
            string endpoint = "yourEndpoint";
            // インスタンスの名前を指定します。
            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);
                // インスタンス内のデータテーブルのリストをクエリし、そのリストを Tablestore コンソールに表示します。
                ListTableResponse response = client.ListTable(new ListTableRequest());
                foreach (var tableName in response.TableNames)
                {
                    Console.WriteLine(tableName);
                }
            }
            catch (Exception ex)
            {
                Console.WriteLine("テーブルリストの取得に失敗しました、例外:{0}", ex.Message);
            }
        }
    }
}

Tablestore:Tablestore クライアントの初期化