Tablestore:Python SDK

Ön Koşullar

Python çalışma zamanı ortamını indirin ve yükleyin. Python sürümünüzü kontrol etmek için python3 --version komutunu çalıştırın.

Python SDK'nın 6.0.0 ve sonraki sürümleri yalnızca Python 3'ü destekler; Python 2 artık desteklenmemektedir. Python 2 kullanmanız gerekiyorsa 5,4,4 veya önceki bir sürüm kullanın.

SDK'yı Yükleme

Bir yükleme yöntemi seçin. Kod örneklerinin doğru çalışmasını sağlamak için en son SDK sürümünü kullanın.

pip3 install tablestore

Erişim Kimlik Bilgilerini Yapılandırma

Alibaba Cloud hesabınız veya RAM kullanıcınız için bir AccessKey oluşturun ve kimlik bilgilerini doğrudan koda sabit kodlamamak amacıyla bu bilgileri ortam değişkeni olarak yapılandırın.

Güncellenmiş ortam değişkenlerinin yüklenmesi için yapılandırmadan sonra IDE'nizi, terminalinizi, diğer masaüstü uygulamalarınızı ve arka plan hizmetlerini yeniden başlatın. Diğer erişim kimlik bilgisi türleri hakkında daha fazla bilgi için bkz. Erişim kimlik bilgilerini yapılandırma .

İstemciyi Başlatma

Aşağıdaki kod, bir örnekteki tüm veri tablolarını ve zaman serisi tablolarını listeleyerek bağlantıyı doğrulamak üzere bir istemci başlatır.

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

import os
import sys
from tablestore import OTSClient

def main():
    try:
        # Get access credentials from environment variables. Ensure TABLESTORE_ACCESS_KEY_ID and TABLESTORE_ACCESS_KEY_SECRET are set.
        access_key_id = os.getenv("TABLESTORE_ACCESS_KEY_ID")
        access_key_secret = os.getenv("TABLESTORE_ACCESS_KEY_SECRET")

        # TODO: Replace the following values with your instance details.
        instance_name = "n01k********"  # Instance name
        endpoint = "https://n01k********.cn-hangzhou.ots.aliyuncs.com"  # Instance endpoint
        
        # Create a client instance.
        client = OTSClient(endpoint, access_key_id, access_key_secret, instance_name)

        # List the data tables.
        resp = client.list_table()

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

        # List the time series tables.
        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()

"Signature mismatch" hatası alırsam ne yapmalıyım?

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

"Request denied by instance ACL policies" hatası alırsam ne yapmalıyım?

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

"Request denied because this instance can only be accessed from the binded VPC" hatası alırsam ne yapmalıyım?

[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

Tablestore kaynaklarına HTTPS üzerinden nasıl erişirim?

Python SDK'nın en son sürümünü kullanın. OpenSSL sürümünüzün 0.9.8j veya üzeri olduğundan emin olun. OpenSSL 1.0.2d önerilir.

Protobuf sürümleri uyumsuzsa ne yapmalıyım?

Bazı protobuf sürümleri, kurulum paketindeki *pb2.py dosyalarıyla uyumsuz olabilir. Bu sorunu çözmek için *pb2.py dosyalarını yeniden oluşturun:

1. Mevcut protoc sürümünüzü kullanarak proto dosyaları için kod üretin.

   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. Oluşturulan dosyaların adını pb2.py uzantısıyla değiştirin ve bunları kurulum dizinindeki tablestore/protobuf/ klasörüne kopyalayarak orijinal *pb2.py dosyalarının üzerine yazın.

Credentials aracını kullanarak erişim kimlik bilgilerini okuma

1. alibabacloud_credentials paketini yüklemek için aşağıdaki komutu çalıştırın.

   pip3 install alibabacloud_credentials

2. Ortam değişkenlerini yapılandırın.

   ALIBABA_CLOUD_ACCESS_KEY_ID ve ALIBABA_CLOUD_ACCESS_KEY_SECRET değişkenlerini Alibaba Cloud hesabınızın AccessKey ID ve AccessKey secret değerlerine ayarlayın.

3. Erişim kimlik bilgilerini okuyun.

   Aşağıdaki kod, Credentials aracını kullanarak erişim kimlik bilgilerini ortam değişkenlerinden okur.

   # -*- coding: utf-8 -*-
   from alibabacloud_credentials.client import Client as CredClient
   
   # Use CredClient to get the AccessKey ID and AccessKey secret from the environment variables.
   cred = CredClient()
   access_key_id = cred.get_credential().access_key_id
   access_key_secret = cred.get_credential().access_key_secret