OpenStack - User contributions [en]

Meetings/Designate

2014-11-19T00:25:41Z

Betsy: /* Agenda */

= DNSaaS Meetings =

The DNSaaS team holds a weekly IRC meeting in #openstack-meeting-alt on Wednesdays at 17:00 UTC

Meeting logs are available at http://eavesdrop.openstack.org/meetings/designate/

== Next meeting ==

Date of next meeting [http://www.timeanddate.com/worldclock/fixedtime.html?ah=1&iso=20141112T17 Wednesday 12 November, 17:00 UTC]

=== Agenda ===

* Action Items from last week
* Specific Items:
** Pools - Where are we? (kiall)
** Mid-Cycle Dates/Locations/Topics (kiall)
*** I'd suggest we turn things around this time, and call it a hackathon
** Pools Question - Do we want to treat nameservers differently than poolattributes, or is it just a type of poolattribute? (betsy)
* Open Discussion

=== Future/Unscheduled Agenda Items ===

* None

Meetings/Designate

2014-07-09T14:57:10Z

Betsy: /* Agenda */

= DNSaaS Meetings =

The DNSaaS team holds a weekly IRC meeting in #openstack-meeting-alt on Wednesdays at 17:00 UTC

Meeting logs are available at http://eavesdrop.openstack.org/meetings/designate/

== Next meeting ==

Date of next meeting [http://www.timeanddate.com/worldclock/fixedtime.html?ah=1&iso=20140625T17 Wednesday 9 July, 17:00 UTC]

We are back to our regularly scheduled IRC meetings after meeting on Google Hangouts for OpenStack Atlanta Summit preparation.

=== Agenda ===
* Action Items from last week
* SOA records - making them visible and editable in v2 (betsy)[https://etherpad.openstack.org/p/soa-records etherpad]
* Open Discussion

Meetings/Designate

2014-07-07T18:50:40Z

Betsy: /* Next meeting */

= DNSaaS Meetings =

The DNSaaS team holds a weekly IRC meeting in #openstack-meeting-alt on Wednesdays at 17:00 UTC

Meeting logs are available at http://eavesdrop.openstack.org/meetings/designate/

== Next meeting ==

Date of next meeting [http://www.timeanddate.com/worldclock/fixedtime.html?ah=1&iso=20140625T17 Wednesday 9 July, 17:00 UTC]

We are back to our regularly scheduled IRC meetings after meeting on Google Hangouts for OpenStack Atlanta Summit preparation.

=== Agenda ===
* Action Items from last week
* SOA records - making them visible and editable in v2 (betsy)
* Open Discussion

Designate/Blueprints/Records Table Redesign

2014-06-24T20:19:48Z

Betsy: /* TXT_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/recordsets-records-tables-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the record_id, the recordset_id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset_id and the IPv4 address. The MX_Record table will contain the recordset_id and the FQDN for the mail server and its preference value. See the the tables below for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| address || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id|| CHAR || 32 || False || Non-unique Key
|-
| address || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| cname || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || Hostname
|-
| preference || INT ||11 || False || Lowest number has highest priority
|}

==== NS_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| nsdname || VARCHAR || 255|| False || Hostname
|}

==== PTR_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| ptrdname || VARCHAR || 255|| False || Hostname
|}

==== SOA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id|| CHAR || 32 || False || Non-unique Key
|-
| mname || VARCHAR || 255 || False || Primary name server
|-
| rname || VARCHAR || 255 || False || Domain name that indicates the email address
|-
| serial || INT || 11 || False || Serial number
|-
| refresh || INT || 11 || False || Number of seconds between data refresh
|-
| retry || INT || 11 || False || Number of seconds between retries
|-
| expire || INT || 11 || False || Number of seconds before information is no longer considered authoritative
|-
| minimum || INT || 11 || False || Number of seconds that the records in the zone are valid
|}

==== SPF_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Authorized computers to send mail
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| target || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| weight || INT || 11 || False || Weight of the service
|-
| port || INT || 11 || False || Port of the service
|}

==== SSHFP_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id|| CHAR || 32 || False || Non-unique Key
|-
| algorithm || TINYINT || 1|| False || 0 reserved; 1 RSA; 2 DSS
|-
| type ||TINYINT || 1 || False || 0 reserved; 1 SHA-1
|-
| fingerprint || VARCHAR || 255 || False || Fingerprint of the server public key
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Text
|}

== Comments & Discussion ==
# Could someone else verify that the Data Type, Length and Nullable fields are correct in the various records tables?

Designate/Blueprints/Records Table Redesign

2014-06-24T20:19:08Z

Betsy: /* SSHFP_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/recordsets-records-tables-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the record_id, the recordset_id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset_id and the IPv4 address. The MX_Record table will contain the recordset_id and the FQDN for the mail server and its preference value. See the the tables below for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| address || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id|| CHAR || 32 || False || Non-unique Key
|-
| address || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| cname || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || Hostname
|-
| preference || INT ||11 || False || Lowest number has highest priority
|}

==== NS_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| nsdname || VARCHAR || 255|| False || Hostname
|}

==== PTR_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| ptrdname || VARCHAR || 255|| False || Hostname
|}

==== SOA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id|| CHAR || 32 || False || Non-unique Key
|-
| mname || VARCHAR || 255 || False || Primary name server
|-
| rname || VARCHAR || 255 || False || Domain name that indicates the email address
|-
| serial || INT || 11 || False || Serial number
|-
| refresh || INT || 11 || False || Number of seconds between data refresh
|-
| retry || INT || 11 || False || Number of seconds between retries
|-
| expire || INT || 11 || False || Number of seconds before information is no longer considered authoritative
|-
| minimum || INT || 11 || False || Number of seconds that the records in the zone are valid
|}

==== SPF_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Authorized computers to send mail
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| target || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| weight || INT || 11 || False || Weight of the service
|-
| port || INT || 11 || False || Port of the service
|}

==== SSHFP_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id|| CHAR || 32 || False || Non-unique Key
|-
| algorithm || TINYINT || 1|| False || 0 reserved; 1 RSA; 2 DSS
|-
| type ||TINYINT || 1 || False || 0 reserved; 1 SHA-1
|-
| fingerprint || VARCHAR || 255 || False || Fingerprint of the server public key
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Text
|}

== Comments & Discussion ==
# Could someone else verify that the Data Type, Length and Nullable fields are correct in the various records tables?

Designate/Blueprints/Records Table Redesign

2014-06-24T20:18:56Z

Betsy: /* SRV_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/recordsets-records-tables-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the record_id, the recordset_id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset_id and the IPv4 address. The MX_Record table will contain the recordset_id and the FQDN for the mail server and its preference value. See the the tables below for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| address || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id|| CHAR || 32 || False || Non-unique Key
|-
| address || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| cname || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || Hostname
|-
| preference || INT ||11 || False || Lowest number has highest priority
|}

==== NS_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| nsdname || VARCHAR || 255|| False || Hostname
|}

==== PTR_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| ptrdname || VARCHAR || 255|| False || Hostname
|}

==== SOA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id|| CHAR || 32 || False || Non-unique Key
|-
| mname || VARCHAR || 255 || False || Primary name server
|-
| rname || VARCHAR || 255 || False || Domain name that indicates the email address
|-
| serial || INT || 11 || False || Serial number
|-
| refresh || INT || 11 || False || Number of seconds between data refresh
|-
| retry || INT || 11 || False || Number of seconds between retries
|-
| expire || INT || 11 || False || Number of seconds before information is no longer considered authoritative
|-
| minimum || INT || 11 || False || Number of seconds that the records in the zone are valid
|}

==== SPF_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Authorized computers to send mail
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| target || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| weight || INT || 11 || False || Weight of the service
|-
| port || INT || 11 || False || Port of the service
|}

==== SSHFP_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Unique Key
|-
| recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| algorithm || TINYINT || 1|| False || 0 reserved; 1 RSA; 2 DSS
|-
| type ||TINYINT || 1 || False || 0 reserved; 1 SHA-1
|-
| fingerprint || VARCHAR || 255 || False || Fingerprint of the server public key
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Text
|}

== Comments & Discussion ==
# Could someone else verify that the Data Type, Length and Nullable fields are correct in the various records tables?

Designate/Blueprints/Records Table Redesign

2014-06-24T20:18:45Z

Betsy: /* SPF_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/recordsets-records-tables-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the record_id, the recordset_id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset_id and the IPv4 address. The MX_Record table will contain the recordset_id and the FQDN for the mail server and its preference value. See the the tables below for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| address || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id|| CHAR || 32 || False || Non-unique Key
|-
| address || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| cname || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || Hostname
|-
| preference || INT ||11 || False || Lowest number has highest priority
|}

==== NS_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| nsdname || VARCHAR || 255|| False || Hostname
|}

==== PTR_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| ptrdname || VARCHAR || 255|| False || Hostname
|}

==== SOA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id|| CHAR || 32 || False || Non-unique Key
|-
| mname || VARCHAR || 255 || False || Primary name server
|-
| rname || VARCHAR || 255 || False || Domain name that indicates the email address
|-
| serial || INT || 11 || False || Serial number
|-
| refresh || INT || 11 || False || Number of seconds between data refresh
|-
| retry || INT || 11 || False || Number of seconds between retries
|-
| expire || INT || 11 || False || Number of seconds before information is no longer considered authoritative
|-
| minimum || INT || 11 || False || Number of seconds that the records in the zone are valid
|}

==== SPF_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Authorized computers to send mail
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| target || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| weight || INT || 11 || False || Weight of the service
|-
| port || INT || 11 || False || Port of the service
|}

==== SSHFP_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Unique Key
|-
| recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| algorithm || TINYINT || 1|| False || 0 reserved; 1 RSA; 2 DSS
|-
| type ||TINYINT || 1 || False || 0 reserved; 1 SHA-1
|-
| fingerprint || VARCHAR || 255 || False || Fingerprint of the server public key
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Text
|}

== Comments & Discussion ==
# Could someone else verify that the Data Type, Length and Nullable fields are correct in the various records tables?

Designate/Blueprints/Records Table Redesign

2014-06-24T20:18:33Z

Betsy: /* SOA_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/recordsets-records-tables-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the record_id, the recordset_id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset_id and the IPv4 address. The MX_Record table will contain the recordset_id and the FQDN for the mail server and its preference value. See the the tables below for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| address || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id|| CHAR || 32 || False || Non-unique Key
|-
| address || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| cname || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || Hostname
|-
| preference || INT ||11 || False || Lowest number has highest priority
|}

==== NS_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| nsdname || VARCHAR || 255|| False || Hostname
|}

==== PTR_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| ptrdname || VARCHAR || 255|| False || Hostname
|}

==== SOA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id|| CHAR || 32 || False || Non-unique Key
|-
| mname || VARCHAR || 255 || False || Primary name server
|-
| rname || VARCHAR || 255 || False || Domain name that indicates the email address
|-
| serial || INT || 11 || False || Serial number
|-
| refresh || INT || 11 || False || Number of seconds between data refresh
|-
| retry || INT || 11 || False || Number of seconds between retries
|-
| expire || INT || 11 || False || Number of seconds before information is no longer considered authoritative
|-
| minimum || INT || 11 || False || Number of seconds that the records in the zone are valid
|}

==== SPF_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Authorized computers to send mail
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| target || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| weight || INT || 11 || False || Weight of the service
|-
| port || INT || 11 || False || Port of the service
|}

==== SSHFP_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Unique Key
|-
| recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| algorithm || TINYINT || 1|| False || 0 reserved; 1 RSA; 2 DSS
|-
| type ||TINYINT || 1 || False || 0 reserved; 1 SHA-1
|-
| fingerprint || VARCHAR || 255 || False || Fingerprint of the server public key
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Text
|}

== Comments & Discussion ==
# Could someone else verify that the Data Type, Length and Nullable fields are correct in the various records tables?

Designate/Blueprints/Records Table Redesign

2014-06-24T20:18:22Z

Betsy: /* PTR_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/recordsets-records-tables-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the record_id, the recordset_id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset_id and the IPv4 address. The MX_Record table will contain the recordset_id and the FQDN for the mail server and its preference value. See the the tables below for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| address || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id|| CHAR || 32 || False || Non-unique Key
|-
| address || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| cname || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || Hostname
|-
| preference || INT ||11 || False || Lowest number has highest priority
|}

==== NS_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| nsdname || VARCHAR || 255|| False || Hostname
|}

==== PTR_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| ptrdname || VARCHAR || 255|| False || Hostname
|}

==== SOA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| mname || VARCHAR || 255 || False || Primary name server
|-
| rname || VARCHAR || 255 || False || Domain name that indicates the email address
|-
| serial || INT || 11 || False || Serial number
|-
| refresh || INT || 11 || False || Number of seconds between data refresh
|-
| retry || INT || 11 || False || Number of seconds between retries
|-
| expire || INT || 11 || False || Number of seconds before information is no longer considered authoritative
|-
| minimum || INT || 11 || False || Number of seconds that the records in the zone are valid
|}

==== SPF_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Authorized computers to send mail
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| target || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| weight || INT || 11 || False || Weight of the service
|-
| port || INT || 11 || False || Port of the service
|}

==== SSHFP_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Unique Key
|-
| recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| algorithm || TINYINT || 1|| False || 0 reserved; 1 RSA; 2 DSS
|-
| type ||TINYINT || 1 || False || 0 reserved; 1 SHA-1
|-
| fingerprint || VARCHAR || 255 || False || Fingerprint of the server public key
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Text
|}

== Comments & Discussion ==
# Could someone else verify that the Data Type, Length and Nullable fields are correct in the various records tables?

Designate/Blueprints/Records Table Redesign

2014-06-24T20:18:12Z

Betsy: /* NS_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/recordsets-records-tables-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the record_id, the recordset_id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset_id and the IPv4 address. The MX_Record table will contain the recordset_id and the FQDN for the mail server and its preference value. See the the tables below for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| address || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id|| CHAR || 32 || False || Non-unique Key
|-
| address || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| cname || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || Hostname
|-
| preference || INT ||11 || False || Lowest number has highest priority
|}

==== NS_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| nsdname || VARCHAR || 255|| False || Hostname
|}

==== PTR_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| ptrdname || VARCHAR || 255|| False || Hostname
|}

==== SOA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| mname || VARCHAR || 255 || False || Primary name server
|-
| rname || VARCHAR || 255 || False || Domain name that indicates the email address
|-
| serial || INT || 11 || False || Serial number
|-
| refresh || INT || 11 || False || Number of seconds between data refresh
|-
| retry || INT || 11 || False || Number of seconds between retries
|-
| expire || INT || 11 || False || Number of seconds before information is no longer considered authoritative
|-
| minimum || INT || 11 || False || Number of seconds that the records in the zone are valid
|}

==== SPF_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Authorized computers to send mail
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| target || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| weight || INT || 11 || False || Weight of the service
|-
| port || INT || 11 || False || Port of the service
|}

==== SSHFP_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Unique Key
|-
| recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| algorithm || TINYINT || 1|| False || 0 reserved; 1 RSA; 2 DSS
|-
| type ||TINYINT || 1 || False || 0 reserved; 1 SHA-1
|-
| fingerprint || VARCHAR || 255 || False || Fingerprint of the server public key
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Text
|}

== Comments & Discussion ==
# Could someone else verify that the Data Type, Length and Nullable fields are correct in the various records tables?

Designate/Blueprints/Records Table Redesign

2014-06-24T20:17:58Z

Betsy: /* MX_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/recordsets-records-tables-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the record_id, the recordset_id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset_id and the IPv4 address. The MX_Record table will contain the recordset_id and the FQDN for the mail server and its preference value. See the the tables below for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| address || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id|| CHAR || 32 || False || Non-unique Key
|-
| address || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| cname || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || Hostname
|-
| preference || INT ||11 || False || Lowest number has highest priority
|}

==== NS_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| nsdname || VARCHAR || 255|| False || Hostname
|}

==== PTR_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| ptrdname || VARCHAR || 255|| False || Hostname
|}

==== SOA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| mname || VARCHAR || 255 || False || Primary name server
|-
| rname || VARCHAR || 255 || False || Domain name that indicates the email address
|-
| serial || INT || 11 || False || Serial number
|-
| refresh || INT || 11 || False || Number of seconds between data refresh
|-
| retry || INT || 11 || False || Number of seconds between retries
|-
| expire || INT || 11 || False || Number of seconds before information is no longer considered authoritative
|-
| minimum || INT || 11 || False || Number of seconds that the records in the zone are valid
|}

==== SPF_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Authorized computers to send mail
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| target || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| weight || INT || 11 || False || Weight of the service
|-
| port || INT || 11 || False || Port of the service
|}

==== SSHFP_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Unique Key
|-
| recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| algorithm || TINYINT || 1|| False || 0 reserved; 1 RSA; 2 DSS
|-
| type ||TINYINT || 1 || False || 0 reserved; 1 SHA-1
|-
| fingerprint || VARCHAR || 255 || False || Fingerprint of the server public key
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Text
|}

== Comments & Discussion ==
# Could someone else verify that the Data Type, Length and Nullable fields are correct in the various records tables?

Designate/Blueprints/Records Table Redesign

2014-06-24T20:17:43Z

Betsy: /* CNAME_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/recordsets-records-tables-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the record_id, the recordset_id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset_id and the IPv4 address. The MX_Record table will contain the recordset_id and the FQDN for the mail server and its preference value. See the the tables below for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| address || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id|| CHAR || 32 || False || Non-unique Key
|-
| address || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| cname || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || Hostname
|-
| preference || INT ||11 || False || Lowest number has highest priority
|}

==== NS_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| nsdname || VARCHAR || 255|| False || Hostname
|}

==== PTR_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| ptrdname || VARCHAR || 255|| False || Hostname
|}

==== SOA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| mname || VARCHAR || 255 || False || Primary name server
|-
| rname || VARCHAR || 255 || False || Domain name that indicates the email address
|-
| serial || INT || 11 || False || Serial number
|-
| refresh || INT || 11 || False || Number of seconds between data refresh
|-
| retry || INT || 11 || False || Number of seconds between retries
|-
| expire || INT || 11 || False || Number of seconds before information is no longer considered authoritative
|-
| minimum || INT || 11 || False || Number of seconds that the records in the zone are valid
|}

==== SPF_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Authorized computers to send mail
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| target || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| weight || INT || 11 || False || Weight of the service
|-
| port || INT || 11 || False || Port of the service
|}

==== SSHFP_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Unique Key
|-
| recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| algorithm || TINYINT || 1|| False || 0 reserved; 1 RSA; 2 DSS
|-
| type ||TINYINT || 1 || False || 0 reserved; 1 SHA-1
|-
| fingerprint || VARCHAR || 255 || False || Fingerprint of the server public key
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Text
|}

== Comments & Discussion ==
# Could someone else verify that the Data Type, Length and Nullable fields are correct in the various records tables?

Designate/Blueprints/Records Table Redesign

2014-06-24T20:17:28Z

Betsy: /* AAAA_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/recordsets-records-tables-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the record_id, the recordset_id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset_id and the IPv4 address. The MX_Record table will contain the recordset_id and the FQDN for the mail server and its preference value. See the the tables below for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| address || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id|| CHAR || 32 || False || Non-unique Key
|-
| address || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| cname || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || Hostname
|-
| preference || INT ||11 || False || Lowest number has highest priority
|}

==== NS_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| nsdname || VARCHAR || 255|| False || Hostname
|}

==== PTR_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| ptrdname || VARCHAR || 255|| False || Hostname
|}

==== SOA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| mname || VARCHAR || 255 || False || Primary name server
|-
| rname || VARCHAR || 255 || False || Domain name that indicates the email address
|-
| serial || INT || 11 || False || Serial number
|-
| refresh || INT || 11 || False || Number of seconds between data refresh
|-
| retry || INT || 11 || False || Number of seconds between retries
|-
| expire || INT || 11 || False || Number of seconds before information is no longer considered authoritative
|-
| minimum || INT || 11 || False || Number of seconds that the records in the zone are valid
|}

==== SPF_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Authorized computers to send mail
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| target || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| weight || INT || 11 || False || Weight of the service
|-
| port || INT || 11 || False || Port of the service
|}

==== SSHFP_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Unique Key
|-
| recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| algorithm || TINYINT || 1|| False || 0 reserved; 1 RSA; 2 DSS
|-
| type ||TINYINT || 1 || False || 0 reserved; 1 SHA-1
|-
| fingerprint || VARCHAR || 255 || False || Fingerprint of the server public key
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Text
|}

== Comments & Discussion ==
# Could someone else verify that the Data Type, Length and Nullable fields are correct in the various records tables?

Designate/Blueprints/Records Table Redesign

2014-06-24T20:17:17Z

Betsy: /* A_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/recordsets-records-tables-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the record_id, the recordset_id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset_id and the IPv4 address. The MX_Record table will contain the recordset_id and the FQDN for the mail server and its preference value. See the the tables below for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recordset_id || CHAR || 32 || False || Non-unique Key
|-
| address || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
recordset_id || CHAR || 32 || False || Non-unique Key
|-
| address || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| cname || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || Hostname
|-
| preference || INT ||11 || False || Lowest number has highest priority
|}

==== NS_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| nsdname || VARCHAR || 255|| False || Hostname
|}

==== PTR_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| ptrdname || VARCHAR || 255|| False || Hostname
|}

==== SOA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| mname || VARCHAR || 255 || False || Primary name server
|-
| rname || VARCHAR || 255 || False || Domain name that indicates the email address
|-
| serial || INT || 11 || False || Serial number
|-
| refresh || INT || 11 || False || Number of seconds between data refresh
|-
| retry || INT || 11 || False || Number of seconds between retries
|-
| expire || INT || 11 || False || Number of seconds before information is no longer considered authoritative
|-
| minimum || INT || 11 || False || Number of seconds that the records in the zone are valid
|}

==== SPF_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Authorized computers to send mail
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| target || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| weight || INT || 11 || False || Weight of the service
|-
| port || INT || 11 || False || Port of the service
|}

==== SSHFP_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Unique Key
|-
| recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| algorithm || TINYINT || 1|| False || 0 reserved; 1 RSA; 2 DSS
|-
| type ||TINYINT || 1 || False || 0 reserved; 1 SHA-1
|-
| fingerprint || VARCHAR || 255 || False || Fingerprint of the server public key
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Text
|}

== Comments & Discussion ==
# Could someone else verify that the Data Type, Length and Nullable fields are correct in the various records tables?

Designate/Blueprints/Records Table Redesign

2014-06-24T20:16:34Z

Betsy: /* AAAA_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/recordsets-records-tables-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the record_id, the recordset_id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset_id and the IPv4 address. The MX_Record table will contain the recordset_id and the FQDN for the mail server and its preference value. See the the tables below for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
recordset_id || CHAR || 32 || False || Non-unique Key
|-
| address || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
recordset_id || CHAR || 32 || False || Non-unique Key
|-
| address || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| cname || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || Hostname
|-
| preference || INT ||11 || False || Lowest number has highest priority
|}

==== NS_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| nsdname || VARCHAR || 255|| False || Hostname
|}

==== PTR_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| ptrdname || VARCHAR || 255|| False || Hostname
|}

==== SOA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| mname || VARCHAR || 255 || False || Primary name server
|-
| rname || VARCHAR || 255 || False || Domain name that indicates the email address
|-
| serial || INT || 11 || False || Serial number
|-
| refresh || INT || 11 || False || Number of seconds between data refresh
|-
| retry || INT || 11 || False || Number of seconds between retries
|-
| expire || INT || 11 || False || Number of seconds before information is no longer considered authoritative
|-
| minimum || INT || 11 || False || Number of seconds that the records in the zone are valid
|}

==== SPF_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Authorized computers to send mail
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| target || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| weight || INT || 11 || False || Weight of the service
|-
| port || INT || 11 || False || Port of the service
|}

==== SSHFP_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Unique Key
|-
| recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| algorithm || TINYINT || 1|| False || 0 reserved; 1 RSA; 2 DSS
|-
| type ||TINYINT || 1 || False || 0 reserved; 1 SHA-1
|-
| fingerprint || VARCHAR || 255 || False || Fingerprint of the server public key
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Text
|}

== Comments & Discussion ==
# Could someone else verify that the Data Type, Length and Nullable fields are correct in the various records tables?

Designate/Blueprints/Records Table Redesign

2014-06-24T20:16:20Z

Betsy: /* A_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/recordsets-records-tables-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the record_id, the recordset_id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset_id and the IPv4 address. The MX_Record table will contain the recordset_id and the FQDN for the mail server and its preference value. See the the tables below for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
recordset_id || CHAR || 32 || False || Non-unique Key
|-
| address || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| address || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| cname || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || Hostname
|-
| preference || INT ||11 || False || Lowest number has highest priority
|}

==== NS_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| nsdname || VARCHAR || 255|| False || Hostname
|}

==== PTR_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| ptrdname || VARCHAR || 255|| False || Hostname
|}

==== SOA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| mname || VARCHAR || 255 || False || Primary name server
|-
| rname || VARCHAR || 255 || False || Domain name that indicates the email address
|-
| serial || INT || 11 || False || Serial number
|-
| refresh || INT || 11 || False || Number of seconds between data refresh
|-
| retry || INT || 11 || False || Number of seconds between retries
|-
| expire || INT || 11 || False || Number of seconds before information is no longer considered authoritative
|-
| minimum || INT || 11 || False || Number of seconds that the records in the zone are valid
|}

==== SPF_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Authorized computers to send mail
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| target || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| weight || INT || 11 || False || Weight of the service
|-
| port || INT || 11 || False || Port of the service
|}

==== SSHFP_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Unique Key
|-
| recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| algorithm || TINYINT || 1|| False || 0 reserved; 1 RSA; 2 DSS
|-
| type ||TINYINT || 1 || False || 0 reserved; 1 SHA-1
|-
| fingerprint || VARCHAR || 255 || False || Fingerprint of the server public key
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Text
|}

== Comments & Discussion ==
# Could someone else verify that the Data Type, Length and Nullable fields are correct in the various records tables?

Meetings/Designate

2014-06-12T17:24:46Z

Betsy: /* Agenda */

= DNSaaS Meetings =

The DNSaaS team holds a weekly IRC meeting in #openstack-meeting-alt on Wednesdays at 17:00 UTC

Meeting logs are available at http://eavesdrop.openstack.org/meetings/designate/

== Next meeting ==

Date of next meeting [http://www.timeanddate.com/worldclock/fixedtime.html?ah=1&iso=20140618T17 Wednesday 18 June, 17:00 UTC]

We are back to our regularly scheduled IRC meetings after meeting on Google Hangouts for OpenStack Atlanta Summit preparation.

=== Agenda ===

* Review action items from last week (See [http://eavesdrop.openstack.org/meetings/designate/ Meeting Logs] for previous week)
* Specific Items:
** Review [https://blueprints.launchpad.net/designate/+spec/recordsets-records-tables-redesign blueprint] for Recordsets/Records db tables redesign (Betsy)
** Incubation progress (kiall)
* Open Discussion

Meetings/Designate

2014-06-12T17:24:28Z

Betsy: /* Agenda */

= DNSaaS Meetings =

The DNSaaS team holds a weekly IRC meeting in #openstack-meeting-alt on Wednesdays at 17:00 UTC

Meeting logs are available at http://eavesdrop.openstack.org/meetings/designate/

== Next meeting ==

Date of next meeting [http://www.timeanddate.com/worldclock/fixedtime.html?ah=1&iso=20140618T17 Wednesday 18 June, 17:00 UTC]

We are back to our regularly scheduled IRC meetings after meeting on Google Hangouts for OpenStack Atlanta Summit preparation.

=== Agenda ===

* Review action items from last week (See [http://eavesdrop.openstack.org/meetings/designate/ Meeting Logs] for previous week)
* Specific Items:
** Review [https://blueprints.launchpad.net/designate/+spec/recordsets-records-tables-redesign blueprint] for Recordsets/Records db tables redesign
** Incubation progress (kiall)
* Open Discussion

Designate/Blueprints/Records Table Redesign

2014-06-12T17:20:01Z

Betsy: /* Overview */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/recordsets-records-tables-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the record_id, the recordset_id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset_id and the IPv4 address. The MX_Record table will contain the recordset_id and the FQDN for the mail server and its preference value. See the the tables below for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| address || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| address || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| cname || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || Hostname
|-
| preference || INT ||11 || False || Lowest number has highest priority
|}

==== NS_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| nsdname || VARCHAR || 255|| False || Hostname
|}

==== PTR_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| ptrdname || VARCHAR || 255|| False || Hostname
|}

==== SOA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| mname || VARCHAR || 255 || False || Primary name server
|-
| rname || VARCHAR || 255 || False || Domain name that indicates the email address
|-
| serial || INT || 11 || False || Serial number
|-
| refresh || INT || 11 || False || Number of seconds between data refresh
|-
| retry || INT || 11 || False || Number of seconds between retries
|-
| expire || INT || 11 || False || Number of seconds before information is no longer considered authoritative
|-
| minimum || INT || 11 || False || Number of seconds that the records in the zone are valid
|}

==== SPF_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Authorized computers to send mail
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| target || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| weight || INT || 11 || False || Weight of the service
|-
| port || INT || 11 || False || Port of the service
|}

==== SSHFP_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Unique Key
|-
| recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| algorithm || TINYINT || 1|| False || 0 reserved; 1 RSA; 2 DSS
|-
| type ||TINYINT || 1 || False || 0 reserved; 1 SHA-1
|-
| fingerprint || VARCHAR || 255 || False || Fingerprint of the server public key
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Text
|}

== Comments & Discussion ==
# Could someone else verify that the Data Type, Length and Nullable fields are correct in the various records tables?

Designate/Blueprints/Records Table Redesign

2014-06-12T17:18:35Z

Betsy: /* Comments & Discussion */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/records-table-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the record_id, the recordset_id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset_id and the IPv4 address. The MX_Record table will contain the recordset_id and the FQDN for the mail server and its preference value. See the the tables below for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| address || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| address || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| cname || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || Hostname
|-
| preference || INT ||11 || False || Lowest number has highest priority
|}

==== NS_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| nsdname || VARCHAR || 255|| False || Hostname
|}

==== PTR_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| ptrdname || VARCHAR || 255|| False || Hostname
|}

==== SOA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| mname || VARCHAR || 255 || False || Primary name server
|-
| rname || VARCHAR || 255 || False || Domain name that indicates the email address
|-
| serial || INT || 11 || False || Serial number
|-
| refresh || INT || 11 || False || Number of seconds between data refresh
|-
| retry || INT || 11 || False || Number of seconds between retries
|-
| expire || INT || 11 || False || Number of seconds before information is no longer considered authoritative
|-
| minimum || INT || 11 || False || Number of seconds that the records in the zone are valid
|}

==== SPF_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Authorized computers to send mail
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| target || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| weight || INT || 11 || False || Weight of the service
|-
| port || INT || 11 || False || Port of the service
|}

==== SSHFP_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Unique Key
|-
| recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| algorithm || TINYINT || 1|| False || 0 reserved; 1 RSA; 2 DSS
|-
| type ||TINYINT || 1 || False || 0 reserved; 1 SHA-1
|-
| fingerprint || VARCHAR || 255 || False || Fingerprint of the server public key
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Text
|}

