Pengaturan Tablestore .NET SDK, instalasi NuGet, dan inisialisasi client - Tablestore

Gunakan Tablestore SDK untuk .NET guna mengelola data di tabel kolom lebar.

Quick start

Mulai menggunakan Tablestore SDK untuk .NET dengan menyiapkan lingkungan, menginstal SDK, dan menginisialisasi client.

Prasyarat

SDK ini dibangun di atas .NET Standard 2.0 dan mendukung platform serta runtime berikut:

Platform	Runtime
Windows	.NET Core 2.0 atau yang lebih baru, atau .NET Framework 4.0 atau yang lebih baru Visual Studio 2010 atau yang lebih baru
Linux dan macOS	.NET Core 2.0 atau yang lebih baru

Instal SDK

Instal Tablestore SDK untuk .NET dari NuGet atau dari kode sumber.

NuGet

Instal dengan .NET CLI:

dotnet add package Aliyun.TableStore.SDK

Atau, instal melalui NuGet Package Manager di Visual Studio:

Buka atau buat proyek di Visual Studio, lalu pilih Tools > NuGet Package Manager > Manage NuGet Packages for Solution.

Catatan
Jika NuGet belum terinstal di Visual Studio, unduh dan instal dari NuGet.
Cari aliyun.tablestore dan pilih Aliyun.TableStore.SDK dari hasil pencarian.
Pilih versi terbaru lalu klik Install. SDK akan secara otomatis ditambahkan ke proyek Anda.

Kode sumber

Impor kode sumber SDK ke dalam proyek Anda.

Clone repositori SDK dari GitHub:
```
git clone https://github.com/aliyun/aliyun-tablestore-csharp-sdk.git
```
Catatan
Jika Git belum terinstal, unduh dan instal dari Git.
Di Visual Studio, klik kanan Solution lalu pilih Add > Existing Project.
Pada kotak dialog, pilih file aliyun-tablestore-sdk.csproj lalu klik Open.
Klik kanan Project lalu pilih References > Add Reference. Pada kotak dialog, beralih ke tab Projects lalu pilih aliyun-tablestore-sdk.
Klik OK.

Konfigurasi kredensial akses

Buat AccessKey untuk Akun Alibaba Cloud atau Pengguna RAM Anda. Kemudian, konfigurasikan AccessKey tersebut dalam variabel lingkungan seperti yang ditunjukkan di bawah. Mengonfigurasi AccessKey dalam variabel lingkungan meningkatkan keamanan karena mencegah penyematan informasi sensitif langsung di dalam kode.

Setelah konfigurasi selesai, Anda harus me-restart atau merefresh lingkungan pengembangan Anda, termasuk IDE, command-line interface, aplikasi desktop lainnya, dan layanan latar belakang, agar variabel lingkungan sistem terbaru dimuat. Untuk informasi lebih lanjut mengenai jenis kredensial akses lainnya, lihat Konfigurasi kredensial akses.

Linux

Jalankan perintah berikut untuk menambahkan pengaturan variabel lingkungan ke file ~/.bashrc.

echo "export TABLESTORE_ACCESS_KEY_ID='YOUR_ACCESS_KEY_ID'" >> ~/.bashrc
echo "export TABLESTORE_ACCESS_KEY_SECRET='YOUR_ACCESS_KEY_SECRET'" >> ~/.bashrc

Jalankan perintah berikut untuk menerapkan perubahan.
```
source ~/.bashrc
```
Jalankan perintah berikut untuk memverifikasi bahwa variabel lingkungan telah aktif.
```
echo $TABLESTORE_ACCESS_KEY_ID
echo $TABLESTORE_ACCESS_KEY_SECRET
```

macOS

