CreateFunction

Copied!
( param_object )

Description

The CreateFunction operation adds a new user-defined function with the specified parameters.

Parameters

Argument Type Definition and Requirements

param_object

Object

The param_object fields are described below.

param_object

Field Name Field Type Definition and Requirements

name

String

The logical name of the function.

body

Object

The Fauna Query Language instructions to be executed.

data

Object

Optional - This is user-defined metadata for the user-defined function. It is provided for the developer to store information at the function level.

role

String or Role Reference

Optional - Specifies the role that should be used when the user-defined function is called, which would typically be used to provide privilege escalation when current privileges would otherwise be too restrictive.

To use a built-in role, specify one of the strings admin, server, server-readonly, client. To use a user-defined role, specify a Role reference, e.g. Role("admin").

role can only be set by users with a privileged role, such as admin, server, or a user-defined role that grants write privilege for functions.

Use role carefully! Setting role to admin, server, or any other privileged role gives your function permission to create/modify/remove any documents when invoked by any caller. Users that can write functions can adjust role to change the function’s privileges.

Returns

An object containing the metadata of CreateFunction operations.

Field Name Field Type Definition and Requirements

ref

Reference

The reference is an automatically-generated, unique identifier within the database to identify the function that was created.

name

String

The logical name of the function created.

role

String or Role Reference

The role that should be used when the function is called. Only included when role is specified in param_object.

ts

Integer

The timestamp, with microsecond resolution, associated with the creation of the function.

body

Object

The Fauna Query Language instructions to be executed.

Examples

The following query creates a user-defined function called "double":

Copied!
client.query(
  q.({
    name: 'double',
    body: q.(
      q.('x', q.(q.('x'), q.('x')))
    ),
  })
)
.then((ret) => console.log(ret))
{ ref: (id=double, collection=(id=functions)),
  ts: 1527275011179623,
  name: 'double',
  body: ("[object Object]") }

Is this article helpful? 

Tell Fauna how the article can be improved:
 Visit Fauna's forums or email docs@fauna.com

Thank you for your feedback!