<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>8. ODBC backend</title><link rel="stylesheet" href="docbook.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /><link rel="home" href="index.html" title="PowerDNS manual" /><link rel="up" href="backends-detail.html" title="Appendix A. Backends in detail" /><link rel="prev" href="bindbackend.html" title="7. Bind zone file backend" /><link rel="next" href="xdbbackend.html" title="9. XDB Backend" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">8. ODBC backend</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="bindbackend.html">Prev</a> </td><th width="60%" align="center">Appendix A. Backends in detail</th><td width="20%" align="right"> <a accesskey="n" href="xdbbackend.html">Next</a></td></tr></table><hr /></div><div class="sect1" title="8. ODBC backend"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="odbc"></a>8. ODBC backend</h2></div></div></div><p>
</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="note.png" /></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>This backend was removed in version 3.1.</p></td></tr></table></div><p>
</p><div class="table"><a id="idp9681408"></a><p class="title"><b>Table A.8. ODBC backend capabilities</b></p><div class="table-contents"><table summary="ODBC backend capabilities" border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>Native</td><td>Yes</td></tr><tr><td>Master</td><td>Yes (experimental)</td></tr><tr><td>Slave</td><td>Yes (experimental)</td></tr><tr><td>Superslave</td><td>No</td></tr><tr><td>Autoserial</td><td>Yes</td></tr></tbody></table></div></div><p><br class="table-break" />
</p><p>
The ODBC backend can retrieve zone information from any source that has a ODBC driver available.
</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="note.png" /></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>This backend is only available on PowerDNS for Windows.</p></td></tr></table></div><p>
</p><p>
The ODBC backend needs data in a fixed schema which is the same as the data needed by the MySQL backend. The create statement
will resemble this:
</p><pre class="screen">
CREATE TABLE records (
id int(11) NOT NULL auto_increment,
domain_id int(11) default NULL,
name varchar(255) default NULL,
type varchar(10) default NULL,
content varchar(255) default NULL,
ttl int(11) default NULL,
prio int(11) default NULL,
change_date int(11) default NULL,
PRIMARY KEY (id),
KEY name_index(name),
KEY nametype_index(name,type),
KEY domainid_index(domain_id)
);
</pre><p>
</p><p>
To use the ODBC backend an ODBC source has to be created, to do this see the section Installing PowerDNS on Microsoft Windows, <a class="xref" href="windows.html" title="Chapter 3. Installing on Microsoft Windows">Chapter 3, <i>Installing on Microsoft Windows</i></a>.
</p><p>
The following configuration settings are available:
</p><div class="variablelist"><dl><dt><span class="term">odbc-datasource</span></dt><dd><p>
Specifies the name of the data source to use.
</p></dd><dt><span class="term">odbc-user</span></dt><dd><p>
Specifies the username that has to be used to log into the data source.
</p></dd><dt><span class="term">odbc-pass</span></dt><dd><p>
Specifies the user's password.
</p></dd><dt><span class="term">odbc-table</span></dt><dd><p>
Specifies the name of the table containing the zone information.
</p></dd></dl></div><p>
</p><p>
The ODBC backend has been tested with Microsoft Access, MySQL (via MyODBC) and Microsoft SQLServer. As the SQL statements used are very basic,
it is expected to work with many ODBC drivers.
</p></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="bindbackend.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="backends-detail.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="xdbbackend.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">7. Bind zone file backend </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 9. XDB Backend</td></tr></table></div></body></html>
