기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# AWS Config 고급 쿼리를 위한 자연어 쿼리 프로세서
<a name="query-assistant"></a>

**참고**  
 AWS Config 자연어 쿼리 프로세서의 공개 미리 보기는 2026년 1월 15일까지 중단됩니다. 또한 Amazon Q Developer에서 자연어 프롬프트를 사용하여 AWS 리소스에 대해 채팅할 수 있습니다. 자세한 내용은 [리소스에 대해 Amazon Q Developer와 채팅](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/chat-actions.html) 섹션을 참조하세요.

고급 쿼리용 자연어 쿼리 프로세서는 일반 영어로 프롬프트를 입력한 후 바로 사용 가능한 쿼리 형식으로 질문을 변환할 수 있는 생성형 인공 지능(생성형 AI) 기술인 [Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-bedrock.html)을 사용합니다. 자연어 쿼리 프로세서를 사용하면 AWS 조직 전체에서 AWS 계정 또는를 쿼리할 수 있습니다.

프롬프트트는 의문형 또는 평서문일 수 있습니다. 예를 들어 'Which load balancers are created after January 1, 2024?' 또는 ‘List all my lambda function that is running node js 16.’과 같은 프롬프트를 입력할 수 있습니다.

## 고려 사항
<a name="query-assistant-considerations"></a>

자연어 쿼리 프로세서는 다음 작업을 수행할 수 없습니다.
+ 영어 이외의 언어로 쿼리 생성
+ 고급 쿼리와 관련이 없는 프롬프트에 대한 쿼리 생성
+ 1,000자 이상의 프롬프트에 대한 쿼리 생성
+ 후속 수정 또는 이전 세션에 대한 쿼리 생성
+ 생성된 코드 설명

## 자연어 쿼리 프로세서를 사용한 쿼리
<a name="use-a-sample-query"></a>

