GetTableMetadataLocation - Object Storage Service: Central de Documentação do Alibaba Cloud

Notas de uso

O valor retornado em metadataLocation aponta para o arquivo JSON de metadados atual do Iceberg.
O versionToken permite o bloqueio otimista em operações subsequentes de UpdateTableMetadataLocation.
O campo warehouseLocation indica o caminho no OSS para o warehouse da tabela.

Permissões

API	Ação	Descrição
GetTableMetadataLocation	oss:GetTableMetadataLocation	Recupera o local dos metadados da tabela e verifica a política da tabela.

Sintaxe da solicitação

GET /tables/{tableBucketARN}/{namespace}/{name}/metadata-location HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
tableBucketARN	string	Sim	acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket	ARN do bucket de tabelas. Formato: `acs:osstables:{region}:{uid}:bucket/{bucketName}`. Este parâmetro faz parte da URI.
namespace	string	Sim	my_namespace	Nome do namespace da tabela. Este parâmetro faz parte da URI.
name	string	Sim	my_table	Nome da tabela. Este parâmetro faz parte da URI.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
metadataLocation	string	oss://bucket/metadata/00000-xxx.metadata.json	Caminho no OSS para o arquivo JSON de metadados atual do Iceberg.
versionToken	string	abc123def456	Token de versão para bloqueio otimista em operações subsequentes de `UpdateTableMetadataLocation`.
warehouseLocation	string	oss://data-bucket/warehouse/	Caminho no OSS para o warehouse da tabela.

Exemplos

Exemplo de solicitação

GET /tables/acs%3Aosstables%3Acn-hangzhou%3A1234567890%3Abucket%2Fmy-table-bucket/my_namespace/my_table/metadata-location HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: Thu, 10 Apr 2025 08:00:00 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/osstables/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c****

Exemplo de resposta

HTTP/1.1 200 OK
Server: AliyunOSS
x-oss-request-id: 5C06A3B67B8B5A3DA422****
x-oss-server-time: 3
Content-Type: application/json

{
   "metadataLocation": "oss://data-bucket/metadata/00000-xxx.metadata.json",
   "versionToken": "aaabbb",
   "warehouseLocation": "oss://data-bucket/warehouse/"
}

SDKs

Os SDKs a seguir oferecem suporte à operação GetTableMetadataLocation:

Ferramenta de linha de comando ossutil

Para obter o comando correspondente do ossutil, consulte get-table-metadata-location.

Códigos de erro

Código de erro	Código de status HTTP	Descrição
ForbiddenException	403	Você não tem permissão para executar esta solicitação.
NotFoundException	404	O recurso solicitado não existe.