┗System∑Sec†ion┛

mysql_real_connect() - Mysql 데이터베이스 엔진으로 연결 시도.

형태 & 인수

MYSQL *mysql_real_connect(

MYSQL *mysql,           /* MYSQL 구조의 어드레스 */

const char *host,        /* 호스트 이름 또는 IP 어드레스 (default = localhost) */

const char *user,       /* MySQL Login ID (default = 현재 로그인 이름) */

const char *passwd, /* 패스워드 (default = none) */

const char *db,           /* 데이터베이스 이름 (default = none) */

unsigned int port,      /* TCP/IP 연결 포트 (use default) */

const char *unix_socket,       /* 소켓 (use default) */

unsigned long client_flag)                /* flag (none) */

리턴 값

성공 : MYSQL* 연결 핸들 (= 첫 번째 파라미터)

실패 : NULL

사용자가 유효한 MYSQL 연결 핸들 구조를 요구하는 다른 어떤 API 함수를 

실행할 수 있기 전에 성공적으로 완료되어야 한다.

플래그(Flag) 이름

플래그(Flag) 설명

CLIENT_COMPRESS

압축 프로토콜 사용.

CLIENT_FOUND_ROWS

변경된 로우의 숫자가 아니라 찾은(맞는) 로우들의 숫자를 리턴.

CLIENT_IGNORE_SPACE

함수 이름 후에 공간 허용. 모든 함수 이름을 예비의 단어로 만듦.

CLIENT_INTERACTIVE

interactive_timeout 초 허용 (wait_timeout 초대신에)

of inactivity before closing the connection. 

클라이언트 세션 wait_timeout 변수는 세션

 interactive_timeout 변수 값으로 설정.

CLIENT_LOCAL_FILES

LOAD DATA LOCAL 조정 가능.

CLIENT_MULTI_STATEMENTS

싱글 문자열 (';'로 나눠진)에서 클라이언트가 다중(멀티) 명령문을 

보내도록 서버에 전달. 만약 이 플래그가 설정되어 있지 않다면, 

멀티-명령문 실행은 불가능하다.

CLIENT_MULTI_RESULTS

클라이언트가 멀티-명령문 실행 또는 스토어드 프로시저로부터 

멀티 결과 셋을 조정할 수 있다는 것을 서버에 전달. 

CLIENT_MULTI_STATEMENTS이 설정되어 있다면, 이것은 자동적으로 설정.

CLIENT_NO_SCHEMA

db_name.tbl_name.col_name 신텍스를 허용하지 않음. 이것은 ODBC용이다.

ODBC 프로그램에곤란한 버그에 사용하는 신텍스를 사용할 경우,

parser(쿼리문 분석기)가 에러를 출력하도록 한다.

CLIENT_ODBC

원격 데이터베이스를 사용할 때 ODBC를 사용하고 있는지 확인할 수 있다.

CLIENT_SSL

SSL 사용. 이 옵션은 어플리케이션 프로그램으로 설정될 수 없다; 

이것은 내부적으로 클라이언트 라이브러리 내에 설정된다.

mysql_real_connect()함수를 호출하기 전에mysql_ssl_set()함수를 사용.

[ 에러 ]

CR_CONN_HOST_ERROR

MySQL 서버로의 연결 실패.

CR_CONNECTION_ERROR

로컬 MySQL 서버로의 연결 실패

CR_IPSOCK_ERROR

IP소켓 생성 실패.

CR_OUT_OF_MEMORY

메모리 부족.

CR_SOCKET_CREATE_ERROR

유닉스 소켓 생성 실패.

CR_UNKNOWN_HOST

호스트 이름 용 IP 어드레스 찾기 실패.

CR_NAMEDPIPEOPEN_ERROR

윈도우에서 명명된 파이프 생성 실패

CR_NAMEDPIPEWAIT_ERROR

윈도우에서 명명된 파이프 대기(wait for) 실패.

CR_NAMEDPIPESETSTATE_ERROR

윈도우에서 파이프 핸들러(조정자) 획득 실패

CR_SERVER_LOST

connect_timeout > 0 이고 서버에 연결하는데

connect_timeout 초 보다 오래 걸리면 또는 서버가

or init-command을 실행하는 동안 죽는다면 실패.

옵션

설명

--cflags

찾는 컴파일러 프래그들은 파일과 핵심 컴파일러 플래그들을 포함하며,

libmysqlclient 라이브러리를 컴파일 할 때 사용된 정의한다.

--include

MySQL을 찾는 컴파일러 옵션은 파일을 포함한다.

(이 옵션 대신에 일반적으로 Note --cflags 을 사용한다는 것을 명심하라.)

--libs

MySQL 클라이언트 라이브러리로 링크하기 위해 요구되는 라이브러리들과 옵션들.

--libs_r

스레드에 안전한 MySQL 클라이언트 라이브러리로 링크하기 위해 요구되는 라이브러리와 옵션.

--plugindir

플러그인 디렉토리.

--socket

MySQL 설정 시 정의된 디폴트 유닉스 소켓 파일.

--port

MySQL 설정 시 정의된 디폴트 TCP/IP 포트 넘버.

--version

MySQL 버전 숫자.

