Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Creación de enlaces de recursos
Los enlaces de recursos son objetos del catálogo de datos que son enlaces a bases de datos y tablas de metadatos, normalmente a bases de datos y tablas compartidas de otras AWS cuentas. Ayudan a permitir el acceso entre cuentas a los datos del lago de datos en todas las regiones. AWS
**nota**
Lake Formation permite consultar las tablas del catálogo de datos en todas las AWS regiones. Puede acceder a las bases de datos y tablas del catálogo de datos desde cualquier AWS región creando enlaces de recursos en esas regiones que apunten a bases de datos y tablas compartidas en diferentes regiones.
**Topics**
+ [Cómo funcionan los enlaces de recursos en Lake Formation](resource-links-about.md)
+ [Crear un enlace de recursos a una tabla de Catálogo de datos compartida](create-resource-link-table.md)
+ [Crear un enlace de recursos a una base de datos de Catálogo de datos compartida](create-resource-link-database.md)
+ [Gestión de enlaces de recursos en AWS Glue APIs](resource-links-glue-apis.md)
# Cómo funcionan los enlaces de recursos en Lake Formation
Un *enlace de recursos* es un objeto de Catálogo de datos que actúa como enlace con una tabla o base de datos local o compartida. Después de crear un enlace de recursos a una tabla o una base de datos, puede emplear el nombre de dicho enlace donde vaya a utilizar el nombre de la base de datos. `glue:GetTables()` devuelve los enlaces de recursos de tablas y las tablas, ya sean suyas o compartidas, y aparecen como entradas en la página **Tablas** de la consola de Lake Formation. Los enlaces de recursos a bases de datos actúan de manera similar.
Al crear un enlace de recursos a una base de datos o tabla podrá:
+ Asignar un nombre diferente a una base de datos o tabla de su Catálogo de datos. Esto resulta especialmente útil si AWS cuentas diferentes comparten bases de datos o tablas con el mismo nombre, o si varias bases de datos de su cuenta tienen tablas con el mismo nombre.
+ Acceda a las bases de datos y tablas del catálogo de datos desde cualquier AWS región creando enlaces de recursos en esas regiones que apunten a la base de datos y las tablas de otra región. Puede ejecutar consultas en cualquier región con estos enlaces de recursos mediante Athena, Amazon EMR y ejecutar trabajos de ETL Spark de AWS Glue , sin copiar los datos de origen ni los metadatos del Glue Data Catalog.
+ Utilice AWS servicios integrados, como Amazon Athena Amazon Redshift Spectrum, para ejecutar consultas que accedan a tablas o bases de datos compartidas. Algunos servicios integrados no pueden acceder directamente a las bases de datos o tablas entre cuentas. Sin embargo, pueden acceder a los enlaces de recursos presentes en su cuenta a las bases de datos y tablas de otras cuentas.
**nota**
No es necesario crear un enlace de recursos para hacer referencia a una base de datos o tabla compartida en los scripts de extracción, transformación y carga (ETL) de AWS Glue. Sin embargo, para evitar la ambigüedad cuando varias cuentas de AWS comparten una base de datos o una tabla con el mismo nombre, puede crear y utilizar un enlace de recursos o especificar el identificador del catálogo al invocar las operaciones de ETL.
En el ejemplo siguiente, se muestra la página **Tablas** de la consola de Lake Formation, que muestra dos enlaces de recursos. Los nombres de los enlaces de recursos siempre se muestran en cursiva. Cada enlace de recursos se muestra junto con el nombre y el propietario del recurso compartido vinculado. En este ejemplo, un administrador de un lago de datos de la AWS cuenta 1111-2222-3333 compartió las tablas `inventory` y `incidents` con la cuenta 1234-5678-9012. A continuación, un usuario de esa cuenta creó enlaces de recursos a esas tablas compartidas.
![\[La página Tablas muestra dos enlaces de recursos. El nombre del enlace de recursos se muestra en la columna Nombre, el nombre de la tabla compartida en la columna Recurso compartido y la cuenta que compartió la tabla se muestra en la columna Propietario del recurso compartido.\]](http://docs.aws.amazon.com/es_es/lake-formation/latest/dg/images/tables-with-links.png)
Las siguientes son notas y restricciones sobre los enlaces de recursos:
+ Los enlaces de recursos son necesarios para permitir que los servicios integrados, como Athena y Redshift Spectrum, consulten los datos subyacentes de las tablas compartidas. Las consultas en estos servicios integrados se crean a partir de los nombres de los enlaces de recursos.
+ Si asumimos que la configuración para **usar solo el control de acceso de IAM para las nuevas tablas de esta base de datos** esté desactivada en la base de datos que la contiene, solo la entidad principal que creó un enlace de recursos podrá verla y acceder a ella. Para que otras entidades principales de su cuenta puedan acceder a un enlace de recursos, conceda el permiso de `DESCRIBE` correspondiente. Para que otros usuarios puedan eliminar un enlace de recursos, concédales el permiso de `DROP`. Los administradores del lago de datos pueden acceder a todos los enlaces de recursos de la cuenta. Para eliminar un enlace de recurso creado por otra entidad principal, el administrador del lago de datos primero debe concederse el permiso de `DROP` para acceder al enlace de recurso. Para obtener más información, consulte [Referencia de permisos de Lake Formation](lf-permissions-reference.md).
**importante**
Conceder permisos en un enlace de recursos no otorga permisos en la tabla o base de datos (vinculada) de destino. Debe conceder los permisos en el destino por separado.
+ Para crear un enlace a un recurso, necesita el `CREATE_DATABASE` permiso `CREATE_TABLE` o Lake Formation, así como el permiso `glue:CreateTable` or `glue:CreateDatabase` AWS Identity and Access Management (IAM).
+ Puede crear enlaces de recursos a los recursos del catálogo de datos local (de su propiedad), así como a los recursos compartidos con su AWS cuenta.
+ Al crear un enlace de recursos, no se comprueba si el recurso compartido de destino existe ni si tiene permisos entre cuentas sobre el recurso. Esto le permite crear el enlace de recurso y el recurso compartido en cualquier orden.
+ Si elimina un enlace de recurso, el recurso compartido vinculado no se elimina. Si elimina un recurso compartido, los enlaces de recursos a ese recurso no se eliminan.
+ Es posible crear cadenas de enlaces de recursos. Sin embargo, no tiene sentido hacerlo, ya que solo APIs siguen el primer enlace al recurso.
**Véase también:**
[Concesión de permisos sobre los recursos del Catálogo de datos](granting-catalog-permissions.md)
# Crear un enlace de recursos a una tabla de Catálogo de datos compartida
Puedes crear un enlace de recursos a una tabla compartida en cualquier AWS región mediante la AWS Lake Formation consola, la API o AWS Command Line Interface (AWS CLI).
**Para crear un enlace de recursos a una tabla compartida (consola)**
1. Abre la AWS Lake Formation consola en [https://console.aws.amazon.com/lakeformation/](https://console.aws.amazon.com/lakeformation/). Inicie sesión como una entidad principal que tenga el permiso de `CREATE_TABLE` de Lake Formation en la base de datos que contiene el enlace de recursos.
1. En el panel de navegación, elija **Tablas** en Catálogo de datos y, a continuación, elija **Crear**, **Enlace de recursos**.
1. En la página **Crear enlace de recursos**, proporcione la siguiente información:
**Nombre del enlace de recursos**
Introduzca un nombre que cumpla las mismas reglas que el nombre de una tabla. El nombre puede ser el mismo que el de la tabla compartida de destino.
**Base de datos**
La base de datos del catálogo local que contiene el enlace de recursos.
**Región del propietario de la tabla**
Si va a crear el enlace de recursos en una región diferente, seleccione la región de la tabla compartida de destino.
**Tabla compartida**
Seleccione una tabla compartida de la lista o introduzca un nombre de tabla local (propia) o compartida.
La lista contiene todas las tablas compartidas con su cuenta. Anote la base de datos y el ID de la cuenta del propietario que aparecen en cada tabla. Si no se muestra una tabla que sabe que se ha compartido con su cuenta, verifique lo siguiente:
+ Si no es administrador de un lago de datos, compruebe que el administrador del lago de datos le haya concedido los permisos de Lake Formation sobre la tabla.
+ Si es administrador de un lago de datos y su cuenta no pertenece a la misma organización de AWS que la cuenta que los concede, asegúrese de haber aceptado la invitación para compartir recursos AWS Resource Access Manager (AWS RAM) de la tabla. Para obtener más información, consulte [Aceptar una invitación para compartir recursos de AWS RAM](accepting-ram-invite.md).
**Base de datos de la tabla compartida**
Si ha seleccionado una tabla compartida de la lista, este campo se rellena con la base de datos de la tabla compartida en la cuenta externa. De lo contrario, introduzca una base de datos local (para un enlace de recursos a una tabla local) o la base de datos de la tabla compartida en la cuenta externa.
**Propietario de tabla compartida**
Si ha seleccionado una tabla compartida de la lista, este campo se rellena con el ID de la cuenta del propietario de la tabla compartida. De lo contrario, introduce tu ID de AWS cuenta (para un enlace de recursos a una tabla local) o el ID de la AWS cuenta que compartió la tabla.
1. Elija **Crear** para crear el enlace de recursos.
A continuación, puede ver el nombre del enlace de recursos en la columna **Nombre** de la página **Tablas**.
1. (Opcional) Otorgue el permiso de `DESCRIBE` de Lake Formation en el enlace de recursos a las entidades principales que deben poder ver el enlace y acceder a la tabla de destino.
No obstante, conceder permisos en un enlace a un recurso no otorga permisos en la tabla o base de datos (vinculada) de destino. Debe conceder permisos en la base de datos de destino por separado para que el table/resource enlace esté visible en Athena.
**Para crear un enlace de recursos a una tabla compartida en la misma región (AWS CLI)**
1. Introduzca un comando similar al siguiente.
```
aws glue create-table --database-name myissues --table-input '{"Name":"my_customers","TargetTable":{"CatalogId":"111122223333","DatabaseName":"issues","Name":"customers"}}'
```
Este comando crea un enlace de recursos con el nombre `my_customers` a la tabla compartida `customers`, que está en la base de datos `issues` de la cuenta de AWS 1111-2222-3333. El enlace de recursos se almacena en la base de datos local `myissues`.
1. (Opcional) Otorgue el permiso de `DESCRIBE` de Lake Formation en el enlace de recursos a las entidades principales que deben poder ver el enlace y acceder a la tabla de destino.
No obstante, conceder permisos en un enlace a un recurso no otorga permisos en la tabla (vinculada) de destino. Debe conceder permisos en la base de datos de destino por separado para que el table/resource enlace esté visible en Athena.
**Para crear un enlace de recursos a una tabla compartida en una región diferente (AWS CLI)**
1. Introduzca un comando similar al siguiente.
```
aws glue create-table --region eu-west-1 --cli-input-json '{
"CatalogId": "111122223333",
"DatabaseName": "ireland_db",
"TableInput": {
"Name": "rl_useast1salestb_ireland",
"TargetTable": {
"CatalogId": "444455556666",
"DatabaseName": "useast1_salesdb",
"Region": "us-east-1",
"Name":"useast1_salestb"
}
}
}‘
```
Este comando crea un enlace de recurso denominado `rl_useast1salestb_ireland` en la región Europa (Irlanda) a la `useast1_salestb` tabla compartida, que se encuentra en la `useast1_salesdb` base de datos de AWS la cuenta 444455556666 de la región EE.UU. Este (Norte de Virginia). El enlace de recursos se almacena en la base de datos local `ireland_db`.
1. Conceda permiso de `DESCRIBE` de Lake Formation a las entidades principales que deben poder ver el enlace y acceder al destino del enlace a través del enlace.
No obstante, conceder permisos en un enlace a un recurso no otorga permisos en la tabla (vinculada) de destino. Debe conceder permisos en la tabla de destino por separado para que el table/resource enlace esté visible en Athena.
**Véase también:**
[Cómo funcionan los enlaces de recursos en Lake Formation](resource-links-about.md)
[`DESCRIBE`](lf-permissions-reference.md#perm-describe)
# Crear un enlace de recursos a una base de datos de Catálogo de datos compartida
Puede crear un enlace de recursos a una base de datos compartida mediante la AWS Lake Formation consola, la API o AWS Command Line Interface (AWS CLI).
**Para crear un enlace de recursos a una base de datos compartida (consola)**
1. Abre la AWS Lake Formation consola en [https://console.aws.amazon.com/lakeformation/](https://console.aws.amazon.com/lakeformation/). Inicie sesión como administrador de un lago de datos o como creador de bases de datos.
El creador de una base de datos es una entidad principal a la que se le ha otorgado el permiso de `CREATE_DATABASE` de Lake Formation.
1. En el panel de navegación, elija **Bases de datos** y, a continuación, elija **Crear**, **Enlace de recursos**.
1. En la página **Crear enlace de recursos**, proporcione la siguiente información:
**Nombre del enlace de recursos**
Introduzca un nombre que cumpla las mismas reglas que el nombre de una base de datos. El nombre puede ser el mismo que el de la base de datos compartida de destino.
**Catálogo de destino**
Seleccione el catálogo de destino para el enlace de recursos de la base de datos.
**Región propietaria de la base de datos compartida**
Si va a crear el enlace de recursos en una región diferente, seleccione la región de la base de datos compartida de destino.
**Base de datos compartida**
Elija una base de datos de la lista o introduzca un nombre de base de datos local (propia) o compartida.
La lista contiene todas las bases de datos compartidas con su cuenta. Observe el ID de la cuenta del propietario que aparece con cada base de datos. Si no ve una base de datos que sabe que se ha compartido con su cuenta, verifique lo siguiente:
+ Si no es administrador de un lago de datos, compruebe que el administrador del lago de datos le haya concedido los permisos de Lake Formation sobre la base de datos.
+ Si es administrador de un lago de datos y su cuenta no pertenece a la misma organización AWS que la cuenta concedente, asegúrese de haber aceptado la invitación para compartir recursos AWS Resource Access Manager (AWS RAM) de la base de datos. Para obtener más información, consulte [Aceptar una invitación para compartir recursos de AWS RAM](accepting-ram-invite.md).
**Propietario de la base de datos compartida**
Si ha seleccionado una base de datos compartida de la lista, este campo se rellena con el ID de la cuenta del propietario de la base de datos compartida. De lo contrario, introduzca el ID de su AWS cuenta (para un enlace de recursos a una base de datos local) o el ID de la AWS cuenta que compartió la base de datos.
**ID de catálogo de la base de datos compartida**
Introduzca el ID de catálogo de la base de datos compartida. Al crear un enlace de recursos a una base de datos compartida desde otra cuenta de AWS , debe especificar este ID de catálogo para identificar qué Catálogo de datos de la cuenta contiene la base de datos de origen.
Al seleccionar una base de datos compartida en el menú desplegable, el sistema rellena automáticamente el ID de catálogo de la cuenta propietaria de esa base de datos y que la ha compartido con usted.
![\[El cuadro de diálogo Detalles de la base de datos tiene marcado el botón del enlace de recursos, con los campos siguientes rellenos: Nombre del enlace de recursos, Base de datos compartida, ID del propietario de la base de datos compartida. El ID del propietario de la base de datos compartida está deshabilitado (es de solo lectura).\]](http://docs.aws.amazon.com/es_es/lake-formation/latest/dg/images/create-resource-link-db.png)
1. Elija **Crear** para crear el enlace de recursos.
A continuación, puede ver el nombre del enlace de recursos en la columna **Nombre** de la página **Bases de datos**.
1. (Opcional) Conceda el permiso de `DESCRIBE` de Lake Formation en el enlace de recursos a las entidades principales de la región de Europa (Irlanda) que deben poder ver el enlace y acceder a la base de datos de destino.
No obstante, conceder permisos en un enlace a un recurso no otorga permisos en la tabla o base de datos (vinculada) de destino. Debe conceder permisos en la base de datos de destino por separado para que el table/resource enlace esté visible en Athena.
**Para crear un enlace de recursos a una base de datos compartida en la misma región (AWS CLI)**
1. Introduzca un comando similar al siguiente.
```
aws glue create-database --database-input '{"Name":"myissues","TargetDatabase":{"CatalogId":"111122223333","DatabaseName":"issues"}}'
```
Este comando crea un enlace de recursos con el nombre `myissues` de la base de datos compartida`issues`, que se encuentra en la AWS cuenta 1111-2222-3333.
1. (Opcional) Otorgue el permiso `DESCRIBE` de Lake Formation a las entidades principales del enlace de recursos para que puedan ver el enlace y acceder a la tabla o base de datos de destino.
No obstante, conceder permisos en un enlace a un recurso no otorga permisos en la tabla o base de datos (vinculada) de destino. Debe conceder permisos en la base de datos de destino por separado para que el table/resource enlace esté visible en Athena.
**Para crear un enlace de recursos a una base de datos compartida en una región diferente (AWS CLI)**
1. Introduzca un comando similar al siguiente.
```
aws glue create-database --region eu-west-1 --cli-input-json '{
"CatalogId": "111122223333",
"DatabaseInput": {
"Name": "rl_useast1shared_irelanddb",
"TargetDatabase": {
"CatalogId": "444455556666",
"DatabaseName": "useast1shared_db",
"Region": "us-east-1"
}
}
}'
```
Este comando crea un enlace de recursos denominado `rl_useast1shared_irelanddb` en la AWS cuenta 111122223333 de la región Europa (Irlanda) a la base de datos compartida`useast1shared_db`, que se encuentra en la AWS cuenta 444455556666 de la región EE.UU. Este (Norte de Virginia).
1. Conceda el permiso de `DESCRIBE` de Lake Formation a las entidades principales de la región de Europa (Irlanda) que deben poder ver el enlace y acceder al destino del enlace a través del enlace.
**Véase también:**
[Cómo funcionan los enlaces de recursos en Lake Formation](resource-links-about.md)
[`DESCRIBE`](lf-permissions-reference.md#perm-describe)
# Gestión de enlaces de recursos en AWS Glue APIs
En las siguientes tablas se explica cómo gestiona el catálogo AWS Glue APIs de datos 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`](lf-permissions-reference.md#perm-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](resource-links-about.md)