CUBRID - Open Source Database Management System Optimized for Web

Using CUBRID and NHibernate

2013-06-05T05:11:19-07:00

An introduction web tutorial

June 5, 2013

Hi,

In this tutorial we will show you how to use NHibernate with CUBRID in a simple demo web application that performs all the standard CRUD operations.

This tutorial was inspired by the following article, published on www.codeproject.com:

NHibernate and MySQL - A simple example (credits goes to Johan Lundqvist, for publishing this article)

What we intend to show here is that using CUBRID you can achieve with no effort the same results as in using MySQL with NHibernate!So we followed the same steps as in the original article, but using CUBRID as the RDBMS backend.

Prerequisites

Required software/setup:

NHibernate
CUBRID ADO.NET driver
Microsoft Visual Studio 2010 / 2012 (Freeware Express edition or Professional/Ultimate)
CUBRID NHibernate Demo Project

Setting up the project

In this tutorial you will learn how to create a simple web project that works with CUBRID and NHibernate to access a database table.

Let's start by creating the project folder structure:

Open MS Visual Studio and create a blank ASP.NET website
Create a new Webform called Default.aspx and set it as the Start Page

Next, add to your project a reference to NHibernate.dll and to CUBRIDData.dll

After you have performed these operations your project tree should look like this:

The last thing we will need is a table in our available database (let’s use demodb). To keep things simple, we will create a table named site with just two columns:

An id column that will serve as primary key
A name column. The SQL is:

CREATE TABLE "site"(
"id" integer AUTO_INCREMENT(1,1) NOT NULL,
"name" character varying(100) NOT NULL,
CONSTRAINT pk_site_id PRIMARY KEY("id")
);

Configuring NHibernate

According to the documentation, you can configure NHibernate in three ways:

through the web.config
through code
using a separate configuration file just for NHibernate called hibernate.cfg.xml

In this tutorial we will use the last approach as it seemed nice to have this separated from the other configuration stuff, so let's get going and take a look at the configuration file.

In your project, create a new xml file called hibernate.cfg.xml. To tell NHibernate that this is its configuration file, set the Build Action property to Embedded Resource and the Copy to Output Directory property to Copy always. Thehibernate.cfg.xml file consists of a few data that is quite simple to understand. The file with looks like this:

<?xml version="1.0" encoding="utf-8" ?>
<hibernate-configuration xmlns="urn:nhibernate-configuration-2.2">
<!-- an ISessionFactory instance -->
<session-factory>
<!-- properties -->
<property name="connection.provider">
NHibernate.Connection.DriverConnectionProvider
</property>
<property name="connection.driver_class">
NHibernate.Driver.CUBRIDDriver
</property>
<property name="connection.connection_string">
server=localhost;database=demodb;port=33000;user=public;password=
</property>
<property name="dialect">
NHibernate.Dialect.CUBRIDDialect
</property>
<!-- mapping files -->
<mapping resource="NHibernateCUBRID.Site.hbm.xml" assembly="NHibernateCUBRID" />
</session-factory>
</hibernate-configuration>

connection.provider sets which connection provider should be used by NHibernate to connect to the CUBRID database.
connection.driver_class sets which driver should be used and in this case, when using CUBRID, CUBRIDDriver is our choice
connection.connection_string is the connection string to the CUBRID database.
dialect states the NHibernate class name that enables certain platform dependent features, and in this case, since we are using CUBRID, the choice is CUBRIDDialect

The mapping part of the configuration file tells NHibernate which mapping files to use for the object/relational mapping, and we will describe that later in this tutorial.

The Persistent Class

NHibernate can use ordinary classes when persisting objects in a relational database, and uses a mapping technique to connect the persistent class properties to the columns in the relational database tables.

For our simple tutorial, we will create a simple C# class called Site, and the code for that class is as follows:

namespace NHibernateCUBRID
{
public class Site
{
    private int id;
    public virtual int Id
    {
        get { return id; }
        set { id = value; }
    }
    private string name;
    public virtual string Name
    {
        get { return name; }
        set { name = value; }
    }
    public Site()
    {
    }
  }
}

Site.cs contains two properties that correspond to the columns in a database table. NHibernate isn't really restricted to use only property types, all .NET types and primitives can be mapped, but in this simple example, we will only use int and string.

The ID property is quite important since it will correlate to the primary key in the table; even if it is not mandatory to use this for NHibernate (which can handle identifiers internally), it is a normal architectural approach.

As you can see from above, all the class public properties are declared virtual and this is because NHibernate utilizes this for some runtime enhancements which otherwise won't work according to the documentation, and it is also recommended that you provide a default constructor for the class.

The Mapping

To be able to use the Site class, it is necessary to create an NHibernate mapping file that contains the metadata that NHibernate uses for the object/relational mapping, i.e., connecting the class declaration, the properties to columns, and keys in the database tables.

So, we will create a new xml file called Site.hbm.xml and set its Build Action property to Embedded Resource.

The content of the file is:

<?xml version="1.0" encoding="utf-8" ?>
<hibernate-mapping xmlns="urn:nhibernate-mapping-2.2">
<class name="NHibernateCUBRID.Site, NHibernateCUBRID" table="site">
<id name="Id" column="ID" type="int">
<generator class="native"></generator>
</id>
<property name="Name" column="name" type="String"></property>
</class>
</hibernate-mapping>

The code

Now that we are finished with configuring NHibernate and implementing our object/relational model, we are ready to implement a simple webpage that performs all the CRUD operations on our database table by using object/relational mapping.

First thing we need to do is add a private ISessionFactory member to our Default class which will compile our mappings and create the NHibernate configuration that we need. ISessionFactory is, according to the NHibernate documentation, a thread safe cache of compiled mappings for a single database, and in the case when we have set the mapping files to be Embedded Resources, this is the only code that is needed to obtain such a factory:

private ISessionFactory factory =
new NHibernate.Cfg.Configuration().Configure().BuildSessionFactory();

SELECT

In this section we will see how can we retrieve the sites from our database table and dynamically populate an HTML table. So we will add an empty asp table to the webpage. Because we need to refresh this table every time an operation is performed, we will create a private method in our class that performs the query on the database and populates the table:

private void RefreshSitesTabe()
{
    SitesTable.Controls.Clear();
    using (ISession session = factory.OpenSession())
    {
        ICriteriasc = session.CreateCriteria(typeof(Site));
        siteList = sc.List();
        session.Close();
    }
    factory.Close();
    for (int i = 0; i <siteList.Count; i++)
    {
        TableRow row = new TableRow();
        TableCell selectCell = new TableCell();
        Button siteSelectButton = new Button();
        siteSelectButton.Text = "Select";
        siteSelectButton.ID = (i+1).ToString();
        siteSelectButton.Click += SelectButton_Clik;
        selectCell.Controls.Add(siteSelectButton);
        row.Cells.Add(selectCell);
        TableCell idCell = new TableCell();
        idCell.Text = ((Site)siteList[i]).Id.ToString();
        row.Cells.Add(idCell);
        TableCell nameCell = new TableCell();
        nameCell.Text = ((Site)siteList[i]).Name;
        row.Cells.Add(nameCell);
        SitesTable.Rows.Add(row);
    }
}

The code uses an ISession instance which is described as a short lived object representing a conversation between the application and the persistent store, i.e., the database, and really wraps an ADO.NET connection. To get an instance of an ISession, you ask the ISessionFactory instance to open and return such an object through the function OpenSession().

One more thing: For each site we create one more column in the asp table that contains a button called Select. We will use this button to update and delete sites from the database.

INSERT

To insert a new site in the table, we need just a TextBox control and a Save button, so let’s add them to the default.aspx webpage. The important piece of code is in the save button click event handler:

protected void SaveButton_Click(object sender, EventArgs e)
{
    Site s = newSite();
    using (ISession session = factory.OpenSession())
    {
        s.Name = NewSiteTextBox.Text;
        session.Save(s);
        session.Flush();
        session.Close();
    }
    factory.Close();
    RefreshSitesTabe();
}

Again, we will use an instance of ISession which we obtain by calling the OpenSession() method form our ISessionFactory. After that, all we have to do is create a new Site object, set its Name property using the TextBox as input, use our session object to save our Site in the database, and refresh the HTML table to include the newly created site:

UPDATE

To update a site in the database, we will use a TextBox control that is populated when the user clicks a select button from the sites table, and an Update button. The user then modifies the content of this textbox and clicks the update button. The update button event handler code is as follows:

protected void UpdateButton_Click(object sender, EventArgs e)
{
    using (ISession session = factory.OpenSession())
    {
        Site s = (Site)session.Load(typeof(Site), int.Parse(SelectedSiteTextBox.ToolTip));
        s.Name = SelectedSiteTextBox.Text;
        session.SaveOrUpdate(s);
        session.Flush();
        session.Close();
    }
    factory.Close();
    RefreshSitesTabe();
}

Without going into too much implementation details, we issue the SaveOrUpdate command which instructs NHibernate that the info has been updated. To persist the changes to the database, it is essential to use the Flush command, otherwise the changes won't be propagated back to the database. After the update has been performed, we call the RefreshSitesTable() method to view the updated information.

DELETE

This operation is done in the same way as the UPDATE operation. The Delete button click event handler code is:

protected void DeleteButton_Click(object sender, EventArgs e)
{
    using (ISession session = factory.OpenSession())
    {
        Site s = (Site)session.Load(typeof(Site), int.Parse(SelectedSiteTextBox.ToolTip));
        session.Delete(s);
        session.Flush();
        session.Close();
    }
    factory.Close();
    RefreshSitesTabe();
}

Note that a client confirmation dialog is displayed – we implemented this in the Page_Load event:

if (!Page.IsPostBack)

{

this.Button2.Attributes.Add("onclick", "return confirm('Are you sure you want to delete this site?');");

}

And this covers the things we wanted to show you in this tutorial!

For more detailed information, please take a look at the project code.

CMS Online Manual

2013-06-17T00:36:30-07:00

How to build and install CMS

Please refer to How to build and install CMS

Known Issue

CUBRID_CHARSET and CUBRID_MSG_CHARSET

About CUBRID_CHARSET and CUBRID_MSG_CHARSET, please refer to http://www.cubrid.org/manual/91/en/env.html.

There is a Known Issue about CUBRID_CHARSET, http://jira.cubrid.org/browse/TOOLS-3185

Currently, If you do not use "CUBRID_CHARSET=en_US", you need set CUBRID_MSG_LANG=en_US in order to use cubrid manager.

CUBRID Node.js Driver

2012-08-19T17:29:29-07:00

CUBRRID Node.js driver is developed in 100% pure JavaScript, and does not require specific platform compilation.

Github
Download
Node.js specific Questions and Answers
[CUBRID Node.js Driver Release Notes|Release Notes]

Documentation
[CUBRID Node.js API Overview|Node.js API Overview]
[CUBRID Node.js Tutorials|Latest News, Guides and Tutorials]
JIRA Issue Tracker

Watch the following video demo.

CUBRID Node.js Driver Release Notes

2012-12-04T23:43:30-08:00

2.0.2	Stable Release Apr 15, 2013: Key highlights: Bug fixes for the commit and rollback functions. Updated test cases suite to provide fixes coverage.
2.0.1	Stable Release Apr 10, 2013: Key highlights: Refactored Autocommit mode implementation. Bug fixes for the query queue execute error with CUBRID SHARD. Improved Result2Array functions for queries that do not return any records. Updated test cases suite to provide fixes coverage.
2.0	Stable Release Mar 11, 2013: Key highlights: Added compatibility with CUBRID 9.1 release. Support or queries queueing. Support for LOB objects. Support for database parameters. Support for more database schema. Support for separate Prepare and Execute protocol (for improved backward compatibility). Code quality improvements. Issues fixing. New test cases.
1.1.1	Stable Release Jan 15, 2013: Key highlights: Added ActionQueue direct export from the node-cubrid module. Added createDefaultCUBRIDDemodbConnection function wrapper. Added the ObjectsArray function witch returns an array of objects where column names from the query result are keys. Bug fixes for datetime type parsing and _sqlFormat function. Updated test cases suite to provide fixes coverage.
1.1	Stable Release Dec 24, 2012: oficial blog announcement. Key highlights: We now follow "One driver to rule them all" concept. In other words, you can use node-cubrid with any version of CUBRID Database including 8.4.1, 8.4.3, and 9.0.0 (beta). Updated NPM installer. The new driver comes with many code fixes, bugs fixes, and design changes. Rich database support: Connect, Query, Fetch, Execute, Commit, Rollback, DB Schema etc. Out of the box driver events model. 10.000+ LOC, including the driver test code and demos New test cases added. Now 50+. We have significantly refactored the code using JSHint/JSLint code analysis. New documentation. Created new tutorials that we will publish later.
1.0	Milestone 4: Stable Release Oct 29, 2012: oficial blog announcement. Key highlights: Oficial NPM installer. Rich database support: Connect, Query, Fetch, Execute, Commit, Rollback, DB Schema, etc. Out of the box driver events model 10,000+ LOC, including the driver test code and demos 50+ test cases HTML documentation User demos: E2E scenarios, web sites User tutorial ...and many more!
1.0 beta	Milestone 3: Beta Release Oct 3, 2012: oficial blog announcement. Key highlights: Connect, Query, Fetch, Execute, Commit, Rollback, DB Schema, etc. - all have been implemented! Events model 9,000+ LOC, including the test code 50+ test cases nodeunit support Documentation is now available. E2E scenarios 5 demos websites ... and many more additions and improvements!
0.9.9	Milestone 2 Sep 17, 2012: oficial blog announcement. Key highlights: https://github.com/CUBRID/node-cubrid project now contains 3,000+ LOC. Connect/Close connection, Query/Close query, Fetch, Batch Execute, Set auto-commit, Commit, Rollback, Implicit Connect etc. are fully implemented. More data types support implemented. Complete driver events model implemented 30+ functional test cases 30+ unit tests 3 E2E demos 4 Web site full demos Video demo ... and many more additions and improvements
0.9.0	Milestone 1 Aug 23, 2012: oficial blog announcement. Key highlights: Basic driver interfaces: Connect/Close, Query, Execute, Fetch, Close request etc. completed 2.000+ LOC 15+ functional test cases 15+ unit tests E2E demos

CUBRID Manager Server

2013-05-16T18:27:01-07:00

CUBRID Manager Server (CMS) is a server-side component which communicates with [CUBRID Manager] Client Tool, the most powerful tool to manage the CUBRID Databases. CUBRID Mananger server(CMS) is a sub-system of CUBRID engine package and works independently from CUBRID engine and Broker processes. It provides both HTTP and socket interface to manage and monitor CUBRID Engine for almost all needs which can be thought of.

[CMS Key features | Key features]
[CMS build and install | How to build and install CMS]
[CMS Socket Interface | CMS Socket Interface]
[CMS HTTP Interface | CMS HTTP Interface]
Questions and Answers

Release process ([Process of CUBRID tools development and release_kr|한글])
Release Notes ([cms-release-notes|English])
Online Manual([cms-online-manual|English])
CMS JIRA Issue Tracker
CMS Dev Repository

sql_log 관련

2013-06-16T23:34:43-07:00

큐브리드의 SQL 질의 로그는 sql_log 폴더의 broker*.sql.log, broker*.slow.log, query_editor*.sql.log, query_editor*.slow.log에
저장되는 걸로 알고 있습니다. 최대 100M까지 저장되고 만약 사이즈가 넘어가면 이전 로그가 지워지면서 최근 내용이 기록되는 형태로요.

그런데 저희가 사용하는 테이블 중에서 특정 데이터만 삭제되는 현상이 발생했습니다.
물론 이 특정 데이터는 delete from temp where pid = 0 과 같은 특정 질의를 통해서만 가능합니다.
그래서 위 sql_log 폴더를 확인해봤지만 특정 데이터만을 삭제하는 질의를 찾을 수가 없었습니다.

이처럼 sql_log 폴더의 로그에 남지않고 큐브리드 데이터 삭제가 가능한지 알고 싶습니다.

CUBRID Web Manager Release Notes

2012-06-11T21:20:04-07:00

CUBRID Web Manager 9.1.0 Build 0001 (2013-04-24)

Supported CUBRID version

CUBRID 9.1.0

Sub-task

[TOOLS-2858] - If not "admin", disable DB operation/Variables/Automations view before service support to config these auth

Bug

[TOOLS-2337] - (CWM-UI) The UI error for longer table name is as the images of attachment.
[TOOLS-2339] - (CWM-Favorites) Opening the link haven't any response with invalid URL "http://$%&*" or "$%&*".
[TOOLS-2342] - (CWM-database) The database name "mmm" of head frame is incorrect style.
[TOOLS-2348] - The pie of disk space can be changed after clicking items in the right side.
[TOOLS-2368] - The displaying of long table name is wrong.
[TOOLS-2374] - (CWM-CMS) The primary key of long table and long column can't be edited and droped.
[TOOLS-2396] - (CWM-change password) The event has no release with changing password and selecting username so that other buttons can't be clicked.
[TOOLS-2398] - (CWM-CMS-AdminUser) The brokers, monitors and users information of head-panel can't be shown after connecting to CUBRID with CMT-JDBC.
[TOOLS-2469] - "Manager Server Version" shows 9.0.0.0016 while CUBRID is 8.4.1.7007
[TOOLS-2613] - (CWM- Variables) Check the duplicate variables "SESSION_TIMEOUT".
[TOOLS-2713] - When clicking on "Add Job" button in Automation tab, a Warning message appear
[TOOLS-2743] - Why does CWM output user and database password to browser console?
[TOOLS-2906] - Query having for orderby_num() returns syntax error in CWM because of internal-forcing LIMIT clause
[TOOLS-2929] - (CWM) If step by step to stop every broker , there is no way to start all brokers.
[TOOLS-2954] - CLONE - (CWM-CMS) The primary key of long table and long column can't be edited and droped.

Improvement

[TOOLS-1769] - (BUG BASH) 다중 호스트 지원
[TOOLS-2338] - (CWM-Favorites) The URL string didn't judge the only space " ". Judging valid URL with regex may be better.
[TOOLS-2343] - (CWM-Users) Clicking the blank space cause of combox values dropdown event as image.
[TOOLS-2347] - (CWM-sendmail) Please show message "current sender account..." or similar to user about "Auto Log Report Management" list.
[TOOLS-2358] - (CWM) The send-mail time should be able to be set by user.
[TOOLS-2487] - Improvement for CWM 8.4.3.201301
[TOOLS-2493] - DATETIME field is not put within quotes when inserting data into table
[TOOLS-2622] - When CWM asks to change the password, it should set focus on the password field automatically
[TOOLS-2632] - Update code to be compatible with CMS after CMS changed save/read sharing logs interface
[TOOLS-2655] - Replace the default spinner to this CUBRID spinner
[TOOLS-2712] - When "Add" button is clicked to create a new CM user, focus should be automatically placed to username field
[TOOLS-2726] - Update CWM to check username and password
[TOOLS-2737] - Add a Refresh button to Users tab in CWM
[TOOLS-2747] - The Variables parameters name should be consistent format, for example all to UpperCase() or CamelCase.

Task

[TOOLS-2352] - Log query and report improve

CUBRID Web Manager 8.4.3 Build 0009 and 9.0.0 Build 0004 (2012-12-17)

Supported CUBRID version

CUBRID 8.4.x
CUBRID 9.0.0

Bug

[TOOLS-2226] - (CWM-USER) Create the existed user successfully.
[TOOLS-2232] - (CWM-Broker) The item value of clicking droplist box can't be input after clicking the "Clear History" button.
[TOOLS-2240] - (CWM-Query) The pop-up message box should show "... 10 criteria rows!" with rows maxmum.
[TOOLS-2291] - Databases tab doesn't refresh in CWM when Refresh button is clicked
[TOOLS-2363] - (CWM-Monitors) The databases status can't be shown in first page when one database is running n standalone mode.

Improvement

[TOOLS-1458] - (BUG BASH) Shall we make the PK column highlighted?
[TOOLS-1639] - (BUG BASH) First run default password not clear
[TOOLS-1802] - (BUG BASH) Localizations for CWM
[TOOLS-1867] - (BUG BASH) Auto-scroll to the last element when adding a new column - create table window
[TOOLS-2188] - Insert improve: if no column in table, give out tip message instead of insert operation panel
[TOOLS-2197] - TableStructure improve: if table name has single quotes, there should show tablestructure correctly
[TOOLS-2199] - Auto Backup Plan improve: default path should be 'prefix/dbname/backup'
[TOOLS-2201] - Improve: make CWM better use
[TOOLS-2210] - Improve: use CCI/sql interface instead of CMAPI to complete DB login and user group authorize jobs.
[TOOLS-2239] - (CWM-SQL) The Hide-button tips is the same to the Show-button tips.
[TOOLS-2286] - Ctab improve: make the width auto ajust to its content
[TOOLS-2301] - DB query UI improve
[TOOLS-2333] - (CWM-importdb) Please add the importing csv's message: success number and fail content.
[TOOLS-2334] - After refresh DB list/CM user auth, refresh reference page
[TOOLS-2346] - Broker Improve: show the CAS info correctly
[TOOLS-2349] - "Share with URL" had better be web link and can be clicked to open.

New Feature

[TOOLS-2053] - I18N properties file.
[TOOLS-2246] - Log report and query
[TOOLS-2268] - CWM support multi language select
[TOOLS-2321] - User can see status per DB in Monitor

CUBRID Web Manager 8.4.1 Build 0006 and 9.0.0 Build 0003 (2012-10-31)

Supported CUBRID version

CUBRID 8.4.x
CUBRID 9.0.0

Improvement

[TOOLS-2068] - Monitor improve: if a CMS user has no authority on a DB, should never see the space info about that DB in Monitor
[TOOLS-2078] - CM user management improve: action column should not be sorted
[TOOLS-2148] - Table structure improve: use less ajax request to reduce the wait time
[TOOLS-2160] - Index improvement: fix the problem that rename index/unique index/primary key failure and no message alert
[TOOLS-2166] - Refresh current table after import into table operation
[TOOLS-2167] - Change the export path after Web manager file path changed

New Feature

[TOOLS-2115] - Favorites web links user-definable.
[TOOLS-2116] - Add automation feature into CWM

CUBRID Web Manager 9.0.0 Build 0001 (2012-09-28)

Supported CUBRID version

CUBRID 8.4.0 +

Bug

[TOOLS-1431] - If length is over range, it won't report an error when we create a table
[TOOLS-1835] - Selecting x instead of Ok doesn't refresh the indexes
[TOOLS-1913] - XSS in "Login Database" operation
[TOOLS-1914] - XSS in "default value of column" from create table dialog
[TOOLS-1915] - XSS in "Rename Index" operation
[TOOLS-1916] - Stored XSS in "Add Backup" operation
[TOOLS-1917] - missing protection against ClickJacking

Improvement

[TOOLS-1405] - Improve UI of "Table Name" field in "Create table" window
[TOOLS-1409] - In "Edit Column" window after selecting a column in "Position" combo box, the "After" option should be auto selected
[TOOLS-1410] - For numeric data types, the "Length/Values" field should be disabled
[TOOLS-1443] - When create table, can not set the auto increment feature
[TOOLS-1449] - When create table column, the sequence type can not set the sub type
[TOOLS-1451] - When create table column and set default value, do not validate the default value according to type
[TOOLS-1476] - When add default values isn't belong to the data type, it hasn't any warning and it hasn't save the value
[TOOLS-1494] - The cms user login CWM, the databases display error, and the authority isn't right.
[TOOLS-1706] - Last auto-backup date and status
[TOOLS-1762] - DB login improve: if DB user auto login failure due to incorrect password or stopped DB, should clean the remembered login status and return home view
[TOOLS-1811] - Confirmation for admin logout
[TOOLS-1897] - Logout user when cubrid is down or browser data deleted
[TOOLS-1899] - Alphabetically sort databases in the disk space usage window
[TOOLS-2004] - DB management improve: only 'admin' user can stop/delete DB
[TOOLS-2006] - CWM monitoring dashboard: No need to duplicate the title of graphs
[TOOLS-2007] - Broker improve: when auto refresh brokers status, if server is busy, there should be no error in console and no error alert window
[TOOLS-2008] - Change combo box to a checkbox in a Brokers tab
[TOOLS-2009] - Add tooltips/popover for broker information
[TOOLS-2010] - CWM login improve: remember last time login successful CMS user
[TOOLS-2041] - Add copyright comments into source code.
[TOOLS-2045] - Auto focusing on the password input box, when show the admin user login main page.

New Feature

[TOOLS-1407] - Add "AUTO_INCREMENT" field to "Edit Column" window
[TOOLS-1957] - Support db login via remote broker user-defined

CUBRID Web Manager 8.4.1 Build 0004 (2012-08-29)

Supported CUBRID version

CUBRID 8.4.0 +

Bug

[TOOLS-1052] - The right head-frame has no auto-refresh function
[TOOLS-1055] - When creating or editing user page was closed, the privileges page didn't refresh automatically and update user list view.
[TOOLS-1122] - The longin-page can't be opened

