BigQuery에 연결

이 문서에서는 BigQuery 데이터에 연결되는 데이터 스토어를 만드는 방법을 설명합니다. 이 데이터 스토어를 Gemini Enterprise 앱에 연결하여 에이전트가 데이터를 분석하도록 허용할 수 있습니다.

Gemini Enterprise 데이터 스토어를 사용하여 BigQuery 데이터에 연결하려면 다음 모드 중 하나를 사용하면 됩니다.

  • 페더레이션 쿼리 (권장) [미리보기]: 데이터를 복사하고 이동하는 이그레스 비용을 발생시키지 않고 BigQuery 데이터에 연결합니다. 페더레이션 쿼리는 ID에 액세스할 수 있는 Identity and Access Management (IAM) 권한이 있는 모든 데이터 세트와 테이블에서 BigQuery로 쿼리를 직접 전송하므로 분석 쿼리에 더 효율적입니다. 사용자의 사용자 인증 정보를 사용하여 쿼리가 실행되므로 행 수준 보안을 포함한 BigQuery IAM 권한이 그대로 유지됩니다. 페더레이션 쿼리 모드를 사용하면 Gemini Enterprise 앱의 어시스턴트 탭에서 Knowledge Catalog가 자동으로 사용 설정되어 에이전트에게 사용자가 액세스할 수 있는 데이터를 검색하고 컨텍스트를 조회하는 도구가 제공됩니다.
  • 데이터 수집: 특정 BigQuery 테이블에서 Gemini Enterprise 데이터 스토어로 데이터를 복사합니다. BigQuery 테이블의 변경사항을 반영하려면 데이터를 새로고침해야 합니다. 이 모드에서는 데이터를 새 위치로 이동하는 데 출구 비용이 발생하며 기존 IAM 권한이 데이터 스토어로 복제되지 않습니다.

시작하기 전에

Gemini Enterprise에서 BigQuery 데이터 스토어를 만들려면 Gemini Enterprise 관리자(roles/discoveryengine.agentspaceAdmin) 또는 Discovery Engine 관리자(roles/discoveryengine.admin) 역할이 있어야 합니다. 자세한 내용은 관리자에게 권한 부여를 참고하세요.

프로젝트가 VPC 서비스 제어 경계로 보호되거나 조직 정책 시행이 사용 설정된 경우 조직 정책에서 커넥터를 허용하는지 확인하세요.

또한 사용할 커넥터 모드에 필요한 BigQuery IAM 권한을 구성합니다.

페더레이션 쿼리

페더레이션 쿼리 모드는 BigQuery MCP 서버를 사용합니다. MCP 도구 (작업)마다 다른 권한이 필요하므로 필요한 IAM 권한은 사용하는 도구에 따라 다릅니다. 자세한 내용은 BigQuery MCP 문서의 필요한 역할을 참고하세요.

다음은 커넥터를 통해 쿼리하거나 작업을 실행하는 사용자에게 가장 일반적으로 적용되는 IAM 역할입니다.

데이터 수집

생성 중인 Gemini Enterprise 데이터 스토어가 포함된 Google Cloud 프로젝트와 다른 소스 Google Cloud 프로젝트의 데이터를 수집하려면 소스 BigQuery 프로젝트에서 service-PROJECT_NUMBER@gcp-sa-discoveryengine.iam.gserviceaccount.com 서비스 계정 (여기서 PROJECT_NUMBER은 Gemini Enterprise 데이터 스토어가 포함된Google Cloud 프로젝트의 프로젝트 번호)에 다음 IAM 역할을 부여하세요.

BigQuery 데이터 스토어 만들기

