• /
  • EnglishEspañolFrançais日本語한국어Português
  • EntrarComeçar agora

Esta tradução de máquina é fornecida para sua comodidade.

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

Ações do AWS Athena

|View as Markdown (English)

Esta página fornece uma referência para as ações do AWS Athena disponíveis no catálogo de ações de automação de fluxo de trabalho. Use estas ações para executar consultas SQL no Amazon Athena, verificar seu status de execução e recuperar resultados diretamente de uma definição de fluxo de trabalho.

Pré-requisitos

Para pré-requisitos e configuração de credenciais, consulte Configurar credenciais da AWS.

Iniciar a execução de uma consulta

O identificador da ação é aws.athena.startQueryExecution.

Executa uma consulta SQL no Amazon Athena e retorna o ID de execução da consulta. Esta ação não aguarda a conclusão da consulta — use aws.athena.getQueryExecution para verificar o status e aws.athena.getQueryResults para recuperar os resultados.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada

Tipo

Descrição

Exemplo

region

Corda

Obrigatório. Região da AWS do grupo de trabalho do Athena.

us-east-2

queryString

Corda

Obrigatório. A instrução SQL a ser executada. Comprimento: 1–262.144 caracteres.

"SELECT * FROM my_table LIMIT 10"

awsRoleArn

Corda

Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.

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

awsAccessKeyId

Corda

Opcional. ID da chave de acesso da AWS. Passe como um segredo.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Corda

Opcional. Chave de acesso secreta da AWS. Passe como um segredo.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Corda

Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.

${{ :secrets:awsSessionToken }}

database

Corda

Opcional. Banco de dados Athena no qual a consulta será executada. Comprimento: 1–255 caracteres.

"my-database"

catalog

Corda

Opcional. Nome do catálogo de dados. Comprimento: 1–256 caracteres.

"AwsDataCatalog"

outputLocation

Corda

Opcional. URI do S3 para os resultados da consulta. Obrigatório se o grupo de trabalho não tiver um local de saída padrão.

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

encryptionOption

Corda

Opcional. Criptografia para os arquivos de resultados. Valores permitidos: SSE_S3, SSE_KMS, CSE_KMS.

"SSE_S3"

kmsKey

Corda

Opcional. ARN ou ID da chave do KMS. Obrigatório quando encryptionOption for SSE_KMS ou CSE_KMS.

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

expectedBucketOwner

Corda

Opcional. ID da conta da AWS de 12 dígitos que deve ser a proprietária do bucket do S3 de saída.

"111122223333"

aclS3Option

Corda

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

"BUCKET_OWNER_FULL_CONTROL"

workGroup

Corda

Opcional. Grupo de trabalho do Athena para executar a consulta. O padrão é primary se omitido. Comprimento: 1–128 caracteres.

"primary"

clientRequestToken

Corda

Opcional. Token de idempotência para novas tentativas. Comprimento: 32–128 caracteres.

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

executionParameters

Lista

Opcional. Valores de parâmetro para uma consulta parametrizada, aplicados em ordem posicional. Cada valor: 1–1.024 caracteres.

["value1", "value2"]

resultReuseEnabled

Boleano

Opcional. Se true, reutiliza os resultados de uma consulta anterior se estiverem dentro de resultReuseMaxAgeInMinutes.

true

resultReuseMaxAgeInMinutes

Inteiro

Opcional. Idade máxima em minutos dos resultados que podem ser reutilizados. Intervalo: 0–10.080.

60

selectors

Lista

Opcional. Seletores JQ para extrair campos específicos da saída da ação.

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

A tabela a seguir descreve os campos de saída para esta ação.

Exemplo

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

Obter a execução de uma consulta

O identificador da ação é aws.athena.getQueryExecution.

Retorna os detalhes e o status atual da execução de uma única consulta do Athena pelo seu ID de execução. Isso pode ser usado para sondar uma consulta iniciada por aws.athena.startQueryExecution até que ela atinja um estado terminal (SUCCEEDED, FAILED ou CANCELLED).

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada

Tipo

Descrição

Exemplo

region

Corda

Obrigatório. Região da AWS do grupo de trabalho do Athena.

us-east-2

queryExecutionId

Corda

Obrigatório. UUID da execução da consulta retornado por aws.athena.startQueryExecution. Comprimento: 1–128 caracteres.

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

awsRoleArn

Corda

Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.

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

awsAccessKeyId

Corda

Opcional. ID da chave de acesso da AWS. Passe como um segredo.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Corda

Opcional. Chave de acesso secreta da AWS. Passe como um segredo.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Corda

Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.

${{ :secrets:awsSessionToken }}

selectors

Lista

Opcional. Seletores JQ para extrair campos específicos da saída da ação.

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

A tabela a seguir descreve os campos de saída para esta ação.

Saída

Tipo

Exemplo

response

Objeto

Contém QueryExecution com Status (State, StateChangeReason, timestamp, AthenaError), Statistics, ResultConfiguration, QueryExecutionContext, WorkGroup e EngineVersion. Consulte a referência da API GetQueryExecution.

success

Boleano

true ou false

errorMessage

Corda

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

Exemplo

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

Obter resultados da consulta

O identificador da ação é aws.athena.getQueryResults.

Retorna as linhas e os metadados de coluna de uma execução de consulta concluída do Athena. Os resultados são paginados — quando a resposta incluir um NextToken, passe-o como nextToken na próxima chamada para recuperar a página seguinte. A primeira linha de ResultSet.Rows é sempre a linha de cabeçalho (nomes das colunas).

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada

Tipo

Descrição

Exemplo

region

Corda

Obrigatório. Região da AWS do grupo de trabalho do Athena.

us-east-2

queryExecutionId

Corda

Obrigatório. UUID da execução da consulta concluída. Comprimento: 1–128 caracteres.

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

awsRoleArn

Corda

Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.

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

awsAccessKeyId

Corda

Opcional. ID da chave de acesso da AWS. Passe como um segredo.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Corda

Opcional. Chave de acesso secreta da AWS. Passe como um segredo.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Corda

Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.

${{ :secrets:awsSessionToken }}

nextToken

Corda

Opcional. Token de paginação de uma resposta truncada anterior. Omita para iniciar a partir da primeira página. Comprimento: 1–1.024 caracteres.

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

maxResults

Inteiro

Opcional. Número máximo de linhas a serem retornadas por página. Intervalo: 1–1.000.

100

queryResultType

Corda

Opcional. Tipo de resultado a retornar. Valores permitidos: DATA_ROWS (padrão), DATA_MANIFEST.

"DATA_ROWS"

selectors

Lista

Opcional. Seletores JQ para extrair campos específicos da saída da ação.

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

A tabela a seguir descreve os campos de saída para esta ação.

Saída

Tipo

Exemplo

response

Objeto

Contém UpdateCount, ResultSet (com Rows e ResultSetMetadata.ColumnInfo) e NextToken quando existem mais páginas. A primeira linha de Rows é sempre a linha de cabeçalho. Consulte a referência da API GetQueryResults.

success

Boleano

true ou false

errorMessage

Corda

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

Exemplo

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.