指定されたテーブルのメタデータファイルの場所を取得します。
注意事項
返される
metadataLocationは、現在の Iceberg メタデータ JSON ファイルを指します。versionTokenは、後続のUpdateTableMetadataLocation操作で楽観的ロックを有効にします。warehouseLocationは、テーブルのウェアハウスへの OSS パスです。
権限
API | 操作 | 説明 |
GetTableMetadataLocation | oss:GetTableMetadataLocation | テーブルメタデータの場所を取得します。この操作では、テーブルポリシーもチェックされます。 |
リクエスト構文
GET /tables/{tableBucketARN}/{namespace}/{name}/metadata-location HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: SignatureValueリクエストパラメーター
パラメーター | 型 | 必須 | 例 | 説明 |
tableBucketARN | 文字列 | はい | acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket | テーブルバケットの ARN です。形式は |
namespace | 文字列 | はい | my_namespace | テーブルの名前空間の名前です。このパラメーターは URI の一部です。 |
name | 文字列 | はい | my_table | テーブルの名前です。このパラメーターは URI の一部です。 |
応答パラメーター
パラメーター | 型 | 例 | 説明 |
metadataLocation | 文字列 | oss://bucket/metadata/00000-xxx.metadata.json | 現在の Iceberg メタデータ JSON ファイルへの OSS パスです。 |
versionToken | 文字列 | abc123def456 | テーブルのバージョントークンです。 |
warehouseLocation | 文字列 | oss://data-bucket/warehouse/ | テーブルのウェアハウスへの OSS パスです。 |
使用例
リクエスト例
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****応答例
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
以下の SDK が GetTableMetadataLocation 操作をサポートしています。
ossutil コマンドラインツール
対応する ossutil コマンドについては、「get-table-metadata-location」をご参照ください。
エラーコード
エラーコード | HTTP ステータスコード | 説明 |
ForbiddenException | 403 | このリクエストを実行する権限がありません。 |
NotFoundException | 404 | リクエストされたリソースが存在しません。 |