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 프로젝트에 대한 다음 IAM 역할을 service-PROJECT_NUMBER@gcp-sa-discoveryengine.iam.gserviceaccount.com 서비스 계정에 부여합니다 (여기서 PROJECT_NUMBER는 Gemini Enterprise 데이터 스토어가 포함된Google Cloud 프로젝트의 프로젝트 번호임).

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가 생성됩니다. 원하는 경우 태그 (선택사항) 필드에 데이터 커넥터의 태그를 입력합니다. 이 태그는 모든 버전에서 커넥터의 고정 식별자 역할을 합니다.
    • Sensitive Data Protection 정책: 데이터 스토어의 Sensitive Data Protection 정책을 선택합니다. 형식은 projects/{project}/locations/{location}/contentPolicies/{policy}이어야 합니다. 이 설정은 나중에 수정할 수 있습니다.

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

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

다음 단계