mirror of
https://github.com/mariadb-corporation/mariadb-connector-python.git
synced 2025-08-04 08:04:45 +00:00
427 lines
30 KiB
HTML
427 lines
30 KiB
HTML
|
||
<!DOCTYPE html>
|
||
|
||
<html>
|
||
<head>
|
||
<meta charset="utf-8" />
|
||
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||
<title>The mariadb module — MariaDB Connector/Python 1.1.0b3-beta documentation</title>
|
||
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
|
||
<link rel="stylesheet" type="text/css" href="_static/classic.css" />
|
||
|
||
<script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
|
||
<script src="_static/jquery.js"></script>
|
||
<script src="_static/underscore.js"></script>
|
||
<script src="_static/doctools.js"></script>
|
||
|
||
<link rel="index" title="Index" href="genindex.html" />
|
||
<link rel="search" title="Search" href="search.html" />
|
||
<link rel="next" title="The connection class" href="connection.html" />
|
||
<link rel="prev" title="API Reference" href="api.html" />
|
||
</head><body>
|
||
<div class="related" role="navigation" aria-label="related navigation">
|
||
<h3>Navigation</h3>
|
||
<ul>
|
||
<li class="right" style="margin-right: 10px">
|
||
<a href="genindex.html" title="General Index"
|
||
accesskey="I">index</a></li>
|
||
<li class="right" >
|
||
<a href="py-modindex.html" title="Python Module Index"
|
||
>modules</a> |</li>
|
||
<li class="right" >
|
||
<a href="connection.html" title="The connection class"
|
||
accesskey="N">next</a> |</li>
|
||
<li class="right" >
|
||
<a href="api.html" title="API Reference"
|
||
accesskey="P">previous</a> |</li>
|
||
<li class="nav-item nav-item-0"><a href="index.html">MariaDB Connector/Python 1.1.0b3-beta documentation</a> »</li>
|
||
<li class="nav-item nav-item-1"><a href="api.html" accesskey="U">API Reference</a> »</li>
|
||
<li class="nav-item nav-item-this"><a href="">The mariadb module</a></li>
|
||
</ul>
|
||
</div>
|
||
|
||
<div class="document">
|
||
<div class="documentwrapper">
|
||
<div class="bodywrapper">
|
||
<div class="body" role="main">
|
||
|
||
<div class="section" id="module-mariadb">
|
||
<span id="the-mariadb-module"></span><span id="module"></span><h1>The mariadb module<a class="headerlink" href="#module-mariadb" title="Permalink to this headline">¶</a></h1>
|
||
<p>The mariadb module supports the standard defined by DB API 2.0 (PEP-249).</p>
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="mariadb.connect">
|
||
<span class="sig-prename descclassname"><span class="pre">mariadb.</span></span><span class="sig-name descname"><span class="pre">connect</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">cursorclass</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">mariadb.connections.Connection</span> <span class="pre">**</span> <span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#mariadb.connect" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Establishes a connection to a database server and returns a new connection
|
||
object.</p>
|
||
<p>Parameters:</p>
|
||
</dd></dl>
|
||
|
||
<div class="versionadded">
|
||
<p><span class="versionmodified added">New in version 1.1.0: </span></p>
|
||
<ul class="simple">
|
||
<li><p><strong>cursorclass</strong>: A subclass of mariadb.connections.Connection. If not specified default will be used.</p></li>
|
||
</ul>
|
||
<p>Keyword arguments:</p>
|
||
<p>The supported connection keywords are:</p>
|
||
<ul class="simple">
|
||
<li><p><strong>user</strong>, <strong>username</strong> (string): The username used to authenticate with the database server, defaults to current user</p></li>
|
||
<li><p><strong>password</strong>, <strong>passwd</strong> (string): The password of the given user</p></li>
|
||
<li><p><strong>host</strong> (string): The host name or IP address of the database server</p></li>
|
||
<li><p><strong>database</strong>, <strong>db</strong> (string): The database (schema) name to used when connecting with the database server</p></li>
|
||
<li><p><strong>unix_socket</strong> (string): The location of the unix socket file to use instead of using an IP port to connect. If socket authentication is enabled, this can also be used in place of a password.</p></li>
|
||
<li><p><strong>port</strong> (integer): The port number of the database server. If not specified the default value (=3306) will be used.</p></li>
|
||
<li><p><strong>connect_timeout</strong> (integer): The connect timeout in seconds</p></li>
|
||
<li><p><strong>read_timeout</strong> (integer): The read timeout in seconds</p></li>
|
||
<li><p><strong>write_timeout</strong> (integer): The write timeout in seconds</p></li>
|
||
<li><p><strong>local_infile</strong> (bool): Enables or disables the use of LOAD DATA LOCAL INFILE statements.</p></li>
|
||
<li><dl class="simple">
|
||
<dt><strong>compress</strong> (bool) – Uses the compressed protocol for client server communication. If the</dt><dd><p>server doesn’t support compressed protocol, the default protocol will
|
||
be used</p>
|
||
</dd>
|
||
</dl>
|
||
</li>
|
||
<li><p><strong>client_flag</strong> (int): Additional client capabilities. Possible values are defined in constants.CLIENT.</p></li>
|
||
<li><p><strong>init_command</strong> (string): Specifies one or more commands to execute when connecting and reconnecting to the database server.</p></li>
|
||
<li><p><strong>default_file</strong> (string): Read options from the specified option file. If the file is an empty string, default configuration file(s) will be used</p></li>
|
||
<li><p><strong>default_group</strong> (string): Read options from the specified group</p></li>
|
||
<li><p><strong>plugin_dir</strong> (string): Directory which contains MariaDB client plugins</p></li>
|
||
<li><dl class="simple">
|
||
<dt><strong>ssl_key</strong> (string): Defines a path to a private key file to use for TLS. This option</dt><dd><p>requires that you use the absolute path, not a relative path. The specified key must be in PEM format</p>
|
||
</dd>
|
||
</dl>
|
||
</li>
|
||
<li><p><strong>ssl_cert</strong> (string): Defines a path to the X509 certificate file to use for TLS. This option requires that you use the absolute path, not a relative path. The X609 certificate must be in PEM format.</p></li>
|
||
<li><p><strong>ssl_ca</strong> (string): Defines a path to a PEM file that should contain one or more X509 certificates for trusted Certificate Authorities (CAs) to use for TLS. This option requires that you use the absolute path, not a relative path.</p></li>
|
||
<li><p><strong>ssl_capath</strong> (string): Defines a path to a directory that contains one or more PEM files that contains one X509 certificate for a trusted Certificate Authority (CA)</p></li>
|
||
<li><p><strong>ssl_cipher</strong> (string): Defines a list of permitted cipher suites to use for TLS</p></li>
|
||
<li><p><strong>ssl_crlpath</strong> (string): Defines a path to a PEM file that should contain one or more revoked X509 certificates to use for TLS. This option requires that you use the absolute path, not a relative path.</p></li>
|
||
<li><p><strong>ssl_verify_cert</strong> (bool): Enables server certificate verification.</p></li>
|
||
<li><p><strong>ssl</strong> (bool): Always use a secure TLS connection</p></li>
|
||
</ul>
|
||
</div>
|
||
<div class="versionadded">
|
||
<p><span class="versionmodified added">New in version 1.0.1: </span></p>
|
||
<ul class="simple">
|
||
<li><p><strong>autocommit</strong> (bool or None): Specifies the autocommit settings: None will use the server default. True will enable autocommit, False will disable it (default).</p></li>
|
||
</ul>
|
||
</div>
|
||
<div class="versionadded">
|
||
<p><span class="versionmodified added">New in version 1.0.3: </span></p>
|
||
<ul class="simple">
|
||
<li><p><strong>converter</strong> (dict): Specifies a conversion dictionary, where keys are FIELD_TYPE values and values are conversion functions.</p></li>
|
||
</ul>
|
||
<dl class="field-list simple">
|
||
<dt class="field-odd">return</dt>
|
||
<dd class="field-odd"><p>Returns a connection object or raises an error if the connection between client and server couldn’t be established.</p>
|
||
</dd>
|
||
</dl>
|
||
<p>The connection parameters have to be provided as a set of keyword arguments:</p>
|
||
<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">mariadb</span>
|
||
|
||
<span class="n">connection</span><span class="o">=</span> <span class="n">mariadb</span><span class="o">.</span><span class="n">connect</span><span class="p">(</span><span class="n">user</span><span class="o">=</span><span class="s2">"myuser"</span><span class="p">,</span> <span class="n">host</span><span class="o">=</span><span class="s2">"localhost"</span><span class="p">,</span> <span class="n">database</span><span class="o">=</span><span class="s2">"test"</span><span class="p">,</span> <span class="n">password</span><span class="o">=</span><span class="s2">"secret"</span><span class="p">)</span>
|
||
</pre></div>
|
||
</div>
|
||
</div>
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p>For a description of configuration file handling and settings please read the chapter <a class="reference external" href="https://github.com/mariadb-corporation/mariadb-connector-c/wiki/config_files#configuration-options">Configuration files</a> of the MariaDB Connector/C documentation.</p>
|
||
</div>
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="mariadb.ConnectionPool">
|
||
<span class="sig-prename descclassname"><span class="pre">mariadb.</span></span><span class="sig-name descname"><span class="pre">ConnectionPool</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#mariadb.ConnectionPool" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Creates a connection pool and returns a ConnectionPool object.</p>
|
||
<p>The connection parameters have to be provided as a set of keyword arguments:</p>
|
||
<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">db_conf</span><span class="o">=</span> <span class="p">{</span><span class="n">user</span><span class="o">=</span><span class="s2">"myname"</span><span class="p">,</span> <span class="n">password</span><span class="o">=</span><span class="s2">"secret"</span><span class="p">,</span> <span class="n">database</span><span class="o">=</span><span class="s2">"test"</span><span class="p">,</span> <span class="n">host</span><span class="o">=</span><span class="s2">"localhost"</span><span class="p">};</span>
|
||
<span class="n">pool</span><span class="o">=</span> <span class="n">mariadb</span><span class="o">.</span><span class="n">ConnectionPool</span><span class="p">(</span><span class="n">pool_name</span><span class="o">=</span><span class="s2">"pool1"</span><span class="p">,</span> <span class="o">**</span><span class="n">db_conf</span><span class="p">)</span>
|
||
</pre></div>
|
||
</div>
|
||
<p>Beside pool specific parameter all parameters from connect() are supported.
|
||
The supported pool parameters are:</p>
|
||
<ul class="simple">
|
||
<li><p>pool_name – Name of the pool</p></li>
|
||
<li><p>pool_size – Size of the pool. If this value is not provided, a default size of 5 pool connections will be used.</p></li>
|
||
<li><p>pool_reset – If set to <cite>True</cite> the connection will be reset after close() method was called.</p></li>
|
||
</ul>
|
||
</dd></dl>
|
||
|
||
<div class="section" id="attributes">
|
||
<h2>Attributes<a class="headerlink" href="#attributes" title="Permalink to this headline">¶</a></h2>
|
||
<dl class="py attribute">
|
||
<dt class="sig sig-object py" id="mariadb.apilevel">
|
||
<span class="sig-prename descclassname"><span class="pre">mariadb.</span></span><span class="sig-name descname"><span class="pre">apilevel</span></span><a class="headerlink" href="#mariadb.apilevel" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>String constant stating the supported DB API level. The value for <cite>mariadb</cite> is
|
||
<code class="docutils literal notranslate"><span class="pre">2.0</span></code>.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py attribute">
|
||
<dt class="sig sig-object py" id="mariadb.threadsafety">
|
||
<span class="sig-prename descclassname"><span class="pre">mariadb.</span></span><span class="sig-name descname"><span class="pre">threadsafety</span></span><a class="headerlink" href="#mariadb.threadsafety" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Integer constant stating the level of thread safety. For <cite>mariadb</cite> the value is 1,
|
||
which means threads can share the module but not the connection.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py attribute">
|
||
<dt class="sig sig-object py" id="mariadb.paramstyle">
|
||
<span class="sig-prename descclassname"><span class="pre">mariadb.</span></span><span class="sig-name descname"><span class="pre">paramstyle</span></span><a class="headerlink" href="#mariadb.paramstyle" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>String constant stating the type of parameter marker. For <cite>mariadb</cite> the value is
|
||
<cite>qmark</cite>. For compatibility reasons <cite>mariadb</cite> also supports the <cite>format</cite> and
|
||
<cite>pyformat</cite> paramstyles with the limitation that they can’t be mixed inside a SQL statement.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py attribute">
|
||
<dt class="sig sig-object py" id="mariadb.mariadbapi_version">
|
||
<span class="sig-prename descclassname"><span class="pre">mariadb.</span></span><span class="sig-name descname"><span class="pre">mariadbapi_version</span></span><a class="headerlink" href="#mariadb.mariadbapi_version" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>String constant stating the version of the used MariaDB Connector/C library.</p>
|
||
</dd></dl>
|
||
|
||
<div class="versionadded">
|
||
<p><span class="versionmodified added">New in version 1.1.0.</span></p>
|
||
</div>
|
||
<dl class="py attribute">
|
||
<dt class="sig sig-object py" id="mariadb.client_version">
|
||
<span class="sig-prename descclassname"><span class="pre">mariadb.</span></span><span class="sig-name descname"><span class="pre">client_version</span></span><a class="headerlink" href="#mariadb.client_version" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Returns the version of MariaDB Connector/C library in use as an integer.
|
||
The number has the following format:
|
||
MAJOR_VERSION * 10000 + MINOR_VERSION * 1000 + PATCH_VERSION</p>
|
||
</dd></dl>
|
||
|
||
<div class="versionadded">
|
||
<p><span class="versionmodified added">New in version 1.1.0.</span></p>
|
||
</div>
|
||
<dl class="py attribute">
|
||
<dt class="sig sig-object py" id="mariadb.client_version_info">
|
||
<span class="sig-prename descclassname"><span class="pre">mariadb.</span></span><span class="sig-name descname"><span class="pre">client_version_info</span></span><a class="headerlink" href="#mariadb.client_version_info" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Returns the version of MariaDB Connector/C library as a tuple in the
|
||
following format:
|
||
(MAJOR_VERSION, MINOR_VERSION, PATCH_VERSION)</p>
|
||
</dd></dl>
|
||
|
||
</div>
|
||
<div class="section" id="exceptions">
|
||
<h2>Exceptions<a class="headerlink" href="#exceptions" title="Permalink to this headline">¶</a></h2>
|
||
<p>Compliant to DB API 2.0 MariaDB Connector/C provides information about errors
|
||
through the following exceptions:</p>
|
||
<dl class="py exception">
|
||
<dt class="sig sig-object py" id="mariadb.DataError">
|
||
<em class="property"><span class="pre">exception</span> </em><span class="sig-prename descclassname"><span class="pre">mariadb.</span></span><span class="sig-name descname"><span class="pre">DataError</span></span><a class="headerlink" href="#mariadb.DataError" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Exception raised for errors that are due to problems with the processed data like division by zero,
|
||
numeric value out of range, etc.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py exception">
|
||
<dt class="sig sig-object py" id="mariadb.DatabaseError">
|
||
<em class="property"><span class="pre">exception</span> </em><span class="sig-prename descclassname"><span class="pre">mariadb.</span></span><span class="sig-name descname"><span class="pre">DatabaseError</span></span><a class="headerlink" href="#mariadb.DatabaseError" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Exception raised for errors that are related to the database</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py exception">
|
||
<dt class="sig sig-object py" id="mariadb.InterfaceError">
|
||
<em class="property"><span class="pre">exception</span> </em><span class="sig-prename descclassname"><span class="pre">mariadb.</span></span><span class="sig-name descname"><span class="pre">InterfaceError</span></span><a class="headerlink" href="#mariadb.InterfaceError" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Exception raised for errors that are related to the database interface
|
||
rather than the database itself.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py exception">
|
||
<dt class="sig sig-object py" id="mariadb.Warning">
|
||
<em class="property"><span class="pre">exception</span> </em><span class="sig-prename descclassname"><span class="pre">mariadb.</span></span><span class="sig-name descname"><span class="pre">Warning</span></span><a class="headerlink" href="#mariadb.Warning" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Exception raised for important warnings like data truncations while inserting, etc.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py exception">
|
||
<dt class="sig sig-object py" id="mariadb.PoolError">
|
||
<em class="property"><span class="pre">exception</span> </em><span class="sig-prename descclassname"><span class="pre">mariadb.</span></span><span class="sig-name descname"><span class="pre">PoolError</span></span><a class="headerlink" href="#mariadb.PoolError" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Exception raised for errors related to ConnectionPool class.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py exception">
|
||
<dt class="sig sig-object py" id="mariadb.OperationalError">
|
||
<em class="property"><span class="pre">exception</span> </em><span class="sig-prename descclassname"><span class="pre">mariadb.</span></span><span class="sig-name descname"><span class="pre">OperationalError</span></span><a class="headerlink" href="#mariadb.OperationalError" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Exception raised for errors that are related to the database’s operation
|
||
and not necessarily under the control of the programmer</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py exception">
|
||
<dt class="sig sig-object py" id="mariadb.IntegrityError">
|
||
<em class="property"><span class="pre">exception</span> </em><span class="sig-prename descclassname"><span class="pre">mariadb.</span></span><span class="sig-name descname"><span class="pre">IntegrityError</span></span><a class="headerlink" href="#mariadb.IntegrityError" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Exception raised when the relational integrity of the database is affected,
|
||
e.g. a foreign key check fails.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py exception">
|
||
<dt class="sig sig-object py" id="mariadb.InternalError">
|
||
<em class="property"><span class="pre">exception</span> </em><span class="sig-prename descclassname"><span class="pre">mariadb.</span></span><span class="sig-name descname"><span class="pre">InternalError</span></span><a class="headerlink" href="#mariadb.InternalError" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Exception raised when the database encounters an internal error,
|
||
e.g. the cursor is not valid anymore</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py exception">
|
||
<dt class="sig sig-object py" id="mariadb.ProgrammingError">
|
||
<em class="property"><span class="pre">exception</span> </em><span class="sig-prename descclassname"><span class="pre">mariadb.</span></span><span class="sig-name descname"><span class="pre">ProgrammingError</span></span><a class="headerlink" href="#mariadb.ProgrammingError" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Exception raised for programming errors, e.g. table not found or already
|
||
exists, syntax error in the SQL statement</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py exception">
|
||
<dt class="sig sig-object py" id="mariadb.NotSupportedError">
|
||
<em class="property"><span class="pre">exception</span> </em><span class="sig-prename descclassname"><span class="pre">mariadb.</span></span><span class="sig-name descname"><span class="pre">NotSupportedError</span></span><a class="headerlink" href="#mariadb.NotSupportedError" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Exception raised in case a method or database API was used which is not
|
||
supported by the database</p>
|
||
</dd></dl>
|
||
|
||
</div>
|
||
<div class="section" id="type-objects-and-constructors">
|
||
<h2>Type objects and constructors<a class="headerlink" href="#type-objects-and-constructors" title="Permalink to this headline">¶</a></h2>
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="mariadb.Binary">
|
||
<span class="sig-prename descclassname"><span class="pre">mariadb.</span></span><span class="sig-name descname"><span class="pre">Binary</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#mariadb.Binary" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>This function constructs an object capable of holding a binary (long)
|
||
string value</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="mariadb.Date">
|
||
<span class="sig-prename descclassname"><span class="pre">mariadb.</span></span><span class="sig-name descname"><span class="pre">Date</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">year</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">month</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">day</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#mariadb.Date" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>This function constructs an object holding a date value</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="mariadb.DateFromTicks">
|
||
<span class="sig-prename descclassname"><span class="pre">mariadb.</span></span><span class="sig-name descname"><span class="pre">DateFromTicks</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">ticks</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#mariadb.DateFromTicks" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>This function constructs an object holding a date value from the given
|
||
ticks value (number of seconds since the epoch). For more information
|
||
see the documentation of the standard Python time module</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="mariadb.Time">
|
||
<span class="sig-prename descclassname"><span class="pre">mariadb.</span></span><span class="sig-name descname"><span class="pre">Time</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">hour</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">minute</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">second</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#mariadb.Time" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>This function constructs an object holding a time value</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="mariadb.TimeFromTicks">
|
||
<span class="sig-prename descclassname"><span class="pre">mariadb.</span></span><span class="sig-name descname"><span class="pre">TimeFromTicks</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">ticks</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#mariadb.TimeFromTicks" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>This function constructs an object holding a time value from the given
|
||
ticks value (number of seconds since the epoch). For more information
|
||
see the documentation of the standard Python time module</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="mariadb.Timestamp">
|
||
<span class="sig-prename descclassname"><span class="pre">mariadb.</span></span><span class="sig-name descname"><span class="pre">Timestamp</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">year</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">month</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">day</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">hour</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">minute</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">second</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#mariadb.Timestamp" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>This function constructs an object holding a time stamp value</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="mariadb.TimestampFromTicks">
|
||
<span class="sig-prename descclassname"><span class="pre">mariadb.</span></span><span class="sig-name descname"><span class="pre">TimestampFromTicks</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">ticks</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#mariadb.TimestampFromTicks" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>This function constructs an object holding a time stamp value from the given
|
||
ticks value (number of seconds since the epoch). For more information
|
||
see the documentation of the standard Python time module</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py data">
|
||
<dt class="sig sig-object py" id="mariadb.STRING">
|
||
<span class="sig-prename descclassname"><span class="pre">mariadb.</span></span><span class="sig-name descname"><span class="pre">STRING</span></span><a class="headerlink" href="#mariadb.STRING" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>This type object is used to describe columns in a database that are
|
||
string-based (e.g. CHAR).</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py data">
|
||
<dt class="sig sig-object py" id="mariadb.BINARY">
|
||
<span class="sig-prename descclassname"><span class="pre">mariadb.</span></span><span class="sig-name descname"><span class="pre">BINARY</span></span><a class="headerlink" href="#mariadb.BINARY" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>This type object is used to describe (long) binary columns in a database
|
||
(e.g. LONG, RAW, BLOBs).</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py data">
|
||
<dt class="sig sig-object py" id="mariadb.NUMBER">
|
||
<span class="sig-prename descclassname"><span class="pre">mariadb.</span></span><span class="sig-name descname"><span class="pre">NUMBER</span></span><a class="headerlink" href="#mariadb.NUMBER" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>This type object is used to describe numeric columns in a database.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py data">
|
||
<dt class="sig sig-object py" id="mariadb.DATETIME">
|
||
<span class="sig-prename descclassname"><span class="pre">mariadb.</span></span><span class="sig-name descname"><span class="pre">DATETIME</span></span><a class="headerlink" href="#mariadb.DATETIME" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>This type object is used to describe date/time columns in a database.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py data">
|
||
<dt class="sig sig-object py" id="mariadb.ROWID">
|
||
<span class="sig-prename descclassname"><span class="pre">mariadb.</span></span><span class="sig-name descname"><span class="pre">ROWID</span></span><a class="headerlink" href="#mariadb.ROWID" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>This type object is used to describe the “Row ID” column in a database.</p>
|
||
</dd></dl>
|
||
|
||
</div>
|
||
</div>
|
||
|
||
|
||
<div class="clearer"></div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
|
||
<div class="sphinxsidebarwrapper">
|
||
<h3><a href="index.html">Table of Contents</a></h3>
|
||
<ul>
|
||
<li><a class="reference internal" href="#">The mariadb module</a><ul>
|
||
<li><a class="reference internal" href="#attributes">Attributes</a></li>
|
||
<li><a class="reference internal" href="#exceptions">Exceptions</a></li>
|
||
<li><a class="reference internal" href="#type-objects-and-constructors">Type objects and constructors</a></li>
|
||
</ul>
|
||
</li>
|
||
</ul>
|
||
|
||
<h4>Previous topic</h4>
|
||
<p class="topless"><a href="api.html"
|
||
title="previous chapter">API Reference</a></p>
|
||
<h4>Next topic</h4>
|
||
<p class="topless"><a href="connection.html"
|
||
title="next chapter">The connection class</a></p>
|
||
<div role="note" aria-label="source link">
|
||
<h3>This Page</h3>
|
||
<ul class="this-page-menu">
|
||
<li><a href="_sources/module.rst.txt"
|
||
rel="nofollow">Show Source</a></li>
|
||
</ul>
|
||
</div>
|
||
<div id="searchbox" style="display: none" role="search">
|
||
<h3 id="searchlabel">Quick search</h3>
|
||
<div class="searchformwrapper">
|
||
<form class="search" action="search.html" method="get">
|
||
<input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
|
||
<input type="submit" value="Go" />
|
||
</form>
|
||
</div>
|
||
</div>
|
||
<script>$('#searchbox').show(0);</script>
|
||
</div>
|
||
</div>
|
||
<div class="clearer"></div>
|
||
</div>
|
||
<div class="related" role="navigation" aria-label="related navigation">
|
||
<h3>Navigation</h3>
|
||
<ul>
|
||
<li class="right" style="margin-right: 10px">
|
||
<a href="genindex.html" title="General Index"
|
||
>index</a></li>
|
||
<li class="right" >
|
||
<a href="py-modindex.html" title="Python Module Index"
|
||
>modules</a> |</li>
|
||
<li class="right" >
|
||
<a href="connection.html" title="The connection class"
|
||
>next</a> |</li>
|
||
<li class="right" >
|
||
<a href="api.html" title="API Reference"
|
||
>previous</a> |</li>
|
||
<li class="nav-item nav-item-0"><a href="index.html">MariaDB Connector/Python 1.1.0b3-beta documentation</a> »</li>
|
||
<li class="nav-item nav-item-1"><a href="api.html" >API Reference</a> »</li>
|
||
<li class="nav-item nav-item-this"><a href="">The mariadb module</a></li>
|
||
</ul>
|
||
</div>
|
||
<div class="footer" role="contentinfo">
|
||
© Copyright 2019-2021 MariaDB Corporation and Georg Richter.
|
||
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 4.1.2.
|
||
</div>
|
||
</body>
|
||
</html> |