== Comments & Discussion ==
# Could someone else verify that the Data Type, Length and Nullable fields are correct in the various records tables?

Designate/Blueprints/Records Table Redesign

2014-06-12T17:17:46Z

Betsy: /* Comments & Discussion */

Designate/Blueprints/Records Table Redesign

2014-06-12T17:16:15Z

Betsy: /* TXT_Records */

Designate/Blueprints/Records Table Redesign

2014-06-12T17:14:54Z

Betsy: /* Overview */

Designate/Blueprints/Records Table Redesign

2014-06-12T17:08:30Z

Betsy: /* SSHFP_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/records-table-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the recordset id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset id and the IPv4 address. The MX_Record table will contain the recordset id and the FQDN for the mail server and its preference value. See the full specification for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| address || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| address || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| cname || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || Hostname
|-
| preference || INT ||11 || False || Lowest number has highest priority
|}

==== NS_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| nsdname || VARCHAR || 255|| False || Hostname
|}

==== PTR_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| ptrdname || VARCHAR || 255|| False || Hostname
|}

==== SOA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| mname || VARCHAR || 255 || False || Primary name server
|-
| rname || VARCHAR || 255 || False || Domain name that indicates the email address
|-
| serial || INT || 11 || False || Serial number
|-
| refresh || INT || 11 || False || Number of seconds between data refresh
|-
| retry || INT || 11 || False || Number of seconds between retries
|-
| expire || INT || 11 || False || Number of seconds before information is no longer considered authoritative
|-
| minimum || INT || 11 || False || Number of seconds that the records in the zone are valid
|}

==== SPF_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Authorized computers to send mail
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| target || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| weight || INT || 11 || False || Weight of the service
|-
| port || INT || 11 || False || Port of the service
|}

==== SSHFP_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Unique Key
|-
| recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| algorithm || TINYINT || 1|| False || 0 reserved; 1 RSA; 2 DSS
|-
| type ||TINYINT || 1 || False || 0 reserved; 1 SHA-1
|-
| fingerprint || VARCHAR || 255 || False || Fingerprint of the server public key
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Text
|}

Designate/Blueprints/Records Table Redesign

2014-06-12T17:08:06Z

Betsy: /* SSHFP_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/records-table-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the recordset id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset id and the IPv4 address. The MX_Record table will contain the recordset id and the FQDN for the mail server and its preference value. See the full specification for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| address || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| address || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| cname || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || Hostname
|-
| preference || INT ||11 || False || Lowest number has highest priority
|}

==== NS_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| nsdname || VARCHAR || 255|| False || Hostname
|}

==== PTR_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| ptrdname || VARCHAR || 255|| False || Hostname
|}

==== SOA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| mname || VARCHAR || 255 || False || Primary name server
|-
| rname || VARCHAR || 255 || False || Domain name that indicates the email address
|-
| serial || INT || 11 || False || Serial number
|-
| refresh || INT || 11 || False || Number of seconds between data refresh
|-
| retry || INT || 11 || False || Number of seconds between retries
|-
| expire || INT || 11 || False || Number of seconds before information is no longer considered authoritative
|-
| minimum || INT || 11 || False || Number of seconds that the records in the zone are valid
|}

==== SPF_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Authorized computers to send mail
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| target || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| weight || INT || 11 || False || Weight of the service
|-
| port || INT || 11 || False || Port of the service
|}

==== SSHFP_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Unique Key
|-
| recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| algorithm || TINYINT || 1|| False || 0 reserved; 1 RSA; 2 DSS
|-
| type ||TINYINT || 1 || False || 0 reserved; 1 SHA-1
|-
| fingerprint || VARCHAR || False || 255 || Fingerprint of the server public key
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Text
|}

Designate/Blueprints/Records Table Redesign

2014-06-12T17:07:06Z

Betsy: /* SRV_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/records-table-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the recordset id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset id and the IPv4 address. The MX_Record table will contain the recordset id and the FQDN for the mail server and its preference value. See the full specification for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| address || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| address || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| cname || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || Hostname
|-
| preference || INT ||11 || False || Lowest number has highest priority
|}

==== NS_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| nsdname || VARCHAR || 255|| False || Hostname
|}

==== PTR_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| ptrdname || VARCHAR || 255|| False || Hostname
|}

==== SOA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| mname || VARCHAR || 255 || False || Primary name server
|-
| rname || VARCHAR || 255 || False || Domain name that indicates the email address
|-
| serial || INT || 11 || False || Serial number
|-
| refresh || INT || 11 || False || Number of seconds between data refresh
|-
| retry || INT || 11 || False || Number of seconds between retries
|-
| expire || INT || 11 || False || Number of seconds before information is no longer considered authoritative
|-
| minimum || INT || 11 || False || Number of seconds that the records in the zone are valid
|}

==== SPF_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Authorized computers to send mail
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| target || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| weight || INT || 11 || False || Weight of the service
|-
| port || INT || 11 || False || Port of the service
|}

==== SSHFP_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Unique Key
|-
| recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| algorithm || INT || TINYINT|| False || || 0 reserved; 1 RSA; 2 DSS
|-
| type || INT || TINYINT || False || || 0 reserved; 1 SHA-1
|-
| fingerprint || VARCHAR || False || 255 || Fingerprint of the server public key
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Text
|}

Designate/Blueprints/Records Table Redesign

2014-06-12T16:56:30Z

Betsy: /* SOA_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/records-table-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the recordset id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset id and the IPv4 address. The MX_Record table will contain the recordset id and the FQDN for the mail server and its preference value. See the full specification for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| address || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| address || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| cname || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || Hostname
|-
| preference || INT ||11 || False || Lowest number has highest priority
|}

==== NS_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| nsdname || VARCHAR || 255|| False || Hostname
|}

==== PTR_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| ptrdname || VARCHAR || 255|| False || Hostname
|}

==== SOA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| mname || VARCHAR || 255 || False || Primary name server
|-
| rname || VARCHAR || 255 || False || Domain name that indicates the email address
|-
| serial || INT || 11 || False || Serial number
|-
| refresh || INT || 11 || False || Number of seconds between data refresh
|-
| retry || INT || 11 || False || Number of seconds between retries
|-
| expire || INT || 11 || False || Number of seconds before information is no longer considered authoritative
|-
| minimum || INT || 11 || False || Number of seconds that the records in the zone are valid
|}

==== SPF_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Authorized computers to send mail
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| target || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| weight || INT || 11 || False || Weight of the service
|-
| port || INT || 11 || False || Port of the service
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Text
|}

Designate/Blueprints/Records Table Redesign

2014-06-12T16:51:15Z

Betsy: /* TXT_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/records-table-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the recordset id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset id and the IPv4 address. The MX_Record table will contain the recordset id and the FQDN for the mail server and its preference value. See the full specification for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| address || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| address || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| cname || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || Hostname
|-
| preference || INT ||11 || False || Lowest number has highest priority
|}

==== NS_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| nsdname || VARCHAR || 255|| False || Hostname
|}

==== PTR_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| ptrdname || VARCHAR || 255|| False || Hostname
|}

==== SOA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| mname || VARCHAR || 255 || False || Primary name server
|-
| rname || VARCHAR || 255 || False || Domain name that indicates the email address
|-
| serial || INT || 11 || False || Serial number
|-
| refresh || INT || 11 || False || Number of seconds between data refresh
|-
| retry || INT || 11 || False || Number of seconds between retries
|-
| expire || INT || 11 || False || Number of seconds before information is no longer considered authoritative
|-
| minimum || INT || 11 || False || Number of seconds that the records in the zone are valid
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| target || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| weight || INT || 11 || False || Weight of the service
|-
| port || INT || 11 || False || Port of the service
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || Text
|}

Designate/Blueprints/Records Table Redesign

2014-06-12T16:50:59Z

Betsy: /* PTR_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/records-table-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the recordset id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset id and the IPv4 address. The MX_Record table will contain the recordset id and the FQDN for the mail server and its preference value. See the full specification for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| address || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| address || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| cname || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || Hostname
|-
| preference || INT ||11 || False || Lowest number has highest priority
|}

==== NS_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| nsdname || VARCHAR || 255|| False || Hostname
|}

==== PTR_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| ptrdname || VARCHAR || 255|| False || Hostname
|}

==== SOA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| mname || VARCHAR || 255 || False || Primary name server
|-
| rname || VARCHAR || 255 || False || Domain name that indicates the email address
|-
| serial || INT || 11 || False || Serial number
|-
| refresh || INT || 11 || False || Number of seconds between data refresh
|-
| retry || INT || 11 || False || Number of seconds between retries
|-
| expire || INT || 11 || False || Number of seconds before information is no longer considered authoritative
|-
| minimum || INT || 11 || False || Number of seconds that the records in the zone are valid
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| target || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| weight || INT || 11 || False || Weight of the service
|-
| port || INT || 11 || False || Port of the service
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || text
|}

Designate/Blueprints/Records Table Redesign

2014-06-12T16:50:51Z

Betsy: /* NS_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/records-table-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the recordset id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset id and the IPv4 address. The MX_Record table will contain the recordset id and the FQDN for the mail server and its preference value. See the full specification for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| address || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| address || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| cname || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || Hostname
|-
| preference || INT ||11 || False || Lowest number has highest priority
|}

==== NS_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| nsdname || VARCHAR || 255|| False || Hostname
|}

==== PTR_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| ptrdname || VARCHAR || 255|| False || hostname
|}

==== SOA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| mname || VARCHAR || 255 || False || Primary name server
|-
| rname || VARCHAR || 255 || False || Domain name that indicates the email address
|-
| serial || INT || 11 || False || Serial number
|-
| refresh || INT || 11 || False || Number of seconds between data refresh
|-
| retry || INT || 11 || False || Number of seconds between retries
|-
| expire || INT || 11 || False || Number of seconds before information is no longer considered authoritative
|-
| minimum || INT || 11 || False || Number of seconds that the records in the zone are valid
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| target || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| weight || INT || 11 || False || Weight of the service
|-
| port || INT || 11 || False || Port of the service
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || text
|}

Designate/Blueprints/Records Table Redesign

2014-06-12T16:50:37Z

Betsy: /* MX_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/records-table-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the recordset id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset id and the IPv4 address. The MX_Record table will contain the recordset id and the FQDN for the mail server and its preference value. See the full specification for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| address || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| address || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| cname || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || Hostname
|-
| preference || INT ||11 || False || Lowest number has highest priority
|}

==== NS_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| nsdname || VARCHAR || 255|| False || hostname
|}

==== PTR_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| ptrdname || VARCHAR || 255|| False || hostname
|}

==== SOA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| mname || VARCHAR || 255 || False || Primary name server
|-
| rname || VARCHAR || 255 || False || Domain name that indicates the email address
|-
| serial || INT || 11 || False || Serial number
|-
| refresh || INT || 11 || False || Number of seconds between data refresh
|-
| retry || INT || 11 || False || Number of seconds between retries
|-
| expire || INT || 11 || False || Number of seconds before information is no longer considered authoritative
|-
| minimum || INT || 11 || False || Number of seconds that the records in the zone are valid
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| target || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| weight || INT || 11 || False || Weight of the service
|-
| port || INT || 11 || False || Port of the service
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || text
|}

Designate/Blueprints/Records Table Redesign

2014-06-12T16:50:13Z

Betsy: /* SOA_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/records-table-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the recordset id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset id and the IPv4 address. The MX_Record table will contain the recordset id and the FQDN for the mail server and its preference value. See the full specification for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| address || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| address || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| cname || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || hostname
|-
| preference || INT ||11 || False || lowest number has highest priority
|}

==== NS_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| nsdname || VARCHAR || 255|| False || hostname
|}

==== PTR_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| ptrdname || VARCHAR || 255|| False || hostname
|}

==== SOA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| mname || VARCHAR || 255 || False || Primary name server
|-
| rname || VARCHAR || 255 || False || Domain name that indicates the email address
|-
| serial || INT || 11 || False || Serial number
|-
| refresh || INT || 11 || False || Number of seconds between data refresh
|-
| retry || INT || 11 || False || Number of seconds between retries
|-
| expire || INT || 11 || False || Number of seconds before information is no longer considered authoritative
|-
| minimum || INT || 11 || False || Number of seconds that the records in the zone are valid
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| target || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| weight || INT || 11 || False || Weight of the service
|-
| port || INT || 11 || False || Port of the service
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || text
|}

Designate/Blueprints/Records Table Redesign

2014-06-12T16:49:54Z

Betsy: /* SOA_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/records-table-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the recordset id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset id and the IPv4 address. The MX_Record table will contain the recordset id and the FQDN for the mail server and its preference value. See the full specification for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| address || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| address || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| cname || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || hostname
|-
| preference || INT ||11 || False || lowest number has highest priority
|}

==== NS_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| nsdname || VARCHAR || 255|| False || hostname
|}

==== PTR_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| ptrdname || VARCHAR || 255|| False || hostname
|}

==== SOA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| mname || VARCHAR || 255 || False || Primary name server
|-
| rname || VARCHAR || 255 || False || Domain name that indicates the email address
|-
| serial || INT || 11 || False || Serial number
|-
|
| refresh || INT || 11 || False || Number of seconds between data refresh
|-
| retry || INT || 11 || False || Number of seconds between retries
|-
| expire || INT || 11 || False || Number of seconds before information is no longer considered authoritative
|-
| minimum || INT || 11 || False || Number of seconds that the records in the zone are valid
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| target || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| weight || INT || 11 || False || Weight of the service
|-
| port || INT || 11 || False || Port of the service
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || text
|}

Designate/Blueprints/Records Table Redesign

2014-06-12T16:49:21Z

Betsy: /* PTR_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/records-table-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the recordset id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset id and the IPv4 address. The MX_Record table will contain the recordset id and the FQDN for the mail server and its preference value. See the full specification for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| address || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| address || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| cname || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || hostname
|-
| preference || INT ||11 || False || lowest number has highest priority
|}

==== NS_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| nsdname || VARCHAR || 255|| False || hostname
|}

==== PTR_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| ptrdname || VARCHAR || 255|| False || hostname
|}

==== SOA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| mname || VARCHAR || 255 || False || Primary name server
|-
| rname || VARCHAR || 255 || False || Domain name that indicates the email address
|-
| serial || INT || 11 || False || Serial number
|
| refresh || INT || 11 || False || Number of seconds between data refresh
|-
| retry || INT || 11 || False || Number of seconds between retries
|-
| expire || INT || 11 || False || Number of seconds before information is no longer considered authoritative
|-
| minimum || INT || 11 || False || Number of seconds that the records in the zone are valid
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| target || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| weight || INT || 11 || False || Weight of the service
|-
| port || INT || 11 || False || Port of the service
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || text
|}

Designate/Blueprints/Records Table Redesign

2014-06-12T16:26:46Z

Betsy: /* A_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/records-table-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the recordset id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset id and the IPv4 address. The MX_Record table will contain the recordset id and the FQDN for the mail server and its preference value. See the full specification for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| address || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| address || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| cname || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || hostname
|-
| preference || INT ||11 || False || lowest number has highest priority
|}

==== NS_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| nsdname || VARCHAR || 255|| False || hostname
|}

==== PTR_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| ptrdname || VARCHAR || 255|| False || hostname
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| target || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| weight || INT || 11 || False || Weight of the service
|-
| port || INT || 11 || False || Port of the service
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || text
|}

Designate/Blueprints/Records Table Redesign

2014-06-12T16:26:36Z

Betsy: /* AAAA_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/records-table-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the recordset id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset id and the IPv4 address. The MX_Record table will contain the recordset id and the FQDN for the mail server and its preference value. See the full specification for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| record || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| address || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| cname || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || hostname
|-
| preference || INT ||11 || False || lowest number has highest priority
|}

==== NS_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| nsdname || VARCHAR || 255|| False || hostname
|}

==== PTR_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| ptrdname || VARCHAR || 255|| False || hostname
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| target || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| weight || INT || 11 || False || Weight of the service
|-
| port || INT || 11 || False || Port of the service
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || text
|}

Designate/Blueprints/Records Table Redesign

2014-06-12T16:26:12Z

Betsy: /* CNAME_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/records-table-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the recordset id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset id and the IPv4 address. The MX_Record table will contain the recordset id and the FQDN for the mail server and its preference value. See the full specification for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| record || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| record || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| cname || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || hostname
|-
| preference || INT ||11 || False || lowest number has highest priority
|}

==== NS_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| nsdname || VARCHAR || 255|| False || hostname
|}

==== PTR_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| ptrdname || VARCHAR || 255|| False || hostname
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| target || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| weight || INT || 11 || False || Weight of the service
|-
| port || INT || 11 || False || Port of the service
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || text
|}

Designate/Blueprints/Records Table Redesign

2014-06-12T16:25:37Z

Betsy: /* NS_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/records-table-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the recordset id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset id and the IPv4 address. The MX_Record table will contain the recordset id and the FQDN for the mail server and its preference value. See the full specification for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| record || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| record || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| record || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || hostname
|-
| preference || INT ||11 || False || lowest number has highest priority
|}

==== NS_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| nsdname || VARCHAR || 255|| False || hostname
|}

==== PTR_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| ptrdname || VARCHAR || 255|| False || hostname
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| target || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| weight || INT || 11 || False || Weight of the service
|-
| port || INT || 11 || False || Port of the service
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || text
|}

Designate/Blueprints/Records Table Redesign

2014-06-12T16:24:27Z

Betsy: /* MX_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/records-table-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the recordset id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset id and the IPv4 address. The MX_Record table will contain the recordset id and the FQDN for the mail server and its preference value. See the full specification for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| record || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| record || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| record || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || hostname
|-
| preference || INT ||11 || False || lowest number has highest priority
|}

==== NS_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| nsdname || VARCHAR || 255|| False || hostname
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| target || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| weight || INT || 11 || False || Weight of the service
|-
| port || INT || 11 || False || Port of the service
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || text
|}

Designate/Blueprints/Records Table Redesign

2014-06-12T16:18:43Z

Betsy: /* TXT_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/records-table-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the recordset id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset id and the IPv4 address. The MX_Record table will contain the recordset id and the FQDN for the mail server and its preference value. See the full specification for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| record || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| record || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| record || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || hostname
|-
| preference || INT ||11 || False || lowest number has highest priority
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| target || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| weight || INT || 11 || False || Weight of the service
|-
| port || INT || 11 || False || Port of the service
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| text || VARCHAR || 255|| False || text
|}

Designate/Blueprints/Records Table Redesign

2014-06-12T16:17:28Z

Betsy: /* SRV_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/records-table-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the recordset id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset id and the IPv4 address. The MX_Record table will contain the recordset id and the FQDN for the mail server and its preference value. See the full specification for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| record || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| record || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| record || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || hostname
|-
| preference || INT ||11 || False || lowest number has highest priority
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| target || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| weight || INT || 11 || False || Weight of the service
|-
| port || INT || 11 || False || Port of the service
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 255|| False || CNAME
|}

Designate/Blueprints/Records Table Redesign

2014-06-12T16:14:58Z

Betsy: /* SRV_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/records-table-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the recordset id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset id and the IPv4 address. The MX_Record table will contain the recordset id and the FQDN for the mail server and its preference value. See the full specification for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| record || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| record || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| record || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || hostname
|-
| preference || INT ||11 || False || lowest number has highest priority
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| record || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| protocol ||
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 255|| False || CNAME
|}

Designate/Blueprints/Records Table Redesign

2014-06-12T16:14:04Z

Betsy: /* CNAME_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/records-table-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the recordset id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset id and the IPv4 address. The MX_Record table will contain the recordset id and the FQDN for the mail server and its preference value. See the full specification for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| record || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| record || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| record || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || hostname
|-
| preference || INT ||11 || False || lowest number has highest priority
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| protocol ||
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 255|| False || CNAME
|}

Designate/Blueprints/Records Table Redesign

2014-06-12T16:13:45Z

Betsy: /* MX_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/records-table-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the recordset id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset id and the IPv4 address. The MX_Record table will contain the recordset id and the FQDN for the mail server and its preference value. See the full specification for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| record || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| record || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
||id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| exchange || VARCHAR || 255|| False || hostname
|-
| preference || INT ||11 || False || lowest number has highest priority
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| protocol ||
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 255|| False || CNAME
|}

Designate/Blueprints/Records Table Redesign

2014-06-12T16:10:00Z

Betsy: /* AAAA_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/records-table-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the recordset id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset id and the IPv4 address. The MX_Record table will contain the recordset id and the FQDN for the mail server and its preference value. See the full specification for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| record || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| record || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 255|| False || CNAME
|-
| priority || INT ||11 || False || lowest number has highest priority
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| protocol ||
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 255|| False || CNAME
|}

Designate/Blueprints/Records Table Redesign

2014-06-12T16:08:40Z

Betsy: /* RecordSets */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/records-table-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the recordset id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset id and the IPv4 address. The MX_Record table will contain the recordset id and the FQDN for the mail server and its preference value. See the full specification for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 32 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| record || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 255|| False || CNAME
|-
| priority || INT ||11 || False || lowest number has highest priority
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| protocol ||
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 255|| False || CNAME
|}

