DocumentClient.CreateStoredProcedureAsync Methode

Definition

Namespace:

Microsoft.Azure.Documents.Client

Assemblys:

Microsoft.Azure.DocumentDB.Core.dll, Microsoft.Azure.Documents.Client.dll

Pakete:

Microsoft.Azure.DocumentDB v2.18.0, Microsoft.Azure.DocumentDB.Core v2.18.0

Überlädt

CreateStoredProcedureAsync(String, StoredProcedure, RequestOptions)	Erstellt eine gespeicherte Prozedur als asychronen Vorgang im Azure Cosmos DB-Dienst.
CreateStoredProcedureAsync(Uri, StoredProcedure, RequestOptions)	Erstellt eine gespeicherte Prozedur als asychronen Vorgang im Azure Cosmos DB-Dienst.

CreateStoredProcedureAsync(String, StoredProcedure, RequestOptions)

Erstellt eine gespeicherte Prozedur als asychronen Vorgang im Azure Cosmos DB-Dienst.

public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.StoredProcedure>> CreateStoredProcedureAsync (string collectionLink, Microsoft.Azure.Documents.StoredProcedure storedProcedure, Microsoft.Azure.Documents.Client.RequestOptions options = default);

abstract member CreateStoredProcedureAsync : string * Microsoft.Azure.Documents.StoredProcedure * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.StoredProcedure>>
override this.CreateStoredProcedureAsync : string * Microsoft.Azure.Documents.StoredProcedure * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.StoredProcedure>>

Public Function CreateStoredProcedureAsync (collectionLink As String, storedProcedure As StoredProcedure, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of StoredProcedure))

Parameter

collectionLink

String

Der Link der Auflistung, in der die gespeicherte Prozedur erstellt werden soll. Beispiel: dbs/db_rid/colls/col_rid/

storedProcedure

StoredProcedure

Das StoredProcedure zu erstellende Objekt.

options

RequestOptions

(Optional) Alle RequestOptionsfür diese Anforderung.

Gibt zurück

Task<ResourceResponse<StoredProcedure>>

Das StoredProcedure erstellt wurde, das in einem Task Objekt enthalten ist, das die Dienstantwort für den asynchronen Vorgang darstellt.

Implementiert

CreateStoredProcedureAsync(String, StoredProcedure, RequestOptions)

Ausnahmen

ArgumentNullException

Wenn entweder collectionLink oder storedProcedure nicht festgelegt ist.

AggregateException

Stellt eine Konsolidierung von Fehlern dar, die während der asynchronen Verarbeitung aufgetreten sind. Suchen Sie in InnerExceptions, um die tatsächlichen Ausnahmen zu finden.

DocumentClientException

Diese Ausnahme kann viele verschiedene Fehlertypen kapseln. Um den spezifischen Fehler zu ermitteln, sehen Sie sich immer die StatusCode-Eigenschaft an. Einige häufige Codes, die Sie beim Erstellen eines Dokuments erhalten, sind:

StatusCode	Ausnahmegrund
400	BadRequest: Dies bedeutet, dass mit der bereitgestellten Anforderung etwas nicht stimmte. Es ist wahrscheinlich, dass für die gespeicherte Prozedur keine ID angegeben wurde oder der Textkörper fehlerhaft war.
403	Verboten: Sie haben Ihr Kontingent an gespeicherten Prozeduren für die angegebene Sammlung erreicht. Wenden Sie sich an den Support, um dieses Kontingent zu erhöhen.
409	Konflikt: Dies bedeutet, dass eine StoredProcedure mit einer ID übereinstimmt, die der von Ihnen angegebenen ID entspricht, bereits vorhanden ist.
413	RequestEntityTooLarge: Dies bedeutet, dass der Textkörper der StoredProcedure zu erstellenden Datei zu groß war.

Beispiele

//Create a new stored procedure called "HelloWorldSproc" that takes in a single param called "name".
StoredProcedure sproc = await client.CreateStoredProcedureAsync(collectionLink, new StoredProcedure
{
   Id = "HelloWorldSproc",
   Body = @"function (name){
               var response = getContext().getResponse();
               response.setBody('Hello ' + name);
            }"
});

Weitere Informationen

• StoredProcedure
• RequestOptions
• ResourceResponse<TResource>
• Task

CreateStoredProcedureAsync(Uri, StoredProcedure, RequestOptions)

Erstellt eine gespeicherte Prozedur als asychronen Vorgang im Azure Cosmos DB-Dienst.

public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.StoredProcedure>> CreateStoredProcedureAsync (Uri documentCollectionUri, Microsoft.Azure.Documents.StoredProcedure storedProcedure, Microsoft.Azure.Documents.Client.RequestOptions options = default);

abstract member CreateStoredProcedureAsync : Uri * Microsoft.Azure.Documents.StoredProcedure * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.StoredProcedure>>
override this.CreateStoredProcedureAsync : Uri * Microsoft.Azure.Documents.StoredProcedure * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.StoredProcedure>>

Public Function CreateStoredProcedureAsync (documentCollectionUri As Uri, storedProcedure As StoredProcedure, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of StoredProcedure))

Parameter

documentCollectionUri

Uri

der URI der Dokumentsammlung, in der die gespeicherte Prozedur erstellt werden soll.

storedProcedure

StoredProcedure

das Microsoft.Azure.Documents.StoredProcedure-Objekt.

options

RequestOptions

Die Anforderungsoptionen für die Anforderung.

Gibt zurück

Task<ResourceResponse<StoredProcedure>>

Das Taskobjekt, das die Dienstantwort für den asynchronen Vorgang darstellt.

Implementiert

CreateStoredProcedureAsync(Uri, StoredProcedure, RequestOptions)