GetTableMetadataLocation - Object Storage Service - Centre de documentation Alibaba Cloud

Remarques sur l'utilisation

La valeur renvoyée pour metadataLocation pointe vers le fichier JSON de métadonnées Iceberg actuel.
Le paramètre versionToken permet d'activer le verrouillage optimiste lors des opérations UpdateTableMetadataLocation ultérieures.
Le champ warehouseLocation correspond au chemin OSS du warehouse de la table.

Permissions

API

Action

Description

GetTableMetadataLocation

oss:GetTableMetadataLocation

Récupère l'emplacement des métadonnées de la table et vérifie la politique associée à celle-ci.

Syntaxe de la requête

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

Paramètres de requête

Parameter

Type

Required

Example

Description

tableBucketARN

string

Yes

acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket

L'ARN du bucket de table. Le format est acs:osstables:{region}:{uid}:bucket/{bucketName}. Ce paramètre fait partie de l'URI.

namespace

string

Yes

my_namespace

Le nom du namespace de la table. Ce paramètre fait partie de l'URI.

name

string

Yes

my_table

Le nom de la table. Ce paramètre fait partie de l'URI.

Paramètres de réponse

Parameter

Type

Example

Description

metadataLocation

string

oss://bucket/metadata/00000-xxx.metadata.json

Le chemin OSS vers le fichier JSON de métadonnées Iceberg actuel.

versionToken

string

abc123def456

Jeton de version utilisé pour le verrouillage optimiste lors des opérations UpdateTableMetadataLocation ultérieures.

warehouseLocation

string

oss://data-bucket/warehouse/

Le chemin OSS vers le warehouse de la table.

Exemples

Exemple de requête

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****

Exemple de réponse

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/"
}

SDK

Les SDK suivants prennent en charge l'opération GetTableMetadataLocation :

Outil de ligne de commande ossutil

Pour la commande ossutil correspondante, consultez la rubrique get-table-metadata-location.

Codes d'erreur

Error code

HTTP status code

Description

ForbiddenException

403

Vous ne disposez pas des autorisations nécessaires pour effectuer cette requête.

NotFoundException

404

La ressource demandée n'existe pas.