Compartir a través de


IDocumentClient.CreateUserDefinedFunctionAsync Método

Definición

Sobrecargas

CreateUserDefinedFunctionAsync(String, UserDefinedFunction, RequestOptions)

Crea una función definida por el usuario como una operación asincrónica en el servicio Azure Cosmos DB.

CreateUserDefinedFunctionAsync(Uri, UserDefinedFunction, RequestOptions)

Crea una función definida por el usuario como una operación asincrónica en el servicio Azure Cosmos DB.

CreateUserDefinedFunctionAsync(String, UserDefinedFunction, RequestOptions)

Crea una función definida por el usuario como una operación asincrónica en el servicio Azure Cosmos DB.

public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.UserDefinedFunction>> CreateUserDefinedFunctionAsync (string collectionLink, Microsoft.Azure.Documents.UserDefinedFunction function, Microsoft.Azure.Documents.Client.RequestOptions options = default);
abstract member CreateUserDefinedFunctionAsync : string * Microsoft.Azure.Documents.UserDefinedFunction * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.UserDefinedFunction>>
Public Function CreateUserDefinedFunctionAsync (collectionLink As String, function As UserDefinedFunction, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of UserDefinedFunction))

Parámetros

collectionLink
String

Vínculo de para DocumentCollection crear la función definida por el usuario en . Por ejemplo, dbs/db_rid/colls/col_rid/

function
UserDefinedFunction

Objeto UserDefinedFunction que se va a crear.

options
RequestOptions

(Opcional) Cualquiera RequestOptionspara esta solicitud.

Devoluciones

Objeto de tarea que representa la respuesta del servicio para la operación asincrónica.

Excepciones

Si se establece o collectionLinkfunction no.

Representa una consolidación de errores que se produjeron durante el procesamiento asincrónico. Busque en InnerExceptions para buscar las excepciones reales.

Esta excepción puede encapsular muchos tipos diferentes de errores. Para determinar el error específico, examine siempre la propiedad StatusCode. Algunos códigos comunes que puede obtener al crear un documento son:

StatusCodeMotivo de la excepción
400BadRequest: esto significa que algo estaba mal con la solicitud proporcionada. Es probable que no se haya proporcionado un identificador para la nueva función definida por el usuario o que el cuerpo tenga un formato incorrecto.
403Prohibido: ha alcanzado la cuota de funciones definidas por el usuario para la colección proporcionada. Póngase en contacto con el soporte técnico para aumentar esta cuota.
409Conflicto: esto significa que un UserDefinedFunction elemento con un identificador que coincide con el identificador que proporcionó ya existía.
413RequestEntityTooLarge: esto significa que el cuerpo del UserDefinedFunction que intentó crear era demasiado grande.

Ejemplos

//Create a user defined function that converts a string to upper case
UserDefinedFunction udf = client.CreateUserDefinedFunctionAsync(collectionLink, new UserDefinedFunction
{
   Id = "ToUpper",
   Body = @"function toUpper(input) {
                       return input.toUpperCase();
                    }",
});

Consulte también

Se aplica a

CreateUserDefinedFunctionAsync(Uri, UserDefinedFunction, RequestOptions)

Crea una función definida por el usuario como una operación asincrónica en el servicio Azure Cosmos DB.

public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.UserDefinedFunction>> CreateUserDefinedFunctionAsync (Uri documentCollectionUri, Microsoft.Azure.Documents.UserDefinedFunction function, Microsoft.Azure.Documents.Client.RequestOptions options = default);
abstract member CreateUserDefinedFunctionAsync : Uri * Microsoft.Azure.Documents.UserDefinedFunction * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.UserDefinedFunction>>
Public Function CreateUserDefinedFunctionAsync (documentCollectionUri As Uri, function As UserDefinedFunction, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of UserDefinedFunction))

Parámetros

documentCollectionUri
Uri

URI de la colección de documentos en el que se va a crear la función definida por el usuario.

options
RequestOptions

(Opcional) para RequestOptions la solicitud.

Devoluciones

Objeto de tarea que representa la respuesta del servicio para la operación asincrónica.

Se aplica a