Cloud SQL Studio에서 컨텍스트 세트 관리

미리보기

이 기능에는 서비스별 약관의 일반 서비스 약관 섹션에 있는 'GA 이전 제품 또는 서비스 약관'과 생성형 AI 프리뷰 제품 추가 약관이 적용됩니다. GA 이전 기능은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.

이 문서에서는 컨텍스트 세트 파일을 사용하여 MySQL용 Cloud SQL Studio에서 컨텍스트 세트를 만드는 방법을 설명합니다. 컨텍스트 세트 이름은 프로젝트 내에서 고유해야 합니다.

컨텍스트 세트에 대한 자세한 내용은 컨텍스트 세트 개요를 참조하세요.

시작하기 전에

에이전트를 만들기 전에 다음 기본 요건을 완료하세요.

필수 서비스 사용 설정

프로젝트에 다음 서비스를 사용 설정합니다.

• Gemini 기반 Data Analytics API
• Gemini for Google Cloud API
• Knowledge Catalog API

Cloud SQL 인스턴스 준비

• 기존 Cloud SQL 인스턴스에 액세스할 수 있는지 확인하거나 새 인스턴스를 만듭니다. 자세한 내용은 Cloud SQL 인스턴스 만들기를 참조하세요.
• 테이블을 만들 인스턴스에 데이터베이스를 만들어야 합니다. 자세한 내용은 Cloud SQL 인스턴스에서 데이터베이스 만들기를 참조하세요.

필수 역할 및 권한

• 인스턴스 수준에서 IAM 사용자 또는 서비스 계정을 추가합니다. 자세한 내용은 사용자, 서비스 계정 또는 그룹에 IAM 정책 바인딩 추가를 참조하세요.
• 프로젝트 수준에서 IAM 사용자 또는 서비스 계정에 cloudsql.studioUser, cloudsql.instanceUser, geminidataanalytics.queryDataUser 역할을 부여합니다. 자세한 내용은 프로젝트에 IAM 정책 바인딩 추가를 참조하세요.
• 컨텍스트 집합을 만들고, 업로드하고, 관리하려면 프로젝트 수준에서 IAM 사용자 또는 서비스 계정에 Dataplex 카탈로그 편집자(roles/dataplex.catalogEditor) 또는 Dataplex 카탈로그 관리자(roles/dataplex.catalogAdmin) 역할을 부여합니다. 자세한 내용은 컨텍스트 세트 권한을 참조하세요.
• 권한이 있는 사용자가 IAM 사용자 또는 서비스 계정에 데이터베이스 권한을 부여해야 합니다.
  
  GRANT SELECT PRIVILEGES ON * TO "IAM_USERNAME";.
  
  자세한 내용은 개별 IAM 사용자 또는 서비스 계정에 데이터베이스 권한 부여를 참조하세요.

Cloud SQL 인스턴스에 executesql 권한 부여

Cloud SQL 인스턴스에 executesql 권한을 부여하고 Cloud SQL Data API를 사용 설정하려면 다음 명령어를 실행합니다.

gcloud config set project PROJECT_ID
gcloud components update
gcloud beta sql instances patch INSTANCE_ID --data-api-access=ALLOW_DATA_API

다음을 바꿉니다.

• PROJECT_ID: Google Cloud 프로젝트의 ID입니다.
• INSTANCE_ID: Cloud SQL 인스턴스의 ID입니다.

이 튜토리얼의 단계를 수행하려면 Google Cloud에 로그인한 후 IAM 인증을 사용하여 데이터베이스에 인증합니다.

컨텍스트 세트 만들기

컨텍스트 세트를 만들려면 다음 단계를 수행합니다.

1. Google Cloud 콘솔에서 Cloud SQL 페이지로 이동합니다.

   Cloud SQL로 이동

2. 목록에서 인스턴스를 선택합니다.

3. 탐색 메뉴에서 Cloud SQL Studio를 클릭합니다.

4. IAM 인증을 사용하여 스튜디오에 로그인합니다.

