Actualización de un conector de origen de datos - Amazon Athena

Actualización de un conector de origen de datos

Athena recomienda actualizar periódicamente los conectores de orígenes de datos que utilice a la última versión para aprovechar las nuevas características y mejoras. Para empezar, debe buscar el número de la última versión.

Búsqueda de la última versión de Athena Query Federation

El número de versión más reciente de los conectores de orígenes de datos de Athena corresponde a la última versión de Athena Query Federation. En ciertos casos, las versiones de GitHub pueden ser ligeramente más recientes que las que están disponibles en el AWS Serverless Application Repository (SAR).

Para buscar la última versión de Athena Query Federation
  1. Visite la URL de GitHub https://github.com/awslabs/aws-athena-query-federation/releases/latest.

  2. Anote el número de la versión en el encabezado de la página principal en el siguiente formato:

    Versión v year.week_of_year.iteration_of_week de Athena Query Federation

    Por ejemplo, el número de versión de la Versión v2023.8.3 de Athena Query Federation es 2023.8.3.

Búsqueda y anotación de los nombres de los recursos

Como preparación para la actualización, debe buscar y anotar la siguiente información:

  1. El nombre de la función de Lambda del conector.

  2. Las variables de entorno para la función de Lambda.

  3. El nombre de la aplicación de Lambda, que administra la función de Lambda del conector.

Para buscar nombres de recursos en la consola de Athena
  1. Abra la consola de Athena en https://console.aws.amazon.com/athena/.

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

    Elija el menú de expansión.
  3. En el panel de navegación, elija Data source (Orígenes de datos).

  4. En la columna Nombre del origen de datos, elija el enlace al origen de datos del conector.

  5. En la sección Detalles del origen de datos, en Función de Lambda, elija el enlace a su función de Lambda.

    Elija el enlace a su función de Lambda.
  6. En la página Funciones, en la columna Nombre de la función, anote el nombre de la función del conector.

    Anote el nombre de la función.
  7. Seleccione el enlace del nombre de la función.

  8. En la sección Información general de la función, seleccione la pestaña Configuración.

  9. En el panel de la izquierda, elija Variables de entorno.

  10. En la sección Variables de entorno, anote las claves y sus valores correspondientes.

  11. Desplácese hasta la parte superior de la página.

  12. En el mensaje Esta función pertenece a una aplicación. Haga clic aquí para administrarla, seleccione el enlace Haga clic aquí.

  13. En la página serverlessrepo-your_application_name, anote el nombre de su aplicación sin serverlessrepo. Por ejemplo, si el nombre de la aplicación es serverlessrepo-DynamoDbTestApp, el nombre de su aplicación es DynamoDbTestApp.

  14. Permanezca en la página de la consola de Lambda de su aplicación y, a continuación, siga con los pasos de Búsqueda de la versión del conector que está utilizando.

Búsqueda de la versión del conector que está utilizando

Siga estos pasos para encontrar la versión del conector que está utilizando.

Para buscar la versión del conector que está utilizando
  1. En la página de la consola de Lambda correspondiente a la aplicación de Lambda, seleccione la pestaña Implementaciones.

  2. En la pestaña Implementaciones, expanda la Plantilla de SAM.

  3. Busque CodeUri.

  4. En el campo Clave de CodeUri, busque la siguiente cadena:

    applications-connector_name-versions-year.week_of_year.iteration_of_week/hash_number

    En el siguiente ejemplo, se muestra una cadena para el conector de CloudWatch:

    applications-AthenaCloudwatchConnector-versions-2021.42.1/15151159...
  5. Registre el valor year.week_of_year.iteration_of_week (por ejemplo, 2021.42.1). Esta es la versión de su conector.

Implementación de la nueva versión del conector

Siga estos pasos para implementar una nueva versión del conector.

Para implementar una nueva versión del conector
  1. Abra la consola de Athena en https://console.aws.amazon.com/athena/.

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

    Elija el menú de expansión.
  3. En el panel de navegación, elija Data source (Orígenes de datos).

  4. En la página Data sources (Orígenes de datos), elija Create data source (Crearo origen de datos).

  5. Seleccione el origen de datos que desee actualizar y, a continuación, seleccione Siguiente.

  6. En la sección Detalles de la conexión, elija Crear función de Lambda. Con esto, se abre la consola de Lambda, donde podrá implementar la aplicación actualizada.

    Página del conector en la consola de AWS Lambda.
  7. Como en realidad no va a crear un nuevo origen de datos, puede cerrar la pestaña de la consola de Athena.

  8. En la página de la consola de Lambda correspondiente al conector, proceda con los siguientes pasos:

    1. Asegúrese de haber eliminado el prefijo serverlessrepo- del nombre de la aplicación y, a continuación, copie el nombre de la aplicación en el campo Nombre de la aplicación.

    2. Copie el nombre de la función de Lambda en el campo AthenaCatalogName. Algunos conectores llaman a este campo LambdaFunctionName.

    3. Copie las variables de entorno que ha registrado en los campos correspondientes.

  9. Seleccione la opción Confirmo que esta aplicación puede crear políticas de recursos y roles de IAM personalizados y, a continuación, elija Implementar.

  10. Para comprobar que la aplicación se ha actualizado, seleccione la pestaña Implementaciones.

    En la sección Historial de implementaciones, se muestra que la actualización se ha completado.

    Se ha completado la actualización del conector.
  11. Para confirmar el nuevo número de versión, puede expandir la Plantilla de SAM como antes, buscar CodeUri y comprobar el número de versión del conector en el campo Clave.

Ahora puede usar el conector actualizado para crear consultas federadas de Athena.