Esta página proporciona una referencia de las acciones de AWS Athena disponibles en el catálogo de acciones de automatización del flujo de trabajo. Utilice estas acciones para ejecutar consultas SQL en Amazon Athena, comprobar su estado de ejecución y recuperar los resultados directamente desde una definición de flujo de trabajo.
Requisitos previos
Para los requisitos previos y la configuración de credenciales, consulte Configurar las credenciales de AWS.
Iniciar una ejecución de consulta
El identificador de la acción es aws.athena.startQueryExecution.
Ejecuta una consulta SQL en Amazon Athena y devuelve el ID de ejecución de la consulta. Esta acción no espera a que se complete la consulta —utilice aws.athena.getQueryExecution para comprobar el estado y aws.athena.getQueryResults para recuperar los resultados.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Requerido. Región de AWS del grupo de trabajo de Athena. |
|
| Cadena | Requerido. La sentencia SQL que se ejecutará. Longitud: 1-262 144 caracteres. |
|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Opcional. Base de datos de Athena en la que se ejecutará la consulta. Longitud: 1-255 caracteres. |
|
| Cadena | Opcional. Nombre del catálogo de datos. Longitud: 1-256 caracteres. |
|
| Cadena | Opcional. URI de S3 para los resultados de la consulta. Obligatorio si el grupo de trabajo no tiene una ubicación de salida predeterminada. |
|
| Cadena | Opcional. Cifrado para los archivos de resultados. Valores permitidos: |
|
| Cadena | Opcional. ARN o ID de la clave de KMS. Requerido cuando |
|
| Cadena | Opcional. ID de cuenta de AWS de 12 dígitos que debe ser el propietario del bucket de S3 de salida. |
|
| Cadena | Opcional. ACL predefinida aplicada a los objetos de resultado. Valor permitido: |
|
| Cadena | Opcional. Grupo de trabajo de Athena en el que se ejecutará la consulta. El valor predeterminado es |
|
| Cadena | Opcional. Token de idempotencia para los reintentos. Longitud: 32-128 caracteres. |
|
| Lista | Opcional. Valores de los parámetros para una consulta parametrizada, aplicados en orden posicional. Cada valor: 1-1024 caracteres. |
|
| Booleano | Opcional. Si |
|
| Entero | Opcional. Antigüedad máxima en minutos de los resultados que se pueden reutilizar. Rango: 0-10 080. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto |
|
| Booleano |
|
| Cadena |
|
Ejemplo
name: start-athena-querydescription: Run a SQL query against Athenasteps: - name: startQuery type: action action: aws.athena.startQueryExecution version: '1' inputs: awsRoleArn: ${{ :secrets:awsRoleArn }} region: us-east-2 queryString: "SELECT * FROM my_table LIMIT 10" database: "my-database" catalog: "AwsDataCatalog" outputLocation: "s3://my-athena-results-bucket/path/" workGroup: "primary" selectors: - name: queryExecutionId expression: ".response.QueryExecutionId" next: endObtener una ejecución de consulta
El identificador de la acción es aws.athena.getQueryExecution.
Devuelve los detalles y el estado actual de la ejecución de una sola consulta de Athena mediante su ID de ejecución. Úselo para sondear una consulta iniciada por aws.athena.startQueryExecution hasta que alcance un estado terminal (SUCCEEDED, FAILED o CANCELLED).
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Requerido. Región de AWS del grupo de trabajo de Athena. |
|
| Cadena | Requerido. UUID de la ejecución de consulta devuelto por |
|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Contiene |
| Booleano |
|
| Cadena |
|
Ejemplo
name: get-athena-query-executiondescription: Check the status of an Athena query executionsteps: - name: getExecution type: action action: aws.athena.getQueryExecution version: '1' inputs: awsRoleArn: ${{ :secrets:awsRoleArn }} region: us-east-2 queryExecutionId: "ef4a125f-9e79-466d-bae5-d6d36536fbee" selectors: - name: state expression: ".response.QueryExecution.Status.State" - name: stateChangeReason expression: ".response.QueryExecution.Status.StateChangeReason" next: endObtener resultados de la consulta
El identificador de la acción es aws.athena.getQueryResults.
Devuelve las filas y los metadatos de columna de una ejecución de consulta de Athena completada. Los resultados están paginados —cuando la respuesta incluya un NextToken, páselo como nextToken en la siguiente llamada para recuperar la página siguiente. La primera fila de ResultSet.Rows siempre es la fila de encabezado (nombres de columna).
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Requerido. Región de AWS del grupo de trabajo de Athena. |
|
| Cadena | Requerido. UUID de la ejecución de la consulta completada. Longitud: 1-128 caracteres. |
|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de paginación de una respuesta truncada anterior. Omitir para comenzar desde la primera página. Longitud: 1–1024 caracteres. |
|
| Entero | Opcional. Número máximo de filas para devolver por página. Rango: 1-1000. |
|
| Cadena | Opcional. Tipo de resultado a devolver. Valores permitidos: |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Objeto | Contiene |
| Booleano |
|
| Cadena |
|
Ejemplo
name: get-athena-query-resultsdescription: Fetch results of a completed Athena querysteps: - name: getResults type: action action: aws.athena.getQueryResults version: '1' inputs: awsRoleArn: ${{ :secrets:awsRoleArn }} region: us-east-2 queryExecutionId: "8d0105c1-30b5-4b8f-a23e-a1b60047c43f" maxResults: 100 selectors: - name: rows expression: ".response.ResultSet.Rows" - name: columnInfo expression: ".response.ResultSet.ResultSetMetadata.ColumnInfo" - name: nextToken expression: ".response.NextToken" next: end