Esta sección contiene especificaciones sobre el catálogo REST Iceberg de AWS Glue y las API de extensión de AWS Glue, así como consideraciones sobre el uso de estas API.
Las solicitudes de API a los puntos de conexión de AWS Glue Data Catalog se autentican mediante AWS Signature Version 4 (SigV4). Consulte la sección de solicitudes de API de la versión de firma 4 de AWS para obtener más información sobre SigV4 de AWS.
Al acceder al punto de conexión del servicio AWS Glue y a los metadatos de AWS Glue, la aplicación asume un rol de IAM que requiere una acción de IAM glue:getCatalog.
El acceso al Catálogo de Datos y sus objetos puede gestionarse mediante IAM, Lake Formation o permisos en modo híbrido de Lake Formation.
Los catálogos federados en el catáogo de datos tienen ubicaciones de datos registradas en Lake Formation. Lake Formation trabaja con el catálogo de datos y proporciona permisos similares a los de una base de datos para administrar el acceso de los usuarios a los objetos del catálogo de datos.
Puede usar IAM, AWS Lake Formation o los permisos de modo híbrido de Lake Formation para administrar el acceso al catálogo de datos predeterminado y sus objetos.
Para crear, insertar o eliminar datos en objetos administrados por Lake Formation, debes configurar permisos específicos para el usuario o rol de IAM.
-
CREATE_CATALOG: es necesario para crear catálogos
-
CREATE_DATABASE: es necesario para crear bases de datos
-
CREATE_TABLE: es necesario para crear tablas
-
DELETE: es necesario para eliminar datos de una tabla
-
DESCRIBE: es necesario para leer los metadatos
-
DROP: es necesario para eliminar una tabla o base de datos
-
INSERT: es necesario cuando la entidad principal debe insertar datos en una tabla
-
SELECT: es necesario cuando la entidad principal necesita seleccionar datos de una tabla
Para obtener más información, consulte Lake Formation permissions reference en la Guía para desarrolladores de AWS Lake Formation.
| Nombre de operación | GetConfig |
| Tipo |
API del catálogo de REST de Iceberg |
| Ruta de REST |
GET /iceberg/v1/config |
| Acción de IAM |
glue:GetCatalog |
| Permisos de Lake Formation | No aplicable |
| Evento de CloudTrail |
glue:GetCatalog |
| Definición de API abierta | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L67 |
Consideraciones y limitaciones
-
El parámetro de consulta
warehousedebe establecerse en el ID del catálogo AWS Glue. Si no se establece, se utiliza el catálogo raíz de la cuenta actual para devolver la respuesta. Para obtener más información, consulte Parámetros de prefijo y ruta de catálogo.
| nombre de operación | GetCatalog |
| Tipo |
API de extensión AWS Glue |
| Ruta de REST |
GET/extensions/v1/catalogs/{catalog} |
| Acción de IAM |
glue:GetCatalog |
| Permisos de Lake Formation | DESCRIBE |
| Evento de CloudTrail |
glue:GetCatalog |
| Definición de API abierta | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml#L40 |
Consideraciones y limitaciones
-
El parámetro de ruta del catálogo debe seguir el estilo descrito en la sección Parámetros de prefijo y ruta de catálogo.
| Nombre de operación | ListNamespaces |
| Tipo |
API del catálogo de REST de Iceberg |
| Ruta de REST |
GET/iceberg/v1/catalogs/{catalog}/namespaces |
| Acción de IAM |
glue:GetDatabase |
| Permisos de Lake Formation | ALL, DESCRIBE, SELECT |
| Evento de CloudTrail |
glue:GetDatabase |
| Definición de API abierta | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L205 |
Consideraciones y limitaciones
-
El parámetro de ruta del catálogo debe seguir el estilo descrito en la sección Parámetros de prefijo y ruta de catálogo.
-
Solo se muestran los espacios de nombres del siguiente nivel. Para listar los espacios de nombres en niveles más profundos, especifique el ID del catálogo anidado en el parámetro de ruta del catálogo.
| Nombre de operación | CreateNamespace |
| Tipo |
API del catálogo de REST de Iceberg |
| Ruta de REST |
POST/iceberg/v1/catalogs/{catalog}/namespaces |
| Acción de IAM |
glue:CreateDatabase |
| Permisos de Lake Formation | ALL, DESCRIBE, SELECT |
| Evento de CloudTrail |
glue:CreateDatabase |
| Definición de API abierta | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L256 |
Consideraciones y limitaciones
-
El parámetro de ruta del catálogo debe seguir el estilo descrito en la sección Parámetros de prefijo y ruta de catálogo.
-
Solo se puede crear un espacio de nombres de un solo nivel. Para crear un espacio de nombres de varios niveles, debe crear cada nivel de forma iterativa y conectarse al nivel mediante el parámetro de ruta del catálogo.
| Nombre de operación | StartCreateNamespaceTransaction |
| Tipo |
API de extensiones AWS Glue |
| Ruta de REST |
POST/extensions/v1/catalogs/{catalog}/namespaces |
| Acción de IAM |
glue:CreateDatabase |
| Permisos de Lake Formation | ALL, DESCRIBE, SELECT |
| Evento de CloudTrail |
glue:CreateDatabase |
| Definición de API abierta | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L256 |
Consideraciones y limitaciones
-
El parámetro de ruta del catálogo debe seguir el estilo descrito en la sección Parámetros de prefijo y ruta de catálogo.
-
Solo puede crear un espacio de nombres de un solo nivel. Para crear espacios de nombres de varios niveles, debe crear cada nivel de forma iterativa y conectarse al nivel mediante el parámetro de ruta del catálogo.
-
La API es asíncrona y devuelve un identificador de transacción que puede usar para realizar un seguimiento mediante la llamada a la API
CheckTransactionStatus. -
Puedes llamar a esta API solo si la llamada a la API
GetCatalogcontiene el parámetrouse-extensions=trueen la respuesta.
| Nombre de operación | LoadNamespaceMetadata |
| Tipo |
API del catálogo de REST de Iceberg |
| Ruta de REST |
GET/iceberg/v1/catalogs/{catalog}/namespaces/{ns} |
| Acción de IAM |
glue:GetDatabase |
| Permisos de Lake Formation | ALL, DESCRIBE, SELECT |
| Evento de CloudTrail |
glue:GetDatabase |
| Definición de API abierta | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L302 |
Consideraciones y limitaciones
-
El parámetro de ruta del catálogo debe seguir el estilo descrito en la sección Parámetros de prefijo y ruta de catálogo.
Solo puede especificar un espacio de nombres de un solo nivel en el parámetro de ruta de REST. Para obtener más información, consulte la sección Parámetro de ruta de espacio de nombres.
| Nombre de operación | UpdateNamespaceProperties |
| Tipo |
API del catálogo de REST de Iceberg |
| Ruta de REST |
POST /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/properties |
| Acción de IAM |
glue:UpdateDatabase |
| Permisos de Lake Formation | ALL, ALTER |
| Evento de CloudTrail |
glue:UpdateDatabase |
| Definición de API abierta | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L400 |
Consideraciones y limitaciones
-
El parámetro de ruta del catálogo debe seguir el estilo descrito en la sección Parámetros de prefijo y ruta de catálogo.
Solo puede especificar un espacio de nombres de un solo nivel en el parámetro de ruta de REST. Para obtener más información, consulte la sección Parámetro de ruta de espacio de nombres.
| Nombre de operación | DeleteNamespace |
| Tipo |
API del catálogo de REST de Iceberg |
| Ruta de REST |
DELETE/iceberg/v1/catalogs/{catalog}/namespces/{ns} |
| Acción de IAM |
glue:DeleteDatabase |
| Permisos de Lake Formation | ALL, DROP |
| Evento de CloudTrail |
glue:DeleteDatabase |
| Definición de API abierta | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L365 |
Consideraciones y limitaciones
-
El parámetro de ruta del catálogo debe seguir el estilo descrito en la sección Parámetros de prefijo y ruta de catálogo.
Solo puede especificar un espacio de nombres de un solo nivel en el parámetro de ruta de REST. Para obtener más información, consulte la sección Parámetro de ruta de espacio de nombres.
-
Si hay objetos en la base de datos, la operación fallará.
-
La API es asíncrona y devuelve un identificador de transacción que puede usar para realizar un seguimiento mediante la llamada a la API
CheckTransactionStatus. -
La API solo se puede usar si la llamada a la API
GetCatalogindicause-extensions=trueen la respuesta.
| Nombre de operación | StartDeleteNamespaceTransaction |
| Tipo |
API de extensiones AWS Glue |
| Ruta de REST |
DELETE /extensions/v1/catalogs/{catalog}/namespces/{ns} |
| Acción de IAM |
glue:DeleteDatabase |
| Permisos de Lake Formation | ALL, DROP |
| Evento de CloudTrail |
glue:DeleteDatabase |
| Definición de API abierta | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml#L85 |
Consideraciones y limitaciones
-
El parámetro de ruta del catálogo debe seguir el estilo descrito en la sección Parámetros de prefijo y ruta de catálogo.
Solo puede especificar un espacio de nombres de un solo nivel en el parámetro de ruta REST. Para obtener más información, consulte la sección Parámetro de ruta de espacio de nombres.
-
Si hay objetos en la base de datos, la operación fallará.
-
La API es asíncrona y devuelve un identificador de transacción que puede usar para realizar un seguimiento mediante la llamada a la API
CheckTransactionStatus. -
La API solo se puede usar si la llamada a la API
GetCatalogindicause-extensions=trueen la respuesta.
| Nombre de operación | ListTables |
| Tipo |
API del catálogo de REST de Iceberg |
| Ruta de REST |
GET /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables |
| Acción de IAM |
glue:GetTable |
| Permisos de Lake Formation | ALL, SELECT, DESCRIBE |
| Evento de CloudTrail |
glue:GetTable |
| Definición de API abierta | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L463 |
Consideraciones y limitaciones
-
El parámetro de ruta del catálogo debe seguir el estilo descrito en la sección Parámetros de prefijo y ruta de catálogo.
Solo puede especificar un espacio de nombres de un solo nivel en el parámetro de ruta de REST. Para obtener más información, consulte la sección Parámetro de ruta de espacio de nombres.
-
Se listarán todas las tablas, incluidas las que no son de Iceberg. Para determinar si una tabla se puede cargar como una tabla de Iceberg o no, llame a la operación
LoadTable.
| Nombre de operación | CreateTable |
| Tipo |
API del catálogo de REST de Iceberg |
| Ruta de REST |
GET /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables |
| Acción de IAM |
glue:CreateTable |
| Permisos de Lake Formation | ALL, CREATE_TABLE |
| Evento de CloudTrail |
glue:CreateTable |
| Definición de API abierta | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L497 |
Consideraciones y limitaciones
-
El parámetro de ruta del catálogo debe seguir el estilo descrito en la sección Parámetros de prefijo y ruta de catálogo.
Solo puede especificar un espacio de nombres de un solo nivel en el parámetro de ruta de REST. Para obtener más información, consulte la sección Parámetro de ruta de espacio de nombres.
-
CreateTablecon almacenamiento provisional no es compatible. Si se especifica el parámetro de consultastageCreate, la operación fallará. Esto significa que no se admite una operación comoCREATE TABLE AS SELECT, y el usuario debe utilizar una combinación deCREATE TABLEyINSERT INTOcomo solución alternativa. -
La operación de la API
CreateTableno admite la opciónstate-create = TRUE.
| Nombre de operación | CreateTable |
| Tipo |
API de extensiones AWS Glue |
| Ruta de REST |
POST/extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables |
| Acción de IAM |
glue:CreateTable |
| Permisos de Lake Formation | ALL, CREATE_TABLE |
| Evento de CloudTrail |
glue:CreateTable |
| Definición de API abierta | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml#L107 |
Consideraciones y limitaciones
-
El parámetro de ruta del catálogo debe seguir el estilo descrito en la sección Parámetros de prefijo y ruta de catálogo.
Solo puede especificar un espacio de nombres de un solo nivel en el parámetro de ruta de REST. Para obtener más información, consulte la sección Parámetro de ruta de espacio de nombres.
-
CreateTablecon almacenamiento provisional no es compatible. Si se especifica el parámetro de consultastageCreate, la operación fallará. Esto significa que no se admite una operación comoCREATE TABLE AS SELECT, y el usuario debe utilizar una combinación deCREATE TABLEyINSERT INTOcomo solución alternativa. -
La API es asíncrona y devuelve un identificador de transacción que puede usar para realizar un seguimiento mediante la llamada a la API
CheckTransactionStatus. -
La API solo se puede usar si la llamada a la API
GetCatalogindicause-extensions=trueen la respuesta.
| Nombre de operación | LoadTable |
| Tipo |
API de extensiones AWS Glue |
| Ruta de REST |
GET /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table} |
| Acción de IAM |
glue:GetTable |
| Permisos de Lake Formation | ALL, SELECT, DESCRIBE |
| evento de CloudTrail |
glue:GetTable |
| Definición de API abierta | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L616 |
Consideraciones
-
El parámetro de ruta del catálogo debe seguir el estilo descrito en la sección Parámetros de prefijo y ruta de catálogo.
Solo puede especificar un espacio de nombres de un solo nivel en el parámetro de ruta de REST. Para obtener más información, consulte la sección Parámetro de ruta de espacio de nombres.
-
CreateTablecon almacenamiento provisional no es compatible. Si se especifica el parámetro de consultastageCreate, la operación fallará. Esto significa que no se admite una operación comoCREATE TABLE AS SELECT, y el usuario debe utilizar una combinación deCREATE TABLEyINSERT INTOcomo solución alternativa. -
La API es asíncrona y devuelve un identificador de transacción que puede usar para realizar un seguimiento mediante la llamada a la API
CheckTransactionStatus. -
La API solo se puede usar si la llamada a la API
GetCatalogindicause-extensions=trueen la respuesta.
| Nombre de operación | LoadTable |
| Tipo |
API de extensiones AWS Glue |
| Ruta de REST |
GET /extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table} |
| Acción de IAM |
glue:GetTable |
| Permisos de Lake Formation | ALL, SELECT, DESCRIBE |
| evento de CloudTrail |
glue:GetTable |
| Definición de API abierta | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml#L134 |
Consideraciones
-
El parámetro de ruta del catálogo debe seguir el estilo descrito en la sección Parámetros de prefijo y ruta de catálogo.
Solo puede especificar un espacio de nombres de un solo nivel en el parámetro de ruta de REST. Para obtener más información, consulte la sección Parámetro de ruta de espacio de nombres.
-
Solo se admite el modo
allpara el parámetro de consulta de instantáneas. -
En comparación con la API
LoadTable, la APIExtendedLoadTablese diferencia en los siguientes aspectos:No exige estrictamente que todos los campos estén disponibles.
-
Proporciona los siguientes parámetros adicionales en el campo de configuración de la respuesta:
Parámetros adicionales Clave de configuración Descripción aws.server-side-capabilities.scan-planning
Indica si la tabla se puede escanear utilizando las API PreparePlan y PlanTable. aws.server-side-capabilities.data-commit
Indica si la tabla se puede confirmar mediante la transacción StartUpdateTable. aws.glue.staging.location
Se utiliza para la planificación de escaneos en el servidor o la confirmación de datos; es una ubicación provisional administrada por el servicio que el motor puede usar para escribir archivos de datos temporales.
aws.glue.staging.access-key-id
Se utiliza para la planificación de escaneos en el servidor o la confirmación de datos; es parte de las credenciales temporales de AWS para acceder a la ubicación provisional administrada por el servicio.
aws.glue.staging.secret-access-key
Se utiliza para la planificación del escaneo del lado del servidor o para la confirmación de datos, y forma parte de las credenciales temporales de AWS para acceder a la ubicación provisional gestionada por el servicio.
aws.glue.staging.session-token
Se utiliza para la planificación del escaneo del lado del servidor o para la confirmación de datos, y forma parte de las credenciales temporales de AWS para acceder a la ubicación provisional gestionada por el servicio.
aws.glue.staging.expiration-ms
Se utiliza para la planificación de escaneos en el servidor o la confirmación de datos; indica el tiempo de expiración de las credenciales para acceder a la ubicación provisional administrada por el servicio.
aws.glue.staging.data-transfer-role-arn
Se utiliza para la planificación de escaneos en el servidor o la confirmación de datos; es un rol de IAM que se puede asumir para acceder a la ubicación provisional administrada por el servicio.
| Nombre de operación | PreplanTable |
| Tipo |
API de extensiones AWS Glue |
| Ruta de REST |
POST /extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table}/preplan |
| Acción de IAM |
glue:GetTable |
| Permisos de Lake Formation | ALL, SELECT, DESCRIBE |
| evento de CloudTrail |
glue:GetTable |
| Definición de API abierta | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml#L211 |
Consideraciones
-
El parámetro de ruta del catálogo debe seguir el estilo descrito en la sección Parámetros de prefijo y ruta de catálogo.
Solo puede especificar un espacio de nombres de un solo nivel en el parámetro de ruta de REST. Para obtener más información, consulte la sección Parámetro de ruta de espacio de nombres.
-
El llamante de esta API siempre debe determinar si quedan resultados por recuperar en función del token de página. Es posible obtener una respuesta con un elemento de página vacío pero con un token de paginación si el servidor sigue procesando pero no puede generar ningún resultado en el tiempo de respuesta dado.
-
Puede usar esta API solo si la respuesta de la API
ExtendedLoadTablecontieneaws.server-side-capabilities.scan-planning=true.
| Nombre de operación | PlanTable |
| Tipo |
API de extensiones AWS Glue |
| Ruta de REST |
POST /extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table}/plan |
| Acción de IAM |
glue:GetTable |
| Permisos de Lake Formation | ALL, SELECT, DESCRIBE |
| evento de CloudTrail |
glue:GetTable |
| Definición de API abierta | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml#L243 |
Consideraciones
-
El parámetro de ruta del catálogo debe seguir el estilo descrito en la sección Parámetros de prefijo y ruta de catálogo.
Solo puede especificar un espacio de nombres de un solo nivel en el parámetro de ruta de REST. Para obtener más información, consulte la sección Parámetro de ruta de espacio de nombres.
-
El llamante de esta API siempre debe determinar si quedan resultados por recuperar en función del token de página. Es posible obtener una respuesta con un elemento de página vacío pero con un token de paginación si el servidor sigue procesando pero no puede generar ningún resultado en el tiempo de respuesta dado.
-
Puede usar esta API solo si la respuesta de la API
ExtendedLoadTablecontieneaws.server-side-capabilities.scan-planning=true.
| Nombre de operación | TableExists |
| Tipo |
API del catálogo de REST de Iceberg |
| Ruta de REST |
HEAD/iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table} |
| Acción de IAM |
glue:GetTable |
| Permisos de Lake Formation | ALL, SELECT, DESCRIBE |
| evento de CloudTrail |
glue:GetTable |
| Definición de API abierta | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L833 |
Consideraciones
-
El parámetro de ruta del catálogo debe seguir el estilo descrito en la sección Parámetros de prefijo y ruta de catálogo.
Solo puede especificar un espacio de nombres de un solo nivel en el parámetro de ruta de REST. Para obtener más información, consulte la sección Parámetro de ruta de espacio de nombres.
| Nombre de operación | UpdateTable |
| Tipo |
API del catálogo de REST de Iceberg |
| Ruta de REST |
POST /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table} |
| Acción de IAM |
glue:UpdateTable |
| Permisos de Lake Formation | ALL, ALTER |
| evento de CloudTrail |
glue:UpdateTable |
| Definición de API abierta | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L677 |
Consideraciones
-
El parámetro de ruta del catálogo debe seguir el estilo descrito en la sección Parámetros de prefijo y ruta de catálogo.
Solo puede especificar un espacio de nombres de un solo nivel en el parámetro de ruta de REST. Para obtener más información, consulte la sección Parámetro de ruta de espacio de nombres.
| Nombre de operación | StartUpdateTableTransaction |
| Tipo | API de extensión AWS Glue |
| Ruta de REST |
POST/extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table} |
| Acción de IAM |
glue:UpdateTable |
| Permisos de Lake Formation |
ALL, ALTER |
| evento de CloudTrail |
glue:UpdateTable |
| Definición de API abierta | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml#L154 |
Consideraciones
-
El parámetro de ruta del catálogo debe seguir el estilo descrito en la sección Parámetros de prefijo y ruta de catálogo.
Solo puede especificar un espacio de nombres de un solo nivel en el parámetro de ruta de REST. Para obtener más información, consulte la sección Parámetro de ruta de espacio de nombres.
-
La API es asíncrona y devuelve un identificador de transacción que puede usar para realizar un seguimiento mediante la llamada a la API
CheckTransactionStatus. -
También se puede realizar una operación
RenamTablea través de esta API. Cuando eso ocurre, la persona que llama también debe tener el permiso Glue:CreateTable o LakeFormation CREATE_TABLE para cambiar el nombre de la tabla. -
Puede usar esta API solo si la respuesta de la API
ExtendedLoadTablecontieneaws.server-side-capabilities.scan-planning=true.
| Nombre de operación | DeleteTable |
| Tipo |
API del catálogo de REST de Iceberg |
| Ruta de REST |
DELETE/iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table} |
| Acción de IAM |
glue:DeleteTable |
| Permisos de Lake Formation | ALL, DROP |
| evento de CloudTrail |
glue:DeleteTable |
| Definición de API abierta | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L793 |
Consideraciones
-
El parámetro de ruta del catálogo debe seguir el estilo descrito en la sección Parámetros de prefijo y ruta de catálogo.
Solo puede especificar un espacio de nombres de un solo nivel en el parámetro de ruta de REST. Para obtener más información, consulte la sección Parámetro de ruta de espacio de nombres.
-
La operación de API
DeleteTableadmite una opción de purga. Si la purga está establecida entrue, los datos de la tabla se eliminan; de lo contrario, no se eliminarán. En el caso de las tablas de Amazon S3, la operación no elimina los datos de las tablas. La operación devuelve un error cuando la tabla está almacenada en Amazon S3 ypurge = TRUE,.En el caso de las tablas que se guardan en el almacenamiento gestionado de Amazon Redshift, la operación eliminará los datos de la tabla, de forma similar al comportamiento
DROP TABLEde Amazon Redshift. La operación devuelve un error cuando la tabla está almacenada en Amazon Redshift ypurge = FALSE. -
purgeRequest=trueno se admite.
| Nombre de operación | StartDeleteTableTransaction |
| Tipo |
API de extensiones AWS Glue |
| Ruta de REST |
DELETE /extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table} |
| Acción de IAM |
glue:DeleteTable |
| Permisos de Lake Formation | ALL, DROP |
| evento de CloudTrail |
glue:DeleteTable |
| Definición de API abierta | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L793 |
Consideraciones
-
El parámetro de ruta del catálogo debe seguir el estilo descrito en la sección Parámetros de prefijo y ruta de catálogo.
Solo puede especificar un espacio de nombres de un solo nivel en el parámetro de ruta de REST. Para obtener más información, consulte la sección Parámetro de ruta de espacio de nombres.
-
purgeRequest=falseno se admite. -
La API es asíncrona y devuelve un identificador de transacción que se puede rastrear mediante
CheckTransactionStatus.
| Nombre de operación | CheckTransactionStatus |
| Tipo |
API de extensiones AWS Glue |
| Ruta de REST |
POST/extensions/v1/transactions/status |
| Acción de IAM |
El mismo permiso que la acción que inicia la transacción |
| Permisos de Lake Formation | El mismo permiso que la acción que inicia la transacción |
| Definición de API abierta | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml#L273 |
Consideraciones
-
El parámetro de ruta del catálogo debe seguir el estilo descrito en la sección Parámetros de prefijo y ruta de catálogo.