--libmysqld-libs

MySQL 임베디드 서버로 링크하기 위해 요구되는 라이브러리들과 옵션들.

shell> mysql_config

Usage: /usr/bin/mysql_config [OPTIONS]

Options:

■■■--cflags■■■[-I/usr/include/mysql -DBIG_JOINS=1 -fno-strict-aliasing -DUNIV_LINUX -DUNIV_LINUX]

■■■--include■■[-I/usr/include/mysql]

■■■--libs■■■■[-Wl,-Bsymbolic-functions -rdynamic -L/usr/lib/mysql -lmysqlclient]

■■■--libs_r■■■[-Wl,-Bsymbolic-functions -rdynamic -L/usr/lib/mysql -lmysqlclient_r]

■■■--plugindir■[/usr/lib/mysql/plugin]

■■■--socket■■[/var/run/mysqld/mysqld.sock]

■■■--port■■■■[0]

■■■--version■■[5.1.41]

■■■--libmysqld-libs■[-Wl,-Bsymbolic-functions -rdynamic -L/usr/lib/mysql -lmysqld -ldl -lwrap -lrt]

shell> CFG=/usr/local/mysql/bin/mysql_config

shell> sh -c "gcc -o progname `$CFG --cflags` progname.c `$CFG --libs`"

Makefile 작성

CC = gcc

CFLAGS = -Wall $(shell mysql_config --cflags)

LIBS = $(shell mysql_config --libs)

EXECUTABLES = myclient

■■■■all : $(EXECUTABLES)

myclient : myclient.c

■■■■$(CC) $(CFLAGS) $^ -o $@ $(LIBS)

예:)

printf ("Number of rows: %lu\n", (unsigned long) mysql_num_rows(result));

플래그(Flag) 값

플래그(Flag) 설명

NOT_NULL_FLAG

필드는 NULL 이 될 수 없다.

PRI_KEY_FLAG

필드는 주요 키의 일부이다.

UNIQUE_KEY_FLAG

필드는 싱글(unique)키의 일부이다.

MULTIPLE_KEY_FLAG

필드는non-unique 키의 일부이다.

UNSIGNED_FLAG

필드는UNSIGNED 속성을 가진다.

ZEROFILL_FLAG

필드는 ZEROFILL 속성을 가진다.

BINARY_FLAG

필드는 BINARY 속성을 가진다.

AUTO_INCREMENT_FLAG

필드는 AUTO_INCREMENT 속성을 가진다.

ENUM_FLAG

필드는ENUM (deprecated)이다.

SET_FLAG

필드는 SET (deprecated)이다.

BLOB_FLAG

필드는BLOB 또는 TEXT (deprecated)이다.

TIMESTAMP_FLAG

필드는 TIMESTAMP (deprecated)이다.

if (field->flags & NOT_NULL_FLAG)

    printf("Field can't be null\n");

Flag 상태

설명

IS_NOT_NULL(flags)

필드가 NOT NULL로 정의된다면 참(true)

IS_PRI_KEY(flags)

이 필드가 주요 키라면 참(True)

IS_BLOB(flags)

이 필드가 BLOB 또는 TEXT (무시됨; 테스트 field->type 대신에)라면 참(true)

타입 값

타입 설명

MYSQL_TYPE_TINY

TINYINT 필드

MYSQL_TYPE_SHORT

SMALLINT 필드

MYSQL_TYPE_LONG

INTEGER 필드

MYSQL_TYPE_INT24

MEDIUMINT 필드

MYSQL_TYPE_LONGLONG

BIGINT 필드

MYSQL_TYPE_DECIMAL

DECIMAL 또는 NUMERIC 필드

MYSQL_TYPE_NEWDECIMAL

정교한 계산 DECIMAL 또는 NUMERIC필드 (MySQL 5.0.3 그리고 그 이후 버전에서)

MYSQL_TYPE_FLOAT

FLOAT 필드

MYSQL_TYPE_DOUBLE

DOUBLE 또는 REAL 필드

MYSQL_TYPE_BIT

BIT 필드 (MySQL 5.0.3 그리고 그 이후 버전에서)

MYSQL_TYPE_TIMESTAMP

TIMESTAMP 필드

MYSQL_TYPE_DATE

DATE 필드

MYSQL_TYPE_TIME

TIME 필드

MYSQL_TYPE_DATETIME

DATETIME 필드

MYSQL_TYPE_YEAR

YEAR 필드

MYSQL_TYPE_STRING

CHAR 또는 BINARY 필드

MYSQL_TYPE_VAR_STRING

VARCHAR 또는 VARBINARY 필드

MYSQL_TYPE_BLOB

BLOB 또는 TEXT 필드 (최대 길이를 결정하기 위해 max_length 를 사용하라)

MYSQL_TYPE_SET

SET 필드

MYSQL_TYPE_ENUM

ENUM 필드

MYSQL_TYPE_GEOMETRY

공간적 필드

MYSQL_TYPE_NULL

NULL-타입 필드

MYSQL_TYPE_CHAR

무시됨; 대신에MYSQL_TYPE_TINY 를 사용하라

if (IS_NUM(field->type))

    printf("Field is numeric\n");