ossutil update-table-metadata-location | Update Iceberg table metadata - Object Storage Service

Met à jour l'emplacement des métadonnées d'une table spécifiée, généralement après la validation d'un nouveau snapshot de métadonnées Iceberg.

Remarques sur l'utilisation

Le paramètre --version-token active le verrouillage optimiste. Récupérez le versionToken actuel en exécutant get-table-metadata-location, puis transmettez-le via ce paramètre. Si un autre client met à jour l'emplacement des métadonnées entre votre lecture et votre écriture, l'opération échoue pour éviter les écrasements concurrents.
--metadata-location doit correspondre à un chemin valide vers un fichier de métadonnées Iceberg.
Les paramètres --metadata-location et --version-token sont obligatoires.

Format de la commande

ossutil tables-api update-table-metadata-location --table-bucket-arn value --namespace value --name value --metadata-location value --version-token value [flags]

Paramètre

Type

Description

--metadata-location

string

Chemin vers le nouveau fichier de métadonnées Iceberg. Obligatoire.

--name

string

Nom de la table. Obligatoire.

--namespace

string

Espace de noms (namespace) de la table. Obligatoire.

--table-bucket-arn

string

ARN du Table Bucket, au format acs:osstables:{region}:{uid}:bucket/{bucket-name}. Obligatoire.

--version-token

string

Jeton de version pour le verrouillage optimiste. Récupérez le jeton actuel en exécutant get-table-metadata-location. Obligatoire.

Remarque

Cette commande correspond à l'opération API UpdateTableMetadataLocation.
Cette commande prend en charge toutes les Options globales ossutil.

Exemples

Mettez à jour l'emplacement des métadonnées de my_table en indiquant un nouveau chemin de métadonnées et un jeton de version.

ossutil tables-api update-table-metadata-location --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket --namespace my_namespace --name my_table --metadata-location oss://my-table-bucket/metadata/my_namespace/my_table/metadata/00001-abc123.metadata.json --version-token abc123def456