Utilisez le SDK Tablestore pour Python afin de mettre à jour les configurations TTL, de version, de mode de mise à jour et de débit réservé d'une table.
Prérequis
Installez le SDK Tablestore pour Python et initialisez un client.
Description de la fonction
Appelez la méthode update_table pour mettre à jour les configurations de table. Vous devez spécifier au moins l'un des paramètres table_options et reserved_throughput.
def update_table(
self,
table_name,
table_options=None,
reserved_throughput=None,
)L'exemple suivant modifie le TTL de example_table sur sept jours et désactive les mises à jour via la méthode update_row.
table_options = TableOptions(
time_to_live=604800,
max_version=1,
max_time_deviation=86400,
allow_update=False,
)
client.update_table(
"example_table",
table_options=table_options,
)Paramètres
La méthode update_table contient les paramètres suivants.
|
Nom |
Type |
Description |
|
table_name (obligatoire) |
|
Le nom de la table. |
|
table_options (facultatif) |
|
Les configurations de table à mettre à jour. Vous devez spécifier au moins ce paramètre ou |
|
reserved_throughput (facultatif) |
|
Le débit réservé à mettre à jour. Vous devez spécifier au moins ce paramètre ou |
Configurations de table
Le paramètre table_options est de type TableOptions et contient les paramètres suivants.
|
Nom |
Type |
Description |
|
time_to_live (facultatif) |
|
Le TTL des données en secondes. Une valeur de |
|
max_version (facultatif) |
|
Le nombre maximal de versions à conserver pour chaque colonne d'attribut. Pour utiliser un index de recherche ou un index secondaire, définissez ce paramètre sur |
|
max_time_deviation (facultatif) |
|
L'écart maximal de version en secondes. La différence entre l'horodatage des données à écrire et l'heure système actuelle doit se situer dans l'écart maximal de version. La plage de versions valide est |
|
allow_update (facultatif) |
|
Indique si les données peuvent être mises à jour en appelant |
Débit réservé
Le paramètre reserved_throughput est de type ReservedThroughput et contient le paramètre suivant.
|
Nom |
Type |
Description |
|
capacity_unit (obligatoire) |
|
Le débit réservé en unités de capacité (CU). Seules les instances haute performance en mode CU prennent en charge les valeurs non nulles. |
Réponse
UpdateTableResponse contient les informations métier suivantes.
|
Champ |
Type |
Description |
|
table_options |
|
Les configurations de table mises à jour. |
|
reserved_throughput_details |
|
Le débit réservé actuel ainsi que les heures de la dernière augmentation et de la dernière diminution. |
Exemples
Mise à jour du débit réservé
L'exemple suivant définit le débit réservé de example_table sur 0 CU.
reserved_throughput = ReservedThroughput(
CapacityUnit(read=0, write=0)
)
client.update_table(
"example_table",
reserved_throughput=reserved_throughput,
)