Databases의 Gemini 설정하기

미리보기

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

Databases의 Gemini를 설정하려면 이 문서에 설명된 단계를 수행하세요.

1. Google Cloud 프로젝트에서 Cloud AI Companion API를 사용 설정합니다. 일반적으로 관리자가 이 단계를 실행합니다.

2. Google Cloud 프로젝트에서 Identity and Access Management(IAM) 역할을 부여합니다. 일반적으로 관리자가 이 단계를 실행합니다.

3. Databases의 Gemini 활성화

4. Recommender API 사용 설정하기

5. 색인 자문 사용 설정(PostgreSQL용 AlloyDB, PostgreSQL용 Cloud SQL, MySQL용 Cloud SQL에만 적용 가능)

시작하기 전에

Databases의 Gemini를 활성화하려면 roles/billing.admin Identity and Access Management(IAM) 역할이 있어야 합니다.

Google Cloud 프로젝트에서 Cloud AI Companion API 사용 설정

이 섹션에서는 Google Cloud 프로젝트에서 Cloud AI Companion API를 사용 설정하는 데 필요한 단계를 설명합니다.

콘솔

1. Cloud AI Companion API를 사용 설정하려면 Google Cloud를 위한 Gemini 페이지로 이동합니다.

   Google Cloud를 위한 Gemini로 이동

2. 프로젝트 선택기에서 프로젝트를 선택합니다.

3. 사용 설정을 클릭합니다.

   페이지가 업데이트되고 사용 설정됨 상태가 표시됩니다. 이제 선택한 Google Cloud 프로젝트에서 필요한 IAM 역할을 가진 모든 사용자가 Gemini를 사용할 수 있습니다.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

2. 프로젝트 선택기 메뉴에서 프로젝트를 선택합니다.

3. gcloud services enable 명령어를 사용하여 Gemini용 Cloud AI Companion API를 사용 설정합니다.

   gcloud services enable cloudaicompanion.googleapis.com
   

   다른 Google Cloud 프로젝트에 Cloud AI Companion API를 사용 설정하려면 --project 매개변수를 추가합니다.

   gcloud services enable cloudaicompanion.googleapis.com --project PROJECT_ID
   

   PROJECT_ID를 Google Cloud 프로젝트 ID로 바꿉니다.

   출력은 다음과 비슷합니다.

   Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
   Operation finished successfully.
   

이제 지정된 Google Cloud 프로젝트에서 필요한 IAM 역할이 있는 모든 사용자가 Gemini for Google Cloud를 사용할 수 있습니다.

Google Cloud 프로젝트에서 IAM 역할 부여

이 섹션에서는 Cloud AI 컴패니언 사용자 및 서비스 사용량 소비자 IAM 역할을 사용자에게 부여하는 데 필요한 단계를 설명합니다.

콘솔

1. Gemini 사용에 필요한 IAM 역할을 부여하려면 IAM 및 관리자 페이지로 이동합니다.

   IAM 및 관리자로 이동

2. 주 구성원 열에서 Gemini에 대한 액세스를 사용 설정하려는 주 구성원 열을 찾은 후 해당 행에서 주 구성원 수정을 클릭합니다.

3. 액세스 수정 창에서 다른 역할 추가를 클릭합니다.

4. 역할 선택에서 Cloud AI 컴패니언 사용자를 선택합니다.

5. 다른 역할 추가를 클릭하고 서비스 사용량 소비자를 선택합니다.

6. 저장을 클릭합니다.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

2. 프로젝트 선택기 메뉴에서 프로젝트를 선택합니다.

3. Cloud AI 컴패니언 사용자 역할을 부여합니다.

   gcloud projects add-iam-policy-binding  PROJECT_ID \
       --member=PRINCIPAL --role=roles/cloudaicompanion.user
   

   PRINCIPAL을 주 구성원 식별자로 바꿉니다. 식별자는 user|group|serviceAccount:email 또는domain:domain 형식을 취합니다(예:user:[e-mail], group:[e-mail], serviceAccount:[e-mail] 또는 domain:example.domain.com).

   다음을 포함하는 정책 바인딩 목록이 출력됩니다.

   - members:
     - user:PRINCIPAL
     role: roles/cloudaicompanion.user
   

4. 서비스 사용량 소비자 역할을 부여합니다.

   gcloud projects add-iam-policy-binding  PROJECT_ID \
       --member=PRINCIPAL --role=roles/serviceusage.serviceUsageConsumer
   

   다음을 포함하는 정책 바인딩 목록이 출력됩니다.

   - members:
     - user:PRINCIPAL
     role: roles/serviceusage.serviceUsageConsumer
   

자세한 내용은 단일 역할 부여 및 gcloud projects add-iam-policy-binding을 참조하세요.

이러한 역할이 부여된 모든 사용자가 지정된 프로젝트 내에서 Google Cloud 콘솔의 Google Cloud용 Gemini 기능에 액세스할 수 있습니다. 자세한 내용은 Google Cloud용 Gemini 개요를 참조하세요.