[TOOLS-1141] - The change-admin-password function need to increase a logic of judging whether the new password contains space and "admin".
[TOOLS-1143] - The create-database function need to increase a logic of judging the new database name's format
[TOOLS-1184] - The create-database function can't create the database of starting with "_" successfully
[TOOLS-1193] - The table-insert function fail to insert correct data.
[TOOLS-1195] - The navigator panel link status didn't update when logout from database.
[TOOLS-1196] - The "export/import table and database" function's affects.
[TOOLS-1270] - The Disk-Space-Detail-UI's scrollbar can't adapt to the screen automatically.
[TOOLS-1297] - The Auto-backup-plan function needs to limit the thread number and backup file number.
[TOOLS-1329] - cub_cmserver start 명령 수행 시에 에러 발생.
[TOOLS-1330] - Input a existed database name with "create database" function, having no error message.
[TOOLS-1334] - Check Privileges Button does not work
[TOOLS-1335] - Deleting the last database does not refresh list
[TOOLS-1336] - All the button titles longer than 1 word are only partially within their background
[TOOLS-1337] - The database name on left frame can't be refreshed out when create only a database.
[TOOLS-1341] - Cubrid Manager Variables are incorrectly displayed
[TOOLS-1342] - Rename table to a name that already exists returns "successful"
[TOOLS-1343] - Typo - No fields choosed
[TOOLS-1344] - Incorrect message - Table was droped successfully
[TOOLS-1345] - "Select All Tables" checkbox doesn't work after dropping all tables
[TOOLS-1346] - When tables are referenced and can't be dropped directly no error message
[TOOLS-1347] - Cannot create table if not all columns are filled. No error is displayed.
[TOOLS-1350] - When creating a table and clicking on a "Save" button, it gives "Syntax: syntax error, unexpected ')'" error
[TOOLS-1353] - "Refresh" button doesn't always refresh the list of table in dropdown box
[TOOLS-1354] - No "Cancel" button when editing a column
[TOOLS-1356] - Typo - Passwords do not match
[TOOLS-1358] - IMPORT시에 종료되지 않음.
[TOOLS-1362] - After tables are dropped, the dropdown box with list of tables is not updated
[TOOLS-1364] - Various Typos
[TOOLS-1365] - Regular User shouldn't be able to check/uncheck privileges
[TOOLS-1366] - Cannot give/remove select access to new users
[TOOLS-1371] - The process bar didn't close with inputing incorrect password when modify database user's password.
[TOOLS-1373] - The pop-up information boxe's style of dropping database is inconsistent.
[TOOLS-1375] - The login page didn't judge whether the user name and password is empty.
[TOOLS-1377] - Database-Query function's affects.
[TOOLS-1378] - Create table successfully without inputing a column name and only data type.
[TOOLS-1380] - when log-in to online DB, it pops up "server error!Please try later"
[TOOLS-1392] - Incorrect path displayed when importing files (C:\fakepath\)
[TOOLS-1393] - Cannot import csv file that does not have double quotes around each column
[TOOLS-1394] - Fatal error after dropping column in table with 1 column
[TOOLS-1395] - Various Typos in Backup screen
[TOOLS-1398] - Grant Execute field is still clickable
[TOOLS-1399] - syntax error, unexpected ')', expecting '('
[TOOLS-1400] - Message cannot be viewed properly
[TOOLS-1403] - Typo in "Change login password for administrator"
[TOOLS-1408] - In "Edit Column" window the same column name should not be in "Position" combo box
[TOOLS-1413] - In "Add column" window cannot remove value of the optional field. Also marked in red as if required or incorrect.
[TOOLS-1415] - cub_cmserver start reports error, but we can also use it normally on Linux
[TOOLS-1425] - Information about broker appear abnormally on chrome
[TOOLS-1435] - Should be fixed a message on the import when you choose the loaddb of the format field
[TOOLS-1436] - When start the CUBRID, the error '' reported
[TOOLS-1438] - Should be fixed an error message on the SQL tab if your table don't have any columns.
[TOOLS-1447] - Cannot login database 8.4.1.2032 by CWM
[TOOLS-1448] - The infomation on Disk Space Detail is wrong
[TOOLS-1453] - The change-password function's error: The pld password is incorrect!
[TOOLS-1459] - The drop-column's UI-display is inconsistent.
[TOOLS-1460] - The database-query's UI-display has error for IE9 at sometimes .
[TOOLS-1463] - The import csv data function has error.
[TOOLS-1464] - statement 'Create' 'Insert' Select can excute successfully but 'Drop' fail to excute if the table name has chinese character
[TOOLS-1467] - The UI should support Utf8 character for table name
[TOOLS-1468] - There should be a delete button when add new columns
[TOOLS-1471] - The export-sql and import-sql function has error.
[TOOLS-1472] - user can update other user's table
[TOOLS-1473] - The start-database's UI-display is inconsistent.
[TOOLS-1475] - Add a new user fail.
[TOOLS-1477] - A SQL query LIKE condition issue for Chinese and Korean contents
[TOOLS-1478] - Add column can't report error
[TOOLS-1485] - The UI should support Utf8 character for user name
[TOOLS-1489] - CWM can't start or stop cubrid broker
[TOOLS-1493] - Columns can't be added in query page
[TOOLS-1498] - Two button are overlap
[TOOLS-1500] - Cannot close the 'Add a new user' dialog.
[TOOLS-1502] - Column can't display completely on query page
[TOOLS-1504] - When type of a column is float, it can't input a value
[TOOLS-1506] - A position error in the column edit page
[TOOLS-1507] - About database tree
[TOOLS-1508] - Create table without column should create successfully
[TOOLS-1509] - "Create Table" page need to click twice to show edit box
[TOOLS-1510] - Using search many times, Server always return “server error! Please try later!”
[TOOLS-1513] - The error info cannot display completely
[TOOLS-1515] - "Create Table" page was edit as bugbash_4.jpg, save, IE8 error happend as bugbash_5.jpg
[TOOLS-1516] - Why don't we input the old password when changing the DBA user password?
[TOOLS-1517] - Format should be choosed before File.
[TOOLS-1518] - Create table fail if the table name is 'test'
[TOOLS-1519] - when create table columns, can not delete column
[TOOLS-1521] - “Insert” a record to a table, found the same record was inserted twice.
[TOOLS-1525] - Cannot insert bit data type .
[TOOLS-1528] - When column type is sequence(numeric(15,3)), then edit the column,the showed information is not right
[TOOLS-1529] - The record number limit field cannot display completely in win XP
[TOOLS-1530] - There should be some message when user search in tables but forget to select any table
[TOOLS-1531] - when create table column, can not create the type NUMERIC(10,3)
[TOOLS-1535] - “Insert” a record to table2(id,name), found only "id“ was inserted
[TOOLS-1536] - CWM UI issue: the constant (no stretching) menu navigation has some constraints
[TOOLS-1545] - impode the CSV file fail
[TOOLS-1550] - The search result is wrong
[TOOLS-1553] - Default value has bug
[TOOLS-1554] - 'System error timeout' occurs when selecting large size of data.
[TOOLS-1555] - when this table is range partition table, set the column is primary key, it's index information is not right
[TOOLS-1558] - Excute rename table to "test" should successfully
[TOOLS-1574] - The result of query isn't right.
[TOOLS-1582] - There isn't error when update data by user which hasn't update authority.
[TOOLS-1590] - Add nothing and click the save button in the add column page, no error returns.
[TOOLS-1591] - typo, wrong word is using
[TOOLS-1593] - Not Null constraint and null default value are not checked when creating table.
[TOOLS-1594] - After adding a column, not null constraint and null default value can exist together in a column.
[TOOLS-1597] - Entering negative length displays "false" error message
[TOOLS-1602] - Errors when fields are empty are incorrectly displayed
[TOOLS-1635] - Search in database
[TOOLS-1637] - Problem stricted check column's data type mapping on the object mapping wizard
[TOOLS-1648] - password in add user dialog cannot contain a single quotation mark (')
[TOOLS-1659] - Add New Table 띄운 상태에서 홈으로 이동 됨
[TOOLS-1667] - Foreign Key를 가진 테이블의 truncate 결과 불일치
[TOOLS-1668] - Foreign Key를 가진 테이블의 drop 결과 불일치
[TOOLS-1673] - Incorrect text in monitors graphic explanation box
[TOOLS-1674] - Grammar errors in delete database confirmation dialog
[TOOLS-1677] - Brokers are not starting
[TOOLS-1686] - Old password asked when trying to enter a new password with empty fields
[TOOLS-1687] - Privileges tab is not selected
[TOOLS-1688] - Incorrect text for creating database tables
[TOOLS-1689] - Structure tab is not selected by default when user logs into a database
[TOOLS-1691] - Unaligned text fields in the create table section
[TOOLS-1699] - Can't enter the database if using a longer password
[TOOLS-1707] - Offline auto-backup not working
[TOOLS-1708] - Add columns after an unexisting one works
[TOOLS-1710] - Confusing search results text
[TOOLS-1720] - Started database shown as stopped
[TOOLS-1721] - Drop down opens outside window
[TOOLS-1726] - Browse 테이블 그리드에서 데이터 수정 시, 데이터 내의 개행문자 사라짐
[TOOLS-1743] - Always inactive Cancel button
[TOOLS-1773] - default 값이 HTML 형식의 태그일 경우 structure에서 표시되지 않음
[TOOLS-1785] - Columns number is not checked before trying to add them
[TOOLS-1797] - Search returns no results when exact phrase is selected
[TOOLS-1829] - Don't allow operations to the table while importing/exporting
[TOOLS-1855] - If record number limit is too big a database can be downloaded
[TOOLS-1862] - Special character appears under a table name with special characters
[TOOLS-1863] - Animation is not working anymore after a longer processing time
[TOOLS-1868] - Incomplete confirmation dialog when adding pk/uk to multiple columns
[TOOLS-1870] - Drop down list appears far from the drop down button
[TOOLS-1873] - Exported table missing data

Improvement

[TOOLS-1061] - Broker manger improvement
[TOOLS-1075] - Add function to DatabaseListView's check privileges icon
[TOOLS-1090] - change prompt info for 'truncate table' and 'drop table'.
[TOOLS-1094] - change logic when add primary key
[TOOLS-1096] - Add message box before the operation in table management view
[TOOLS-1202] - remove the magic number when call getComponent function
[TOOLS-1203] - remove the progress dialog when open database, it will block the UI sometimes when run on IE8
[TOOLS-1204] - Bugfix: white page after login success in IE8
[TOOLS-1210] - Monitor improvement
[TOOLS-1224] - Remove the 'save password' feature in database login window
[TOOLS-1225] - Monitoring - UI redesign and refactor
[TOOLS-1273] - Improve database authorization: add check/uncheck all function to column
[TOOLS-1274] - Improve database user group: check the groups
[TOOLS-1275] - Improve CookieUtil.js: check unreadable cookie name and optimize
[TOOLS-1310] - Improve change DB user password: check space(' ') in new password when changing password
[TOOLS-1311] - Improve DB user group: Remove 'PUBLIC' from user list
[TOOLS-1312] - Improve DB user authorization: remove all the tables whose owner is default user-'PUBLIC' in grid
[TOOLS-1313] - Improve Monitor: use gauge instead area chart in view and 'column chart' in detail window
[TOOLS-1314] - Improve create new DB user: check space(' ') in new password, and give out prompt
[TOOLS-1327] - Tooltips in Monitor tab disappear too fast
[TOOLS-1331] - Remove unusable 'UserCenter.js' from project
[TOOLS-1338] - Insert into table should catch "Error: -494 - Semantic:" when no elements entered
[TOOLS-1339] - Fields that need to be filled look like plain text and seem uneditable
[TOOLS-1340] - Browse section only works for 100 rows without manually setting limit
[TOOLS-1348] - When creating a table with the same name as the existing table, it should give warning message
[TOOLS-1349] - Add a spinner to a login page
[TOOLS-1351] - In Create table window, when focus is on "type" dropdown box it should listen to keystrokes
[TOOLS-1352] - Allow to Select All indexes in Table view just like select all columns
[TOOLS-1355] - No way in GUI to add Foreign key
[TOOLS-1363] - Improve DB user list: user can only be removed one by one
[TOOLS-1367] - Table list should be sorted alphabetically
[TOOLS-1372] - Improve DB auth: add missed authorized info when login user is not a dba
[TOOLS-1376] - Please check the consistency of all the tips or labels of uppercase and lowercase letters.
[TOOLS-1385] - DB search improvement: modify to make user use it more simply, easily
[TOOLS-1388] - when exporting structure and data into loaddb format, it exports only "obj" file without schema?
[TOOLS-1389] - supporting multi values insert in the Insert menu
[TOOLS-1390] - In the Variables>there is a typo <Borker> and its displaying order should be changed
[TOOLS-1402] - Improve "Change login password for administrator"
[TOOLS-1414] - If default value is defined for a column, when trying to insert new record, it should allow if value is empty
[TOOLS-1417] - Start broker button in action is not obvious for users
[TOOLS-1421] - CWM UI issue: the table list isn't displayed properly
[TOOLS-1422] - when add a column in table, which column is necessary is important for user.
[TOOLS-1424] - index column has "---'
[TOOLS-1426] - go button should be changed into insert
[TOOLS-1427] - column need to be insert should be highlight
[TOOLS-1431] - If length is over range, it won't report an error when we create a table
[TOOLS-1441] - Should be reloaded on the left tree when you create/modify/drop some tables
[TOOLS-1452] - add column should not go to a new page
[TOOLS-1466] - There should be a cancel button when we insert new columns
[TOOLS-1470] - Buttons at the bottom of create table page are too crowed
[TOOLS-1483] - System error occurs when executing prepare statement.
[TOOLS-1488] - password should be display in a proper value
[TOOLS-1491] - Change go button to OK on privileges page
[TOOLS-1495] - It will turn white when the mouse move on it on browse table page
[TOOLS-1505] - When put the mouse to the column name ,the background became to white. The column name cannot see clearly.
[TOOLS-1514] - Error message should be more precise when fail to create table
[TOOLS-1538] - the Enter button is not work!
[TOOLS-1542] - Cannot point data type for set .
[TOOLS-1543] - When the column inherit from super class, the column related function should be disabled.
[TOOLS-1580] - when add backup plan, there is not a cancel button to return the operations page
[TOOLS-1584] - The host title is always localhost, should display the real IP
[TOOLS-1589] - 'Cancel' button should be added to add column page.
[TOOLS-1595] - Hover over header fields
[TOOLS-1598] - Checkbox is not centered
[TOOLS-1601] - Column size should be limited
[TOOLS-1605] - Broker improve: when all brokers are stopped, should show the states precisely
[TOOLS-1606] - DB query improve: if one table has no column, the DB query should run precisely
[TOOLS-1608] - Improve: if table/column/user name is keyword in CUBRID, the CWM should run correctly
[TOOLS-1609] - DB search improve: if one table has no column, DB search should run precisely
[TOOLS-1622] - DB query/search improve: create UI before load data, Refactor DB query.
[TOOLS-1640] - Monitor Improve: system disk info should get all disks' info in windows
[TOOLS-1654] - 특정 테이블 > Browse
[TOOLS-1655] - 우측 메인 화면 가로 스크롤이 불필요하게 생김
[TOOLS-1660] - character varying 으로는 컬럼 타입 지정 안됨
[TOOLS-1665] - Check for updates 동작하지 않음
[TOOLS-1669] - 테이블 명 변경 시, 처리 중 처리
[TOOLS-1675] - The view is not restored when password is typed wrong in the administration authentication dialog
[TOOLS-1678] - The auto refresh value for the brokers is not saved
[TOOLS-1694] - Update table field dialog is too snug by default
[TOOLS-1696] - Don't open new popup when trying to export database
[TOOLS-1705] - Explain the table dropdown
[TOOLS-1709] - Browse button is not highlighted in the Search section
[TOOLS-1734] - The user around database doesn't fit if one of them is too long
[TOOLS-1735] - Incorrect text when 1 table is created
[TOOLS-1737] - Interface freezes for about 2 minutes when trying to create a table with 100 columns
[TOOLS-1747] - Open Query drop down in full
[TOOLS-1767] - Small letter for column definition
[TOOLS-1776] - Monitors 메뉴의 용량 표기법 통일
[TOOLS-1778] - Can't see full error when running big sql query
[TOOLS-1780] - Inconsistency in message box
[TOOLS-1781] - Add option has the Edit icon
[TOOLS-1786] - Import file field gets cleared when Format is selected
[TOOLS-1787] - Owner of a table should be allowed to import to that table
[TOOLS-1799] - Same error message when trying to delete criteria rows in Query section
[TOOLS-1800] - Query tab is unselected after executing a query
[TOOLS-1801] - Incorrect display of empty dropdown
[TOOLS-1827] - Missing trademark from the initialization page
[TOOLS-1848] - Don't allow exporting of empty data
[TOOLS-1857] - Incorrect text when creating a table
[TOOLS-1864] - Verify if database exist in CWM - manual delete from disk
[TOOLS-1871] - Text issue when dropping columns
[TOOLS-1874] - Round up kernel cpu usage percentage
[TOOLS-1880] - Table list only has 50 tables if the tables in DB are more than 50
[TOOLS-1881] - Insert Improve: if column name is too long to show correctly, give out finite numbers character with '...' following
[TOOLS-1883] - DB query/search improve: if table name is too long, the table list area is overflow the panel on horizontal

New Feature

[TOOLS-937] - main page and frame of web manager console
[TOOLS-938] - retrieve and list all existing databases on left panel of console
[TOOLS-939] - retrieve and list all existing databases on 'Databases' tab of main console
[TOOLS-940] - start database on 'Databases' tab of main console
[TOOLS-941] - stop database on 'Databases' tab of main console
[TOOLS-942] - create new database on 'Databases' tab of main console
[TOOLS-943] - drop (delete) database on 'Databases' tab of main console
[TOOLS-946] - drop (delete) user of a database in 'Privilege' tab of database main console
[TOOLS-1054] - Query Editor - row editable
[TOOLS-1059] - Query helper for database
[TOOLS-1060] - Operations of database
[TOOLS-1063] - Query Editor - row delete
[TOOLS-1077] - Keyword Search in a DB's tables
[TOOLS-1078] - database export and import
[TOOLS-1091] - Show the status detail of each broker
[TOOLS-1100] - Show cubrid setting variables and Server informations
[TOOLS-1123] - Monitor for broker status, DB status, DB performance, Host Performance
[TOOLS-1135] - Query editor - query plan and explain
[TOOLS-1223] - Retrieve and list all server ports in Variables tab.
[TOOLS-1255] - New feature - db auto backup plan
[TOOLS-1290] - Export source tables into separate data files if exporting to database unload files.
[TOOLS-1357] - User should be able to go back to previous screen
[TOOLS-1396] - Only show file name in file upload in Import View
[TOOLS-1397] - refresh table list and field list when click structure tab

Task

[TOOLS-1083] - Can't delete the index if table name like xxx_xxx, and no message before remove the index
[TOOLS-1093] - add failed message when insert a row

CUBRID Web Manager 8.4.1 Build 0003 (2012-07-31)

Supported CUBRID version

CUBRID 8.4.0 +

New features

Provides the web-based GUI and user-friendly widget, panel and navigator.
Allows CM server administrator to login, logout and to change the password.
Allows to browse and manage databases.
Allows to browse and manage database users and privileges.
Provides a convenient way to browse and manage table schema or structure and it allows to manage indexes and records.
Provides Data Import and Export functions for various file formats.
Provides SQL query editor to execute user-defined SQL statements and display query results and it allows user to update or delete records visually.
Allows to browse and check brokers with their status details.
Allows to browse and check the variable settings for CUBRID server, manager server and brokers.
Provides visual tools to graphically monitor the performance and status of host server, databases and brokers

Known Bugs

[TOOLS-1534] - (BUG BASH) When you have partition tables, the shown style is not correct in navigator
[TOOLS-1571] - (BUG BASH) The UI should forbid insert date on partitioned table
[TOOLS-1592] - (BUG BASH) db can't be stopped after loading a large data file
[TOOLS-1600] - (BUG BASH) The value returned by select statement is inconsistent with data in database
[TOOLS-1537] - (BUG BASH) When selected table is sub partition table, the related operations should be disabled.
[TOOLS-1551] - (BUG BASH) In table list, if this table is sub partition table, the Drop actions should be disabled.
[TOOLS-1552] - (BUG BASH) Error box pops out, but no message has been shown when dropping a partition table.
[TOOLS-1555] - (BUG BASH) when this table is a range partition table and you set the column as primary key, its index information is not right

CMT Release Note Summary_kr

2013-06-16T22:21:39-07:00

2013년 5월 릴리스

1. 릴리스 버전 : CMT-2013.05

2. 다운로드

- FTP 서버: ftp://ftp.cubrid.org/CUBRID_Tools/CUBRID_Migration_Toolkit/2013.05/

- 영문 커뮤니티: http://www.cubrid.org/?mid=downloads&item=cubrid_migration_toolkit

3. 주요 개선 사항

- 마이그레이션 마법사를 개선하여 CSV/SQL 또한 하나의 마이그레이션 마법사로 선택할 수 있도록 하였습니다.

- 마이그레이션후 생성되는 이력을 이용해서 다시 마이그레이션을 할 수 있습니다.

또한 실패한 테이블은 수작업으로 선택하지 않고도 자동 선택되어 다시 마이그레이션하도록 옵션으로 지원됩니다.

- 마이그레이션을 다중으로 예약할 수 있습니다.

마이그레이션 마법사 UI 개선

기존 SQL/CSV 마이그레이션이 마이그레이션 마법사에 통합되었습니다. 통합된 마이그레이션 마법사로 원본, 대상 유형을 더 쉽게 선택하고 마이그레이션할 수 있게 되었습니다.

다중 예약 지원

기존 버전에는 1개의 예약만 지원하였으나 이제는 여러개를 동시에 예약해둘 수 있습니다. 그러나, 동시에 실행되지 않기 때문에 동일 시간으로 예약될 경우 다른 동일시간에 예약된 작업은 실행되지 않습니다.

예약방법은 두 가지 방법으로 할 수 있는데, 마이그레이션 마법사 5단계에서 "시작하기"를 누르면 나오는 "예약하기" 버튼으로 예약할 수 있습니다.

아래의 창에서 1회 실행 또는 반복 실행 및 고급(Unix/Linux의 CRON에 익숙할 경우)을 사용하여 실행 예약을 할 수 있습니다. 예약할 경우 다른 예약과 시간이 겹치지 않도록 주의가 필요합니다.

두번째 방법은 이미 생성된 스크립트를 선택하고 "스크립트 예약" 버튼을 누르면 위의 화면처럼 예약하는 창이 출력됩니다.

스크립트 선택후 마우스 오른쪽 버튼으로 예약된 스크립트 실행 이력을 보거나 예약 취소를 할 수 있습니다.

실패한 테이블만 다시 마이그레이션

마이그레이션 완료후 아래 그림처럼 실패한 마이그레이션이 있을 때 기존에는 실패한 테이블을 하나 하나 선택한 후 마이그레이션을 해야 했습니다. 그러나 실패한 테이블만 다시 마이그레이션할 수 있도록 "마이그레이션 재실행" 기능을 마이그레이션 이력에 추가하였습니다.

"전체 테이블 + 전체 데이터", "실패한 테이블 + 실패한 테이블의 전체 데이터", "실패한 데이터의 전체 데이터"를 옵션으로 선택할 수 있습니다. 그러나 실패한 데이터만 별도로 입력하는 기능은 아직 지원되지 않으며 실패한 테이블의 모든 데이터를 다시 마이그레이션을 합니다 (차기 버전에 실패한 데이터만 별도로 입력 기능 지원 예정).

JDBC 연결 정보에 설정 추가

마이그레이션 마법사에서 사용한 접속 정보는 다시 마이그레이션할 때 편리하도록 재활용되기 때문에 접속명에 사용자가 알아볼 수 있도록 설명을 달 수 있습니다.

2013년 3월 릴리스

1. 릴리스 버전 : CMT-2013.03

2. 다운로드

- FTP 서버: ftp://ftp.cubrid.org/CUBRID_Tools/CUBRID_Migration_Toolkit/2013.03/

- 영문 커뮤니티: http://www.cubrid.org/?mid=downloads&item=cubrid_migration_toolkit

3. 주요 개선 사항

- *.sql, *.csv 마이그레이션 마법사 지원

- 마이그레이션 마법사 3단계에서 오른쪽 매핑뷰에서도 사용자 정의 SQL을 입력할 수 있도록 개선

- 콘솔 마이그레이션 결과 리포트 상세화

- 마이그레이션 마법사 최종 단계에서 바로 마이그레이션할 것인지 예약할 것인지 선택하는 기능 추가

마이그레이션 마법사 추가 - SQL, CSV 파일 입력

새 마이그레이션에 기존 DB > DB 및 파일출력만 지원하였으나, 이번 버전부터 다량의 SQL (DDL 및 INSERT), CSV를 입력할 수 있는 기능이 추가되었습니다. 툴바에서 "새 마이그레이션"을 클릭하면 별도의 추가 메뉴로 이용할 수 있습니다.

1.1 SQL 파일 입력

입력할 SQL 파일을 "추가"로 입력

1.2 CSV 파일 입력

파일명이 테이블명과 일치할 경우 대상 테이블로 자동 매핑

CSV파일의 첫 줄이 제목줄이 없이 데이터만 있을 경우 "제목줄 없음" 선택 기능 제공

콘솔 마이그레이션 결과 리포트 개선

콘솔 마이그레이션 후 결과 리포트를 확인하기 위해서는 mh파일을 CMT UI로 가져와야 했으나,

이번부터 log파일 및 console 표준 출력으로 결과를 확인할 수 있도록 개선되었습니다.

콘솔 마이그레이션이 설치된 경로의 log 디렉토리에 있는 cubridmigration.log 파일에 마이그레이션시

발생한 오류 log와 마이그레이션 결과가 저장됩니다.

마이그레이션 시작전 "바로 시작하기"와 "예약하기" 선택 기능 추가

오른쪽 객체 매핑 화면에서도 사용자 정의 SQL을 입력할 수 있도록 SQL 탭 추가

2013년 1월 릴리스

1. 릴리스 버전 : CMT-2013.01

2. 다운로드

- FTP 서버: ftp://ftp.cubrid.org/CUBRID_Tools/CUBRID_Migration_Toolkit/8.4.3/

- 영문 커뮤니티: http://www.cubrid.org/?mid=downloads&item=cubrid_migration_toolkit

3. 주요 개선 사항

- 성능 옵션을 상세히 설정 가능

- 연결 정보 입력으로 JDBC URL 지원 (오라클 RAC 또는 CUBRID의 zeroDateTimeBehavior 설정 가능)

- XLS 파일로 Export 지원

- 컬럼의 기본값을 표현식(함수) 지정 지원

- CLOB를 VARCHAR로 변환 지원

New performance settings in migration wizard

New preference page:

New performance setting dialog:

Click button “Advanced Settings…” to pop the dialog as follows:

The initialized values in the dialog are from the preference page.
Please input reasonable values, too big values may cause out of memory error.
Implicit estimate option controls the CMT getting total record count from source database.
Because getting record count costs too much time in some big source databases.

Supporting user defined JDBC URL

Click the button “JDBC Advanced…” to pop a dialog as follows:

Users can input JDBC connection URL into this dialog.

Export data with XLS format

CMT supports exporting records with XLS format.
But it is not recommended that there are some records with BLOB/Binary or big Varchar types in the source database.

Define column's default value by expressions

If the “Expression” option is checked, CMT will regard the string in the text box as a SQL expression, so the text will not be quoted with ‘’ in table’s DDL.

2012년 12월 릴리스

1. 릴리스 버전 : CMT-2012.12

2. 다운로드

- FTP 서버: ftp://ftp.cubrid.org/CUBRID_Tools/CUBRID_Migration_Toolkit/8.4.3/

- 영문 커뮤니티: http://www.cubrid.org/?mid=downloads&item=cubrid_migration_toolkit

3. 주요 개선 사항

- 마이그레이션 스크립트를 이용한 마이그레이션 예약 기능 추가

- JDBC 마이그레이션시 실패 SQL을 파일로 별도 저장

- 테이블의 컬럼 순서 조정 기능

- 테이블 매핑시 사용자 정의 SQL로 마이그레이션 전/후 스키마 변경 작업 지원

스크립트 실행 예약

CUBRID Migration Toolkit을 실행한 상태에서 <스크립트 예약> 버튼으로 스크립트 실행 예약이 가능합니다. 시간 예약은 아래의 그림처럼 3가지 방식을 지원하고 있습니다. 1회, 매일 반복, UNIX의 cron 형식을 지원합니다.

예약 실행 이력이나 취소를 하려면 해당 스크립트를 선택후 오른쪽 마우스의 메뉴를 보실 수 있습니다.

이 실행 예약 기능은 UI에서 실행할 경우만 지원하며 CUBRID Migration Toolkit을 종료하게되면 실행되지 않습니다. 유닉스/리눅스 콘솔로 마이그레이션하는 경우에는 UI에서 설정한 예약 실행은 사용할 수 없으며 CUBRID Migration Toolkit Console과 마이그레이션 스크립트를 이용하여 직접 cron에 등록하여야 합니다.

JDBC 마이그레이션 중 실패 데이터를 SQL 파일로 남기는 기능

JDBC 마이그레이션 중 실패하는 데이터를 SQL 파일로 남기는 기능이 추가되었습니다. 마이그레이션 마법사 2단계에서 아래와 같이 <입력 실패 데이터 SQL 로그 파일로 저장>을 체크하시면, CUBRID Migration Toolkit 실행 폴더에 errorsqls 폴더가 생성되며 파일이 저장됩니다.

다량/대용량 SQL 파일 로드 기능

<SQL 파일 실행> 기능을 이용하여 다량 또는 대용량의 SQL 파일을 로드할 수 있습니다.

툴바 버튼을 클릭하면 SQL 파일을 선택하여 마이그레이션을 진행할 수 있도록 마법사가 출력되며, 여기에 입력을 원하는 SQL 파일을 추가하여 다음 단계로 진행할 수 있습니다. 2단계에서 입력될 데이터베이스를 선택한 후 마이그레이션을 시작할 수 있습니다.

3단계 객체매핑에서 테이블별로 마이그레이션 이후의 컬럼 순서를 변경하는 기능을 지원합니다.

또한, 테이블이 생성된 직후(데이터 마이그레이션 직전)에 실행할 SQL과 테이블 마이그레이션이 완료된 이후 실행할 SQL을 사용자 정의할 수 있는 기능을 지원합니다.

Documentations for release

2012-12-24T03:22:02-08:00

Home

Manual

CM - Korean, English
CQB - Korean, English
CMT - Korean, English
CWM - Korean, English

Release Notes

New Features

CM/CQB : [release-note-summary_kr|All] , [New Features of CM 8.4.1.201208_kr|2012.08] , [New Features of CM 8.4.3.201212_kr|2012.12] , [New Features of CM 2013.03_kr|2013.03] , [New Features of CM 2013.05_kr|2013.05]
CMT : [cmt-release-note-summary_kr|All], [New Features of CMT 8.4.3.201212_kr|2012.12] , [New Features of CMT 8.4.3.201301|2013.01], [New Features of CMT 2013.03_kr|2013.03], [New Features of CMT 2013.05|2013.05E] [New Features of CMT 2013.05_kr|2013.05K]
CWM : [CWM Release Note Summary|8.4.3.0009]

QA Reports

[CUBRID Manager QA Report]
[CUBRID Query Browser QA Report]
[CUBRID Migration Toolkit QA Report]
CWM

Known Issues

CUBRID OLEDB Driver Installation Instructions

2013-04-26T01:39:49-07:00

The scope of this tutorial is to provide an introduction to the CUBRID OLEDB Data Provider. We will show you where to get the CUBRID OLEDB Provider library, how to setup a CUBRID connection and how to develop some simple applications, mainly using OLE DB Consumer templates.

Notice: If your CUBRID OLEDB driver version is 9.1.0.p1 or later, only one installation package is needed for both Windows 32 bit and 64 bit. Our new OLEDB installer supports CUBRID DB engine 8.4.1 or later.

If your CUBRID OLEDB Driver version is 9.1.0 or older, it may have a problem on 64 bit operating system. Please see our installation tutorial for an old version: http://www.cubrid.org/wiki_apis/entry/cubrid-oledb-driver-installation-instructions-old

Download

Download a new installation package file which name is "CUBRID_OLEDB_Provider-<version>-win32-x64.zip".

It will install both CUBRIDProvider32.dll and CUBRIDPRovider64.dll at once. You can find a CUBRID OLEDB Provider installer at:

http://ftp.cubrid.org/CUBRID_Drivers/OLEDB_Driver/ or

http://www.cubrid.org/?mid=downloads&item=oledb_driver

Driver Installation

Run a CUBRID OLEDB Provider Installer (exe) and click the Next / Install Button.

In your installation directory, you can see the following DLL files and uninstall. exe.

DB Connection

Data Link Properties Dialog Box

To access this dialog box in Visual Studio .NET, select Connect to Database from the Tools menu or click the Connect to Database icon in Server Explorer.
You also can open this dialog box by double-clicking a universal data link (.udl) file in Windows Explorer, and in a variety of other ways, including programmatically.

1）you must install Visual Studio first, click “Connect to Database”

2) Choose <other>,and .Net Famework Data Provider for OLE DB, Then click continue button

3) Choose CUBRID OLE DB Provider, then click Data links button

4) Fill in the information, and click Test Connection button, if driver connect database successful, success dialog will pop up.
More information can found in msdn: http://msdn.microsoft.com/en-us/library/79t8s5dk(v=vs.71).aspx

5) A simple method of open dialog
First, create a text file, and modify extension to *.udl: 1.txt -> 1.udl

Second, double click 1.udl, dialog will pop up.

6) Setting method of character set

Connection String:

