Gemini 지원으로 SQL 작성

미리보기 — Gemini in Spanner

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

이 문서에서는 Databases의 Gemini를 사용하여 Spanner에서 다음 작업을 지원하는 AI 기반 지원을 받는 방법을 설명합니다.

• 자연어 프롬프트를 사용하여 SQL 쿼리 생성
• 쿼리 편집기에서 SQL 문을 완성합니다.
• 쿼리 편집기에서 SQL 쿼리를 설명합니다.

Google Cloud를 위한 Gemini가 사용자의 데이터를 사용하는 방법과 시점을 알아보세요.

이 문서는 Spanner, SQL, 데이터 분석에 익숙한 데이터베이스 관리자 및 데이터 엔지니어를 대상으로 합니다. Spanner를 처음 사용하는 경우 Google Cloud 콘솔을 사용하여 데이터베이스를 만들고 쿼리하는 방법을 확인하세요.

시작하기 전에

1. 데이터베이스에서 Gemini를 설정했는지 확인합니다.
2. 이 문서의 태스크를 완료하려면 필요한 Identity and Access Management(IAM) 권한이 있는지 확인합니다.

3. Google Cloud 콘솔에서 Spanner 페이지로 이동합니다.

   Spanner로 이동

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

5. 데이터베이스를 선택합니다.

6. 탐색 메뉴에서 Spanner 스튜디오를 클릭합니다.

7. 작업 표시줄에서 pen_spark Gemini를 클릭하여 Spanner에서 Gemini 기능을 확인합니다.

8. 사용 설정할 Gemini 기능을 선택합니다. 예를 들어 SQL 완료, 주석-쿼리 생성 등입니다. 프로젝트에서 작업하는 다른 사용자에게 영향을 주지 않고 직접 기능을 선택하고 사용해 볼 수 있습니다.

9. 선택사항: 이 문서의 예시를 따라 진행하려면 먼저 데이터베이스의 스키마 만들기에 설명된 대로 Singers 테이블을 만듭니다.

Spanner에서 Gemini 기능을 사용 중지하려면 이 단계를 반복한 다음 사용을 중지하려는 Gemini 기능을 선택 해제합니다.

필요한 역할

이 문서의 태스크를 완료하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Google Cloud용 Gemini 사용자(roles/cloudaicompanion.user) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

자연어 프롬프트를 사용하여 SQL 쿼리 생성

Google Cloud용 Gemini는 아직 초기 단계의 기술로, 그럴듯해 보이지만 실제로는 잘못된 출력을 생성할 수 있습니다. Google Cloud용 Gemini 제품의 모든 출력을 사용 전에 미리 검사하는 것이 좋습니다. 자세한 내용은 Google Cloud를 위한 Gemini와 책임감 있는 AI를 참조하세요.

자연어 주석(또는 프롬프트)으로 Gemini가 스키마에 따른 쿼리를 생성하게 할 수 있습니다. 예를 들어 Gemini가 다음 프롬프트에 대한 응답 SQL을 생성하도록 유도할 수 있습니다.

• '고객 만족도 설문조사 결과를 추적하는 테이블을 만들어 줘.'
• 'Singers 테이블에 생일이라는 날짜 열을 추가해 줘.'
• '90년대에 태어난 가수는 몇 명이야?'

참고: Spanner에 Gemini 프롬프트를 입력하면 데이터베이스 스키마에 대한 정보가 프롬프트에 포함됩니다. 여기에는 테이블 이름, 데이터 유형, 열 설명이 포함될 수 있습니다. 데이터베이스 스키마와 데이터는 Spanner에 유지되고 Gemini로 전송되지 않습니다.

Gemini 지원으로 Spanner에서 SQL을 생성하려면 다음 단계를 따르세요.

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

   Spanner로 이동

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

3. 데이터베이스를 선택합니다.

4. 탐색창에서 Spanner 스튜디오를 클릭합니다. 탐색기 창에 데이터베이스의 객체 목록이 표시됩니다.

5. 데이터베이스를 쿼리하려면 새 SQL 편집기 탭을 클릭합니다. SQL 생성이 사용 설정되어 있는지 확인합니다.

6. SQL을 생성하려면 쿼리 편집기에서 --로 시작하고 그 뒤에 한 줄 주석이 있는 주석을 입력한 후 Return을 누릅니다.

   예를 들어 -- add a row to table singers 프롬프트를 입력하고 Return을 누르면 Gemini에서 다음과 유사한 SQL을 생성합니다.

   INSERT INTO Singers (SingerId, FirstName, LastName, BirthDate)
   VALUES (1, Alex, 'M.', '1977-10-16');
   

   Singers 테이블을 사용하여 예시를 계속 진행하면 -- show all singers born in the 70s 프롬프트를 입력하면 Gemini가 다음과 비슷한 SQL을 생성합니다.

   SELECT *
   FROM Singers
   WHERE Singers.BirthDate
   BETWEEN '1970-01-01' AND '1979-12-31'
   
   

   참고: Gemini는 개발자가 같은 프롬프트를 입력할 때마다 다른 문법을 제안할 수 있습니다.

