Spanner에 연결

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

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

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

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

시작하기 전에

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

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

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

페더레이션 쿼리

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

데이터 수집

만들려는 Gemini Enterprise 데이터 스토어가 포함된 Google Cloud 프로젝트와 다른 source Google Cloud project에서 데이터를 수집하려면 소스 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 가격 책정을 참조하세요.

다음 단계