psycopg2/doc/api/private/psycopg2.psycopg1.connection-class.html

   1 <?xml version="1.0" encoding="utf-8"?>\r
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"\r
   3           "DTD/xhtml1-transitional.dtd">\r
   4 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">\r
   5 <head>\r
   6   <title>psycopg2.psycopg1.connection</title>\r
   7   <link rel="stylesheet" href="epydoc.css" type="text/css" />\r
   8 <script type="text/javascript">\r
   9 <!--\r
  10 function setFrame(url1, url2){\r
  11     parent.frames[1].location.href = url1;\r
  12     parent.frames[2].location.href = url2;\r
  13 }\r
  14 -->\r
  15 </script>\r
  16 </head>\r
  17 <body bgcolor="white" text="black" link="blue" vlink="#204080"\r
  18       alink="#204080">\r
  19 \r
  20 <!-- =========== START OF NAVBAR =========== -->\r
  21 <table class="navbar" border="0" width="100%" cellpadding="0" bgcolor="#a0c0ff" cellspacing="0">\r
  22   <tr valign="middle">\r
  23     <th class="navbar">&nbsp;&nbsp;&nbsp;<a class="navbar" href="psycopg2-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>\r
  24     <th class="navbar">&nbsp;&nbsp;&nbsp;<a class="navbar" href="trees.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>\r
  25     <th class="navbar">&nbsp;&nbsp;&nbsp;<a class="navbar" href="indices.html">Index</a>&nbsp;&nbsp;&nbsp;</th>\r
  26     <th class="navbar">&nbsp;&nbsp;&nbsp;<a class="navbar" href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>\r
  27     <th class="navbar" width="100%"></th>\r
  28   </tr>\r
  29 </table>\r
  30 <table width="100%" cellpadding="0" cellspacing="0">\r
  31   <tr valign="top">\r
  32     <td width="100%">\r
  33       <span class="breadcrumbs">\r
  34         <a href="psycopg2-module.html">Package&nbsp;psycopg2</a> ::\r
  35         <a href="psycopg2.psycopg1-module.html">Module&nbsp;psycopg1</a> ::\r
  36         Class&nbsp;connection\r
  37       </span><br />\r
  38     </td>\r
  39     <td><table cellpadding="0" cellspacing="0">\r
  40       <tr><td align="right"><span class="options">[show&nbsp;private&nbsp;|&nbsp;<a href="../public/psycopg2.psycopg1.connection-class.html">hide&nbsp;private</a>]</span></td></tr>\r
  41       <tr><td align="right"><span class="options">[<a href="frames.html" target="_top">frames</a>&nbsp;|&nbsp;<a href="psycopg2.psycopg1.connection-class.html" target="_top">no&nbsp;frames</a>]</span></td></tr>\r
  42     </table></td>\r
  43 </tr></table>\r
  44 \r
  45 <!-- =========== START OF CLASS DESCRIPTION =========== -->\r
  46 <h2 class="class">Type connection</h2>\r
  47 \r
  48 <pre class="base-tree">\r
  49 <a href="__builtin__.object-class.html"><code>object</code></a> --+    \r
  50          |    \r
  51 <a href="../private/psycopg2._psycopg.connection-class.html"><code>connection</code></a> --+\r
  52              |\r
  53             <strong class="uidshort">connection</strong>\r
  54 </pre><br />\r
  55 \r
  56 <hr/>\r
  57 \r
  58 <p>psycopg 1.1.x connection.</p>\r
  59 <hr/>\r
  60 \r
  61 \r
  62 <!-- =========== START OF METHOD SUMMARY =========== -->\r
  63 <table class="summary" border="1" cellpadding="3" cellspacing="0" width="100%" bgcolor="white">\r
  64 <tr bgcolor="#70b0f0" class="summary">\r
  65   <th colspan="2">Method Summary</th></tr>\r
  66 <tr><td align="right" valign="top" width="15%" class="rtype">switch autocommit on (1) or off (0)</td>\r
  67   <td><code><a name="autocommit"></a><span class="summary-sig"><span class="summary-sig-name">autocommit</span>(<span class="summary-sig-arg">on_off</span>)</span></code>\r
  68 </td></tr>\r
  69 <tr><td align="right" valign="top" width="15%" class="rtype">new psycopg 1.1.x compatible cursor object</td>\r
  70   <td><code><a name="cursor"></a><span class="summary-sig"><span class="summary-sig-name">cursor</span>()</span></code>\r
  71 </td></tr>\r
  72 <tr bgcolor="#e8f0f8" class="group">\r
  73   <th colspan="2">&nbsp;&nbsp;&nbsp;&nbsp;Inherited from connection</th></tr>\r
  74 <tr><td align="right" valign="top" width="15%" class="rtype">&nbsp;</td>\r
  75   <td><code><span class="summary-sig"><a href="../private/psycopg2._psycopg.connection-class.html#__init__" class="summary-sig-name"><code>__init__</code></a>(<span class="summary-sig-vararg">...</span>)</span></code>\r
  76 <br />\r
  77 x.__init__(...) initializes x; see x.__class__.__doc__ for signature</td></tr>\r
  78 <tr><td align="right" valign="top" width="15%" class="rtype">&nbsp;</td>\r
  79   <td><code><span class="summary-sig"><a href="../private/psycopg2._psycopg.connection-class.html#__new__" class="summary-sig-name"><code>__new__</code></a>(<span class="summary-sig-arg">T</span>,\r
  80           <span class="summary-sig-arg">S</span>,\r
  81           <span class="summary-sig-vararg">...</span>)</span></code>\r
  82 <br />\r
  83 Return a new object with type S, a subtype of T...</td></tr>\r
  84 <tr><td align="right" valign="top" width="15%" class="rtype">&nbsp;</td>\r
  85   <td><code><span class="summary-sig"><a href="../private/psycopg2._psycopg.connection-class.html#__repr__" class="summary-sig-name"><code>__repr__</code></a>(<span class="summary-sig-arg">x</span>)</span></code>\r
  86 <br />\r
  87 Return repr(x)...</td></tr>\r
  88 <tr><td align="right" valign="top" width="15%" class="rtype">&nbsp;</td>\r
  89   <td><code><span class="summary-sig"><a href="../private/psycopg2._psycopg.connection-class.html#__str__" class="summary-sig-name"><code>__str__</code></a>(<span class="summary-sig-arg">x</span>)</span></code>\r
  90 <br />\r
  91 Return str(x)...</td></tr>\r
  92 <tr><td align="right" valign="top" width="15%" class="rtype">&nbsp;</td>\r
  93   <td><code><span class="summary-sig"><a href="../private/psycopg2._psycopg.connection-class.html#close" class="summary-sig-name"><code>close</code></a>()</span></code>\r
  94 <br />\r
  95 Close the connection.</td></tr>\r
  96 <tr><td align="right" valign="top" width="15%" class="rtype">&nbsp;</td>\r
  97   <td><code><span class="summary-sig"><a href="../private/psycopg2._psycopg.connection-class.html#commit" class="summary-sig-name"><code>commit</code></a>()</span></code>\r
  98 <br />\r
  99 Commit all changes to database.</td></tr>\r
 100 <tr><td align="right" valign="top" width="15%" class="rtype">&nbsp;</td>\r
 101   <td><code><span class="summary-sig"><a href="../private/psycopg2._psycopg.connection-class.html#rollback" class="summary-sig-name"><code>rollback</code></a>()</span></code>\r
 102 <br />\r
 103 Roll back all changes done to database.</td></tr>\r
 104 <tr><td align="right" valign="top" width="15%" class="rtype">&nbsp;</td>\r
 105   <td><code><span class="summary-sig"><a href="../private/psycopg2._psycopg.connection-class.html#set_client_encoding" class="summary-sig-name"><code>set_client_encoding</code></a>(<span class="summary-sig-arg">encoding</span>)</span></code>\r
 106 <br />\r
 107 Set client encoding to <tt class="docutils literal docutils literal docutils literal docutils literal"><span class="pre">encoding</span></tt>.</td></tr>\r
 108 <tr><td align="right" valign="top" width="15%" class="rtype">&nbsp;</td>\r
 109   <td><code><span class="summary-sig"><a href="../private/psycopg2._psycopg.connection-class.html#set_isolation_level" class="summary-sig-name"><code>set_isolation_level</code></a>(<span class="summary-sig-arg">level</span>)</span></code>\r
 110 <br />\r
 111 Switch isolation level to <tt class="docutils literal docutils literal docutils literal docutils literal"><span class="pre">level</span></tt>.</td></tr>\r
 112 <tr bgcolor="#e8f0f8" class="group">\r
 113   <th colspan="2">&nbsp;&nbsp;&nbsp;&nbsp;Inherited from object</th></tr>\r
 114 <tr><td align="right" valign="top" width="15%" class="rtype">&nbsp;</td>\r
 115   <td><code><span class="summary-sig"><a href="__builtin__.object-class.html#__delattr__" class="summary-sig-name"><code>__delattr__</code></a>(<span class="summary-sig-vararg">...</span>)</span></code>\r
 116 <br />\r
 117 x.__delattr__('name') &lt;==&gt; del x.name</td></tr>\r
 118 <tr><td align="right" valign="top" width="15%" class="rtype">&nbsp;</td>\r
 119   <td><code><span class="summary-sig"><a href="__builtin__.object-class.html#__getattribute__" class="summary-sig-name"><code>__getattribute__</code></a>(<span class="summary-sig-vararg">...</span>)</span></code>\r
 120 <br />\r
 121 x.__getattribute__('name') &lt;==&gt; x.name</td></tr>\r
 122 <tr><td align="right" valign="top" width="15%" class="rtype">&nbsp;</td>\r
 123   <td><code><span class="summary-sig"><a href="__builtin__.object-class.html#__hash__" class="summary-sig-name"><code>__hash__</code></a>(<span class="summary-sig-arg">x</span>)</span></code>\r
 124 <br />\r
 125 Return hash(x)...</td></tr>\r
 126 <tr><td align="right" valign="top" width="15%" class="rtype">&nbsp;</td>\r
 127   <td><code><span class="summary-sig"><a href="__builtin__.object-class.html#__reduce__" class="summary-sig-name"><code>__reduce__</code></a>(<span class="summary-sig-vararg">...</span>)</span></code>\r
 128 <br />\r
 129 helper for pickle</td></tr>\r
 130 <tr><td align="right" valign="top" width="15%" class="rtype">&nbsp;</td>\r
 131   <td><code><span class="summary-sig"><a href="__builtin__.object-class.html#__reduce_ex__" class="summary-sig-name"><code>__reduce_ex__</code></a>(<span class="summary-sig-vararg">...</span>)</span></code>\r
 132 <br />\r
 133 helper for pickle</td></tr>\r
 134 <tr><td align="right" valign="top" width="15%" class="rtype">&nbsp;</td>\r
 135   <td><code><span class="summary-sig"><a href="__builtin__.object-class.html#__setattr__" class="summary-sig-name"><code>__setattr__</code></a>(<span class="summary-sig-vararg">...</span>)</span></code>\r
 136 <br />\r
 137 x.__setattr__('name', value) &lt;==&gt; x.name = value</td></tr>\r
 138 </table><br />\r
 139 \r
 140 \r
 141 <!-- =========== START OF PROPERTY SUMMARY =========== -->\r
 142 <table class="summary" border="1" cellpadding="3" cellspacing="0" width="100%" bgcolor="white">\r
 143 <tr bgcolor="#70b0f0" class="summary">\r
 144   <th colspan="2">Property Summary</th></tr>\r
 145 <tr bgcolor="#e8f0f8" class="group">\r
 146   <th colspan="2">&nbsp;&nbsp;&nbsp;&nbsp;Inherited from connection</th></tr>\r
 147 <tr><td align="right" valign="top" width="15%" class="ptype">&nbsp;</td>\r
 148   <td><strong><a href="../private/psycopg2._psycopg.connection-class.html#closed"><code>closed</code></a></strong>: True if the connection is closed.</td></tr><tr><td align="right" valign="top" width="15%" class="ptype">&nbsp;</td>\r
 149   <td><strong><a href="../private/psycopg2._psycopg.connection-class.html#DatabaseError"><code>DatabaseError</code></a></strong>: Error related to the database engine.</td></tr><tr><td align="right" valign="top" width="15%" class="ptype">&nbsp;</td>\r
 150   <td><strong><a href="../private/psycopg2._psycopg.connection-class.html#DataError"><code>DataError</code></a></strong>: Error related to problems with the processed data.</td></tr><tr><td align="right" valign="top" width="15%" class="ptype">&nbsp;</td>\r
 151   <td><strong><a href="../private/psycopg2._psycopg.connection-class.html#dsn"><code>dsn</code></a></strong>: The current connection string.</td></tr><tr><td align="right" valign="top" width="15%" class="ptype">&nbsp;</td>\r
 152   <td><strong><a href="../private/psycopg2._psycopg.connection-class.html#encoding"><code>encoding</code></a></strong>: The current client encoding.</td></tr><tr><td align="right" valign="top" width="15%" class="ptype">&nbsp;</td>\r
 153   <td><strong><a href="../private/psycopg2._psycopg.connection-class.html#Error"><code>Error</code></a></strong>: Base class for error exceptions.</td></tr><tr><td align="right" valign="top" width="15%" class="ptype">&nbsp;</td>\r
 154   <td><strong><a href="../private/psycopg2._psycopg.connection-class.html#IntegrityError"><code>IntegrityError</code></a></strong>: Error related to database integrity.</td></tr><tr><td align="right" valign="top" width="15%" class="ptype">&nbsp;</td>\r
 155   <td><strong><a href="../private/psycopg2._psycopg.connection-class.html#InterfaceError"><code>InterfaceError</code></a></strong>: Error related to the database interface.</td></tr><tr><td align="right" valign="top" width="15%" class="ptype">&nbsp;</td>\r
 156   <td><strong><a href="../private/psycopg2._psycopg.connection-class.html#InternalError"><code>InternalError</code></a></strong>: The database encountered an internal error.</td></tr><tr><td align="right" valign="top" width="15%" class="ptype">&nbsp;</td>\r
 157   <td><strong><a href="../private/psycopg2._psycopg.connection-class.html#isolation_level"><code>isolation_level</code></a></strong>: The current isolation level.</td></tr><tr><td align="right" valign="top" width="15%" class="ptype">&nbsp;</td>\r
 158   <td><strong><a href="../private/psycopg2._psycopg.connection-class.html#notices"><code>notices</code></a></strong></td></tr><tr><td align="right" valign="top" width="15%" class="ptype">&nbsp;</td>\r
 159   <td><strong><a href="../private/psycopg2._psycopg.connection-class.html#notifies"><code>notifies</code></a></strong></td></tr><tr><td align="right" valign="top" width="15%" class="ptype">&nbsp;</td>\r
 160   <td><strong><a href="../private/psycopg2._psycopg.connection-class.html#NotSupportedError"><code>NotSupportedError</code></a></strong>: A not supported datbase API was called.</td></tr><tr><td align="right" valign="top" width="15%" class="ptype">&nbsp;</td>\r
 161   <td><strong><a href="../private/psycopg2._psycopg.connection-class.html#OperationalError"><code>OperationalError</code></a></strong>: Error related to database operation (disconnect, memory allocation etc).</td></tr><tr><td align="right" valign="top" width="15%" class="ptype">&nbsp;</td>\r
 162   <td><strong><a href="../private/psycopg2._psycopg.connection-class.html#ProgrammingError"><code>ProgrammingError</code></a></strong>: Error related to database programming (SQL error, table not found etc).</td></tr><tr><td align="right" valign="top" width="15%" class="ptype">&nbsp;</td>\r
 163   <td><strong><a href="../private/psycopg2._psycopg.connection-class.html#Warning"><code>Warning</code></a></strong>: A database warning.</td></tr></table><br />\r
 164 \r
 165 \r
 166 <!-- =========== START OF METHOD DETAILS =========== -->\r
 167 <table class="details" border="1" cellpadding="3" cellspacing="0" width="100%" bgcolor="white">\r
 168 <tr bgcolor="#70b0f0" class="details">\r
 169   <th colspan="2">Method Details</th></tr>\r
 170 </table>\r
 171 \r
 172 <a name="autocommit"></a>\r
 173 <table width="100%" class="func-details" bgcolor="#e0e0e0"><tr><td>\r
 174   <h3><span class="sig"><span class="sig-name">autocommit</span>(<span class="sig-arg">on_off</span>=<span class="sig-default">1</span>)</span>\r
 175   </h3>\r
 176   <dl><dt></dt><dd>\r
 177     <dl><dt>Returns:</dt>\r
 178       <dd>\r
 179 switch autocommit on (1) or off (0)      </dd>\r
 180     </dl>\r
 181   </dd></dl>\r
 182 </td></tr></table>\r
 183 \r
 184 <a name="cursor"></a>\r
 185 <table width="100%" class="func-details" bgcolor="#e0e0e0"><tr><td>\r
 186   <h3><span class="sig"><span class="sig-name">cursor</span>()</span>\r
 187   </h3>\r
 188   <dl><dt></dt><dd>\r
 189     <dl><dt>Returns:</dt>\r
 190       <dd>\r
 191 new psycopg 1.1.x compatible cursor object      </dd>\r
 192     </dl>\r
 193     <dl><dt>Overrides:</dt>\r
 194       <dd><a href="../private/psycopg2._psycopg.connection-class.html#cursor"><code>psycopg2._psycopg.connection.cursor</code></a></dd>\r
 195     </dl>\r
 196   </dd></dl>\r
 197 </td></tr></table>\r
 198 <br />\r
 199 \r
 200 \r
 201 <!-- =========== START OF NAVBAR =========== -->\r
 202 <table class="navbar" border="0" width="100%" cellpadding="0" bgcolor="#a0c0ff" cellspacing="0">\r
 203   <tr valign="middle">\r
 204     <th class="navbar">&nbsp;&nbsp;&nbsp;<a class="navbar" href="psycopg2-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>\r
 205     <th class="navbar">&nbsp;&nbsp;&nbsp;<a class="navbar" href="trees.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>\r
 206     <th class="navbar">&nbsp;&nbsp;&nbsp;<a class="navbar" href="indices.html">Index</a>&nbsp;&nbsp;&nbsp;</th>\r
 207     <th class="navbar">&nbsp;&nbsp;&nbsp;<a class="navbar" href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>\r
 208     <th class="navbar" width="100%"></th>\r
 209   </tr>\r
 210 </table>\r
 211 \r
 212 <table border="0" cellpadding="0" cellspacing="0" width="100%">\r
 213   <tr>\r
 214     <td align="left" class="footer">Generated by Epydoc 2.1 on Sat Jan 14 01:42:36 2006</td>\r
 215     <td align="right" class="footer">\r
 216       <a href="http://epydoc.sourceforge.net">http://epydoc.sf.net</a>\r
 217     </td>\r
 218   </tr>\r
 219 </table>\r
 220 </body>\r
 221 </html>\r