Panduan pengguna Tablestore SDK untuk Go - Tablestore - Alibaba Cloud Documentation Center

Tablestore SDK for Go mendukung model WideColumn, TimeSeries, dan Timeline.

Quick start

Siapkan lingkungan Anda, instal Tablestore SDK for Go, lalu inisialisasi client.

Prasyarat

Go 1.4 atau versi yang lebih baru. Unduh Go dari halaman unduhan resmi Go.
IDE Go seperti GoLand atau Visual Studio Code dengan ekstensi Go.

Instal SDK

Jalankan go mod init <DIRNAME> di direktori proyek Anda untuk menghasilkan file go.mod, lalu jalankan perintah berikut untuk menginstal Tablestore SDK for Go.

Catatan

<DIRNAME> adalah path direktori proyek Anda.

go get github.com/aliyun/aliyun-tablestore-go-sdk/tablestore

Lihat program contoh untuk setiap model data di folder sample pada repositori Tablestore SDK for Go.

Konfigurasikan kredensial akses

Buat AccessKey untuk Akun Alibaba Cloud atau RAM user Anda, lalu konfigurasikan AccessKey tersebut dalam variabel lingkungan seperti yang ditunjukkan di bawah ini. Mengonfigurasi AccessKey dalam variabel lingkungan meningkatkan keamanan karena mencegah penyematan informasi sensitif secara langsung 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 tentang jenis kredensial akses lainnya, lihat Konfigurasikan 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

Setelah menginisialisasi client, daftarkan tabel data dan tabel time series dalam instans Anda untuk memverifikasi koneksi.

Penting

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

WideColumn

package main

import (
	"fmt"
	"os"
	"github.com/aliyun/aliyun-tablestore-go-sdk/tablestore"
)

func main() {
	// yourInstanceName: masukkan nama instans Anda
	instanceName := "yourInstanceName"
	// yourEndpoint: masukkan titik akhir instans Anda
	endpoint := "yourEndpoint"
	// Dapatkan ID AccessKey dan AccessKey Secret dari variabel lingkungan
	accessKeyId := os.Getenv("TABLESTORE_ACCESS_KEY_ID")
	accessKeySecret := os.Getenv("TABLESTORE_ACCESS_KEY_SECRET")

	// Inisialisasi client Tablestore
	client := tablestore.NewClient(endpoint, instanceName, accessKeyId, accessKeySecret)

	// Daftarkan tabel data dalam instans dan cetak ke konsol
	tables, err := client.ListTable()
	if err != nil {
		fmt.Println("Gagal mendaftarkan tabel")
	} else {
		for _, table := range tables.TableNames {
			fmt.Println(table)
		}
	}
}

TimeSeries

package main

import (
	"fmt"
	"os"
	"github.com/aliyun/aliyun-tablestore-go-sdk/tablestore"
)

func main() {
	// yourInstanceName: masukkan nama instans Anda
	instanceName := "yourInstanceName"
	// yourEndpoint: masukkan titik akhir instans Anda
	endpoint := "yourEndpoint"
	// Dapatkan ID AccessKey dan AccessKey Secret dari variabel lingkungan
	accessKeyId := os.Getenv("TABLESTORE_ACCESS_KEY_ID")
	accessKeySecret := os.Getenv("TABLESTORE_ACCESS_KEY_SECRET")

	// Inisialisasi client Tablestore
	client := tablestore.NewTimeseriesClient(endpoint, instanceName, accessKeyId, accessKeySecret)

	// Daftarkan tabel time series dalam instans dan cetak ke konsol
	timeseriesTables, err := client.ListTimeseriesTable()
	if err != nil {
		fmt.Println("Gagal mendaftarkan tabel")
	} else {
		for _, timeseriesTablesMeta := range timeseriesTables.GetTimeseriesTableMeta() {
			fmt.Println(timeseriesTablesMeta.GetTimeseriesTableName())
		}
	}
}

Kompatibilitas versi

Versi terbaru adalah 1.17.x. Semua versi baru kompatibel mundur dengan versi sebelumnya.

Untuk changelog SDK, lihat Riwayat versi Tablestore SDK untuk Go.

FAQ

Referensi

Untuk penanganan error di Tablestore, lihat Penanganan error.