• /
  • EnglishEspañolFrançais日本語한국어Português
  • 로그인지금 시작하기

사용자의 편의를 위해 제공되는 기계 번역입니다.

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하시기 바랍니다.

문제 신고

AWS Athena 작업

|View as Markdown (English)

이 페이지는 워크플로우 자동화 액션 카탈로그에서 사용할 수 있는 AWS Athena 액션에 대한 참조를 제공합니다. 이러한 액션을 사용하여 Amazon Athena를 대상으로 SQL 쿼리를 실행하고, 실행 상태를 확인하며, 워크플로우 정의에서 직접 결과를 가져오십시오.

전제 조건

사전 요구 사항 및 자격 증명 설정에 대해서는 AWS 자격 증명 설정을 참조하십시오.

쿼리 실행을 시작합니다.

작업 식별자는 aws.athena.startQueryExecution입니다.

Amazon Athena를 대상으로 SQL 쿼리를 실행하고 쿼리 실행 ID를 반환합니다. 이 작업은 쿼리가 완료될 때까지 기다리지 않습니다 — 상태를 폴링하려면 aws.athena.getQueryExecution을(를) 사용하고, 결과를 가져오려면 aws.athena.getQueryResults을(를) 사용하십시오.

다음 표에서는 이 작업의 입력 필드를 설명합니다.

입력

유형

설명

예시

region

문자열

필수 항목입니다. Athena 작업 그룹의 AWS 리전입니다.

us-east-2

queryString

문자열

필수 항목입니다. 실행할 SQL 문입니다. 길이: 1~262,144자.

"SELECT * FROM my_table LIMIT 10"

awsRoleArn

문자열

선택 사항. AWS API 호출을 위해 수임할 IAM 역할 ARN입니다.

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

awsAccessKeyId

문자열

선택 사항. AWS 액세스 키 ID입니다. 시크릿으로 전달하십시오.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

문자열

선택 사항. AWS 비밀 액세스 키입니다. 시크릿으로 전달하십시오.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

문자열

선택 사항. STS 인증을 위한 임시 세션 토큰. 시크릿으로 전달하십시오.

${{ :secrets:awsSessionToken }}

database

문자열

선택 항목입니다. 쿼리를 실행할 Athena 데이터베이스입니다. 길이: 1~255자입니다.

"my-database"

catalog

문자열

선택 항목입니다. 데이터 카탈로그 이름입니다. 길이: 1~256자.

"AwsDataCatalog"

outputLocation

문자열

선택 항목입니다. 쿼리 결과에 대한 S3 URI입니다. 작업 그룹에 기본 출력 위치가 없는 경우 필수입니다.

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

encryptionOption

문자열

선택 항목입니다. 결과 파일 암호화입니다. 허용되는 값: SSE_S3, SSE_KMS, CSE_KMS.

"SSE_S3"

kmsKey

문자열

선택 항목입니다. KMS 키 ARN 또는 ID입니다. encryptionOption이(가) SSE_KMS 또는 CSE_KMS인 경우 필수입니다.

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

expectedBucketOwner

문자열

선택 항목입니다. 출력 S3 버킷을 소유해야 하는 12자리 AWS 계정 ID입니다.

"111122223333"

aclS3Option

문자열

선택 항목입니다. 결과 객체에 적용되는 사전 정의된 ACL입니다. 허용되는 값: BUCKET_OWNER_FULL_CONTROL.

"BUCKET_OWNER_FULL_CONTROL"

workGroup

문자열

선택 항목입니다. 쿼리를 실행할 Athena 작업 그룹입니다. 생략한 경우 기본값은 primary 입니다. 길이: 1~128자.

"primary"

clientRequestToken

문자열

선택 항목입니다. 재시도를 위한 멱등성 토큰입니다. 길이: 32~128자.

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

executionParameters

목록

선택 항목입니다. 위치 순서대로 적용되는 파라미터화된 쿼리의 파라미터 값입니다. 각 값: 1~1,024자입니다.

["value1", "value2"]

resultReuseEnabled

부울

선택 항목입니다. true인 경우, 이전 쿼리 결과가 resultReuseMaxAgeInMinutes 이내이면 이를 재사용합니다.

true

resultReuseMaxAgeInMinutes

정수

선택 항목입니다. 재사용할 수 있는 결과의 최대 경과 시간(분)입니다. 범위: 0~10,080.

60

selectors

목록

