Skip to content

sinfin/pg_sequencer

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

64 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

pg_sequencer

pg_sequencer adds methods to your migrations to allow you to create, drop and change sequence objects in PostgreSQL. It also dumps sequences to schema.rb.

This is especially useful if you are connecting to a legacy database where the primary key field is declared as an INTEGER and a sequence is queried for the value of the next record.

The design of pg_sequencer is heavily influenced on Matthew Higgins’ Foreigner gem:

Installation

Add this to your Gemfile:

gem 'pg_sequencer'

API

pg_sequencer adds the following methods to migrations:

  • create_sequence(sequence_name, options)

  • change_sequence(sequence_name, options)

  • drop_sequence(sequence_name)

The methods closely mimic the syntax of the PostgreSQL SQL for CREATE SEQUENCE, DROP SEQUENCE and ALTER SEQUENCE. See the REFERENCES section below for more information.

Options

For create_sequence and change_sequence, all options are the same, except create_sequence will look for :start or :start_with, and change_sequence will look for :restart or :restart_with.

  • :increment/:increment_by (integer) - The value to increment the sequence by.

  • :min (integer/false) - The minimum value of the sequence. If specified as false (e.g. :min => false), “NO MINVALUE” is sent to Postgres.

  • :max (integer/false) - The maximum value of the sequence. May be specified as “:max => false” to generate “NO MAXVALUE”

  • :start/:start_with (integer) - The starting value of the sequence (create_sequence only)

  • :restart/:restart_with (integer) The value to restart the sequence with (change_sequence only)

  • :cache (integer) - The number of values the sequence should cache.

  • :cycle (boolean) - Whether the sequence should cycle. Generated at “CYCLE” or “NO CYCLE”

Examples

Creating a sequence

Create a sequence called “seq_user”, incrementing by 1, min of 1, max of 2000000, starts at 1, caches 10 values, and disallows cycles:

create_sequence("seq_user", {
  :increment => 1,
  :min => 1,
  :max => 2000000,
  :start => 1,
  :cache => 10,
  :cycle => false
})

This is equivalent of the following query:

CREATE SEQUENCE seq_user INCREMENT BY 1 MIN 1 MAX 2000000 START 1 CACHE 10 NO CYCLE

If sequence already exists, creation is skipped. If You pass option ‘drop_if_exists: true`, than existing one is dropped and new is created.

Reset a sequence’s value:

change_sequence "seq_accounts", :restart_with => 50

This is equivalent to:

ALTER SEQUENCE seq_accounts RESTART WITH 50

Removing a sequence:

drop_sequence "seq_products"

Caveats / Bugs

  • Tested with postgres 11.7, should work down to 8.4.

  • Listing all the sequences in a database creates n+1 queries (1 to get the names and n to describe each sequence). Is there a way to fully describe all sequences in a database in one query?

  • The “SET SCHEMA” fragment of the ALTER command is not implemented.

  • Oracle/other databases not supported

  • Other unknown bugs :)

References

About

Create and dump postgres sequences in your Rails app!

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Ruby 100.0%