alter applied function replication definition

Description

Changes the function replication definition created by the create applied function replication definition command.

Syntax

alter applied function replication definition repdef_name
        {with replicate function named ‘func_name’ |
        add @param_name datatype[, @param_name datatype]… |
        add searchable parameters @param_name[, @param_name]… |
         send standby {all | replication definition} parameters}

Parameters

repdef_name

The name of the applied function replication definition to change.

with replicate function named 'func_name'

Specifies the name of the stored procedure to execute at the replicate database. func_name is a character string with a maximum length of 255 characters.

add

Adds parameters and their datatypes to the applied function replication definition.

@param_name

The name of a parameter you are adding to the list of replicated or searchable parameters. Each parameter name must begin with the @ character.

datatype

The datatype of the parameter you are adding to the parameter list. See “Datatypes” for a list of the datatypes and their syntax. Adaptive Server stored procedures and function replication definitions cannot contain parameters with the text, unitext, rawobject, and image datatypes.

add searchable parameters

Specifies additional parameters that you can use in the where clause of the create subscription or define subscription command.

send standby

In a warm standby application, specifies whether to send all parameters in the function (send standby all parameters) or only those specified in the replication definition (send standby replication definition parameters), to a standby database. The default is send standby all parameters.

Examples

Example 1

Adds the @notes, @pubdate, and @contract parameters to the titles_frep function replication definition:

alter applied function replication definition titles_frep
add @notes varchar(200), @pubdate datetime, @contract bit

Example 2

Adds the @type and @pubdate parameters to the list of searchable parameters in the titles_frep function replication definition:

alter applied function replication definition titles_frep
add searchable parameters @type, @pubdate

Example 3

Changes the titles_frep function replication definition to be replicated as the newtitles stored procedure at the replicate database:

alter applied function replication definition titles_frep
with replicate function named  'newtitles'

Usage

Permissions

alter applied function replication definition requires “create object” permission.

See also

alter function string, alter request function replication definition, create applied function replication definition, create request function replication definition,