View Source Memento.Schema (memento v0.4.1)

Module to interact with the database schema.

For persisting data, Mnesia databases need to be created on disk. This module provides an interface to create the database on the disk of the specified nodes. Most of the time that is usually the node that the application is running on.

# Create schema on current node
Memento.Schema.create([ node() ]

# Create schema on many nodes
node_list = [node(), :alice@host_x, :bob@host_y, :eve@host_z]
Memento.Schema.create(node_list)

Important thing to note here is that only the nodes where data has to be persisted to disk have to be included. RAM-only nodes should be left out. Disk schemas can also be deleted by calling delete/1 and you can get information about them by calling info/0.

Example

# The nodes where you want to persist
nodes = [ node() ]

# Create the schema
Memento.stop
Memento.Schema.create(nodes)
Memento.start

# Create disc copies of your tables
Memento.Table.create!(TableA, disc_copies: nodes)
Memento.Table.create!(TableB, disc_copies: nodes)

Summary

Functions

create(nodes)

Creates a new database on disk on the specified nodes.

delete(nodes)

Deletes the database previously created by create/1 on the specified nodes.

info()

Prints schema information about all Tables to the console.

info(table)

Prints schema information about the specified Table to the console.

set_storage_type(node, type)

Sets the schema storage mode for the specified node.

Functions

create(nodes)

@spec create([node()]) :: :ok | {:error, any()}

Creates a new database on disk on the specified nodes.

Calling :mnesia.create_schema for a custom path throws an exception if that path does not exist. Memento's version avoids this by ensuring that the directory exists.

Also see :mnesia.create_schema/1.

delete(nodes)

@spec delete([node()]) :: :ok | {:error, any()}

Deletes the database previously created by create/1 on the specified nodes.

Use this with caution, as it makes persisting data obsolete. Also see :mnesia.delete_schema/1.