Gemini 지원을 받아 쿼리 작성

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

AI 기반 지원을 제공하는 Google Cloud를 위한 Gemini를 사용하여 SQL 쿼리 및 Python 코드로 데이터를 쿼리할 수 있습니다. BigQuery의 Gemini는 쿼리를 생성하고, 입력하는 동안 코드를 완성하고, 쿼리를 설명할 수 있습니다.

Google Cloud를 위한 Gemini는 사용자의 명시적 허가 없이 사용자의 프롬프트나 프롬프트에 대한 응답을 모델을 학습시키기 위한 데이터로 사용하지 않습니다. Google에서 사용자 데이터를 사용하는 방법에 관한 자세한 내용은 Google Cloud용 Gemini에서 데이터를 사용하는 방법을 참고하세요. 프리뷰 중인 BigQuery의 Gemini 기능에 대한 데이터 공유를 선택하려면 추천 개선에 참여하기를 참고하세요.

BigQuery에서는 Gemini에 영어 프롬프트만 지원됩니다.

이 문서는 SQL 쿼리와 BigQuery의 Colab Enterprise 노트북을 사용하는 데이터 분석가, 데이터 과학자, 데이터 개발자를 대상으로 합니다. 여기서는 BigQuery SQL 작업공간에서 데이터를 쿼리하는 방법이나 노트북을 사용하여 Python으로 BigQuery 데이터를 분석하는 방법을 알고 있다고 가정합니다.

시작하기 전에

1. Gemini가 Google Cloud 프로젝트에 설정되어 있는지 확인합니다. 설정이 완료될 때까지는 BigQuery의 Gemini 기능이 사용 중지되거나 사용할 수 없을 수 있습니다. 이 단계는 일반적으로 관리자가 실행합니다.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

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

   BigQuery로 이동

4. 툴바에서 pen_sparkGemini 드롭다운 아이콘을 클릭합니다.

   

5. 기능의 드롭다운 목록에서 사용 설정할 기능을 선택합니다. 사용 가능한 기능은 다음과 같습니다.

   • SQL 쿼리의 Gemini:
     • 자동 완성(미리보기): 쿼리 편집기에서 입력하면 Gemini가 현재 쿼리의 컨텍스트와 관련된 논리적인 다음 단계를 제안하거나 쿼리를 반복하는 데 도움을 줄 수 있습니다.
     • 자동 생성: BigQuery 쿼리 편집기에서 자연어 주석을 사용하여 BigQuery의 Gemini에 프롬프트를 입력하여 SQL 쿼리를 생성할 수 있습니다.
     • SQL 생성 도구: 도구에 자연어 텍스트를 입력하여 SQL 쿼리를 생성할 수 있으며, 쿼리 결과를 미세 조정하고, 테이블 소스를 선택하고, 결과를 비교하는 옵션이 있습니다.
     • 설명: BigQuery에서 SQL 쿼리를 자연어로 설명하도록 Gemini에 프롬프트를 입력할 수 있습니다.
   • Python 노트북의 Gemini:
     • 코드 완성(미리보기): Gemini는 노트북의 콘텐츠를 기반으로 상황에 따라 적절한 추천을 제공합니다.
     • 코드 생성: 자연어 문이나 Python 코드 생성에 대한 질문으로 Gemini에 프롬프트를 입력할 수 있습니다.

필수 권한

Gemini 지원을 사용하여 쿼리를 작성하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Cloud AI 컴패니언 사용자(roles/cloudaicompanion.user) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 Gemini 지원을 사용하여 쿼리를 작성하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

Gemini 지원을 사용하여 쿼리를 작성하려면 다음 권한이 필요합니다.

• cloudaicompanion.companions.generateCode
• cloudaicompanion.entitlements.get
• cloudaicompanion.instances.completeTask
• SQL 쿼리 설명하기: cloudaicompanion.companions.generateChat
• Python 코드 완성하기: cloudaicompanion.instances.completeCode
• Python 코드 생성하기: cloudaicompanion.instances.generateCode

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