Designate/Blueprints/Records Table Redesign

2014-06-12T16:07:47Z

Betsy: /* A_Records */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/records-table-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the recordset id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset id and the IPv4 address. The MX_Record table will contain the recordset id and the FQDN for the mail server and its preference value. See the full specification for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 36 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 36 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
|id || CHAR || 32 || False || UUID, Unique Key
|-
|recoredset_id || CHAR || 32 || False || Non-unique Key
|-
| record || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 255|| False || CNAME
|-
| priority || INT ||11 || False || lowest number has highest priority
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| protocol ||
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 255|| False || CNAME
|}

Designate/Blueprints/Records Table Redesign

2014-06-04T14:28:10Z

Betsy: /* A_RecordSets */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/records-table-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the recordset id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset id and the IPv4 address. The MX_Record table will contain the recordset id and the FQDN for the mail server and its preference value. See the full specification for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 36 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 36 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 255|| False || CNAME
|-
| priority || INT ||11 || False || lowest number has highest priority
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| protocol ||
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 255|| False || CNAME
|}

Designate/Blueprints/Records Table Redesign

2014-05-30T19:49:31Z

Betsy: /* A_RecordSets */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/records-table-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the recordset id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset id and the IPv4 address. The MX_Record table will contain the recordset id and the FQDN for the mail server and its preference value. See the full specification for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== A_RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 36 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 36 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 255|| False || CNAME
|-
| priority || INT ||11 || False || lowest number has highest priority
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| protocol ||
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 255|| False || CNAME
|}

