Gestión de enlaces de recursos en las API de AWS Glue

En las tablas siguientes se explica cómo las API del Catálogo de datos de AWS Glue gestionan los enlaces a los recursos de bases de datos y tablas. Para todas las operaciones de la API de Get*, solo se devuelven las bases de datos y las tablas sobre las que la persona que llama tiene permiso. Además, al acceder a una base de datos o tabla de destino a través de un enlace de recursos, debe tener los permisos AWS Identity and Access Management (IAM) y Lake Formation tanto en el enlace de destino como en el enlace de recursos. El permiso de Lake Formation que se requiere en los enlaces de recursos es DESCRIBE. Para obtener más información, consulte DESCRIBE.

Operaciones de la API de base de datos
Operación de la API	Gestión de enlaces de recursos
CreateDatabase	Si la base de datos es un enlace de recursos, crea el enlace de recursos a la base de datos de destino designada.
UpdateDatabase	Si la base de datos es un enlace de recursos, sigue el enlace y actualiza la base de datos de destino. Si el enlace de recursos se debe modificar para enlazarlo a una base de datos diferente, debe eliminarlo y crear uno nuevo.
DeleteDatabase	Elimina el enlace de recursos. No elimina la base de datos vinculada (de destino).
GetDatabase	Si la persona que llama tiene permisos sobre el destino, sigue el enlace para obtener las propiedades del destino. De lo contrario, devuelve las propiedades del enlace.
GetDatabases	Devuelve una lista de bases de datos, incluidos los enlaces de recursos. Para cada enlace de recursos del conjunto de resultados, la operación sigue el enlace para obtener las propiedades del destino del enlace. Debe especificar ResourceShareType = ALL para ver las bases de datos compartidas con su cuenta.

Operaciones de la API de tabla
Operación de la API	Gestión de enlaces de recursos
CreateTable	Si la base de datos es un enlace de recursos, sigue el enlace de la base de datos y crea una tabla en la base de datos de destino. Si la tabla es un enlace de recursos, la operación crea el enlace de recursos en la base de datos designada. No es compatible crear un enlace de recursos de tabla a través de un enlace de recursos de base de datos.
UpdateTable	Si la tabla o la base de datos designada es un enlace de recursos, actualiza la tabla de destino. Si tanto la tabla como la base de datos son enlaces de recursos, la operación falla.
DeleteTable	Si la base de datos designada es un enlace de recursos, sigue el enlace y borra la tabla o el enlace de recursos de tabla en la base de datos de destino. Si la tabla es un enlace de recursos, la operación borra el enlace de recursos de la tabla en la base de datos designada. La eliminación de un enlace de recursos de tabla no elimina la tabla de destino.
BatchDeleteTable	Igual que DeleteTable.
GetTable	Si la base de datos designada es un enlace de recursos, sigue el enlace de la base de datos y devuelve la tabla o el enlace de recursos de la tabla de la base de datos de destino. En caso contrario, si la tabla es un enlace de recursos, la operación sigue el enlace y devuelve las propiedades de la tabla de destino.
GetTables	Si la base de datos designada es un enlace de recursos, sigue el enlace de la base de datos y devuelve las tablas y los enlaces de recursos de tablas de la base de datos de destino. Si la base de datos de destino es una base de datos compartida de otra AWS cuenta, la operación devuelve solo las tablas compartidas de esa base de datos. No sigue los enlaces de recursos de la tabla en la base de datos de destino. De lo contrario, si la base de datos designada es una base de datos local (propia), la operación devuelve todas las tablas de la base de datos local, y sigue cada enlace de recurso de tabla para devolver las propiedades de la tabla de destino.
SearchTables	Devuelve enlaces a recursos de tablas y tablas. No sigue los enlaces para devolver las propiedades de la tabla de destino. Debe especificar ResourceShareType = ALL para ver las bases de datos compartidas con su cuenta.
GetTableVersion	Igual que GetTable.
GetTableVersions	Igual que GetTable.
DeleteTableVersion	Igual que DeleteTable.
BatchDeleteTableVersion	Igual que DeleteTable.

Operaciones de la API en una partición
Operación de la API	Gestión de enlaces de recursos
CreatePartition	Si la base de datos designada es un enlace de recursos, sigue el enlace de la base de datos y crea una partición en la tabla designada de la base de datos de destino. Si la tabla es un enlace de recursos, la operación sigue el enlace de recursos y crea la partición en la tabla de destino. No es compatible crear una partición mediante un enlace de recursos de tabla y un enlace de recursos de base de datos.
BatchCreatePartition	Igual que CreatePartition.
UpdatePartition	Si la base de datos designada es un enlace de recursos, sigue el enlace de la base de datos y actualiza la partición en la tabla designada de la base de datos de destino. Si la tabla es un enlace de recursos, la operación sigue el enlace de recursos y actualiza la partición en la tabla de destino. No es compatible actualizar una partición mediante un enlace de recursos de tabla y un enlace de recursos de base de datos.
DeletePartition	Si la base de datos designada es un enlace de recursos, sigue el enlace de la base de datos y borra la partición en la tabla designada en la base de datos de destino. Si la tabla es un enlace de recursos, la operación sigue el enlace de recursos y borra la partición en la tabla de destino. No es compatible eliminar una partición mediante un enlace de recursos de tabla y un enlace de recursos de base de datos.
BatchDeletePartition	Igual que DeletePartition.
GetPartition	Si la base de datos designada es un enlace de recursos, sigue el enlace de la base de datos y devuelve la información de partición de la tabla designada. En caso contrario, si la tabla es un enlace de recursos, la operación sigue el enlace y devuelve información sobre la partición. Si la tabla y la base de datos son enlaces de recursos, devuelve un conjunto de resultados vacío.
GetPartitions	Si la base de datos designada es un enlace de recursos, sigue el enlace de la base de datos y devuelve la información de partición para todas las particiones de la tabla designada. En caso contrario, si la tabla es un enlace de recursos, la operación sigue el enlace y devuelve información sobre la partición. Si la tabla y la base de datos son enlaces de recursos, devuelve un conjunto de resultados vacío.
BatchGetPartition	Igual que GetPartition.

Operaciones de la API con funciones definidas por el usuario
Operación de la API	Gestión de enlaces de recursos
(Todas las operaciones de la API)	Si la base de datos es un enlace de recursos, sigue el enlace de recursos y efectúa la operación en la base de datos de destino.

Véase también:

• Cómo funcionan los enlaces de recursos en Lake Formation