Databases의 Gemini 활성화

중요: Databases의 Gemini를 활성화하는 데 24~48시간이 걸릴 수 있습니다.

Google Cloud 프로젝트에서 Databases의 Gemini를 활성화하려면 다음 단계를 따르세요. 일반적으로 관리자 또는 프로젝트 소유자가 다음 단계를 수행합니다.

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

   Google Cloud용 Gemini

2. Databases의 Gemini를 클릭합니다.

   Gemini 살펴보기 창이 표시됩니다.

3. Databases의 Gemini 가져오기를 클릭합니다.

   Gemini 관리자 페이지가 표시됩니다.

4. Databases의 Gemini를 활성화하려는 결제 계정을 선택하고 Databases의 Gemini 페이지 계속을 클릭합니다.

   Databases의 Gemini 페이지가 표시됩니다.

5. 약관 검토 및 사용 설정을 클릭합니다.

   Databases의 Gemini 사용 설정 페이지가 표시됩니다.

6. 구매를 클릭하여 Databases의 Gemini를 활성화합니다.

Recommender API 사용 설정

Enable the Recommender API.

Enable the API

Recommender API가 나열되지 않으면 프로젝트에 이미 사용 설정된 것입니다.

색인 자문 사용 설정

PostgreSQL용 AlloyDB, MySQL용 Cloud SQL 8.0 인스턴스, PostgreSQL용 Cloud SQL 12 이상 인스턴스에 대해 색인 자문을 사용 설정할 수 있습니다.

PostgreSQL용 AlloyDB

다음 단계에서는 PostgreSQL용 AlloyDB에 색인 자문을 사용 설정하는 방법을 설명합니다.

1. 색인 자문을 사용 설정하기 전에 인스턴스에서 향상된 쿼리 통계를 사용 설정하세요.

2. Google Cloud 콘솔에서 클러스터 페이지로 이동합니다.

   클러스터로 이동

3. 클러스터 및 인스턴스 목록에서 인스턴스를 클릭합니다.
4. 쿼리 통계를 클릭합니다.
5. 데이터베이스와 사용자를 선택합니다.
6. '설정 수정'을 클릭합니다.
7. 클러스터의 쿼리 통계 페이지에서 색인 생성 추천을 사용 설정하려면 추천 사용 설정을 선택합니다.
8. 변경사항을 저장합니다.

PostgreSQL용 AlloyDB에서 색인 자문을 사용하는 방법에 대한 자세한 내용은 쿼리 통계에 색인 자문 사용을 참조하세요.

MySQL용 Cloud SQL

다음 단계에서는 MySQL용 Cloud SQL에 대해 색인 자문을 사용 설정하는 방법을 설명합니다. MySQL용 Cloud SQL의 색인 자문은 MySQL 성능 스키마의 데이터를 사용합니다. 기본적으로 Cloud SQL은 메모리가 15GB를 초과하는 모든 MySQL 8.0 인스턴스에서 MySQL 성능 스키마를 사용 설정합니다.

1. Index Advisor를 사용 설정하기 전에 인스턴스에서 쿼리 통계를 사용 설정하세요.
2. MySQL용 Cloud SQL 인스턴스에서 이미 MySQL 성능 스키마가 사용 설정된 경우 색인 자문을 사용 설정하려면 다음 gcloud CLI 명령어를 실행합니다.

gcloud sql instances patch INSTANCE_NAME \
    --database-flags=cloudsql_index_advisor=on

INSTANCE_NAME을 인스턴스 이름으로 바꿉니다.

3. MySQL용 Cloud SQL 인스턴스에서 MySQL 성능 스키마가 사용 설정되지 않은 경우 색인 자문을 사용 설정하려면 다음 gcloud CLI 명령어를 실행합니다.

gcloud sql instances patch INSTANCE_NAME \
   --database-flags=cloudsql_index_advisor=on,performance_schema=on

INSTANCE_NAME을 인스턴스 이름으로 바꿉니다.

주의: performance_schema 플래그를 on으로 설정하면 인스턴스가 자동으로 다시 시작됩니다.

플래그 구성에 대한 자세한 내용은 데이터베이스 플래그 구성을 참조하세요.

PostgreSQL용 Cloud SQL

다음 단계에서는 PostgreSQL용 Cloud SQL에 대해 색인 자문을 사용 설정하는 방법을 설명합니다.

1. Index Advisor를 사용 설정하기 전에 인스턴스에서 쿼리 통계를 사용 설정하세요.
2. PostgreSQL용 Cloud SQL 인스턴스에 Index Advisor를 사용 설정하려면 다음 Google Cloud CLI 명령어를 실행합니다.

gcloud sql instances patch INSTANCE_NAME \
   --database-flags=cloudsql.enable_index_advisor=on
    

INSTANCE_NAME을 인스턴스 이름으로 바꿉니다.

플래그 구성에 대한 자세한 내용은 데이터베이스 플래그 구성을 참조하세요.