• /
  • EnglishEspañolFrançais日本語한국어Português
  • Se connecterDémarrer

Cette traduction automatique est fournie pour votre commodité.

En cas d'incohérence entre la version anglaise et la version traduite, la version anglaise prévaudra. Veuillez visiter cette page pour plus d'informations.

Créer un problème

Actions AWS Athena

|View as Markdown (English)

Cette page fournit une référence pour les actions AWS Athena disponibles dans le catalogue des actions d'automatisation des workflows. Utilisez ces actions pour exécuter des requêtes SQL sur Amazon Athena, vérifier leur statut d'exécution, et récupérer les résultats directement depuis une définition de workflow.

Prérequis

Pour les prérequis et la configuration des identifiants, consultez Configurer les identifiants AWS.

Démarrer l’exécution d’une requête

L’identifiant de l’action est aws.athena.startQueryExecution.

Exécute une requête SQL sur Amazon Athena et renvoie l'ID d'exécution de la requête. Cette action n'attend pas que la requête soit terminée : utilisez aws.athena.getQueryExecution pour vérifier le statut et aws.athena.getQueryResults pour récupérer les résultats.

Le tableau suivant décrit les champs d’entrée pour cette action.

Saisir

Type

Description

Exemple

region

Chaîne

Obligatoire. Région AWS du groupe de travail Athena.

us-east-2

queryString

Chaîne

Obligatoire. L’instruction SQL à exécuter. Longueur : 1 à 262 144 caractères.

"SELECT * FROM my_table LIMIT 10"

awsRoleArn

Chaîne

Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS.

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

awsAccessKeyId

Chaîne

Facultatif. ID de clé d’accès AWS. Passer en tant que secret.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Chaîne

Facultatif. Clé d’accès secrète AWS. Passer en tant que secret.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Chaîne

Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret.

${{ :secrets:awsSessionToken }}

database

Chaîne

Facultatif. Base de données Athena sur laquelle exécuter la requête. Longueur : 1 à 255 caractères.

"my-database"

catalog

Chaîne

Facultatif. Nom du catalogue de données. Longueur : 1 à 256 caractères.

"AwsDataCatalog"

outputLocation

Chaîne

Facultatif. URI S3 pour les résultats de la requête. Requis si le groupe de travail n’a pas d’emplacement de sortie par défaut.

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

encryptionOption

Chaîne

Facultatif. Chiffrement des fichiers de résultats. Valeurs autorisées : SSE_S3, SSE_KMS, CSE_KMS.

"SSE_S3"

kmsKey

Chaîne

Facultatif. ARN ou ID de la clé KMS. Requis lorsque encryptionOption est SSE_KMS ou CSE_KMS.

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

expectedBucketOwner

Chaîne

Facultatif. ID de compte AWS à 12 chiffres qui doit posséder le bucket S3 de sortie.

"111122223333"

aclS3Option

Chaîne

Facultatif. ACL prédéfinie appliquée aux objets de résultat. Valeur autorisée : BUCKET_OWNER_FULL_CONTROL.

"BUCKET_OWNER_FULL_CONTROL"

workGroup

Chaîne

Facultatif. Groupe de travail Athena dans lequel exécuter la requête. La valeur par défaut est primary en cas d’omission. Longueur : 1 à 128 caractères.

"primary"

clientRequestToken

Chaîne

Facultatif. Jeton d'idempotence pour les nouvelles tentatives. Longueur : 32 à 128 caractères.

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

executionParameters

List

Facultatif. Valeurs de paramètre pour une requête paramétrée, appliquées par ordre de position. Chaque valeur : de 1 à 1024 caractères.

["value1", "value2"]

resultReuseEnabled

Booléen

Facultatif. Si true, réutilise les résultats d’une requête précédente s’ils sont dans resultReuseMaxAgeInMinutes.

true

resultReuseMaxAgeInMinutes

Entier

Facultatif. Âge maximal en minutes des résultats pouvant être réutilisés. Plage : 0 à 10 080.

