설명
이 페키지는 mSQL에 포함되어 있는 C API에 가능한 비슷하게 설계되었다. mSQL에 포함되어 있는 설명서는 사용자에게 필요한 대부분의 것들을 설명하고 있다. 또한 많은 사람들의 요구 때문에, 이 버전의 msqlperl에서는 StudlyCaps를 사용한다.
내부적으로
Msql2와
Msql2::Statement의 두개의 크래스를 처리할 수 있지만 두번째 형식이 사용되는 것은 결코 볼수 없을 것이다. 왜냐하면 이것은 query나 listfield 문장에의해 리턴되는 스테이트먼트 핸들을 통해 이루어지때문이다. 확실히 사용해야할 유일한 크래스는 Msql2이다. 이 크래스는 다음과 같은 세가지 형태의 데이타베이스 접속 명령을 제공한다.
$dbh = Msql2->connect; # dB 서버와 웹 서버가 같은 호스트에 있는 경우
$dbh = Msql2->connect($host); # dB 서버와 웹 서버가 다른 호스트에 있는 경우
$dbh = Msql2->connect($host, $database); # 위와 동일하며, 접속시 데이타 베이스를 선택
이 명령을 이용해서 사용자는 원하는 호스트나 데이타 베이스에 접속할 수 있다. 첫번째 매개변수를 지정하지 않거나 널 문자열을 지정하는 경우, msqlperl은 UNIX 소켓(일반적으로 /dev/msql)을 통해 접속하며, TCP를 통해 접속하는 것보다 성능면에서 훨씬 우수하다. 두번째 매개변수로서 데이타베이스의 이름을 줄 수있으며, 이 매개변수로 접속 후 특정 데이타베이스를 선택할 수 있다.
리턴 값은 접속에 성공한 경우, 데이타베이스 핸들이며, 그렇지 못한 경우에는 데이타 베이스 핸들은 정의되지 않는다.
나중에 데이타 베이스에 접근하기위해서는 이 데이타베이스 핸들을 사용해야 한다.
$dbh->selectdb($database); # dB 선택. 반드시 connect 명령으로 dB 엔진에 먼저
# 접속해야 함
만약
connect 명령을 사용할때 데이타베이스를 선택하지않았거나 이전에
connect 명령으로 얻은 데이타베이스 핸들을 사용해서 다른 데이타베이스를 접속하려면 selectdb를 사용한다.
$sth = $dbh->listfields($table); # 표의 스키마에대한 핸들을 리턴
$sth = $dbh->query($sql_statement); # 질의 결과에대한 핸들을 리턴
이들 두 명령은 mSQL 설명서에서 설명하고 있는 것과 유사하게 동작한다. 이들은 msql 서버가 사용자에게 전달하는 것이 무엇인지 알 수있도록 하는 스테이트먼트 핸들을 리턴한다. 오류가 발생한 경우, 스테이트먼트 핸들은 정의되지 않는다. listfields에의해 리턴된 값으로는 테이블의 크기를 알수는 없다. 따라서 이 스테이트먼트 핸들에대한 numrow()는 "N/A"라는 문자열을 리턴하게 된다.
@arr = $dbh->listdbs(); # dB의 목록을 배열로 리턴. 반드시 connect 명령을
# 먼저 실행해야 한다.
@arr = $dbh->listtables; # dB에 등록된 테이블의 목록을 리턴.
# 반드시 connect 명령과 selectdb 명령을 먼저 수행해야 한다.
위의 두 명령은 dB 엔진에 등록된 데이타베이스의 목록과 데이타베이스에 등록된 테이블의 목록을 배열로 리턴한다.
@arr = $sth->fetchrow; # 테이블에서 다음 행의 데이타 값을 배열로 리턴
서버로 부터 다음 행의 데이타 값의 배열을 리턴한다. 유사하게
%hash = $sth->fetchhash; # 테이블에서 다음 행의 데이타 값을 연관배열로 리턴
는 연관배열을 리턴한다. 해쉬에서 키는 테이블의 필드명이고, 값은 테이블 값이다. 한가지 두개의 동일한 필드명을 갖는 테이블이 있는 경우, 둘 중 한 필드를 삭제하지 않고는 이 방법을 사용할 수 없다는 것에 주의해야 한다. 그러한 경우에는 fetchrow를 사용해야 한다.
$sth->dataseek($row_number); # 가져올 데이타의 옾셋을 변경
스테이트먼트 핸들에 연관된 데이타의 옾셋을 지정한다. 다음번 fetchrow는 적당한 행(첫행은 0)을 리턴할 것이다.
(