5. 탐색기 창에서 컨텍스트 세트 옆에 있는 작업 보기를 클릭합니다.

6. 컨텍스트 세트 만들기를 클릭합니다.

7. 컨텍스트 세트 이름에 고유한 컨텍스트 세트 이름을 입력합니다. 컨텍스트 세트 이름은 대소문자를 구분하며 문자, 숫자, 하이픈, 밑줄을 포함할 수 있습니다. 이름은 4~30자(영문 기준)여야 합니다.

   컨텍스트 세트 ID는 컨텍스트 세트 이름에서 파생되지만 반드시 동일하지는 않습니다. 컨텍스트 세트 ID의 경우 컨텍스트 세트 이름이 소문자로 변환되고 영숫자가 아닌 문자는 - 문자로 대체됩니다. 예를 들어 컨텍스트 세트 이름 querydata_e2e_test에는 컨텍스트 세트 ID querydata-e2e-test가 있습니다.

8. (선택사항) 컨텍스트 세트 설명에 컨텍스트 세트에 대한 설명을 추가합니다.

9. (선택사항) 컨텍스트 세트 파일을 업로드하려면 컨텍스트 세트 파일 업로드 섹션에서 찾아보기를 클릭하고 컨텍스트 세트 파일을 선택합니다.

10. 만들기를 클릭합니다.

참고: 프로젝트에서 첫 번째 컨텍스트 세트를 만드는 데 몇 분 정도 걸릴 수 있습니다.

빌드 컨텍스트 세트

컨텍스트 세트를 만든 후 Gemini CLI를 사용하여 컨텍스트 빌드의 단계에 따라 컨텍스트 세트 파일을 만듭니다. 그런 다음 컨텍스트 세트를 수정하여 컨텍스트 세트 파일을 업로드할 수 있습니다.

컨텍스트 세트 수정

컨텍스트 세트를 수정하려면 다음 단계를 수행합니다.

1. Google Cloud 콘솔에서 Cloud SQL 페이지로 이동합니다.

   Cloud SQL로 이동

2. 목록에서 인스턴스를 선택합니다.

3. 탐색 메뉴에서 Cloud SQL Studio를 클릭합니다.

4. IAM 인증을 사용하여 스튜디오에 로그인합니다.

5. 수정하려는 컨텍스트 세트 옆에 있는 작업 보기를 클릭합니다.

6. 컨텍스트 세트 수정을 클릭합니다.

7. (선택사항) 컨텍스트 세트 설명을 수정합니다.

8. 컨텍스트 세트 파일 업로드 섹션에서 찾아보기를 클릭하고 컨텍스트 세트 파일을 선택합니다.

9. 저장을 클릭합니다.

컨텍스트 세트 삭제

컨텍스트 세트를 삭제하려면 다음 단계를 수행합니다.

1. Google Cloud 콘솔에서 Cloud SQL 페이지로 이동합니다.

   Cloud SQL로 이동

2. 목록에서 인스턴스를 선택합니다.

3. 탐색 메뉴에서 Cloud SQL Studio를 클릭합니다.

4. IAM 인증을 사용하여 스튜디오에 로그인합니다.

5. 삭제하려는 컨텍스트 세트 옆에 있는 작업 보기를 클릭합니다.

6. 컨텍스트 세트 삭제를 클릭합니다.

7. 컨텍스트 세트 삭제 확인 대화상자에서 컨텍스트 세트의 ID를 입력합니다.

8. 확인을 클릭하여 컨텍스트 세트를 삭제합니다.

참고: 데이터베이스를 삭제하려면 먼저 해당 데이터베이스와 연결된 모든 컨텍스트 집합을 삭제해야 합니다.

다음 단계

• 컨텍스트 세트에 대해 자세히 알아보세요.
• 컨텍스트 세트를 테스트하는 방법을 알아보세요.
• Gemini CLI를 사용하여 컨텍스트를 빌드하는 방법을 알아보세요.