Designate/Blueprints/Records Table Redesign

2014-05-30T19:49:13Z

Betsy: /* A_RecordSets */

== Overview ==

{| class="wikitable"
|-
! Gerrit Patch || []
|-
! Launchpad Blueprint || [https://blueprints.launchpad.net/designate/+spec/records-table-redesign]
|}

Currently, there is only one RecordSets table and one Records table for all the different record types. This blueprint proposes to subdivide those tables into a RecordSet table and Record table per record type.

Having one monolithic RecordSets table and Records table for all record types can become problematic as the size of the table grows. If any modifications need to be made, for example, adding a column, the entire table would have to be locked and it could take a long time to update a table with millions of records. In addition, if a table gets too large, it has to be sharded, which involves writing a lot of code to know which shard to call for which records. On the other hand, joins across tables are not a problem, as long as the indexing is done correctly. In addition, having a table per record type is a proven DNS database design as some companies have already implemented it in this fashion and have millions of records.

Most of the information that is currently in the Records table will be consolidated into the RecordSet table. The Records table for each type will only contain the recordset id and the unique data for that particular record type. For instance, the A_Record table will contain the recordset id and the IPv4 address. The MX_Record table will contain the recordset id and the FQDN for the mail server and its preference value. See the full specification for more detail.

== Database Schema Changes ==

The existing Recordset table and Records table will become obsolete and be replaced with new tables for each record type.
=== Existing Tables ===

==== Recordsets Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || UUID, Primary Key
|-
| created_at || datetime || - || True || Time of creation
|-
| updated_at || datetime || - || True || Time of last update
|-
| version || INT || 11 || False || Designate API version
|-
| tenant_id || VARCHAR || 36 || True || ID of recordset owner
|-
| domain_id || CHAR || 32 || False || Non-unique Key
|-
| name || VARCHAR || 255 || False || Recordset name
|-
| type || ENUM || - || False || A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP
|-
| ttl || INT || 11 || True || time to live
|-
| description || VARCHAR || 160 || True || Description of Recordset
|}

