'\" -*- coding: us-ascii -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH "SLONIK SET ADD SEQUENCE" 7 "24 July 2014" "" "Slony-I 2.2.3 Documentation"
.SH NAME
SET ADD SEQUENCE \- Add a sequence to a Slony-I replication set 
.SH SYNOPSIS
'nh
.fi
.ad l
\fBSET ADD SEQUENCE (options);\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
'in \n(.iu-\nxu
.ad b
'hy
.SH DESCRIPTION
Add an existing user sequence to a replication set. The set
cannot currently be subscribed by any other node - that
functionality is supported by the \fBSLONIK MERGE
SET\fR(7)
command.
.TP 
\*(T<SET ID = ival \*(T>
ID of the set to which the sequence is to be added.
.TP 
\*(T<ORIGIN = ival \*(T>
Origin node for the set. (optional) 
.TP 
\*(T<ID = ival \*(T>
Unique ID of the sequence. 
.RS 
\fBNote\fR

Note
that this ID needs to be unique \fIacross
sequences\fR throughout the cluster; the numbering of
tables is separate, so you might have a table with ID 20 and a
sequence with ID 20, and they would be recognized as
separate.
.RE

This parameter is optional. 
If this parameter is omitted
then slonik will check every node that it can connect to and find the 
highest table id being used across all nodes. 
.TP 
\*(T<FULLY QUALIFIED NAME = 'string' \*(T>
The full sequence name including schema name.
If \*(T<SEQUENCES\*(T> is specified then
\*(T<FULLY QUALIFIED NAME\*(T> should be omitted.
.TP 
\*(T<SEQUENCES = 'string' \*(T>
A POSIX regular expression that matches to the
sequences that should be added to the replication set.
This regular expression is passed to postgresql for evaluation
on the set origin against fully qualified sequence names. This
parameter is optional. If \*(T<FULLY QUALIFIED NAME\*(T>
is omitted then
\*(T<SEQUENCES\*(T> must be specified. 
.TP 
\*(T<COMMENT = 'string' \*(T>
A descriptive text added to the sequence entry. 
.PP
This uses \(lqschemadocsetaddsequence(p_seq_comment integer, p_fqname integer, p_seq_id text, p_set_id text)\(rq [not available as a man page]. 
.SH EXAMPLE
.nf
\*(T<     SET ADD SEQUENCE (
     SET ID = 1,
     ORIGIN = 1,
     ID = 20,
     FULLY QUALIFIED NAME = 'public.tracker_ticket_id_seq',
     COMMENT = 'Support ticket ID sequence'
     );

	 or

	 SET ADD SEQUENCE(
	 SET ID=1,
	 SEQUENCES='public.tracker_ticket_id_seq'
	 );


    \*(T>
.fi
.SH "LOCKING BEHAVIOUR "
No application-visible locking should take place. 
.SH "SLONIK EVENT CONFIRMATION BEHAVIOUR "
Slonik waits for the command submitted to the previous
event node to be confirmed on the specified event node before
submitting this command.
.SH "VERSION INFORMATION "
This command was introduced in Slony-I 1.0