Spanner Studio에서 컨텍스트 세트 관리

컨텍스트 엔지니어링 에이전트를 사용하면 CLI에서 컨텍스트 세트를 자동으로 만들고 업로드할 수 있습니다. 이 문서에서는 Google Cloud 콘솔에서 시각적 인터페이스를 사용하여 컨텍스트 세트 파일을 관리하려는 경우 Spanner Studio에서 컨텍스트 세트를 만들고, 수정하고, 삭제하는 방법을 설명합니다. Spanner Studio에서 컨텍스트 세트를 만들면 Spanner Studio는 선택한 리전의 프로젝트 default 컨텍스트 세트 그룹에 이를 저장하고 현재 데이터베이스에 연결합니다. 컨텍스트 세트 이름(및 파생된 컨텍스트 세트 ID)은 지정된 리전의 프로젝트 default 컨텍스트 세트 그룹 내에서 모든 데이터베이스와 인스턴스에 걸쳐 고유해야 합니다. Spanner Studio에서 파생 ID가 이미 존재하는 이름으로 컨텍스트 세트를 만들면 유효성 검사에 실패합니다. 데이터베이스 연결을 유지하면서 콘텐츠를 덮어쓰려면 기존 컨텍스트 세트를 수정하세요. 컨텍스트 엔지니어링 에이전트 또는 Dataplex API를 통해 기존 컨텍스트 세트 ID로 직접 업로드하면 콘텐츠와 지정된 경우 데이터베이스 연결이 대체됩니다.

Spanner Studio의 컨텍스트 세트 목록에는 현재 데이터베이스에 연결된 모든 지원되는 리전의 default 컨텍스트 세트 그룹에 있는 컨텍스트 세트만 표시됩니다. 다른 데이터베이스에 대해 생성되었거나 databases(또는 커스텀 컨텍스트 세트 그룹)에서 데이터베이스 리소스를 연결하지 않고 API를 통해 생성된 컨텍스트 세트는 Spanner Studio 목록에 표시되지 않습니다.

컨텍스트 세트에 대한 자세한 내용은 컨텍스트 세트 개요를 참조하세요.

시작하기 전에

컨텍스트 세트를 만들거나 업로드하기 전에 다음 기본 요건을 완료하세요.

컨텍스트 세트는 us-central1, us-east1, europe-west4, asia-southeast1 리전에서 만들 수 있습니다.

필수 서비스 사용 설정

프로젝트에 다음 서비스를 사용 설정합니다.

Spanner 인스턴스 준비

필수 역할 및 권한

  • 인스턴스에 IAM 사용자 또는 서비스 계정을 추가합니다. 자세한 내용은 IAM 역할 적용을 참조하세요.
  • 프로젝트 수준에서 IAM 사용자에게 roles/spanner.databaseReader, roles/serviceusage.serviceUsageConsumer, roles/geminidataanalytics.queryDataUser 역할을 부여합니다. 자세한 내용은 프로젝트에 IAM 정책 바인딩 추가를 참조하세요.
  • 컨텍스트 세트를 만들고, 업로드하고, 관리하려면 프로젝트 수준에서 IAM 사용자에게 Dataplex 카탈로그 편집자(roles/dataplex.catalogEditor) 또는 Dataplex 카탈로그 관리자(roles/dataplex.catalogAdmin) 역할을 부여합니다. 자세한 내용은 컨텍스트 세트 권한을 참고하세요.
  • 필요한 데이터베이스의 프로젝트 수준에서 IAM 사용자에게 역할 및 권한을 부여합니다.

컨텍스트 세트 만들기

