Tablestore:Python SDK

Requisitos previos

Descargue e instale el entorno de ejecución de Python. Ejecute el comando python3 --version para comprobar su versión de Python.

A partir de la versión 6.0.0, el SDK de Python solo es compatible con Python 3 y ya no admite Python 2. Si necesita usar Python 2, debe utilizar la versión 5.4.4 o una anterior.

Instalar el SDK

Seleccione un método de instalación. Utilice la versión más reciente del SDK para asegurar que los ejemplos de código se ejecuten correctamente.

pip3 install tablestore

Configurar las credenciales de acceso

Obtenga Create an AccessKey para su cuenta de Alibaba Cloud o usuario de RAM. Después, configúrelas como variable de entorno para evitar codificarlas directamente en el código.

Reinicie su IDE, terminal, otras aplicaciones de escritorio y servicios en segundo plano después de configurar las variables. Así se cargarán las variables de entorno actualizadas. Para obtener más información sobre otros tipos de credenciales de acceso, consulte Configure access credentials .

Inicializar el cliente

El código a continuación inicializa un cliente. También enumera todas las tablas de datos y de series de tiempo de una instancia para comprobar la conectividad.

#!/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()

¿Qué hago si ocurre el error "Signature mismatch"?

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

¿Qué hago si ocurre el 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

¿Qué hago si ocurre el 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

¿Cómo accedo a los recursos de Tablestore mediante HTTPS?**

Utilice la versión más reciente del SDK de Python. Asegúrese de que su versión de OpenSSL sea 0.9.8j o posterior; se recomienda OpenSSL 1.0.2d.

¿Qué hago si las versiones de protobuf son incompatibles?

Algunas versiones de protobuf son incompatibles con los archivos *pb2.py del paquete de instalación. Para resolverlo, regenere los archivos *pb2.py:

1. Use su versión actual de protoc para generar el código de los archivos 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. Cambie el nombre de los archivos generados para que tengan la extensión pb2.py. Luego cópielos a tablestore/protobuf/ dentro del directorio de instalación y reemplace los archivos *pb2.py originales.

Usar la herramienta Credentials para leer las credenciales de acceso

1. Ejecute el siguiente comando para instalar el paquete alibabacloud_credentials.

   pip3 install alibabacloud_credentials

2. Configure las variables de entorno.

   Establezca ALIBABA_CLOUD_ACCESS_KEY_ID y ALIBABA_CLOUD_ACCESS_KEY_SECRET con el AccessKey ID y el AccessKey secret de su cuenta de Alibaba Cloud.

3. Lea las credenciales de acceso.

   El código a continuación lee las credenciales de acceso desde las variables de entorno mediante la herramienta Credentials.

   # -*- 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