"idZddlmZddlmZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl mZddlmZmZmZmZmZmZmZddlmZmZdd lmZdd lmZmZmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&dd l'm(Z(m)Z)dd l*m+Z+dd l,m-Z-m.Z.m/Z/m0Z0ddl1m2Z2ej3e45ej6ej3e4Z7Gdde2Z8dS)z/Implementing communication with MySQL servers. )Decimal)IOBaseN)get_auth_plugin) ClientFlag ServerCmd ServerFlag FieldType flag_is_set ShutdownTypeNET_BUFFER_LENGTH)errorsversion)MySQLConverter) CursorBase MySQLCursorMySQLCursorRawMySQLCursorBufferedMySQLCursorBufferedRawMySQLCursorPreparedMySQLCursorDictMySQLCursorBufferedDictMySQLCursorNamedTupleMySQLCursorBufferedNamedTuple)MySQLUnixSocketMySQLTCPSocket) MySQLProtocol) int1store int4storelc_int get_platform)MySQLConnectionAbstractceZdZdZfdZdZdZ dBdZdCd Zd Z d Z dDd Z d Z dZ dZeZ dEdZdFdZdZedZdZdZdZdZdGdZ dHdZdZdZdIdZdZd Zd!Z dDd"Z!d#Z"d$Z#d%Z$d&Z% dJd(Z&ed)Z'e'j(d*Z'd+Z)d,Z*dCd-Z+dKd/Z,dLd0Z-ed1Z. dMd2Z/d3Z0d4Z1d5Z2d6Z3d7Z4d8Z5dNd9Z6d:Z7dOd<Z8d=Z9d>Z:d?Z;d@ZS)PMySQLConnectionzConnection to a MySQL Servercd|_d|_d|_tt|j|i|t |_tj |_ d|_ 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|_(|r1 |j)d i|dS#|*d|_xYwdS) N-Fz 127.0.0.1i rTr)+ _protocol_socket _handshakesuperr$__init__r_converter_classr get_default _client_flags _charset_id _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_nfactorconnectclose)selfargskwargs __class__s R/srv/django_bis/venv311/lib/python3.11/site-packages/mysql/connector/connection.pyr-zMySQLConnection.__init__Es -ot$$-t>v>>> .'355         ""'#!& $$(!  &*#$(!&+#    &&v&&&&&  #   s 0 D??Ec 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|Sr()str).0xs rU z;MySQLConnection._add_default_conn_attrs..s666AQ666r)_pid _platform _source_host _client_name_client_license_client_version_osN) r!rLICENSEsplitr]osgetpidsocket gethostnamejoinVERSION _conn_attrsupdate)rQplatformlicense_chunksclient_licensedefault_conn_attrss rU_add_default_conn_attrsz'MySQLConnection._add_default_conn_attrs{s>> ..s33 !  ' '&NN)N $$!&)".004-"xx661!5666  I&    !355555rac|j}|ddkrtj|d|_ |j|}n8#t$r+}tj|j |j |j d}~wwxYw| |d|_ |dtjzsm|jdkrd}tj||jd rtjd d |xjtjzc_n!|js|xjtjzc_|dtjzr |tjg|dtjzr'd |_|tjg|dtjzr |tjg||_dS)z'Get the handshake from the MySQL serverN)msgerrnosqlstateserver_version_original capabilitiesmysql_clear_passwordzEClear password authentication is not supported over insecure channels verify_certz1SSL is required but the server doesn't support iti)r}T)r*recvr get_exceptionr+r)parse_handshake Exceptionget_mysql_exceptionr|r}r~_check_server_version_server_versionrSSLrIInterfaceErrorr=getr0 _ssl_disabled PLUGIN_AUTHset_client_flagsCLIENT_QUERY_ATTRIBUTESrLMULTI_FACTOR_AUTHENTICATION)rQpacket handshakeerrerr_msgs rU _do_handshakezMySQLConnection._do_handshakes#""$$ !9  &v.. . D66v>>II D D D, 69lDDD D D $99 / 0 2 2(:>9 1 $:::4+G444y}}]++ N+-AHLNNNN   :>/ 1   # 1   *. 0   ^ $z'= = <  ! !:#9": ; ; ; ^ $z'I I H*.D '  ! !:#E"F G G G ^ $z'M M L  ! !:#I"J K K K#sA B'&B  BNrr&c rd|_|tjzr|j||}|j||d)d|d} nd} |j |d|d|d |d pd|d pd| |d d |_|j r||j kr|j }t d|t d|j |j ds*|j drFtjdkr6|s4t#j}t d||j t d|t d||j|j||||||j|j | }|j|||||tjzs|r||d S)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. F)charset client_flagstls_ciphersuitesN:r'cacertkeyrverify_identity tls_versionsTz# _do_auth(): user: %sz## _do_auth(): self._auth_plugin: %sauthentication_ociauthentication_kerberosntz4MySQL user is empty, OS user: %s will be used for %sz# _do_auth(): password: %s rusernamepassworddatabaserr ssl_enabled auth_plugin conn_attrs)rHrrr) make_auth_sslr*sendrrp switch_to_ssl _password1_LOGGERdebugrI startswithrlnamegetpassgetuser make_authr+_auth_switch_requestCONNECT_WITH_DB cmd_init_db) rQrrrrr ssl_optionsrrrs rU_do_authzMySQLConnection._do_auths! *. ( $^11'?K2MMF L  f % % %122>#&88KOO'>'2u'='='2}'E'E'N'27H'I'I(-','7'2~'F'F H H H $D  ? 'x4?::H (( 4 4 4 5t7H J J J   ( ()= > > -   ) )*C D D - W__x_((H MMF$+ - - -  .999 2H===))o8,()! *## &!!! !!(H555z99 'x '   X & & &tracd}|jp |jd}td||j}|ddkr't |dkrtjd|ddkrZ|j |\}}t|||j ||j }||||}|dd kr|j |}t||||j }|d krI|}|r|j||j}|dd kr||S|dd kr||S|ddkrtj|dS)zHandle second part of authentication Raises NotSupportedError when we get the old, insecure password reply back. Raises any error coming from MySQL. Nrznew_auth_plugin: %srzzAuthentication with old (insecure) passwords is not supported. For more information, lookup Password Hashing in the latest MySQL manualrrrrrrcaching_sha2_passwordrr{)rIr+rrr*rlenrNotSupportedErrorr)parse_auth_switch_requestrr5rH_auth_continueparse_auth_more_data auth_responser _handle_ok _handle_mfar)rQrrauthnew_auth_pluginr auth_dataresponses rUrz$MySQLConnection._auth_switch_requests +Mt}/M +_===""$$ !9  F q 0 0*>?? ?AY#  .BB6JJ _ 3??33I*x!-///D(( JJF !9>>;;FCCI3??33H$:JLLLD"999--//0L%%h///**,, !9>>??6** * AY!^^##F++ + AY#  &v.. .trac|xjdz c_|jdkr|j}n'|jdkr|j}ntjdt d|j|j|dd\}}t|d|j ||j }| |||}|ddkr|j |}t||||j }|d krI|}|r|j||j}|dd kr||S|ddkr||S|dd krtj|dS) z#Handle Multi Factor Authentication.rrrbz5Failed Multi Factor Authentication (invalid N factor)z# MFA N Factor #%drzNrrrrr{)rN _password2 _password3rrrrr)parse_auth_next_factorrr5rHrrrr*rrrrr)rQrrrrrrs rUrzMySQLConnection._handle_mfa#s Q   ! !HH  ! # #HH'G   *D,=>>>"nCC 122J   ,{++ Z(     $$T;?? !9>>;;FCCI/?;//H$:JLLLD555--//0L%%h///**,, !9>>??6** * AY!^^##F++ + AY#  &v.. .tracj |dkr6td|||j}n|dkr1td|||}nU|dkr;td|j||j}n|}td|t ||j||j}td||dkrt |dkr|d d kr|dd kr|d d }| |}|j||j}|d d krB|dd kr6| |d d r|j}n|dkr|dkr|ddkryd }tdtd|d |dztdt |tdd} d} | s| d krtdd| dzdtd|td|d |dz| ||d \} } td| |j| pd|j}| dz } | s| d k| stj d| |td|t ||||d } td | t | |j| |j}td!||j}td"|n |dkr|ddkrd }td#td$|d |dztd%t |tdd} d} | s| d krtdd| dzdtd&|td'|d |dz| ||d \} } | r|j| | rnA|j}td(| | dz } | s| d k| s(tj d)| |td*|t ||j}td+||S),z!Continue with the authentication.authentication_ldap_sasl_clientz# auth_data: %sauthentication_kerberos_clientauthentication_oci_clientz!# oci configuration file path: %sz# request: %s size: %sz# server response packet: %srr=NvsGSSAPIrzr{z*# Continue with sasl GSSAPI authenticationz# response header: %srz# response size: %sz# Negotiate a service requestFrz%s Attempt %s %sz--------------------z<< server response: %sz# response code: %sz >> response to server: %srazLUnable to fulfill server request after %s attempts. Last server response: %sz0 last GSSAPI response from server: %s length: %dz* >> last response to server: %s length: %dz"<< final handshake from server: %sz<< ok packet from server: %sz%# Continue with GSSAPI authenticationz# Response header: %sz# Response size: %sz<< Server response: %sz# Response code: %sz>> Response to server: %szLUnable to fulfill server request after {} attempts. Last server response: {}z(Last response from server: %s length: %dz<< Ok packet from server: %s)rrrrJ_oci_config_filerr*rr auth_continue auth_finalizeauth_continue_krbrrauth_accept_close_handshakeformat)rQrrrrr dec_response cresponse rcode_sizecompletetriesstep last_steptokens rUrzMySQLConnection._auth_continueNs~ ; ; ; MM+Y 7 7 7))$*EFFHH < < < MM+Y 7 7 7)))44HH 7 7 7 MM3T5J   ))$*?@@HH))++H .#h--HHH (###""$$ 4f=== < < <F q  VAY#%5%5&)r//"!"":L**<88I L  i ( ( (\&&((FayCF1IOO%%fQRRj111!\..00F < < <Y&&6!9+;+;J MMF G G G MM16-:a<-3H I I I MM/V = = = MM9 : : :HE 5199 0(EAIxPPP 6??? 3VOZ!^O5LMMM!%!7!7z{{8K!L!Lh :DAAA !!$+#...**,,  5199 +/05v MMBF     88 9LMMI MM<I    L  i ( ( (\&&((F MM> G G G\&&((F MM8& A A A A ; ; ;q S  J MMA B B B MM16/:>/3J K K K MM/V = = = MM9 : : :HE 5199 &%!)X 6??? )6/:>/+B#'"4"4VJKK5H"I"Ix-L%%e,,,**,, 95AAA ! 5199$ +//5veV/D/D MM:F    \&&((F MM8& A A A racd}|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. Nr) unix_socket)hostport force_ipv6) rrlrrr server_host server_portr>set_connection_timeout_connection_timeout)rQprtclsconns rU_get_connectionzMySQLConnection._get_connectionsv   ?4"t/?@@@DD!t'7'+'7-1-=???D ##D$<=== rac |jdkrDtjdkr4|js-t |j}||_t |_||_ |j | | |j|j |j|j|j|j|j||j|jt*jzr,|j j|j _|j j|j _|j dn#|xYw|js|t=|j jdrdtA|j jj!rH|j j!}|dvr(d|d}tEj#|tHdSdSdSdSdS)zOpen the connection to the MySQL server This method sets up and opens the connection to the MySQL server. Raises on errors. rrNr)TLSv1zTLSv1.1zThis connection is using zZ which is now deprecated and will be removed in a future release of MySQL Connector/Python)%rIrlrr5rget_user_from_credentialsrr)rr*open_connectionrrr6r7r0r1r=rrset_converter_classr.rCOMPRESSrecv_compressedrsend_compressedrrrPrhasattrsockcallablerwarningswarnDeprecationWarning)rQcls tls_versionwarn_msgs rU_open_connectionz MySQLConnection._open_connections   @ @ @RWPT__: =%d&788 ::<< &++--   L ( ( * * *    MM$*dn.$*N)T%5 7 7 7  $ $T%: ; ; ;!J$77 A$(L$@ !$(L$@ ! L / / 5 5 5 5  JJLLL " < )955 <*233 < ,+3355K222- ---  h(:;;;;; < < < < < <32s =CEE4c|jsdS |jdS#ttjf$rYdSwxYw)z.Shut down connection to MySQL Server. N)r*shutdownAttributeErrorrErrorrQs rUrzMySQLConnection.shutdown s[|  F  L ! ! # # # # # -    DD s&AAc|jsdS |n#ttjf$rYnwxYw|jd|_dS)z Disconnect from the MySQL serverN)r*cmd_quitrrr close_connectionr+r s rUrPzMySQLConnection.closesk|  F  MMOOOO -    D  %%'''s  99Tc| |j|j||p|||n"#t $rt jdwxYw|sdS|jS)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. MySQL Connection not available.N) handle_unread_resultr*rr) make_commandrrOperationalErrorr)rQcommandargument packet_numberrexpect_responsecompressed_packet_numbers rU _send_cmdzMySQLConnection._send_cmd%s" !!### M L  ++GV5GxHH7 9 9 9 9 M M M)*KLL L M 4|  """s 7AA-Fc|t|dstd |tdz }|r9|j||tdz }|9n"#t$rtj dwxYw|r> |jdn"#t$rtj dwxYw|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 objectrra) rr ValueErrorrr r*rrrrr)rQ data_filesend_empty_packetbufs rU _send_datazMySQLConnection._send_dataCs8 !!###y&)) =;<< < M..!2R!788C = !!#&&&nn%6%;<< = M M M)*KLL L M  7 7 !!#&&&&! 7 7 7-5777 7|  """sABB-3CC-cttj||_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)r r MORE_RESULTS_EXISTSrDSTATUS_IN_TRANSrF)rQflagss rU_handle_server_statusz%MySQLConnection._handle_server_statuscs9"-Z-K-2"4"4*:+EuMMrac|jS)z'MySQL session has started a transaction)rFr s rUin_transactionzMySQLConnection.in_transactionns ##rac|ddkr7|j|}||d|S|ddkrtj|tjd)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, errors.InterfaceError will be raised. Returns a dict() rzr status_flagr{zExpected OK packet)r)parse_okr%rrr)rQrok_pkts rUrzMySQLConnection._handle_okssv !9>>^,,V44F  & &vm'< = = =M AY#  &v.. .#$8999rac|ddkr7|j|}||d|S|ddkrtj|tjd)a Handle 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, errors.InterfaceError will be raised. Returns a dict() rzrr)r{zExpected EOF packet)r) parse_eofr%rrr)rQreofs rU _handle_eofzMySQLConnection._handle_eofsx !9  .**622C  & &s='9 : : :J AY#  &v.. .#$9:::ractj|}tj|rt jd|js|jst jd|js|jrtj|j}d} tj ||g}nJ#t$r=}d}t j | t|||d}~wwxYw||kr*d}t j| || t|d}|||d |S#t$t&f$rYSwxYw#t$$rf |jd n"#t,$rt jd wxYwt j d |wxYw# |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 {}rbT)rrarzFile '{0}' could not be read)rlpathabspathislinkrr_allow_local_infile_allow_local_infile_in_path DatabaseError commonpathrrrr]openrr rPIOError NameErrorr*rr)rQfilename file_name infile_pathc_pathrrrs rU_handle_load_data_infilez(MySQLConnection._handle_load_data_infilesGOOH-- 7>>) $ $ Q)*OPP P' +/ +&*++ +' ;D,L ;'//$*JKKKF F++[),DEE F F F<+NN3s88Y DDFFF F $$;*NN9[99;;; Y--I??4??9EI$3$K$KLL !!!!Y'     B B B 7 !!#&&&&! 7 7 7-5777 7'.55i@@BB B B !!!!Y'    s~*!C D8DD9F-FF*)F*- H8GHG22+HH I"H76I7I I I  IcP|rt|dkrtjd|ddkr||S|ddkr1|dd}||S|ddkr||S|ddkrtj||j |}|rt|tstjd dg|z|_ td|D]A}|j|j|j|j |<B||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 errors.Error-exception will be raised. The dictionary returned of: - columns: column information - eof: the EOF-packet information Returns a dict() rzEmpty responserrNrr{Illegal result set.T)columnsr.)rrrrdecoderAr/rr)parse_column_count isinstanceintrMrange parse_columnr*rpython_charset unread_result)rQrr= column_countir.s rU_handle_resultzMySQLConnection._handle_results /Vq'(899 9 AY!^^??6** * AY#  abbz((**H00:: : AY#  ##F++ + AY#  &v.. .~88@@  ?:lC#@#@ ?'(=>> >"W|3q,'' : :A$(N$?$? !!##T%8%:%:D q ! !t|002233!-c:::racZ|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)countbinaryrFrawrN)get_rows)rQrTrFrUrowsr.s rUget_rowzMySQLConnection.get_rowsImm!FG(+$-- s  "GS> !c{rac* |j}jstjd |r2j}|dkrd}jj|||}n'jjj |}n #tj $r}d_|d}~wwxYw|\}} |s6|s4j -|r+tdrj j 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 available.utf8mb4utf8)rSF converterc2g|]}|jSr()rM)r^row row_to_pythonrQs rUr`z,MySQLConnection.get_rows.. s(KKKsMM#t'9::KKKrar) server_status)rErNr InternalErrorrr)read_binary_resultr*read_text_resultrr rMrr\r_r%) rQrSrTrFrU prep_stmtrrWreof_pr_s ` @rUrVzMySQLConnection.get_rowss ;)C! C&'ABB B  D,i''$G~88L'5';;~66t|7;7K=B7DD|   !&D I  e L# L4#5#Ad#At[))$B N8MKKKKKdKKKD    & &}',@-@-u]';';272H J J J!&D U{sABB! BB!c@|jr|dSdS)zConsume results N)rNrVr s rUconsume_resultszMySQLConnection.consume_results)s*    MMOOOOO  rac||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)rrrINIT_DBencode)rQrs rUrzMySQLConnection.cmd_init_db/s= NN9,hoog.F.F G GII Irac  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| \}}}| |nt| trU| |} | t-t| | zt"j}nt| t0r@| t-t| | zt"j}nt| t4r| t-tt| |t| |zt"j}n.t| t8r5| t;jd | t"j}nt| t@j t@j!fr3|j"| \}}| |nt| t@j#t@j$fr3|j%| \}}| |n2tMj'd (| j)j* |t!|t!|z| d|}|t-t||z|+t-t|j|+t-d | r|+d,d| Dt!d zt[||D]/\}}|+||+|0| D]} |+| |+|t1|} |.|/t`j1|}nB#tLj'$r0}|j2dkrd|j3vrd}tMj4|d }~wwxYw|j5rtMj6d|S)a Send a query to the MySQL server This method send the query to the MySQL server and returns the result. If there was a text result, a tuple will be returned consisting of the number of columns and a list containing information about these columns. When the query doesn't return a text result, the OK or EOF packet information as dictionary will be returned. In case the result was an error, exception errors.Error will be raised. Returns a tuple() rirZr[.s$KKKfk#s33KKKrailzLoading local data is disabledr1z8Use cmd_query_iter for statements with multiple queries.)7rI bytearrayr]rkrrL _query_attrsrrWarningr0rrr enumerateappendrr NULLrJr)_prepare_binary_integerr VARCHARbytesBLOBrDECIMALfloatrurvDOUBLEdatetimedate_prepare_binary_timestamp timedeltatime_prepare_binary_timerProgrammingErrorrrT__name__extendrpziprQrrQUERYr}r|r8rDr)rQqueryrUbuffered raw_as_stringrrnamestypesvalues null_bitmappos attr_tuplevaluer$packed field_typer_typeresultrrs rU cmd_queryzMySQLConnection.cmd_query;s%++ %%%% . W--e$$E"&,)";";$,,* "t/@ " MN  " " " "   B B@ )EEF##d&7"8"81"<!BCK#,T->#?#?+ 7+ 7Z"1 =+++qS1W~=+++LL9>!:!:!*5!1!1"2333s++A"nDDUKKVZMM&))))s++A!LL11EMM&U"4"4u"<===!*!2JJu--AMM&U"4"4u"<===!*JJw//AMMs3u::#4#4#$%$% & &''),U):):7)C)CDEEE"+!2JJu--AMM&+dE":":;;;!*!1JJ(98='IJJ A~??FF)VZMM&))))(:HM'JKKA~::5AA)VZMM&)))) 1006&+o&>171@1@AAA Yz22&u--.///!!}++G44 VCII..56666 MM&T%6!7!788 9 9 9 MM&)) $ $ $ ) HHKK{KKKLLaLL!"""$'ue#4#4((KE4MM%(((MM$''''#))EMM%(((( ef  (( )O)OPPFF&   yD  /37::8*7333     ! L'JLL L s53W))X(8+X##X(c#Kt}t|ts9t|tr|d}t|}|jt jzrD|td|td||t|}| | tj |V|jrK|| |jV|jIdSdS)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[rrN)rxrIr]rkr0rrrr rrQrrrrDrr*r)rQ statementsrrs rUcmd_query_iterzMySQLConnection.cmd_query_itersI"*i00 /*c** 7'..v66 ":..J   B B % MM&)) $ $ $ MM&)) $ $ $ j!!!f !!$..%"H"HIIIII$ ;  % % ' ' '%%dl&7&7&9&9:: : : :$ ; ; ; ; ;rac||tjt |S)aSend the Refresh command to the MySQL server This method sends the Refresh command to the MySQL server. The options argument should be a bitwise value using constants.RefreshOption. Usage example: RefreshOption = mysql.connector.RefreshOption refresh = RefreshOption.LOG | RefreshOption.THREADS cnx.cmd_refresh(refresh) The result is a dictionary with the OK packet information. Returns a dict() )rrrREFRESHr)rQoptionss rU cmd_refreshzMySQLConnection.cmd_refreshs9 NN9,i.@.@ A ACC Crac||jtj}|j|dd|S)aClose the current connection with the server This method sends the QUIT command to the MySQL server, closing the current connection. Since the no response can be returned to the client, cmd_quit() will return the packet it send. Returns a str() r)rr)rrQUITr*rrQrs rUr zMySQLConnection.cmd_quitsL !!###,,Y^<< &!Q''' rac|r+tj|stjd|}n tj}||tjt|S)aZShut down the MySQL Server This method sends the SHUTDOWN command to the MySQL server and is only possible if the current user has SUPER privileges. The result is a dictionary containing the OK packet information. Note: Most applications and scripts do not the SUPER privilege. Returns a dict() zInvalid shutdown type) r get_inforrSHUTDOWN_DEFAULTr/rrSHUTDOWNr)rQ shutdown_typeatypes rU cmd_shutdownzMySQLConnection.cmd_shutdowns~  2(77 E+,CDDD!EE 1Ey/A/8/?/?!A!ABB Brac ||jtj}|j|dd|j|jS)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) rr)rr STATISTICSr*rparse_statisticsrrs rUcmd_statisticszMySQLConnection.cmd_statisticssl !!###,,Y-ABB &!Q'''~..t|/@/@/B/BCCCrac||tjt |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. Returns a dict() )rrr PROCESS_KILLr)rQ mysql_pids rUcmd_process_killz MySQLConnection.cmd_process_kills9 NN919Y3G3G H HJJ Jracf||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() )r/rrDEBUGr s rU cmd_debugzMySQLConnection.cmd_debugs&y ? ?@@@racf||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() )rrrPINGr s rUcmd_pingzMySQLConnection.cmd_ping*s$t~~in==>>>rar'c td|_||_||_||_||_||_|jr||jkr|j}||jrtj d|j |j |||||j |j|j|j } |j| dd|r||_|||} |j t*jzs|r||n#xYw||_|| 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() rz.Change user is not supported with compression.rr)rNr5r6rrrr _compressrrr)make_change_userr+r0rHrIrrr*rrrrrrr1_post_connection) rQrrrr password1 password2 password3oci_config_filer ok_packets rUcmd_change_userzMySQLConnection.cmd_change_user5sf !### ? 'x4?::H !!### > ;*,:;; ;00o8$*<()' 1)) &!Q'''  4$3D !--hAA  &)CC +  +  ***  " s ++DDc8|ddS)zGet the current databasezSELECT DATABASE()r) info_queryr s rUrzMySQLConnection.databasehs233A66rac6|d|zdS)zSet the current databasezUSE %sN)r)rQrs rUrzMySQLConnection.databasems! x%'(((((racB |n#YdSxYwdS)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 s rU is_connectedzMySQLConnection.is_connectedrs+  MMOOOO 55tsc||_dS)zJset local_infile_in_path Set allow_local_infile_in_path. N)r7)rQr3s rUset_allow_local_infile_in_pathz.MySQLConnection.set_allow_local_infile_in_paths ,0(((rac |stjd|so ||j|j|j|j|j |j |j |j n)#tj $r|YnwxYw|}|rD|D]/\}}|d||f0|rD|D]1\}}|d||f0dSdS)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. rzSET @`{0}` = %szSET SESSION `{0}` = %sN)rrrcmd_reset_connectionrr5r6r7r1rrrrr reconnectcursoritemsexecuter)rQuser_variablessession_variablescurrrs rU reset_sessionzMySQLConnection.reset_sessions   "" M)*KLL L((** ! !$$TZ%)^T5E%)_do%)_%)%: <<<< * ! ! !      !kkmm  E,2244 E E U -44S99E8DDDD  L/5577 L L U 4;;C@@5(KKKK L L L LsAB#B)(B)rcd}||kr|dz} |||rdSnT#t$rG}||kr7d|t |}t j|Yd}~nd}~wwxYw|dkrtj |||kdSdS)aAttempt to reconnect to the MySQL server The argument attempts should be the number of times a reconnect is tried. The delay argument is the number of seconds to wait between each retry. You may want to set the number of attempts higher and use delay when you expect the MySQL server to be down for maintenance or when you expect the network to be temporary unavailable. Raises InterfaceError on errors. rrz4Can not reconnect to MySQL after {0} attempt(s): {1}N) disconnectrOrrrr]rrrsleep)rQattemptsdelaycounterrr|s rUrzMySQLConnection.reconnects!!kG 5!!! $$&&E 5 5 5h&&,,2F8SXX,F,F /444'&&&& 5 qyy 5!!!!!!!!!s>>>>>+->???sA A cH|jr|jdSdS)zMySQL connection IDserver_threadidN)r+rr s rU connection_idzMySQLConnection.connection_ids* ? :?&&'899 9trac  ||stjd|4t |t stjd||S||n|j}||n|j}d |dur dz |dur dz |dur dz |dur d z |dur d z tttttttt t"d } | |S#t$$rBd t'd d fdt+dDzwxYw)aInstantiates 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.CursorBase. Raises ProgrammingError when cursor_class is not a subclass of CursorBase. Raises ValueError when cursor is not available. Returns a cursor-object rNz6Cursor class needs be to subclass of cursor.CursorBaserTrrrzrqr) rrrrbrzrrq r)rrU dictionary named_tuplepreparedz*Cursor not available with given criteria: z, c8g|]}d|zzdk|Srrr()r^rPrR cursor_types rUr`z*MySQLConnection.cursor..&s=(H(H(HA+6!q&+AQ+F+F)-Q+F+F+Frar)rrrr issubclassrrrBrErrrrrrrrrKeyErrorrrprK) rQrrUr cursor_classrrrrRrs @@rUrzMySQLConnection.cursors* !!###  "" M)*KLL L  #lJ77 N-LNNN L$'' ''388_cc$) t   1 K $;; 1 K    1 K $   1 K t   2 K"%&$,#    J&E+&-- - J J JODI!YY(H(H(H(H(Hq(H(H(HIIIJJ J Js 4DA Ec0|ddS)zCommit current transactionCOMMITN)_execute_queryr s rUcommitzMySQLConnection.commit)s H%%%%%racf|jr||ddS)zRollback current transactionROLLBACKN)rNrVrr s rUrollbackzMySQLConnection.rollback-s4    MMOOO J'''''racX|||dS)a Execute a query This method simply calls cmd_query() after checking for unread result. If there are still unread result, an errors.InterfaceError is raised. Otherwise whatever cmd_query() returns is returned. Returns a dict() N)rr)rQrs rUrzMySQLConnection._execute_query4s. !!### urac|d}|||S)z%Send a query which only returns 1 rowT)r)rrfetchone)rQrrs rUrzMySQLConnection.info_query@s7d++u   rac|ddkr|j|S|ddkrtj|tjd)aEHandle 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, errors.InterfaceError will be raised. Returns a dict() rzrr{zExpected Binary OK packet)r)parse_binary_prepare_okrrrrs rU_handle_binary_okz!MySQLConnection._handle_binary_okFsY !9>>>99&AA A AY#  &v.. .#$?@@@rac|rt|dkrtjd|ddkr||S|ddkr||S|ddkrtj||j|}|rt|tstjddg|z}td|D]<}|j |j |j||<=||j }|||fS)a Handle 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 errors.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() rzrCrrr{rEN)rrrrr/rr)rHrIrJrKrLr*rrM)rQrrOrFrPr.s rU_handle_binary_resultz%MySQLConnection._handle_binary_resultVsX /Vq'(899 9 AY!^^??6** * AY#  ##F++ + AY#  &v.. .~88@@  ?:lC#@#@ ?'(=>> >&<'q,'' : :A44 !!##T%8::GAJJt|002233gs++rac|j||}d|_|tj|dd|_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. FrTN)r)make_stmt_fetchrNrr STMT_FETCH)rQ statement_idrWrs rUcmd_stmt_fetchzMySQLConnection.cmd_stmt_fetch{sL // dCC" y+VUKKK!rac|tj|}||}g|d<g|d<|ddkrt d|dD]R}|d|j|j |j S| |j |ddkrt d|dD]R}|d|j|j |j S| |j |S)zPrepare a MySQL statement This method will send the PREPARE command to MySQL together with the given statement. Returns a dict() rF parameters num_paramsr num_columns) rr STMT_PREPARErrKr|r)rLr*rrMr/)rQ statementrr_s rUcmd_stmt_preparez MySQLConnection.cmd_stmt_prepares 6 BB''//y!| , ! # #1f\233 F F|$++N// 0A0A0C0C040CEEFFFF   T\..00 1 1 1 - 1 $ $1f]344 F Fy!((N// 0A0A0C0C040CEEFFFF   T\..00 1 1 1 rar(c t|}i}|rvt|D]f\}}t||trFd} d||jv}n#t $rYnwxYw||||||f||<g|js"|jrtj dt|j tjzr>|j||t#||||j|j|j} n8|j||t#||||j|j} |t*j| } || } | S)z"Execute a prepared MySQL statementTbrmrn)converter_str_fallback)r)listr{rIrmodercmd_stmt_send_long_datarLryrrrzr0rrr)make_stmt_executetupler_converter_str_fallbackrr STMT_EXECUTEr) rQrdatarr$long_data_usedparam_idr rTexecute_packetrrs rUcmd_stmt_executez MySQLConnection.cmd_stmt_executes*%%   9(44 9 9 !d8nf559!F!$DN,?!?)00x15hAAA06yN8,* "t/@ " MN  " " " "   B B E!^==dE*$5$5u d.?,..NN "^==dE*$5$5u '+'C>EEN 6~NN++F33 sA A#"A#cd|tjt|ddS)zDeallocate a prepared MySQL statement This method deallocates the prepared statement using the statement_id. Note that the MySQL server does not return anything. FrN)rr STMT_CLOSErrQrs rUcmd_stmt_closezMySQLConnection.cmd_stmt_closes; y+Y|-D-D',  . . . . .racLd}d}|jj} ||}|rX||||}|tj|d|t |z }||}|Xn"#t$rtj dwxYw|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. i rF)rrr) r)_prepare_stmt_send_long_datarrrSTMT_SEND_LONG_DATArrrr) rQrrr chunk_size total_sentprepare_packetrrs rUrz'MySQLConnection.cmd_stmt_send_long_datas"  D M))J''C ,' hDDy'>@@ A A A A Arac ||tj|dS#t jt jf$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)rrrRESET_CONNECTIONrrrrr s rUrz$MySQLConnection.cmd_reset_connectionsl  OODNN9+EFF G G G  ! ! # # #4(&*AB   55 sAA A)(A)cv|jr|dS|jrtjddS)z'Check whether there is an unread resultzUnread result foundN)can_consume_resultsrgrNrrar s rUrz$MySQLConnection.handle_unread_result sL  # >  " " " " "   >&'<== = > >ra)NNNrr&NN)NN)N)NrNTr)F)FNN)NFNNN)FFF)r'r'r'r&r'r'r'r'r)Frr)NNNNNN)r)r(r(r)?r __module__ __qualname____doc__r-rxrrrrrrrrrPrrr r%propertyr'rr/rArQrXrVrgrrrrr rrrrrrrsetterrrrrrrrrrrrrrrr rrrr'rr __classcell__)rTs@rUr$r$Csn&&44444l666,'$'$'$R?CJN====~((((T)))V||||&+<+<+>>>>>>rar$)9r.decimalriorrrloggingrlrnrurrauthenticationr constantsrrr r r r r r'rr conversionrrrrrrrrrrrrnetworkrrprotocolrutilsrrr r! abstractsr" getLoggerr addHandler NullHandlerrr$r(rarUr?so: ++++++ &&&&&&######################## 54444444######============......(&&':w':'<'<=== ' H % %L>L>L>L>L>-L>L>L>L>L>ra