DB Spec Info Guide(KR)

DB Spec Info Guide

Language: English | 한국어

1. CB-Spider DB Spec Info 개요

• 사용자는 DB Engine(mysql, mariadb, postgresql)별로 DB Spec Name을 설정하여 해당 DB Spec의 속성(VCpu, Memory, Storage 크기 범위 등 자원 규모 정보)을 준수하는 DB Instance를 생성 요청할 수 있다.
• CB-Spider가 제공하는 DB Spec 정보는 RDBMS Management Guide의 DB Instance 생성 요청 시 DBSpec 필드 값(예: db.t3.medium)으로 그대로 사용된다.
• 사용자는 추상화된 CB-Spider DB Spec 정보를 활용하여 원하는 DB Instance 사양(CPU 개수, Memory 크기, Storage 크기 범위 등)을 파악한 후 DB Instance 생성을 요청할 수 있다.

2. CB-Spider DB Spec Info API 및 제공 정보 규격

• 사용자는 다음과 같은 CB-Spider REST API를 이용하여 DB Spec 정보를 JSON 규격으로 제공 받는다.

  GET /dbspec            - List DB Specs
  GET /dbspec/{Name}     - Get DB Spec
  GET /dborgspec         - List Original DB Specs
  GET /dborgspec/{Name}  - Get Original DB Spec
  

  • 모든 API는 ConnectionName(Connection 이름)과 DBEngine(mysql | mariadb | postgresql) 쿼리 파라미터를 필수로 요구한다.

• 제공 되는 JSON 결과에 포함된 정보는 다음과 같다.

  속성 명칭	제공 정보	제공 값 예시
  Region	DB Spec을 제공하는 Region Name 정보	● us-east-1, ap-northeast-2 등
  DBEngine	DB Spec이 적용되는 DB 엔진 정보	● mysql, mariadb, postgresql
  Name	CSP가 관리 및 제공하는 DB Spec(인스턴스 클래스/플레이버) Name 정보	● db.t3.medium, db.r5.24xlarge 등
  VCpu	DB Spec으로 생성되는 DB Instance의 CPU 자원 정보, Count(개수)와 ClockGHz(Frequency) 정보로 구성	● {2, 3.1}, {96, 3.1} 등 ● -1: CSP가 값을 제공하지 않거나, 동일 CSP 스펙 이름으로부터 값을 얻을 객관적 근거가 없음
  MemSizeMiB	DB Spec으로 생성되는 DB Instance의 Memory 크기 정보	● 4096, 786432 등 ● -1: CSP가 값을 제공하지 않음
  StorageSizeRangeGB	해당 DB Spec으로 DB Instance 생성 시 요청 가능한 Storage 크기의 Min/Max 범위 정보, DB Spec에 내장된 디스크가 아니라 생성 시점에 선택 가능한 Storage 크기 제약임	● {20, 65536} 등 ● {-1, -1}: 해당 DB Spec 단위의 제약 정보 없음(RDBMSMetaInfo의 StorageSizeRangeGB 값을 따름)
  DataSource DataSourceNotes	각 필드 값이 CSP API로부터 실시간으로 획득한 값(API)인지, 고정/변환 불가 값(Static)인지 나타내는 정보, Static인 경우 그 사유가 DataSourceNotes에 기록됨, 필드에 대한 기재가 없으면 API로 간주	● "DataSource" : { "VCpu.Count" : "Static" } ● "DataSourceNotes" : { "VCpu.Count" : "..." }
  KeyValueList	CSP가 제공하는 DB Spec 관련 부가 정보를 Key/Value List 형태로 제공, 예) 매핑된 EC2 Instance Type, IOPS, Architecture, 참고 가격 등	● "KeyValueList" : [ { "Key" : "EC2InstanceType", "Value" : "t3.medium" } ]

3. CB-Spider DB Spec Info API 및 제공 정보 예시

• AWS RDS mysql 엔진의 db.t3.medium DB Spec 정보 호출 API 및 제공 정보 예시가 다음과 같다.

  curl -u admin:your-secure-password -sX 'GET' 'http://localhost:1024/spider/dbspec/db.t3.medium?ConnectionName=aws-config01&DBEngine=mysql' | json_pp
  

  {
     "DBEngine" : "mysql",
     "KeyValueList" : [
        {
           "Key" : "EC2InstanceType",
           "Value" : "t3.medium"
        }
     ],
     "MemSizeMiB" : "4096",
     "Name" : "db.t3.medium",
     "Region" : "ap-southeast-2",
     "StorageSizeRangeGB" : {
        "Max" : 17592,
        "Min" : 5
     },
     "VCpu" : {
        "ClockGHz" : "2.5",
        "Count" : "2"
     }
  }
  

• Azure Database for MySQL의 Standard_B12ms DB Spec처럼, CSP API가 특정 필드를 SKU 단위가 아닌 엔진 전체 단위로만 제공하여 값이 고정(Static)으로 처리된 예시가 다음과 같다.

  curl -u admin:your-secure-password -sX 'GET' 'http://localhost:1024/spider/dbspec/Standard_B12ms?ConnectionName=azure-northeu-config&DBEngine=mysql' | json_pp
  

  {
     "DBEngine" : "mysql",
     "DataSource" : {
        "StorageSizeRangeGB" : "Static"
     },
     "DataSourceNotes" : {
        "StorageSizeRangeGB" : "The capabilitySets response's per-SKU details carry no storage-range field; storage size is a single engine-wide range for this CSP, not tied to a specific SKU. See RDBMSMetaInfo.StorageSizeRangeGB instead."
     },
     "KeyValueList" : [
        {
           "Key" : "SupportedIops",
           "Value" : "3800"
        }
     ],
     "MemSizeMiB" : "49152",
     "Name" : "Standard_B12ms",
     "Region" : "northeurope",
     "StorageSizeRangeGB" : {
        "Max" : 0,
        "Min" : 0
     },
     "VCpu" : {
        "ClockGHz" : "-1",
        "Count" : "12"
     }
  }
  

4. CB-Spider DB Spec Info AdminWeb 제공 예시

• AdminWeb(http://localhost:1024/spider/adminweb) 접속 후, 좌측 메뉴에서 Connection을 선택하여 대상 Connection Config(예: aws-config01)를 선택한다.
• 화면 우측 상단의 아이콘 메뉴(Region, Price, Quota, Image, VMSpec, DBSpec) 중 DBSpec을 클릭한다.
• 검색어 입력창(Search Keyword) 옆의 DB Engine 드롭다운에서 mysql / mariadb / postgresql 중 하나를 선택하면, 선택된 Connection의 Region·DB Engine 조합에 해당하는 DB Spec 목록이 다음 컬럼으로 구성된 테이블로 조회된다.