"Provider=CUBRIDProvider;Data Source=demodb;Location=10.34.64.104;User ID=dba;Password=;Port=30000;Fetch Size=100;Charset=utf-8;"

7) Setting method of isolevels

Connection String:

"Provider=CUBRIDProvider;Data Source=demodb;Location=10.34.64.104;User ID=dba;Password=;Port=30000;Fetch Size=100;Charset=utf-8;Autocommit Isolation Levels=256;"

OLEDB	Cubrid	Value
ISOLATIONLEVEL_READUNCOMMITTED	TRAN_COMMIT_CLASS_UNCOMMIT_INSTANCE	256
ISOLATIONLEVEL_READCOMMITTED	TRAN_COMMIT_CLASS_COMMIT_INSTANCE	4096
ISOLATIONLEVEL_REPEATABLEREAD	TRAN_REP_CLASS_REP_INSTANCE	65536
ISOLATIONLEVEL_SERIALIZABLE	TRAN_SERIALIZABLE	1048576

If you do not set isolation levels, the default value is 4096.

Configuration

The following tutorials will help you when developing your application thru CUBRID OLEDB Provider.

release-note-summary_kr

2012-12-24T01:24:53-08:00

2013년 5월 릴리스

1. 릴리스 버전 : CM-2013.05 / CQB-2013.05

- 상세 릴리스 노트: http://www.cubrid.org/wiki_tools/entry/cubrid-manager-release-note_kr
- 상세 릴리스 노트: http://www.cubrid.org/wiki_tools/entry/cubrid-query-browser-release-note_kr

2. 다운로드

- CUBRIDManager-2013.05 빌드0120: http://ftp.cubrid.org/CUBRID_Tools/CUBRID_Manager/2013.05/
- CUBRIDQuery-2013.05 빌드0120: http://ftp.cubrid.org/CUBRID_Tools/CUBRID_Query_Browser/2013.05/

3. 주요개선사항

- 엔진 버전 CUBRID 8.2.2 ~ CUBRID 9.1 지원

- 튜닝모드 출력 고도화 (별도 창으로 두개의 질의 실행 계획 비교 지원)

- 멀티 질의 색상 비교 기능 (멀티 질의 후 서로 다른 데이터를 색상으로 시각화하여 가독성 향상)

- 질의 결과 필터 기능 (질의 결과에서 특정 데이터를 찾기 위한 필터)

- SQL 실행 기능 가져오기 마법사에 통합 및 기능 개선

튜닝 모드 결과

튜닝 모드는 질의 편집기의 튜닝모드 버튼이 눌려진 상태에서 계속 동작합니다. 튜닝 모드에서는 질의를 실행할 때마다 질의 통계(Statistics)와 질의 실행 계획을 함께 출력해주어 튜닝이 용이하도록 지원합니다. 멀티 모니터를 이용하실 경우 한쪽 모니터에는 튜닝 결과만 계속 출력할 수 있습니다.

출력되는 정보는 실행한 SQL 비교, 텍스트/트리/그래프(선호하는 방식 선택 가능)를 이용해서 질의 실행 계획을 좌우 비교할 수 있습니다.

왼쪽창과 오른쪽 창으로 분리되어 있으며 체크한 곳으로 질의 실행시마다 정보가 갱신됩니다. 위 그림처럼 오른쪽을 체크해두면 매번 질의 실행시 오른쪽 창의 정보가 업데이트되어 원하는 두개의 상태를 지속적으로 비교해갈 수 있습니다.

멀티 질의 비교

HA 시스템의 서로 다른 DB나 데이터 정합 여부를 확인해야하는 질의를 실행할 때 일일이 직접 차이를 추적하지 않아도 색상으로 차이점을 시각적으로 보여주도록 개선하였습니다. 색상으로 비교를 하지 않으려면 "비교 상태 숨기기"를 클릭하시면 됩니다.

질의 결과 필터 기능

질의를 실행한 후 질의 결과에서 특정 단어가 들어간 데이터만 보려면 질의를 수정해서 조건을 추가해야 했으나 질의 필터 기능을 이용하면 원하는 데이터를 즉시 하일라이팅 해줍니다. 특정 컬럼에 포함된 데이터만 찾을 수도 있습니다.

입력창 오른쪽에 화살표를 누르면 옵션창이 아래와 같이 출력됩니다. 만약 상세 검색을 원하신다면 특정 컬럼, 비교 방식을 설정해서 검색할 수 있습니다.

SQL 실행 개선 (가져오기 마법사에 통합)

SQL 파일을 이용 데이터를 입력/변경을 위해 지원하였던 SQL 실행 기능을 가져오기 마법사에 통합하면서 스키마/인덱스/데이터 SQL 파일을 구분해서 추가할 수 있도록 개선하였습니다.

가져오기 마법사에서 SQL 파일 실행하기를 선택합니다.

스키마, 데이터, 인덱스 파일을 구분해서 입력하시면 스키마 > 데이터 > 인덱스 순으로 파일이 실행됩니다. 만약, HA 구성 장비의 경우에는 스키마에 인덱스 파일도 함께 추가해주시면 됩니다.

2013년 3월 릴리스

1. 릴리스 버전 : CM-2013.03 / CQB-2013.03

- 상세 릴리스 노트: http://www.cubrid.org/wiki_tools/entry/cubrid-manager-release-note_kr
- 상세 릴리스 노트: http://www.cubrid.org/wiki_tools/entry/cubrid-query-browser-release-note_kr

2. 다운로드

- 이번 버전부터 각 도구의 버전 규칙이 변경되었습니다.
- 각 도구의 릴리스 시기를 기준으로 <도구이름>-<년>-<빌드번호>를 포함합니다.
- CUBRIDManager-2013.03 빌드0037: http://ftp.cubrid.org/CUBRID_Tools/CUBRID_Manager/2013.03/
- CUBRIDQuery-2013.03 빌드0037: http://ftp.cubrid.org/CUBRID_Tools/CUBRID_Query_Browser/2013.03/

3. 주요개선사항

- 엔진 버전 CUBRID 8.2.2 ~ CUBRID 9.1 지원

- ERwin XML파일 가져오기/내보내기 기능 지원 : 스키마 추가/변경 작업 편의성 향상

- N개의 DB에서 데이터 비교/검증 기능: 복제 DB 구성 후 검증 편의성 향상

- 질의 실행 계획 그래픽 모드 지원: 실행 순서와 비용에 대한 이해 및 가독성 향상

- 대시보드의 확장: 네비게이션에서 오브젝트 노드(테이블/뷰/시리얼/자동화/트리거)를 더블클릭하면 통합뷰 출력

- 테이블 편집창 개선: 편집창 셀에서 즉시 편집 가능

ERwin XML 가져오기 / 내보내기 지원

상단 고급기능 메뉴 > ERwin XML 파일로 스키마 내보내기, ERwin XML에서 스키마 가져오기를 지원합니다.
ERwin 프로그램에서 XML 파일은 File > Save As를 이용하여 저장할 수 있습니다. ERwin은 4.1 버전을 지원합니다.

CUBRID 도구를 통해 스키마 변경 작업 -> ERwin XML로 스키마 내보내기를 이용하여 XML로 저장 -> ERwin 프로그램에서 CUBRID에서 추출한 스키마(xml) 열기를 수행할 수 있습니다.

< ERwin XML에서 스키마 가져오기> XML로 저장 -> CUBRID 도구에서 ERwin XML파일로부터 스키마 가져오기 실행-> 현재 접속된 DB 스키마 VS ERwin XML 스키마를 비교 -> ALTER DDL문을 생성 -> DB 스키마 변경작업을 수행할 수 있습니다.

고급기능 > DB 데이터 비교 마법사

개발DB <-> 운영DB, HA 구성된 마스터DB <->슬레이브 DB, 마이그레이션 작업 대상인 원본DB <-> 대상 DB 등
마이그레이션 또는 복제 후 2개 이상의 DB에서 데이터 정합성을 쉽게 파악할 수 있습니다.
Primary Key가 있는 테이블만 비교 대상이 됩니다.

질의 실행 계획을 그래픽 모드에서 출력

질의 실행 계획을 그래프로 출력하여 초보자도 쉽게 실행 계획 및 비용을 파악할 수 있습니다.

테이블 편집 UI 개선

테이블 편집시 셀 바로 편집이 가능하므로, 컬럼 추가/변경이 쉬워집니다.
또한, 데이터타입 선택시 오른쪽에 도움말이 출력됩니다.

대상 DB 하위에 N개의 SQL탭이 출력되도록 계층화

작업 DB가 N개, 열려있는 질의편집기가 N개인 경우 상단에 너무 많은 탭이 열려 복잡했던 단점을 개선하였습니다.
작업 DB마다 열리는 질의편집기 탭 1개, 그 하위에 N개의 SQL탭이 열리도록 계층화하여 혼동하지 않고 질의를 수행할 수 있습니다.

오브젝트 대시보드

작년부터 꾸준하게 진행한 대시보드 기능 확장의 결과로,
이제 테이블, 뷰, 시리얼, 트리거, 작업 자동화 노드를 더블클릭하면 대시보드를 출력합니다.
대시보드는 해당 오브젝트의 통합뷰를 출력하며, 우클릭 > 메뉴를 통해 편집/추출 기능을 수행할 수 있습니다.

다중 호스트 설정 편집기 (CM)

복수개의 호스트 설정 (cubrid.conf, broker.conf)을 동시에 비교하면서 편집할 수 있습니다.

인덱스 탭 추가

왼쪽 네비게이션 하단 빠른 스키마 보기에 인덱스만 별도로 확인할 수 있도록 탭이 추가되었습니다.

찾기 / 바꾸기 개선

입력한 키워드 히스토리 기능과 구역 검색/치환, 정규식 지원 등 기능 개선이 되었습니다.

빠른 질의 입력

질의 편집기에서 마우스 없이도 쉽게 질의를 입력할 수 있는 방법을 제공합니다.
CTRL + , 를 누르면 [빠른 질의 입력] 창이 뜨고 테이블명을 입력(자동 완성)한 후,
SELECT, INSERT, UPDATE 문을 바로 질의 편집기에 입력할 수 있습니다.

2013년 1월 SHARD 지원을 위한 임시 패치 릴리스

1. 릴리스 버전 : CM-8.4.3.201212 p1 / CQB-8.4.3.201212 p1

- 상세 릴리스 노트: http://www.cubrid.org/wiki_tools/entry/cubrid-manager-release-note_kr
- 상세 릴리스 노트: http://www.cubrid.org/wiki_tools/entry/cubrid-query-browser-release-note_kr

2. 다운로드

- CUBRIDQuery-8.4.3.201212.3086: http://ftp.cubrid.org/CUBRID_Tools/CUBRID_Query_Browser/8.4.3/
- CUBRIDManager-8.4.3.201212.3086: http://ftp.cubrid.org/CUBRID_Tools/CUBRID_Manager/8.4.3/

3. 주요개선사항

이번 버전은 CQB의 SHARD 기능 강화를 위한 패치외 CM의 멀티질의와 관련한 사소한 오류가 개선된 패치 버전 입니다.

SHARD 지원 강화 (CQB)

데이터베이스 접속창에 "SHARD 브로커"가 선택된 경우 SHARD 브로커의 기능을 사용할 수 있습니다.

SHARD 브로커가 사용 가능한 경우 데이터베이스 노드에서 원하는 기본 SHARD ID 또는 SHARD VAL을 변경할 수 있습니다.

데이터베이스에 설정한 기본 SHARD ID, VAL과 별도로 질의 편집기의 툴바 버튼을 이용하여 질의시 사용할 SHARD ID 또는 SHARD VAL을 지정하여 사용할 수 있습니다. 이렇게 지정한 SHARD 정보는 멀티 SQL 질의, 멀티 DB 질의시에서 자동으로 HINT가 추가되어 정상적으로 질의를 실행할 수 있도록 지원합니다.

2012년 12월 릴리스

1. 릴리스 버전 : CM-8.4.3.201212 / CQB-8.4.3.201212

- 상세 릴리스 노트: http://www.cubrid.org/wiki_tools/entry/cubrid-manager-release-note_kr
- 상세 릴리스 노트: http://www.cubrid.org/wiki_tools/entry/cubrid-query-browser-release-note_kr

2. 다운로드

- CUBRIDQuery-8.4.3.201212.3080: http://ftp.cubrid.org/CUBRID_Tools/CUBRID_Query_Browser/8.4.3/
- CUBRIDManager-8.4.3.201212.3080: http://ftp.cubrid.org/CUBRID_Tools/CUBRID_Manager/8.4.3/

3. 주요개선사항

HA 마법사 (CUBRID Manager Only)

HA를 쉽게 구성해주는 HA 마법사를 제공합니다. 처음 HA를 시작하려는 사용자에게 적합하며, 1개의 마스터 1개의 슬레이브 구성을 쉽게 할 수 있습니다.

<사용방법 상세보기>

데이터베이스 스키마 비교

두 개 이상의 데이터베이스를 선택후 데이터베이스 스키마 비교 기능이 단순 diff 기능을 넘어 각 테이블별 컬럼, PK, 인덱스 등 상세 분석과 레코드 개수까지 동시에 비교할 수 있게 되었습니다. HA로 구성된 서버의 마스터와 슬레이브 노드를 비교하는 용도로도 안성맞춤 입니다.

테이블/컬럼 설명 기능

테이블/컬럼 설명 기능은 UI를 이용하여 테이블을 생성하거나 편집할 때, 테이블/컬럼의 설명을 등록하여 각 테이블과 컬럼의 용도를 UI에서 쉽게 확인하고 관리하기 위해 지원합니다.

단, 이 기능은 CUBRID에서 기본 지원되는 기능이 아니며, CUBRID Manager, CUBRID Query Browser에서 자체 지원되는 기능이며 사용상 기능 한계가 있을 수 있습니다. 또한, 처음 사용시 설치를 해야 사용할 수 있는 기능이며, DBA 권한이 있을 경우만 생성 가능 합니다.

DBA 사용자일 경우 아래와 같이 안내후 _cub_schema_comments을 자동 생성합니다. 네비게이션에서는 일반 유저들이 이 테이블을 UI에서 편집하지 못하도록 시스템 테이블 영역에 출력이 됩니다만 실제 시스템 테이블은 아닙니다.

DBA 권한이 없는 유저의 경우 아래와 같은 오류가 발생하게 됩니다.

설치후 아래와 같이 설명 편집과 조회가 가능합니다.

테이블 설명과 컬럼 설명을 확인 가능하며 컬럼 설명은 아래의 컬럼 편집 UI에서 편집 가능합니다.

이렇게 등록한 메타 정보는 현재 제한적으로만 사용 가능하나 UI 도구내에서 계속 사용 범위를 넓혀갈 것입니다.

테이블 명세서 Excel 출력 기능

데이터베이스의 모든 테이블에 대해 테이블 명세서를 Excel로 출력하는 기능을 제공합니다. 테이블 목록과 각 테이블별 상세 스키마 정보를 표로 제공하며, 만약 테이블 컬럼/설명 기능을 이미 사용하고 있을 경우에는 기 입력된 설명과 함께 출력됩니다.

브로커 설정파일 일괄 편집 기능

서비스가 복잡해지고 데이터베이스 입출력이 많아지면 브로커 또한 목적에 맞게 분리하여 사용하게 됩니다. 그럴 경우 여러 브로커의 설정을 하나씩 설정하기 어려운데 특정 서버에 있는 모든 브로커 설정을 한 화면에서 비교하면서 편집하는 기능을 제공합니다.

데이터베이스 생성시 자동 시작 선택 옵션 추가 (CUBRID Manager Only)

데이터베이스 자동 시작 옵션이 데이터베이스 생성시에 설정할 수 없어 불편하였는데 생성시 기본 설정 화면에 자동 시작 옵션을 추가하였습니다.

데이터베이스 접속 화면 개선 (CUBRID Query Browser Only)

데이터베이스의 접속 주소를 먼저 입력하고 이후에 데이터베이스명이나 아이디, 비밀번호를 입력하는 대부분의 사용 유형에 따라 접속 정보 입력 양식을 변경하였습니다.

SHARD 브로커 연결 지원 (CUBRID Query Browser Only)

8.4.3부터 SHARD 기능이 지원되고 있으며, CUBRID Query Browser에서도 SHARD 브로커를 접속할 수 있도록 개선되었습니다.

연결 정보 편집에 SHARD 브로커에 사용 선택을 하면 SHARD 브로커로 접속할 수 있게 됩니다. 기본 SHARD는 0인데, 기본 SHARD를 변경하는 방법은 연결 정보 편집에서 SHARD ID 버튼을 클릭하여 변경할 수 있습니다.

또한, 로그인후 “데이터베이스 SHARD 변경”에서도 가능합니다.

또한, 질의 편집기에서 개별로 기본으로 사용할 SHARD를 지정할 수 있습니다.

질의 편집기에서 SHARD 를 변경할 경우 왼쪽 네비게이션에서 끌어오기를 할 경우 SHARD 아이디가 현재 질의 편집기에서 변경한 아이디로 설정되어 질의가 생성될 수 있습니다.

2012년 10월 개발 테마 "호스트 / 데이터베이스 대시보드"

1. 릴리스 버전 : CM-8.4.1.201210 / CQB-8.4.1.201210

- 상세 릴리스 노트: http://www.cubrid.org/wiki_tools/entry/cubrid-manager-release-note_kr
- 상세 릴리스 노트: http://www.cubrid.org/wiki_tools/entry/cubrid-query-browser-release-note_kr

2. 다운로드

- CUBRIDQuery-8.4.1.201210.2360 : http://ftp.cubrid.org/CUBRID_Tools/CUBRID_Query_Browser/8.4.1/
- CUBRIDManager-8.4.1.201210.2360 : http://ftp.cubrid.org/CUBRID_Tools/CUBRID_Manager/8.4.1/

3. 주요개선사항

호스트, 데이터베이스 대시보드 (CUBRID MANAGER)

CUBRID Manager는 이미 호스트 정보, 데이터베이스 정보를 제공하는 기능을 모두 갖추고 있으나 하나의 뷰로 보여주는 기능을 이번 개선부터 지원하게 됩니다. DBA가 필요한 기본적인 서버의 상태를 일목요연하게 보여주어 관리의 편의성을 더하였습니다. 특히 볼륨의 가용공간은 5% 이하가 되면 빨간색으로, 15% 이하가 되면 노란색으로 경고를 보여줍니다.

호스트 대시보드

데이터베이스 대시보드

사용자 관리 (CUBRID QUERY BROWSER)

CQB에서 사용자 관리를 하기 위해서는 DDL을 이용하여 관리를 할 수밖에 없었는데 이제는 UI 도구로 완벽하게 지원합니다. CUBRID Manager를 사용할 수 없는 환경에서도 이제는 사용자 관리를 할 수 있습니다.

질의 다중 실행 기능의 다중 SQL 단일 DB 실행

질 의 다중 실행 기능은 2개 이상의 데이터베이스에 SQL을 실행하여 하나의 뷰로 실행 결과를 조회하기 위한 기능 인데, 이제는 1개의 데이터베이스에서 여러개의 SQL을 실행하여 하나의 뷰로 실행 결과를 조회할 수 있도록 개선하였습니다. 조건이 약간씩 다른 동일한 SQL의 결과를 쉽게 할 수 있습니다.

컬럼/DDL 빠른 조회창

접 속창에서 테이블, 뷰를 선택하여 컬럼 정보를 조회하기가 쉽지 않았던 불편함을 보완하기 위해 테이블, 뷰를 선택할 때마다 하단의 컬럼정보 빠른 보기창에서 보여주도록 개선되었습니다. 컬럼을 선택하여 컬럼 목록 문자열(컬럼을 코머로 나열, ENTER로 구분하여 나열)을 생성하거나 SELECT, INSERT, UPDATE 구문을 쉽게 만드는 기능이 마우스 우클릭으로 지원하게 되었습니다.

질의 결과로 INSERT, UPDATE SQL 만들기

질 의 결과에서 일부분을 수정해서 데이터를 다시 입력해야할 경우에 유용한 기능입니다. 원하는 레코드를 선택한 후 툴바 또는 마우스 우클릭으로 나오는 메뉴를 선택하면 클립보드에 SQL을 만들어 줍니다. 이 기능은 소량의 간편한 편집을 위해 지원하므로 최대 100개 레코드까지만 지원합니다.

질의 편집창 질의 편집 편의성 개선

(1) JOIN 질의를 작성하는 경우 귀찮은 것 중 하나는 모든 컬럼 앞에 테이블 별칭을 넣어줘야하는 것 입니다. 그래서, 수십개 되는 컬럼을 일일이 입력해왔으나 이제는 변경을 원하는 컬럼을 선택한 후 마우스 우클릭에 있는 "컬럼명 앞 테이블 별칭 일괄 변경"을 선택하여 원하는 별칭을 추가 또는 이미 있을 경우 교체할 수 있습니다. 단, 함수나 괄호 등으로 시작할 경우에는 아직 지원하지 않습니다.

(2) 질의 편집기의 각종 로그창의 크기가 마우스를 클릭하면 자동으로 확대되고,
다른 곳으로 클릭하여 포커스를 잃으면 축소되어 마우스 드래그를 할 필요가 없도록 하였습니다.

지원되는 단축키

기본 단축키		질의 편집기에서 사용되는 단축키
단축키	기능	단축키	기능
Ctrl+T	질의 편집기 열기	F5	질의 실행
Ctrl+W	질의 편집기 닫기	F6	질의 실행계획
Ctrl+Shift+W	모든 질의 편집기 닫기	F7	질의 이력보기
F1	도움말 WIKI로 이동	F8	질의 다중실행 전환
		F11	질의 실행계획 그래픽<>텍스트 전환
		Ctrl+Shift+X	선택된 텍스트 대문자 변환
		Ctrl+Shift+Y	선택된 텍스트 소문자 변환
		Ctrl+Enter	현재 커서가 위치한 질의 실행
		Ctrl+Shift+F	선택된 또는 전체 질의 서식화
		Tab	들여쓰기
		Shift+Tab	내어쓰기
		Ctrl+/	주석 추가 <> 제거
		Ctrl+Z	실행 취소 (UNDO)
		Ctrl+Y	다시 실행 (REDO)
		Ctrl+F	찾기/바꾸기
		Ctrl+C	복사
		Ctrl+X	잘라내기
		Ctrl+V	붙여넣기
		Ctrl+G	줄 번호 이동

CUBRID NHibernate Support

2013-06-05T01:56:50-07:00

NHibernate is a .NET port of the well-known Hibernate Java framework.

It is an open source project which implements persisting objects (an ORM) to and from an underlying relational database – MySQL, PostgreSQL, SQL Server, Oracle etc. (The term object/relational mapping (ORM) refers to the technique of mapping a data representation from an object model to a relational data model with a SQL-based schema).

Useful Links

Source code

SVN Source

Tutorials

