MusicBrainz Database/Schema

From MusicBrainz Wiki
< MusicBrainz Database
Revision as of 06:43, 21 April 2009 by Zout (talk | contribs) (Tracklist: little formatting)

Objects

Artist

Same as our current artist entity, but with new "country" and "gender" attributes.

Artist Credit

List of artists, variations of artist names and pieces of text to join the artist names. Examples:

Release Group

Represents an abstract "album" entity. Technically it's a group of releases, with a specified type. The type is the same as current release type. Examples:

Release

Real-world release object you can buy in your music store. It has release date and country, list of catalog number and label pairs, packaging type and release status. Example:

  • 1984 US release of "The Wall" by "Pink Floyd", release on label "Columbia Records" with catalog number "C2K 36183" and UPC "074643618328", it's an official release and comes with two CDs in jewel case.

Medium

Piece of physical media, included in a release. It has information about the format, position in the release and an optional title. Example:

  • CD1 of the 1984 US release of "The Wall" by "Pink Floyd"
  • CD2 of the 2005 UK release of "Aerial" by "Kate Bush", named "A Sky of Honey"

Tracklist

Simple list of tracks. Tracklists are used by mediums.

Tracklist Track

This object is not visible to users on it's own, only in the context of a tracklist. It contains a link to a track, title, artist credit and the position on the tracklist.

Track

Represents the "master" track. Has title, artist credit, duration, list of PUIDs and ISRCs. Examples:

  • Album version of the track "Into the Blue" by "Moby"
  • Remix "Into the Blue (Buzz Boys Main Room Mayhem mix)" by "Moby"
  • Remix "Into the Blue (Underground mix)" by "Moby"

Work

One layer above the master tracks ("song", "composition", etc.). While track represents unique audio data, work represents the abstract idea behind the track.

  • Song "Into the Blue" by "Moby" -- all the tracks listed above will be linked to this object

Label

Same as our current label entity.

Database Schema

This diagrams shows the core database tables and relationships between them:

ngs.png

Because we are adding new core entities, and there are plans for adding more, ARs between them need to be optimized. Only the absolutely necessary information is in l_*_* tables, everything else is shared:

ngs-ars.png

Data Dictionary

  • artist = @id + @gid + name + sort name + (type) + (begin date) + (end date) + (country) + (comment) + {artist alias}
  • artist alias = @id + name
  • artist credit = @id + 1{artist + name + (join phrase)}
  • label = @id + @gid + name + sort name + (label code) + (type) + (begin date) + (end date) + (country) + (comment) + {label alias}
  • label alias = @id + name
  • release group = @id + @gid + artist credit + name + (type) + (comment) + {release}
  • release = @id + @gid + artist credit + name + (barcode) + (date) + (country) + (status) + (packaging) + (language) + (script) + {label + catalog number} + {medium} + (comment)
  • medium = @id + position + (format) + (name) + tracklist
  • tracklist = @id + 1{track + name + artist credit + position}
  • track = @id + @gid + artist credit + name + length + (comment) + {puid} + {isrc}
  • work = @id + @gid + artist credit + name + {work alias}
  • work alias = @id + name
  • date = (year) + (month) + (day)

Code Changes

TODO

http://java.sun.com/blueprints/corej2eepatterns/Patterns/DataAccessObject.html

Caching

  • memcache:
    • MBID are cached in an additional layer to avoid duplication, instead of UUID -> object, there is UUID -> rowid, and then rowid -> object.
    • Used to store:
      • artist credits
      • artists
      • labels
      • links
      • (maybe release groups?)
  • Local in-process cache:
    • Very fast access, but we have no control over invalidating it in all processes, so there needs to be low TTL for all cached items.
    • Used to store:
      • release group types
      • release statuses
      • release packaging types
      • medium formats
      • artist types
      • label types
      • countries
      • scripts
      • languages