UserDefinedFunctions class
Usado para criar, upsert, consultar ou ler todas as funções definidas pelo usuário.
Consulte UserDefinedFunction para ler, substituir ou excluir uma determinada função definida pelo usuário por id.
Propriedades
container |
Métodos
create(User |
Crie um UserDefinedFunction. O Azure Cosmos DB dá suporte a UDFs JavaScript que podem ser usadas dentro de consultas, procedimentos armazenados e gatilhos. Para obter detalhes adicionais, consulte a documentação da API JavaScript do lado do servidor. exemplo
|
query(Sql |
Consultar todas as funções definidas pelo usuário. |
query<T>(Sql |
Consultar todas as funções definidas pelo usuário. exemplo
|
read |
Leia todas as funções definidas pelo usuário. exemplo Leia todas as funções definidas pelo usuário na matriz.
|
Detalhes da propriedade
container
Detalhes do método
create(UserDefinedFunctionDefinition, RequestOptions)
Crie um UserDefinedFunction.
O Azure Cosmos DB dá suporte a UDFs JavaScript que podem ser usadas dentro de consultas, procedimentos armazenados e gatilhos.
Para obter detalhes adicionais, consulte a documentação da API JavaScript do lado do servidor.
exemplo
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; }",
};
const { resource: udf } = await container.scripts.userDefinedFunctions.create(udfDefinition);
function create(body: UserDefinedFunctionDefinition, options?: RequestOptions): Promise<UserDefinedFunctionResponse>
Parâmetros
- options
- RequestOptions
Retornos
Promise<UserDefinedFunctionResponse>
query(SqlQuerySpec, FeedOptions)
Consultar todas as funções definidas pelo usuário.
function query(query: SqlQuerySpec, options?: FeedOptions): QueryIterator<any>
Parâmetros
- query
- SqlQuerySpec
Configuração de consulta para a operação. Consulte sqlQuerySpec para obter mais informações sobre como configurar uma consulta.
- options
- FeedOptions
Retornos
QueryIterator<any>
query<T>(SqlQuerySpec, FeedOptions)
Consultar todas as funções definidas pelo usuário.
exemplo
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 querySpec = {
query: "SELECT * FROM root r WHERE r.id=@id",
parameters: [
{
name: "@id",
value: "<udf-id>",
},
],
};
const { resources: results } = await container.scripts.userDefinedFunctions
.query(querySpec)
.fetchAll();
function query<T>(query: SqlQuerySpec, options?: FeedOptions): QueryIterator<T>
Parâmetros
- query
- SqlQuerySpec
Configuração de consulta para a operação. Consulte sqlQuerySpec para obter mais informações sobre como configurar uma consulta.
- options
- FeedOptions
Retornos
readAll(FeedOptions)
Leia todas as funções definidas pelo usuário.
exemplo
Leia todas as funções definidas pelo usuário na matriz.
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 { resources: udfList } = await container.scripts.userDefinedFunctions.readAll().fetchAll();
function readAll(options?: FeedOptions): QueryIterator<UserDefinedFunctionDefinition & Resource>
Parâmetros
- options
- FeedOptions