[Using CUBRID and NHibernate] - An introduction web tutorial
[CUBRID NHibernate Support project]
[Using CUBRID with NHibernate - Beginner's Guide]
[Using NMG (NHibernate Mappings Generator) with CUBRID]
[Using CUBRID with NHibernate – Advanced tutorial (Part I)]
[Using CUBRID with NHibernate – Advanced tutorial (Part II)]

Community

Some of the most important NHibernate features are:

It uses a natural programming model - NHibernate supports natural OO idiom; inheritance, polymorphism, composition and the .NET collections framework, including generic collections.
It uses .NET conventions and idioms
It has support for fine-grained object models - a rich variety of mappings for collections and dependent objects
It supports custom SQLs
NHibernate not only takes care of the mapping from .NET classes to database tables (and from .NET data types to SQL data types), but also provides data query and retrieval facilities and can significantly reduce development time otherwise spent with manual data handling in SQL and ADO.NET.
Its free/open source - NHibernate is licensed under the LGPL (Lesser GNU Public License)
It has a very strong community and it is very well maintained:

“NHibernate's goal is to relieve the developer from 95 percent of common data persistence related programming tasks” (http://nhforge.org/doc/nh/en/index.html)

The scope of the CUBRID NHibernate project, presented in this wiki page, is to add support in NHibernate for CUBRID.

To achieve this goal, we have:

Added support in the NHibernate Core for CUBRID
Updated the implementation of the CUBRID ADO.NET driver
Created a series of tutorials to help you start fast with NHibernate in CUBRID

Beside all these, we took a step further and we added CUBRID support to one of the best NHibernate automatic code generators - NMG.

Not the least, as always for the API/drivers we have developed for CUBRID, we developed a rich suite of automated test cases, which can also provide you immediately with out-of-the-box code examples to start with.

If you want to find out how we implemented CUBRID support, you can read the technical implementation documentation.

Error -493 when saving

2012-09-07T07:24:54-07:00

We are using Samsung HOTELTV and when we save a change to a page, we're getting the following error - anyone any suggestions?

A Database Error Occurred
Error Number: -493
Syntax: syntax error, unexpected ',' 
INSERT INTO sds_framecontents (men_idx, men_key, lay_idx, fra_idx, men_lang, regdate, editdate) 
VALUES (, 104, 1, , 'ENG', 1347031405, 1347031405)

Input values in column type SEQUENCE using the DBD::cubrid Perl module

2013-06-13T04:48:16-07:00

I was trying to insert a value into a table column within a Perl script and using the DBD::cubrid module (v9.1.0.0001, server v9.1.0) with type SEQUENCE and it failed with:

"CUBRID DBMS Error : (-494) Semantic: Cannot coerce host var to type sequence. at ... line ..."

This was my first attempt and the script was using parameters. My workaround for the moment is to NOT use parameters, like in the second attempt.

#!/bin/env perl
#
# CREATE TABLE test_seq (
#     tags   SEQUENCE (VARCHAR(512))
# );

use strict;
use warnings;
use DBI;

my $dbname = 'test_sequence';
my $host   = 'localhost';
my $port   = '33000';
my $user   = 'user';
my $pass   = 'pass',

my $dsn = qq{dbi:cubrid:database=$dbname;host=$host;port=$port};
my $dbh = DBI->connect(
    $dsn, $user, $pass,
    {   AutoCommit => 1,
        RaiseError => 1,
        PrintError => 1,
    }
) or die $DBI::errstr;

my $tag = q({'tag1','tag2'}); # also tried "{'tag1'}" and '{"tag1"}' ...

$dbh->do( qq{ INSERT INTO test_seq ( tags ) VALUES (?) }, undef, $tag )
    or die $DBI::errstr;                # CUBRID DBMS Error : (-494)

$dbh->do( qq{ INSERT INTO test_seq ( tags ) VALUES ($tag) } )
    or die $DBI::errstr;                 # This is OK

My question is: have I done something wrong or this feature is not yet implemented for type SEQUENCE?

P.S.: I think a Perl tag sould be available.

CUBRID NHibernate Support project

2013-06-06T04:26:50-07:00

1 CUBRID Data types testing
- 1.1 Standard data types
- 1.2 Special CUBRID data types
  - 1.2.1 BLOB/CLOB
  - 1.2.2 SET, MULTISET, SEQUENCE
2 Relationships testing
3 References

CUBRID Data types testing

Standard data types

Overview

For testing of the standard data types support in NHibernate with CUBRID we implemented a suite of test cases that perform the basic SQL operations (Create, Read, Update and Delete - CRUD):

A generic table was created with columns of all the standard SQL data types available in CUBRID:

create table TestDataTypes (
c_integer INTEGER NOT NULL AUTO_INCREMENT,
c_smallint SMALLINT,
c_bigint BIGINT,
c_numeric NUMERIC(10,2),
c_float FLOAT,
c_decimal DECIMAL(19,5),
c_double DOUBLE,
c_char CHAR(1),
c_varchar STRING,
c_time TIME,
c_date DATE,
c_timestamp TIMESTAMP,
c_datetime DATETIME,
c_monetary MONETARY,
c_string STRING,
c_bit BIT(1),
c_varbit BIT VARYING(1),
primary key (c_integer))

Note: All test cases were developed in C#, using MS Visual Studio

Setup

To map NHibernate objects to this table the following files where created:

Mappings\TestDataTypesStandard.cs: the mapping class for the table
Mappings\TestDataTypesStandard.hbm.xml: the xml mapping file for the table
TestDataTypesStandard.cs: the implementation of the data types test cases

Test cases

The test cases where developed to test all the CRUD operations on all the standard data types. Each test case performs one type of operation on all the above standard data types. For every test case, we create the database table above, we perform the tested operation and we test if the operation was performed correctly.

Test case Name	Purpose
Test_DataTypesStandard_Insert	Test data insertion of all the standard data types
Test_DataTypesStandard_Select	Test retrieving data of all the standard data types
Test_DataTypesStandard_Update	Test updating data of all the standard data types
Test_DataTypesStandard_Delete	Test deleting records from a table with columns of all the standard data types

Results

The results of the test cases show that all the basic SQL operations can be performed on all the standard SQL data types supported by CUBRID.

The following table depicts the results of the testing performed:

CUBRID Data type	Test type	NHibernate compatibility status	Notes
INTEGER	C,R,U,D	Supported	No modifications to the ADO.NET driver or NHibernate required
SMALLINT	C,R,U,D	Supported	No modifications to the ADO.NET driver or NHibernate required
BIGINT	C,R,U,D	Supported	No modifications to the ADO.NET driver or NHibernate required
NUMERIC	C,R,U,D	Supported	No modifications to the ADO.NET driver or NHibernate required
FLOAT	C,R,U,D	Supported	No modifications to the ADO.NET driver or NHibernate required
DECIMAL	C,R,U,D	Supported	No modifications to the ADO.NET driver or NHibernate required
DOUBLE	C,R,U,D	Supported	No modifications to the ADO.NET driver or NHibernate required
CHAR	C,R,U,D	Supported	No modifications to the ADO.NET driver or NHibernate required
VARCHAR	C,R,U,D	Supported	No modifications to the ADO.NET driver or NHibernate required
TIME	C,R,U,D	Supported	No modifications to the ADO.NET driver or NHibernate required
DATE	C,R,U,D	Supported	No modifications to the ADO.NET driver or NHibernate required
TIMESTAMP	C,R,U,D	Supported	No modifications to the ADO.NET driver or NHibernate required
DATETIME	C,R,U,D	Supported	No modifications to the ADO.NET driver or NHibernate required
MONETARY	C,R,U,D	Supported	No modifications to the ADO.NET driver or NHibernate required
STRING	C,R,U,D	Supported	No modifications to the ADO.NET driver or NHibernate required
BIT	C,R,U,D	Supported	No modifications to the ADO.NET driver or NHibernate required
BIT VARYING	C,R,U,D	Supported	No modifications to the ADO.NET driver or NHibernate required

Special CUBRID data types

BLOB/CLOB

The purpose of testing the support for CUBRID BLOB and CLOB data types was to find out if the basic CRUD operations (INSERT, SELECT, UPDATE, DELETE) can be performed from NHibernate on a BLOB or CLOB column in a CUBRID table and what are the code adjustments required to support this in the best way.

For this purpose two tables where created in the demodb CUBRID database: one with a column of type BLOB and one with a column of type CLOB.

The files used in the tests are:

TestCUBRIDBLOBType.cs: the mapping class for the table with a BLOB column
TestCUBRIDCLOBType.cs: the mapping class for the table with a CLOB column
TestCUBRIDBLOBType.hbm.xml: the xml mapping file for the table with a BLOB column
TestCUBRIDCLOBType.hbm.xml: the xml mapping file for the table with a CLOB column
TestDataTypesCUBRID.cs: the implementation of the test cases;

Preliminary tests results showed that these custom CUBRID types are not supported by NHibernate out of the box.

The CUBRID BLOB and CLOB types are custom types and are implemented as custom classes in the ADO.NET driver so they are not recognized by NHibernate.

Additional modifications to the ADO.NET driver and NHibernate Core

The solution to this problem was to implement an adapter for the CUBRID BLOB and CLOB types in the NHibernate Core.

To do that, two classes (CUBRIDBLOBType.csand CUBRIDCLOBType.cs) that implement the PrimitiveType interface where created in NHibernate.Type namespace. These classes are responsible for transferring a CUBRID BLOB or CLOB object from the ADO.NET driver into NHibernate and map this object to a property of the corresponding mapping class.

In order to implement the PrimitiveType interface, we need to implement a number of methods and we will see how to implement the most important ones.

First of all let's see the constructor method:

public CUBRIDBLOBType() : base(SqlTypeFactory.GetSqlType(DbType.Binary, 0, 0))
{
}

public CUBRIDCLOBType() : base(SqlTypeFactory.GetSqlType(DbType.AnsiString, 0, 0))
{
}

The constructor method inherits the base class constructor and passes as parameter the SQLType to which the ADO.NET driver maps BLOB and CLOB objects. In our case, the ADO.NET driver maps a BLOB object to DbType.Binary and a CLOB object to DbType.AnsiString.

Another important component of the PrimitiveType interface we need to implement is the Name property. This tells NHibernate the name that the user will use in the xml mapping file when using CUBRIDBLOB or CLOB data types:

public override string Name
{
    get { return "CUBRIDBlobType"; }
}

public override string Name
{
    get { return "CUBRIDClobType"; }
}

Now comes the most important methods that we need to implement; the Get and Set methods form the PrimitiveType interface. Because CUBRID BLOB and CUBRID CLOB objects are very similar these methods are implemented the same for both CUBRIDBLOB and CUBRIDCLOB classes.

public override object Get(IDataReader rs, int index)
{
    return rs[index];
}

public override object Get(IDataReader rs, string name)
{
    return rs[name];
}

/// <summary>
///Sets a <see cref="System.Data.IDataParameter" /> parameter with the value of the BLOB object
/// </summary>
/// <param name="st"></param>
/// <param name="value"></param>
/// <param name="index"></param>

public override void Set(IDbCommand st, object value, int index)
{
    if (value == null)
    {
        ((IDataParameter)st.Parameters[index]).Value = DBNull.Value;
    }
    else
    {
        ((IDataParameter)st.Parameters[index]).Value = value;
    }
}

The Get method receives as parameters a DataReader object from the ADO.NET driver and the index of the column that is read or the name of the column that is read. The method's purpose is to pass the CUBRIDBLOB or CUBRIDCLOB object from the driver into NHibernate. The Set method is null-safe. It receives a DbCommand from the ADO.NET driver, the value to be passed to the driver and the index of the column that is written. The purpose of the method is to set the value of the command parameter corresponding to the column that is being written. If the value is null, we write a DBNull value to the parameter.

After implementing these classes, the new types need to be registered in the TypeFactory class:

RegisterType(NHibernateUtil.CUBRIDBLOB, new[] { "CUBRIDBLOB" });
RegisterType(NHibernateUtil.CUBRIDCLOB, new[] { "CUBRIDCLOB" });

The last modification needed is to tell NHibernate how to create an internal object of the new type. We do that in the NHibernateUtil class:

///<summary>
/// NHibernate CUBRIDBLOB type
///</summary>
public static readonly NullableType CUBRIDBLOB = new CUBRIDBLOBType();

///<summary>
/// NHibernate CUBRIDCLOB type
///</summary>
public static readonly NullableType CUBRIDCLOB = new CUBRIDCLOBType();

After these modifications, we can map a NHibernate object property to a CUBRID BLOB or CLOB column. The xml mapping looks like this:

Test results

After performing these modifications the test results show that all the basic operations can be performed on CUBRID BLOB and CLOB columns:

Operation/Type	BLOB	CLOB
Insert	Supported	Supported
Select	Supported	Supported
Update	Supported	Supported
Delete	Supported	Supported

SET, MULTISET, SEQUENCE

The purpose of testing support for CUBRID Collection data types (Set/Multiset/Sequence) is to see if the CRUD operations (INSERT, SELECT, UPDATE, DELETE) can be performed from NHibernate on a Set, Multiset or Sequence column in a CUBRID table. For this purpose a table was created in the demodb CUBRID database with three columns: one of type Set, one of type Multiset and one of type Sequence.

The files used in the tests are:

TestCUBRIDCollectionType.cs: the mapping class for the table with a CUBRID Set, Multiset and Sequence columns
TestCUBRIDCollectionType.hbm.xml:the xml mapping file for the table with a CUBRID Set, Multiset and Sequence columns
TestDataTypesCUBRID.cs: the implementation of the test cases;

Preliminary tests results showed that these custom CUBRID types are not supported by NHibernate.

The CUBRID Set, Multiset and Sequence types are custom types and are handled in a special way by the CUBRID ADO.Net Driver.

Additional modifications to the ADO.NET driver and NHibernate Core

The solution to this problem was to implement an adapter class for these types in the NHibernate Core.

The approach is very similar to the one taken for the CLOB/BLOB data types!

We will not go into many details – please take a look at the previous CLOB/BLOB section to understand the approach.

So we will list in the next section only the key steps, starting with the new class creation:

public CUBRIDCollectionType() : base(SqlTypeFactory.GetSqlType(DbType.VarNumeric, 0, 0))
{
}

The constructor method inherits the base class constructor and passes as parameter the SQL type to which the ADO.NET driver maps SET, MULTISET and SEQUENCE objects. In our case, the ADO.NET driver maps these types of objects to DbType.VarNumeric

Next, we added the Name property:

public override string Name
{
    get { return "CUBRIDCollection"; }
}

Next, we implemented the Get and Set methods from the PrimitiveType interface:

public override object Get(IDataReader rs, int index)
{
    return rs[index];
}

public override object Get(IDataReader rs, string name)
{
    return rs[name];
}

/// <summary>
/// Sets a <see cref="System.Data.IDataParameter" /> parameter with the value of the CUBRIDCollection object
/// </summary>
/// <param name="st"></param>
/// <param name="value"></param>
/// <param name="index"></param>

public override void Set(IDbCommand st, object value, int index)
{
    if (value == null)
    {
        ((IDataParameter)st.Parameters[index]).Value = DBNull.Value;
    }
    else
    {
        ((IDataParameter)st.Parameters[index]).Value = value;
    }
}

After implementing all these above, the new types need to be registered in the TypeFactory class:

RegisterType(NHibernateUtil.CUBRIDCollections, new[] { "CUBRIDCollection" });

The last modification needed was to tell NHibernate how to create an internal object of the new type. We do that in the NHibernateUtil class:

///<summary>
/// NHibernate CUBRIDCollection type
///</summary>
public static readonly NullableType CUBRIDCollection = new CUBRIDCollectionType();

After these modifications, we can map a NHibernate object property to a CUBRID SET, MULTISET and SEQUENCE column.

The xml mapping looks like this:

Test results

After performing these modifications the test results show that all the basic operations can be performed on CUBRID SET, MULTISET and SEQUENCE columns:

Operation/Type	Set	Multiset	Sequence
Insert	Supported	Supported	Supported
Select	Supported	Supported	Supported
Update	Supported	Supported	Supported
Delete	Supported	Supported	Supported

Relationships testing

1:N Relationship tests

For testing 1:N relationship in NHibernate we used the Nation and Athlete tables in the demodb database. The tests consist in performing the basic SQL CRUD operations (INSERT, SELECT, UPDATE, DELETE) on the relationship between the two tables.

The files used in the tests are:

Mappings\AthleteOneToMany.cs: the mapping class for the Athlete table.
Mappings\AthleteOneToMany.hbm.xml: the xml mapping file for the Athlete table.
Mappings\Nation.cs: the mapping class for the Nation table.
Mappings\Nation.hbm.xml: the xml mapping file for the Nation table.
TestRelationships.cs: the implementation of the test cases.

Test results

Operation	Test Result	Notes
Insert	OK	Insertion of a new Nation triggers an insertion of a new Athlete
Select	OK	Selection of a Nation triggers the selection of the corresponding Athletes
Update	OK	Updating a Nation also updates the corresponding Athletes
Delete	OK	Deleting a Nation triggers the deletion of the orphan Athletes

M:N Relationship tests

For testing M:N relationship in NHibernate we used the Event and Athlete tables in the demodb database. Because in NHibernate the columns referenced by the foreign keys must be the primary key in the reference table, we could not use the Record table as reference between Event and Athlete.

So for testing, a custom reference table was created:

create table AthleteEvent(
    event_code int,
    athlete_code int,
    primary key(event_code,athlete_code)
)

The tests consist in performing the basic SQL operations (INSERT, SELECT, UPDATE, DELETE) on the relationship between the two tables.

The files used in the tests are:

Mappings\AthleteManyToMany.cs: the mapping class for the Athlete table.
Mappings\AthleteManyToMany.hbm.xml: the xml mapping file for the Athlete table.
Mappings\Event.cs: the mapping class for the Event table.
Mappings\Event.hbm.xml: the xml mapping file for the Event table.
TestRelationships.cs: the implementation of the test cases.

Test results

Operation	Test Result	Notes
Insert	OK	Insertion of a new Athlete triggers an insertion of a new Event and the insertion of a new record in the reference table
Select	OK	Selection of an Athlete triggers the selection of the corresponding Event and selection of an Event triggers the selection of the corresponding Athletes
Update	OK	Updating an Athlete or Event also updates the corresponding the other part of the relationship and the reference table.
Delete	OK	Deleting a Athlete triggers the deletion of the orphan Events and deletes the corresponding record in the reference table

1:1 Relationship test

1:1 relationships where tested using a more complex schema from the demodb database. We used the Game table as the center table and we linked the Nation, Athlete, Stadium and Event tables to it in 1:1 relationships.

As usual, the tests consist in performing the basic SQL operations (INSERT, SELECT, UPDATE, DELETE) on the relationship between the tables.

The files used in the tests are:

Mappings\AthleteOneToOne.cs: the mapping class for the Athlete table.
Mappings\AthleteOneToOne.hbm.xml: the xml mapping file for the Athlete table.
Mappings\Event.cs: the mapping class for the Event table.
Mappings\Event.hbm.xml: the xml mapping file for the Event table.
Mappings\Game.cs: the mapping class for the Game table.
Mappings\Game.hbm.xml: the xml mapping file for the Game table.
Mappings\Stadium.cs: the mapping class for the Stadium table.
Mappings\Stadium.hbm.xml: the xml mapping file for the Stadium table.
Mappings\Nation.cs: the mapping class for the Nation table.
Mappings\Nation.hbm.xml: the xml mapping file for the Nation table.
TestRelationships.cs: the implementation of the test cases.

Test results

Operation	Test Result	Notes
Insert	OK	Inserting a new Game triggers the insertion of new entries in all the other tables in the relationship
Select	OK	Selecting a Game triggers the selection of the corresponding records in the other tables
Update	OK	Updating a Game updates the corresponding information in the other tables in the relationship
Delete	OK	Deleting a Game triggers the deletion of the orphan records in the other tables

References

Resource	Address
CUBRID ADO.NET Driver download from cubrid.org	http://www.cubrid.org/?mid=downloads&item=ado_dot_net_driver&os=windows&cubrid=9.1.0
CUBRID NHibernate source code	http://svn.cubrid.org/cubridapis/NHibernate
CUBRID NHibernate Wiki page	http://www.cubrid.org/wiki_apis/entry/using-cubrid-and-nhibernate
Test cases suite source code	http://svn.cubrid.org/cubridapis/adodotnet/branches/RB-9.1.0-p1/Code/Test/NHibernate/

Installing CUBRID PDO Driver using PECL

2012-01-03T17:15:06-08:00

If PECL packager is installed in your system, the installation of CUBRID PDO Driver is straightforward. PECL will download and compile the library for you.

Requirements

To install the PDO Driver using PECL, you need to have CUBRID Database installed in your system since PDO Driver is dependent on CUBRID CCI API.

Apart from PHP, the script also needs g++ to be installed:

sudo apt-get install g++

Installation

Type the following command to install the latest version of CUBRID PDO Driver.

sudo pecl install pdo_cubrid

If you need older version of the driver, you can indicate its exact version like:

sudo pecl install pdo_cubrid-8.3.1.0003

During the installation you will be prompted to enter "CUBRID base install dir [!autodetect] :". Just to make sure your installation goes smoothly, enter the full path to the directory where you have installed CUBRID. Ex: if CUBRID was installed at /home/cubridtest/CUBRID, then enter /home/cubridtest/CUBRID.

a) If you have Centos 6.0 and above, Fedora 15 and above, or Ubuntu 13.04 and above, create a file named pdo_cubrid.ini in /etc/php5/conf.d/ or /etc/php.d (check where in your system other .ini files are located).

b) Otherwise, edit the php.ini (default location: /etc/php5/apache2/php.ini or /etc/php.ini).

Then in the above .ini file add the following line:

extension=pdo_cubrid.so

To apply the changes, restart your Web Server.

What If I don't have PECL installed?

Install PECL packager

What's Next?

Refer to CUBRID PDO Tutorials

CUBRID Migration Toolkit Tutorial Senarios 4_kr

2012-06-05T19:02:00-07:00

시나리오 4: 리눅스 콘솔에서 마이그레이션

CUBRID Migration Toolkit은 클라이언트 UI 환경에서 사용자가 작성한 마이그레이션 스크립트를 기반으로 동작한다.

클라이언트 UI 환경에서 마이그레이션 스크립트를 작성

-> 소스 DB to 로컬 클라이언트 환경 to 대상 DB 로 마이그레이션 작업 수행
-> (로컬 경유 O, 수행 시간 길다, 예약 기능 사용 가능)

그러나, 짧은 시간 내에 데이터 이전 작업을 수행해야 하는 경우에는 서버 리소스를 충분히 활용하여 대상 서버(CUBRID 설치 서버)에서 마이그레이션 스크립트를 실행할 수 있다. 이를 지원하는 도구가 마이그레이션 톨킷 콘솔이다.

클라이언트 UI 환경에서 마이그레이션 스크립트를 작성

-> 이를 재료로 CUBRID가 설치된 서버에서 스크립트를 실행할 수 있는 콘솔용 프로그램(Java Application)을 실행
-> 소스 DB to 대상 DB로 마이그레이션 작업 수행
-> (로컬 경유 X, 대상 서버 리소스 활용 가능, 수행 시간 짧다, 예약 기능 사용 불가)

운영 서버에서 마이그레이션 툴킷 콘솔 설치