==== Records Table ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || True || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| data || MEDIUMTEXT || - || False || Data unique to a specific record
|-
| priority || INTEGER || 11 || True || Priority value for certain types of records
|-
| domain_id || CHAR || 32 || False || Non-unique Key, Domain ID
|-
| managed || TINYINT || 1 || True || Boolean value indicates a managed resource
|-
| managed_resource_type || VARCHAR || 50 || True || Managed resource type
|-
| managed_resource_id || CHAR || 32 || True || Managed resource id
|-
| managed_plugin_name || VARCHAR || 50 || True || Managed plugin name
|-
| managed_plugin_type || VARCHAR || 50 || True || Managed plugin type
|-
| hash || VARCHAR || 32 || False || Unique Key, Hash value of record
|-
| description || VARCHAR || 160 || True || Description of record
|-
| status || ENUM("Active", "Pending", "Deleted") || - || False || Record status
|-
| tenant_id || VARCHAR || 36 || True || ID of record owner
|-
| recordset_id || CHAR || 32 || False || Non-unique Key, ID of recordset
|-
| managed_tenant_id || CHAR || 32 || True || ID of managed owner
|-
| managed_resource_region || VARCHAR || 100 || True || Region of managed
|-
| managed_extra || VARCHAR || 100 || True || Extra field
|}