60

selectors

List

Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.

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

Le tableau suivant décrit les champs de sortie pour cette action.

Exemple

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

Obtenir une exécution de requête

L’identifiant de l’action est aws.athena.getQueryExecution.

Renvoie les détails et le statut actuel d'une seule exécution de requête Athena par son ID d'exécution. Utilisez ceci pour interroger une requête démarrée par aws.athena.startQueryExecution jusqu'à ce qu'elle atteigne un état terminal (SUCCEEDED, FAILED, ou CANCELLED).

Le tableau suivant décrit les champs d’entrée pour cette action.

Saisir

Type

Description

Exemple

region

Chaîne

Obligatoire. Région AWS du groupe de travail Athena.

us-east-2

queryExecutionId

Chaîne

Obligatoire. UUID de l'exécution de la requête renvoyé par aws.athena.startQueryExecution. Longueur : 1 à 128 caractères.

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

awsRoleArn

Chaîne

Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS.

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

awsAccessKeyId

Chaîne

Facultatif. ID de clé d’accès AWS. Passer en tant que secret.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Chaîne

Facultatif. Clé d’accès secrète AWS. Passer en tant que secret.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Chaîne

Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret.

${{ :secrets:awsSessionToken }}

selectors

List

Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.

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

Le tableau suivant décrit les champs de sortie pour cette action.

Sortir

Type

Exemple

response

Objet

Contient QueryExecution avec Status (State, StateChangeReason, horodatage, AthenaError), Statistics, ResultConfiguration, QueryExecutionContext, WorkGroup, et EngineVersion. Consultez la référence de l’API GetQueryExecution.

success

Booléen

true ou false

errorMessage

Chaîne

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

Exemple

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

Obtenir les résultats de la requête

L’identifiant de l’action est aws.athena.getQueryResults.

Renvoie les lignes et les métadonnées de colonne de l’exécution d’une requête Athena terminée. Les résultats sont paginés ; lorsque la réponse inclut un NextToken, transmettez-le en tant que nextToken lors de l’appel suivant pour récupérer la page suivante. La première ligne de ResultSet.Rows est toujours la ligne d’en-tête (noms des colonnes).

Le tableau suivant décrit les champs d’entrée pour cette action.

Saisir

Type

Description

Exemple

region

Chaîne

Obligatoire. Région AWS du groupe de travail Athena.

us-east-2

queryExecutionId

Chaîne

Obligatoire. UUID de l'exécution de requête terminée. Longueur : 1 à 128 caractères.

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

awsRoleArn

Chaîne

Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS.

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

awsAccessKeyId

Chaîne

Facultatif. ID de clé d’accès AWS. Passer en tant que secret.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Chaîne

Facultatif. Clé d’accès secrète AWS. Passer en tant que secret.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Chaîne

Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret.

${{ :secrets:awsSessionToken }}

nextToken

Chaîne

Facultatif. Jeton de pagination provenant d'une réponse tronquée précédente. Omettez-le pour commencer à la 1re page. Longueur : 1 à 1024 caractères.

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

maxResults

Entier

Facultatif. Nombre maximal de lignes à renvoyer par page. Plage : 1 à 1000.

100

queryResultType

Chaîne

Facultatif. Type de résultat à renvoyer. Valeurs autorisées : DATA_ROWS (par défaut), DATA_MANIFEST.

"DATA_ROWS"

selectors

List

Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.

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

Le tableau suivant décrit les champs de sortie pour cette action.

Sortir

Type

Exemple

response

Objet

Contient UpdateCount, ResultSet (avec Rows et ResultSetMetadata.ColumnInfo), et NextToken lorsque d’autres pages existent. La première ligne de Rows est toujours la ligne d’en-tête. Consultez la référence de l’API GetQueryResults.

success

Booléen

true ou false

errorMessage

Chaîne

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

Exemple

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
Droits d'auteur © 2026 New Relic Inc.

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