BigQuery의 데이터를 Gemini Enterprise에 연결하는 데이터 스토어를 만들려면 다음 단계를 따르세요.

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

    Gemini Enterprise

  2. 데이터 스토어 페이지로 이동합니다.

  3. 데이터 저장소 만들기를 클릭합니다.

  4. 소스 페이지에서 데이터 스토어의 데이터 소스를 선택합니다. 데이터 소스 선택 검색 필드에서 'BigQuery'를 검색하거나 퍼스트 파티 데이터 소스 목록에서 BigQuery를 찾습니다. 데이터 소스 추가를 선택합니다.

  5. 데이터 페이지에서 데이터에 연결하는 방법을 위한 커넥터 모드를 선택합니다. 선택한 모드에 따라 다음 탭에서 자세한 안내를 확인하세요.

    페더레이션 쿼리

    1. 페더레이션 쿼리 (권장)를 선택합니다.
    2. 선택적으로 고급 옵션에서 결제 프로젝트 ID 필드에 프로젝트 ID를 입력하여 데이터 스토어의 쿼리 실행을 위한 Google Cloud 결제 프로젝트를 지정합니다. 이 필드를 비워 두면 쿼리에서 사용자에게 결제 프로젝트를 묻거나 맞춤 안내를 사용합니다.
    3. 계속을 클릭합니다.
    4. 작업 페이지에서 데이터 스토어에 사용 설정할 BigQuery 작업을 선택합니다. 이 설정은 나중에 수정할 수 있습니다. 계속을 클릭합니다.

    데이터 수집

    1. 데이터 수집을 선택합니다.
    2. 가져올 데이터의 유형을 확인합니다. 데이터를 가져오기 전에 수집할 데이터 준비를 검토하세요.
      • 구조화된 데이터를 가져오는 경우 자체 스키마가 있는 BigQuery 테이블 또는 메타데이터가 있는 BigQuery 테이블 중에서 선택합니다. 자체 스키마를 사용하는 경우 가져오기 중에 스키마가 자동으로 감지됩니다. 메타데이터를 사용하는 경우 가져오기 중에 Google 지정 스키마를 정의해야 합니다.
      • 특수 처리가 필요한 데이터를 가져오는 경우 특수 데이터 가져오기에서 옵션을 선택합니다.

    3. 동기화 빈도에서 BigQuery 테이블에서 데이터를 가져올 빈도를 선택합니다. 데이터 스토어가 생성된 후에는 이 옵션을 변경할 수 없습니다.

      • 한 번 가져오려면 한 번을 선택합니다.
      • 주기적을 선택하여 반복 가져오기 일정을 설정합니다.

    4. 가져올 데이터 표를 선택합니다. BigQuery 경로 필드에서 찾아보기를 클릭하고 수집을 위해 준비한 테이블을 선택한 다음 선택을 클릭합니다. 또는 BigQuery 경로 필드에 테이블 위치를 직접 입력해도 됩니다.

    5. 계속을 클릭합니다.

    데이터 스토어를 만든 후 데이터 스토어 페이지로 이동하여 데이터 스토어 이름을 클릭한 후 데이터 페이지에서 세부정보를 확인하여 수집 상태를 확인할 수 있습니다. 활동 탭의 상태 열이 진행 중에서 가져오기 완료됨으로 변경되면 수집이 완료된 것입니다.

    데이터 크기에 따라 수집에 몇 분부터 몇 시간까지 걸릴 수 있습니다.

  6. 구성 페이지에서 데이터 스토어 설정을 구성합니다.

    • 데이터 커넥터 위치: 데이터 스토어의 메타데이터를 저장할 리전을 선택합니다. 데이터 스토어를 만든 후에는 위치를 변경할 수 없습니다. 멀티 리전에 대한 중요한 정보는 Gemini Enterprise 위치를 참고하세요.
    • 데이터 커넥터 이름: 데이터 커넥터 이름 필드에 데이터 커넥터의 이름을 입력합니다. 데이터 커넥터를 만든 후에는 이름을 변경할 수 없습니다. 이름을 입력하면 데이터 커넥터의 고유 ID가 생성됩니다. 원하는 경우 태그 (선택사항) 필드에 데이터 커넥터의 태그를 입력합니다. 이 태그는 모든 버전에서 커넥터의 안정적인 식별자 역할을 합니다.
    • 민감한 정보 보호 정책: 데이터 스토어의 민감한 정보 보호 정책을 선택합니다. 형식은 projects/{project}/locations/{location}/contentPolicies/{policy}을 따라야 합니다. 이 설정은 나중에 수정할 수 있습니다.

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

이제 데이터 스토어를 Gemini Enterprise 앱에 연결할 수 있습니다. 페더레이션 쿼리 모드에서는 사용자가 연결된 앱을 통해 쿼리를 실행할 때 BigQuery 컴퓨팅 비용이 발생합니다. 데이터 수집 모드에서는 데이터 스토어가 앱에 연결되기 전에도 데이터를 가져오면 BigQuery 및 Gemini Enterprise 색인 생성 비용이 발생합니다. 이러한 요금에 대해 자세히 알아보려면 Gemini Enterprise 가격 책정을 참고하세요.

다음 단계