>ijg9BdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl m Z ddl m Z ddlmZmZmZmZmZmZmZmZmZmZmZmZddlmZdd lmZdd lm Z dd l!m"Z"m#Z#dd l$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+dd l,m-Z-ddl.m/Z/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:ddl;mZ>m?Z?m@Z@mAZAmBZBmCZCmDZDmEZEmFZFddlGmGZGddlHmIZImJZJmKZKddlLmMZMddlNmOZOddlPmQZQddlRmSZSmTZTmUZUmVZVmWZWmXZXmYZYmZZZm[Z[ddl\m]Z]m^Z^m_Z_m`Z`maZambZbmcZcerddlmdZdeMrddlemfZfmgZgGdde ZhdS)z.Implementing communication with MySQL servers.) annotationsN)Decimal)IOBase) TYPE_CHECKINGAnyBinaryIODict GeneratorListMappingOptionalSequenceTupleTypeUnion)version)cmd_refresh_verify_options)MySQLConnectionAbstract)MySQLAuthenticatorget_auth_plugin) ClientFlag FieldType RefreshOption ServerCmd ServerFlag flag_is_set-raise_warning_against_deprecated_cursor_class)MySQLConverter) MySQLCursorMySQLCursorBufferedMySQLCursorBufferedDictMySQLCursorBufferedNamedTupleMySQLCursorBufferedRawMySQLCursorDictMySQLCursorNamedTupleMySQLCursorPreparedMySQLCursorPreparedDictMySQLCursorPreparedNamedTupleMySQLCursorPreparedRawMySQLCursorRaw) ConnectionTimeoutError DatabaseErrorErrorInterfaceError InternalErrorNotSupportedErrorOperationalErrorProgrammingErrorReadTimeoutErrorWriteTimeoutError get_exception)logger) MySQLSocketMySQLTCPSocketMySQLUnixSocket) OTEL_ENABLED)with_context_propagation) MySQLProtocol) BinaryProtocolTypeDescriptionType EofPacketType HandShakeType OkPacketType ResultTypeRowTypeStatsPacketType StrOrBytes) get_platformhandle_read_write_timeout int1store int4storelc_intwarn_ciphersuites_deprecatedwarn_tls_version_deprecated)CMySQLPrepStmt)end_spanrecord_exception_eventc<eZdZdZdfd ZddZddZ dddZddZddZ ddZ ddZ e Z e ddd(Ze ddd.Zdd0Zedd1Zdd4Zdd6Ze ddd9Ze ddd;Z dddDZe dddGZddHZddIZee dddNZe ddQZeddSZddTZ dddVZ!e ddXZ"ddZZ#dd[Z$dd\Z%e dddfZ&eddgZ'e'j(ddiZ'ddjZ)ddlZ* dddpZ+ddduZ,eddvZ- ddd}Z.dd~Z/ddZ0ddZ1ddZ2ddZ3e dddZ4 dddZ5e ddZ6e dddZ7ddZ8ddZ9ddZ:ddZ;ddZ<xZ=S)MySQLConnectionzConnection to a MySQL ServerkwargsrreturnNonec d|_d|_d|_tt |_tj|_ d|_ d|_ d|_ d|_ d|_d|_d|_d|_d|_d|_d|_i|_d|_d|_d|_d|_d|_d|_d|_d|_d|_d|_d|_ d|_!d|_"d|_#d|_$g|_%d|_&tO|_(|r: |j)di|dS#tT$r|+d|_wxYwdS) NFz 127.0.0.1i rTr), _protocol_socket _handshakesuper__init__r_converter_classr get_default _client_flags _sql_mode _time_zone _autocommit_user _password _database_host_port _unix_socket _client_host _client_port_ssl _force_ipv6 _use_unicode _get_warnings_raise_on_warnings _buffered_unread_result_have_next_result_raw_in_transaction_prepared_statements _ssl_active _auth_plugin_krb_service_principal_pool_config_version_query_attrs_supported _columns_desc _mfa_nfactorr_authenticatorconnect Exceptionclose)selfrS __class__s X/var/www/html/mpstechhub/venv/lib/python3.11/site-packages/mysql/connector/connection.pyr]zMySQLConnection.__init__s26.2 37 6D","8":":(,)-!&   %  +/!#!"FH !&"&#((-$$)', %*)-!!&+/59#)-!+0#46!"2D2F2F    &&v&&&&&    #     s < E 'E2c t}tjd}|ddkrd}nd}t t j|dtjd|d d tj dd D|d d }|j |d S)z&Add the default connection attributes. rGPLv2zGPL-2.0 Commercialarchzmysql-connector-python.c,g|]}t|SrX)str).0xs r z;MySQLConnection._add_default_conn_attrs..s(N(N(NAQ(N(N(Nr)_pid _platform _source_host _client_name_client_license_client_version_osN) rGrLICENSEsplitrosgetpidsocket gethostnamejoinVERSION _conn_attrsupdate)rplatformlicense_chunksclient_licensedefault_conn_attrss r_add_default_conn_attrsz'MySQLConnection._add_default_conn_attrss>> ..s33 !  ' '&NN)N $$!&)".004-"xx(N(N19M(N(N(NOOI&   !355555rc^t|j}|ddkrt|d|_|j|}|d}|t|tttfr|nd|_ |j |j |dtjzs|js4|jdkrt%d|jd krt%d |jd rt%d d |xjtjzc_n!|js|xjtjzc_|dtjzr |tjg|dtjzr'd|_|tjg|dtjzr |tjg||_dS)z'Get the handshake from the MySQL serverNserver_version_originalUnknown capabilitiesmysql_clear_passwordzEClear password authentication is not supported over insecure channels$authentication_openid_connect_clientzEOpenID Connect authentication is not supported over insecure channels verify_certz1SSL is required but the server doesn't support iti)errnoT)bytesrZrecvr6r[rYparse_handshake_check_server_version isinstancer bytearray_server_version_character_setset_mysql_versionrSSL is_securerxr/rlgetr` _ssl_disabled PLUGIN_AUTHset_client_flagsCLIENT_QUERY_ATTRIBUTESr{MULTI_FACTOR_AUTHENTICATION)rpacket handshakeserver_versions r _do_handshakezMySQLConnection._do_handshakes6t|((**++ !9  '' 'N226:: "#<=#99.3y*ABB NN   --d.BCCC(:>9 1> $(>>>(,$(NNN(,y}}]++ $G   :>/ 1   # 1   *. 0   ^ $z'= = <  ! !:#9": ; ; ; ^ $z'I I H*.D '  ! !:#E"F G G G ^ $z'M M L  ! !:#I"J K K K#rNrusername Optional[str]passworddatabase client_flagsint ssl_options:Optional[Dict[str, Optional[Union[str, bool, List[str]]]]] conn_attrsOptional[Dict[str, str]]boolc@|jds*|jdr@tjdkr0|s.t j}t jd||j|jr||jkr|j}d|_ |j sD|tj zr5|j |j|j||j|d|_ |j |j|j|j|j|jd |j |j|j|||j|j||j||j|j| }|||tjzs|r||dS) aeAuthenticate with the MySQL server Authentication happens in two parts. We first send a response to the handshake. The MySQL server will then send either an AuthSwitchRequest or an error packet. Raises NotSupportedError when we get the old, insecure password reply back. Raises any error coming from MySQL. authentication_ociauthentication_kerberosntz4MySQL user is empty, OS user: %s will be used for %sF)charsetrT)krb_service_principaloci_config_fileoci_config_profilewebauthn_callbackopenid_token_fileconfig) sockrr password1 password2 password3rrr auth_pluginauth_plugin_classr) rx startswithrnamegetpassgetuserr7debug _password1rwrrrr~ setup_sslrZ server_host _charset_idupdate_plugin_configry_oci_config_file_oci_config_profile_webauthn_callback_openid_token_file authenticater[ _password2 _password3_auth_plugin_class _handle_okCONNECT_WITH_DB cmd_init_db)rrrrrrrok_pkts r_do_authzMySQLConnection._do_auths&   ( ()= > > !,,-FGG GtOO$((H LF!    ? 'x4?::H ! $|jn'D $   ) )  () *    $D  00)-)D#'#8&*&>%)%<%)%<  1   $11ooo$%)"5!2    z99 'x '   X & & &trr8cd}|jr&tjdkrt|j}n!t |j|j|j}| |j |S)zGet connection based on configuration This method will return the appropriated connection object using the connection parameters. Returns subclass of MySQLBaseSocket. Nposix) unix_socket)hostport force_ipv6) rirrr:rr9r server_portrmset_connection_timeout_connection_timeout)rconns r_get_connectionzMySQLConnection._get_connectionTsy   G!3!3"t/?@@@DD!%%+D ##D$<=== rc|j}|j}dx|_|_|jdkr:|js3t |j|j}||_t|_| |_ |j | | |j|j|j|j|j|j||j|jt*jzr|j |j dne#t2$rX}|j t7|t8t:frt=|j|j ||d}~wwxYw ||_||_n#||_||_wxYw|j!s{tE|j j#drctI|j j#j%rG|j j#%\}}}tM|tO||dSdSdSdS)zOpen the connection to the MySQL server This method sets up and opens the connection to the MySQL server. Raises on errors. Nauthentication_kerberos_client)rmsgcipher)( read_timeout write_timeoutrxrdrrget_user_from_credentialsr=rYrrZopen_connectionrrrerfr`rlrset_converter_classr^rCOMPRESSswitch_to_compressed_moderrclose_connectionrr4r5r,rrrhasattrrcallabler rMrL)rstored_read_timeoutstored_write_timeoutclserrr  tls_version_s r_open_connectionz MySQLConnection._open_connectionis#/#1155D.   @ @ @ @!$"3T5LMMC6688DJ&++-- # 6 L ( ( * * *     MM "       $ $T%: ; ; ;!J$77 9 66888 L / / 5 5 5 5    L ) ) + + +# 02CDEE ,)I  6!4D !5D  !4D !5D  5 5 5 5" > )844 >*122 >&*\%6%=%=%?%? "FK ' 4 4 4 ( = = = = = > > > > > >s,CEG  F8 AF33F88G Gc||jsdS |jdS#ttf$rYdSwxYw)ahShut down connection to MySQL Server. This method closes the socket. It raises no exceptions. Unlike `disconnect()`, `shutdown()` closes the client connection without attempting to send a QUIT command to the server first. Thus, it will not block if the connection is disrupted for some reason such as network failure. N)rZshutdownAttributeErrorr.rs rrzMySQLConnection.shutdownsY|  F  L ! ! # # # # #&    DD s &;;c(|jrE|jr,t|jtjd|jsdS |n#ttf$rYnwxYw |j n/#t$r"}trt|j|d}~wwxYw trt|jn!#trt|jwwxYwd|_ dS)z Disconnect from the MySQL serverrN)_span is_recordingrPsysexc_inforZcmd_quitrr.rrr;rOr[)rrs rrzMySQLConnection.closes3 : B$*1133 B "4:s|~~a/@ A A A|  F  MMOOOO&    D  % L ) ) + + + +    8&tz3777   ,  %$$$ %$$$$ %s<A,,B?BBC* C (CC  C**DTcommandargumentOptional[bytes] packet_numberrexpect_responsecompressed_packet_numberr  Optional[int]r Optional[bytearray]c 8| |j|j||p||||p|j|r!|j|p|jndS#t$r} td| d} ~ wwxYw)a4Send a command to the MySQL server This method sends a command with an optional argument. If packet is not None, it will be sent and the argument will be ignored. The packet_number is optional and should usually not be used. Some commands might not result in the MySQL server returning a response. If a command does not return anything, you should set expect_response to False. The _send_cmd method will then return None instead of a MySQL packet. Returns a MySQL packet or None. NMySQL Connection not available) handle_unread_resultrZsendrY make_command_write_timeoutr _read_timeoutrr2) rr%r&r(rr)r*r r rs r _send_cmdzMySQLConnection._send_cmds6 !!### N L  ++GV5GxHH(4!4    # !!,"D$2DEEE   N N N"#CDD# M NsA#A:: BBBF data_filersend_empty_packetrcT|t|dstdd} ||dz }|r=|j||p|j||dz }|=n"#t$r}td|d}~wwxYw|rV |jd|p|jn1#t$r}|d}~wt$r}td|d}~wwxYw|j |p|j S) a4Send data to the MySQL server This method accepts a file-like object and sends its data as is to the MySQL server. If the send_empty_packet is True, it will send an extra empty package (for example when using LOAD LOCAL DATA INFILE). Returns a MySQL packet. readzexpecting a file-like objectr r.Nr) r/r ValueErrorr8rZr0r2rr2r5rr3)rr5r6r r  chunk_sizebufrs r _send_datazMySQLConnection._send_data s" !!###y&)) =;<< <  N..b11C 6 !!}'K8K" nnZ"_55  6  N N N"#CDD# M N  R R !!}'K8K"%    ! R R R&'GHHcQ R|  !C1CDDDs<AB B.B))B.4#C D"C$$ D1DDflagscttj||_ttj||_dS)aHandle the server flags found in MySQL packets This method handles the server flags send by MySQL OK and EOF packets. It, for example, checks whether there exists more result sets or whether there is an ongoing transaction. N)rrMORE_RESULTS_EXISTSrsSTATUS_IN_TRANSru)rr@s r_handle_server_statusz%MySQLConnection._handle_server_status6s4"-Z-KU!S!S*:+EuMMrc|jS)z'MySQL session has started a transaction)rurs rin_transactionzMySQLConnection.in_transaction@s ##rrrBc|ddkr7|j|}||d|S|ddkrt|t d)aHandle a MySQL OK packet This method handles a MySQL OK packet. When the packet is found to be an Error packet, an error will be raised. If the packet is neither an OK or an Error packet, InterfaceError will be raised. Returns a dict() rr status_flagrzExpected OK packet)rYparse_okrDr6r/)rrrs rrzMySQLConnection._handle_okEsp !9>>^,,V44F  & &vm'< = = =M !9  '' '1222rr@c|ddkr7|j|}||d|S|ddkrt|t d)aHandle a MySQL EOF packet This method handles a MySQL EOF packet. When the packet is found to be an Error packet, an error will be raised. If the packet is neither and OK or an Error packet, InterfaceError will be raised. Returns a dict() rrHrzExpected EOF packet)rY parse_eofrDr6r/)rreofs r _handle_eofzMySQLConnection._handle_eofVsr !9  .**622C  & &s='9 : : :J !9  '' '2333rfilenamercjtj|}tj|rt d|js|jstd|js|jrtj|j}d} tj||g}nF#t$r9}d}t| t||||d}~wwxYw||kr%d}t| || t|d} ||| d|| | S#t"t$f$rYSwxYw#t"$r\ |jd|p|j n"#t,$r}t d |d}~wwxYwtd |d dwxYw# | w#t"t$f$rYwwxYwxYw) z'Handle a LOAD DATA INFILE LOCAL requestz#Use of symbolic link is not allowedKLOAD DATA LOCAL INFILE file request rejected due to restrictions on access.NzL{} while loading file `{}` and path `{}` given in allow_local_infile_in_pathzEThe file `{}` is not found in the given allow_local_infile_in_path {}rbTrr;r.zFile 'z' could not be read)rpathabspathislinkr2_allow_local_infile_allow_local_infile_in_pathr- commonpathr<r/formatropenrr?rIOError NameErrorrZr0r2r) rrOr r  file_name infile_pathc_pathrerr_msgr5s r_handle_load_data_infilez(MySQLConnection._handle_load_data_infilegsGOOH-- 7>>) $ $ J"#HII I' 0P * ' LD,L L'//$*JKKKF ++[),DEE   5%NN3s88Y DD  $$4$GNN9k$J$JKKK Y--I?? 4}MM !!!!Y'     T T T R !!}'K8K"" R R R&'GHHcQ R !H)!H!H!HIIt S T !!!!Y'    s !C D 4DD4:F/FFF H&#G  H G)G$$G))HHH2HH2H/,H2.H//H2rCcV|rt|dkrtd|ddkr||S|ddkr3|dd}||||S|ddkr||S|ddkrt ||j|}|rt|tstd dg|z|_ td|D]I}|j |j|p|j|j|j |<J||j|p|j}d |_|j |d S) aHandle a MySQL Result This method handles a MySQL result, for example, after sending the query command. OK and EOF packets will be handled and returned. If the packet is an Error packet, an Error-exception will be raised. The dictionary returned of: - columns: column information - eof: the EOF-packet information Returns a dict() rEmpty responserNrKrzIllegal result setT)columnsrM)lenr/rdecoderarNr6rYparse_column_countrrr|range parse_columnrZrr3python_charset unread_result)rrr r rO column_countirMs r_handle_resultzMySQLConnection._handle_results( 3Vq !122 2 !9>>??6** * !9  abbz((**H00<WW W !9  ##F++ + !9  '' '~88@@  7:lC#@#@ 7 !566 6  q,''  A$(N$?$? !!,"D$2DEE#%%D q ! ! t|001SASTTUU!-c:::rbinaryrfOptional[List[DescriptionType]]rawOptional[bool] prep_stmtOptional[CMySQLPrepStmt]1Tuple[Optional[RowType], Optional[EofPacketType]]c |dd}|d||||\}}|r |d|fSd|fS)aTGet the next rows returned by the MySQL server This method gets one row from the result set after sending, for example, the query command. The result is a tuple consisting of the row and the EOF packet. If no row was available in the result set, the row data will be None. Returns a tuple. r Nr)countrqrfrsr r)rget_rows) rrqrfrsrurSr rowsrMs rget_rowzMySQLConnection.get_rowsd"zz.$77 mm% $  s  "GS> !c{rry-Tuple[List[RowType], Optional[EofPacketType]]c h |j}jstdgdf} |dd}|r:j} | dkrd} jj||| |pj}n.j jj ||pj}n#t$r} d_| d} ~ wwxYw|\}} |s6|s4j -|r+tdrjj fd|D}| .d | vr| d n| d d_|| fS) aGet all rows returned by the MySQL server This method gets all rows returned by the MySQL server after sending, for example, the query command. The result is a tuple consisting of a list of rows and the EOF packet. Returns a tuple() NzNo result set availabler utf8mb4utf8F converterc2g|]}|jSrX)r|)rrow row_to_pythonrs rrz,MySQLConnection.get_rows..)s(KKKsMM#t'9::KKKrrH server_status)rtrmr0rrrYread_binary_resultrZr3read_text_resultrr.r|rrrrD) rryrqrfrsrurSr{r rreof_prs ` @rrzzMySQLConnection.get_rowss$ ;)C! ; 9:: :=?J !::nd;;L ,i''$G~88L 6D$6 ~66L( 6D$6     !&D I  e L L"./k**/!N8MKKKKKdKKKD    & & E))m$$?+    "'D U{sBB(( C2 B;;Cc@|jr|dSdS)zConsume resultsN)rmrzrs rconsume_resultszMySQLConnection.consume_results5s(    MMOOOOO  rc||tj|dS)zChange the current database This method changes the current (default) database by sending the INIT_DB command. The result is a dictionary containing the OK packet information. Returns a dict() utf-8)rr4rINIT_DBencode)rrs rrzMySQLConnection.cmd_init_db:s: NN9,hoog.F.F G G   rqueryrFbuffered raw_as_stringc  t|ts9t|tr|d}t|}|jdkr|jnd}t}|js"|jrtjdt|j tj zrg}g} g} dgt|jdzdzz} t|jD]\} } | d }d}|V| | dzxxd | dzzzcc<| t#t$jt#|zht|t(r5|j|\}}}| |nmt|trU||}| t/t||zt$j}nt|t2r@| t/t||zt$j}nt|t4r| t/tt||t||zt$j}nt|t8r5| t;jd |t$j}nt|t@j t@j!fr3|j"|\}}| |nvt|t@j#t@j$fr3|j%|\}}| |ntMd |j'j(d | t#|t#|z| d|}|t/t||z|)t/t|j|)t/d | r|)d *d| Dt#d ztW| |D]/\}}|)||)|0| D]}|)||)|t3|} |,dd}|,dd}|-|.t^j0|||||}n9#tL$r,}|j1dkrd|j2vrd}tg||d}~wwxYw|S)Nrrr.s$KKKfk#s33KKKrr r r r ilzLoading local data is disabledrQ)4rrrrrr{ _query_attrswarningswarnWarningr`rrrg enumerateitemsappendrIrNULLrrYprepare_binary_integerrKSTRINGrrDECIMALfloatrrDOUBLEdatetimedateprepare_binary_timestamp timedeltatimeprepare_binary_timer3r__name__extendrziprrpr4rQUERYrrr-)rrrsrrrSrrnamestypesvalues null_bitmappos attr_tuplevaluer@packed field_typer_typer r resultrr`s r cmd_queryzMySQLConnection.cmd_queryGs%++ %%%% . W--e$$E"&,)";";$,,* t/@  MN        B BD )EE"$F##d&7"8"81"<!BCK#,T->-D-D-F-F#G#G. 7. 7Z"1 =+++qS1W~=+++LL9>!:!:Yu=M=M!MNNNeS))$ ==eDD "MM&))))s++!LL11EMM&U"4"4u"<===!*!1JJu--MM&U"4"4u"<===!*!1JJw//MMs3u::#4#4W#=#=>>??e**++G445"+!2JJu--MM&+dE":":;;;!*!1JJ(98='IJJ ??FF"MM&))))(:HM'JKK+/>+M+Me+T+T(VZMM&))))*@!O4@@@ Yz22Yu5E5EEFFF!!}++G44 VCII..56666 MM&T%6!7!788 9 9 9 MM&)) $ $ $ ) HHKK{KKKLLll#$'ue#4#4((KE4MM%(((MM$''''#))EMM%(((( ef  !::nd;;L"JJ==M((O!-"/    FF    yD  %E%P%P1$G,,#5   s2A$X Y !'YY  statements!Generator[ResultType, None, None]c+@K|dd}|dd}t}t|ts9t|tr|d}t|}|jt jzrD|td|td||t|}| | tj|||||V|jrV|| |j|p|j||V|jTdSdS) atSend one or more statements to the MySQL server Similar to the cmd_query method, but instead returns a generator object to iterate through results. It sends the statements to the MySQL server and through the iterator you can get the results. statement = 'SELECT 1; INSERT INTO t1 VALUES (); SELECT 2' for result in cnx.cmd_query(statement, iterate=True): if 'columns' in result: columns = result['columns'] rows = cnx.get_rows() else: # do something useful with INSERT result Returns a generator. r Nr rrrr)r )rrrrrr`rrrrKrrpr4rrrsr/rZrr3)rrrSr r rrs rcmd_query_iterzMySQLConnection.cmd_query_iters,zz.$77  ?D99 *i00 /*c** 7'..v66 ":..J   B B % MM&)) $ $ $ MM&)) $ $ $ j!!!f !! NN)+        $   % % ' ' '%% !!|/Qt?Q!RR   $     roptionsc|tjtjztjztjztjztjzzstdd}|tjzr|d}|tjzr|d}|tjzr|d}|tjzr|d}|tjzr|d}|tjzr"||j dkrdnd }|S) NzInvalid command REFRESH optionzFLUSH PRIVILEGESz FLUSH LOGSz FLUSH TABLESz,TRUNCATE TABLE performance_schema.host_cachez FLUSH STATUS)rrz RESET SLAVEz RESET REPLICA) rGRANTLOGTABLESHOSTSTATUSREPLICAr<rr)rrress r cmd_refreshzMySQLConnection.cmd_refreshsN   " #  !"  # #  $  ?=>> > ]( ( 5..!344C ]& & /....C ]) ) 1..00C ]' ' Q..!OPPC ]) ) 1..00C ]* * ..!%!5 !B!B C rc||jtj} |j|dd|jn#t$r }Yd}~nd}~wwxYw|S)aClose the current connection with the server This method sends the `QUIT` command to the MySQL server, closing the current connection. Since there is no response from the MySQL server, the packet that was sent is returned. Returns a str() rN) r/rYr1rQUITrZr0r2r5)rrrs rr$zMySQLConnection.cmd_quits !!###,,Y^<<  L  faD,? @ @ @ @     DDDD  s"A A1,A1 shutdown_typec0|ddS)zShut down the MySQL Server This method sends the SHUTDOWN command to the MySQL server. The `shutdown_type` is not used, and it's kept for backward compatibility. SHUTDOWNN)r)rrs r cmd_shutdownzMySQLConnection.cmd_shutdown)s z"""""rrEc$||jtj}|j|dd|j|j|j |j S)zSend the statistics command to the MySQL Server This method sends the STATISTICS command to the MySQL server. The result is a dictionary with various statistical information. Returns a dict() r) r/rYr1r STATISTICSrZr0r2parse_statisticsrr3rrs rcmd_statisticszMySQLConnection.cmd_statistics1sv !!###,,Y-ABB &!Q(;<<<~..t|/@/@AS/T/TUUUr mysql_pidczt|tstd|d|S)zKill a MySQL process This method send the PROCESS_KILL command to the server along with the process ID. The result is a dictionary with the OK packet information. zMySQL PID must be intzKILL )rrr<r)rrs rcmd_process_killz MySQLConnection.cmd_process_kill@s@)S)) 6455 5~~1i11222rcf||tjS)aFSend the DEBUG command This method sends the DEBUG command to the MySQL server, which requires the MySQL user to have SUPER privilege. The output will go to the MySQL server error log and the result of this method is a dictionary with EOF packet information. Returns a dict() )rNr4rDEBUGrs r cmd_debugzMySQLConnection.cmd_debugKs&y ? ?@@@rcf||tjS)aSend the PING command This method sends the PING command to the MySQL server. It is used to check if the the connection is still valid. The result of this method is dictionary with OK packet information. Returns a dict() )rr4rPINGrs rcmd_pingzMySQLConnection.cmd_pingWs$t~~in==>>>rrWrrrrrrrOptional[OkPacketType]c t|@t|tstd|dkrtd||_d|_||_||_||_||_||_ |jr||jkr |j|_| |j rtd|r||_ | r| |_| |_|j|j |j|jd|j|j|j|j|j|j|j ||j|j|j|j|jd |j|j } |jt6jzs|r||||| S) zChange the current logged in user This method allows to change the current logged in user information. The result is a dictionary with OK packet information. Returns a dict() Nzcharset must be an integerrz2charset should be either zero or a postive integerrz-Change user is not supported with compression)rrrrT)rrrrrrrrrrrris_change_user_requestr r ) rrr<rr}rdrerrrr/ _compressr1rrrr~rrrZr[r`rxrrr3r2rrr_post_connectionr) rrrrrrrrrrrrs rcmd_change_userzMySQLConnection.cmd_change_userbs.  gs++ ? !=>>>{{ !UVVV&D  !### ? -x4?::!_DN !!### > U#$STT T  4$3D !  8&7D ##5  00#'#8&*&>%)%< 1   $11oZnoo$+)"5'#'+-2  $"Z%?? 'X '   X & & & v&&&rc8|ddS)zGet the current databasezSELECT DATABASE()r) info_queryrs rrzMySQLConnection.databases233A66rrc0||dS)zSet the current databaseN)r)rrs rrzMySQLConnection.databases rcT |n#t$rYdSwxYwdS)a2Reports whether the connection to MySQL Server is available This method checks whether the connection to MySQL is available. It is similar to ping(), but unlike the ping()-method, either True or False is returned and no exception is raised. Returns True or False. FT)rr.rs r is_connectedzMySQLConnection.is_connecteds=  MMOOOO   55 ts  %%rSc||_dS)zySet the path that user can upload files. Args: path (str): Path that user can upload files. N)rW)rrSs rset_allow_local_infile_in_pathz.MySQLConnection.set_allow_local_infile_in_paths ,0(((ruser_variablesOptional[Dict[str, Any]]session_variablesc h|std|sv ||j|j|j|j|j|j |j |j |j |j n$#t$r|YnwxYw|}|r5|D] \}}|d|d|f!|r5|D]"\}}|d|d|f!dSdS)aClears the current active session This method resets the session state, if the MySQL server is 5.7.3 or later active session will be reset without re-authenticating. For other server versions session will be reset by re-authenticating. It is possible to provide a sequence of variables and their values to be set after clearing the session. This is possible for both user defined variables and session variables. This method takes two arguments user_variables and session_variables which are dictionaries. Raises OperationalError if not connected, InternalError if there are unread results and InterfaceError on errors. zMySQL Connection not available.zSET @`z` = %sz SET SESSION `N)rr2cmd_reset_connectionrrdrerfrrrrrrrr3 reconnectcursorrexecute)rrrcurkeyrs r reset_sessionzMySQLConnection.reset_sessions(  "" F"#DEE E((** ! !$$JNN$OOO),+    $ ! ! !      !kkmm  <,2244 < < U 0S0005(;;;;  C/5577 C C U 7C777%BBBB C C C CsAB B+*B+rrattemptsdelayc |dS#t$r5}|r|||ntd|Yd}~dSd}~wwxYw)aCheck availability of the MySQL server When reconnect is set to True, one or more attempts are made to try to reconnect to the MySQL server using the reconnect()-method. delay is the number of seconds to wait between each retry. When the connection is not available, an InterfaceError is raised. Use the is_connected()-method if you just want to check the connection without raising an error. Raises InterfaceError on errors. )rrz$Connection to MySQL is not availableN)rr.rr/)rrrrrs rpingzMySQLConnection.ping s V MMOOOOO V V V V>>>>$%KLLRUU?>>>>> Vs A*AAcH|jr|jdSdS)zMySQL connection IDserver_threadidN)r[rrs r connection_idzMySQLConnection.connection_ids* ? :?&&'899 9trprepared cursor_classOptional[Type[MySQLCursor]] dictionary named_tupler c  ||std|*t|tr|dkrt d|*t|tr|dkrt d|1t |tstd||||S||n|j }||n|j }d |dur dz |dur d z |dur d z |dur d z |dur d z ttttttt t"t$t&t(t*d } t-| j| |||S#t0$rCd t3dd fdt7dDzdwxYw)aUInstantiates and returns a cursor By default, MySQLCursor is returned. Depending on the options while connecting, a buffered and/or raw cursor is instantiated instead. Also depending upon the cursor options, rows can be returned as dictionary or named tuple. Dictionary and namedtuple based cursors are available with buffered output but not raw. It is possible to also give a custom cursor through the cursor_class parameter, but it needs to be a subclass of mysql.connector.cursor.MySQLCursor. Raises ProgrammingError when cursor_class is not a subclass of MySQLCursor. Raises ValueError when cursor is not available. Raises InterfaceError when read_timeout or write_timeout is not a positive integer. Returns a cursor-object r.Nrz.Option read_timeout must be a positive integerz/Option write_timeout must be a positive integerz0Cursor class needs be to subclass of MySQLCursorTrrrr:) rrr rrrer r:) cursor_name)rrsrrrz*Cursor not available with given criteria: z, c8g|]}d|zzdk|S)rrrX)rroargs cursor_types rrz*MySQLConnection.cursor..s1VVV+a:PTU:U:UT!W:U:U:Urre)r/rr2rrr/ issubclassr r3rqrtr!r+r$r%r"r&r#r'r*r(r)rrKeyErrorr<rrj) rrrsrrrrr r rrrs @@rrzMySQLConnection.cursor&sP@ !!###  "" E"#CDD D  #<-- $1=1A1A !QRR R  $=#.. %2?!2C2C !RSS S  #lK88 &F!L$ mDD D'388_cc$) t   1 K $;; 1 K    1 K $   1 K t   2 K"%&$,#&'-     9!+.7    'E+&lMJJ J   OD<))VVVVVeAhhVVVWWX  s -FA Gc0|ddS)zCommit current transactionCOMMITN)_execute_queryrs rcommitzMySQLConnection.commits H%%%%%rcf|jr||ddS)zRollback current transactionROLLBACKN)rmrzrrs rrollbackzMySQLConnection.rollbacks4    MMOOO J'''''rcX|||dS)aExecute a query This method simply calls cmd_query() after checking for unread result. If there are still unread result, an InterfaceError is raised. Otherwise whatever cmd_query() returns is returned. Returns a dict() N)r/r)rrs rrzMySQLConnection._execute_querys. !!### urOptional[RowType]c|d|j|j}|||S)z%Send a query which only returns 1 rowT)rr r )rr3r2rfetchone)rrrs rrzMySQLConnection.info_querysM+-   u   rDict[str, int]c|ddkr|j|S|ddkrt|td)a>Handle a MySQL Binary Protocol OK packet This method handles a MySQL Binary Protocol OK packet. When the packet is found to be an Error packet, an error will be raised. If the packet is neither an OK or an Error packet, InterfaceError will be raised. Returns a dict() rrrzExpected Binary OK packet)rYparse_binary_prepare_okr6r/rs r_handle_binary_okz!MySQLConnection._handle_binary_oksS !9>>>99&AA A !9  '' '8999rEUnion[OkPacketType, Tuple[int, List[DescriptionType], EofPacketType]]c|rt|dkrtd|ddkr||S|ddkr||S|ddkrt ||j|}|rt|tstddg|z}td|D]D}|j |j |p|j |j||<E||j |p|j }|||fS)aHandle a MySQL Result This method handles a MySQL result, for example, after sending the query command. OK and EOF packets will be handled and returned. If the packet is an Error packet, an Error exception will be raised. The tuple returned by this method consist of: - the number of columns in the result, - a list of tuples with information about the columns, - the EOF packet information as a dictionary. Returns tuple() or dict() rrcrrKrzIllegal result set.N)rgr/rrNr6rYrirrrjrkrZrr3rl)rrr rnrfrorMs r_handle_binary_resultz%MySQLConnection._handle_binary_resultsd" 3Vq !122 2 !9>>??6** * !9  ##F++ + !9  '' '~88@@  8:lC#@#@ 8 !677 7*.,)>q,''  A44 !!,"D$2DEE#GAJJ t|001SASTTUUgs++r statement_idr{c |dd}|dd}|j||}d|_|t j|d||d|_dS)zFetch a MySQL statement Result Set This method will send the FETCH command to MySQL together with the given statement id and the number of rows to fetch. r Nr Fr)r r T)rrYmake_stmt_fetchrmr4r STMT_FETCH)rr&r{rSr r rs rcmd_stmt_fetchzMySQLConnection.cmd_stmt_fetchszz.$77  ?D99 // dCC"   !%'    "r statement/Mapping[str, Union[int, List[DescriptionType]]]c |dd}|dd}|tj|||}||}g|d<g|d<|ddkrt d|dD]Z}|d|j|j |p|j |j [| |j |p|j |d dkrt d|d D]Z}|d|j|j |p|j |j [| |j |p|j |S) zPrepare a MySQL statement This method will send the PREPARE command to MySQL together with the given statement. Returns a dict() r Nr rrf parameters num_paramsr num_columns)rr4r STMT_PREPAREr"rjrrYrkrZrr3rlrN)rr,rSr r rrrs rcmd_stmt_preparez MySQLConnection.cmd_stmt_prepareszz.$77  ?D99   " %'     ''//y!| , ! # #1f\233  |$++N// )),*L$:LMM+   T\..|/Qt?QRR S S S - 1 $ $1f]344  y!((N// )),*L$:LMM+   T\..|/Qt?QRR S S S rrXdataSequence[BinaryProtocolType]r/rc Nt|}i}|dd}|dd}|ryt|D]i\} } t|| trId} d|| jv} n#t $rYnwxYw||| || ||| f|| <j|js"|j rtj dt|j tjzr>|j||t%||||j|j|j} n8|j||t%||||j|j } |t.j| || } || |}|S) z"Execute a prepared MySQL statementr Nr Tbrrr)converter_str_fallback)rr r )listrrrrmodercmd_stmt_send_long_datar{rrrrr`rrrYmake_stmt_executetupler query_attrs_converter_str_fallbackr4r STMT_EXECUTEr%)rr&r4r/r@rSlong_data_usedr r param_idrrqexecute_packetrrs rcmd_stmt_executez MySQLConnection.cmd_stmt_execute"s*%% zz.$77  ?D99  9(44 9 9 !d8nf55 9!F!$DN,?!?)00$ X%1&3 117yN8,* t/@  MN        B B !^==j!!  ,  NN"^==j!! '+'C>N  "!%'     ++FLAA s2B BBc |tjt|d|dd|dddS)zDeallocate a prepared MySQL statement This method deallocates the prepared statement using the statement_id. Note that the MySQL server does not return anything. Fr Nr r()r4r STMT_CLOSErJrrr&rSs rcmd_stmt_closezMySQLConnection.cmd_stmt_closeds_   l # #!ND99 **_d;;      rrBc d}d} ||}|r|j|||}|tj|d|dd|dd|t|z }||}|n"#t$r} td| d} ~ wwxYw|S) a.Send data for a column This methods send data for a column (for example BLOB) for statement identified by statement_id. The param_id indicate which parameter the data belongs too. The data argument should be a file-like object. Since MySQL does not send anything back, no error is raised. When the MySQL server is not reachable, an OperationalError is raised. cmd_stmt_send_long_data should be called before cmd_stmt_execute. The total bytes send is returned. Returns int. r9rFr Nr )rr)r r r.) r8rYprepare_stmt_send_long_datar4rSTMT_SEND_LONG_DATArrgrr2) rr&rBr4rSr= total_sentr>rrs rr;z'MySQLConnection.cmd_stmt_send_long_dataws.   N))J''C ,CC (C1!$)!'ND!A!A"(**_d"C"C c#hh& ii ++ , N N N"#CDD# M NsB(B// C9C  Cc ||tjt ||dd|dddS)zReset data for prepared statement sent as long data The result is a dictionary with OK packet information. Returns a dict() r Nr r)rr4r STMT_RESETrJrrGs rcmd_stmt_resetzMySQLConnection.cmd_stmt_resetsm  NN$,''#ZZ==$jj$??        rc ||tj|dS#t t f$rYdSwxYw)zResets the session state without re-authenticating Reset command only works on MySQL server 5.7.3 or later. The result is True for a successful reset otherwise False. Returns bool TF)rr4rRESET_CONNECTIONrr1r2rs rrz$MySQLConnection.cmd_reset_connectionsg  OODNN9+EFF G G G  ! ! # # #4!#34   55 sAA AAcl|jr|dS|jrtddS)z'Check whether there is an unread resultzUnread result foundN)can_consume_resultsrrmr0rs rr/z$MySQLConnection.handle_unread_resultsI  # 7  " " " " "   7 566 6 7 7r)rSrrTrU)rTrU)NNNrNN)rrrrrrrrrrrrrTr)rTr8)NrNTrNN)r%rr&r'r(rrr'r)rr*rr r+r r+rTr,)FNN) r5rr6rr r+r r+rTr)r@rrTrU)rTr)rrrTrB)rrrTr@)NN)rOrr r+r r+rTrB)rrr r+r r+rTrC)FNNN) rqrrfrrrsrtrurvrSrrTrw)NFNNN)ryr+rqrrfrrrsrtrurvrSrrTr})rrrTrB)FFF) rrFrsrrrrrrSrrTrC)rrFrSrrTr)rrrTrB)rTr)N)rr+rTrU)rTrE)rrrTrB)rTr@)rTrB) rWrWrWNrWrWrWrWrWrW)rrrrrrrr+rrrrrrrrrrrrrTr)rTr)rrrTrU)rSrrTrU)rrrrrTrU)Frr)rrrrrrrTrU)rTr+)NNNNNNNN)rrtrsrtrrtrrrrtrrtr r+r r+rTr )rrrTrU)rrrTr)rrrTr)rrr r+rTr#)r)r&rr{rrSrrTrU)r,rrSrrTr-)rXrXr) r&rr4r5r/rr@rrSrrTr#)r&rrSrrTrU) r&rrBrr4rrSrrTr)>r __module__ __qualname____doc__r]rrrrrrr disconnectrHr4r?rDpropertyrFrrNrarpr|rzrrr<rrrrr$rrrrrrrsetterrrrrrrrrrrr"r%r+r3rDrHr;rOrr/ __classcell__)rs@rrRrRs&&555555n6666(1$1$1$1$j#'"&"&RV/3LLLLL\*E>E>E>E>N"4J  %)"& $()&*'+)N)N)N)N! )NV  #(&*'+ *E*E*E*E! *EXNNNN$$$X$3333"4444"  '+'+ 7777! 7r  '+'+ /;/;/;/;! /;f37".2 :   $37".2 BBBB! BH       # rrrr! rh  999! 9v !!"!:$#####   V V V!  V 3 3 3 3 A A A A ? ? ? ?  !%!"$!#S'S'S'S'! S'j777X7_   _     0000486:.C.C.C.C.C`VVVVV,X$("#'48%)&*&*'+ZZZZZx&&&&((((    !!!!::::   ;?&,&,&,&,! &,V"""""0  +++! +Z.0! ?????B    &++++Z    (    77777777rrR)irV __future__rrrrrrr"rdecimalriortypingrrrr r r r r rrrrrWr _decoratingr abstractsrauthenticationrr constantsrrrrrrr conversionrrr r!r"r#r$r%r&r'r(r)r*r+errorsr,r-r.r/r0r1r2r3r4r5r6r7networkr8r9r:opentelemetry.constantsr;!opentelemetry.context_propagationr<protocolr=rr>r?r@rArBrCrDrErFutilsrGrHrIrJrKrLrMrNopentelemetry.instrumentationrOrPrRrXrrrks>54""""""                             333333......????????'&&&&&                                                      AAAAAAAAAA111111GGGGGG######                      *))))))POOOOOOOOG7G7G7G7G7-G7G7G7G7G7r