콘텐츠로 이동
≡

Administrator

Developer

Tools

External Tools

7. Shard Manager#

개요#

Shard Manager는 Altibase Sharding의 샤드 노드와 샤드 객체에 대한 구성 및 관리를 돕는 도구이다.

Altibase Sharding은 다수의 데이터베이스로 구성되기 때문에, 각 데이터베이스와 객체를 관리하는 비용이 많이 들 수 있다. 이러한 환경에서 관리자는 Shard Manager를 사용함으로써 여러 데이터베이스에서 수행해야 하는 반복 작업을 단순화하여 업무 효율성을 향상시키고, 샤드 노드와 샤드 객체를 시각화하여 구성에 대한 이해도를 증진시킬 수 있다.

특징#

Shard Manager의 특징은 다음과 같다.

  • 샤드 데이터베이스를 손쉽게 추가/삭제/초기화할 수 있다.
  • 샤드 노드를 손쉽게 등록/수정/해제할 수 있다.
  • DB 객체를 샤드 객체로 손쉽게 등록/해제할 수 있다.
  • 여러 노드에 걸쳐 존재하는 분산 객체의 개별 정보 및 분산 정보를 하나의 창에서 확인할 수 있다.
  • 여러 노드들에 대해, SQL(DDL)을 Primary DB/Alternate DB 단위로 한 번에 수행할 수 있다.
  • 샤드 노드 구성, 샤드 객체 분포 및 스키마, 그리고 데이터 분포를 HTML 형태의 레포트로 확인할 수 있다.

설치#

이 절에서는 Shard Manager를 설치할 때 필요한 환경과 선행 조건, 그리고 설치 및 제거 방법을 안내한다.

시스템 요구사항#

Shard Manager는 Windows 또는 Linux에서 설치 및 실행이 가능하다.

GUI 모드#

Windows용 Shard Manager는 Java 6 64bit JRE를 포함해서 패키징된다.

  • Windows OS 64bit 사용자는 특별한 설정이 필요없다.
  • Windows OS 32bit 사용자는 Shard Mananager가 설치된 디렉토리의 64bit JRE 디렉토리를 32bit용 JRE로 변경해야 한다.

Linux용 Shard Manager는 JRE를 포함하지 않는다. 따라서 사용자가 실행 환경에 적합한 버전의 JRE를 설치해야 한다.

CLI 모드#

실행 환경에 적합한 JAVA_HOME 환경변수를 설정해야 한다.

