AWS Athena에 앱 연결하기

Amazon S3의 데이터를 대상으로 SQL 쿼리를 실행하는 서버리스 쿼리 서비스 AWS Athena에 앱을 연결해 데이터 레이크 기반 대시보드를 구동하세요.

Amazon Athena는 Amazon S3에 저장된 데이터에 SQL을 직접 실행하는 서버리스 쿼리 서비스입니다. AWS Athena connector를 사용하면 Lovable 앱이 쿼리를 제출하고 결과를 읽을 수 있어, 데이터베이스 서버를 관리하지 않고도 데이터 레이크 위에 대시보드, 보고서, 내부 도구를 구축할 수 있습니다.

AWS Athena를 연결하면 앱은 다음 작업이 가능합니다.

• S3에 저장된 데이터에 SQL 쿼리 실행
• 데이터 카탈로그, 데이터베이스, 테이블 스키마 탐색
• 페이지 단위로 쿼리 결과 가져오기
• 데이터 레이크 쿼리로 대시보드·보고서 구동
• 기존 Athena workgroup과 결과 위치 재사용

Athena 쿼리는 비동기로 처리됩니다. 앱이 쿼리를 시작하면 Athena가 처리하고, 완료 후(보통 수 초 이내) 앱이 결과를 가져옵니다. Lovable이 이 흐름을 자동으로 생성합니다.

주요 활용 사례 및 예시 앱

AWS Athena 연결 방식

각 AWS Athena 연결은 단일 AWS 리전에 묶이며 선택적으로 workgroup과 쿼리 결과 위치를 지정합니다. AWS Athena를 연결하면 IAM 자격증명을 제공하고, Lovable의 connector gateway가 모든 요청에 서명합니다. 자격증명은 서버에 보관되며 게시된 앱에 노출되지 않습니다.

Lovable workspace 내에서는 다음이 가능합니다.

• AWS Athena 연결을 여러 개 생성 가능
• 각 연결은 특정 리전을 대상으로 하며 선택적으로 workgroup과 결과 위치를 지정
• 각 연결마다 고유한 IAM 자격증명 사용
• 단일 workspace 내 여러 프로젝트가 동일한 연결 공유 가능

이를 통해 환경(예: 프로덕션·스테이징 workgroup)을 분리하거나 팀별로 접근을 제한하기 쉽습니다.

AWS Athena는 안전한 자격증명 처리와 자동 요청 서명을 위해 Lovable의 gateway 아키텍처를 사용합니다. 인증 및 사용 제한 상세 내용은 Gateway-based connectors를 참고하세요.

AWS Athena 연결하기

Workspace admins와 owners가 AWS Athena를 연결할 수 있습니다.

연결이 생성되면 workspace 내 모든 프로젝트에서 AWS Athena를 사용할 수 있습니다. 프로젝트에서 작업하는 누구든 Lovable 채팅에서 프로젝트를 연결해달라고 요청할 수 있습니다.

사전 준비

AWS Athena를 연결하기 전에 다음을 준비하세요.

• S3에 데이터가 있고 Glue Data Catalog에 테이블이 정의된 AWS 계정
• 아래에 나열된 Athena, Glue, S3 권한을 가진 IAM 사용자
• Lovable workspace owner 또는 admin 역할

Step 1: Athena 접근 권한을 가진 IAM 사용자 생성하기

