Tablestore：Python SDK

Prasyarat

Unduh dan instal Python. Jalankan perintah python3 --version untuk memeriksa versi Python Anda.

Mulai dari versi 6.0.0, Python SDK 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 berjalan dengan benar.

pip3 install tablestore

Konfigurasikan kredensial akses

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

Setelah konfigurasi selesai, restart atau refresh lingkungan pengembangan Anda, termasuk IDE, antarmuka baris perintah, 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.

Inisialisasi client

Kode berikut menginisialisasi klien Tablestore dan mencantumkan semua tabel data serta tabel deret waktu dalam instans tertentu untuk memverifikasi koneksi.

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

import os
import sys
from tablestore import OTSClient

def main():
    try:
        # Dapatkan kredensial akses dari variabel lingkungan. Pastikan TABLESTORE_ACCESS_KEY_ID dan TABLESTORE_ACCESS_KEY_SECRET telah disetel.
        access_key_id = os.getenv("TABLESTORE_ACCESS_KEY_ID")
        access_key_secret = os.getenv("TABLESTORE_ACCESS_KEY_SECRET")

        # TODO: Ganti nilai berikut dengan detail instans Anda.
        instance_name = "n01k********"  # Nama instans
        endpoint = "https://n01k********.cn-hangzhou.ots.aliyuncs.com"  # Titik akhir instans
        
        # Buat instans client.
        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 deret waktu.
        resp = client.list_timeseries_table()

        print(f"\nFound {len(resp)} time series 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"?

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"?

[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"?

[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 mengakses sumber daya Tablestore melalui HTTPS?

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

Apa yang harus saya lakukan jika versi protobuf tidak kompatibel?

Beberapa versi protobuf tidak kompatibel dengan file *pb2.py dalam paket instalasi saat ini. Untuk mengatasi masalah ini, buat ulang file *pb2.py secara manual:

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.

Gunakan tool Credentials untuk membaca kredensial akses

1. Jalankan perintah berikut untuk menginstal paket alibabacloud_credentials.

   pip3 install alibabacloud_credentials

2. Konfigurasikan variabel lingkungan.

   Setel variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET ke ID AccessKey dan rahasia AccessKey Akun Alibaba Cloud Anda.

3. Baca kredensial akses.

   Kode berikut 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