Tablestore：Python SDK

準備環境

下載並安裝Python運行環境，通過 python --version 命令查看Python版本資訊。

Python SDK 從 6.0.0 版本開始僅支援 Python 3，不再支援 Python 2。如需使用 Python 2，請選擇 5.4.4 及之前的版本。

安裝SDK

根據開發環境選擇合適的安裝方式。推薦使用最新版本的SDK，確保程式碼範例正常運行。

pip install tablestore

配置訪問憑證

為阿里雲帳號或RAM使用者建立AccessKey，並按如下方式將AccessKey配置到環境變數中。通過環境變數配置AccessKey可避免在代碼中寫入程式碼敏感資訊，提升安全性。

配置完成後請重啟或重新整理編譯運行環境，包括IDE、命令列介面、其它傳統型應用程式及後台服務，確保最新的系統內容變數成功載入。更多訪問憑證類型，請參見配置訪問憑證。

初始化用戶端

以下範例程式碼初始化用戶端，並通過列舉Table Store執行個體下的資料表和時序表進行串連驗證。

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

import os
import sys
from tablestore import OTSClient

def main():
    try:
        # 從環境變數中擷取訪問憑證（需要配置TABLESTORE_ACCESS_KEY_ID和TABLESTORE_ACCESS_KEY_SECRET）
        access_key_id = os.getenv("TABLESTORE_ACCESS_KEY_ID")
        access_key_secret = os.getenv("TABLESTORE_ACCESS_KEY_SECRET")

        # TODO: 根據執行個體資訊修改以下配置
        instance_name = "n01k********"  # 填寫執行個體名稱
        endpoint = "https://n01k********.cn-hangzhou.ots.aliyuncs.com"  # 填寫執行個體訪問地址
        
        # 建立用戶端執行個體
        client = OTSClient(endpoint, access_key_id, access_key_secret, instance_name)

        # 列舉資料表
        resp = client.list_table()

        print(f"在執行個體 '{instance_name}' 中共找到 {len(resp)} 個資料表:")
        for table_name in resp:
            print(f"{table_name}")

        # 列舉時序表
        resp = client.list_timeseries_table()

        print(f"\n在執行個體 '{instance_name}' 中共找到 {len(resp)} 個時序表:")
        for tableMeta in resp:
            print(f"{tableMeta.timeseries_table_name}")
            
    except Exception as e:
        print(f"操作失敗: {str(e)}")
        sys.exit(1)


if __name__ == "__main__":
    main()

使用SDK時出現Signature mismatch異常？

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

使用SDK時出現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

使用SDK時出現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

如何使用HTTPS協議訪問Table Store資源？

使用最新版本的Python SDK，並且確保OpenSSL版本最少為0.9.8j，推薦OpenSSL 1.0.2d。

部分protobuf版本不相容？

部分protobuf版本無法和當前安裝包中的*pb2.py檔案相容，可以通過手動產生*pb2.py檔案的方式嘗試解決。具體操作如下：

1. 使用自己目前的版本的protoc依次產生對應proto檔案的代碼。

   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. 將產生的3個檔案更名為pb2.py尾碼，然後拷貝檔案到安裝目錄下的tablestore/protobuf/目錄中，替換掉原有的*pb2.py檔案。

如何使用Credentials工具讀取存取憑證？

1. 執行以下命令安裝alibabacloud_credentials包。

   pip install alibabacloud_credentials

2. 配置環境變數。

   配置環境變數ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET，分別代表阿里雲帳號的AccessKey ID和AccessKey Secret。

3. 讀取存取憑證。

   以下範例程式碼使用Credentials工具讀取環境變數的訪問憑證。

   # -*- coding: utf-8 -*-
   from alibabacloud_credentials.client import Client as CredClient
   
   # 使用 CredClient 擷取環境變數裡的 AccessKey ID 和 AccessKey Secret
   cred = CredClient()
   access_key_id = cred.get_credential().access_key_id
   access_key_secret = cred.get_credential().access_key_secret