指定されたテーブルバケット内のテーブルの名前を変更するか、別の名前空間に移動します。
注意事項
--new-nameパラメーターまたは--new-namespaceパラメーターのいずれか一方は必ず指定する必要があります。--new-nameのみを指定した場合、テーブルは現在の名前空間内で名前が変更されます。--new-namespaceのみを指定した場合、テーブルは新しい名前空間に移動されますが、元の名前は維持されます。両方のパラメーターを指定した場合、テーブルは名前変更されるとともに新しい名前空間に移動されます。--version-tokenパラメーターにより楽観的ロックが有効になります。テーブルの現在のversionTokenはget-tableコマンドを使用して取得できます。このパラメーターは同時操作時の更新競合を防止します。このパラメーターを指定しない場合、バージョンチェックは実行されません。
構文
ossutil tables-api rename-table --table-bucket-arn value --namespace value --name value [--new-name value] [--new-namespace value] [--version-token value] [flags]パラメーター | タイプ | 説明 |
--name | 文字列 | 現在のテーブル名です。このパラメーターは必須です。 |
--namespace | 文字列 | テーブルの現在の名前空間です。このパラメーターは必須です。 |
--new-name | 文字列 | テーブルの新しい名前です。 |
--new-namespace | 文字列 | テーブルの移動先となる名前空間です。 |
--table-bucket-arn | 文字列 | テーブルバケットの Alibaba Cloud リソースネーム (ARN) です。フォーマットは |
--version-token | 文字列 | 楽観的ロック用のバージョントークンです。テーブルの現在の |
rename-tableコマンドはRenameTableAPI に対応しています。API パラメーターの詳細については、「RenameTable」をご参照ください。サポートされているグローバルコマンドラインオプションの詳細については、「ossutil global options」をご参照ください。
使用例
現在の名前空間内で、テーブル名を
old_tableからnew_tableに変更します。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テーブル
my_tableを名前空間my_namespaceから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テーブルの名前を変更し、別の名前空間に移動します。楽観的ロックのためにバージョントークンを使用します。
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