7. 생성된 SQL을 검토하고 다음 작업 중 하나를 수행합니다.

   • Gemini에서 생성한 SQL을 수락하려면 Tab을 누른 후 실행을 클릭하여 추천 SQL을 실행합니다.
   • Gemini에서 생성한 SQL을 수정하려면 Tab을 눌러 SQL을 수정한 후 실행을 클릭합니다.
   • 추천을 닫으려면 Esc를 누르거나 계속 입력합니다.

쿼리 편집기에서 SQL 문 완성

Spanner의 Gemini는 SQL 코드를 작성하는 데 도움이 되도록 AI 지원 코드 완성 기능을 제공합니다. Gemini가 사용 설정된 상태에서 Spanner 스튜디오 쿼리 편집기에 텍스트를 입력하면 Gemini가 SQL 코드를 예측하고 자동 완성합니다.

인라인 코드 추천

인라인 코드 추천을 사용하려면 다음 단계를 따르세요.

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

   Spanner로 이동

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

3. 데이터베이스를 선택합니다.

4. 탐색창에서 Spanner 스튜디오를 클릭합니다.

5. 데이터베이스를 쿼리하려면 새 SQL 편집기 탭을 클릭합니다. SQL 완성이 사용 설정되어 있는지 확인합니다.

6. 쿼리를 입력하고 줄 끝에 공백 또는 줄바꿈을 입력합니다. 텍스트를 입력하면 Gemini가 선택한 데이터베이스 스키마에서 지원되는 객체를 기반으로 추천 SQL을 표시합니다.

   예를 들어 Singers 테이블에 행을 추가하려면 SQL INSERT INTO Singers를 작성합니다.

   Gemini는 다음과 유사한 SQL을 제안합니다.

   INSERT INTO Singers
   (SingerId, FirstName, LastName, BirthDate)
   VALUES
     (1, 'Marc', 'Singer', '1970-03-24')
   

   참고: Gemini는 개발자가 같은 SQL 문을 입력할 때마다 다른 SQL 문법을 제안할 수 있습니다.

7. SQL 추천을 검토하고 다음 작업을 수행합니다.

   • Gemini에서 생성한 SQL을 수락하려면 Tab을 누른 후 실행을 클릭하여 추천 SQL을 실행합니다.
   • Gemini에서 생성한 SQL을 수정하려면 Tab을 눌러 SQL을 수정한 후 실행을 클릭합니다.
   • 추천을 닫으려면 Esc를 누르거나 계속 입력합니다.

코딩 작성 지원 도구

코드 작성 지원 도구를 사용하려면 다음 단계를 수행합니다.

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

   Spanner로 이동

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

3. 데이터베이스를 선택합니다.

4. 탐색창에서 Spanner 스튜디오를 클릭합니다.

5. 데이터베이스를 쿼리하려면 새 탭을 클릭합니다.

6. 쿼리 편집기 옆에 있는 pen_spark 코드 작성 지원을 클릭합니다.

7. 코드 작성 지원 창에 프롬프트를 입력합니다. 예를 들어 add a row to table singers이고 생성을 클릭합니다.

   Gemini는 다음과 유사한 SQL을 생성합니다.

   INSERT INTO Singers (SingerId, FirstName, LastName, BirthDate)
   VALUES (1, Alex, 'M.', '1977-10-16');
   

   참고: Gemini는 개발자가 같은 프롬프트를 입력할 때마다 다른 구문을 제안할 수 있습니다.

8. 생성된 SQL을 검토하고 다음 작업 중 하나를 수행합니다.

   • Gemini에서 생성한 SQL을 수락하려면 삽입을 클릭하여 문을 쿼리 편집기에 삽입합니다. 그런 다음 실행을 클릭하여 추천 SQL을 실행합니다.
   • Gemini에 새 쿼리를 생성하라고 요청하려면 수정을 클릭합니다. 프롬프트를 수정한 후 업데이트를 클릭합니다. 그런 다음 새로 생성된 문을 수락하거나 추천을 닫을 수 있습니다.
   • 추천을 닫으려면 코드 작성 지원 창을 닫습니다.

쿼리 편집기에서 SQL 문 설명

Spanner에서 Gemini를 사용하여 자연어로 SQL 쿼리를 설명할 수 있습니다. 이 설명은 복잡하거나 긴 쿼리에 대한 구문, 기본 스키마, 비즈니스 컨텍스트를 이해하는 데 도움이 될 수 있습니다.

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

   Spanner로 이동

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

3. 데이터베이스를 선택합니다.

4. 탐색창에서 Spanner 스튜디오를 클릭합니다.

5. 데이터베이스를 쿼리하려면 새 탭을 클릭합니다.

6. 쿼리 편집기에서 쿼리를 붙여넣습니다.

7. Gemini에서 설명할 쿼리를 강조표시한 후 spark 이 쿼리 설명을 클릭합니다.

   SQL 설명이 Gemini 창에 표시됩니다.

다음 단계

• Google Cloud용 Gemini 개요 읽어보기
• Gemini에서 데이터를 사용하는 방법 알아보기