Tablestore:Python SDK

Prérequis

Téléchargez et installez l'environnement d'exécution Python. Exécutez la commande python3 --version pour vérifier votre version de Python.

À partir de la version 6.0.0, le SDK Python prend uniquement en charge Python 3 et ne prend plus en charge Python 2. Pour utiliser Python 2, vous devez utiliser la version 5.4.4 ou une version antérieure.

Installer le SDK

Sélectionnez une méthode d'installation. Utilisez la dernière version du SDK pour garantir le bon fonctionnement des exemples de code.

pip3 install tablestore

Configurer les identifiants d'accès

Créez un AccessKey pour votre compte Alibaba Cloud ou utilisateur RAM, puis configurez-le comme variable d'environnement afin d'éviter d'encoder les identifiants en dur.

Redémarrez votre IDE, votre terminal, vos autres applications de bureau et vos services en arrière-plan après la configuration pour charger les variables d'environnement mises à jour. Pour plus d'informations sur les autres types d'identifiants d'accès, consultez la rubrique Configurer les identifiants d'accès .

Initialiser le client

Le code suivant initialise un client et répertorie toutes les tables de données et les tables de séries temporelles d'une instance pour vérifier la connectivité.

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

Que faire en cas d'erreur « Signature mismatch » ?

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

Que faire en cas d'erreur « 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

Que faire en cas d'erreur « 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

Comment accéder aux ressources Tablestore via HTTPS ?

Utilisez la dernière version du SDK Python. Assurez-vous que votre version d'OpenSSL est la 0.9.8j ou une version ultérieure. La version 1.0.2d d'OpenSSL est recommandée.

Que faire en cas d'incompatibilité des versions de protobuf ?

Certaines versions de protobuf sont incompatibles avec les fichiers *pb2.py du package d'installation. Pour résoudre ce problème, régénérez les fichiers *pb2.py :

1. Utilisez votre version actuelle de protoc pour générer le code pour les fichiers 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. Renommez les fichiers générés avec l'extension pb2.py et copiez-les dans tablestore/protobuf/ du répertoire d'installation, en remplaçant les fichiers *pb2.py d'origine.

Utiliser l'outil Credentials pour lire les identifiants d'accès

1. Exécutez la commande suivante pour installer le package alibabacloud_credentials.

   pip3 install alibabacloud_credentials

2. Configurez les variables d'environnement.

   Définissez ALIBABA_CLOUD_ACCESS_KEY_ID et ALIBABA_CLOUD_ACCESS_KEY_SECRET sur l'AccessKey ID et l'AccessKey secret de votre compte Alibaba Cloud.

3. Lisez les identifiants d'accès.

   Le code suivant lit les identifiants d'accès à partir des variables d'environnement à l'aide de l'outil 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