Jalankan perintah berikut di terminal untuk melihat jenis shell default Anda.
```
echo $SHELL
```
Lakukan langkah-langkah berikut berdasarkan jenis shell default Anda.
Zsh
1. Jalankan perintah berikut untuk menambahkan pengaturan variabel lingkungan ke file ~/.zshrc.
```
echo "export TABLESTORE_ACCESS_KEY_ID='YOUR_ACCESS_KEY_ID'" >> ~/.zshrc
echo "export TABLESTORE_ACCESS_KEY_SECRET='YOUR_ACCESS_KEY_SECRET'" >> ~/.zshrc
```
2. Jalankan perintah berikut untuk menerapkan perubahan.
```
source ~/.zshrc
```
3. Jalankan perintah berikut untuk memverifikasi bahwa variabel lingkungan telah aktif.
```
echo $TABLESTORE_ACCESS_KEY_ID
echo $TABLESTORE_ACCESS_KEY_SECRET
```
Bash
1. Jalankan perintah berikut untuk menambahkan pengaturan variabel lingkungan ke file ~/.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. Jalankan perintah berikut untuk menerapkan perubahan.
```
source ~/.bash_profile
```
3. Jalankan perintah berikut untuk memverifikasi bahwa variabel lingkungan telah aktif.
```
echo $TABLESTORE_ACCESS_KEY_ID
echo $TABLESTORE_ACCESS_KEY_SECRET
```

Windows

CMD

Jalankan perintah berikut di Command Prompt (CMD) untuk mengatur variabel lingkungan.

setx TABLESTORE_ACCESS_KEY_ID "YOUR_ACCESS_KEY_ID"
setx TABLESTORE_ACCESS_KEY_SECRET "YOUR_ACCESS_KEY_SECRET"

Restart CMD lalu jalankan perintah berikut untuk memverifikasi bahwa variabel lingkungan telah aktif.
```
echo %TABLESTORE_ACCESS_KEY_ID%
echo %TABLESTORE_ACCESS_KEY_SECRET%
```

PowerShell

Jalankan perintah berikut di 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)

Jalankan perintah berikut untuk memverifikasi bahwa variabel lingkungan telah aktif.

[Environment]::GetEnvironmentVariable("TABLESTORE_ACCESS_KEY_ID", [EnvironmentVariableTarget]::User)
[Environment]::GetEnvironmentVariable("TABLESTORE_ACCESS_KEY_SECRET", [EnvironmentVariableTarget]::User)

Inisialisasi client

SDK Tablestore untuk .NET bersifat thread-safe. Saat menggunakan beberapa thread, gunakan satu instans OTSClient secara bersama. Setelah menginisialisasi client, daftar semua tabel dalam instans tersebut untuk memverifikasi koneksi.

Penting

Akses jaringan publik dinonaktifkan secara default untuk instans baru. Untuk mengakses sumber daya instans melalui jaringan publik, aktifkan akses publik di Network Management.

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

namespace Aliyun.OTS.Samples
{
    public class Sample
    {
        public static void InitializeClient()
        {
            // Ganti yourEndpoint dengan titik akhir instans
            string endpoint = "yourEndpoint";
            // Ganti yourInstanceName dengan nama instans
            string instanceName = "yourInstanceName";
            // Dapatkan ID AccessKey dan AccessKey Secret dari variabel lingkungan
            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
            {
                // Inisialisasi client Tablestore
                OTSClient client = new OTSClient(config);
                // Daftar dan cetak semua tabel dalam instans
                ListTableResponse response = client.ListTable(new ListTableRequest());
                foreach (var tableName in response.TableNames)
                {
                    Console.WriteLine(tableName);
                }
            }
            catch (Exception ex)
            {
                Console.WriteLine("Gagal menampilkan daftar tabel, exception:{0}", ex.Message);
            }
        }
    }
}

Kompatibilitas versi

Versi terbaru SDK adalah 6.x.x. Berikut kompatibilitasnya dengan versi sebelumnya:

Versi	Kompatibilitas	Deskripsi
5.x.x	Compatible	N/A
4.x.x	Compatible	N/A
3.x.x	Compatible	N/A
2.x.x	Incompatible	Antarmuka berikut dihapus: `Condition.IGNORE`, `Condition.EXPECT_EXIST`, dan `Condition.EXPECT_NOT_EXIST`. Nama file DLL diubah dari Aliyun.dll menjadi Aliyun.TableStore.dll.

Untuk riwayat versi lengkap, lihat Riwayat Versi Tablestore SDK untuk .NET.

FAQ

Permasalahan umum yang terjadi saat menggunakan Tablestore SDK untuk .NET:

Referensi

Untuk informasi tentang penanganan error di Tablestore, lihat Penanganan error.