컨텍스트 세트를 만들려면 다음 단계를 수행합니다.

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

    Spanner로 이동

  2. 목록에서 인스턴스를 선택한 후 데이터베이스를 선택합니다.

  3. 탐색 메뉴에서 Spanner 스튜디오를 클릭합니다.

  4. 탐색기 창에서 컨텍스트 세트 옆에 있는 작업 보기를 클릭합니다.

  5. 컨텍스트 세트 만들기를 클릭합니다.

  6. 컨텍스트 세트 이름에 고유한 컨텍스트 세트 이름을 입력합니다. Spanner Studio에서 이름은 4~30자(영문 기준)여야 하며 공백으로 시작할 수 없습니다. Studio는 이름을 소문자로 변환하고 영숫자 문자가 아닌 문자를 하이픈(-)으로 바꿔 컨텍스트 세트 ID를 파생하며, 파생된 컨텍스트 세트 ID는 선택한 리전의 프로젝트 default 컨텍스트 세트 그룹 내에서 고유해야 합니다. 예를 들어 컨텍스트 세트 이름 querydata_e2e_test에는 컨텍스트 세트 ID querydata-e2e-test가 있습니다. 컨텍스트 엔지니어링 에이전트 또는 Dataplex API를 사용하여 컨텍스트 세트를 직접 업로드하는 경우 컨텍스트 세트 ID는 대소문자를 구분하고 슬래시(/)를 포함할 수 없으며 4~30자(영숫자 문자, 하이픈, 밑줄)로 제한되지 않습니다.

  7. (선택사항) 컨텍스트 세트 설명에 컨텍스트 세트에 대한 설명을 추가합니다.

  8. (선택사항) 컨텍스트 세트 파일을 업로드하려면 컨텍스트 세트 파일 업로드 섹션에서 찾아보기를 클릭하고 컨텍스트 세트 파일을 선택합니다.

  9. (선택사항) 컨텍스트 세트의 리전을 선택하려면 고급 옵션 표시를 클릭하고 위치 선택에서 리전을 선택합니다(생성할 때마다 기본값은 us-east1). us-east1 이외의 리전을 선택하는 경우 컨텍스트 세트 이름을 입력하기 전에 리전을 선택하여 Spanner Studio가 해당 리전에서 이름 고유성을 검증하도록 합니다.

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

빌드 컨텍스트 세트

Studio에서 빈 컨텍스트 세트를 만들었거나 기존 컨텍스트 세트를 업데이트하려면 컨텍스트 엔지니어링 에이전트로 컨텍스트 세트 빌드 및 최적화의 단계에 따라 컨텍스트 세트 파일을 생성하고 최적화합니다. 컨텍스트 엔지니어링 에이전트는 CLI에서 직접 컨텍스트 세트를 만들고 업로드할 수 있습니다. 또는 Studio에서 컨텍스트 세트를 수정하여 컨텍스트 세트 파일을 수동으로 업로드할 수 있습니다.

컨텍스트 세트 수정

컨텍스트 세트를 수정하려면 다음 단계를 수행합니다.

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

    Spanner로 이동

  2. 목록에서 인스턴스를 선택한 후 데이터베이스를 선택합니다.

  3. 탐색 메뉴에서 Spanner 스튜디오를 클릭합니다.

  4. 수정하려는 컨텍스트 세트 옆에 있는 작업 보기를 클릭합니다.

  5. 컨텍스트 세트 수정을 클릭합니다.

  6. (선택사항) 컨텍스트 세트 설명을 수정합니다.

  7. 컨텍스트 세트 파일 업로드 섹션에서 찾아보기를 클릭하고 컨텍스트 세트 파일을 선택합니다.

  8. 저장을 클릭합니다.

컨텍스트 세트 삭제

컨텍스트 세트를 삭제하려면 다음 단계를 수행합니다.

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

    Spanner로 이동

  2. 목록에서 인스턴스를 선택한 후 데이터베이스를 선택합니다.

  3. 탐색 메뉴에서 Spanner 스튜디오를 클릭합니다.

  4. 삭제하려는 컨텍스트 세트 옆에 있는 작업 보기를 클릭합니다.

  5. 컨텍스트 세트 삭제를 클릭합니다.

  6. 컨텍스트 세트 삭제 확인 대화상자에서 컨텍스트 세트의 ID를 입력합니다.

  7. 확인을 클릭하여 컨텍스트 세트를 삭제합니다.

다음 단계