Files
2021-12-07 10:26:39 +01:00

99 lines
2.3 KiB
Markdown

+++
title = "pdsql"
description = "*pdsql* - uses powerdns generic sql as backend."
weight = 10
tags = [ "plugin" , "pdsql" ]
categories = [ "plugin", "external" ]
date = "2017-12-09T10:26:00+08:00"
repo = "https://github.com/wenerme/coredns-pdsql"
home = "https://github.com/wenerme/coredns-pdsql/blob/master/README.md"
+++
# Description
*pdsql* uses PowerDNS [generic sql](https://github.com/PowerDNS/pdns/tree/master/pdns/backends/gsql) as backend.
Use [jinzhu/gorm](https://github.com/jinzhu/gorm) database drivers, supports as many databases as Gorm does.
## Syntax
~~~ txt
pdsql <dialect> <arg> {
// enable debug mode
debug [db]
// create table for test
auto-migrate
}
~~~
## Install Driver
pdsql needs db drivers for dialect, to install a driver you need to add an import in `plugin.cfg`, like
~~~ txt
pdsql_mysql:github.com/jinzhu/gorm/dialects/mysql
pdsql_sqlite:github.com/jinzhu/gorm/dialects/sqlite
~~~
pdsql_mysql and pdsql_sqlite are meaningless, specified to prevent duplicates.
## Examples
Start a server on port `1053`, use `test.db` as backend.
~~~ corefile
test.:1053 {
pdsql sqlite3 ./test.db {
debug db
auto-migrate
}
}
~~~
Prepare data for test.
~~~ bash
# Insert records for wener.test
sqlite3 ./test.db 'insert into records(name,type,content,ttl,disabled)values("wener.test","A","192.168.1.1",3600,0)'
sqlite3 ./test.db 'insert into records(name,type,content,ttl,disabled)values("wener.test","TXT","TXT Here",3600,0)'
~~~
When queried for "wener.test. A", CoreDNS will respond with:
~~~ txt
;; QUESTION SECTION:
;wener.test. IN A
;; ANSWER SECTION:
wener.test. 3600 IN A 192.168.1.1
~~~
When queried for "wener.test. ANY", CoreDNS will respond with:
~~~ txt
;; QUESTION SECTION:
;wener.test. IN ANY
;; ANSWER SECTION:
wener.test. 3600 IN A 192.168.1.1
wener.test. 3600 IN TXT "TXT Here"
~~~
### Wildcard
~~~ bash
# domain id 1
sqlite3 ./test.db 'insert into domains(name,type)values("example.test","NATIVE")'
sqlite3 ./test.db 'insert into records(domain_id,name,type,content,ttl,disabled)values(1,"*.example.test","A","192.168.1.1",3600,0)'
~~~
When queried for "first.example.test. A", CoreDNS will respond with:
~~~ txt
;; QUESTION SECTION:
;first.example.test. IN A
;; ANSWER SECTION:
first.example.test. 3600 IN A 192.168.1.1
~~~