운영체제별 자세한 지원 사항은 다음의 링크된 페이지에서 확인할 수 있다( http://www.eclipse.org/projects/project-plan.php?projectid=eclipse#target_environments ).

리소스 최소 요구사항
OS Windows 32/64 bit 또는 Linux 64 bit
메모리 512 MB
Java Runtime Environment(JRE) JRE Version 6
디스크 공간 90 MB
화면 해상도 1024 * 786 pixels
CPU Pentium III 800MHz

호환가능 데이터베이스#

Shard Manager와 호환가능한 데이터베이스는 아래와 같다.

  • 알티베이스 데이터베이스에 샤드 환경 변수가 설정되어있어야 한다.
  • 알티베이스 데이터베이스 샤딩에 필요한 패키지가 설치되어 있어야 한다.

샤딩에 필요한 패키지는 $ALTIBASE_HOME/packages에 포함되어 있으며 설치 대상 목록은 다음과 같다.

  • dbms_shard.sql, dbms_shard.plb
  • dbms_metadata.sql, dbms_metadata.plb

설치와 제거#

제공된 압축(zip) 파일을 원하는 위치에 해제하면 Shard Manager 설치가 완료된다. Shard Manager를 제거하기 위해서는 설치 시 생성한 Shard Manager 디렉토리를 삭제하면 제거가 완료된다.

사용자 인터페이스#

Shard Manager는 그래픽 사용자 인터페이스 (GUI) 모드와 명령어 인터페이스 (CLI) 모드, 두 가지 사용자 인터페이스를 제공한다.

그래픽 사용자 인터페이스 (GUI) 모드#

GUI 모드는 사용자 친화적인 인터페이스로 Shard Manager의 기본 인터페이스이다. GUI 모드를 사용하면 샤드 데이터베이스 관리를 직관적으로 수행할 수 있다. GUI 사용자 인터페이스는 Windows OS를 기준으로 설명한다.

ShardManager.exe를 클릭해서 최초로 실행한 화면이다.

화면에서 빈 공간은 샤드 데이터베이스 뷰, 샤드 객체 뷰에 따라 다른 뷰(쿼리 뷰, 상세 뷰, 레코드 카운트 뷰, 메모리 테이블스페이스 사용률 뷰)를 보여준다.

샤드 데이터베이스 뷰#

샤드 데이터베이스 뷰는 샤드 노드를 하나의 그룹으로 표현하는 샤드 데이터베이스를 중심으로 샤드 정보를 보여준다. 기본 전체 화면의 왼쪽 상단에 위치한다.

샤드 데이터베이스 뷰에서 표현하는 정보는 3가지이다.

  1. 샤드 데이터베이스: 사용자가 등록한 샤드 노드를 하나의 그룹으로 나타낸다. 특정 샤드 노드로 접속을 성공하면, 샤드 데이터베이스는 현재 접속 노드로부터 샤드 노드들의 정보를 가져와 트리 구조의 하위 노드로 표현한다.
  2. 샤드 노드: 샤드 메타에 등록된 샤드 노드이다. 하위 개체로 Primary/Alternate DB의 연결 정보를 보여준다.
  3. DB의 연결정보: 샤드 노드를 구성하는 Primary/Alternate DB 연결 정보이다.

Label Expression

  • 샤드 데이터베이스: 샤드 데이터베이스 추가 시 사용자가 부여한 이름
  • 샤드 노드: 샤드 메타에 등록된 샤드 노드 이름
  • 샤드 노드의 연결정보: IP 주소 : 포트 번호 (SMN)

Icon Expression

  • 샤드 데이터베이스: 샤드 노드에 성공적으로 접속하면 아이콘 오른쪽 하단에 초록색 화살표를 표시한다.
  • 샤드 노드의 연결정보: 원형 아이콘은 접속 성공 시 초록색, 실패 시 빨간색으로 표시된다. 해당 연결 정보가 샤드 노드의 alternate DB는 아이콘 오른쪽 하단에 'A' 문자를 표시한다.

샤드 객체 뷰#

샤드 객체 뷰는 샤드 데이터베이스 뷰에서 선택된 샤드 데이터베이스에 속한 샤드 객체를 보여준다. 기본 전체화면의 왼쪽 하단에 위치한다.

샤드 객체는 종류에 따라 'Procedures', 'Tables'의 트리 하위 노드로 표현된다.

  • 프로시저: 샤드 메타에 등록된 샤드 프로시저이다.
  • 프로시저 파라미터: 샤드 프로시저에서 샤드 키 또는 서브 샤드 키로 사용되는 파라미터 정보
  • 테이블: 샤드 메타에 등록된 샤드 테이블이다.
  • 테이블 컬럼: 샤드 테이블에서 샤드 키 또는 서브 샤드 키로 사용되는 컬럼 정보

Label Expression

  • 프로시저, 테이블: 사용자 이름.객체 이름
  • 프로시저 파라미터: 프로시저 파라미터 이름 [데이터 타입]
  • 테이블 컬럼: 테이블 컬럼 이름 [데이터 타입]

Icon Expression

  • 프로시저 파라미터: 파라미터 타입에 따라 IN은 오른쪽, OUT은 왼쪽, IN OUT은 양쪽 화살표 아이콘을 표시한다. 열쇠 그림 위의 숫자가 1이면 샤드 키, 2이면 서브 샤드 키를 의미한다.
  • 테이블 컬럼: 열쇠 그림 위의 숫자가 1이면 샤드 키, 2이면 서브 샤드 키를 의미한다.

칼럼 설명

  • Name: 샤드 객체의 이름을 표시한다.

  • Split Method: 샤드 객체의 분산 방식을 표시한다.

샤드 객체 뷰 툴바

  • Set Shard Object(): 샤드 객체를 추가한다.
  • Create Shard Hash Table (): 새로운 테이블 생성과 Set Shard Hash Table을 동시에 수행한다.
  • Resharding for Shard Key Distributed table(): Shard Key Distributed table (Hash, Range, List) 리샤딩을 수행한다.
  • Resharding for Clone table(): Clone table 리샤딩을 수행한다.
  • Resharding for Solo table(): Solo table 리샤딩을 수행한다.
  • Refresh (): 샤드 객체 뷰를 업데이트 한다.

쿼리 뷰#

쿼리 뷰는 사용자가 입력한 쿼리를 샤드 노드를 구성하는 Primary, Alternate DB를 대상으로 수행하는 뷰이다.

쿼리 뷰에서 사용가능한 쿼리 종류는 데이터 정의 언어(Data Definition Language, DDL)과 데이터 제어 언어(Data Control Language, DCL)이다.

쿼리 뷰는 (Data Manipulation Language, DML: SELECT, INSERT, DELETE, UPDATE) 를 지원하지 않는다. 쿼리 뷰에서 입력한 DML은 사용자가 선택한 DB에서 모두 수행되기 때문에, 예상하지 못한 결과를 가져올 수 있다.

샤드 데이터베이스를 연결할 때 자동으로 뷰가 나타나며, 대상 데이터베이스의 이름이 뷰의 제목으로 사용된다. 사용자가 쿼리 뷰를 직접 열 때에는 샤드 데이터베이스 뷰에서 샤드 데이터베이스를 마우스 오른쪽 버튼을 누르거나 선택 후, Shard Database 메뉴를 열어 'Open Query View'를 선택하면 생성된다. 기본 전체 화면 오른쪽 상단에 위치한다.

쿼리 뷰 툴바#

  • Execute Statement (): 커서로 선택한 문자 블록 또는 해당 커서가 위치한 라인이 수행된다.
  • Execute Script (): 쿼리 뷰에 입력한 모든 SQL문이 수행된다.

사용자가 선택한 체크박스에 따라 Primary 또는 Alternate DB DB를 대상으로 쿼리를 수행하며, 쿼리 수행 결과는 콘솔 뷰에 출력된다.

쿼리 뷰에 여러 SQL문을 입력할 수 있으며, 일부 또는 전체 SQL문을 선택하여 수행할 수 있다. SQL문은 입력한 순서대로 수행된다.

상세 뷰#

상세 뷰는 특정 객체에 대해 샤드 메타에 등록된 분산 정보와 각 노드에 저장된 해당 객체의 상세 정보를 보여준다.

대상 객체의 사용자 이름과 객체 이름이 개별 뷰의 제목으로 쓰인다. 샤드 객체 뷰에서 객체를 마우스 오른쪽 버튼으로 누르거나, 선택 후 Shard Object 메뉴를 열어 'Show Detail'을 선택하면 생성되며, 기본 전체화면의 오른쪽 상단에 위치한다.

상세 뷰는 샤드 객체 정보를 'Shard Info'와 'Detail'라는 탭으로 분류하여 보여준다.

  • Shard Info: 대상 객체가 샤드 객체인 경우, 샤드 메타에 등록된 분산 정보를 보여준다.
    • Split Information: 샤드 키, 분산 방식, 기본 노드를 보여준다.
    • Key Values: 선택한 샤드 객체가 분산된 샤드 노드의 이름과 샤드 키 값, 서브 샤드 키의 값을 보여준다.

  • Detail: 각 노드에 저장된 객체의 상세 정보를 보여준다.
  • Owner Databases: 샤드 객체 뷰에서 선택된 객체와 동일한 스키마 이름과 객체 이름을 가진 객체가 저장되어 있는 데이터베이스 리스트를 보여준다. (Label Expression: '샤드 노드 이름 (IP 주소 : 포트 번호)' )
  • Owner Databases에서 선택된 데이터베이스에 존재하는 분산 객체의 정보는 오른쪽 화면에 탭 형식으로 분류하여 나타낸다. 샤드 테이블의 경우 'Properties', 'Columns', 'Constraints'로 분류하고, 샤드 프로시저의 경우 'Properties', 'Parameters', 'Code'로 분류한다.

메모리 테이블스페이스 사용률 뷰#

메모리 테이블스페이스 사용률 뷰는 샤드 데이터베이스를 구성하는 DB의 메모리 테이블스페이스 사용률을 보여준다.

접속한 샤드 데이터베이스를 마우스 오른쪽 버튼으로 누르거나, 선택 후 Shard Database 메뉴를 열어 'Show Memory Tablespace Usage'를 클릭하면 생성된다. 생성 시 기본 전체화면 오른쪽 상단에 위치한다.

칼럼 설명

  • Database: 샤드 노드의 연결정보로 접속한 데이터베이스(Label Expression: '샤드 노드 이름 (IP 주소 : 포트 번호)'
  • Tablespace Name: 메모리 테이블스페이스 이름, 노드에 존재하는 메모리 테이블스페이스가 다수일 경우, 선택할 수 있다.
  • Max(MB): 메모리 테이블스페이스에서 사용할 수 있는 최대 메모리 크기, 테이블스페이스 생성 시 최대 크기를 지정하지 않았다면 MEM_MAX_DB_SIZE 프로퍼티에 지정된 크기를, AUTOEXTEND가 OFF라면 메모리 테이블스페이스가 할당받은 크기를 출력한다.
  • Alloc(MB): 메모리 테이블스페이스에 할당된 메모리 크기
  • Used(MB): 'Alloc(MB)'의 값 중, 실제 사용하는 메모리 크기
  • Usage(%): 메모리 테이블스페이스 사용률 (= Alloc(MB) / Max(MB) * 100)

레코드 카운트 뷰#

샤드 테이블의 레코드는 여러 샤드 노드에 분산되어 저장된다. 레코드 카운트 뷰는 각 샤드 노드에 저장된 레코드 개수를 표시한다. 기본적으로 Primary DB에 저장된 테이블 레코드 갯수를 보여준다.

샤드 객체 뷰에서 테이블을 마우스 오른쪽 버튼으로 누르거나, 선택 후 'Shard Object' 메뉴에서 'Show Record Count'를 클릭하면 생성된다. 기본 전체화면의 오른쪽 상단에 위치한다.

칼럼 설명

  • Shard Node: 샤드 메타에 저장된 노드의 이름
  • Address: 샤드 노드의 연결정보로 노드에 Alternate DB가 있으면 연결정보를 선택할 수 있다. (Label Expression: 'IP 주소 : 포트 번호')
  • Record Count: Shard Node와 Address 컬럼에서 선택된 데이터베이스에 저장된 테이블의 레코드 개수

콘솔 뷰#

프로그램 수행 중 사용자에게 전달할 정보가 기록되는 뷰이다.

프로그램의 수행 상태와 쿼리 실행결과 등이 기록된다. 기본 전체화면 오른쪽 하단에 위치한다.

명령어 인터페이스 (CLI) 모드#

CLI 모드는 GUI를 수행할 수 없는 환경 또는 shell script를 이용한 반복 작업 수행 등 특수 목적을 위해 제공하는 인터페이스이다. CLI 사용자 인터페이스는 Linux OS를 기준으로 설명한다.

작업 수행 형식은 수행할 작업 option과 그에 따라 필요한 값을 입력한다. 

$ ./ShardManCli.sh -option [XML file path | shard_db_name]

지원하는 작업 option은 다음과 같이 확인할 수 있다.

$ ./ShardManCli.sh
-----------------------------------------------------------------
     Shard Manager CLI
     Copyright 2000, ALTIBASE Corporation or its subsidiaries.
     All Rights Reserved.
-----------------------------------------------------------------
usage: Shard Manager CLI
 -report <arg>      generate report for given shard database name
 -reshard <arg>     resharding shard objects with XML file
 -sharddb <arg>     create/load/remove shard database with XML file
 -shardnode <arg>   add/remove shard node(s) from target shard database
                    with XML file

입력할 XML의 문법(DTD)는 Shard Manager 패키지에 제공되는 XML 샘플 파일을 참조한다.

  • shard_db.xml: 샤드 데이터베이스 관리
  • shard_node.xml: 샤드 노드 관리
  • shard_obj.xml: 샤드 객체 관리
  • reshard.xml: 리샤딩

샤드 데이터베이스 관리#

새로운 샤드 데이터베이스 추가#

새로운 샤드 데이터베이스를 만든다. 샤드 데이터베이스를 구성하는 모든 데이터베이스들은 샤드 메타값이 초기화 되어 있어야 하며, 샤드 객체는 없어야 한다. 새로 설치된 데이터베이스들에 샤드 데이터베이스 프로퍼티가 설정되어 있고, 필수 패키지만 설치된 상태를 권장한다.

GUI 모드#

  1. 툴바 또는 Database 메뉴에 위치한 'Create New Shard Database'를 클릭한다.
  2. 샤드 데이터베이스 이름과 샤드 노드, 그리고 DB 공통 연결정보를 입력한다. 샤드 데이터베이스 이름은 사용자가 임의로 설정하는 이름이다. 샤드 노드 연결정보는 노드 이름 및 노드를 구성하는 데이터베이스 접속 정보를 입력한다. Replication IP는 데이터베이스의 IP와 다른 값을 사용한Alternate DB가 없으면 Alternate 컬럼에 값을 입력하지 않는다. Common Database Properties는 DB 접속에 필요한 공통 정보를 입력한다.
  3. 'Test' 버튼을 클릭하여 입력한 연결정보를 통해 노드에 접속이 정상적으로 이루어지는지 확인한다.
  4. 'OK' 버튼을 클릭하여 샤드 데이터베이스를 저장한다.
  5. 정상적으로 샤드 데이터베이스가 생성되었다면 해당 샤드 데이터베이스가 샤드 데이터베이스 뷰에 나타난다.

CLI 모드#

$ ./ShardManCli.sh -sharddb ./shard_db.xml

을 이용하여 새로운 샤드 데이터베이스를 등록한다.

<ShardDb Name = "NewAltiShard" Action="Create">
    <CommonDbConn DbName="MYDB" UserName="SYS" Password="MANAGER" JdbcDriver="C:\Altibase\Driver\Altibase.jar"/>
    <ShardNode Name="NODE1">
       <Db Type="Primary"   Ip="192.168.1.11" Port="20300">
       <Db Type="Alternate" Ip="192.168.1.12" Port="20300">
    </ShardNode>
    <ShardNode Name="NODE2">
       <Db Type="Primary"   Ip="192.168.1.21" Port="20300" JdbcDriver="C:\Altibase\Driver\Altibase2.jar">
       <Db Type="Alternate" Ip="192.168.1.22" Port="20300" JdbcDriver="C:\Altibase\Driver\Altibase2.jar">
    </ShardNode>
    <ShardNode Name="NODE3">
       <Db Type="Primary"   Ip="192.168.1.31" Port="20300" ReplIp="192.168.2.31" >
    </ShardNode>        
</ShardDb>

새로운 샤드 데이터 베이스를 추가할 때, DB 객체 생성 및 샤드 객체 설정도 함께 할 수 있다 (). 샤드 객체 상세 내용은 '샤드 객체 설정'을 참조한다.

<ShardDb Name = "CreateShardDb" Action="Create">
    <CommonDbConn DbName="MYDB" UserName="SYS" Password="MANAGER" DriverPath="./drv/Altibase_7_1_0_0_0_branch_rev.76468.jar"/>
    <ShardNode Name="NODE1">
       <Db Type="Primary"   Ip="192.168.1.24" Port="12099" />
       <Db Type="Alternate" Ip="192.168.1.94" Port="56816" />
    </ShardNode>
    <ShardNode Name="NODE2">
       <Db Type="Primary"   Ip="192.168.1.26" Port="12099" DriverPath="./drv/Altibase_Trunk_rev.81318.jar" />
       <Db Type="Alternate" Ip="192.168.1.94" Port="56817" DriverPath="./drv/Altibase_Trunk_rev.81318.jar" />
    </ShardNode>
    <ShardNode Name="NODE3">
       <Db Type="Primary"   Ip="192.168.1.27" Port="12099" RpIp="192.168.1.30" />
    </ShardNode>
    <ShardObjList>
        <DDL> 
            CREATE OR REPLACE PROCEDURE SYS.P1 (c1 INT) as begin null; 
            END
        </DDL>
        <Set Schema="SYS" Name="P1" ObjType="P" SplitMethod="H" KeyColumnName="C1" DefaultNode="NODE1"/>

        <DDL IgnoreFailure = "T">DROP TABLE SYS.CT1</DDL>
        <DDL>CREATE TABLE CT1 ( I1 char(20) primary key)</DDL>
        <Set Schema="SYS" Name="CT1" ObjType="T" SplitMethod="C" DefaultNode="NODE1, NODE2, NODE3" />

        <DDL IgnoreFailure = "T">DROP TABLE SYS.ST1</DDL>
        <DDL>CREATE TABLE ST1 ( I1 char(20) primary key)</DDL>
        <Set Schema="SYS" Name="ST1" ObjType="T" SplitMethod="S" DefaultNode="NODE2" />  

        <DDL IgnoreFailure = "T">DROP TABLE SYS.HT1</DDL>
        <CreateAndSet Schema="SYS" Name="HT1" ObjType="T" SplitMethod="H" KeyColumnName="I1" DefaultNode="NODE1" PartitionPerNode = "3">
            <ColumnSql>
                I1 VARCHAR(32) PRIMARY KEY, 
                I2 VARCHAR(32)
            </ColumnSql>
        </CreateAndSet>
    </ShardObjList>    
</ShardDb>

샤드 데이터베이스 읽어 오기#

미리 구성되어 있는 Altibase Sharding에 접속해 샤드 데이터베이스를 등록하는 메뉴이다.

주의할 점은 여러 개의 샤드 매니저가 동일한 Altibase Sharding을 대상으로 동시에 작업을 하면 예상하지 못한 결과를 초래할 수 있다. 반드시 하나의 샤드 매니저로 하나의 Altibase Sharding에만 작업해야 한다.

GUI 모드#

  1. 툴바 또는 Database 메뉴에 위치한 'Load from Running Shard Database'를 클릭한다.
  2. 샤드 데이터베이스 이름과 최초 접속 노드의 연결정보를 입력한다. 샤드 데이터베이스 이름은 사용자가 임의로 설정하는 이름이다. 최초 접속 노드 연결정보는 샤드 노드와 샤드 객체 정보를 가지고 오기 위해서 필요하다.
  3. 'Test' 버튼을 클릭하여 입력한 연결정보를 통해 최초 접속 노드에 접속이 정상적으로 이루어지는지 확인한다.
  4. 'Next' 버튼을 클릭하여 다음 페이지에서 최초 접속 노드로부터 가져온 샤드 노드 이름, 연결정보, 그리고 접속하는데 사용될 JDBC 드라이버 파일을 확인한다.
  5. 각 샤드 노드 접속에 필요한 JDBC 드라이버 파일이 최초 접속 노드에서 사용한 파일과 다르면, Driver Path 열에서 해당하는 칸에 위치한 연필 아이콘을 클릭하여 드라이버 파일을 변경한다.
  6. 'Finish' 버튼을 클릭하여 샤드 데이터베이스를 저장한다.
  7. 정상적으로 샤드 데이터베이스가 생성되었다면 해당 샤드 데이터베이스가 샤드 데이터베이스 뷰에 나타난다.

CLI 모드#

$ ./ShardManCli.sh -sharddb ./shard_db.xml

로 미리 구성되어 있는 샤드 데이터베이스를 Shard Manager에 등록한다. 샤드 데이터베이스내의 Primary DB 접속 정보를 입력 후 수행하면 된다.

<ShardDb Name = "LoadFromRunningAltiShard" Action="Load">
   <Db Type="Primary"   Ip="192.168.1.11" Port="20300" DbName="MYDB" UserName="SYS"
       Password="MANAGER" JdbcDriver="C:\Altibase\Driver\Altibase.jar">
</ShardDb>

샤드 데이터베이스 편집#

샤드 데이터베이스가 가장 먼저 접속할 데이터베이스의 접속 정보를 수정하기 위한 메뉴이다.

GUI 모드#

  1. 샤드 데이터베이스 뷰에서 수정할 샤드 데이터베이스를 클릭한다.
  2. 샤드 데이터베이스 뷰 위에서 마우스 오른쪽 버튼을 누르거나, Shard Database 메뉴를 열어 'Edit Shard Database'를 클릭한다.
  3. 최초 접속 노드 연결정보를 수정한 뒤, 'Test'버튼을 클릭하여 접속 여부를 확인한다.
  4. 'Next' 버튼을 클릭하여 다음 페이지에서 수정된 최초 접속 노드로부터 가져온 데이터 노드 리스트를 확인한다.
  5. 각 샤드 노드 접속에 필요한 JDBC 드라이버 파일의 변경이 필요하면, Driver Path 열에서 해당하는 칸에 위치한 연필 아이콘을 클릭하여 파일을 변경한다.
  6. 'Finish' 버튼을 클릭하여 수정된 샤드 데이터베이스를 저장한다.

CLI 모드#

N/A

샤드 데이터베이스 연결#

샤드 데이터베이스에 연결한다.

GUI 모드#

  1. 샤드 데이터베이스 뷰에서 연결할 샤드 데이터베이스를 더블클릭하거나, 마우스 오른쪽 버튼으로 눌러 'Connect'를 클릭한다.
  2. 연결이 정상적으로 수행되면 아이콘 오른쪽 하단에 초록색 화살표를 표시하고, 트리 하위 노드로 샤드 메타에 등록된 샤드 노드를 표시한다.

CLI 모드#

N/A

샤드 데이터베이스 연결 해제#

샤드 데이터베이스 연결을 해제한다.

GUI 모드#

  1. 샤드 데이터베이스 뷰에서 연결 해제할 샤드 데이터베이스를 더블클릭하거나, 마우스 오른쪽 버튼을 눌러 'Disconnect'를 클릭한다.
  2. 연결이 정상적으로 해제되었다면 아이콘 오른쪽 하단에 있는 초록색 화살표가 사라지고, 트리 하위 노드들이 사라진다.

CLI 모드#

N/A

샤드 데이터베이스 삭제#

샤드 데이터베이스를 초기화 후, Shard Manager에서 제거한다.

  • 샤드 객체: 샤드 메타에 등록된 모든 샤드 객체를 해제하고, 대응되는 DB객체를 삭제한다.
  • 샤드 노드: Primary DB와 Alternate DB간의 이중화 객체, 그리고 샤드 메타를 초기화 시킨다.
  • 샤드 데이터베이스: Shard Manager에서 제거한다.

GUI 모드#

  1. 샤드 데이터베이스 뷰에서 삭제할 샤드 데이터베이스를 마우스 오른쪽 버튼으로 누르거나, 클릭 후 Database 메뉴를 열어 'Remove Shard Database'를 클릭한다.
  2. 삭제 여부를 묻는 팝업 창에서 삭제할 샤드 데이터베이스가 맞는지 확인한 뒤,'Yes' 버튼을 클릭한다.
  3. 정상적으로 샤드 데이터베이스가 삭제되었다면, 해당 샤드 데이터베이스가 샤드 데이터베이스 뷰에서 사라진다.

CLI 모드#

$ ./ShardManCli.sh -sharddb ./shard_db.xml

를 이용하여 샤드 데이터베이스를 삭제한다.

<ShardDb Name = "RemoveAltiShard" Action="Remove"/>

메모리 테이블스페이스 사용률 확인#

GUI 모드#

  1. 샤드 데이터베이스 뷰에서 메모리 테이블스페이스의 사용률을 확인하려는 샤드 데이터베이스를 마우스 오른쪽 버튼으로 누르거나, 클릭 후 Database 메뉴를 열어 'Show Memory Tablespace Usage'를 클릭한다.
  2. 확인하고자 하는 데이터베이스의 행에서 Tablespace Name 열에 해당하는 칸을 클릭하여 원하는 메모리 테이블스페이스를 선택한다.

CLI 모드#

N/A

샤드 데이터베이스 레포트#

샤드 데이터베이스의 현황을 요약한 HTML 포멧의 Shard Confinguration, Record Count 레포트를 제공한다.

  • Shard Confinguration 레포트: 샤드 노드 구성과 샤드 객체 구성 및 DDL을 보여준다.

  • Record Count 레포트: 샤드 테이블의 노드(DB)별 레코드 갯수 분포를 보여준다. 이때 DB별 레코드 반환 시점의 차이로 인해 레코드 갯수 차이가 있을 수 있다.

GUI 모드#

  1. 샤드 데이터베이스 뷰에서 대상 샤드 데이터베이스를 마우스 오른쪽 버튼으로 누르거나, 메뉴바에서 Shard Database 메뉴를 열어 'Generate Report'를 클릭한다.
  2. 레포트 생성 완료 시 콘솔뷰에 파일 경로가 나타난다. 샤드 매니저가 설치된 경로의 report 디렉토리에 레포트 파일이 생성된다. 파일 이름은 수행 시작 시간을 기준으로 yyyyMMdd_HHmmss_[ShardConf | ShardRecord].html 형식으로 만들어진다.

CLI 모드#

$ ./ShardManCli.sh -report shardb_name

XML 파일 대신 대상 샤드 데이터베이스 이름을 직접 입력하여 레포트를 생성한다. 생성되는 레포트 파일은 GUI 모드의 것과 동일하다.

샤드 노드 관리#

샤드 노드 추가#

샤드 노드를 추가한다. 노드를 추가할때, 새 노드의 Primary/Alternate DB에 샤드 메타를 복제하고 샤드 객체를 생성한다. 또한 새 노드의 Primary/Alternate DB간에 이중화 객체도 필요시 자동 생성한다.

추가되는 노드의 Primary/Alternate DB에는 DB 객체들이 없어야 한다. 샤드 데이터베이스 프로퍼티가 설정되어 있고, 필수 패키지만 설치된 초기화된 데이터베이스를 권장한다.

GUI 모드#

  1. 샤드 데이터베이스에 새로운 샤드 노드를 추가한다.
  2. 샤드 데이터베이스 뷰에서 샤드 데이터베이스를 마우스 오른쪽 버튼으로 누르거나, 클릭 후 Shard Node 메뉴를 열어 'Add Data Node'를 클릭한다.
  3. 노드 이름과 Primary DB 연결정보를 반드시 입력하며, 선택적으로 Alternate DB의 연결정보까지 입력할 수 있다.
  4. 'Test' 버튼을 클릭하여 입력한 연결정보에 접속이 정상적으로 이루어지는지 확인한다.
  5. 'OK' 버튼을 클릭하여 샤드 노드를 추가한다.
    1. 추가할 샤드 노드의 Primary/Alternate DB에 기존 샤드 노드에 등록된 샤드 객체를 자동으로 생성 시도한다. 이때 DB 객체 생성이 하나라도 실패하면 생성에 성공한 DB 객체들도 다시 삭제 후, 샤드 노드 추가를 취소한다.
    2. 추가되는 샤드 노드에 Alternate DB 연결정보가 입력되어 있으면, Primary DB와 Alternate DB간 샤드 테이블을 이중화 하기 위해 이중화 객체를 자동으로 생성하고 이중화를 시작한다. 샤드 매니저가 생성하는 이중화 객체의 이름 형식은 SHDMGR_IN_NODE_NodeName 이다.
  6. 정상적으로 수행되었으면, 샤드 데이터베이스에 등록한 샤드 노드가 추가된다.

CLI 모드#

$ ./ShardManCli.sh -shardnode ./shard_node.xml

로 기존 샤드 데이터베이스에 새로운 노드를 추가한다.

<ShardDb Name = "AltiShard">
    <ShardNode Name="NODE4" Action="Add">
       <Db Type="Primary"   Ip="192.168.1.41" Port="20300">
       <Db Type="Alternate" Ip="192.168.1.42" Port="20300">
    </ShardNode>
    <ShardNode Name="NODE5" Action="Add">
       <Db Type="Primary"   Ip="192.168.1.51" Port="20300" ReplIp="192.168.2.51" JdbcDriver="C:\Altibase\Driver\Altibase.jar">
    </ShardNode>
</ShardDb>

샤드 노드 삭제#

샤드 노드를 삭제한다.

GUI 모드#

  1. 샤드 데이터베이스 뷰에서 삭제할 샤드 노드를 마우스 오른쪽 버튼으로 누르거나, 클릭 후 Shard Node 메뉴를 열어 'Remove Shard Node'를 클릭한다.
  2. 삭제 여부를 묻는 팝업 창에서 삭제할 샤드 노드에 대한 정보를 확인한 뒤, 'Yes' 버튼을 클릭한다. Primary DB와 Alternate DB간 샤드 매니저가 생성한 이중화 객체가 있으면, 이를 감지해서 이중화 객체를 중지하고 삭제할 것인지 물어본다.
  3. 정상적으로 샤드 노드가 삭제되었다면 샤드 데이터베이스 뷰 내 대상 노드가 사라진다.

CLI 모드#

$ ./ShardManCli.sh -shardnode ./shard_node.xml

로 샤드 데이터베이스에서 등록된 노드를 제거한다. 제거되는 노드의 Shard key partitioned table의 파티션, Clone table, 그리고 Solo table은 AltNodeName의 노드로 이동된다. 

<ShardDb Name = "AltiShard">
    <ShardNode Name="NODE5" Action="Remove" AltNodeName="NODE3">
    <ShardNode Name="NODE4" Action="Remove" AltNodeName="NODE2">
</ShardDb>

Alternate DB 추가#

대상 노드에 Alternate DB를 추가한다. 새 Alternate DB에 샤드 메타를 복제하고 샤드 객체를 생성한다. 또한 Primary/Alternate DB간에 이중화 객체도 필요시 자동 생성한다.

추가되는 Alternate DB는 DB 객체들이 없어야 한다. 샤드 데이터베이스 프로퍼티가 설정되어 있고, 필수 패키지만 설치된 초기화된 데이터베이스를 권장한다.

GUI 모드#

  1. 샤드 데이터베이스 뷰에서 alternate DB를 추가할 샤드 노드 연결정보의 트리 상위 노드인 샤드 노드를 마우스 오른쪽 버튼으로 누르거나, 클릭 후 Shard Node 메뉴를 열어 'Add Alternate DB'를 클릭한다.
  2. 추가할 alternate DB 접속 정보를 입력한다.
  3. 'Test' 버튼을 클릭하여 입력한 연결정보로 접속이 정상적으로 이루어지는지 확인한다.
  4. 'OK' 버튼을 클릭하여 Alternate DB를 추가한다.
  5. Primary DB에 생성되어 있는 샤드 객체가 Alternate DB의 DB 메타에 미리 생성되어 있지 않으면, 자동으로 생성 시도한다. 이때 DB 객체 생성이 하나라도 실패하면 생성에 성공한 DB 객체들도 다시 삭제 후, Alternate DB 추가가 실패한다.
  6. Primary DB에 샤드 테이블이 있으면, Primary DB와 Alternate DB간 샤드 테이블을 이중화 하기 위해 이중화 객체를 자동으로 생성하고 이중화를 시작한다. 샤드 매니저가 생성하는 이중화 객체의 이름 형식은 SHDMGR_IN_NODE_NodeName 이다.
  7. 정상적으로 alternate DB가 추가되었다면 샤드 데이터베이스 뷰 내 대상 샤드 노드의 트리 하위 노드로 Alternate DB정보가 추가된다.

CLI 모드#

N/A

Alternate DB 삭제#

샤드 메타에서 Alternate DB 정보를 삭제한다. 노드에서 Alternate DB가 제거된다.

GUI 모드#

  1. 샤드 데이터베이스 뷰에서 삭제할 Alternate DB가 포함된 샤드 노드를 마우스 오른쪽 버튼으로 누르거나, 클릭 후 Shard Node 메뉴를 열어 'Remove Alternate Node'를 클릭한다.
  2. 삭제 여부를 묻는 팝업 창에서 삭제할 Alternate DB를 확인한 뒤 'Yes' 버튼을 클릭한다.
  3. 정상적으로 alternate DB가 삭제되었다면 샤드 데이터베이스 뷰 내 대상 샤드 노드의 트리 하위 노드인 Alternate DB 정보가 사라진다.

CLI 모드#

N/A

샤드 객체 관리#

샤드 객체 설정#

일반 DB 객체를 샤드 객체로 설정한다. 샤드 메타에 샤드 객체 정보가 저장된다.

GUI 모드#

  1. 샤드 객체 뷰의 툴바에 위치한 'Set Shard Object' 버튼() 또는 메뉴에서 'Shard Object' - 'Set Shard Object' 항목을 클릭한다.
  2. 'Available Database Object' 테이블에서 샤드 객체로 지정할 항목의 체크박스를 클릭하여 선택한다. 이때 Shard Key도 함께 지정해야 한다.
  3. 'Composite'을 제외한 샤드 키 분산 테이블이면, 선택한 샤드 객체의 샤드 키와 서브 샤드 키를 지정한 뒤, 샤드 키 분산 방식, 서브 샤드 키 분산 방식, 기본 노드를 선택한다.
  4. 'Key Values' 테이블에서 분산 정보에 등록할 노드와 샤드 키 값, 서브 샤드 키 값을 작성한다.
  5. 'Submit' 버튼을 클릭하여 샤드 객체 설정을 샤드 노드에 요청한다.
  6. 샤드 객체 설정이 완료되면, 해당 객체는 샤드 객체 뷰에 표시된다. 지정한 분산 방식은 'Split Method'에 표시되고, 샤드 키와 서브 샤드 키는 객체의 하위 노드로 표시된다.

CLI 모드#

$ ./ShardManCli.sh -shardobj ./shard_obj.xml

두가지 샤드 객체 설정 방법을 제공한다.

첫번째는 모든 샤드 객체에 적용가능한 방법으로 을 사용하여 DB 객체를 샤드 객체로 설정하는 방법이다. 여기서 DDL은 DB 객체 생성/삭제가 필요한 경우에만 수행한다.

<ShardDb Name = "ShardDb">
    <ShardObjList>
        <DDL> 
            CREATE OR REPLACE PROCEDURE SYS.P1 (C1 INT) as begin null; 
            END
        </DDL>
        <Set Schema="SYS" Name="P1" ObjType="P" SplitMethod="H" KeyColumnName="C1" DefaultNode="NODE1"/>

        <DDL IgnoreFailure = "T">DROP TABLE SYS.HT2</DDL>
        <DDL>
            CREATE TABLE SYS.HT2 ( 
                I1 VARCHAR(32) PRIMARY KEY, 
                I2 VARCHAR(32) 
            )
            PARTITION BY RANGE_USING_HASH ( I1 )
            (
                PARTITION P1 VALUES LESS THAN ( 200 ),
                PARTITION P2 VALUES LESS THAN ( 400 ),
                PARTITION P3 VALUES LESS THAN ( 600 ),
                PARTITION P4 VALUES LESS THAN ( 800 ),
                PARTITION P5 VALUES LESS THAN ( 1000 ),
                PARTITION PD VALUES DEFAULT
            )
        </DDL>
        <Set Schema="SYS" Name="HT2" ObjType="T" SplitMethod="H" KeyColumnName="I1"  DefaultNode="NODE1">
            <ValueNodeList>
                <ValueNode Value = "200" NodeName="NODE1"/>
                <ValueNode Value = "400" NodeName="NODE1"/>
                <ValueNode Value = "600" NodeName="NODE2"/>
                <ValueNode Value = "800" NodeName="NODE2"/>
                <ValueNode Value = "1000" NodeName="NODE3"/>
            </ValueNodeList>            
        </Set>   

        <DDL IgnoreFailure = "T">DROP TABLE SYS.LT1</DDL>      
        <DDL>
            CREATE TABLE SYS.LT1 
            ( 
                C1 int PRIMARY KEY, 
                C2 VARCHAR(32) 
            )
            PARTITION BY LIST ( C1 )
            (
                PARTITION P1 VALUES ( 1 ),
                PARTITION P2 VALUES ( 2 ),
                PARTITION P3 VALUES ( 3 ),
                PARTITION PD VALUES DEFAULT
            )
        </DDL>
        <Set Schema="SYS" Name="LT1" ObjType="T" SplitMethod="L"  KeyColumnName="C1" DefaultNode="NODE1">
            <ValueNodeList>
                <ValueNode Value = "SEOUL" NodeName="NODE1"/>
                <ValueNode Value = "BUSAN" NodeName="NODE2"/>
                <ValueNode Value = "TAEGU" NodeName="NODE3"/>
            </ValueNodeList>
        </Set>

        <DDL>
            CREATE TABLE SYS.RT1 
            ( 
                C1 INTEGER PRIMARY KEY, 
                C2 INTEGER
            )
            PARTITION BY RANGE ( C1 )
            (
                PARTITION P1 VALUES LESS THAN ( 100 ),
                PARTITION P2 VALUES LESS THAN ( 300 ),
                PARTITION P3 VALUES LESS THAN ( 500 ),
                PARTITION PD VALUES DEFAULT
            )
        </DDL>
        <Set Schema="SYS" Name="RT1" ObjType="T" SplitMethod="R" KeyColumnName="C1" DefaultNode="NODE1">
            <ValueNodeList>
                <ValueNode Value = "100" NodeName="NODE1"/>
                <ValueNode Value = "300" NodeName="NODE2"/>
                <ValueNode Value = "500" NodeName="NODE3"/>
            </ValueNodeList>
        </Set>

        <DDL>CREATE TABLE CT1 ( I1 char(20) primary key)</DDL>
        <Set Schema="SYS" Name="CT1" ObjType="T" SplitMethod="C" DefaultNode="NODE1, NODE3" />

        <DDL>CREATE TABLE ST1 ( I1 char(20) primary key)</DDL>
        <Set Schema="SYS" Name="ST1" ObjType="T" SplitMethod="S" DefaultNode="NODE2" />
    </ShardObjList>
</ShardDb>

두번째는 샤드 해시 테이블에만 적용가능한 방법으로 으로 파티션드 해시 테이블을 생성하고, 이를 샤드 테이블로 설정한다.

PartitionPerNode는 각 노드당 몇개의 파티션을 생성할 것인지를 지정하는 옵션이다. 따라서, 최종 생성되는 파티션의 갯수는 (PartitionPerNode * 노드 갯수) + 디폴트 파티션 1개이다. 디폴트 파티션은 Default Node에 생성된다.

<ShardDb Name = "ShardDb">
    <ShardObjList>
        <CreateAndSet Schema="SYS" Name="HT1" ObjType="T" SplitMethod="H" KeyColumnName="C1" DefaultNode="NODE1" PartitionPerNode = "3">
            <ColumnSql>
                C1 VARCHAR(32) PRIMARY KEY, 
                C2 VARCHAR(32)
            </ColumnSql>
        </CreateAndSet>
    </ShardObjList>
</ShardDb>

샤드 객체 해제#

샤드 메타에서 샤드 객체 정보를 삭제하여, 일반 DB 객체로 변경한다.

GUI 모드#

  1. 샤드 객체 뷰에서 원하는 샤드 객체를 마우스 오른쪽 버튼으로 누르거나, 클릭 후 'Shard Object' 메뉴를 열어 'Unset Shard Object'를 클릭한다.
  2. 샤드 객체 해제를 완료하면, 샤드 객체 뷰에서 해당하는 샤드 객체가 제거된다.

CLI 모드#

$ ./ShardManCli.sh -shardobj ./shard_obj.xml

을 이용하여 샤드 객체를 해제한다.

<ShardDb Name = "ShardDb">
    <ShardObjList>
        <Unset Schema="SYS" Name="PROC1" ObjType="P" /> 
        <Unset Schema="SYS" Name="T1" ObjType="T" />
    </ShardObjList>
</ShardDb>

샤드 객체 삭제#

샤드 객체를 해제한 후, 샤드 메타에서 삭제한다. 그리고, 샤드 데이터베이스에 등록된 모든 DB에서 해당 객체를 삭제한다.

GUI 모드#

  1. 샤드 객체 뷰에서 원하는 객체를 마우스 오른쪽 버튼으로 누르거나, 클릭 후 Shard Object 메뉴를 열어, 객체 종류가 테이블일 경우 'Drop Table'를, 프로시저일 경우 'Drop Procedure'를 클릭한다.
  2. 삭제 여부를 묻는 팝업 창에서 삭제할 객체를 확인한 뒤, 'Yes' 버튼을 클릭한다.
  3. 정상적으로 객체가 삭제되었다면 샤드 객체 뷰 내 해당 객체가 사라진다.

CLI 모드#

CLI 모드에는 동일한 기능이 제공되지 않는다. 

$ ./ShardManCli.sh -shardobj ./shard_obj.xml

하지만, 과 을 함께 사용하면 동일한 결과를 얻을 수 있다.

<ShardDb Name = "ShardDb">
    <ShardObjList>
        <Unset Schema="SYS" Name="PROC1" ObjType="P" /> 
        <DDL>DROP PRCEDURE SYS.PROC1</DDL>
        <Unset Schema="SYS" Name="T1" ObjType="T" />
        <DDL>DROP TABLE SYS.T1</DDL>
    </ShardObjList>
</ShardDb>

샤드 객체 정보 확인#

GUI 모드#

샤드 객체 뷰에서 원하는 객체를 마우스 오른쪽 버튼으로 누르거나, 클릭 후 Shard Object 메뉴를 열어 'Show Detail'을 클릭한다.

CLI 모드#

N/A

테이블 레코드 카운트 확인#

GUI 모드#

  1. 샤드 객체 뷰에서 원하는 테이블을 마우스 오른쪽 버튼으로 누르거나 클릭 후 Shard Object 메뉴를 열어, 'Show Record Count'를 클릭한다.
  2. 확인하고자 하는 샤드 노드의 행에서 Address 열에 해당하는 칸을 클릭하여 원하는 연결정보를 선택한다.

CLI 모드#

N/A

Resharding#

샤드 노드간 샤드 테이블의 데이터 재분배를 손쉽게 수행한다. GUI 모드에서 리샤딩 대상 테이블 종류에 따라 Resharding for Shard Key Distributed table (Hash, Range, List), Resharding for Clone table, Resharding for Solo table를 선택 가능하다. CLI 모드에서는 -reshard 옵션과 동작을 정의한 XML을 작성해 리샤딩을 수행한다.

Resharding for Shard Key Distributed table#

GUI 모드#
  1. 샤드 객체 뷰의 툴바에 위치한 'Resharding for Shard Key Distributed table' 아이콘 또는 메뉴에서 'Shard Object' -> 'Resharding' -> 'Resharding for Shard Key Distributed table'을 클릭한다.
  2. 'Shard Tables' 리스트에서 리샤딩 대상 샤드 테이블을 클릭하여 선택한다.
  3. 샤드 테이블을 선택하면 'Partitions' 테이블에 파티션의 목록이 표시된다. 'Distribution' 테이블에는 노드별 레코드 갯수가 표시된다.
  4. 'Partitions' 테이블에서 ToNode 컬럼값을 클릭하여 이동할 노드를 선택한다. 'Shard Tables'에서 다른 테이블을 선택하여 여러 테이블을 resharding한번으로 작업할 수 있다. 작업 대상 파티션 노드 변경사항은 'Resharding candidates'에 표시된다.
  5. 'OK' 버튼을 누르면 작업 대상 파티션 노드 변경사항이 차례로 수행된다.
  6. '테이블 레코드 카운트 확인'을 수행하여 Resharding으로 레코드 재분배 결과를 확인할 수 있다.
CLI 모드#
$ ./ShardManCli.sh -reshard ./reshard.xml

아래는 NODE1의 H1 테이블 파티션 P1, P2를 NODE4로 리샤딩하는 예제이다.

<ReshardingList ShardDbName = "AltiShard">
    <TableList FromNode="NODE1" ToNode="NODE4">
        <Table Schema="SYS" Name="H1" Part="P1, P2" />
    </TableList>
</ReshardingList>

Resharding for Clone table#

GUI 모드#
  1. 샤드 객체 뷰의 툴바에 위치한 'Resharding for Clone table' 아이콘 또는 메뉴에서 'Shard Object' -> 'Resharding' -> 'Resharding for Clone table'을 클릭한다.
  2. 'Clone Tables' 리스트에서 리샤딩 대상 샤드 테이블을 클릭하여 선택한다.
  3. 'Nodes' 테이블의 'New' 항목을 선택하여 복사 또는 이동할 노드를 선택한다. Clone table은 최소한 한개 이상의 노드에 있어야 한다.
  4. 'Shard Object' 뷰에서 리샤딩 한 테이블의 'Show Detail'을 수행하여 리샤딩 결과를 확인할 수 있다.
CLI 모드#
$ ./ShardManCli.sh -reshard ./reshard.xml

아래는 NODE1에만 할당된 클론 테이블 CT1을, NODE2, NODE3로 복제 후 NODE1에서 제거하는 예제이다. CloneOp는 Copy 또는 Remove를 선택할 수 있다. 자세한 내용은 패키지에 제공되는 reshard.xml의 DTD를 참고한다.

<ReshardingList ShardDbName = "AltiShard">
    <TableList FromNode="NODE1" ToNode="NODE2">
        <Table Schema="SYS" Name="CT1" CloneOp="Copy" />
    </TableList>
    <TableList FromNode="NODE1" ToNode="NODE3">
        <Table Schema="SYS" Name="CT1" CloneOp="Copy" />
        <Table Schema="SYS" Name="CT1" CloneOp="Remove" />
    </TableList>    
</ReshardingList>

Resharding for Solo table#

GUI 모드#
  1. 샤드 객체 뷰의 툴바에 위치한 'Resharding for Solo table' 아이콘 또는 메뉴에서 'Shard Object' -> 'Resharding' -> 'Resharding for Solo table'을 클릭한다.
  2. 'Solo Tables' 리스트에서 리샤딩 대상 샤드 테이블을 클릭하여 선택한다.
  3. 'Nodes' 테이블의 'New' 항목을 선택하여 이동할 노드를 선택한다. Solo table은 하나의 노드에만 존재할 수 있다.
  4. 'Shard Object' 뷰에서 리샤딩 한 테이블의 'Show Detail'을 수행하여 리샤딩 결과를 확인할 수 있다.
CLI 모드#
$ ./ShardManCli.sh -reshard ./reshard.xml

아래는 솔로 테이블 ST1을 NODE1에서 NODE2로 리샤딩하는 예제이다.

<ReshardingList ShardDbName = "AltiShard">
    <TableList FromNode="NODE1" ToNode="NODE2">
        <Table Schema="SYS" Name="ST1" />
    </TableList>
</ReshardingList>

SQL 실행: DDL#

샤드 데이터베이스에 속한 여러 데이터베이스들을 대상으로 사용자가 입력한 SQL을 수행한다. DDL만 지원되며, DML이나 Select 문은 지원하지 않는다.

GUI 모드#

쿼리 뷰 열기#

샤드 데이터베이스 뷰에서 원하는 샤드 데이터베이스를 마우스 오른쪽 버튼으로 누르거나, 클릭 후 Database 메뉴를 열어 'Show Query View'를 클릭한다.

SQL 실행#

선택한 노드 종류에 해당하는 데이터베이스에서 입력한 SQL문이 실행된다.

  1. 쿼리 뷰 내 SQL 입력 창에 실행하고자 하는 SQL문을 입력한다.
  2. 쿼리 뷰 내 툴바에 위치한 체크박스 중, 입력한 SQL문을 실행하고자 하는 대상 DB 종류를 선택한다.
  3. 입력한 SQL문 중 특정 쿼리만 수행하려면, 해당 구문을 마우스 커서로 드래그하여 선택한 뒤 쿼리 뷰의 툴바에서 'Execute Statement'()을 클릭한다. 입력한 전체 SQL문을 모두 수행하고 싶을 경우에는 'Execute Script'()을 클릭하여 SQL 문을 실행한다.
  4. 콘솔 뷰를 통해 각 데이터베이스에서의 실행 결과를 확인한다.

CLI 모드#

$ ./ShardManCli.sh -shardobj ./shard_obj.xml

아래는 DB 객체인 프로시저 P1과 테이블 T1을 모든 노드에 생성하는 예제이다.

IgnoreFailure = "T" 옵션을 사용하면, 해당 구문을 수행하다 실패 또는 예외가 발생해도 무시하고 다음 작업을 진행한다. IgnoreFailure = "T" 옵션이 없으면 실패 또는 예외 발생시 에러 메세지를 표시하고 문제 발생 지점에서 수행을 중지한다.

좀더 상세한 내용은 '샤드 객체 관리'를 참조한다.

<ShardDb Name = "ShardDb">
    <ShardObjList>
        <DDL> 
            CREATE OR REPLACE PROCEDURE SYS.P1 (C1 INT) as begin null; 
            END
        </DDL> 
        <DDL IgnoreFailure = "T">DROP TABLE SYS.CT1</DDL>
        <DDL>CREATE TABLE CT1 ( I1 char(20) primary key)</DDL>
    </ShardObjList>
</ShardDb>