선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.

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

다음 표는 이 작업의 출력 필드를 설명합니다.

예시

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

쿼리 실행 가져오기

작업 식별자는 aws.athena.getQueryExecution입니다.

실행 ID를 기준으로 단일 Athena 쿼리 실행의 세부 정보 및 현재 상태를 반환합니다. aws.athena.startQueryExecution에 의해 시작된 쿼리가 종료 상태(SUCCEEDED, FAILED 또는 CANCELLED)에 도달할 때까지 해당 쿼리를 폴링하는 데 사용하십시오.

다음 표에서는 이 작업의 입력 필드를 설명합니다.

입력

유형

설명

예시

region

문자열

필수 항목입니다. Athena 작업 그룹의 AWS 리전입니다.

us-east-2

queryExecutionId

문자열

필수 항목입니다. aws.athena.startQueryExecution이(가) 반환한 쿼리 실행의 UUID입니다. 길이: 1~128자.

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

awsRoleArn

문자열

선택 사항. AWS API 호출을 위해 수임할 IAM 역할 ARN입니다.

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

awsAccessKeyId

문자열

선택 사항. AWS 액세스 키 ID입니다. 시크릿으로 전달하십시오.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

문자열

선택 사항. AWS 비밀 액세스 키입니다. 시크릿으로 전달하십시오.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

문자열

선택 사항. STS 인증을 위한 임시 세션 토큰. 시크릿으로 전달하십시오.

${{ :secrets:awsSessionToken }}

selectors

목록

선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.

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

다음 표는 이 작업의 출력 필드를 설명합니다.

산출

유형

예시

response

물체

Status (State, StateChangeReason, 타임스탬프, AthenaError)가 포함된 QueryExecution, Statistics, ResultConfiguration, QueryExecutionContext, WorkGroup 및 EngineVersion를 포함합니다. GetQueryExecution API 참조를 확인하십시오.

success

부울

true 또는 false

errorMessage

문자열

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

예시

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

쿼리 결과 가져오기

작업 식별자는 aws.athena.getQueryResults입니다.

완료된 Athena 쿼리 실행의 행 및 열 메타데이터를 반환합니다. 결과는 페이지 단위로 제공됩니다 ― 응답에 NextToken이(가) 포함된 경우, 다음 페이지를 가져오려면 다음 호출에서 이를 nextToken (으)로 전달하십시오. ResultSet.Rows의 첫 번째 행은 항상 헤더 행(열 이름)입니다.

다음 표에서는 이 작업의 입력 필드를 설명합니다.

입력

유형

설명

예시

region

문자열

필수 항목입니다. Athena 작업 그룹의 AWS 리전입니다.

us-east-2

queryExecutionId

문자열

필수 항목입니다. 완료된 쿼리 실행의 UUID입니다. 길이: 1~128자.

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

awsRoleArn

문자열

선택 사항. AWS API 호출을 위해 수임할 IAM 역할 ARN입니다.

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

awsAccessKeyId

문자열

선택 사항. AWS 액세스 키 ID입니다. 시크릿으로 전달하십시오.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

문자열

선택 사항. AWS 비밀 액세스 키입니다. 시크릿으로 전달하십시오.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

문자열

선택 사항. STS 인증을 위한 임시 세션 토큰. 시크릿으로 전달하십시오.

${{ :secrets:awsSessionToken }}

nextToken

문자열

선택 항목입니다. 이전의 잘린 응답에서 가져온 페이징 토큰입니다. 첫 번째 페이지부터 시작하려면 생략하십시오. 길이: 1~1,024자.

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

maxResults

정수

선택 항목입니다. 페이지당 반환할 최대 행 수입니다. 범위: 1~1,000.

100

queryResultType

문자열

선택 항목입니다. 반환할 결과 유형입니다. 허용되는 값: DATA_ROWS (기본값), DATA_MANIFEST.

"DATA_ROWS"

selectors

목록

선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.

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

다음 표는 이 작업의 출력 필드를 설명합니다.

산출

유형

예시

response

물체

더 많은 페이지가 있는 경우 UpdateCount, ResultSet (Rows 및 ResultSetMetadata.ColumnInfo 포함) 및 NextToken을(를) 포함합니다. Rows의 첫 번째 행은 항상 헤더 행입니다. GetQueryResults API 참조를 확인해 주십시오.

success

부울

true 또는 false

errorMessage

문자열

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

예시

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.