全部产品
Search
文档中心

:Inisialisasi Klien Tablestore

更新时间:Nov 04, 2025

Sebuah Tablestore klien menyediakan berbagai metode untuk melakukan operasi pada tabel dan data di Tablestore. Topik ini menjelaskan cara menggunakan Tablestore SDK untuk Python untuk menginisialisasi klien Tablestore.

Penting

Topik ini menggunakan Pasangan Kunci Akses dari akun Alibaba Cloud sebagai contoh. Untuk menginisialisasi klien menggunakan kredensial lainnya, lihat Gunakan Pasangan Kunci Akses Pengguna RAM untuk mengakses Tablestore dan Gunakan kredensial akses sementara dari STS untuk mengakses Tablestore.

Persiapan

Sebelum menginisialisasi klien Tablestore, peroleh informasi instans, instal Tablestore SDK, dan konfigurasikan kredensial akses.

Peroleh informasi tentang instans yang ingin Anda akses

  • ID Wilayah: ID wilayah dari instans. Sebagai contoh, ID wilayah China (Hangzhou) adalah cn-hangzhou.

  • Nama instans dan endpoint: Setiap Tablestore instans memiliki endpoint unik. Aplikasi Anda harus menentukan endpoint untuk melakukan operasi pada tabel dan data. Untuk memperoleh endpoint, lakukan langkah-langkah berikut:

    1. Masuk ke Konsol Tablestore.

    2. Di bilah navigasi atas, pilih kelompok sumber daya dan wilayah.

    3. Di halaman Overview, klik alias instans atau klik Manage Instance di kolom Actions.

    4. Di tab Instance Details, lihat nama instans dan endpoint.

      Penting

      Secara default, akses Internet dinonaktifkan untuk instans baru. Untuk mengakses sumber daya dalam instans melalui Internet, Anda harus mengaktifkan akses Internet untuk instans.

Instal Tablestore SDK untuk Python

Jalankan perintah berikut untuk menggunakan pip menginstal Tablestore SDK untuk Python:

sudo pip install tablestore

Untuk informasi lebih lanjut, lihat Instal Tablestore SDK untuk Python.

Konfigurasikan kredensial akses

Buat Pasangan Kunci Akses untuk akun Alibaba Cloud atau Pengguna RAM Anda, lalu konfigurasikan Pasangan Kunci Akses sebagai variabel lingkungan.

Catatan

Setelah menyelesaikan konfigurasi, mulai ulang atau segarkan lingkungan pengembangan Anda, seperti IDE, antarmuka baris perintah, aplikasi desktop, atau layanan latar belakang, untuk memuat variabel lingkungan sistem terbaru. Untuk informasi lebih lanjut, lihat Konfigurasikan kredensial akses.

Linux

  1. Jalankan perintah berikut di antarmuka baris perintah 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
  2. Jalankan perintah berikut untuk membuat perubahan berlaku:

    source ~/.bashrc
  3. Jalankan perintah berikut untuk memeriksa apakah variabel lingkungan berlaku:

    echo $TABLESTORE_ACCESS_KEY_ID
    echo $TABLESTORE_ACCESS_KEY_SECRET

macOS

  1. Jalankan perintah berikut di terminal untuk memeriksa jenis Shell default.

    echo $SHELL
  2. Lakukan operasi berdasarkan jenis Shell default.

    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 membuat perubahan berlaku:

      source ~/.zshrc
    3. Jalankan perintah berikut untuk memeriksa apakah variabel lingkungan berlaku:

      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 membuat perubahan berlaku:

      source ~/.bash_profile
    3. Jalankan perintah berikut untuk memeriksa apakah variabel lingkungan berlaku:

      echo $TABLESTORE_ACCESS_KEY_ID
      echo $TABLESTORE_ACCESS_KEY_SECRET

Windows

CMD
  1. Jalankan perintah berikut di CMD untuk menetapkan variabel lingkungan.

    setx TABLESTORE_ACCESS_KEY_ID "YOUR_ACCESS_KEY_ID"
    setx TABLESTORE_ACCESS_KEY_SECRET "YOUR_ACCESS_KEY_SECRET"
  2. Setelah memulai ulang CMD, jalankan perintah berikut untuk memeriksa apakah variabel lingkungan berlaku:

    echo %TABLESTORE_ACCESS_KEY_ID%
    echo %TABLESTORE_ACCESS_KEY_SECRET%