=== New Tables ===

==== A_RecordSets ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| id || CHAR || 32 || False || Primary Key, Generated UUID
|-
| created_at || DATETIME || - || False || UTC time of creation
|-
| updated_at || DATETIME || - || True || UTC time of last update
|-
| version || INTEGER || 11 || False || Designate API version
|-
| tenant_id || CHAR || 36 || True || The tenant_id to which the record belongs
|-
| domain_id || CHAR || 36 || False || Non-Unique Key; the domain_id to which the record belongs
|-
| name || VARCHAR || 255 || False || The zone to which the A record belongs
|-
| ttl || INTEGER || 11 || True || The time-to-live assigned to the record
|-
| description || VARCHAR || 160 || True || A description of the record
|-
| status || ENUM || 'Active', 'Pending', 'Deleted' || False || Current status of RecordSet
|-
| hash || VARCHAR || 32 || False || Unique Key
|-
| managed || TINYINT || 1 || True || Indicates whether it is managed or not
|-
| managed_resource_type || VARCHAR || 50 || True ||
|-
| managed_resource_id || CHAR || 32 || True ||
|-
| managed_plugin_name || VARCHAR || 50 || True ||
|-
| managed_plugin_type || VARCHAR || 50 || True ||
|-
| managed_tenant_id || VARCHAR || 36 || True ||
|-
| managed_resource_region || VARCHAR || 100 || True ||
|-
| managed_extra || VARCHAR || 100 || True ||
|}

==== A_Records ====

{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 15 || False || iPv4
|}

==== AAAA_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || BINARY || 16|| False || iPv6 address
|}

==== CNAME_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 255|| False || CNAME
|}

==== MX_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 255|| False || CNAME
|-
| priority || INT ||11 || False || lowest number has highest priority
|}

==== SRV_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 255|| False || Name of the service
|-
| priority || INT || 11 || False || Priority of the service
|-
| protocol ||
|}

==== TXT_Records ====
{| class="wikitable"
|-
! Name !! Data Type !! Length !! Nullable !! Details
|-
| recordset_id || VARCHAR || 32 || False || UUID, Unique Key
|-
| record || VARCHAR || 255|| False || CNAME
|}