Tablestore：Python SDK

Persiapkan lingkungan

Unduh dan instal lingkungan runtime Python. Jalankan perintah python --version untuk memeriksa versi Python Anda.

Mulai versi 6.0.0, SDK Python hanya mendukung Python 3 dan tidak lagi mendukung Python 2. Untuk menggunakan Python 2, gunakan versi 5.4.4 atau sebelumnya.

Instal SDK

Pilih metode instalasi berdasarkan lingkungan pengembangan Anda. Gunakan versi terbaru SDK agar contoh kode dapat dijalankan dengan benar.

pip install tablestore

Konfigurasikan kredensial akses

Buat AccessKey untuk Akun Alibaba Cloud atau Pengguna RAM Anda. Kemudian, 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, restart atau refresh lingkungan pengembangan Anda—termasuk IDE, antarmuka baris perintah, aplikasi desktop lainnya, serta layanan latar belakang—untuk memastikan variabel lingkungan sistem terbaru dimuat. Untuk informasi lebih lanjut tentang jenis kredensial akses lainnya, lihat Konfigurasikan kredensial akses.

Inisialisasi klien

Kode contoh berikut menginisialisasi klien, lalu mencantumkan tabel data dan tabel timeseries dalam instans Tablestore untuk mengautentikasi koneksi.

#!/usr/bin/env python3
# -*- coding: utf-8 -*-

import os
import sys
from tablestore import OTSClient

def main():
    try:
        # Ambil kredensial akses dari variabel lingkungan. Konfigurasikan TABLESTORE_ACCESS_KEY_ID dan TABLESTORE_ACCESS_KEY_SECRET.
        access_key_id = os.getenv("TABLESTORE_ACCESS_KEY_ID")
        access_key_secret = os.getenv("TABLESTORE_ACCESS_KEY_SECRET")

        # TODO: Ubah konfigurasi berikut sesuai detail instans Anda.
        instance_name = "n01k********"  # Masukkan nama instans.
        endpoint = "https://n01k********.cn-hangzhou.ots.aliyuncs.com"  # Masukkan titik akhir instans.
        
        # Buat instans klien.
        client = OTSClient(endpoint, access_key_id, access_key_secret, instance_name)

        # Cantumkan tabel data.
        resp = client.list_table()

        print(f"Found {len(resp)} data tables in instance '{instance_name}':")
        for table_name in resp:
            print(f"{table_name}")

        # Cantumkan tabel timeseries.
        resp = client.list_timeseries_table()

        print(f"\nFound {len(resp)} timeseries tables in instance '{instance_name}':")
        for tableMeta in resp:
            print(f"{tableMeta.timeseries_table_name}")
            
    except Exception as e:
        print(f"Operation failed: {str(e)}")
        sys.exit(1)


if __name__ == "__main__":
    main()

Apa yang harus saya lakukan jika terjadi error "Signature mismatch" saat menggunakan SDK?

Error Code: OTSAuthFailed, Message: Signature mismatch., RequestId: 0005f55a-xxxx-xxxx-xxxx-xxxxxxxxxxxx, TraceId: 10b0f0e0-xxxx-xxxx-xxxx-xxxxxxxxxxxx, HttpStatus: 403

Apa yang harus saya lakukan jika terjadi error "Request denied by instance ACL policies" saat menggunakan SDK?

[ErrorCode]:OTSAuthFailed, [Message]:Request denied by instance ACL policies., [RequestId]:XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX, [TraceId]:XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX, [HttpStatus:]403

Apa yang harus saya lakukan jika terjadi error "Request denied because this instance can only be accessed from the binded VPC" saat menggunakan SDK?

[ErrorCode]:OTSAuthFailed, [Message]:Request denied because this instance can only be accessed from the binded VPC., [RequestId]:XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX, [TraceId]:XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX, [HttpStatus:]403

Bagaimana cara menggunakan protokol HTTPS untuk mengakses sumber daya Tablestore?

Gunakan versi terbaru SDK Python. Pastikan versi OpenSSL Anda 0.9.8j atau lebih baru. Disarankan menggunakan OpenSSL 1.0.2d.

Apa yang harus dilakukan jika beberapa versi protobuf tidak kompatibel?

Beberapa versi protobuf tidak kompatibel dengan file *pb2.py dalam paket instalasi saat ini. Untuk mengatasi masalah ini, Anda dapat membuat file *pb2.py secara manual dengan langkah-langkah berikut:

1. Gunakan versi protoc Anda saat ini untuk menghasilkan kode untuk file proto yang sesuai secara berurutan.

   protoc --python_out=. tablestore/protobuf/search.proto
   protoc --python_out=. tablestore/protobuf/table_store.proto
   protoc --python_out=. tablestore/protobuf/table_store_filter.proto

2. Ubah nama ketiga file yang dihasilkan dengan ekstensi pb2.py. Lalu, salin file-file tersebut ke folder tablestore/protobuf/ dalam direktori instalasi untuk menggantikan file *pb2.py asli.

Bagaimana cara menggunakan tool Credentials 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 dan ALIBABA_CLOUD_ACCESS_KEY_SECRET. Variabel ini merepresentasikan ID AccessKey dan rahasia AccessKey Akun Alibaba Cloud Anda.

3. Baca kredensial akses.

   Kode contoh berikut menunjukkan cara menggunakan tool Credentials untuk membaca kredensial akses dari variabel lingkungan.

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