ossutil update-table-metadata-location | Atualizar metadados de tabela Iceberg - Object Storage Service: Central de Documentação do Alibaba Cloud

Atualiza o local dos metadados de uma tabela especificada, geralmente após a confirmação de um novo snapshot de metadados do Iceberg.

Observações de uso

O parâmetro --version-token ativa o bloqueio otimista. Obtenha o versionToken atual executando get-table-metadata-location e passe-o para este parâmetro. Se outro cliente atualize o local dos metadados entre sua leitura e gravação, a operação falhará para evitar substituições simultâneas.
--metadata-location deve ser um caminho válido para arquivo de metadados do Iceberg.
Tanto --metadata-location quanto --version-token são obrigatórios.

Formato do comando

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

Parâmetro	Tipo	Descrição
--metadata-location	string	Caminho para o novo arquivo de metadados do Iceberg. Obrigatório.
--name	string	Nome da tabela. Obrigatório.
--namespace	string	Namespace da tabela. Obrigatório.
--table-bucket-arn	string	ARN do Table Bucket, no formato `acs:osstables:{region}:{uid}:bucket/{bucket-name}`. Obrigatório.
--version-token	string	Token de versão para bloqueio otimista. Recupere o token atual executando `get-table-metadata-location`. Obrigatório.

Nota

Este comando corresponde à operação da API UpdateTableMetadataLocation.
Este comando oferece suporte a todas as Opções globais do ossutil.

Exemplos

Atualize o local dos metadados de my_table com um novo caminho de metadados e token de versão.

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