Lovable에서 연결을 설정하기 전에 AWS에서 필요한 최소 권한을 가진 IAM 사용자를 생성합니다. Athena에는 세 가지 접근 권한이 필요합니다. Athena API 자체, 테이블 정의가 있는 Glue Data Catalog, 데이터와 쿼리 결과를 보관하는 S3 버킷입니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AthenaQueries",
      "Effect": "Allow",
      "Action": [
        "athena:StartQueryExecution",
        "athena:StopQueryExecution",
        "athena:GetQueryExecution",
        "athena:GetQueryResults",
        "athena:GetWorkGroup",
        "athena:ListDatabases",
        "athena:ListTableMetadata"
      ],
      "Resource": [
        "arn:aws:athena:YOUR-REGION:YOUR-ACCOUNT-ID:workgroup/YOUR-WORKGROUP",
        "arn:aws:athena:YOUR-REGION:YOUR-ACCOUNT-ID:datacatalog/AwsDataCatalog"
      ]
    },
    {
      "Sid": "GlueCatalog",
      "Effect": "Allow",
      "Action": [
        "glue:GetDatabase",
        "glue:GetDatabases",
        "glue:GetTable",
        "glue:GetTables",
        "glue:GetPartition",
        "glue:GetPartitions"
      ],
      "Resource": [
        "arn:aws:glue:YOUR-REGION:YOUR-ACCOUNT-ID:catalog",
        "arn:aws:glue:YOUR-REGION:YOUR-ACCOUNT-ID:database/YOUR-DATABASE",
        "arn:aws:glue:YOUR-REGION:YOUR-ACCOUNT-ID:table/YOUR-DATABASE/*"
      ]
    },
    {
      "Sid": "ReadData",
      "Effect": "Allow",
      "Action": ["s3:GetObject", "s3:ListBucket"],
      "Resource": [
        "arn:aws:s3:::YOUR-DATA-BUCKET",
        "arn:aws:s3:::YOUR-DATA-BUCKET/*"
      ]
    },
    {
      "Sid": "ResultLocation",
      "Effect": "Allow",
      "Action": [
        "s3:GetObject",
        "s3:PutObject",
        "s3:GetBucketLocation",
        "s3:ListBucket"
      ],
      "Resource": [
        "arn:aws:s3:::YOUR-RESULTS-BUCKET",
        "arn:aws:s3:::YOUR-RESULTS-BUCKET/*"
      ]
    }
  ]
}

자세한 내용은 AWS 문서의 Identity and access management in Athena를 참고하세요.

Step 2: AWS Athena를 Lovable에 연결하기

다른 IAM 자격증명을 사용해 여러 연결을 생성할 수 있습니다.

연결이 완료되면 프로젝트에서 작업하는 누구든 Lovable 채팅에서 프로젝트를 AWS Athena에 연결해달라고 요청할 수 있습니다(구성된 connection-level access 기준). Lovable 앱은 S3의 데이터에 SQL 쿼리를 실행하고 결과를 활용할 수 있습니다.

제한사항

AWS Athena connector는 다음 작업을 지원하지 않습니다.

• Athena 이외의 AWS 서비스 호출. gateway는 Athena API 작업만 전달하므로 이 연결을 통해 S3 객체를 직접 읽거나 Glue 리소스를 관리할 수 없습니다.
• 연결한 IAM 정책의 권한 초과. 자격증명에 데이터, Glue Data Catalog, 결과 위치에 대한 접근 권한이 없으면 쿼리가 실패합니다.
• 쿼리 동기 실행. Athena가 쿼리 처리를 완료한 후에만 결과를 사용할 수 있습니다.
• 액세스 키 자동 교체. 교체하려면 IAM에서 새 액세스 키를 생성하고 Lovable 연결을 업데이트하세요.
• 최종 사용자별 AWS 로그인. 각 연결은 연결된 모든 프로젝트가 공유하는 단일 IAM 자격증명을 나타냅니다.

AWS Athena 연결에서 프로젝트 연결 해제하기

Editors 이상은 연결 자체를 삭제하지 않고 특정 프로젝트만 연결에서 제거할 수 있습니다. 연결은 다른 프로젝트에서 계속 사용할 수 있습니다.

프로젝트 연결을 해제하려면 다음 단계를 따르세요.

연결 해제 후 해당 프로젝트는 이 연결을 통해 AWS Athena에 접근할 수 없습니다. 다시 AWS Athena가 필요하면 사용 가능한 연결에 프로젝트를 연결하면 됩니다.

AWS Athena 연결 삭제하기

Workspace admins와 owners가 AWS Athena 연결을 삭제할 수 있습니다. 다른 멤버는 본인이 생성했거나 명시적으로 접근 권한을 부여받은 연결만 삭제할 수 있습니다.

삭제 전에 Linked projects 섹션에서 현재 이 연결을 사용하는 프로젝트를 확인하세요.

연결을 삭제하려면 다음 단계를 따르세요.