PowerShell
  1. 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)
  2. Jalankan perintah berikut untuk memeriksa apakah variabel lingkungan berlaku:

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

Inisialisasi klien

Anda harus menginisialisasi klien dan memanggil metode yang disediakan oleh klien untuk mengakses Tablestore. Tablestore SDK untuk Python menyediakan OTSClient.

Penting

Jika Anda ingin mengakses Tablestore sumber daya melalui HTTPS, kami sarankan Anda menggunakan Tablestore SDK untuk Python V6.x.x dan pastikan versi OpenSSL adalah 0.9.8j atau lebih baru. Kami sarankan Anda menggunakan OpenSSL 1.0.2d.

Paket rilis untuk Tablestore SDK untuk Python berisi paket certifi yang dapat Anda instal dan gunakan langsung. Untuk memperbarui sertifikat root, unduh sertifikat root terbaru dari situs resmi certifi.

Model Kolom Lebar

Kode sampel berikut memberikan contoh tentang cara menginisialisasi klien, menanyakan daftar tabel data dalam instans, dan menampilkan daftar di konsol:

# -*- coding: utf-8 -*-
import os
from tablestore import OTSClient

# Tentukan nama instans.
instance_name = "yourInstanceName"
# Tentukan endpoint instans.
endpoint = "yourEndpoint"
# Dapatkan AccessKey ID dan rahasia AccessKey dari variabel lingkungan.
access_key_id = os.getenv("TABLESTORE_ACCESS_KEY_ID")
access_key_secret = os.getenv("TABLESTORE_ACCESS_KEY_SECRET")

# Inisialisasi klien Tablestore
client = OTSClient(endpoint, access_key_id, access_key_secret, instance_name)

# Tanyakan daftar tabel data dalam instans dan tampilkan daftar di konsol
resp = client.list_table()
for table_name in resp:
    print(table_name)

Model Deret Waktu

Kode sampel berikut memberikan contoh tentang cara menginisialisasi klien, menanyakan daftar tabel deret waktu dalam instans, dan menampilkan daftar di konsol:

# -*- coding: utf-8 -*-
import os
from tablestore import OTSClient

# Tentukan nama instans.
instance_name = "yourInstanceName"
# Tentukan endpoint instans.
endpoint = "yourEndpoint"
# Dapatkan AccessKey ID dan rahasia AccessKey dari variabel lingkungan.
access_key_id = os.getenv("TABLESTORE_ACCESS_KEY_ID")
access_key_secret = os.getenv("TABLESTORE_ACCESS_KEY_SECRET")

# Inisialisasi klien Tablestore
client = OTSClient(endpoint, access_key_id, access_key_secret, instance_name)

# Tanyakan daftar tabel deret waktu dalam instans dan tampilkan daftar di konsol
response = client.list_timeseries_table()
for tableMeta in response:
    print(tableMeta.timeseries_table_name)

Anda juga bisa gunakan Alat Kredensial untuk membaca kredensial akses.

FAQ

Lampiran: Gunakan Alat Kredensial untuk membaca kredensial akses

  1. Jalankan perintah berikut untuk menginstal paket alibabacloud_credentials:

    pip install alibabacloud_credentials
  2. Konfigurasikan variabel lingkungan.

    Konfigurasikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID untuk ID Kunci Akses akun Alibaba Cloud Anda dan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_SECRET untuk rahasia Kunci Akses akun Alibaba Cloud Anda.

  3. Baca kredensial akses.

    Kode sampel berikut memberikan contoh tentang cara menggunakan Alat Kredensial untuk membaca kredensial akses dari variabel lingkungan.

    # -*- coding: utf-8 -*-
    from alibabacloud_credentials.client import Client as CredClient
    
    # Gunakan CredClient untuk mendapatkan ID Kunci Akses dan rahasia Kunci Akses dari variabel lingkungan.
    cred = CredClient()
    access_key_id = cred.get_credential().access_key_id
    access_key_secret = cred.get_credential().access_key_secret