|
2142 | 2142 | "shape":"IcebergSchema", |
2143 | 2143 | "documentation":"<p>The schema for an Iceberg table.</p>" |
2144 | 2144 | }, |
| 2145 | + "partitionSpec":{ |
| 2146 | + "shape":"IcebergPartitionSpec", |
| 2147 | + "documentation":"<p>The partition specification for the Iceberg table. Partitioning organizes data into separate files based on the values of one or more fields, which can improve query performance by reducing the amount of data scanned. Each partition field applies a transform (such as identity, year, month, or bucket) to a single field.</p>" |
| 2148 | + }, |
| 2149 | + "writeOrder":{ |
| 2150 | + "shape":"IcebergSortOrder", |
| 2151 | + "documentation":"<p>The sort order for the Iceberg table. Sort order defines how data is sorted within data files, which can improve query performance by enabling more efficient data skipping and filtering.</p>" |
| 2152 | + }, |
2145 | 2153 | "properties":{ |
2146 | 2154 | "shape":"TableProperties", |
2147 | | - "documentation":"<p>Contains configuration properties for an Iceberg table.</p>" |
| 2155 | + "documentation":"<p>A map of custom configuration properties for the Iceberg table.</p>" |
2148 | 2156 | } |
2149 | 2157 | }, |
2150 | 2158 | "documentation":"<p>Contains details about the metadata for an Iceberg table.</p>" |
2151 | 2159 | }, |
| 2160 | + "IcebergNullOrder":{ |
| 2161 | + "type":"string", |
| 2162 | + "enum":[ |
| 2163 | + "nulls-first", |
| 2164 | + "nulls-last" |
| 2165 | + ] |
| 2166 | + }, |
| 2167 | + "IcebergPartitionField":{ |
| 2168 | + "type":"structure", |
| 2169 | + "required":[ |
| 2170 | + "sourceId", |
| 2171 | + "transform", |
| 2172 | + "name" |
| 2173 | + ], |
| 2174 | + "members":{ |
| 2175 | + "sourceId":{ |
| 2176 | + "shape":"Integer", |
| 2177 | + "documentation":"<p>The ID of the source schema field to partition by. This must reference a valid field ID from the table schema.</p>", |
| 2178 | + "locationName":"source-id" |
| 2179 | + }, |
| 2180 | + "transform":{ |
| 2181 | + "shape":"String", |
| 2182 | + "documentation":"<p>The partition transform to apply to the source field. Supported transforms include <code>identity</code>, <code>year</code>, <code>month</code>, <code>day</code>, <code>hour</code>, <code>bucket</code>, and <code>truncate</code>. For more information, see the <a href=\"https://iceberg.apache.org/spec/#partition-transforms\">Apache Iceberg partition transforms documentation</a>.</p>" |
| 2183 | + }, |
| 2184 | + "name":{ |
| 2185 | + "shape":"String", |
| 2186 | + "documentation":"<p>The name for this partition field. This name is used in the partitioned file paths.</p>" |
| 2187 | + }, |
| 2188 | + "fieldId":{ |
| 2189 | + "shape":"Integer", |
| 2190 | + "documentation":"<p>An optional unique identifier for this partition field. If not specified, S3 Tables automatically assigns a field ID.</p>", |
| 2191 | + "locationName":"field-id" |
| 2192 | + } |
| 2193 | + }, |
| 2194 | + "documentation":"<p>Defines a single partition field in an Iceberg partition specification.</p>" |
| 2195 | + }, |
| 2196 | + "IcebergPartitionFieldList":{ |
| 2197 | + "type":"list", |
| 2198 | + "member":{"shape":"IcebergPartitionField"} |
| 2199 | + }, |
| 2200 | + "IcebergPartitionSpec":{ |
| 2201 | + "type":"structure", |
| 2202 | + "required":["fields"], |
| 2203 | + "members":{ |
| 2204 | + "fields":{ |
| 2205 | + "shape":"IcebergPartitionFieldList", |
| 2206 | + "documentation":"<p>The list of partition fields that define how the table data is partitioned. Each field specifies a source field and a transform to apply. This field is required if <code>partitionSpec</code> is provided.</p>" |
| 2207 | + }, |
| 2208 | + "specId":{ |
| 2209 | + "shape":"Integer", |
| 2210 | + "documentation":"<p>The unique identifier for this partition specification. If not specified, defaults to <code>0</code>.</p>", |
| 2211 | + "locationName":"spec-id" |
| 2212 | + } |
| 2213 | + }, |
| 2214 | + "documentation":"<p>Defines how data in an Iceberg table is partitioned. Partitioning helps optimize query performance by organizing data into separate files based on field values. Each partition field specifies a transform to apply to a source field.</p>" |
| 2215 | + }, |
2152 | 2216 | "IcebergSchema":{ |
2153 | 2217 | "type":"structure", |
2154 | 2218 | "required":["fields"], |
|
2174 | 2238 | }, |
2175 | 2239 | "documentation":"<p>Contains details about the snapshot management settings for an Iceberg table. The oldest snapshot expires when its age exceeds the <code>maxSnapshotAgeHours</code> and the total number of snapshots exceeds the value for the minimum number of snapshots to keep <code>minSnapshotsToKeep</code>.</p>" |
2176 | 2240 | }, |
| 2241 | + "IcebergSortDirection":{ |
| 2242 | + "type":"string", |
| 2243 | + "enum":[ |
| 2244 | + "asc", |
| 2245 | + "desc" |
| 2246 | + ] |
| 2247 | + }, |
| 2248 | + "IcebergSortField":{ |
| 2249 | + "type":"structure", |
| 2250 | + "required":[ |
| 2251 | + "sourceId", |
| 2252 | + "transform", |
| 2253 | + "direction", |
| 2254 | + "nullOrder" |
| 2255 | + ], |
| 2256 | + "members":{ |
| 2257 | + "sourceId":{ |
| 2258 | + "shape":"Integer", |
| 2259 | + "documentation":"<p>The ID of the source schema field to sort by. This must reference a valid field ID from the table schema.</p>", |
| 2260 | + "locationName":"source-id" |
| 2261 | + }, |
| 2262 | + "transform":{ |
| 2263 | + "shape":"String", |
| 2264 | + "documentation":"<p>The transform to apply to the source field before sorting. Use <code>identity</code> to sort by the field value directly, or specify other transforms as needed.</p>" |
| 2265 | + }, |
| 2266 | + "direction":{ |
| 2267 | + "shape":"IcebergSortDirection", |
| 2268 | + "documentation":"<p>The sort direction. Valid values are <code>asc</code> for ascending order or <code>desc</code> for descending order.</p>" |
| 2269 | + }, |
| 2270 | + "nullOrder":{ |
| 2271 | + "shape":"IcebergNullOrder", |
| 2272 | + "documentation":"<p>Specifies how null values are ordered. Valid values are <code>nulls-first</code> to place nulls before non-null values, or <code>nulls-last</code> to place nulls after non-null values.</p>", |
| 2273 | + "locationName":"null-order" |
| 2274 | + } |
| 2275 | + }, |
| 2276 | + "documentation":"<p>Defines a single sort field in an Iceberg sort order specification.</p>" |
| 2277 | + }, |
| 2278 | + "IcebergSortFieldList":{ |
| 2279 | + "type":"list", |
| 2280 | + "member":{"shape":"IcebergSortField"} |
| 2281 | + }, |
| 2282 | + "IcebergSortOrder":{ |
| 2283 | + "type":"structure", |
| 2284 | + "required":[ |
| 2285 | + "orderId", |
| 2286 | + "fields" |
| 2287 | + ], |
| 2288 | + "members":{ |
| 2289 | + "orderId":{ |
| 2290 | + "shape":"Integer", |
| 2291 | + "documentation":"<p>The unique identifier for this sort order. If not specified, defaults to <code>1</code>. The order ID is used by Apache Iceberg to track sort order evolution.</p>", |
| 2292 | + "locationName":"order-id" |
| 2293 | + }, |
| 2294 | + "fields":{ |
| 2295 | + "shape":"IcebergSortFieldList", |
| 2296 | + "documentation":"<p>The list of sort fields that define how data is sorted within files. Each field specifies a source field, sort direction, and null ordering. This field is required if <code>writeOrder</code> is provided.</p>" |
| 2297 | + } |
| 2298 | + }, |
| 2299 | + "documentation":"<p>Defines the sort order for data within an Iceberg table. Sorting data can improve query performance by enabling more efficient data skipping.</p>" |
| 2300 | + }, |
2177 | 2301 | "IcebergUnreferencedFileRemovalSettings":{ |
2178 | 2302 | "type":"structure", |
2179 | 2303 | "members":{ |
|
2188 | 2312 | }, |
2189 | 2313 | "documentation":"<p>Contains details about the unreferenced file removal settings for an Iceberg table bucket.</p>" |
2190 | 2314 | }, |
| 2315 | + "Integer":{ |
| 2316 | + "type":"integer", |
| 2317 | + "box":true |
| 2318 | + }, |
2191 | 2319 | "InternalServerErrorException":{ |
2192 | 2320 | "type":"structure", |
2193 | 2321 | "members":{ |
|
2940 | 3068 | "type" |
2941 | 3069 | ], |
2942 | 3070 | "members":{ |
| 3071 | + "id":{ |
| 3072 | + "shape":"Integer", |
| 3073 | + "documentation":"<p>An optional unique identifier for the schema field. Field IDs are used by Apache Iceberg to track schema evolution and maintain compatibility across schema changes. If not specified, S3 Tables automatically assigns field IDs.</p>" |
| 3074 | + }, |
2943 | 3075 | "name":{ |
2944 | 3076 | "shape":"String", |
2945 | 3077 | "documentation":"<p>The name of the field.</p>" |
|
0 commit comments