SQL 쿼리 생성

데이터의 스키마를 기반으로 SQL 쿼리를 생성하려면 Gemini에 자연어 문구 또는 질문(프롬프트라고도 함)을 제공하면 됩니다. 코드 없이 시작하거나 데이터 스키마에 대한 지식이 부족하거나 Google SQL 문법에 대한 기본 지식만 있더라도 Gemini는 데이터를 탐색하는 데 도움이 되는 SQL을 생성할 수 있습니다.

SQL 생성 도구 사용

SQL 생성 도구를 사용하면 자연어를 사용하여 최근에 보거나 쿼리한 테이블에 관한 SQL 쿼리를 생성할 수 있습니다. 이 도구를 사용하여 기존 쿼리를 수정하고 SQL을 생성할 테이블을 수동으로 지정할 수도 있습니다.

SQL 생성 도구를 사용하려면 다음 단계를 따르세요.

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

   BigQuery로 이동

2. 쿼리 편집기 옆에 있는 SQL 생성 도구 pen_spark를 클릭합니다.

   

3. 쿼리 편집기 왼쪽에 있는 pen_spark SQL 생성 도구 아이콘을 클릭하여 도구를 엽니다.

4. SQL 생성 도구에서 최근에 보거나 쿼리한 테이블에 관해 질문하거나 자연어 프롬프트를 입력합니다. 예를 들어 bigquery-public-data.austin_bikeshare.bikeshare_trips 테이블을 확인한 다음 다음을 입력할 수 있습니다.

    Show me the duration and subscriber type for the ten longest trips
   

5. 생성을 클릭합니다.

   Gemini에서 다음과 유사한 SQL 쿼리를 생성합니다.

   SELECT
       subscriber_type,
       duration_sec
     FROM
         `bigquery-public-data.san_francisco_bikeshare.bikeshare_trips`
   ORDER BY
       duration_sec DESC
   LIMIT 10;
   

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

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

   • 생성된 SQL 쿼리를 수락하려면 삽입을 클릭하여 문을 쿼리 편집기에 삽입합니다. 그런 다음 실행을 클릭하여 추천 SQL 쿼리를 실행할 수 있습니다.
   • 프롬프트를 수정하려면 수정을 클릭한 다음 초기 프롬프트를 수정하거나 대체합니다. 프롬프트를 수정한 후 업데이트를 클릭하여 새 쿼리를 확인합니다.
   • 추천 SQL 쿼리를 생성하는 컨텍스트로 사용된 테이블 소스를 업데이트하려면 테이블 소스 수정을 클릭하고 체크박스를 선택하여 테이블 소스를 선택한 후 적용을 클릭합니다.
   • 생성된 쿼리의 자연어 요약을 보려면 쿼리 요약을 클릭합니다.
   • 추천된 SQL 쿼리를 세분화하려면 세분화 텍스트 상자에 세분화 내용을 입력한 다음 보내기를 클릭하여 쿼리를 세분화합니다. 예를 들어 limit to 1000을 입력하여 쿼리 결과 수를 제한합니다. 쿼리의 변경사항을 비교하려면 비교 표시 체크박스를 선택합니다.
   • 생성된 쿼리를 삽입하지 않고 추천을 닫으려면 SQL 생성 도구를 닫습니다.

SQL 생성 도구 사용 중지

SQL 생성 도구를 사용 중지하는 방법을 알아보려면 Gemini 기능 사용 중지를 참고하세요.

주석에서 SQL 생성

주석에 원하는 쿼리를 설명한 다음 Enter 키를 눌러 다음 줄로 이동하면 SQL 편집기에서 SQL을 생성할 수 있습니다.

다음 예시에서는 BigQuery 공개 테이블 bigquery-public-data.austin_bikeshare.bikeshare_trips에 대한 쿼리를 생성합니다.

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

   BigQuery Studio로 이동

   나머지 단계는 Google Cloud 콘솔에 표시됩니다.

