Renommer une table - Object Storage Service - Centre de documentation Alibaba Cloud

Notes

Spécifiez au moins l'un des paramètres --new-name ou --new-namespace. Si vous spécifiez uniquement --new-name, la table est renommée au sein de son namespace actuel. Si vous spécifiez uniquement --new-namespace, la table est déplacée vers le nouveau namespace mais conserve son nom d'origine. Si vous spécifiez les deux paramètres, la table est renommée et déplacée vers le nouveau namespace.
Le paramètre --version-token active le verrouillage optimiste. Obtenez le versionToken actuel d'une table à l'aide de la commande get-table pour éviter les conflits de mise à jour lors d'opérations simultanées. Si vous ne spécifiez pas ce paramètre, aucune vérification de version n'est effectuée.

Syntaxe

ossutil tables-api rename-table --table-bucket-arn value --namespace value --name value [--new-name value] [--new-namespace value] [--version-token value] [flags]

Paramètre

Type

Description

--name

string

Nom actuel de la table. Obligatoire.

--namespace

string

Namespace actuel de la table. Obligatoire.

--new-name

string

Nouveau nom de la table. Spécifiez au moins l'un des paramètres --new-name ou --new-namespace.

--new-namespace

string

Namespace cible de la table. Spécifiez au moins l'un des paramètres --new-name ou --new-namespace.

--table-bucket-arn

string

ARN (Alibaba Cloud Resource Name) du compartiment de tables, au format acs:osstables:{region}:{uid}:bucket/{bucket-name}. Obligatoire.

--version-token

string

Jeton de version pour le verrouillage optimiste. Obtenez le versionToken actuel de la table à l'aide de la commande get-table pour éviter les conflits de mise à jour lors d'opérations simultanées.

Remarque

La commande rename-table correspond à l'API RenameTable. Pour plus d'informations sur les paramètres de l'API, consultez RenameTable.
Pour obtenir des informations sur les options de ligne de commande globales prises en charge, consultez Options globales ossutil.

Exemples

Renommez une table de old_table en new_table au sein de son namespace actuel.

ossutil tables-api rename-table --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket --namespace my_namespace --name old_table --new-name new_table

Déplacez la table my_table du namespace my_namespace vers target_namespace.

ossutil tables-api rename-table --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket --namespace my_namespace --name my_table --new-namespace target_namespace

Renommez une table et déplacez-la vers un autre namespace, en utilisant un jeton de version pour le verrouillage optimiste.

ossutil tables-api rename-table --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket --namespace my_namespace --name old_table --new-name new_table --new-namespace target_namespace --version-token abc123def456