Class to manager MYSQL for Harbour/xHarbour
Custom Search

domingo, 5 de septiembre de 2010

xcommand ( 2 part )

Explicare los commands referente al manejo de conexiones
I'll explain the command to handle connections

> CONNECT
> SELECTSERVER
> CLOSEMYSQL SERVER
> CLOSEMYSQL ALL
> SELECTDB cdb [srv: SERVER, MYSQL, OF oServer]

CONNECT [ srv: SERVER, MYSQL, OF ] oServer ;
                  HOST cHost ;
                  USER cUser ;
                  PASSWORD cPassword;
                  [ PORT nPort ];
                  [ FLAGS nFlags ];
                  [ DATABASE cDBName ];
                  [ ON ERROR uOnError ] ;
                  [ NAME cName ];

comando para hacer una conexion a un servidor, se necesitan como minimo 4 (cuatro) parametros.
command to make connection to host, is necessary (minimal) 4 parameter
1) Variable oServer (puede ser cualquier variable) contenedora del objeto TDolphinSrv
1) oServer variable (can be any variable name) owned TDolphinSrv object

2) HOST El valor de cHost puede ser un nombre de host o una dirección IP.
2) HOST The cHost value may be either a hostname or an IP address.

3) USER El valor cUser contiene el ID de usuario para la conexion del usuario a MySQL
3) USER The cUser value contains the user's MySQL login ID

4) PASSWORD El valor cPassword contiene la contraseña para cUser .
4) PASSWORD The cPassword value contains the password for cUser.

Los valores de los siguientes parametros seran determinados por defecto
The next paraneters values will be set by default
> PORT El valor nPort se utiliza como el número de puerto para la conexión TCP / IP, valor por defecto 3306
> PORT The nPort value is used as the port number for the TCP/IP connection. Default value 3306

> FLAGS El valor de nFlags suele ser 0, pero se puede establecer a una combinación de las siguientes opciones en circunstancias muy especiales:
> FLAGS The value of nFlags is usually 0, but can be set to a combination of the following flags in very special circumstances:




Flag NameFlag Description
CLIENT_COMPRESSUse compression protocol.
CLIENT_FOUND_ROWSReturn the number of found (matched) rows, not the number of affected rows.
CLIENT_IGNORE_SPACEAllow spaces after function names. Makes all functions names reserved words.
CLIENT_INTERACTIVEAllow interactive_timeout seconds (instead of wait_timeout seconds) of inactivity before closing the connection. The client's sessionwait_timeout variable is set to the value of the session interactive_timeout variable.
CLIENT_LOCAL_FILESEnable LOAD DATA LOCAL handling.
CLIENT_MULTI_STATEMENTSTell the server that the client may send multiple statements in a single string (separated by ';'). If this flag is not set, multiple-statement execution is disabled. New in 4.1.
CLIENT_MULTI_RESULTSTell the server that the client can handle multiple result sets from multiple-statement executions or stored procedures. This is automatically set ifCLIENT_MULTI_STATEMENTS is set. New in 4.1.
CLIENT_NO_SCHEMADon't allow the db_name.tbl_name.col_name syntax. This is for ODBC. It causes the parser to generate an error if you use that syntax, which is useful for trapping bugs in some ODBC programs.
CLIENT_ODBCThe client is an ODBC client. This changes mysqld to be more ODBC-friendly.
CLIENT_SSLUse SSL (encrypted protocol). This option should not be set by application programs; it is set internally in the client library.

> DATABASE cDBName es el nombre de la base de datos
> DATABASE cDBName is the database name

> ON ERROR uOnError Codeblock que personaliza el manejo de errores
argumentos 
Self, Objeto TDolphinSrv
nError, Codigo del error generado
lInternal, variable logica que determina si es un error interno de programacion (.T.) o devuelto por MySql (.F.) 
cExtra, Cadena adicional de descripcion de determinados errores

> ON ERROR uOnError Codeblock to custom manager error message
Arguments 
Self, TDolphinSrv Object
nError, Error Code
lInternal, Logical variable to check if is a internal error by programmer (.T.) or is returned by MySql (.F.) 
cExtra, Aditional string to description some specifics errors 

> NAME cName nombre para identificar la conexion al servidor
> NAME cName name to identify host connection

ejemplo/sample

CONNECT oServer
 HOST "dolphintest.sitasoft.net";
 USER "dan_dolphin" ; 
 PASSWORD "123456 ; 
 DATABASE "dolphin_man" ;
 NAME "connect01";
 ON GETERROR onError( Self, nErrorSrv ) 

/samples/connto.prg
-------------------------------------------------------------
SELECTSERVER
Comando para seleccionar y activar por defecto una conexion a un servidor
Command to select and activate by default an host connection
uParam puede conetener los siguientes valores:
Objecto TDolphinQry, Objecto TDolphinSrv, cadena con el nombre de la conexion

uParam can be next values:
Object TDolphinQry, Object TDolphinSrv, name connection string

ejemplo / sample

SELECTSERVER oServer
SELECTSERVER "connect01"

-------------------------------------------------------------
CLOSEMYSQL SERVER 
Commando para cerrar una conexion a un servidoron puede conetener los siguientes valores:
Objecto TDolphinSrv, cadena con el nombre de la conexion


command to close host connectionon can be next values:
Object TDolphinSrv, name connection string


CLOSEMYSQL ALL
Comando para cerrar todas las conexiones activas


Command to close all active connections

ejemplo/sample

CLOSEMYSQL SERVER "connect01"
CLOSEMYSQL ALL

--------------------------------------------------------------

SELECTDB cdb [srv: SERVER, MYSQL, OF oServer]

Selecciona base de datos cdb en conexion actual o una conexion especifica, determinada por el objeto oServer

Select a database cdb in current connection or specific connection, defined by oServer





No hay comentarios:

Publicar un comentario en la entrada