2. SQL 쿼리 편집기에서 새 쿼리 작성을 클릭합니다.

   

3. 쿼리 편집기에서 최근에 보거나 쿼리한 테이블에 관한 SQL 주석을 작성합니다. 예를 들어 bigquery-public-data.austin_bikeshare.bikeshare_trips 테이블을 확인한 다음 다음과 같은 주석을 작성할 수 있습니다.

   # Show me the duration and subscriber type for the ten longest trips
   

4. Enter(macOS에서는 Return) 키를 누릅니다.

   Gemini는 다음과 유사한 SQL 쿼리를 제안합니다.

   # Show me the duration and subscriber type for the ten longest trips
   
   SELECT
     duration_sec,
     subscriber_type
     AVG(duration_minutes) AS average_trip_length
   FROM
     `bigquery-public-data.austin_bikeshare.bikeshare_trips`
   ORDER BY
     duration_sec
   LIMIT 10;
   

5. 제안된 내용을 사용하려면 Tab 키를 누르세요.

SQL 생성 팁

다음 팁은 BigQuery의 Gemini에서 제공하는 추천을 개선할 수 있습니다.

• 사용할 테이블을 수동으로 지정하려면 정규화된 테이블 이름을 백틱(`)으로 묶어 포함합니다(예: `PROJECT.DATASET.TABLE`).
• 열 이름 또는 시맨틱스 관계가 명확하지 않거나 복잡한 경우 프롬프트에 컨텍스트를 제공하여 Gemini가 개발자가 원하는 답변을 제공하도록 안내할 수 있습니다. 예를 들어 생성된 쿼리가 열 이름을 참조하도록 하려면 열 이름과 원하는 답변과의 관련성을 설명합니다. 평생 가치 또는 총이익과 같이 복잡한 용어를 참조하는 답변을 유도하려면 개념 및 데이터와의 관련성을 설명하여 SQL 생성 결과를 향상시킵니다.
• 주석에서 SQL을 생성할 때 각 줄 앞에 # 문자를 붙여 여러 줄에 걸쳐 프롬프트 형식을 지정할 수 있습니다.
• 열 설명은 SQL 쿼리를 생성할 때 고려됩니다. 정확성을 개선하려면 스키마에 열 설명을 추가하세요. 열 설명에 관한 자세한 내용은 스키마 지정 시 열 설명을 참조하세요.

Gemini 및 BigQuery 데이터

BigQuery의 Gemini는 개발자에게 액세스 권한이 있는 테이블의 메타데이터에 액세스할 수 있습니다. 여기에는 테이블 이름, 열 이름, 데이터 유형, 열 설명이 포함될 수 있습니다. BigQuery의 Gemini는 테이블, 뷰 또는 모델의 데이터에 액세스할 수 없습니다. Gemini에서 데이터를 사용하는 방법에 대한 자세한 내용은 Google Cloud용 Gemini가 데이터를 사용하는 방법을 참조하세요.

SQL 쿼리 작성

미리보기

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

SQL 작성은 쿼리 편집기의 콘텐츠를 기반으로 상황에 따라 적절한 권장사항을 제공하려고 시도합니다. 입력과 동시에 Gemini는 현재 쿼리의 컨텍스트와 관련된 논리적인 다음 단계를 제안하거나 쿼리를 반복하는 데 도움을 줄 수 있습니다.

Gemini에서 SQL 완성을 사용해 보려면 다음 단계를 수행합니다.

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

   BigQuery Studio로 이동

   나머지 단계는 Google Cloud 콘솔에 표시됩니다.

2. 쿼리 편집기에서 다음을 복사합니다.

   SELECT
     subscriber_type
     , EXTRACT(HOUR FROM start_time) AS hour_of_day
     , AVG(duration_minutes) AS avg_trip_length
   FROM
     `bigquery-public-data.austin_bikeshare.bikeshare_trips`
   

   subscriber_type이 그룹화되거나 집계되지 않았다는 오류 메시지가 표시됩니다. 올바른 쿼리를 위해 도움이 필요한 경우가 많습니다.

3. Enter(macOS의 경우 Return) 키 또는 스페이스바를 누릅니다.

   Gemini는 다음과 유사한 텍스트로 끝날 수 있는 쿼리 상세검색을 제안합니다.

   GROUP BY
     subscriber_type, hour_of_day;
   

4. 제안을 수락하려면 Tab 키를 누르거나 추천 텍스트 위에 마우스 포인터를 올려놓고 각 추천 대안을 클릭하세요. 추천 항목을 닫으려면 ESC 키를 누르거나 계속 입력합니다.

SQL 쿼리 설명

BigQuery에서 SQL 쿼리를 자연어로 설명하도록 Gemini에 프롬프트를 입력할 수 있습니다. 이러한 설명은 쿼리의 길이 또는 복잡성으로 인해 문법, 기본 스키마, 비즈니스 컨텍스트를 평가하기 어려울 수 있는 쿼리를 이해하는 데 도움이 될 수 있습니다.

SQL 쿼리 설명

SQL 쿼리를 설명하려면 다음 단계를 따르세요.

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

   BigQuery Studio로 이동

   나머지 단계는 Google Cloud 콘솔에 표시됩니다.

2. 쿼리 편집기에서 설명이 필요한 쿼리를 열거나 붙여넣습니다.

3. Gemini에서 설명할 쿼리를 강조표시한 다음 astrophotography_mode Gemini를 클릭합니다.

   

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

Python 코드 생성

자연어 문이나 Python 코드 생성에 대한 질문으로 Gemini에 프롬프트를 입력할 수 있습니다. Gemini는 Python 코드 추천 하나 이상으로 응답합니다.

Gemini를 사용하여 Python 코드 생성

다음 예시에서는 BigQuery 공개 데이터 세트 bigquery-public-data.ml_datasets.penguins의 코드를 생성합니다.

1. BigQuery Studio 페이지로 이동합니다.

   BigQuery로 이동

2. 편집기 창의 탭 표시줄에서 + 기호 옆에 있는 드롭다운 화살표 를 클릭한 다음 Python 노트북 생성을 클릭합니다.

   bigquery-public-data.ml_datasets.penguins 공개 데이터 세트에 대한 쿼리 예시를 보여주는 셀이 포함된 새 노트북이 열립니다.

3. 툴바에서 + 코드를 클릭하여 새 코드 셀을 삽입합니다. 코딩 시작 또는 AI로 생성이라는 새로운 코드 셀이 표시됩니다.

4. 새 코드 셀에서 생성을 클릭합니다.

5. 코드 편집기에서 다음 자연어 프롬프트를 입력합니다.

   Using bigquery magics query the `bigquery-public-data.ml_datasets.penguins` table
   

6. Enter(macOS에서는 Return) 키를 누릅니다.

   Gemini는 다음과 유사한 Python 코드를 제안합니다.

   %%bigquery
   SELECT *
   FROM `bigquery-public-data.ml_datasets.penguins`
   LIMIT 10
   

7. 코드를 실행하고 Enter 키를 누릅니다.

전체 Python 코드

미리보기

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

Python 코드 완성은 쿼리 편집기의 콘텐츠를 기반으로 상황에 따라 적절한 추천을 제공하려고 합니다. 입력과 동시에 Gemini는 현재 코드 컨텍스트와 관련된 논리적인 다음 단계를 제안하거나 코드를 반복하는 데 도움을 줄 수 있습니다.

Gemini를 사용하여 Python 코드 완성

Gemini에서 Python 코드 완성을 사용해 보려면 다음 단계를 수행합니다.

1. BigQuery Studio 페이지로 이동합니다.

   BigQuery로 이동

2. 편집기 창의 탭 표시줄에서 + 기호 옆에 있는 드롭다운 화살표 를 클릭한 다음 Python 노트북 생성을 클릭합니다. bigquery-public-data.ml_datasets.penguins 공개 데이터 세트에 대한 쿼리 예시를 보여주는 셀이 포함된 새 노트북이 열립니다.

3. 코드 편집기에서 Python 코드를 입력합니다. 예를 들면 %%bigquery입니다. Gemini는 입력하는 동안 코드 인라인을 제안합니다. 제안을 수락하려면 Tab 키를 누릅니다.

Gemini 쿼리 어시스턴트 기능 사용 중지

BigQuery에서 Gemini 기능을 중지하려면 다음을 수행합니다.

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

   BigQuery로 이동

2. 툴바에서 pen_spark Gemini 드롭다운 아이콘을 클릭합니다.

![Gemini button in the BigQuery toolbar.](/bigquery/images/duet-ai-assistant-link.png){: class="screenshot" } 

1. 기능 드롭다운 목록에서 사용 중지하려는 BigQuery 쿼리 어시스턴트의 Gemini 기능을 선택 해제합니다.

   • SQL 쿼리의 Gemini:
     • 자동 완성(프리뷰): 입력하는 동안 Gemini는 현재 쿼리의 컨텍스트와 관련된 논리적인 다음 단계를 제안하거나 쿼리를 반복하는 데 도움을 줄 수 있습니다.
     • 자동 생성: Gemini에 자연어 프롬프트를 제공하여 비즈니스 질문에 답하는 SQL 문법을 생성할 수 있습니다.
     • SQL 생성 도구: 자연어를 사용하여 조직의 데이터를 기반으로 SQL 쿼리 결과를 생성하고 반복합니다.
     • 설명: BigQuery에서 SQL 쿼리를 자연어로 설명하도록 Gemini에 프롬프트를 입력할 수 있습니다.
   • Python 노트북의 Gemini:
     • 코드 완성(프리뷰): Gemini는 쿼리 편집기의 콘텐츠를 기반으로 상황에 따라 적절한 추천을 제공합니다.
     • 코드 생성: 자연어 문이나 Python 코드 생성에 대한 질문으로 Gemini에 프롬프트를 입력할 수 있습니다.

Gemini in BigQuery 기능을 사용 중지하는 방법을 알아보려면 Gemini 제품 사용 중지를 참고하세요.

의견 보내기

Gemini의 추천에 대해 의견을 제공할 수 있습니다.

• 의견을 제공하려면 툴바에서 Gemini pen_spark를 선택한 후 의견 보내기를 선택합니다.

추천 개선 도움말

프리뷰의 기능에 제출한 프롬프트 데이터를 Google과 공유하여 Gemini 추천을 개선할 수 있습니다. 프롬프트 데이터를 공유하려면 다음 단계를 수행합니다.

1. Google Cloud 콘솔의 BigQuery Studio 페이지 툴바에서 Gemini pen_spark를 클릭합니다.

2. 데이터를 공유하여 Gemini 개선을 선택합니다.

3. 데이터 사용 설정 대화상자에서 데이터 사용 설정을 업데이트합니다.

데이터 공유 설정은 전체 프로젝트에 적용되며 serviceusage.services.enable 및 serviceusage.services.list IAM 권한이 있는 프로젝트 관리자만 이 설정을 설정할 수 있습니다. 신뢰할 수 있는 테스터 프로그램에서의 데이터 사용에 대한 자세한 내용은 Google Cloud 신뢰할 수 있는 테스터 프로그램의 Gemini를 참조하세요.

가격 책정

이 기능의 가격 책정에 관한 자세한 내용은 BigQuery의 Gemini 가격 책정 개요를 참고하세요.

할당량 및 한도

이 기능의 할당량 및 한도에 대한 자세한 내용은 BigQuery의 Gemini 할당량을 참조하세요.

다음 단계

• Google Cloud용 Gemini에 대한 자세한 내용은 Google Cloud용 Gemini 개요 참조하기
• Gemini 데이터 정책에 대한 자세한 내용은 Google Cloud용 Gemini가 데이터를 사용하는 방법 참조하기