Object Storage Service:UpdateTableMetadataLocation

注意事項

• この操作を使用して、テーブルを新しいメタデータファイルにポイントできます。これにより、スキーマ進化やデータコミットなどの操作が可能になります。

• 楽観的ロックを実装し、同時更新時の整合性を確保するには、現在の versionToken を提供する必要があります。

• versionToken は、GetTableMetadataLocation 操作または GetTable 操作を呼び出すことで取得できます。

• 新しい metadataLocation は、有効な Iceberg メタデータ JSON ファイルを指している必要があります。

権限

リクエスト構文

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

{
   "versionToken": "string",
   "metadataLocation": "string"
}

リクエストパラメーター

応答パラメーター

使用例

リクエスト例

PUT /tables/acs%3Aosstables%3Acn-hangzhou%3A1234567890%3Abucket%2Fmy-table-bucket/my_namespace/my_table/metadata-location HTTP/1.1
Content-type: application/json
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****

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

レスポンス例

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/00001-xxx.metadata.json",
   "name": "my_table",
   "namespace": ["my_namespace"],
   "tableARN": "acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket/table/table_id",
   "versionToken": "cccbbb"
}

SDK

以下の SDK は UpdateTableMetadataLocation 操作をサポートしています。

• Python V2

• Go V2

• Java V2

ossutil CLI

対応する ossutil コマンドについては、「update-table-metadata-location」をご参照ください。

エラーコード