1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/config/home](https://console.aws.amazon.com/config/home) AWS Config 콘솔을 엽니다.

1. 왼쪽 탐색 메뉴에서 **고급 쿼리**를 선택하여 단일 계정 및 지역 또는 여러 계정 및 지역의 리소스 구성을 쿼리할 수 있습니다.

1. **고급 쿼리** 페이지에서 **새 쿼리**를 선택하여 쿼리 편집기로 이동합니다.
   + 애그리게이터로 쿼리를 실행하려면 애그리게이터를 생성합니다. 자세한 내용은 [AWS Config의 애그리게이터 생성](aggregated-create.md) 섹션을 참조하세요.
   + 이미 애그리게이터를 설정한 경우 쿼리 범위에서 그 애그리게이터를 선택하고 그 애그리게이터에 대해 고급 쿼리를 실행합니다. 집계자를 선택할 때 쿼리 문에 AWS 계정 ID와 AWS 리전을 추가하여 결과에서 해당 정보를 보는 것이 좋습니다.

1. 쿼리 편집기에서 **자연어 쿼리 프로세서** 섹션으로 이동합니다. 일반 영어로 프롬프트를 입력한 다음 **생성**을 선택합니다. 예제는 [프롬프트 예제](https://docs.aws.amazon.com/config/latest/developerguide/query-assistant.html#example-prompts)를 참조하세요.

1. 쿼리를 생성한 후 **복사**(기능적으로는 Ctrl\$1C와 동일)를 선택하여 쿼리를 클립보드에 복사하거나 **편집기에 채우기**를 선택할 수 있습니다. 편집기에 채워진 경우 생성된 쿼리를 필요에 맞게 편집할 수 있습니다.

1. 이 쿼리를 새 쿼리에 저장하려면 **다른 이름으로 저장**을 선택합니다.
   + **쿼리 이름** 필드에서 쿼리 이름을 업데이트합니다.
   + **설명** 필드에서 쿼리의 설명을 업데이트합니다.
   + 이 쿼리에 최대 50개의 고유 태그를 입력합니다.
   + **저장**을 선택합니다.

1. **실행**을 선택합니다. 쿼리 결과는 쿼리 편집기 아래 테이블에 표시됩니다.

1. 쿼리 결과를 CSV 또는 JSON 형식으로 내보내려면 **내보내기 형식**을 선택합니다.
**참고**  
쿼리 결과가 페이지 매김됩니다. 내보내는 경우 최대 500개의 결과가 내보내집니다.  
API를 사용하여 모든 결과를 검색할 수도 있습니다. 결과는 페이지 매김되며 한 번에 100개의 결과를 검색할 수 있습니다.

## 프롬프트 예제
<a name="query-assistant-example-prompts"></a>

다음은 예제로 사용할 수 있는 프롬프트와 생성 쿼리입니다.

------
#### [ Example: What load balancers were created after January 1, 2024? ]

프롬프트

**생성된 쿼리:**

```
SELECT
    resourceId,
    resourceType,
    resourceCreationTime
WHERE
    resourceType IN ('AWS::ElasticLoadBalancing::LoadBalancer', 'AWS::ElasticLoadBalancingV2::LoadBalancer')
AND
    resourceCreationTime > '2024-01-01T00:00:00.0Z'
ORDER BY
    resourceCreationTime
DESC
```

------
#### [ Example: Which of my RDS database instances are publicly accessible? ]

프롬프트

**생성된 쿼리:**

```
SELECT
    resourceId,
    resourceType,
    configuration.publiclyAccessible
WHERE 
    resourceType = 'AWS::RDS::DBInstance'
AND
    configuration.publiclyAccessible = true
```

------
#### [ Example: How many EC2 instances were created in last one year? ]

프롬프트

**생성된 쿼리:**

```
SELECT
    COUNT(*)
WHERE
    resourceType = 'AWS::EC2::Instance'
AND
    resourceCreationTime
BETWEEN
    '2023-05-10T16:56:25.000Z'
AND
    '2024-05-10T16:56:25.000Z'
```

------
#### [ Example: How many EC2 instances do I have in each of my AWS 계정? ]

프롬프트

**생성된 쿼리:**

```
SELECT
    accountId,
    COUNT(*)
WHERE
    resourceType = 'AWS::EC2::Instance'
GROUP BY
    accountId'
```

------
#### [ Example: Which IAM roles have the managed policy AdministratorAccess attached? ]

프롬프트

**생성된 쿼리:**

```
SELECT
    resourceId,
    resourceName,
    resourceType
WHERE
    resourceType = 'AWS::IAM::Role'
AND
    configuration.attachedManagedPolicies.policyName = 'AdministratorAccess'
```

------
#### [ Example: EBS volumes without encryption ]

프롬프트

**생성된 쿼리:**

```
SELECT
    accountId
WHERE
    resourceType = 'AWS::EC2::Volume'
AND
    configuration.encrypted = false
```

------
#### [ Example:  Get noncompliant resources ]

프롬프트

**생성된 쿼리:**

```
SELECT
    resourceId,
    resourceType
WHERE
    resourceType = 'AWS::Config::ResourceCompliance'
AND
    configuration.complianceType = 'NON_COMPLIANT'
```

------
#### [ Example: List all my lambda function that is running node js 16 ]

프롬프트

**생성된 쿼리:**

```
SELECT
    accountId,
    resourceName
WHERE
    resourceType = 'AWS::Lambda::Function'
AND
    configuration.runtime = 'nodejs16.x'
```

------
#### [ Example: What ACM certificates expire the next 30 days? ]

프롬프트

**생성된 쿼리:**

```
SELECT
    resourceId,
    configuration.domainName,
    configuration.notAfter
WHERE
    resourceType = 'AWS::ACM::Certificate'
AND
    configuration.notAfter
BETWEEN
    '2024-05-10 16:59:53'
AND
    '2024-06-10 16:59:53’
```

**참고**  
생성된 쿼리의 시간은 프롬프트를 입력한 시간에 따라 달라집니다.

------

## 피드백 제공
<a name="query-assistant-feedback"></a>

자연어 쿼리 프로세서에 대한 전반적인 피드백 또는 생성된 특정 쿼리에 대한 피드백을 제공할 수 있습니다.

**자연어 쿼리 프로세서에 대한 피드백 제공**

오른쪽의 자연어 쿼리 프로세서 위에 나타나는 **피드백 제공** 버튼을 선택합니다. 만족 또는 불만족을 입력하고가 자연어 쿼리를 더 유용하게 만들 수 있는 방법에 대한 피드백을 제공할 AWS Config 수 있습니다.

**참고**  
개인 정보, 상업적으로 민감한 정보 또는 기밀 정보를 공개하지 마세요.

**생성된 특정 쿼리에 대한 피드백 제공**

생성된 쿼리 아래에 나타나는 좋아요 또는 싫어요 버튼을 선택하여 생성된 쿼리에 대한 피드백을 제공할 수 있습니다.

## 리전 지원
<a name="query-assistant-region-support"></a>

자연어 쿼리 프로세서는 다음 리전에서 지원됩니다.


****  
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/config/latest/developerguide/query-assistant.html)