• /
  • EnglishEspañolFrançais日本語한국어Português
  • Inicia sesiónComenzar ahora

Te ofrecemos esta traducción automática para facilitar la lectura.

En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.

Crea una propuesta

Acciones de AWS Athena

|View as Markdown (English)

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

region

Cadena

Requerido. Región de AWS del grupo de trabajo de Athena.

us-east-2

queryString

Cadena

Requerido. La sentencia SQL que se ejecutará. Longitud: 1-262 144 caracteres.

"SELECT * FROM my_table LIMIT 10"

awsRoleArn

Cadena

Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Cadena

Opcional. ID de clave de acceso de AWS. Páselo como un secreto.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Cadena

Opcional. Clave de acceso secreta de AWS. Páselo como un secreto.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Cadena

Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto.

${{ :secrets:awsSessionToken }}

database

Cadena

Opcional. Base de datos de Athena en la que se ejecutará la consulta. Longitud: 1-255 caracteres.

"my-database"

catalog

Cadena

Opcional. Nombre del catálogo de datos. Longitud: 1-256 caracteres.

"AwsDataCatalog"

outputLocation

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.

"s3://my-athena-results-bucket/path/"

encryptionOption

Cadena

Opcional. Cifrado para los archivos de resultados. Valores permitidos: SSE_S3, SSE_KMS, CSE_KMS.

"SSE_S3"

kmsKey

Cadena

Opcional. ARN o ID de la clave de KMS. Requerido cuando encryptionOption es SSE_KMS o CSE_KMS.

"arn:aws:kms:us-east-2:123456789012:key/abc123"

expectedBucketOwner

Cadena

Opcional. ID de cuenta de AWS de 12 dígitos que debe ser el propietario del bucket de S3 de salida.

"111122223333"

aclS3Option

Cadena

Opcional. ACL predefinida aplicada a los objetos de resultado. Valor permitido: BUCKET_OWNER_FULL_CONTROL.

"BUCKET_OWNER_FULL_CONTROL"

workGroup

Cadena

Opcional. Grupo de trabajo de Athena en el que se ejecutará la consulta. El valor predeterminado es primary si se omite. Longitud: 1-128 caracteres.

"primary"

clientRequestToken

Cadena

Opcional. Token de idempotencia para los reintentos. Longitud: 32-128 caracteres.

"3f2504e0-4f89-41d3-9a0c-0305e82c3301"

executionParameters

Lista

Opcional. Valores de los parámetros para una consulta parametrizada, aplicados en orden posicional. Cada valor: 1-1024 caracteres.

["value1", "value2"]

resultReuseEnabled

Booleano

Opcional. Si true, reutiliza los resultados de una consulta anterior si están dentro de resultReuseMaxAgeInMinutes.

true

resultReuseMaxAgeInMinutes

Entero

Opcional. Antigüedad máxima en minutos de los resultados que se pueden reutilizar. Rango: 0-10 080.

60

selectors

Lista

Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "queryExecutionId", "expression": ".response.QueryExecutionId"}]

La siguiente tabla describe los campos de salida para esta acción.

Ejemplo

name: start-athena-query
description: Run a SQL query against Athena
steps:
- 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: end

Obtener 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

region

Cadena

Requerido. Región de AWS del grupo de trabajo de Athena.

us-east-2

queryExecutionId

Cadena

Requerido. UUID de la ejecución de consulta devuelto por aws.athena.startQueryExecution. Longitud: 1-128 caracteres.

"ef4a125f-9e79-466d-bae5-d6d36536fbee"

awsRoleArn

Cadena

Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Cadena

Opcional. ID de clave de acceso de AWS. Páselo como un secreto.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Cadena

Opcional. Clave de acceso secreta de AWS. Páselo como un secreto.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Cadena

Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto.

${{ :secrets:awsSessionToken }}

selectors

Lista

Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "state", "expression": ".response.QueryExecution.Status.State"}]

La siguiente tabla describe los campos de salida para esta acción.

Producción

Tipo

Ejemplo

response

Objeto

Contiene QueryExecution con Status (State, StateChangeReason, timestamp, AthenaError), Statistics, ResultConfiguration, QueryExecutionContext, WorkGroup y EngineVersion. Consulte la referencia de la API GetQueryExecution.

success

Booleano

true o false

errorMessage

Cadena

"An error occurred (InvalidRequestException) when calling the GetQueryExecution operation: ..."

Ejemplo

name: get-athena-query-execution
description: Check the status of an Athena query execution
steps:
- 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: end

Obtener 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

region

Cadena

Requerido. Región de AWS del grupo de trabajo de Athena.

us-east-2

queryExecutionId

Cadena

Requerido. UUID de la ejecución de la consulta completada. Longitud: 1-128 caracteres.

"8d0105c1-30b5-4b8f-a23e-a1b60047c43f"

awsRoleArn

Cadena

Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Cadena

Opcional. ID de clave de acceso de AWS. Páselo como un secreto.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Cadena

Opcional. Clave de acceso secreta de AWS. Páselo como un secreto.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Cadena

Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto.

${{ :secrets:awsSessionToken }}

nextToken

Cadena

Opcional. Token de paginación de una respuesta truncada anterior. Omitir para comenzar desde la primera página. Longitud: 1–1024 caracteres.

"${{ .steps.getResults.outputs.nextToken }}"

maxResults

Entero

Opcional. Número máximo de filas para devolver por página. Rango: 1-1000.

100

queryResultType

Cadena

Opcional. Tipo de resultado a devolver. Valores permitidos: DATA_ROWS (predeterminado), DATA_MANIFEST.

"DATA_ROWS"

selectors

Lista

Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "rows", "expression": ".response.ResultSet.Rows"}, {"name": "nextToken", "expression": ".response.NextToken"}]

La siguiente tabla describe los campos de salida para esta acción.

Producción

Tipo

Ejemplo

response

Objeto

Contiene UpdateCount, ResultSet (con Rows y ResultSetMetadata.ColumnInfo) y NextToken cuando existen más páginas. La primera fila de Rows siempre es la fila de encabezado. Consulte la referencia de la API GetQueryResults.

success

Booleano

true o false

errorMessage

Cadena

"An error occurred (InvalidRequestException) when calling the GetQueryResults operation: ..."

Ejemplo

name: get-athena-query-results
description: Fetch results of a completed Athena query
steps:
- 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
Copyright © 2026 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.