Gemini 지원으로 SQL 작성

이 문서에서는 Bigtable에서 자연어 프롬프트를 사용하여 SQL 쿼리를 생성하는 데 AI 기반 지원을 받는 방법을 설명합니다.

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

이 문서는 Bigtable, SQL, 데이터 분석에 익숙한 데이터베이스 관리자와 데이터 엔지니어를 대상으로 합니다. Bigtable을 처음 사용하는 경우 빠른 시작: Google Cloud 콘솔을 사용하여 Bigtable 인스턴스 만들기를 참고하세요.

제한사항

  • Bigtable에서 Gemini를 사용하여 SQL 쿼리를 자연어로 설명할 수는 없습니다.

  • Bigtable의 Gemini는 Bigtable용 GoogleSQL에서 유효하지 않은 쿼리 또는 지원되지 않는 다음 문이나 구문을 사용하는 쿼리를 생성할 수 있습니다.

    • SELECT 이외의 데이터 조작 언어(DML) 문(예: INSERT, UPDATE, DELETE)
    • 데이터 정의 언어(DDL) 문(예: CREATE, ALTER, DROP)
    • 데이터 액세스 제어 문입니다.
    • 서브 쿼리, JOIN, UNION, CTE의 쿼리 구문

    자세한 내용은 Bigtable용 GoogleSQL 개요를 참고하세요.

시작하기 전에

  1. Google Cloud 프로젝트에서 Gemini for Google Cloud API를 사용 설정합니다.

  2. 이 문서의 태스크를 완료하려면 필요한 Identity and Access Management(IAM) 권한이 있는지 확인합니다.

  3. 선택사항: 이 문서의 예시를 따라 하려면 테스트 테이블 만들기에 설명된 대로 test-table를 만들고 채웁니다.

필요한 역할

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

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

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

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

  • '1GB 데이터 요금제를 사용하는 기기 수를 세어 줘.'
  • '2019년 5월 1일에 Wi-Fi에 연결된 모든 휴대전화를 나열해 줘.'
  • '10GB 데이터 요금제가 사용 설정된 태블릿은 무엇인가요?'

Gemini를 사용하여 Bigtable에서 SQL을 생성하려면 다음 단계를 따르세요.

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

    Bigtable로 이동

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

  3. 탐색창에서 Bigtable Studio를 클릭합니다.

  4. 를 클릭한 후 편집기를 선택하여 새 탭을 엽니다.

  5. SQL 생성을 클릭합니다.

  6. 코딩 도우미 대화상자에 프롬프트를 입력한 다음 생성을 클릭합니다.

    예를 들어 Count the number of devices that have a 1GB data plan. 프롬프트를 입력하면 Gemini가 다음과 유사한 SQL을 생성합니다.

    SELECT
    count(*)
FROM
    `test_table`
WHERE
    cell_plan['data_plan_01gb'] = 'true'

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

    • 추천 SQL을 실행하려면 삽입을 클릭한 다음 실행을 클릭합니다.
    • 프롬프트를 수정하려면 수정을 클릭한 다음 업데이트를 클릭합니다.
    • 추천 SQL을 수정하려면 삽입을 클릭합니다. 쿼리 빌더에서 쿼리를 수동으로 수정하고 실행을 클릭합니다.

  8. 선택사항: test_table 예시를 계속 진행하려면 Show all data for phones from May 2019. 프롬프트를 입력하면 Gemini가 다음과 유사한 SQL을 생성합니다.

    SELECT
    *
FROM
    `test_table`
WHERE
    _key LIKE 'phone#%#201905%'

다음 단계