适用于 Apache Iceberg 的 AWS Glue REST API 规范

warehouse 查询参数必须设置为 AWS Glue 目录 ID。如果未设置，则将使用当前账户中的根目录来返回响应。有关更多信息，请参阅 前缀和目录路径参数。

目录路径参数必须遵循前缀和目录路径参数部分中描述的样式。

目录路径参数必须遵循前缀和目录路径参数部分中描述的样式。

仅显示下一层级的命名空间。要列出更深层级的命名空间，请在目录路径参数中指定嵌套目录 ID。

目录路径参数必须遵循前缀和目录路径参数部分中描述的样式。

只能创建单级命名空间。要创建多级命名空间，必须以迭代方式创建每个层级，然后使用目录路径参数连接到该层级。

目录路径参数必须遵循前缀和目录路径参数部分中描述的样式。

只能创建单级命名空间。要创建多级命名空间，必须以迭代方式创建每个层级，然后使用目录路径参数连接到该层级。

此 API 是异步的，并且会返回一个可以用于通过 CheckTransactionStatus API 调用进行跟踪的事务 ID。

只有当 GetCatalog API 调用在响应中包含 use-extensions=true参数时，才能调用此 API。

目录路径参数必须遵循前缀和目录路径参数部分中描述的样式。

只能在 REST 路径参数中指定单级命名空间。有关更多信息，请参阅命名空间路径参数部分。

目录路径参数必须遵循前缀和目录路径参数部分中描述的样式。

只能在 REST 路径参数中指定单级命名空间。有关更多信息，请参阅命名空间路径参数部分。

目录路径参数必须遵循前缀和目录路径参数部分中描述的样式。

只能在 REST 路径参数中指定单级命名空间。有关更多信息，请参阅命名空间路径参数部分。

如果数据库中有对象，则操作将失败。

此 API 是异步的，并且会返回一个可以用于通过 CheckTransactionStatus API 调用进行跟踪的事务 ID。

只有当 GetCatalog API 调用的响应中指示 use-extensions=true 时，才能使用此 API。

目录路径参数必须遵循前缀和目录路径参数部分中描述的样式。

您只能在 REST 路径参数中指定单级命名空间。有关更多信息，请参阅命名空间路径参数部分。

如果数据库中有对象，则操作将失败。

此 API 是异步的，并且会返回一个可以用于通过 CheckTransactionStatus API 调用进行跟踪的事务 ID。

只有当 GetCatalog API 调用的响应中指示 use-extensions=true 时，才能使用此 API。

目录路径参数必须遵循前缀和目录路径参数部分中描述的样式。

只能在 REST 路径参数中指定单级命名空间。有关更多信息，请参阅命名空间路径参数部分。

将列出所有表，包括非 Iceberg 表。要确定某个表是否可以作为 Iceberg 表加载，请调用 LoadTable 操作。

目录路径参数必须遵循前缀和目录路径参数部分中描述的样式。

只能在 REST 路径参数中指定单级命名空间。有关更多信息，请参阅命名空间路径参数部分。

不支持将 CreateTable 与暂存功能结合使用。如果指定了 stageCreate 查询参数，则操作将失败。这意味着不支持类似于 CREATE TABLE AS SELECT 的操作，您可以通过组合使用 CREATE TABLE 和 INSERT INTO 来解决问题。

CreateTable API 操作不支持 state-create = TRUE 选项。

目录路径参数必须遵循前缀和目录路径参数部分中描述的样式。

只能在 REST 路径参数中指定单级命名空间。有关更多信息，请参阅命名空间路径参数部分。

不支持将 CreateTable 与暂存功能结合使用。如果指定了 stageCreate 查询参数，则操作将失败。这意味着不支持类似于 CREATE TABLE AS SELECT 的操作，用户应组合使用 CREATE TABLE 和 INSERT INTO 来解决问题。

此 API 是异步的，并且会返回一个可以用于通过 CheckTransactionStatus API 调用进行跟踪的事务 ID。

只有当 GetCatalog API 调用的响应中指示 use-extensions=true 时，才能使用此 API。

目录路径参数必须遵循前缀和目录路径参数部分中描述的样式。

