Registrar un catálogo de datos desde otra cuenta

Puede utilizar la característica de catálogo de AWS Glue de cuentas cruzadas de Athena para registrar un catálogo AWS Glue desde una cuenta que no sea la suya. Después de configurar los permisos de IAM necesarios para AWS Glue y registrar el catálogo como recurso de DataCatalog de Athena, puede utilizar Athena para ejecutar consultas entre cuentas. Para obtener información sobre la configuración de los permisos necesarios, consulte Configuración del acceso entre cuentas a los catálogos de datos de AWS Glue.

El procedimiento siguiente muestra cómo utilizar Athena para configurar un AWS Glue Data Catalog en una cuenta de Amazon Web Services distinta de la suya como origen de datos.

Registrar desde la consola

1. Siga los pasos de Configuración del acceso entre cuentas a los catálogos de datos de AWS Glue para asegurarse de que tiene permisos para consultar el catálogo de datos en la otra cuenta.

2. Abra la consola de Athena en https://console.aws.amazon.com/athena/.

3. Si el panel de navegación de la consola no está visible, elija el menú de expansión de la izquierda.

   

4. Elija Orígenes de datos y catálogos.

5. En la parte superior derecha de la consola, seleccione Create data source (Crear origen de datos).

6. En la página Choose a data source (Elegir un origen de datos), para Data Sources (Orígenes de datos), elija S3 -AWS Glue Data Catalog y, a continuación, elija Next (Siguiente).

7. En la página Introducir detalles del origen de datos, en la sección AWS Glue Data Catalog, para Elegir un AWS Glue Data Catalog, elija AWS Glue Data Catalog en otra cuenta.

8. En Dataset details (Detalles del origen de datos), ingrese la siguiente información:

   • Data source name (Nombre del origen de datos): ingrese el nombre que desea utilizar en las consultas SQL para hacer referencia al catálogo de datos de la otra cuenta.

   • Descripción: (opcional) ingrese una descripción del catálogo de datos en la otra cuenta.

   • ID del catálogo: ingrese el ID de cuenta de Amazon Web Services de 12 dígitos de la cuenta a la que pertenece el catálogo de datos. El ID de cuenta de Amazon Web Services es el ID del catálogo.

9. (Opcional) En Tags (Etiquetas), ingrese pares clave-valor que quiera asociar con el origen de datos. Para obtener más información acerca de las etiquetas, consulte Etiquetado de recursos de Athena.

10. Elija Siguiente.

11. En la página Review and create (Revisar y crear), revise la información que ha proporcionado y, a continuación, elija Create data source (Crear un origen de datos). En la página Data source details (Detalles de origen de datos) se enumeran las bases de datos y etiquetas del catálogo de datos que ha registrado.

12. Elija Orígenes de datos y catálogos. El catálogo de datos que ha registrado se muestra en la columna Data source name (Nombre de origen de datos).

13. Para ver o editar información sobre el nuevo catálogo de datos, elija el catálogo y, a continuación, elija Actions (Acciones) y Edit (Editar).

14. Para eliminar el nuevo catálogo de datos, elija el catálogo y, a continuación, elija Actions (Acciones) y Delete (Eliminar).

Registrar usando las operaciones API

1. El siguiente cuerpo de solicitud de CreateDataCatalog registra un catálogo de AWS Glue para acceso entre cuentas:

   # Example CreateDataCatalog request to register a cross-account Glue catalog:
   {
       "Description": "Cross-account Glue catalog",
       "Name": "ownerCatalog",
       "Parameters": {"catalog-id" : "<catalogid>"  # Owner's account ID
       },
       "Type": "GLUE"
   }

2. El siguiente código de muestra utiliza un cliente Java para crear el objeto DataCatalog.

   # Sample code to create the DataCatalog through Java client
   CreateDataCatalogRequest request = new CreateDataCatalogRequest()
       .withName("ownerCatalog")
       .withType(DataCatalogType.GLUE)
       .withParameters(ImmutableMap.of("catalog-id", "<catalogid>"));
   
   athenaClient.createDataCatalog(request);

   Después de estos pasos, el prestatario debe ver el ownerCatalog cuando llama a la operación de la API ListDataCatalogs.

Registrar usando AWS CLI

Utilice el siguiente comando CLI de ejemplo para registrar una AWS Glue Data Catalog desde otra cuenta.

aws athena create-data-catalog \
  --name cross_account_catalog \
  --type GLUE \
  --description "Cross Account Catalog" \
  --parameters catalog-id=<catalogid>

Para obtener más información, consulte Query cross-account AWS Glue Data Catalogs using Amazon Athena en el Blog de macrodatos de AWS.