UserDefinedFunction class
Used to read, replace, or delete a specified User Definied Function by id.
See UserDefinedFunction to create, upsert, query, read all User Defined Functions.
Properties
container | |
id | |
url | Returns a reference URL to the resource. Used for linking in Permissions. |
Methods
delete(Request |
Delete the given <xref:UserDefined>. Example
|
read(Request |
Read the UserDefinedFunctionDefinition for the given UserDefinedFunction. Example
|
replace(User |
Replace the given UserDefinedFunction with the specified UserDefinedFunctionDefinition. Example
|
Property Details
container
id
id: string
Property Value
string
url
Returns a reference URL to the resource. Used for linking in Permissions.
string url
Property Value
string
Method Details
delete(RequestOptions)
Delete the given <xref:UserDefined>.
Example
import { CosmosClient } from "@azure/cosmos";
const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });
const { database } = await client.databases.createIfNotExists({ id: "Test Database" });
const { container } = await database.containers.createIfNotExists({ id: "Test Container" });
await container.scripts.userDefinedFunction("<udf-id>").delete();
function delete(options?: RequestOptions): Promise<UserDefinedFunctionResponse>
Parameters
- options
- RequestOptions
Returns
Promise<UserDefinedFunctionResponse>
read(RequestOptions)
Read the UserDefinedFunctionDefinition for the given UserDefinedFunction.
Example
import { CosmosClient } from "@azure/cosmos";
const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });
const { database } = await client.databases.createIfNotExists({ id: "Test Database" });
const { container } = await database.containers.createIfNotExists({ id: "Test Container" });
const { resource: udf } = await container.scripts.userDefinedFunction("<udf-id>").read();
function read(options?: RequestOptions): Promise<UserDefinedFunctionResponse>
Parameters
- options
- RequestOptions
Returns
Promise<UserDefinedFunctionResponse>
replace(UserDefinedFunctionDefinition, RequestOptions)
Replace the given UserDefinedFunction with the specified UserDefinedFunctionDefinition.
Example
import { CosmosClient, UserDefinedFunctionDefinition } from "@azure/cosmos";
const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });
const { database } = await client.databases.createIfNotExists({ id: "Test Database" });
const { container } = await database.containers.createIfNotExists({ id: "Test Container" });
const udfDefinition: UserDefinedFunctionDefinition = {
id: "sample udf",
body: "function () { const x = 10; }",
};
await container.scripts.userDefinedFunctions.create(udfDefinition);
udfDefinition.body = "function () { const x = 20; }";
const { resource: replacedUdf } = await container.scripts
.userDefinedFunction(udfDefinition.id)
.replace(udfDefinition);
function replace(body: UserDefinedFunctionDefinition, options?: RequestOptions): Promise<UserDefinedFunctionResponse>
Parameters
- options
- RequestOptions
Returns
Promise<UserDefinedFunctionResponse>