只能在 REST 路径参数中指定单级命名空间。有关更多信息，请参阅命名空间路径参数部分。

不支持将 CreateTable 与暂存功能结合使用。如果指定了 stageCreate 查询参数，则操作将失败。这意味着不支持类似于 CREATE TABLE AS SELECT 的操作，用户应组合使用 CREATE TABLE 和 INSERT INTO 来解决问题。

此 API 是异步的，并且会返回一个可以用于通过 CheckTransactionStatus API 调用进行跟踪的事务 ID。

只有当 GetCatalog API 调用的响应中指示 use-extensions=true 时，才能使用此 API。

目录路径参数必须遵循前缀和目录路径参数部分中描述的样式。

只能在 REST 路径参数中指定单级命名空间。有关更多信息，请参阅命名空间路径参数部分。

快照查询参数仅支持 all 模式。

与 LoadTable API 相比，ExtendedLoadTable API 的差异在于以下方面：

目录路径参数应遵循前缀和目录路径参数部分中描述的样式。

只能在 REST 路径参数中指定单级命名空间。有关更多信息，请参阅命名空间路径参数部分。

此 API 的调用者应始终根据页面令牌来确定是否还有剩余的结果需要获取。如果服务器端仍在处理中但无法在给定的响应时间内生成任何结果，则可能出现除分页令牌外其他页面项为空的响应。

只有当 ExtendedLoadTable API 响应包含 aws.server-side-capabilities.scan-planning=true 时，您才能使用此 API。

目录路径参数必须遵循前缀和目录路径参数部分中描述的样式。

只能在 REST 路径参数中指定单级命名空间。有关更多信息，请参阅命名空间路径参数部分。

此 API 的调用者应始终根据页面令牌来确定是否还有剩余的结果需要获取。如果服务器端仍在处理中但无法在给定的响应时间内生成任何结果，则可能出现除分页令牌外其他页面项为空的响应。

只有当 ExtendedLoadTable API 响应包含 aws.server-side-capabilities.scan-planning=true 时，您才能使用此 API。

目录路径参数必须遵循前缀和目录路径参数部分中描述的样式。

只能在 REST 路径参数中指定单级命名空间。有关更多信息，请参阅命名空间路径参数部分。

目录路径参数必须遵循前缀和目录路径参数部分中描述的样式。

只能在 REST 路径参数中指定单级命名空间。有关更多信息，请参阅命名空间路径参数部分。

目录路径参数必须遵循前缀和目录路径参数部分中描述的样式。

只能在 REST 路径参数中指定单级命名空间。有关更多信息，请参阅命名空间路径参数部分。

此 API 是异步的，并且会返回一个可以用于通过 CheckTransactionStatus API 调用进行跟踪的事务 ID。

也可以通过此 API 执行 RenamTable 操作。发生这种情况时，调用者还必须拥有要重命名的表的 glue:CreateTable 或 LakeFormation CREATE_TABLE 权限。

只有当 ExtendedLoadTable API 响应包含 aws.server-side-capabilities.scan-planning=true 时，您才能使用此 API。

目录路径参数应遵循前缀和目录路径参数部分中描述的样式。

只能在 REST 路径参数中指定单级命名空间。有关更多信息，请参阅命名空间路径参数部分。

DeleteTable API 操作支持 purge 选项。当清除设置为 true 时，表数据会被删除，否则数据不会被删除。对于 Amazon S3 中的表，此操作不会删除表数据。当表存储在 Amazon S3 中且 purge = TRUE, 时，此操作将会失败。

对于存储在 Amazon Redshift 托管存储中的表，该操作将删除表数据，类似于 Amazon Redshift 中的 DROP TABLE 行为。当表存储在 Amazon Redshift 中且 purge = FALSE 时，操作会失败。

不支持 purgeRequest=true。

目录路径参数必须遵循前缀和目录路径参数部分中描述的样式。

只能在 REST 路径参数中指定单级命名空间。有关更多信息，请参阅命名空间路径参数部分。

不支持 purgeRequest=false。

此 API 是异步的，并且会返回一个可以通过 CheckTransactionStatus 进行跟踪的事务 ID。

目录路径参数必须遵循前缀和目录路径参数部分中描述的样式。