콘솔용 마이그레이션 툴킷은 다운로드는 배포 사이트에서 다운로드한다.
(http://ftp.cubrid.org/CUBRID_Tools/CUBRID_Migration_Toolkit/ )
이때, 클라이언트 환경에 설치된 CUBRID Migration Toolkit과 버전과 동일한 버전의 디렉토리에서 콘솔용 패키지를 받아 압축을 해제한다.

tar xvfpz CUBRID-Migration-Toolkit-console-x.x.x.xxxxxx-linux.tar.gz

다음과 같은 파일들이 압축 해제가 된다.

migration.sh
migration.jar
jdbc/(JDBC drivers)

마이그레이션 툴킷 콘솔 실행

실행 방법은 migration.sh <마이그레이션 스크립트 파일명>로 실행하면 된다.
또한, 뒤에 옵션 없이 migration.sh를 실행하면, 마이그레이션에 사용할 마이그레이션 스크립트 파일명을 직접 입력할 수도 있다.
이제 클라이언트 UI에서 원하는 마이그레이션 스크립트(xml파일)을 만들어보자!

마이그레이션 스크립트 작성 및 준비

마이그레이션 스크립트 파일을 작성하기 위해 마이그레이션 시나리오 1 ~ 3중 해당하는 작업 환경에 따라 진행한 후 최종 단계에서 마이그레이션을 시작하는 대신 |마이그레이션 스크립트 저장| 버튼을 클릭하여 XML 형태의 마이그레이션 스크립트 파일을 저장한다.

작업할 서버> 마이그레이션 콘솔 설치 디렉터리로 마이그레이션 스크립트 파일을 업로드 한다.
만약, 클라이언트 환경에 있는 sql, csv, sql 파일을 로딩하여 DB로 입력하는 시나리오라면, 이 파일들도 함께 마이그레이션 콘솔 설치 디렉터리로 업로드한다.

마이그레이션 시작

작성한 마이그레이션 스크립트(migration.xml)가 준비되었다면 아래와 같이 실행하여 마이그레이션을 시작할 수 있다.

$ ./migration.sh migration.xml

주의/트러블 슈팅

만약, 아래와 같이 jdbc 드라이버의 위치를 요구할 경우에는 jdbc full path를 입력해야 한다.

Please specify the source database's JDBC driver:
Please specify the target database's JDBC driver:

만약, 자동으로 진행하기를 원한다면, migration script(xml)에는 아래와 같은 부분이 source와 target 두 군데 있는데, driver의 경로를 console이 설치된 jdbc내부에 있는 해당 jdbc driver의 fullpath를 설정해야만 위와 같은 질문 없이 자동으로 마이그레이션이 진행된다.

<jdbc charset="UTF-8" driver="C:\cubridmigration\jdbc\JDBC-8.4.1.jar" host="0.0.0.0" name="testdb1" password="" port="33000" timezone="Default" user="dba"/>

이후 과정은 GUI 환경에서 실행되는 마이그레이션 툴킷과 동일하게 진행되며 진행 상태만 간략하게 출력이 된다.

마이그레이션 결과 확인

마이그레이션이 완료(또는 실패)되면 아래와 같이 리포트가 생성된다.

The report file was saved as : [....\report\1338953415916.mh]

GUI용 마이그레이션 툴킷으로 파일을 가져와서 report 디렉토리에 파일을 복사한 후 마이그레이션 툴킷을 실행하여, 마이그레이션 이력 보기(마이그레이션 툴킷의 툴바에서 실행 가능)를 하면 상세 리포트를 확인할 수 있다.

Using CUBRID with NHibernate - Advanced tutorial (Part I)

2013-06-12T07:26:54-07:00

June, 2013

Introduction

This tutorial is the continuation of the CUBRID NHibernate Beginner's guide tutorial.

If you have not read yet the Beginner's Guide, we strongly suggest doing it, before proceeding further with this tutorial.

The scope of this next tutorial is to show you some more advanced topics in regard to suing CUBRID and NHibernate together:

Tables relationships
Dealing with CUBRID special data types

Let’s start!

Recap

In the previous NHibernate tutorials we showed you where to get:

The NHibernate CUBRID extensions library
The CUBRID ADO.NET library
...And how to setup a MS Visual Studio project

To recap:

Download the CUBRID ADO.NET Data provider installer from here or

Compile the CUBRID ADO.NET data provider yourself from the source code; checkout the code from theSVN repository: http://svn.cubrid.org/cubridapis/adodotnet/branches/RB-9.1.0/
Download the NHibernate with CUBRID extensions:
Precompiled dll or

Download the source code and compile it yourself:

http://svn.cubrid.org/cubridapis/NHibernate
You need to add in MS Visual Studio the references to these libraries:
- NHibernate.dll
- CUBRID.Data.dll

Table relationships

When dealing with databases, one of the most important parts is handling the relationships between database tables. NHibernate makes this task easier because the relationships are mapped only once at the beginning of the development phase of a project, and then NHibernate handles automatically all the operations for you. In the following example we will demonstrate how to work with 1:N and M:N relationships.

1:N relationship

To exemplify a 1:N relationship we will use two demodb tables:

athlete
nation

The mapping files

In the Nation.hbm.xml mapping file the relationship is mapped as bag element that has two child elements: akey element which specifies the column in the foreign key table that references the Nation table, and a one-to-many element which specifies the name of the class that references Nation. In addition, notice that in the bag element we have set the cascade attribute. The all-delete-orphan cascade style means that when an object is saved/updated/deleted, NHibernate checks the associations and saves/updates/deletes all the objects found. In additional to that, when an object is removed from the association and not associated with another object (orphaned), NHibernate also deletes it.

More information on NHibernate cascade styles can be found here.

<?xml version="1.0" encoding="utf-8" ?>
<hibernate-mapping xmlns="urn:nhibernate-mapping-2.2"
assembly="OneNRelationship"
namespace="OneNRelationship">
<class name="Nation">
<id name="code" >
<column name="code"/>
</id>
<property name="name" not-null="true"/>
<property name="continent"/>
<property name="capital"/>
<bag name="Athletes" cascade="all-delete-orphan" inverse="true">
<key column="nation_code" />
<one-to-many class="Athlete"/>
</bag>
</class>
</hibernate-mapping>

<?xml version="1.0" encoding="utf-8" ?>
<hibernate-mapping xmlns="urn:nhibernate-mapping-2.2"
assembly="OneNRelationship"
namespace="OneNRelationship">
<class name="Athlete" table="athlete">
<id name="code">
<generator class="identity" />
</id>
<property name="name"/>
<property name="gender"/>
<property name="nation_code"/>
<property name="athlete_event" column="event"/>
</class>
</hibernate-mapping>

The Persistent Classes

In the Nation persistent class, the 1:N relationship is represented as an IList of Athletes. This list will be populated with the corresponding entries from the Athlete table when a nation is queried:

namespace OneNRelationship
{
  class Nation
  {
    virtual public string code { get; set; }
    virtual public string name { get; set; }
    virtual public string continent { get; set; }
    virtual public string capital { get; set; }
    public virtual IList<Athlete> Athletes { get; set; }
  }
}

namespace OneNRelationship
{
  class Athlete
  {
     virtual public int code { get; set; }
     virtual public string name { get; set; }
     virtual public string gender { get; set; }
     virtual public string nation_code { get; set; }
     virtual public string athlete_event { get; set; }
  }
}

Next, we will see how to perform the basic operations (INSERT, SELECT, UPDATE, DELETE) on the relationship we just mapped.

INSERT

To perform an INSERT operation, we create a Nation and an Athlete object as usual. What is different here is that the athlete is added to the Athletes list of the nation object. After doing this, when we save a nation, NHibernate will also insert the corresponding athlete because in the mapping file we set the cascade style of the relationship to cascade-all-delete-orphan.

Nation nation = new Nation
{
   code = "ROM",
   name = "Romania",
   capital = "Bucharest",
   continent = "Europe",
   Athletes = new List<Athlete>()
};
Athlete athlete = new Athlete
{
   name = "Lucian Bute",
   gender = "M",
   nation_code = "ROM",
   athlete_event = "Boxing",
};
nation.Athletes.Add(athlete);
using (ISession session = sessionFactory.OpenSession())
{
    using (ITransactiontx = session.BeginTransaction(IsolationLevel.ReadUncommitted))
    {
        session.Save(nation);
        tx.Commit();
    }
}

SELECT

A SELECT operation can be performed in the standard way to retrieve both the nations and the athletes.

But what do we do if we want to retrieve a nation together with its corresponding athletes?

To do this, when we will use the Fetch() method, which is an extension of the ISession class.That additional method says: "Hey, NHibernate! Go and get the nation, but also the athletes too!"

using (ISession session = sessionFactory.OpenSession())
{
    foreach (Nation currentNation in session.Query<Nation>().Fetch(b =>b.Athletes))
    {
        System.Console.WriteLine(string.Format("Nation {0} has athletes:", currentNation.name));
        foreach (Athlete currentAthlete in currentNation.Athletes)
        {
            System.Console.WriteLine(string.Format("\t{0}", currentAthlete.name));
        }
    }
}

Note: In order to use the Query<T>() method you have to import the NHibernate.Linq namespace.

using NHibernate.Linq;

UPDATE

An UPDATE operation is straight forward. We just update the properties of our Nation and Athlete objects and call the Update() method from ISession on our nation. Again, NHibernate will also update the corresponding athlete because of the cascade style we've set in the mapping:

using (ISession session = sessionFactory.OpenSession())
{
    using (ITransaction tx = session.BeginTransaction(IsolationLevel.ReadUncommitted))
    {
        nation.capital = "Bucuresti";
        athlete.name = "Leonard Doroftei";
        session.Update(nation);
        tx.Commit();
    }
}

DELETE

Just like the UPDATE operation, DELETE is done in a standard way on a Nation object and the delete-orphan cascade style will delete the orphan athletes:

using (ISession session = sessionFactory.OpenSession())
{
    //Delete an inserted information
    using (var trans = session.BeginTransaction(IsolationLevel.ReadUncommitted))
    {
        session.Delete(nation);
        trans.Commit();
    }
}

M:N relationships

In this section, we will go a step further and see how to handle M:N relationships using the Athlete and the Event tables from the demodb database:

Let's say that we want to know in what events does an athlete take part, but also, we want to know who the athletes that take part in an event are. It is obvious that we are dealing with a M:N relationship so let's see how we go about mapping it.

By design, NHibernate only supports the implicit many-to-many mapping if there is absolutely nothing other than the pair of FKs represented in the intermediate (“middle”) table that holds the many-to-many relationship information.

So, because we don't have such a table already in the database, let's create one (in the following we will refer to this table as the reference table):

CREATE TABLE athleteevent(
event_code integer NOT NULL,
athlete_code integer NOT NULL,
CONSTRAINT pk_athleteevent_event_code_athlete_code PRIMARY KEY(event_code,athlete_code)
)

Now let's add a couple of records to the table so we can link athletes to events:

INSERT INTO AthleteEvent VALUES (20038, 10011), (20038, 14313)

The mapping files

To map the M:N relationship, we will again use a bag element in both our mapping files, but this time with some differences . First of all, we add the table attribute to tell NHibernate that it is dealing with a reference table. Next, instead of the <one-to-many/> tag, we use the <many-to-many> tag. This specifies that the relationship is M:N with the table given by the class attribute, and the reference column given by the column attribute. Note that, the key column and the many-to-many column are columns from the AthleteEvent table. Notice that we used the cascade attribute again, in the same way we did for the 1:N relationship:

<?xml version="1.0" encoding="utf-8" ?>
<hibernate-mapping xmlns="urn:nhibernate-mapping-2.2"
assembly="NMRelationship"
namespace="NMRelationship">
<class name="Athlete" table="Athlete">
<id name="code">
<generator class="identity" />
</id>
<property name="name"/>
<property name="gender"/>
<property name="nation_code"/>
<property name="athlete_event" column="event"/>
<bag name="Events" table="AthleteEvent" cascade="all-delete-orphan" lazy="true">
<key column ="athlete_code" />
<many-to-many class="Event" column="event_code" />
</bag>
</class>
</hibernate-mapping>

<?xml version="1.0" encoding="utf-8" ?>
<hibernate-mapping xmlns="urn:nhibernate-mapping-2.2"
assembly="NMRelationship"
namespace="NMRelationship">
<class name="Event" table="Event">
<id name="code">
<column name="code" />
</id>
<property name="sports"/>
<property name="name"/>
<property name="gender"/>
<property name="players"/>
<bag name="Athletes" table="AthleteEvent" cascade="all-delete-orphan" inverse="true" lazy="true">
<key column ="event_code" />
<many-to-many class="Athlete" column="athlete_code" />
</bag>
</class>
</hibernate-mapping>

The Persistent Classes

The persistent classes have nothing special. All we need to do is to add IList properties that correspond to the other class:

namespace NMRelationship
{
    class Athlete
    {
        virtual public int code { get; set; }
        virtual public string name { get; set; }
        virtual public string gender { get; set; }
        virtual public string nation_code { get; set; }
        virtual public string athlete_event { get; set; }
        virtual public IList<Event> Events { get; set; }
  }
}
 
namespace NMRelationship
{
    class Event
    {
        virtual public int code { get; set; }
        virtual public string sports { get; set; }
        virtual public string name { get; set; }
        virtual public string gender { get; set; }
        virtual public int players { get; set; }
        virtual public IList<Athlete> Athletes { get; set; }
    }
}

Next, we will see how to perform the basic operations (INSERT, SELECT, UPDATE, DELETE) on the M:Nrelationship we mapped.

INSERT

We perform an INSERT operation in the same way we've done before. Just add an Event to the Athlete's list of events and NHibernate will do the rest: it will insert the athlete, the event and it will add a corresponding entry in the AthleteEvent table too:

Configuration cfg = (new Configuration()).Configure().AddAssembly(typeof (Athlete).Assembly);
ISessionFactory sessionFactory = cfg.BuildSessionFactory();
Athlete athlete = new Athlete {
    name = "Lucian Bute",
    gender = "M",
    nation_code = "ROM",
    athlete_event = "Boxing",
    Events = new List<Event>()
};
athlete.Events.Add(new Event { code = 20422, sports = "Boxing", name = "70 Kg", gender = "M", players = 2 });
using (ISession session = sessionFactory.OpenSession())
{
    using (ITransaction tx = session.BeginTransaction(IsolationLevel.ReadUncommitted))
    {
        session.Save(athlete);
        tx.Commit();
    }
}

SELECT

Again, no difference from the 1:N relationship in the previous section. The only thing worth noting is that NHibernate will create a circular reference between an athlete and its events. That means that the elements in the athlete's list of events will contain a list of their corresponding athletes and so on:

using (ISession session = sessionFactory.OpenSession())
{
    foreach (Athlete currentAthlete in session.Query<Athlete>().Fetch(b =>b.Events))
    {
        if (currentAthlete.Events.Count != 0)
        {
            Console.WriteLine(string.Format(
                "Athlete {0} takes part in {1} along with:",
                currentAthlete.name, currentAthlete.Events[0].name));
            foreach (Athlete currentEventAthletes in currentAthlete.Events[0].Athletes)
            {
                Console.WriteLine(string.Format("\t{0}", currentEventAthletes.name));
            }
        }
    }
}

UPDATE

The update operation is performed just like before:

athlete.name = "Leonard Doroftei";
athlete.Events[0].name = "65 Kg";
using (ISession session = sessionFactory.OpenSession())
{
    using (ITransaction tx = session.BeginTransaction(IsolationLevel.ReadUncommitted))
    {
        session.Update(athlete);
        tx.Commit();
    }}

DELETE

The delete-orphan cascade style is the important thing here. If we delete an athlete with this cascade style, NHibernate will also delete the corresponding entry in the reference table, but more important, it will also delete the corresponding events even though they might correspond to other athletes, so you have to be careful with your configuration. In our case, this is not a problem since we are sure that our event corresponds to just one athlete:

using (ISession session = sessionFactory.OpenSession())
{
    using (ITransaction tx = session.BeginTransaction(IsolationLevel.ReadUncommitted))
    {
        session.Delete(athlete);
        tx.Commit();
    }
}

This concludes the 1st part of this tutorial. You can find the 2nd part here.

Using CUBRID with NHibernate - Advanced tutorial (Part II)

2013-06-12T03:59:11-07:00

June, 2013

Introduction

This is the 2nd part of the Using CUBRID with NHibernate Advanced tutorial.

In this part, we will discuss about dealing with CUBRID special data types in NHibernate.

CUBRID special data types

Out-of-the-box, NHibernate Core does not support the following CUBRID special data types:

CLOB
BLOB
SET
MULTISET
LIST/SEQUENCE
ENUM

We have submitted a code patch to the NHibernate Core project – we will let you know when CUBRID support will be available in the official NHibernate Core libraries.

In the meantime, you will have to use the precompiled libraries we have already published (or apply the CUBRID NHibernate patch and compile the NHibernate Core library yourself) – see the 1st tutorial.

So, in this part we will show you how to deal in NHibernate with some of these CUBRID special data types.

CUBRID LOB

CUBRID CLOB is a data type used to store large character string data.The maximum length of CLOB data is the maximum file size which can be created on the external storage, which depends on the OS specifics.

In this section we will use NHibernate to store and retrieve a text file in the demodb database. As usual, the first thing we need to do is to create a table with a CLOB column:

CREATE TABLE testcubridclob(
   c_integer integer AUTO_INCREMENT(1,1) NOT NULL,
   c_clob clob,
   CONSTRAINT pk_testcubridclob_c_integer PRIMARY KEY(c_integer)
)

The Mapping File

Because NHibernate does not support CUBRID CLOB out-of-the-box, we have to add a new attribute to the <property> tag corresponding to the CUBRID CLOB column: type = "CUBRIDClob". This will tell NHibernate that it is dealing with a CUBRIDClob object at it will handle it approprietly.

<?xml version="1.0" encoding="utf-8" ?>
<hibernate-mapping xmlns="urn:nhibernate-mapping-2.2"
assembly="NHibernateTestCases"
namespace="CUBRID.Data.TestNHibernate">
<class name="TestCUBRIDClobType" table="TestCUBRIDClob">
<id name="c_integer">
<generator class="identity" />
</id>
<property name="c_clob" type="CUBRIDClob">
<column name="c_clob" sql-type="CLOB" />
</property>
</class>
</hibernate-mapping>

The Persistent Class

In the persistent class, the property corresponding to the CUBRIDClob Column will be of type CUBRID.Data.CUBRIDClinet.CUBRIDClob:

namespace CUBRID.Data.TestNHibernate
{
    public class TestCUBRIDClobType
    {
        virtual public int c_integer { get; set; }
        virtual public CUBRID.Data.CUBRIDClient.CUBRIDClobc_clob { get; set; }
    }
}

INSERT

To insert a CLOB object in our table we will perform the following operations: read a file from the disk using a StreamReader, create a CUBRIDClob object using the CUBRID ADO.NET Driver, fill our CUBRIDClob object with the content of our file through the SetString() method and then use NHibernate to perform the insert operation just like we would with a normal data type.

The CLOB data type is a special data types also in the CUBRID ADO.NET Driver, so in order to handle it some dedicated specific operations are implemened. You can get more information on handling LOB objects with the CUBRID ADO.NET Driver here.

Configuration cfg = (new Configuration()).Configure().AddAssembly(typeof(TestCUBRIDClobType).Assembly);
TestCUBRIDClobType test = new TestCUBRIDClobType {
    c_clob = new CUBRIDClob(conn)
};
StreamReader originalFileReader = new StreamReader("../../BSD License.txt");
string clobStringToInsert = originalFileReader.ReadToEnd();
originalFileReader.Close();
test.c_clob.SetString(1, clobStringToInsert);

//Insert
ISessionFactorysessionFactory = cfg.BuildSessionFactory();
using (var session = sessionFactory.OpenSession())
{
    using (var trans = session.BeginTransaction(IsolationLevel.ReadUncommitted))
    {
        session.Save(test);
        trans.Commit();
    }
}

SELECT

Retrieving the CLOB from the database is done the other way around: use NHibernate to get a CUBRIDClob object from the ADO.NET Driver, use that object to get the CLOB content through the GetString() method and save the content to a new file on the disk:

ISessionFactorysessionFactory = cfg.BuildSessionFactory();
using (var session = sessionFactory.OpenSession())
{
    //Retrieve the inserted information
    IQuery query = session.CreateQuery("FROM TestCUBRIDClobType");
    IList<TestCUBRIDClobType>testQuery = query.List<TestCUBRIDClobType>();
    CUBRIDClob bImage = testQuery[0].c_clob;
    string clobInserted = bImage.GetString(1, (int)testQuery[0].c_clob.ClobLength);
    System.IO.StreamWriter file = new System.IO.StreamWriter("../../Retrieved.txt");
    file.WriteLine(clobInserted);
    file.Close();
}

CUBRID SET

CUBRID SET is a collection type in which each element has different values. Elements of a SET are allowed to have only one data type. It can have records of other tables.

Handling the CUBRID SET data type in NHibernateis pretty much the same as handling a normal data type, with the exception that it is not supported out-of-the-box so we have to use the type attribute of the <property> tag again to tell NHibernate how to handle this kind of object. This time the attribute will be: type = "CUBRIDCollection".

In the following example we will use a CUBRID SET column to store the ingredients of a recipe. The SQL used for the creation of our table is:

CREATE TABLE recipe(
   id integer AUTO_INCREMENT(1,1) NOT NULL,
   recipe_name character varying(1073741823),
   ingredients set_of(character varying(10)),
   CONSTRAINT pk_recipe_id PRIMARY KEY(id)
)

The Mapping file

<?xml version="1.0" encoding="utf-8" ?>
<hibernate-mapping xmlns="urn:nhibernate-mapping-2.2"
assembly="CUBRIDSet"
namespace="CUBRIDSet">
<class name="Recipe" table="recipe">
<id name="id">
<generator class="identity" />
</id>
<property name="name">
<column name="recipe_name"/>
</property>
<property name="ingredients" type="CUBRIDCollection">
<column name="ingredients"/>
</property>
</class>
</hibernate-mapping>

The persistent class

In the persistent class the CUBRID SET column is represented by an array of objects. This is because the column can contain both numeric and string values.

namespace CUBRIDSet
{
    class Recipe
    {
        virtual public int id { get; set; }
        virtual public string name { get; set; }
        virtual public object[] ingredients { get; set; }
    }
}

To insert our SET values, we just have to create an array of objects, set it with the elements of the set and perform the operation normally:

Configuration cfg = (new Configuration()).Configure().AddAssembly(typeof(Recipe).Assembly);
object[] ingredients = { "apples", "eggs", "flour", "yeast" };
Recipe recipe = new Recipe() {
    name = "Apple pie",
    ingredients = ingredients
};
ISessionFactory sessionFactory = cfg.BuildSessionFactory();
using (var session = sessionFactory.OpenSession())
{
    using (var trans = session.BeginTransaction(IsolationLevel.ReadUncommitted))
    {
        session.Save(recipe);
        trans.Commit();
    }
}

Now let's retrieve the inserted information. There is really no difference from handling a normal data type in NHibernate:

using (var session = sessionFactory.OpenSession())
{
    //Retrieve the inserted information
    IQuery query = session.CreateQuery(" from Recipe");
    IList<Recipe> recipies = query.List<Recipe>();
    for (var i = 0; i <recipies.Count; i++)
    {
        Console.Write("{0} is made out of: ", recipies[i].name);
        foreach (var ingredient in recipies[i].ingredients)
        {
            Console.Write("{0}, ", ingredient);
        }
    Console.WriteLine();
    }
}

Note: CUBRID SET is a collection type in which each element has different values so if we try to insert duplicates like:

object[] ingredients = { "apples", "eggs", "flour", "yeast" , "apples"};

, we will get the same result as before, because CUBRID will discard the duplicates.

CUBRID LIST/SEQUENCE

CUBRID LIST (= SEQUENCE) is a collection type in which the input order of elements is preserved, and duplications are allowed. Elements of a LIST are allowed to have only one data type. It can have records of other tables.

To demonstrate the use of CUBRID LIST/SEQUENCE we will create a table called student_class in which we will store in a LIST column the students that study in that class. The SQL statement used for the creation of the table is:

CREATE TABLE students_class(
    id integer AUTO_INCREMENT(1,1) NOT NULL,
    class_name character varying(1073741823),
    students sequence_of(character varying(30)),
    CONSTRAINT pk_class_id PRIMARY KEY(id)
)

The Mapping file

Handling CUBRID LIST/SEQUENCE columns is the same as handling the CUBRID SET columns which we discussed earlier. All we need to do apart from a normal mapping is to set the type attribute of the <property> tag like this: type = "CUBRIDCollection":

<?xml version="1.0" encoding="utf-8" ?>
<hibernate-mapping xmlns="urn:nhibernate-mapping-2.2"
assembly="CUBRIDList"
namespace="CUBRIDList">
<class name="Class" table="students_class">
<id name="id">
<generator class="identity" />
</id>
<property name="name">
<column name="class_name"/>
</property>
<property name="students" type="CUBRIDCollection">
<column name="students"/>
</property>
</class>
</hibernate-mapping>

The Persistent Class

As discussed in the previous CUBRID SET example, the LIST column will be persisted like an array of objects:

namespace CUBRIDList
{
    class Class
    {
        virtual public int id { get; set; }
        virtual public string name { get; set; }
        virtual public object[] students { get; set; }
    }
}

Let's now insert something into the table:

Configuration cfg = (new Configuration()).Configure().AddAssembly(typeof(Class).Assembly);
object[] students = { "John Doe", "Amy Smith", "Mark Stevans", "Bety Ross" };
Class recipe = new Class() {
    name = "First Grade",
    students = students
};
ISessionFactory sessionFactory = cfg.BuildSessionFactory();
using (var session = sessionFactory.OpenSession())
{
    using (var trans = session.BeginTransaction(IsolationLevel.ReadUncommitted))
    {
        session.Save(recipe);
        trans.Commit();
    }
}

As before, we create an object array and set it with our student names. Please note that the students were not put in any particular order. Let's see what happens when we retrieve the students from the database:

using (var session = sessionFactory.OpenSession())
{
    //Retrieve the inserted information
    IQuery query = session.CreateQuery(" from Class");
    IList<Class> classes = query.List<Class>();
    for (var i = 0; i <classes.Count; i++)
    {
        Console.WriteLine("In {0} study the following students: ", classes[i].name);
        foreach (var student in classes[i].students)
        {
            Console.WriteLine("\t{0}", student);
        }
    }
}

As you can see, the students were retrieved in alphabetical order.

CUBRID ENUM

The CUBRID ENUM type is a data type consisting of an ordered set of distinct constant char literals called enum values.Only the specified string elements are allowed as the value of the column defined as ENUM and the maximum number of the ENUM elements is 65535.

In the following, we will see how to handle insert and select operations on CUBRIDENUM columns. But first, let's create a table in the demodb database with an ENUM column:

CREATE TABLE "colors"(
    "id" integer AUTO_INCREMENT(1,1) NOT NULL,
    "color" ENUM('red', 'green', 'blue'),
    PRIMARY KEY("id")
);

NHibernate does not support the CUBRID ENUM type out-of-the-box, but in this case we can take advantage of the fact that the value of an ENUM column is just a char literal, so we will map this column in NHibernate just like we would a STRING, CHAR, or VARCHAR column. The only difference is that we will specify that the sql-type of the column is ENUM.

The Mapping file

<?xml version="1.0" encoding="utf-8"?>
<hibernate-mapping assembly="CUBRIDEnum" namespace="CUBRIDEnum" xmlns="urn:nhibernate-mapping-2.2">
<class name="Colors" table="colors" lazy="true" >
<id name="id">
<generator class="identity" />
</id>
<property name="color">
<column name="color" sql-type="ENUM" not-null="false" />
</property>
</class>
</hibernate-mapping>

The Persistent Class

namespace CUBRIDEnum
{
    class Colors
    {
        virtual public int id { get; set; }
        virtual public string color { get; set; }
    }
}

Once we have the persistent class and the mapping document in place, we can perform INSERT and SELECT operations. Let's insert three records in the table - one of each color in our enumeration:

Configuration cfg = (new Configuration()).Configure().AddAssembly(typeof(Colors).Assembly);
Colors red = new Colors {
    color = "red"
};
Colors green = new Colors {
    color = "green"
};
Colors blue = new Colors {
    color = "blue"
};
ISessionFactory sessionFactory = cfg.BuildSessionFactory();
using (var session = sessionFactory.OpenSession()) {
    using (var trans = session.BeginTransaction(IsolationLevel.ReadUncommitted))
    {
        session.Save(red);
        session.Save(green);
        session.Save(blue);
        trans.Commit();
    }
}

And now, let's retrieve the inserted records:

using (var session = sessionFactory.OpenSession())
{
    //Retrieve the inserted information
    IQuery query = session.CreateQuery("FROM Colors");
    IList<Colors> colors = query.List<Colors>();
    Console.WriteLine("The colors in the table are:");
    Console.WriteLine("id\t\tColor");
    Console.WriteLine("_________________________");
    for (var i = 0; i <colors.Count; i++)
    {
        Console.WriteLine(colors[i].id + "\t|\t" + colors[i].color);
    }
}

The console output from running the code is:

Note: As can be seen from the SQL statement we used to create the table, the color column can take one of the three values: 'red', 'green', 'blue'. Trying to insert a different a different value, like yellow or orange will result in the following error:

Semantic: before ' );'

Cannot coerce 'yellow' to type enum. insert into colors colors (colors.color) values ( cast('yell...

Important! We have presented here just some of the CUBRD special data types mappings in NHibernate.

The rest are pretty much similar to deal with – but if you need some ready-to-go code, please take a look at the CUBRID NHibernate test cases suite.

And this concludes our tutorial!J

References

CUBRID NHibernate Wiki page	http://www.cubrid.org/wiki_apis/entry/cubrid-nhibernate-support
NHibernate home page	http://nhforge.org/
CUBRID ADO.NET driver	http://www.cubrid.org/wiki_apis/entry/cubrid-ado-net-driver
CUBRID NHibernate source code	http://svn.cubrid.org/cubridapis/NHibernate
CUBRID-enabled NMG tool	http://nmg.codeplex.com

We hope you enjoyed the CUBRID NHibernate tutorials series!

As always, we kindly ask you to let us know your feedback and suggestions, so we can improve!

Thank you!

The CUBRID API team

Using CUBRID with NHibernate - Beginner's Guide

2013-06-10T06:56:47-07:00

Introduction

As you probably know already, NHibernate is a .NET port of the well-known Hibernate Java framework.It is an open source project which implements persisting objects (an ORM) to and from an underlying relational database – MySQL, PostgreSQL, SQL Server, Oracle etc.

What we have done in the scope of the CUBRID NHibernate project was to add support in NHibernate for CUBRID.

Note: This tutorial assumes that you are familiar with Hibernate, from which NHibernate is derived!

If you are not familiar, we strongly suggest reading more about Hibernate, before proceeding further with this tutorial.

And to help you get started fast with CUBRID and NHibernate working together, we have prepared a couple of tutorials!

This tutorial will introduce you to the very basics of working with NHibernate and CUBRID; it will be followed shortly by an “advanced tutorial”.

So let’s get started!

Software prerequisites

Before you start developing .NET applications with CUBRID and NHibernate, you will need the NHibernate libraries and the CUBRID ADO.NET Data provider library(Cubrid.Data.dll):

Download the CUBRID ADO.NET Data provider installer from here or

Compile the CUBRID ADO.NET data provider yourself from the source code; checkout the code from theSVN repository: http://svn.cubrid.org/cubridapis/adodotnet/branches/RB-9.1.0/
Download the NHibernate with CUBRID extensions:
Precompiled dll or

Download the source code and compile it yourself:

http://svn.cubrid.org/cubridapis/NHibernate
For this tutorial, you will also need Microsoft Visual Studio 2010/2012 (the freeware Express edition or the Professional/Ultimate)

Setup the environment

Installing NHibernate with the CUBRID extensions

If you've downloaded the NHibernate with CUBRID extensions binaries in a zip file from here, all you need to do is extract that files. In this tutorial we will use this folder: C:\NHibernateCUBRID. And that's it, NHibernate is installed - there's nothing else to be done to get NHibernate.

All is left to do now is add the required references to you project. We will see in the following sections how to create a MS Visual Studio project with the proper references and settings.

Compiling NHibernate with CUBRID extensions

If you want to compile NHibernate with CUBRID extensions from the source code, all you need to do is load in Visual Studio 2012 the solution file located in the \NHibernate\src\ folder and build the NHibernate project:

Creating a MS Visual Studio project

Now that we have the NHibernate binaries in place, let's see how to create a Visual Studio project and add the required references and settings in order to use NHibernate with CUBRID database.

Since we're not going to be focusing on the user interface in this tutorial, we will see how to create a C# console application project.

So, fire up MS Visual Studio and create a new C# console application. Let's call it HelloNHibernate.

Please note that it is strongly recommended to stick to this naming since in many cases these names may be used in other parts of the tutorial.

Next, we have to add the references to NHibernate:

…and the CUBRID ADO.NET Data provider:

The last step is to configure NHibernate for use with CUBRID.

We do that by adding to our project a new xml configuration file called hibernate.cfg.xml. In order for NHibernate to use it as its configuration file we have to set the Build Action property to Embedded Content and its Copy to Output Directory property to Copy always.

The content of the file is as follows:

<?xml version="1.0" encoding="utf-8" ?>
<hibernate-configuration xmlns="urn:nhibernate-configuration-2.2">
<!-- an ISessionFactory instance -->
<session-factory>
<!-- properties -->
<property name="connection.provider">
NHibernate.Connection.DriverConnectionProvider
</property>
<property name="connection.driver_class">
NHibernate.Driver.CUBRIDDriver
</property>
<property name="connection.connection_string">
server=localhost;database=demodb;port=33000;user=public;password=
</property>
<property name="dialect">
NHibernate.Dialect.CUBRIDDialect
</property>
</session-factory>
</hibernate-configuration>

Here is a quick intro of the properties declared inside the xml file:

connection.provider sets which connection provider should be used by NHibernate to connect to the database.
connection.driver_class sets which driver should be used and in this case, when using CUBRID, CUBRIDDriver is the logical choice
connection.connection_string is the connection string to the database. In this tutorial we will use the default CUBRID Connection string.
dialect states the NHibernate class name that enables certain platform dependent features, and in this case, since we are using CUBRID, the obvious choice is CUBRIDDialect

That is all. We are now ready to start coding with NHibernate and CUBRID!

A first NHibernate CUBRID application

For a first example of using NHibernate with CUBRID, we will use the Athlete table from the demodb database, which comes with your CUBRID install and we will see how to retrieve data from that table.

The NHibernate persistence class

Let’s create a new class in your project named Athlete with the properties below (note that NHibernate is case sensitive, so our property names will need to exactly match our NHibernate mapping that we will be creating later):

namespace HelloNHibernate
{
    public class Athlete
    {
        virtual public int code { get; set; }
        virtual public string name { get; set; }
        virtual public string gender { get; set; }
        virtual public string nation_code { get; set; }
        virtual public string athlete_event { get; set; }
    }
}

The mappings

To be able to use the Athlete class, it is necessary to create a NHibernate mapping file that contains the metadata that NHibernate uses for the object/relational mapping, i.e., connecting the class declaration, the properties to columns, and keys in the database tables.

So, we will create a new xml file called Athlete.hbm.xml and set its Build Action property to Embedded Resource. The content of the file is:

Within the hibernate-mapping tag, we're referencing both the assembly and namespace that the classes (POCOs) below reside in. This is handy when your mapping files end up in a separate namespace or assembly than your model.

The class element represents our mapping to a single POCO. The name represents the name of a class within the assembly and namespace from above, while the table attribute tells NHibernate which table or view in our database to map to.
The id element tells NHibernate which database field and corresponding object property to use as a unique key. In this case, we are using the Code field.
The generator element tells NHibernate how to create unique IDs for new entities. Since CUBRID supports identity columns through AUTO_INCREMENT, we specify the generator class as 'identity'.
The property tag is the tag you will see the most. This simply maps a POCO property to the corresponding field in our table or view.

<?xml version="1.0"encoding="utf-8" ?>
<hibernate-mapping xmlns="urn:nhibernate-mapping-2.2" assembly="HelloNHibernate" namespace="HelloNHibernate">
<class name="Athlete" table="Athlete">
<id name="code">
<generator class="identity" />
</id>
<property name="name"/>
<property name="gender"/>
<property name="nation_code"/>
<property name="athlete_event" column="event"/>
</class>
</hibernate-mapping>

The code

We are now ready to do some coding... In this example we will query the Athlete table and print the first ten entries in the console. The code is placed directly in the main method of our console application:

private static void Main(string[] args)
{
    Configuration cfg = (new Configuration()).Configure().AddAssembly(typeof (Athlete).Assembly);
    ISessionFactory sessionFactory = cfg.BuildSessionFactory();
    using (var session = sessionFactory.OpenSession())
    {
        IQuery query = session.CreateQuery("FROM Athlete");
        IList<Athlete> athletes = query.List<Athlete>();
        Console.WriteLine("There are {0} athletes in the databse.\n", athletes.Count);
        Console.WriteLine("The first 10 athletes are:\n");
        for (var i = 0; i < 9; i++)
        {    
            Console.WriteLine(
                string.Format("|{0}|{1}|{2}|{3}|{4}|",
                AlignCenter(athletes[i].code.ToString(), 5),
                AlignCenter(athletes[i].name, 30),
                AlignCenter(athletes[i].gender, 5),
                AlignCenter(athletes[i].nation_code, 5),
                AlignCenter(athletes[i].athlete_event, 20)));
        }
    }
    Console.WriteLine(@"Press any key to continue...");
    Console.ReadKey();
}

Our first line of the main method is simply creating an instance of the NHibernate Configuration object based on the values in our hihernate.cfg.xml file and then we load our mapping files. These are used to map our POCOs to our persistent database objects.

There are several techniques for loading these in, but all will require an assembly to be passed as a parameter. NHibernate will then look for all persistence mapping data within those assemblies:

Configuration cfg = (new Configuration()).Configure().AddAssembly(typeof (Athlete).Assembly);

Next, we open a Session from our SessionFactory. All of our NHibernate persistence operations will be handled within the context of a Session:

using (var session = sessionFactory.OpenSession())

With a session created, we can now get down to business. In cases where we are simply retrieving data, so our Session object is all we need.

Retrieving Athlete objects from the database is performed by creating aIQuery object from our session and execute the desired query using it. In addition, we use the List() method to retrieve a list of all the athletes in the database:

IQuery query = session.CreateQuery("FROM Athlete");
IList<Athlete> athletes = query.List<Athlete>();

Note that for printing the entries in the Athlete table in a easily readable format we use the AlignCentre method with the following code:

static string AlignCenter(string text, int width)
{
    if (string.IsNullOrEmpty(text))
    {
        return new string(' ', width);
    }
    else
    {
        return text.PadRight(width - (width - text.Length) / 2).PadLeft(width);
    }
}

The output from running the above code is:

An example which implements Update operations

In this example we will show how to handle the basic SQL operations (insert, select, update and delete) on all the standard data types.

For this purpose, we will create a table that has columns of all the standard SQLdata types. The SQL for creating this table is:

create TABLE DataTypes (
c_integer INTEGER AUTO_INCREMENT,
c_smallint SMALLINT,
c_bigint BIGINT,
c_numeric numeric(10,2),
c_float FLOAT,
c_decimal decimal(19,5),
c_double DOUBLE,
c_char char(1),
c_varchar varchar(30),
c_time TIME,
c_date DATE,
c_timestamp TIMESTAMP,
c_datetime DATETIME,
c_monetary MONETARY,
c_string STRING,
c_bit BIT(8),
c_varbit bit varying(8),
primary key (c_integer))

The Persistent class

As we did in the previous example, to persist our database table in NHibernate we create a class called DataTypes:

namespace HelloNHibernate
{
   public class DataTypes
   {
       virtual public int c_integer { get; set; }
       virtual public short c_smallint { get; set; }
       virtual public long c_bigint { get; set; }
       virtual public decimal c_numeric { get; set; }
       virtual public float c_float { get; set; }
       virtual public decimal c_decimal { get; set; }
       virtual public double c_double { get; set; }
       virtual public string c_char { get; set; }
       virtual public string c_varchar { get; set; }
       virtual public DateTimec_time { get; set; }
       virtual public DateTimec_date { get; set; }
       virtual public DateTimec_timestamp { get; set; }
       virtual public DateTime c_datetime { get; set; }
       virtual public intc_monetary { get; set; }
       virtual public String c_string { get; set; }
       virtual public byte c_bit { get; set; }
       virtual public byte c_varbit { get; set; }
   }
}

The Mappings

Again, to map the database column to our persistent class we have to create a mapping file called DataTypes.hbm.xml and set its Build Action property to Embedded Resource. The content of this file is as follows:

<?xml version="1.0" encoding="utf-8" ?>
<hibernate-mapping xmlns="urn:nhibernate-mapping-2.2" assembly="HelloNHibernate" namespace="HelloNHibernate">
<class name="DataTypes" table="DataTypes">
<id name="c_integer">
<generator class="identity" />
</id>
<property name="c_smallint" />
<property name="c_bigint" />
<property name="c_numeric" />
<property name="c_float" />
<property name="c_decimal" />
<property name="c_double" />
<property name="c_char" />
<property name="c_varchar" />
<property name="c_time" />
<property name="c_date" />
<property name="c_timestamp" />
<property name="c_datetime" />
<property name="c_monetary" />
<property name="c_string" />
<property name="c_bit" />
<property name="c_varbit" />
</class>
</hibernate-mapping>

The code

Now we have the persistent class and the mapping file ready.

Next we will implement a simple console application enables the user to perform the basic CRUD operations. The application will prompt the user for a supported type of operation and perform it. After that, the user is prompted again for a type of operation until he inputs a "Q" character which will close the application.

The full code for the application can be downloaded from here.

Insert

Whether we have one or several properties, creating our new persistent object follows the same pattern, and can be accomplished in just a few lines of code.

Create a Transaction within which you will perform your updates
Execute the Save method on your current session, passing the object you wish to persist as a parameter
Commit your transaction

private static void Create(ISession session, DataTypes entry)
{
    using (var trans = session.BeginTransaction(IsolationLevel.ReadUncommitted))
    {
        session.Save(entry);
        trans.Commit();
    }
}

Select

Retrieving object from the database is performed by creating aIQuery object from our session and execute the desired query using it. In addition, we use the List() method to retrieve the object as a list:

private static void Retrieve(ISession session)
{
    IQuery query = session.CreateQuery("FROM DataTypes");
    IList<DataTypes>dataTypes = query.List<DataTypes>();
    Console.WriteLine("There are {0} entries in the DataTypes table.", dataTypes.Count);
    for (var i = 0; i <dataTypes.Count; i++)
    {
       Console.WriteLine("Entry number {0} has c_integer {1} and was created at {2}",
          i+1, dataTypes[i].c_integer, dataTypes[i].c_datetime);
    }
    Console.WriteLine();
}

After performing these operations, the console output will look like this:

Please note that for appearance and simplicity purposes we didn't output to the console all the column values retrieved from the database. Instead, we output just the c_integer column value, which is the primary key of the table, and the c_datetime column value to differentiate between our entries.

Update

For simplicity purposes we will just update the c_datetime column. We will update a persistent object the same way we created one - by executing a method against the session object within the context of a transaction, as shown below:

private static void Update(ISession session)
{
    DataTypespGet = session.Get<DataTypes>(1);
    pGet.c_datetime = DateTime.Now;
    using (var trans = session.BeginTransaction(IsolationLevel.ReadUncommitted))
    {
        session.Update(pGet);
        trans.Commit();
    }
}

Let's see it in action:

Delete

For our last example, we will be deleting a record. Again, since this will affect our persistent entity, we will perform our delete method within the scope of a transaction, and pass the object we wish to delete as a parameter:

private static void Delete(ISession session)
{
    DataTypespGet = session.Get<DataTypes>(1);
    using (var trans = session.BeginTransaction(IsolationLevel.ReadUncommitted))
    {
        session.Delete(pGet);
        trans.Commit();
    }
}

And this concludes this first tutorial…!

In the next tutorial, we will go through some more advanced topics:

Tables relationships
Working with special CUBRID data types: LOB etc.

References

CUBRID NHibernate Wiki page	http://www.cubrid.org/wiki_apis/entry/cubrid-nhibernate-support
NHibernate home page	http://nhforge.org/
CUBRID ADO.NET driver	http://www.cubrid.org/wiki_apis/entry/cubrid-ado-net-driver
CUBRID NHibernate source code	http://svn.cubrid.org/cubridapis/NHibernate
CUBRID-enabled NMG tool	http://nmg.codeplex.com

We hope you enjoyed this tutorial! Stay tuned for the next part!

As always, we kindly ask you to let us know your feedback and suggestions, so we can improve!

Thank you!

The CUBRID API team

Using NMG (NHibernate Mappings Generator) with CUBRID

2013-06-08T00:49:43-07:00

June, 2013

In this tutorial we will show you how to usethe NMG(NHibernate Mapping Generator) application with CUBRID, to generate the NHibernate database mappings & code.

Introduction

NMG - "NHibernate Mapping Generator" is an application that can generate NHibernate mapping files and the corresponding domain classes from database tables:

It supports Oracle, SQLServer, PostgreSQL, MySQL, SQLite, Sybase, Ingres, and CUBRID
Can generate hbm.xml, Fluent NHibernate and NH 3.3 Fluent style of mapping files.
Has lots of preferences to control the property naming conventions.
Can generate Domain Entity and WCF Data Contracts too.
Can generate one table at a time or script entire DB in one go. (It can generate mapping for around 800 tables in under 3 minutes on my moderately powered laptop)
Supports ActiveRecord code generation.
It is free. No licensing restrictions.
Has the option to generate NHibernate or MS validators

Most important for the CUBRID community is that NMG does support CUBRID starting with version 4.0:

Setup

You can download the latest version of NHibernate Mapping Generator, complete with CUBRID support here.

To get started with NMG just download it and unzip the file into a location of you convenience.

Then, run the NHibernateMappingGenerator.exe executable file.

In order to generate NHibernate mapping files with NMG we first have to connect to a CUBRID database. To do that, launch NMG and create a new connection using the New connection button. In the connection dialog, type a name of your choice for this connection, set the Database Type to CUBRID, edit the connection parameters accordingly to your database setup (because the connection is done using the CUBRID ADO.NET driver, the connection string must use this syntax; you can easily generate the connection string here) and click Save.

In this tutorial we will use the default CUBRID ADO.NET connection parameters for the "demodb" database.

After creating the new connection click Connect and NMG will retrieve the list of the tables from the database and display the structure of the currently selected table:

NHibernate mappings

As mentioned before, NMG can generate:

(“standard”) .hbm.xml files
By code NHibernate mappings
NHibernate 3.3 Fluent style of mapping files

Also, NMG generates the domain class code associated with the mapping files. These mapping styles can be configured from the Preferences tab:

You can find more information by examining the tool source code here.

Let's see some simple examples of mapping files that NMG can generate. We will use the Stadium table from the demodb database.

*.hbm.xml mapping

Fluent mapping

By Code mapping

In addition, NMG also generates the corresponding Domain Class code:

As you can see, the NMG tool can significantly help the NHibernate CUBRID developer, by automatically generating all the mappings files and the domain classes’ code.

NMG is easy to use and it provides good support for CUBRID!

Examples

In this section we will see two examples of how NMG generates mapping files and domain classes.

The first example is a mapping of a 1:N relationship, and the second will be an example of how NMG maps a CUBRID CLOB type column.

1:N example

In this first example, we will show the generation of the mapping for a 1:N tables relationship.

For the purpose of this example we will create two simple tables that implement the 1:N relationship between a book and its chapters. The SQL used for the creation of the tables is:

CREATE TABLE "book"(
"id" integer AUTO_INCREMENT(1,1) NOT NULL,
"title" character varying(255) NOT NULL,
"author" character varying(255) NOT NULL,
CONSTRAINT pk_books_id PRIMARY KEY("id")
);

CREATE TABLE "chapter"(
"id" integer AUTO_INCREMENT(1,1) NOT NULL,
"title" character varying(100),
"bookid" integer,
CONSTRAINT  "fk_chapters_bookid" FOREIGN KEY ("bookid") REFERENCES "book"("id") ON DELETE RESTRICT ON UPDATE RESTRICT,
CONSTRAINT pk_chapters_id PRIMARY KEY("id")
);

After creating the tables and you connect to the database, when you select these tables and generate the NHibernate code you will obtain:

The generated Domain Code for the two tables is:

namespace NMGCubrid {
    public class Book {
        private System.Nullable<int> id;
        private string title;
        private string author;
        public Book() {
            Chapters = new List<Chapter>();
        }
        public virtual IList<Chapter> Chapters { get; set; }
    }
}

namespace NMGCubrid {
    public class Chapter {
        private System.Nullable<int> id;
        private Book Bookid;
        private string title;
    }
}

The 1:N relationship is implemented in the Book class by the Chapters member who represents a list of the book's corresponding chapters, and in the Chapter class by the Bookid member who will hold the chapter's corresponding book. The relationship is mapped in the hbm.xml generated files in the same way:

<?xml version="1.0" encoding="utf-8"?>
<hibernate-mapping assembly="NMGCubrid" namespace="NMGCubrid" xmlns="urn:nhibernate-mapping-2.2">
<class name="Book" table="book" lazy="true" >
<id name="Id">
<generator class="identity" />
<column name="id" sql-type="INT" not-null="true" unique="true" />
</id>
<property name="Title">
<column name="title" sql-type="STRING" not-null="true" />
</property>
<property name="Author">
<column name="author" sql-type="STRING" not-null="true" />
</property>
<bag name="Chapters" inverse="true" cascade="none">
<key column="bookid" />
<one-to-many class="Chapter" />
</bag>
</class>
</hibernate-mapping>

<?xml version="1.0" encoding="utf-8"?>
<hibernate-mapping assembly="NMGCubrid" namespace="NMGCubrid" xmlns="urn:nhibernate-mapping-2.2">
<class name="Chapter" table="chapter" lazy="true" >
<id name="Id">
<generator class="identity" />
<column name="id" sql-type="INT" not-null="true" unique="true" />
</id>
<property name="Title">
<column name="title" sql-type="STRING" not-null="false" />
</property>
<many-to-one insert="false" update="false" lazy="false" name="Bookid">
<column name="bookid" sql-type="INT" not-null="false" />
</many-to-one>
<property name="Bookid">
<column name="bookid" sql-type="INT" not-null="false" />
</property>
</class>
</hibernate-mapping>

In the Book mapping file the relationship is mapped as bag element that has two child elements: a key element which specifies the column in the foreign key table that references the Book table, and a one-to-many element which specifies the name of the class that references Book.

In the Chapter mapping file, the relationship is represented by the many-to-one element which makes the mapping between the bookid column and the corresponding book.

A CUBRID CLOB example

To exemplify how NMG maps CUBRID CLOB objects, we will create a table that contains a CLOB column and use NMG on this table. The SQL used for creating the tables is:

CREATE TABLE "clob_table"(
"id" integer NOT NULL,
"text" clob,
CONSTRAINT pk_clob_table_id PRIMARY KEY("id")
);

Now let's see the table's structure definition in NMG:

Notice that NMG detected the C# type of our CLOB column as CUBRID.Data.CUBIDClient.CUBRIDClob.

This information is also used in the generation of the Domain Code class:

namespace NMGCubrid {
    public class ClobTable {
        private System.Nullable<int> id;
        private CUBRID.Data.CUBRIDClient.CUBRIDClob text;
    }
}

As for the NHibernate mapping, NMG does NOT detect the NHibernate type for columns and does not include it in the xml mapping.

This is because the standard C# data type, like System.Int and System.String, are detected in NHibernate by reflection, but that is not the case for custom (=non-standard) data types like CUBRIDCLOB.

NMG will generateout-of-the-box the following xml mapping:

<?xml version="1.0" encoding="utf-8"?>
<hibernate-mapping assembly="NMGCubrid" namespace="NMGCubrid" xmlns="urn:nhibernate-mapping-2.2">
<class name="ClobTable" table="clob_table" lazy="true" >
<id name="Id">
<generator class="identity" />
<column name="id" sql-type="INT" not-null="true" unique="true" />
</id>
<property name="Text">
<column name="text" sql-type="CLOB" not-null="false" />
</property>
</class>
</hibernate-mapping>

So in order to use this mapping in a project, we MUST SET MANUALLY the NHibernate type by adding the type attribute to the property element corresponding to the CLOB column:

<property name="Text" type="CUBRIDClob">
<column name="text" sql-type="CLOB" not-null="false" />
</property>

Once we do this manual step we are good to go – we can start using the generated files to create CUBRID NHibernate applications!

For examples and tutorials related to creating such applications, please visit the CUBRID NHibernate home page.

References

Resource	Address
NHibernate Mapping Generator	nmg.codeplex.com/
CUBRID NHibernate source code	http://svn.cubrid.org/cubridapis/NHibernate
CUBRID NHibernate Wiki page	http://www.cubrid.org/wiki_apis/entry/using-cubrid-and-nhibernate

We hope you enjoyed this tutorial!

Please let us know your feedback and suggestions, so we can improve!

Thank you!

The CUBRID API team

Test Automation using Hudson and Selenium at NHN Services

2013-06-10T21:25:57-07:00

NHN, the company behind CUBRID open source database development, is automating tests for diverse browsers (Chrome, Firefox, Internet Explorer, Opera, iOS Safari and Android) that run on a variety of operating systems (Linux, Microsoft Windows, Mac OS, iOS and Android) with a set of test codes by using Hudson and Selenium WebDriver. In this article, I will briefly summarize the test automation process we use at NHN's NAVER portal and the benefits of Hudson and Selenium WebDriver for automation.

How to Automate Tests

I registered a test code to Hudson, Continuous Integration (CI) tool, and set the test code to be executed by using Selenium WebDriver and JUnit whenever source is committed in SVN. It takes about 2 seconds to test a browser. When a problem occurs, the problem is reported within 10 minutes.

Hudson is commonly used in most development departments of NHN. By clicking Build Now, users can view the test progress status. The report system provides a good environment for "Fast Fail, Fast Feedback".

Figure 1: Multi-browser Test with One Set of Test Code.

Automating Firefox Test in Linux

Install xserver package on Linux server with Hudson. Modify run level to 5 and then add the following setting to an account where CI runs in order to execute a browser in a text console.

Xvfb :1 -screen 0 1024x768x24 > /home1/irteam/log/xvfb.log &

Install the latest Firefox version under the /usr/lib64 directory and replace the symbolic link. Now you can execute automation tests by running Firefox in Hudson.

Firefox Test Automation Demo Video (Youtube)

Automating iPhone and iPad Tests in Mac OS X and Simulator

For tests, install Hudson on Mac OS X. It requires the iPhone or iPad Simulator, so you should install Xcode in advance.

iPhone Test Automation Demo Video by Using Simulator (Youtube)

Automating Internet Explorer and Opera Tests in Microsoft Windows

For more details on how to automate tests in Microsoft Windows, see http://seleniumhq.org/docs/03_webdriver.html.

Why Is Browser Test Automation with Hudson Required?

If tests for several browsers are automatically executed whenever a source code is changed, it would clearly help developers to reduce bugs and keep the source tree that can be released anytime. In addition, QA time can be significantly reduced. There are many benefits of browser tests with Hudson, in addition to quality and cost. The following are the benefits of Hudson.

Keeping a Living Document and Building up Domain Knowledge

Whenever performing a test in Hudson, a document with illustration and description can be automatically generated by using Javadoc package.htm in the test code. This document is called a "living document" which is continuously updated and used by operators, developers and QAers for a variety of purposes such as hand-off of domain knowledge and preservation of revision history.

Figure 2: Javadoc Document Created from Tests.

Visualizing Service Quality by Browser and Domain Knowledge

Anyone who clicks Build Now in Hudson can check the service quality by browser.

Figure 3: Verifying Mobile News Service in Firefox.

For example, in some cases, the news service should be provided differently by day due to the service characteristics. It is very difficult to hand off all domain information to all related staffs. For example, the KOSPI/KOSDAQ indexes are not showed on the news on weekends but after the opening of the market on Monday morning. Anyone who clicks the Build Now button can see the news service operation process by status.

Tests with Hudson help users to hand off domain knowledge and build up the information as well as enhance quality and cut costs.

Best Practices and Examples

We once needed to update the version of Spring Framework used for the mobile news service. We modified the version information in the pom.xml file of Maven and performed the unit test and the integration test for web server source, and the result was no problem. Developers opened some new web pages by running the web server and checked that all of them were fine.

However, there were more than 80 runtime errors. Fortunately, we had the multi-browser test in Hudson test, so we could fix all bugs and problems before releasing the service.

Selenium WebDriver

Why Selenium WebDriver?

We use Selenium WebDriver because of its reliable quality through a version up process for a long time, and it is easy-to-use. The test is performed by running a browser, so it is easy to perform UI test by browser.

The virtual browser test such as HtmlUnit cannot support a variety of browser versions (it is limited to Firefox 3.6 and lower and Internet Explorer 8 and lower). In addition, it does not support mobile browsers. Therefore, I recommend Selenium WebDriver over HtmlUnit, even though Selenium WebDriver requires more effort.

With Java API provided by Selenium WebDriver at the JUnit test code, you can easily produce the browser test code. Code 1 below is now used for the mobile news service test.

Code 1. News Service Test Code.

@Test(timeout = 1000 * 60)
public void 뉴스홈에_최근3일_최종편집시간이_표시된다() {
    Driver.get(driver, "http://m.news.naver.com/home.nhn");
    String expectedResult = "최종편집";
    String result = Driver.getTextByClass(driver, "last_update");
    assertThat(result.startsWith(expectedResult), is(true));
}

Benefits of Selenium WebDriver

Benefits of Selenium WebDriver are various: it allows developers to produce the test code with a variety of languages (Java, C#, Python, PHP, Ruby, Perl) and provides fast feedback by using the implicit wait function. The following are the benefits of Selenium WebDriver.

Test by Specifying ID/Class/XPath

If considering HTML maintenance, ID is the best choice to specify HTML/CSS elements, the second best is Class, and finally, XPath. Selenium WebDriver supports all three.

Multi-browser Tests with One Set of Test Code

You can test several browsers with one set of test code because you can change the test browser by replacing WebDriver only. As of 2012, WebDriver supports Firefox, Internet Explorer, Chrome, Opera, iPhone Safari, iPad Safari and Android browsers. Code 2 below is a part of code that creates WebDriver.

Code 2. Example of Creating WebDriver.

public WebDriverFactory() throws Exception {
    String browsetype = TestConfigParam.getBrowseType();

    if ("firefox".equals(browsetype)) {
        this.driver = new FirefoxDriver();
    } else if ("chrome".equals(browsetype)) {
        this.driver = new ChromeDriver();
    } else if ("ie".equals(browsetype)) {
        this.driver = new InternetExplorerDriver();
    } else if ("iphone".equals(browsetype)) {
        this.driver = new IPhoneDriver();
    } else if ("ie".equals(browsetype)) {
        this.driver = new InternetExplorerDriver();
    } else if ("android".equals(browsetype)) {
        this.driver = new AndroidDriver();
    } else if ("htmlunit".equals(browsetype)) {
        this.driver = new HtmlUnitDriver(false);
    } else {
        this.driver = new FirefoxDriver();
        driver.manage().timeouts().implicitlyWait(Driver.TIMEOUT, TimeUnit.SECONDS);
    }
}

Conclusion

So far, we have reviewed test automation applied to NAVER services. NHN has already automated tests for many services by using Hudson and Selenium WebDriver. I guess other companies have automated tests in the similar ways. Therefore, I hope this article to be a chance to communicate with others to create a Best Practice, rather than showing it for test methods.

By Hyehwan Ahn, Software Engineer at News Service Development Team, NHN Corporation.

I am a developer who is interested in automation of routine tasks in releasing Alpha/Beta/QA/Distribution phases to improve efficiency.

CUBRID ADO.NET Tutorials

2012-01-03T23:01:41-08:00

Installation Instructions

[CUBRID ADO.NET Driver Installation Guide]

CUBRID ADO.NET TestCases

[ADO.NET TestCases] - Find Out How To Use ADO.NET Driver with CUBRID

Guides and Tutorials

[A Simple Query/Retrieve Code]
[Batch Commands]
[Connection Options]
[Connection String]
[CUBRID Collections]
[CUBRID LOBs]
[CUBRID Metadata support]
[CUBRID NHibernate Support]
[CUBRID OIDs]
[DataTable Support]
[Transactions]
[Working With Parameters]
[CUBRID ADO.NET Error Codes and Messages]
Sample
- [How to using the CUBRID ADO.NET Data Provider?]
- [Connect to CUBRID Database]
- [Manage Table: A sample using CUBRID Ado.net Driver]
- [CUBRID ADO.NET Schema Provider]
- [How to add multiple rows of data using CUBRID ADO.net Driver?]
- [How to calling Java Stored Function/Procedure(C#)?]
- [How to using ENUM data type in C#?]
- [Using DataSets in CUBRID ADO.NET]
  - [Creating a DataSet]
  - [Populating a DataSet from a DataAdapter]
- [Modifying Data in CUBRID ADO.NET]
  - [Updating Data Sources with Commands]
ADO.NET MSDN Documentation

Questions and Answers

CUBRID Migration Toolkit Release Notes

2011-09-15T00:20:44-07:00

[CUBRID Migration Toolkit Release Note Summary|Release Note Summary]

CUBRID Migration Toolkit 2013.05 build 4227 (2013-06-07)

New Feature

[TOOLS-3094] - Users can re-open migration with migration history.
[TOOLS-3132] - Add "Select migration type page"

Improvement

[TOOLS-3078] - Support multi-reservation task setting
[TOOLS-3130] - Should display the step number of the migration wizard for easy to know the current position.
[TOOLS-3133] - Improve data source selection of migration wizard
[TOOLS-3134] - Improve destination selection page of the migration wizard
[TOOLS-3169] - Spec-out cms ftp loaddb function
[TOOLS-3173] - Fixed renewal CMT UI
[TOOLS-3190] - If there are error records in a committed batch, try to insert them one by one

Bug

[TOOLS-2907] - CMT editing SQL has an error when using LIMIT caluse
[TOOLS-3125] - CSV importing error
[TOOLS-3129] - Whenever it shows the confirm dialog after clicking Next button.
[TOOLS-3131] - The notice widget goes wrong when the window is maximized.
[TOOLS-3141] - The checkbox of migration history is disable.
[TOOLS-3143] - After choose a wrong xml from "Local mysql xml dump file" to any target database, it will has an error.
[TOOLS-3144] - File not found exception.
[TOOLS-3149] - Cannot migrate date,time,timestamp,datetime type.
[TOOLS-3163] - When the column name is not correct ,cannot go back to step3:Database Object Mapping.
[TOOLS-3164] - After "Cancle reservation" ,it is still enable.
[TOOLS-3165] - It will migrate un-selected view/serial.
[TOOLS-3171] - Argument cannot be null
[TOOLS-3174] - Can't find the source SQL schema
[TOOLS-3175] - Cannot choose SQL when migrate xml to CUBRID.
[TOOLS-3176] - Target column will change to Data type.
[TOOLS-3177] - "Max count" is disable.
[TOOLS-3178] - 'One table one file' option will be lost.
[TOOLS-3179] - The migration wizard page cannot show completely.
[TOOLS-3180] - Cannot use the "open migration scripts files" on the menu bar.
[TOOLS-3181] - Change separating character ,it will have an error.
[TOOLS-3183] - java.lang.NullPointerException
[TOOLS-3186] - After refresh database ,it is still show "table not in database"
[TOOLS-3187] - When not start CUBRID service ,the error message is not correct.
[TOOLS-3194] - Cannot delete migration history.
[TOOLS-3195] - The error message of Charset is not correct.
[TOOLS-3197] - Start migration failed
[TOOLS-3198] - The content of index and schema file is reverse.
[TOOLS-3199] - jxl.read.biff.BiffException: Unable to recognize OLE stream
[TOOLS-3205] - The confirm dialog will show twice.
[TOOLS-3207] - The input count is not correct.

CUBRID Migration Toolkit 2013.03 patch 2 build 4168 (2013-04-29)

Bug

[TOOLS-3000] - csv importing bug

Improvement

[TOOLS-2968] - Migration Console Tool Improvement: Only fetch the schemas in configuration

CUBRID Migration Toolkit 2013.03 patch 1 build 4167 (2013-04-19)

Improvement

[TOOLS-2951] - CHAR/VARCHAR length problem when you migrate MySQL,Oracle to CUBRID

Bug

[TOOLS-2950] - Performance problem when it export table data on CUBRID 8.2.x, 8.3.x

CUBRID Migration Toolkit 2013.03 build 4161 (2013-04-02)

1.New Feature

[TOOLS-109] - CMT supports *.sql format and *.csv format
[TOOLS-2703] - Migration step 3: support import .sql files in SQL tables management view
[TOOLS-2748] - Add data files' max record count when exporting to files

2.Improvement

[TOOLS-1174] - Improve the report information of Migration console tool
[TOOLS-2027] - Cannot create database on old version of CUBRID databases
[TOOLS-2623] - User defined SQL in table mapping view supports multi-SQL statements.
[TOOLS-2633] - Auto check target CUBRID database is running in HA mode.
[TOOLS-2637] - Auto refresh target DB after online migration
[TOOLS-2687] - Move SQL table manager view to the top mapping view.
[TOOLS-2722] - Users can choose starting migration now or setting a reservation after migration wizard finished.
[TOOLS-2872] - When migrate csv to cubrid and don't migrate the first row, please change the tartget column to same name with column name.
[TOOLS-1207] - Unclear CMT preferences

3.Bug

[TOOLS-1164] - Migrate blob data type from mysql to cubrid, some blob cannot migrate to CUBRID8.4.2.0027
[TOOLS-1940] - Cannot migrate partition table from mysql to cubrid.
[TOOLS-2412] - The CMT check the invalid table name still when I don't select the table.
[TOOLS-2442] - Migrating data from oracle to cubrid can't be success fully.
[TOOLS-2735] - Sometimes error "Column xxx in table xxx has no mapping column" will be raised in SQL table management
[TOOLS-2855] - Shoud be shown the sub menu items when the user click "New Migration" button.
[TOOLS-2863] - When migrate patition table to cubrid, it will pop error when the partition column is keyword.
[TOOLS-2864] - When copy the history of console to CMT/report directory, the record row display in red.
[TOOLS-2865] - There is no error message when multi-SQL statement is not correct.
[TOOLS-2866] - Chineses will be shown as "unrecognizable Code"
[TOOLS-2867] - Error "Column xxx in table xxx has no mapping column" will be raised in SQL table management.
[TOOLS-2868] - When migrate sql ,the charset hasn't work
[TOOLS-2869] - When click back, it will pop nullpointerexception
[TOOLS-2870] - When new script, advanced settings hasn't been saved.
[TOOLS-2871] - When migrate the csv file, the column name isn't clear
[TOOLS-2873] - When migrate from csv to CUBRID, it will pop NullPointerException
[TOOLS-2874] - The timezone cannot display all the word.
[TOOLS-2875] - After change column data type and don't choose "import first row", it will display error.
[TOOLS-2876] - After modify data type, modify "import first row", the data type has been changed again
[TOOLS-2877] - Cannot import xls and xlsx
[TOOLS-2878] - When migrate from csv to CUBRID, set other character to null, it doesn't work.
[TOOLS-2882] - Error in Import SQL tables management view.
[TOOLS-2883] - There is no error window when import wrong SQL tables.
[TOOLS-2884] - When source database have unique constraint, target database still can import repeated values.
[TOOLS-2889] - When migrate csv to cubrid, there are two same target column, the warning message isn't right.
[TOOLS-2890] - Migrate csv from CM, then migrate to CUBRID, it cannot be migrated successfully.
[TOOLS-2891] - When migrate xml to CUBRID, add sql on step3, do migration, it cannot migrate
[TOOLS-2892] - After run migrate from csv,mysql to CUBRID via console, it hasn't genarated report.
[TOOLS-2893] - After migrate from csv to CUBRID via console, the history display error.
[TOOLS-2894] - In script, it hasn't save the import sqls.
[TOOLS-2896] - When migrate from import sql to CUBRID via console, the record in history isn't right.
[TOOLS-2897] - Goto step2, choose csv, click csv setting, the defult values isn't right.
[TOOLS-2899] - Error with settings when import csv file.

CUBRID Migration Toolkit 8.4.3.201301 build 4097 (2013-02-07)

1. [New Features of CMT 8.4.3.201301|Introduce New Features]

2. New Features

[TOOLS-2037] - And add perforence settings to migration wizard
[TOOLS-2399] - CMT can't connect oracle RAC
[TOOLS-2572] - Export XLS format feature
[TOOLS-2579] - Supporting definiting column default as an expression in wizard step 3.

3. Improvement

[TOOLS-2485] - Support CLOB to Varchar migration in Oracle
[TOOLS-2591] - Auto add connection parameters to local DB list if the connection parameter is not avaliable.
[TOOLS-2601] - When select database unload in step2, check-box 'Replace Table' is out of action in step3.

4. Bug

[TOOLS-2172] - ERROR:Too few input host variables provided
[TOOLS-2435] - Existing a correct table A1 and correct view A1, the CMT show error duplicate table or view.
[TOOLS-2502] - Can't create index when do MySQL to CUBRID migration
[TOOLS-2580] - Handling Mysql "UNKNOWN" data type
[TOOLS-2598] - If changed File Repository in Step 2, the type of Schema file and index,data will changed into xls.
[TOOLS-2599] - Nonsupport objects list twice.
[TOOLS-2600] - In step3, Rename the target table name.It doesn't work.
[TOOLS-2602] - When import sql in step 3,files of type is .xls/.xlsx, it should be .sql.
[TOOLS-2603] - When copy migration script,the Enter key doesn't work.
[TOOLS-2615] - In step3, FK's icon is lost.

CUBRID Migration Toolkit 8.4.3.201212 build 4047 (2012-12-31)

Supported CUBRID version

CUBRID 8.2.2.x ~ CUBRID 8.4.3.0146

New Feature

[TOOLS-2212] - CMT task Reservation
[TOOLS-2294] - Error records can be written into some local files
[TOOLS-2295] - Import SQL scripts to Online CUBRID databases
[TOOLS-2328] - Change the order of table columns
[TOOLS-2387] - User defined SQL in the table mapping view.

Improvement

[TOOLS-2211] - Add a progress dialog before starting migration process.
[TOOLS-2229] - If user has closed CM/CQB/CMT in full screen, next time open window in full screen
[TOOLS-2236] - Improve performance during fetching meta data on CUBRID
[TOOLS-2237] - Improve performance to execute COUNT(*) sql without derived query
[TOOLS-2327] - Improve fetching data performance when cmt use online database mode of the source database
[TOOLS-2331] - rename script supporting enter key.

Bug

[TOOLS-2397] - The CMT won't load all tables and views if there is incorrect or invalid view in views of oracle database.
[TOOLS-2401] - The inputed incorrect time values "000-000 0:0", "0-000 000:0","55-66 99:99" were converted to other values and have no error message.
[TOOLS-2402] - Add the start time with crontab format unsuccessfully and have no error message.
[TOOLS-2414] - Console migration can be supported MySQL2CUBRID customized setting.
[TOOLS-2417] - The start time of crontab format should be limited.
[TOOLS-2418] - When migratio fail,decimal type data isn't exact in errorsqls
[TOOLS-2419] - When migratio fail,some decimal points is redundant
[TOOLS-2422] - Clicking editing and deleting button have no response without selecting SQL item in Step3.
[TOOLS-2423] - The adding and editing SQL label should include only "SELECT sql script".
[TOOLS-2426] - Import SQL File(s) doesn't import sql in order.
[TOOLS-2433] - CMT can't connect to CUBRID 8.3.1.2003
[TOOLS-2438] - Even I didn't select view ,it also check view in Step 3.
[TOOLS-2439] - Doesn't list the information of Database in 'Configuration History'
[TOOLS-2440] - The PARTITION table from MYSQL to CUBRID is wrong.
[TOOLS-2441] - When I open a existed migration script with including custom SQL and change source to mysql xml, the errors about SQL show and the SQL items of left list can't be delete.
[TOOLS-2451] - It shouldn't create partition tables.

CUBRID Migration Toolkit 8.4.3.201211 build 4000 (2012-11-16)

Supported CUBRID version

CUBRID 8.2.2.x ~ CUBRID 8.4.3.0146

Improvement

[TOOLS-2211] - Add a progress dialog before starting migration process
[TOOLS-2234] - CMT console support more parameters
[TOOLS-2237] - Improve performance to execute COUNT(*) sql without derived query.
[TOOLS-2236] - Improve performance during fetching meta data on CUBRID.

CUBRID Migration Toolkit 8.4.1.201211 build 3095 (2012-11-09)

Supported CUBRID version

CUBRID 8.2.2.x ~ CUBRID 8.4.1.7007

New Feature

[TOOLS-2100] - Using Excel file to import SQL tables in migration wizard
[TOOLS-2105] - Export source database into CSV/SQL files
[TOOLS-2190] - Support reuse_oid option at creating cubrid tables

Improvement

[TOOLS-2120] - Support for the target HA database
[TOOLS-2138] - When import sql, please add process bar. Or it like hasn't import.
[TOOLS-2139] - When migrate function sql, it isn't good
[TOOLS-2180] - Cannot migrate to HA master via offline.
[TOOLS-2085] - Handle target file format in different OS in Migration console

Bug

[TOOLS-1153] - After online migration, the shared become to default.
[TOOLS-2075] - CMT can't connect the server with CUBRID JDBC 9.0.0
[TOOLS-2127] - When export from mysql to csv, the datatime doesn't good.
[TOOLS-2131] - After add online database in step2, it cannot click next
[TOOLS-2133] - When change the xml to error xml, it cannot import and haven't any warning.
[TOOLS-2136] - When migrate sql to target database and choose replace, it will still pop the table exist.
[TOOLS-2137] - When import sqls from excel, some sqls will be lost
[TOOLS-2140] - After delete sqls, click sql table, it will pop error.
[TOOLS-2141] - The cancel doesn't work in preference.
[TOOLS-2143] - The function of save current tab and save all of Migration Report has problem
[TOOLS-2145] - When there are two sqls which has different sqlid and same sql, it hasn't any warning.
[TOOLS-2146] - When run CMT on linux by vnc, it will pop JDBC driver can't be null
[TOOLS-2150] - When migrate database to sql, and choose one table one file, the file is error.
[TOOLS-2153] - When migrate one database to file, then back to step1, change database, goto step2, the file name hasn't been changed.
[TOOLS-2154] - When migrate database to sql, if the column name has blank, the sql isn't right.
[TOOLS-2158] - When migrate bigint to csv, the data has been changed.
[TOOLS-2162] - When migrate float type from oracle to sql, the data isn't right.
[TOOLS-2163] - When migrate interval day to second to sql, the data isn't right.
[TOOLS-2170] - Multiset(INTEGER) migration from 8.4.1.7007 to9.0.0.0478 has error
[TOOLS-2171] - After migrate from online to offline, the script is error.
[TOOLS-2178] - When there are two index which orders are different, one will cannot be migrated.
[TOOLS-2182] - When migrate from cubrid to cubrid, change the source database, goto step2,the database display error.
[TOOLS-2185] - Error:Semantic: Cannot coerce host var to type numeric
[TOOLS-2187] - When migrate auto increment from CUBRID8.4.1.7007 to CUBRID9.0.0, the current value is error.
[TOOLS-2191] - When migrate reuseoid, it cannot migrated.
[TOOLS-2195] - Not Null lose
[TOOLS-2196] - JavaNullPointException
[TOOLS-2198] - CLONE - Multiset(INTEGER) migration from 8.4.1.7007 to9.0.0.0478 has error
[TOOLS-2200] - The data of Set type has error after migration
[TOOLS-2203] - When migrate from CUBRID8.4.0 to CUBRID8.4.1, the values are error.
[TOOLS-2206] - Windows:NullPointerException
[TOOLS-2207] - When migrate one table which has two fk, one fk will be lost
[TOOLS-2209] - When only migrate data, don't migrate schema, if the schema has error, it will pop warning too.

CUBRID Migration Toolkit 8.4.1.201209 build 3051 (2012-09-19)

Supported CUBRID version

CUBRID 8.2.2.x ~ CUBRID 8.4.1.6004

Improvement

[TOOLS-1323] - CMT UI improvements
[TOOLS-781] - There isn't warning in partition tab in step4.
[TOOLS-1324] - Support n:1 migration
[TOOLS-1927] - When click table name, please display the General tab.
[TOOLS-1934] - When there is error view, it will pop error, and cannot delete the error view
[TOOLS-1950] - Suggest put PK to table UI
[TOOLS-1951] - Suggest data, create, replace will be choosed default in step3.
[TOOLS-1958] - Now cannot migrate many sql to one table.
[TOOLS-1960] - When hasn't choose any column, click default X1, and multiplicate, it hasn't any warning.
[TOOLS-1963] - When the data type aren't same for two columns of two table, the data type is used the column of target table
[TOOLS-1964] - When don't choose migrate data, only choose create and replace. The progress isn't good
[TOOLS-1969] - When migrate to file, please set the file name to dbname_*
[TOOLS-1973] - Please add pk mark in column of source table.
[TOOLS-1975] - Now it doesn't display the column of sql statement.
[TOOLS-1997] - The error warning isn't clearly.
[TOOLS-2012] - Now change the jdbc and file path, we need change many directory.
[TOOLS-2024] - When there are warning for replace, and the warning for error length. the pop order isn't good.
[TOOLS-2025] - Console need verify absolute matching for jdbc directory.
[TOOLS-1885] - Create Window menu and add maximize and minimize actions in CUBRID Tools for Mac

Bug

[TOOLS-450] - When change the data type length, it will be error
[TOOLS-573] - After migrated, pk has been changed.
[TOOLS-1039] - The message is error when migrate one sql to the target database which has one view which name is same as the sql name.
[TOOLS-1150] - When migration partition from CUBRID to CUBRID, there are error
[TOOLS-1153] - After online migration, the shared become to default.
[TOOLS-1613] - CMT edit SQL table bugs
[TOOLS-1838] - Had folders of duplicated meaning on installed directory
[TOOLS-1929] - When choose migrate table in table UI, cannot choose pk, but can choose fk.
[TOOLS-1930] - When input error password, it can pass in offline UI
[TOOLS-1933] - When there are two table which names are same, the logs is error.
[TOOLS-1935] - After delete error view, hasn't refresh the data of source db.
[TOOLS-1936] - The fk name of oracle has been lost.
[TOOLS-1937] - When do migration without fk, it will pop nullpointer
[TOOLS-1938] - When migrate to file, and choose export to one file for table.
[TOOLS-1939] - When migration from oracle by console, haven't choose sequencese,but migrate it.
[TOOLS-1941] - Cannot migrate xml file successfully.
[TOOLS-1944] - When change table name, then click other place, some target column will be lost
[TOOLS-1945] - When migrate two tables to one table, and the two tables columns aren't same, the data cannot be migrated.
[TOOLS-1946] - When assign the target column, it will add not null attribute default.
[TOOLS-1947] - The exit button is error.
[TOOLS-1948] - Now set trim column values for one column, all the columns of database will be choosed.
[TOOLS-1949] - When migrate partition table and don't choose the column of partition, it will failed.
[TOOLS-1952] - When change sql statement, it cannot change target name.
[TOOLS-1953] - When migrate two table to one table which has pk, it will create pk twice.
[TOOLS-1954] - When migrate two partition table to one table, the partition hasn't been merged.
[TOOLS-1955] - Cannot migrate some sql statement with different columns to one table
[TOOLS-1956] - The progress of migration is error.
[TOOLS-1959] - Now the column in advanced is all tables.
[TOOLS-1961] - The PK is easy to be lost.
[TOOLS-1962] - The create tables in total UI and in table UI aren't identical.
[TOOLS-1965] - Click clear all ,hasn't deleted the choose of source table column.
[TOOLS-1966] - When click the default X1, the data type will be become to uppercase.
[TOOLS-1968] - When migrate partition table, don't create partition, it will fail.
[TOOLS-1970] - The summary of report is error.
[TOOLS-1971] - When migrate from history which only migrate sql statement, the column name will be choosed too.
[TOOLS-1972] - The db records isn't right, when migrate some tables.
[TOOLS-1974] - After migration, the index order become to error.
[TOOLS-1976] - When migrate sequence of oracle, the max value will be lost
[TOOLS-1977] - When there are two tables which names are same, it will pop fk cannot found
[TOOLS-1978] - When migrate from online to file by console bat, the setting is error.
[TOOLS-1981] - The reverse of index hasn't work
[TOOLS-1983] - When input error sql, then change to right sql, it will be pop error.
[TOOLS-1984] - The replace cannot be saved when click other tree node.
[TOOLS-1985] - When only migrate data, it will pop there isn't the table in target db.
[TOOLS-1986] - When there is colon in replaced data and be replaced data, it cannot be replaced.
[TOOLS-1987] - When click migrate data, the create pk option will be choosed.
[TOOLS-1991] - Cannot loaddb from the file by migrated.
[TOOLS-1992] - When migrate inf from cubrid8.4.1.2003 to cubrid 8.4.1.6004, it will be error.
[TOOLS-1993] - When choose create table in table UI, the partition hasn't been choosed.
[TOOLS-1995] - The percent of migration has error.
[TOOLS-1996] - The one table one file hasn't been saved in migration history
[TOOLS-1998] - After delete blank space of column, it will add one record.
[TOOLS-1999] - If the capital word of table name is number, it cannot be replaced.
[TOOLS-2000] - When migrate big database, it will not responsed.
[TOOLS-2001] - Cannot migrate from online to online
[TOOLS-2002] - When do migration for big database, some data will be lost.
[TOOLS-2003] - Nullable and unique option hasn't been worked.
[TOOLS-2005] - According some order, The UI will be error.
[TOOLS-2011] - When click create table ,hasn't choose fk, index
[TOOLS-2013] - When migrate to file and one table one file, the report isn't right.
[TOOLS-2014] - When change fk name, it will add some column.
[TOOLS-2015] - The warning cannot see which table is error.
[TOOLS-2016] - The index warning isn't good when migrate from oracle to cubrid
[TOOLS-2017] - Cannot import the blob data to varchar
[TOOLS-2018] - Now choose create table in tables UI, it hasn't choose fk.
[TOOLS-2019] - When click close in warning, the UI needn't goto next UI.
[TOOLS-2020] - Now merge table ,it will pop error.
[TOOLS-2022] - When migrate two table to one table which is in target DB, the warning isn't good.
[TOOLS-2023] - When migrate to old version than CUBRID8.4.1, we need cmt server, suggest give related warning.
[TOOLS-2026] - After change CMT directory, double click history in CMT, it will pop error.
[TOOLS-2028] - When choose fk which is on update cascade on total UI, the warning doesn't display.
[TOOLS-2031] - When use the Offline File repository, if it has already selected a database on jdbc tab, it will be fetched schema information.

CUBRID Migration Toolkit 8.4.1.201207 build 2039 (2012-08-06)

Supported CUBRID version

CUBRID 8.2.2.x ~ CUBRID 8.4.1.2039

Bug

[TOOLS-1630] - The default CUBRID broker port should be a 33000 not a 30000.
[TOOLS-1629] - If you rename a target table name on the edit sql of the migration wizard step 3, it may be caused errors when it is migrating.
[TOOLS-1628] - Can't see full sql if it has line feed character.
[TOOLS-1627] - Can't use a sql with group by clause
[TOOLS-1626] - Problem of XpressEngine's index name after migration
[TOOLS-1625] - Problem of the file separator on selected folder name
[TOOLS-1206] - CMT for Mac: Nothing happens when "Preferences" or "About CUBRID Migration Toolkit" menus are clicked.
[TOOLS-1631] - The confirmation message should be needed when you click "Run script" on the context menu of the left tree.

CUBRID Migration Toolkit 8.4.1.201205 build 2029 (2012-05-31)

Supported CUBRID version

CUBRID 8.2.2.x ~ CUBRID 8.4.1.2032

New Feature

[TOOLS-840] - CMT Console tool
[TOOLS-910] - Support BLOB to Varchar migration
[TOOLS-950] - Add total information and message area control function of migration progress monitor
[TOOLS-952] - A dialog which can make changing the length of the columns which data type are char more conveniently.

Improvement

[TOOLS-92] - CMT test should cover at leart 100G sized data migration to CUBRID
[TOOLS-98] - 인덱스 타입에 따른 결과값 리포팅
[TOOLS-510] - The button of "Default(1X)" should be grey when the tables have no char/varchar columns.
[TOOLS-841] - To improve performance, the FTP interface will not be used if the target database is localhost and offline.
[TOOLS-842] - Package the migration report files to make them easy to manage
[TOOLS-845] - Improve offline migration performance
[TOOLS-915] - Diplay index tree.
[TOOLS-1005] - Support Zip file transportation when using offline migration
[TOOLS-1037] - Cannot only migrate the sequence in cmt
[TOOLS-1062] - Migration rate isn't right after migration.
[TOOLS-1084] - Cannot migrate to new database when there isn't the db.
[TOOLS-1085] - It will display migration is finished. it hasn't display any error when there is error in migration.
[TOOLS-1111] - The lob file path isn't same which generated after offline migration and generated after online migration.

Bug

[TOOLS-224] - CMT ORACLE sequnce 에 대하여 serial 이 생성되지 않습니다 / CMT ORACLE sequnce 无法生成serial
[TOOLS-171] - Reuse the connection information in the CMT
[TOOLS-284] - From oracle to CUBRID, the FK migration is not right.
[TOOLS-438] - The form of data is inconsistent when migrating "decimal unsigned(20,10)" to "character varying(30)"
[TOOLS-511] - There is some unreadable code in log and the information can't be displayed completely because of it.
[TOOLS-535] - Do migration using XE template, goto step5, target index doesn't been added prefix.
[TOOLS-555] - Migrate blob to bit varying, the data cannot be migrated.
[TOOLS-584] - When do migration of sequence, haven't delete previous sequence.
[TOOLS-796] - In migration, it is error that has judge the sql name with the source table which hasn't been migrated.
[TOOLS-797] - When the name of sql statement is same with target db, it hasn't warning.
[TOOLS-809] - When do online migration and choose "Replace existed tables" , change the target table name to one which is existed in target db, it will pop duplication.
[TOOLS-817] - There will be connect failed sometime.
[TOOLS-828] - After change two same index name to different index name, it will need to click next again. It is not good.
[TOOLS-886] - Migrating large online mysql database may rise out of memory errors
[TOOLS-1038] - Cannot migrate the data to the table which name is same as sql name.
[TOOLS-1049] - When change sql, the column isn't right in advanced , .
[TOOLS-1050] - The data type of sql is error in advanced
[TOOLS-1051] - When only migrate sql and there are char in the sql, the default(1x) and multiplication and advanced are disable.
[TOOLS-1057] - The warning is error when the target table isn't same as migrating table
[TOOLS-1058] - Cannot run the xml which path has blank space.
[TOOLS-1074] - When migrate from blob to varchar, the chinese data change to messy code.
[TOOLS-1087] - It will pop error when migrate view which source table doesn't existed in target DB.
[TOOLS-1088] - When delete the source xml, it will pop error in migration
[TOOLS-1089] - When do migration via command, the migration history has lost
[TOOLS-1098] - It will pop error too when there delete the blank space of column
[TOOLS-1103] - Tinyint convert to numeric is error
[TOOLS-1107] - When migrate int to numeric, it will pop error.
[TOOLS-1108] - Bit is migrated to bit, it is error via offline migration
[TOOLS-1110] - There isn't data in smallint, it will become 0 after do online migration.
[TOOLS-1115] - When migrate from oracle to cubrid, the intervaldaytosecond data type is error.
[TOOLS-1116] - Migrate blob to varchar, it will pop error
[TOOLS-1117] - When change the target host, it will pop error.
[TOOLS-1158] - Cannot connect CMS when there isn't demodb in new server

CUBRID Migration Toolkit 8.4.1.201204 Hot fix build 2004 (2012-04-16)

Supported CUBRID version

CUBRID 8.2.2.x ~ CUBRID 8.4.1.2032

Improvement

[TOOLS-919] - Remove duplicated index names checking at the stage 4 of migration wizard

Bug

[TOOLS-886] - Migrating large online mysql database may rise out of memory errors

CUBRID Migration Toolkit 8.4.1.201203

Supported CUBRID version

CUBRID 8.2.2.x ~ CUBRID 8.4.1.0558

New Feature

[TOOLS-512] - Auto update support (using eclipse p2)
[TOOLS-807] - Add the update url to install new software

Improvement

[TOOLS-622] - Typo in english messages
[TOOLS-626] - Commit unit : 500 is too low for new version tools and engine. Let's find optimized value.
[TOOLS-691] - When create new JDBC connection in step 2 of migration wizard, the default database type is CUBRID and the driver is the newest version.
[TOOLS-707] - Improve the performance of FTP
[TOOLS-723] - The database type have to be selected CUBRID Database in New Database connection dialog of Migration Wizard Step 2
[TOOLS-740] - Modify name of Wizard Step two
[TOOLS-760] - Cannot migrate number partition table to CUBRID via CMT
[TOOLS-782] - Cannot support migrate sub partition from oracle to cubrid.

Bug

[TOOLS-346] - Modify cms user, the database display error
[TOOLS-360] - When the index name are same in two tables,goto step4, the index's table is error
[TOOLS-361] - When do offline migration, the directory of loaddb log is error.
[TOOLS-412] - From xml to CUBRID, bit data type convert is error.
[TOOLS-472] - Do migration view, there is different in migrate to online db and file.
[TOOLS-498] - In step2, change online db to EUC-KR, save XE. Then change the online db's charset to UTF-8. Use the XE, charset cannot be modified.
[TOOLS-500] - the data is inconsistent after migrating binary type to bit type(or varbinary type to bit varying type)
[TOOLS-501] - the data is inconsistent after migrating binary type to character type(xml migration)
[TOOLS-505] - In step5, please change dafult timezone to actual data
[TOOLS-519] - The order of columns of tables having more than one columns is wrong(it is opposite) after convering DB with offline form.
[TOOLS-543] - When there is one table has double quotation marks, cannot do migration.
[TOOLS-572] - When migrated some data type to nvarchar, please add the confirm info.
[TOOLS-599] - Migrate to windows server, it will be error
[TOOLS-602] - When there are same name in select statements, the target column name will be lost
[TOOLS-604] - In DB Records of migration report, the align of - is not same.
[TOOLS-610] - When start oracle after login CMT, connect oracle server in step1, it cannot connect.
[TOOLS-621] - Does not like to port some tables from database - keyword problem?
[TOOLS-731] - When there are two table name is same, there are two warning.
[TOOLS-741] - When migrate the partition table, it has been migrated, but there display error in migration report.
[TOOLS-745] - When migrate the table which name has "", the table can be migrated successfully, but the data has been lost
[TOOLS-749] - When connect to mysql database, cannot connect the database in upper case
[TOOLS-750] - There isn't distinguish upper case and lower case in step3.
[TOOLS-754] - Creating new database can be canceled.
[TOOLS-755] - When do offline migration to create new database via CMT, the process blocked.
[TOOLS-758] - When load the txt which are migrated from mysql to file, some object cannot be loaded.
[TOOLS-761] - Do migration from numer to varchar, it will pop warning
[TOOLS-762] - When do migration from xml to offline cubrid, It will lost partition
[TOOLS-763] - When migrate two table which have same name, click back,delete one table, the duplicate judgement still exist.
[TOOLS-767] - When there are two table name is same and one has fk, it will be pop error in migration process.
[TOOLS-770] - When add two connection in step1, one is upper case, the other is lower case,it will display one.
[TOOLS-784] - When migrate partition to CUBRID, please add " " on the partition filed
[TOOLS-785] - When the server is run in standalone mode, there will be pop user and password incorrect.
[TOOLS-786] - There doesn't display the referenced table name in step 4.
[TOOLS-788] - When there are two index in one table, change to same index name in migration,it will be error
[TOOLS-789] - When there are two table name is same and one has fk, the referenced table will be lost in step4
[TOOLS-792] - When copy one url to install other software UI, it will pop error.
[TOOLS-798] - When migrate from oracle, there is untidy of tables.
[TOOLS-800] - When migrate from XE template, the partition ddl will be lost in step4
[TOOLS-801] - Do migration from oracle, when there are two tables which name is same. The data migration is error.
[TOOLS-802] - When do migration from oracle to cubrid, it will pop error.
[TOOLS-803] - When create new database via cmt use the other user, it cannot be login with dba.
[TOOLS-806] - Check for update doesn't work
[TOOLS-812] - When do migration use XE(migrate to file), cannot migrate.
[TOOLS-816] - There will be pop error in migration, but it doesn't display every time.
[TOOLS-825] - Don't choose XE serial in XE ui, but it migrate the xe serial in migration
[TOOLS-829] - When generate XE to change file name in database unload UI. The file name isn't saved.

Task

[TOOLS-460] - Migrate partition table in mysql to database, the partition will be lost
[TOOLS-513] - The parser of MYSQL XML dump file can read the invalid XML characters correctly
[TOOLS-747] - Migrate source code from svn.platform.nhncorp.cn to dev.nave.com
[TOOLS-394] - the object for checking new version is wrong(it is for cubrid in this version, not for cubridmigration)
[TOOLS-532] - Change cubridmigration.exe icon to new icon.
[TOOLS-603] - The char ' ' in the XML dump file will be lost during migration

CUBRID Migration Toolkit 8.4.1

Supported CUBRID version

CUBRID 8.2.2.x ~ CUBRID 8.4.1.0558

Improvement

[TOOLS-95] - human readable/editable template file
[TOOLS-96] - increase performance of MySQL dump file parsing
[TOOLS-121] - support cancel migration task even which run on server side as standalone process
[TOOLS-228] - CM server improvements
[TOOLS-337] - There is error in migration, the migration progress bar isn't finished
[TOOLS-355] - Please add one summary which is like step5 to migration history
[TOOLS-358] - Goto step4, don't choose create new table and data migration for one table, goto report, the table will display error, please add some error infor
[TOOLS-490] - Add charset in file repository.

Task

[TOOLS-110] - Improve migration working engine
[TOOLS-111] - Data transform engine
[TOOLS-112] - Improve migration wizard UI
[TOOLS-569] - To support CUBRID 8.4.1 and prepare release build
[TOOLS-600] - It is needed a brandnew version string that it easily support for CUBRID compatibility.

Bug

[TOOLS-306] - In step2, click off line, database should display offline database. But there is all database.
[TOOLS-309] - After migration, the process bar isn't finished
[TOOLS-310] - Offline migration to online database, it can do migration.
[TOOLS-314] - In step2, connect one online server, then stop the server, do migration, the result is error
[TOOLS-321] - XML to cubrid, datetime data type transfer error
[TOOLS-322] - When there are two index which has same name in xml, one index will be error.
[TOOLS-324] - XE template saved can't reproduce former step(that is step 2:select target database) when using the converting form: online->file repository.
[TOOLS-341] - Migrate to file repository, the file hasn't override the target files
[TOOLS-345] - After do offline migration, the target database hasn't data.
[TOOLS-351] - Migrated FK from Mysql to CUBRID, if one table has primary key, the FK will became index
[TOOLS-353] - When multitype in tables, the view hasn't multitype.
[TOOLS-354] - Export migration report to excel. The sheet is ambiguous.
[TOOLS-356] - The progress bar is not complete when converting database.
[TOOLS-359] - the index of type "unique" can not be converted to type of "reverse unique" or "reverse index"
[TOOLS-362] - Multiplication should be decided by the charset target database.
[TOOLS-363] - Changed charset in step1, the index, PK migrated failed
[TOOLS-368] - There is no effect for step 4 when be back to step 3 from step 4 to edit the "select statement" table name.
[TOOLS-369] - There is no effect for "ok" button when selecting other charset from default.
[TOOLS-371] - In step4,choose don't create table, goto migration report, display migrate table error.
[TOOLS-377] - Bit(1) cannot migrate to target database.
[TOOLS-378] - The time form in log is inconsistent.
[TOOLS-379] - Only choose some fields to do migration, the cut is error
[TOOLS-385] - After migration, binary(255) cannot be migrated
[TOOLS-386] - After convert blob to bit, the target data is error.
[TOOLS-388] - bool and boolean convert is error
[TOOLS-389] - the index of type "unique" can not be converted to type of "reverse unique" or "reverse index"(mysql->offline db)
[TOOLS-391] - In date data type migration, it will be error
[TOOLS-392] - The form of time is 12h(I think it should be 24h) and the statement should not be ended ";".
[TOOLS-393] - the hint in the status bar of help system is wrong.
[TOOLS-397] - Migrated from online db view to file, the report and the file contents isn't consistent.
[TOOLS-400] - Migrated decimal to numeric, it will be error in migration.
[TOOLS-401] - When migrating from db to online database, stop db server. In migration
[TOOLS-404] - Enum type can't migrated to target type successfully when changing target column name
[TOOLS-405] - Longtext type can't be migrated to target type successfully when changing the target column name.
[TOOLS-406] - Migrated float , it will be error.
[TOOLS-410] - Save XE to one exist xml, it will pop failed.
[TOOLS-413] - In migration from xml to file, datatime is error.
[TOOLS-414] - Migrated from online db to cubrid, datetime convert is error.
[TOOLS-415] - In sometime, the log will be combined.
[TOOLS-419] - When migrate varbinary(65532) to bit varying, the big value cannot be migrated.
[TOOLS-420] - When migrate the data type about int error, the report error.
[TOOLS-422] - The function of "Data Migration" has no effect
[TOOLS-425] - When do xml to cubrid migration, if change the source charset, it will migrate error.
[TOOLS-428] - In report,click the canceled DB Objects, it hasn't display name.
[TOOLS-429] - The view ddl in the file migrated display is not good
[TOOLS-432] - there is an error when migrating a table of year type.
[TOOLS-437] - When multiplicated in tables, the view hasn't been multiplicated.
[TOOLS-440] - Choose the replace table in step3, haven't delete index.
[TOOLS-441] - Migrated the table which has two fk will error
[TOOLS-443] - In step4, can change view sql, but when migrate, it will be error
[TOOLS-445] - the prompt of "Save current tab to file" is not exact and should be like another prompt "Save all tabs to an excel file"
[TOOLS-448] - When choose something, it will pop nullpointerException.
[TOOLS-451] - the parameter of "NULL" about time in migration parameters of Preferences has no effect
[TOOLS-452] - the parameter of "Replace with" about time in migration parameters of Preferences has no effect
[TOOLS-453] - the parameter of "NULL" about date in migration parameters of Preferences has no effect
[TOOLS-455] - the parameter of "Replace with" about date in migration parameters of Preferences has no effect
[TOOLS-456] - the parameter of "NULL" about timestamp in migration parameters of Preferences has no effect
[TOOLS-457] - the parameter of "Replace with" about timestamp in migration parameters of Preferences has no effect
[TOOLS-459] - The default XE template cannot be used
[TOOLS-462] - the table of type converting can be edit to anything(please do some limit when editing them)
[TOOLS-463] - Migrated datetime from xml and online database, it's different.
[TOOLS-466] - Migrate xml charset is not utf8, it will be error.
[TOOLS-467] - the "0"(zero) in the data(the "0" is in the end) will be lost when converting binary to bit.
[TOOLS-469] - there is an error when two user migrate two different databases to the same target database concurrently
[TOOLS-470] - In the new version, do migration from online db to new db, many tables cannot be migrated
[TOOLS-471] - the negative number and zero will be converted to "0" and positive number will be converted to "1" when converting bool type to smallint type.
[TOOLS-473] - the data is inconsistent when migrating date type to date type
[TOOLS-474] - Migrate xml to online cubrid, bit data is error
[TOOLS-475] - Migrate bit(1) from xml to online database, it doesn't work
[TOOLS-476] - Migrate numeric to numeric,some data hasn't been migrated
[TOOLS-477] - Do migration from loaddb, the blob content directory cannot found.
[TOOLS-478] - the data is inconsistent when migrating datetime type to datetime type
[TOOLS-479] - Migrated from xml to new DB and from mysql DB to new DB,the data of bool data type isn't same.
[TOOLS-480] - the data is inconsistent when migrating double type to double type
[TOOLS-481] - the window of "preferences" can not be closed when you click "close" icon first time under certain conditions.
[TOOLS-482] - Migrated from xml to offline db, timezone from default to default, timestamp is error
[TOOLS-483] - the data is inconsistent when migrating double unsigned type to double unsigned type
[TOOLS-484] - Migrate xml to online cubrid, datetime,time,timestamp data is error
[TOOLS-485] - the data is inconsistent when migrating float type to double type
[TOOLS-486] - the data is inconsistent when migrating float unsigned type to double type
[TOOLS-487] - the migration of converting longblob type to blob type is failed
[TOOLS-489] - the data is not what we expects it to be when migrating numeric(20,10) type to numeric(20,8) type
[TOOLS-491] - In step2, choose timezone in file repository. Save XE,
[TOOLS-493] - Choose all in step3, save XE, the sequences cannot been saved
[TOOLS-494] - the data is inconsistent when migrating year type to character type
[TOOLS-496] - By some way, XE cannot be used.
[TOOLS-503] - Use XE which is export mysql DB to online DB, delete online DB, it will pop "Failed to connect database server"
[TOOLS-504] - Migrate online to file ,it will pop java.lang.NullPointerException
[TOOLS-506] - When delete migration history, please give confirm info.
[TOOLS-507] - Use XE, "add prefix to index names" doesn't work
[TOOLS-508] - After some operation, it will pop NullPointerException
[TOOLS-509] - the parameter of "Replace with" about time in migration parameters of Preferences has wrong effect
[TOOLS-515] - There is some error about display in ubuntu 64 bit or windows
[TOOLS-517] - There is an error after migrating a big xml(but having no error after migrating the same xml)
[TOOLS-523] - The index name of target DB is not the same with the name in the field of "Target Index Name"
[TOOLS-524] - The function of "Replace Existed Tables" has some errors when replacing table which have FKs(you must notice the order of deleting these tables)
[TOOLS-527] - After extract the new version, login cmt, in the copyright of CUBRID Migration Toolkit, there are Chinese word.
[TOOLS-529] - Migrate blob data type to file, it record the absolute path
[TOOLS-533] - Migrate big xml (test.xml) to file, will have some index will be canceled.
[TOOLS-534] - When do migration from big xml to offline, sometimes pop "listen:Address already in use <end> "
[TOOLS-539] - Migrate bfile data type, the default glo is not defined
[TOOLS-540] - When get data from source database, the waring word in Chinese is error
[TOOLS-541] - When there are composite primary key, it will be error.
[TOOLS-542] - Migrated from oracle to cubrid, there is clob data type, it cannot migrated.
[TOOLS-544] - Migrate from oracle to cubrid, the migration from timestamp withe local time zone and time stamp with time zone to datetime is error
[TOOLS-545] - Migrated from bfile to blob, it hasn't been migrated
[TOOLS-546] - Migrate from blob to blob,clob to clob, nclob to nclob the data hasn't been migrated
[TOOLS-548] - The data of the two type "INTERVAL YEAR TO MONTH" and "INT,INTERVAL DAY TO SECOND" will be converted to "NULL" when using the converting form Oracle DB->online
[TOOLS-549] - The record of long type cannot be converted(oracle db->online)
[TOOLS-550] - Migrate from date date type to date, it will lost time.
[TOOLS-551] - Migrated date 0000-0-0 to date, it became 4713-01-01
[TOOLS-553] - Migrate from urowid to varchar, the value is error
[TOOLS-554] - Migrate long raw to bit varying(1073741823), it isn't same as raw to bit varying
[TOOLS-556] - Migrate int to int, some data cannot be migrated.
[TOOLS-558] - The record of number type cannot be converted(oracle db->online)
[TOOLS-561] - The data migration from decimal, number to number is different in migration from oracle and mysql
[TOOLS-563] - Migrate from interval_day_to_second to varchar, the data is not good
[TOOLS-564] - Migrate interval to Varchar, the data type is constant , but it times 3.
[TOOLS-565] - Migrate from real to float, the data cannot be migrated
[TOOLS-566] - Migrate int to numeric(38,0), the data cannot be migrated.
[TOOLS-568] - Migrate from date to datetime, the data is error
[TOOLS-577] - In migration, there is pk and unique index, the unique constraint will be lost.
[TOOLS-578] - Migrate FK on delete no action from oracle to cubrid, the action change from no action to restrict.
[TOOLS-581] - Normal index cannot be migrated from oracle to cubrid.
[TOOLS-583] - When there are procedure, trigger, function in oracle db, migrate from oracle to cubrid, the nonsupport objects is error
[TOOLS-585] - SQL statement hasn't multiply.
[TOOLS-586] - There is a help mark(?) in the interface of "Preferences"
[TOOLS-587] - There is an extra word in the sentence "To File Repository Commit Count"
[TOOLS-589] - Migrate date data type to offline db, datetime changed too.
[TOOLS-590] - Oracle has change timezone to GMT+04:00, but in step5 in migration, it display GMT+08:00
[TOOLS-591] - When do big xml migration, there are wait long time sometimes.
[TOOLS-592] - There is a wrong word in "Preferences"
[TOOLS-595] - In xe, the index hasn't be saved.
[TOOLS-597] - The primary key can not be created when migrating mysql db to offline db..
[TOOLS-598] - When do migration use XE, the sequence will be error

CUBRID Migration Toolkit 1.5.5

Bug

[TOOLS-165] - Display referential ations on "FK" and apply that option a user chooses to tables by asking "you want to apply the option to all tables?"
[TOOLS-212] - Migrate partition table to CUBRID8.4.0 successfully. But the table is migrated to CUBRID8.4.1 is error.
[TOOLS-229] - Use XE to do migration, go to step5 , then back to step1, omit XE, goto step3, only display the table which in XE
[TOOLS-255] - The csql error is occurred when click the Check Owner with no-inputted User name and Password form on the migration wizard step 4
[TOOLS-267] - When using "Load Migration Script" menu, target table name is always empty in the SQL tab in the step 5.
[TOOLS-268] - In step4, after choose "Skip Check of the exist database name and the owner name", then choose Create new database, the warning is error
[TOOLS-273] - After migrate the source database to txt file, the import record count of migration statistic report display exported
[TOOLS-274] - Migrate decimal data type to CUBRID, the target data type is error
[TOOLS-282] - From mysql to CUBRID, the FK migration is not right.
[TOOLS-286] - Migrated FK from Mysql to CUBRID, if one table has primary key, the FK will became index
[TOOLS-291] - When we choose the XE, click next. It cannot goto step 2
[TOOLS-292] - The same xml migrated to old version and new version, the result is not same.
[TOOLS-293] - Use XE, do migration, goto step 6, the UI is error. The result of step 7 is error too.
[TOOLS-296] - It occur a error sometimes when using customized XE template because it didn't create new database.
[TOOLS-297] - After add the attention of alert of the no logging option using, has error.
[TOOLS-298] - In some times, the import record count will display error
[TOOLS-299] - Use XE, migrated xml, if the xml has fk, the fk become to index, and the index hasn't been choosed.

Improvement

[TOOLS-166] - In the wizard 1, it should nitoce the user that CMT server should be installed in the CUBRID server
[TOOLS-253] - A default values of a database volumn auto extends option is not same of CMT and CM (CMT와 CM 에서의 데이터베이스 생성시의 Default화면이 다릅니다)
[TOOLS-264] - Improve a multibyte charset supports.
[TOOLS-265] - Users difficult to know whether change to resize when a database has multi-bytes character set.
[TOOLS-266] - For users convenience, some of the menu needs to be put on the toolbar.
[TOOLS-295] - Need to show a alert dialog when using a --no-logging option in the migration step 6.
[TOOLS-288] - Include a recent driver of CUBRID 8.4.0 in CMT 1.5.5

New Feature

[TOOLS-262] - Can create the loaddb type data files without a database import
[TOOLS-263] - Add to select a table method with a file of a table name list in wizard step 3

CUBRID Migration Toolkit 1.5.4

Bug

[TOOLS-143] - In migration history, cannot choose any record, click delete button. It will prompt "Are you sure to delete the migration history"
[TOOLS-144] - When new database connection, the JDBC driver hasn't display order by version desc
[TOOLS-145] - In step1, when choose use default XE, click next. It will pop a process windows, but the cancel button is disable.
[TOOLS-148] - Input a not available remote migration server ip , It can go next from step 1 to step 2 when you use an available IP to test connection before
[TOOLS-163] - When loading table schem with default values, it quotes the values of some (randomly)
[TOOLS-164] - CMT automatically increases the size to2X or 3X depending on CHARSET to handle the multi-byte characters.
[TOOLS-167] - In migration, if import data is less than export, there isn't warning.
[TOOLS-169] - CMT returns no error when checking the option "creating a new database" on the wizard 4 in the localhost without installing cubrid server
[TOOLS-170] - When SELECT statement are entered to extract part of records only from the source DB, CMT doesn't work well.
[TOOLS-189] - JDBC 드라이버 오류로 인한 오라클 삭제된 테이블 조회되는 오류
[TOOLS-190] - In step1, input error ip, it will pop null
[TOOLS-196] - Slowly sub-query issue while checking SQLs syntax
[TOOLS-210] - When SELECT statement are entered to extract part of records only from the source DB, CMT doesn't work well.
[TOOLS-216] - In migration report wizard,the load a xml file time error
[TOOLS-222] - change the checkbox(change all the solumn size of char .....)in the migration wizard step 2,the step 5 page's content don't update.
[TOOLS-223] - Do migration by XE template, migrate xml file, it will pop error sometimes.
[TOOLS-226] - In windows64, there is a charset of cp1252 in step 4
[TOOLS-227] - Use XE to create XE, found the table will be lost

Improvement

[TOOLS-24] - CMT 용어 개선 및 설명
[TOOLS-102] - CMT supports Mac OS

New Feature

[TOOLS-23] - CMT 인댁스 수 Before/after 비교하기

CUBRID Migration Toolkit 1.5.3

Improvements and bug fixes

[TOOLS-76] - CMT report improved
[TOOLS-96] - There is a big improvement of parsing MySQL dump file .
[TOOLS-97] - If data source is xml file, the condition input cell will be read-only.

CUBRID Migration Toolkit 1.5.0

CUBRID Migration Toolkit 1.5.0 Release Note_en.pdf

New Features of CMT 2013.05

2013-06-04T22:31:42-07:00

1. Redesigned migration wizard: added a selecting migration type page

SQL importing wizard and CSV importing wizard were integrated into migration wizard.

A new page was added to the start of migration wizard and users should select the migration type on this page firstly.

2. Mutil-reservation supported.

Now, CMT supports users to regist several reservation tasks, but only one migration task can be executed at same time.

You can make a reservation by One time only, Repeat Every Day or Advanced(If you familiar with unix/linux crontab). However, you should beaware of overlapping another schedules.

The second way to reserve is clicking "Reservation" button.

You can see the execution history or cancel this reservation.

3. Open migration wizard with failed schemas and data by a migration history

Now, there is able to migrate with failed tables and data by "Restart migration" funtion.

If there are some table were not migrated successfully in the migration history, a dialog will be popped to ask users how to re-open the migration wizard.

The first option means: Reserving all the history’s migration settings when opening migration wizard with current history.

The second option means: In the object mapping step, selecting schemas and all data of the tables which were not migrated successfully.

The second option means: In the object mapping step, only selecting all data of the tables which were not migrated successfully.

4. Users can name a JDBC connection.

In the JDBC connection management, users can specify a name to a JDBC connection for easy to remember them.

And the name can't be duplicated.

New Features of CMT 2013.05_kr

2013-06-06T18:58:13-07:00

1. 마이그레이션 마법사 UI 개선

2. 다중 예약 지원

예약방법은 두 가지 방법으로 할 수 있는데, 마이그레이션 마법사 5단계에서 "시작하기"를 누르면 나오는 "예약하기" 버튼으로 예약할 수 있습니다.

두번째 방법은 이미 생성된 스크립트를 선택하고 "스크립트 예약" 버튼을 누르면 위의 화면처럼 예약하는 창이 출력됩니다.

스크립트 선택후 마우스 오른쪽 버튼으로 예약된 스크립트 실행 이력을 보거나 예약 취소를 할 수 있습니다.

3. 실패한 테이블만 다시 마이그레이션

4. JDBC 연결 정보에 설정 추가

Where can I find a list of DB Optimisations that are there in CUBRID

2013-06-07T15:37:55-07:00

Hi,

I am working to create a custom version of CUBRID Database.

As part of this, I would like to work on and improve CUBRID by applying DB optimisation logic and code to CUBRID's code. I am well versed in most such (commonly used) optimisations that are part of MySQL. I am referring to not only SQL code optimisation - I am also referring to algorithms/strategies used by CUBRID DB server itself to improve performance/reduce CPU/RAM usage etc.

What I wish to know is this - where can I find such a detailed list of optimisations that are already there in CUBRID--> so that then I can check off one by one those optimisations that I wish to apply (on CUBRID) and finally be left with only those optimisations that are not already there in CUBRID?

This would be far more easy than going through CUBRID's source and finding/searching for such optimisations/algorithms that are implemented in CUBRID.

Yours sincerely,

Arvind.

Embrace SQL with CUBRID and jOOQ

2013-06-09T23:55:25-07:00

This is a guest post by Lukas Eder, the creator of jOOQ open source Java API for typesafe SQL modeling. If you develop or use an open source application and would like to tell the world about it, CUBRID open source database project is accepting guest posts.

Big Data, the Web and SQL

In recent years, software companies have started to raise millions up to billions of dollars getting acquired by a big player, such as Google, Facebook, Yahoo! or Microsoft. Very often, the assumed value of such deals lay in the fact that Big Data could be purchased along with such acquisitions. "Social" Big Data was generated by millions of users over the web. It seemed too big to fit in classic relational databases, which is why the purchases also included buying the proprietary, rather short-lived technologies used to maintain Big Data. Most of the new companies thus experimented with NoSQL in one form or another.

SQL, on the other hand, has come a long way. SQL is a very expressive and powerful language used to model queries against any type of data, albeit mostly relational. At the same time, SQL is standardised and quite open. CUBRID is a good example of an object-relational database, which combines the expressiveness of SQL with high availability, sharding, and many other features needed to manage Big Data! In other words, CUBRID is the proof that SQL can be an adequate technology for the modern web.

Querying CUBRID with jOOQ

jOOQ is a Java API modelling SQL as an internal domain-specific language directly in Java. It features a built-in code generator to generate Java classes from your database model. These generated classes can then be used to create typesafe SQL queries directly in Java. A simple example of how this works with CUBRID can be seen in this jOOQ CUBRID tutorial.

The idea of creating fluent APIs in Java is not new. Usually, Martin Fowler takes most credits for his elaborations on the subject. After that, many approaches towards building internal domain-specific languages have surfaced, mostly in unit testing environments (e.g. JMock and Mockito). Apart from jOOQ, there are also a couple of fluent APIs that model SQL as a language in Java. These include:

Among the above, QueryDSL is the only other API with a comparable traction to jOOQ's. While QueryDSL hides the full SQL expressiveness behind a LINQesque API, jOOQ strongly focuses on SQL only. Unlike any of the above SQL abstraction APIs, jOOQ combines these features:

A BNF defines jOOQ's fluent API

jOOQ uses next generation techniques to implement its fluent API. These techniques involve a formal BNF notation specifying API type and method hierarchies:

With a formal BNF, jOOQ's fluent API is much more robust and typesafe, as it will dictate syntax correctness in a more formal way than ordinary builder APIs.

jOOQ embraces usage of stored procedures

When closely coupling with your favourite relational database, you will likely want to make use of stored procedures and functions, directly in your SQL. jOOQ embraces this fact and allows for typesafe embedding of stored functions.

jOOQ embraces usage of row value expressions

Row value expressions (also called tuples, records) are at the heart of SQL. Few libraries outside of the SQL world will be able to model the fact that the following predicates are type-safe:

SELECT * FROM t1 WHERE t1.a = (SELECT t2.a FROM t2)
-- Types must match:   ^^^^           ^^^^

SELECT * FROM t1 WHERE (t1.a, t1.b) IN (SELECT t2.a, t2.b FROM t2)
-- Types must match:   ^^^^^^^^^^^^            ^^^^^^^^^^

SELECT t1.a, t1.b FROM t1 UNION SELECT t2.a, t2.b FROM t2
--     ^^^^^^^^^^ Types must match     ^^^^^^^^^^

jOOQ will leverage the Java compiler to help you check the above:

select().from(t1).where(t1.a.eq(select(t2.a).from(t2));
// Type-check here: -----------------> ^^^^

select().from(t1).where(row(t1.a, t1.b).in(select(t2.a, t2.b).from(t2)));
// Type-check here: ----------------------------> ^^^^^^^^^^

select(t1.a, t1.b).from(t1).union(select(t2.a, t2.b).from(t2));
// Type-check here: -------------------> ^^^^^^^^^^

jOOQ emulates built-in functions and SQL clauses

Providing support for simple SQL clauses is easy: SELECT, DISTINCT, FROM, JOIN, GROUP BY, etc. Implementing "real" SQL is much harder, though. Take the above row value expressions, for instance. They are currently not supported in CUBRID, but you can use them nonetheless with jOOQ. jOOQ emulates missing functions and SQL clauses for you as can be seen in this syndicated blog post.

jOOQ renders specialised SQL for 14 major RDBMS vendors

Instead of generalising and abstracting advanced standard and vendor-specific SQL features, such as JPA and tools built upon JPA, jOOQ sees good things in each vendor-specific syntax element. You know your database well, so you want to leverage it, not abstract it.

jOOQ is a platform

jOOQ is much more than just a SQL library. For example, it features the very useful jOOQ Console, which helps you debug and profile your jOOQ-generated SQL statements in any environment, without the need for expensive third-party tools:

The jOOQ Console also includes on-the-fly SQL editing tools as well as breakpoint capability for advanced debugging.

More feature comparisons

More feature comparisons can be found here, in this blog post.

Getting productive with jOOQ

jOOQ is a vision where SQL matters again to the Java developer. While some have called ORM to be the Vietnam of Computer Science, jOOQ is the Peace Treaty Between SQL and Java. Using the above and many more features, you can be productive again when writing high-performing, specialised SQL against your favourite database directly in Java, typesafely compiled by your Java compiler.

By Lukas Eder, the creator of jOOQ. Follow him on Twitter @JavaOOQ.

I'm a Java and SQL enthusiast developer currently contracting for Adobe Systems in Basel, Switzerland. Originating from the E-Banking field, I have a strong Oracle SQL background. I'm the creator of jOOQ, a comprehensive SQL library for Java.

ApiAxle - open source API management and analytics proxy

2013-06-09T20:43:54-07:00

This is a guest post by Phil Jackson, the creator of ApiAxle open source API management and analytics solution. If you develop or use an open source application and would like to tell the world about it, CUBRID open source database project is accepting guest posts.

ApiAxle is an API management solution which is open source and free. The basic premise is that you build your API, put ApiAxle in front of it and it will handle user authentication, rate limiting, statistics, etc. I represent a business which generates a revenue through support and consultancy, but first and foremost I am a developer who loves APIs and the idea of companies exposing their data to enable people to build some brilliant things. As a company we are enjoying building a great product and watching it gain traction amongst fellow hackers.

The API problem

We noticed a space in the market for an open source, on-premise proxy which did not cost the earth and did not involve sending your data over multiple, high-latency hops out into the cloud.

Where a developer these days can type apt-get install nginx to get a solid webserver, there was not really an equivalent for an API management system. Building out the features we provide can be a time-consuming, monotonous and error-prone process that we really hope people do not keep having to perform.

The solution

That is where we come in. We want to bury our head in security documentation and RFCs so that you can concentrate on making a great API. With a few simple commands you can be up and running within 20 minutes. Within 30 you can be on-boarding customers, authenticating them and getting detailed statistics about their usage. You will also get caching, rate limiting, HTTPS support and a highly configurable logging system.

How it works

There are three components in ApiAxle:

The REPL

You probably want this first. The repl allows you to configure ApiAxle from the command line. Setting up an API and API keys ready for the proxy to work with is easy. It fires up an instance of ApiAxle’s own HTTP API in the background and uses that to modify aspects of the system. Anything you can do in the REPL you can do programmatically with the API too.

Install:

$ sudo npm install apiaxle-repl

Start:

$ apiaxle

Configure an API and a new key to use the API with:

axle> key "05050c14643dc" create
axle> api "acme" create endPoint="localhost:81"
axle> api "acme" linkkey "05050c14643dc"

The Proxy

The kernel of the system. This goes between the Internet and your API and does the authentication, throttling, caching and statistics collection. It’is fast, secure and easy to setup. You will need either the REPL or the API to configure it first.

It does not matter what your API actually outputs - ApiAxle never modifies the body of a response. With regards to errors (e.g. user over quota) you can tell ApiAxle what format they should be in. We support XML or JSON. If you have Node.js installed, installation is as simple as:

$ sudo npm install apiaxle-proxy

Then start the proxy with:

$ apiaxle-proxy

The API

Bear with me, this gets a bit meta. This is ApiAxle’s own HTTP API which gives you full control over your APIs and the API keys and keyrings used to access them. You can view statistics about individual APIs and API keys from week long granularities right down to near-real-time hits at a single second granularity.

Install:

$ sudo npm install apiaxle-api

Start:

$ apiaxle-api

Find out which APIs you have configured:

$ curl "localhost:3000/v1/apis"

Where we are headed to

We have lots planned, to summarise:

Client drivers for the API. Demand is high for PHP and Ruby so we will get them done ASAP.
Now that OAuth2 has been ratified we will be working on getting that in as an authentication method.
We are working on a dashboard which will give you a way to manage your APIs, keys, keyrings and give you a way to view real-time and historical statistics - this will be a paid-for service.
We will be pushing out a user registration system soon so that you can on-board and bill customers without any manual intervention.

So the future is exciting. We are really looking forward to meeting more developers that are interested in APIs and the huge ecosystem that is formed around them. Please feel free to get in touch with any questions or just to say hi!

By Phil Jackson, the creator of ApiAxle. Follow him on Twitter @philjackson.

After receiving his computing degree from Teesside University, Phil became a software engineer. As he moved through industry, he found himself becoming increasingly fascinated with APIs and, after helping the BBC write their iPlayer API, founded Qwerly, a company that aggregated social profile information and offered it to companies for insight/marketing purposes. After selling Qwerly to a competitor, taking some time off, Phil wrote the code which would eventually make up ApiAxle. Now he's running ApiAxle full-time and hopes it will become the ubiquitous, open source tool for managing APIs.

LIKE 조건식

2012-05-22T03:33:39-07:00

LIKE 조건식

설명

LIKE 조건식은 문자열 데이터 간의 패턴을 비교하는 연산을 수행하여, 검색어와 일치하는 패턴의 문자열이 검색되면 TRUE를 반환한다. 패턴 비교 대상이 되는 도메인은 CHAR, VARCHAR, STRING이며, NCHAR 또는 BIT 타입에 대해서는 LIKE 검색을 수행할 수 없다. LIKE 키워드 앞에 NOT이 있으면 LIKE 연산의 결과에 NOT 연산을 수행하여 결과를 반환한다.

LIKE 연산자 오른쪽에 오는 검색어에는 임의의 문자 또는 문자열에 대응되는 와일드 카드(wild card) 문자열을 포함할 수 있으며, %(percent)와 _(underscore)를 사용할 수 있다. %는 길이가 0 이상인 임의의 문자열에 대응되며, _는 1개의 문자에 대응된다. 또한, 이스케이프 문자(escape character)는 와일드 카드 문자 자체에 대한 검색을 수행할 때 사용되는 문자로서, 사용자에 의해 길이가 1인 다른 문자(NULL, 알파벳 또는 숫자)로 지정될 수 있다. 와일드 카드 문자 또는 이스케이프 문자를 포함하는 문자열을 검색어로 사용하는 예제는 아래를 참고한다.

구문

expression [ NOT ] LIKE expression [ ESCAPE char]

expression (left) : 문자열 데이터 타입 컬럼이 지정된다. 패턴 비교는 컬럼 값의 첫 번째 문자부터 시작되며, 대소문자를 구분한다.
expression (right) : 검색어를 입력하며, 길이가 0 이상인 문자열이 된다. 이때, 검색어 패턴에는 와일드 카드 문자(% 또는 _)가 포함될 수 있다. 문자열의 길이는 0 이상이다.
ESCAPE char : char에 올 수 있는 문자는 NULL, 알파벳, 숫자이다. 만약 검색어의 문자열 패턴이 "_" 또는 "%" 자체를 포함하는 경우 이스케이프 문자가 반드시 지정되어야 한다. 예를 들어, 이스케이프 문자를 백슬래시(\)로 지정한 후 '10%'인 문자열을 검색하고자 한다면, expression (right)에 '10\%'을 지정해야 한다. 또한, 'C:\'인 문자열을 검색하고자 한다면, expression (right)에 'C:\\ '을 지정하면 된다.

참고 사항

LIKE 조건식은 대소문자를 구분한다. 대소문자를 구분하지 않게 하려면 RLIKE 조건식을 이용한다.

UTF-8과 같은 멀티바이트 문자 세트 환경에서 입력된 데이터에 대해서는 LIKE 검색 결과가 정상적이지 않을 수 있다. 이는 문자 세트에 따라 문자열 비교 연산을 수행하는 바이트 단위가 다르기 때문이며, 1바이트 단위로 문자열 비교를 수행하도록 하는 파라미터(single_byte_compare=yes)를 cubrid.conf 파일에 추가한 후 DB를 재가동하면 정상적인 검색 결과를 얻을 수 있다.

CUBRID가 지원하는 문자 세트에 관한 상세한 설명은 문자열 데이터 타입을 참고하며, single_byte_compare 파라미터에 관한 상세한 설명은 기타 파라미터를 참고한다.

LIKE 조건식의 이스케이프 문자 인식은 cubrid.conf 파일의 no_backslash_escapes 파라미터와 require_like_escape_character 파라미터의 설정에 따라 달라진다. 이에 대한 상세한 설명은 구문/타입 관련 파라미터를 참고한다.

예제

--selection rows where name contains lower case 's', not upper case

SELECT * FROM condition_tbl WHERE name LIKE '%s%';

id name dept_name salary

======================================================================

3 'Jones ' 'sales' 5400000

--selection rows where second letter is 'O' or 'o'

SELECT * FROM condition_tbl WHERE UPPER(name) LIKE '_O%';

id name dept_name salary

======================================================================

2 'Moy ' 'sales' 3000000

3 'Jones ' 'sales' 5400000

--selection rows where name is 3 characters

SELECT * FROM condition_tbl WHERE name LIKE '___';

id name dept_name salary

======================================================================

1 'Kim ' 'devel' 4000000

2 'Moy ' 'sales' 3000000

5 'Kim ' 'account' 3800000

Resource	Address
CUBRID ADO.NET Driver Wiki Page	http://www.cubrid.org/wiki_apis/entry/cubrid-ado-net-driver
CUBRID ADO.NET Driver download from cubrid.org	http://www.cubrid.org/?mid=downloads&item=ado_dot_net_driver&os=windows&cubrid=9.1.0
CUBRID NHibernate source code	http://svn.cubrid.org/cubridapis/NHibernate
CUBRID NHibernate Wiki page	http://www.cubrid.org/wiki_apis/entry/cubrid-nhibernate-support

CUBRID - Open Source Database Management System Optimized for Web

Using CUBRID and NHibernate

An introduction web tutorial

Prerequisites

Required software/setup:

Setting up the project

Configuring NHibernate

The Persistent Class

The Mapping

The code

SELECT

INSERT

UPDATE

DELETE

See also…

CMS Online Manual

How to build and install CMS

Known Issue

CUBRID_CHARSET and CUBRID_MSG_CHARSET

CUBRID Node.js Driver

CUBRID Node.js Driver Release Notes

Stable Release

Stable Release

Stable Release

Stable Release

Stable Release

Milestone 4: Stable Release

Milestone 3: Beta Release

Milestone 2

Milestone 1

CUBRID Manager Server

sql_log 관련

CUBRID Web Manager Release Notes

CUBRID Web Manager 9.1.0 Build 0001 (2013-04-24)

Supported CUBRID version

Sub-task

Bug

Improvement

Task

CUBRID Web Manager 8.4.3 Build 0009 and 9.0.0 Build 0004 (2012-12-17)

Supported CUBRID version

Bug

Improvement

New Feature

CUBRID Web Manager 8.4.1 Build 0006 and 9.0.0 Build 0003 (2012-10-31)

Supported CUBRID version

Improvement

New Feature

CUBRID Web Manager 9.0.0 Build 0001 (2012-09-28)

Supported CUBRID version

Bug

Improvement

New Feature

CUBRID Web Manager 8.4.1 Build 0004 (2012-08-29)

Supported CUBRID version

Bug

Improvement

New Feature

Task

CUBRID Web Manager 8.4.1 Build 0003 (2012-07-31)

Supported CUBRID version

New features

Known Bugs

CMT Release Note Summary_kr

2013년 5월 릴리스

1. 릴리스 버전 : CMT-2013.05

2. 다운로드

3. 주요 개선 사항

마이그레이션 마법사 UI 개선

다중 예약 지원

실패한 테이블만 다시 마이그레이션

JDBC 연결 정보에 설정 추가

2013년 3월 릴리스

1. 릴리스 버전 : CMT-2013.03

2. 다운로드

3. 주요 개선 사항

마이그레이션 마법사 추가 - SQL, CSV 파일 입력

1.1 SQL 파일 입력

1.2 CSV 파일 입력

콘솔 마이그레이션 결과 리포트 개선