Spanner에 연결

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

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

  • 페더레이션 쿼리 (권장) [미리보기]: 데이터를 복사하고 이동하는 데 드는 이그레스 비용 없이 Spanner 데이터에 바로 연결합니다. 페더레이션 쿼리는 ID에 액세스할 수 있는 Identity and Access Management (IAM) 권한이 있는 모든 데이터베이스와 테이블에 쿼리를 직접 전송하므로 분석 쿼리에 더 효율적입니다. 페더레이션 쿼리 모드를 사용하면 Gemini Enterprise 앱의 어시스턴트 탭에서 Knowledge Catalog가 자동으로 사용 설정되어 에이전트에게 사용자가 액세스할 수 있는 데이터를 검색하고 컨텍스트를 조회하는 도구가 제공됩니다.

  • 데이터 수집: 특정 Spanner 테이블에서 Gemini Enterprise 데이터 스토어로 데이터를 복사합니다. Spanner 테이블의 변경사항을 반영하려면 데이터를 수동으로 새로고침해야 합니다. 이 모드에서는 데이터를 새 위치로 이동하는 데 이그레스 비용이 발생하며 기존 IAM 권한이 데이터 스토어로 복제되지 않습니다.

시작하기 전에

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

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

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

페더레이션 쿼리

연결된 쿼리 모드를 사용하여 Spanner에 연결하려면 Spanner 데이터베이스가 포함된Google Cloud 프로젝트에서 커넥터를 통해 쿼리하거나 작업을 실행하는 사용자에게 다음 IAM 역할을 부여하세요.

데이터 수집

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

Spanner 데이터 스토어 만들기

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

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

    Gemini Enterprise

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

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

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

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

    페더레이션 쿼리

    1. 페더레이션 쿼리 (권장)를 선택합니다. 계속을 클릭합니다.
    2. 작업 페이지에서 데이터 스토어에 사용 설정할 Spanner 작업을 선택합니다. 이 설정은 나중에 수정할 수 있습니다. 계속을 클릭합니다.

    데이터 수집

    1. 데이터 수집을 선택합니다.

    2. 가져올 데이터에 대한 세부정보를 지정합니다. Spanner 테이블에서 데이터 가져오기에서 다음 정보를 지정합니다.

      • 프로젝트 ID: Spanner 테이블이 포함된 Google Cloud 프로젝트입니다. 필수 입력란입니다.
      • 인스턴스 ID: 가져올 데이터가 포함된 Spanner 인스턴스 ID입니다. 필수 입력란입니다.
      • 데이터베이스 ID: 가져올 데이터가 포함된 Spanner 데이터베이스 ID입니다. 필수 입력란입니다.
      • 표 ID: 가져올 데이터가 포함된 Spanner 표 ID입니다. 필수 입력란입니다.

      선택사항으로 Data Boost 사용 설정을 선택하여 Spanner Data Boost를 사용하여 쿼리를 더 빠르게 실행할 수 있습니다. Data Boost를 사용 설정하면 추가 비용이 발생합니다. Spanner Data Boost 결제 및 할당량을 참고하세요.

    3. 계속을 클릭합니다.

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

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

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

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

다음 단계