Skapa lagrad procedur
Åtgärden Create Stored Procedure skapar en ny lagrad procedur i en samling.
Förfrågan
| Metod | URI för förfrågan | Description |
|---|---|---|
| POST | https://{databaseaccount}.documents.azure.com/dbs/{db-id}/colls/{coll-id}/sprocs | {databaseaccount} är namnet på det Azure Cosmos DB-konto som skapats under din prenumeration. Värdet {db-id} är det användargenererade namnet/ID:t för databasen där den lagrade proceduren skapas, inte systemets genererade ID (rid). Värdet {coll-id} är namnet på samlingen där den lagrade proceduren skapas. |
Sidhuvuden
Se Vanliga REST-begärandehuvuden för Azure Cosmos DB för rubriker som används av alla Azure Cosmos DB-begäranden.
Brödtext
| Egenskap | Krävs | Typ | Description |
|---|---|---|---|
| id | Obligatorisk | Sträng | Användaren genererade ett unikt namn för den lagrade proceduren. Inga två lagrade procedurer kan ha samma ID:n. Det är en sträng som inte får innehålla mer än 255 tecken. |
| Kroppen | Obligatorisk | Sträng | Brödtexten i den lagrade proceduren. |
{
"body": "function () {\r\n var context = getContext();\r\n var response = context.getResponse();\r\n\r\n response.setBody(\"Hello, World\");\r\n}",
"id": "sproc_1"
}
Svarsåtgärder
Sidhuvuden
Se Vanliga REST-svarshuvuden för Azure Cosmos DB för rubriker som returneras av alla Azure Cosmos DB-svar.
Statuskoder
I följande tabell visas vanliga statuskoder som returneras av den här åtgärden. En fullständig lista över statuskoder finns i HTTP-statuskoder.
| HTTP-statuskod | Beskrivning |
|---|---|
| Skapad 201 | Åtgärden lyckades. |
| 400 Felaktig begäran | JSON-brödtexten är ogiltig. Kontrollera om det saknas klammerparenteser eller citattecken. |
| 409 – Konflikt | Det ID som anges för den nya lagrade proceduren har tagits av en befintlig lagrad procedur. |
Brödtext
| Egenskap | Beskrivning |
|---|---|
| _Bli | Det är en systemgenererad egenskap. Resurs-ID :t (_rid) är en unik identifierare som också är hierarkisk per resursstacken i resursmodellen. Den används internt för placering och navigering av behörighetsresursen. |
| _Ts | Det är en systemgenererad egenskap. Den anger resursens senast uppdaterade tidsstämpel. Värdet är en tidsstämpel. |
| _Själv | Det är en systemgenererad egenskap. Det är den unika adresserbara URI:n för resursen. |
| _Etag | Det är en systemgenererad egenskap som representerar resursetaggen som krävs för optimistisk samtidighetskontroll. |
{
"body": "function () {\r\n var context = getContext();\r\n var response = context.getResponse();\r\n\r\n response.setBody(\"Hello, World\");\r\n}",
"id": "sproc_1",
"_rid": "Sl8fALN4sw4CAAAAAAAAgA==",
"_ts": 1449680569,
"_self": "dbs\/Sl8fAA==\/colls\/Sl8fALN4sw4=\/sprocs\/Sl8fALN4sw4CAAAAAAAAgA==\/",
"_etag": "\"0600ffe0-0000-0000-0000-56685eb90000\""
}
Exempel
POST https://contosomarketing.documents.azure.com/dbs/volcanodb/colls/volcano1/sprocs HTTP/1.1
x-ms-session-token: 28
x-ms-date: Wed, 09 Dec 2015 17:02:48 GMT
authorization: type%3dmaster%26ver%3d1.0%26sig%3d1puCtXMwS2AOFwQ19Y33nT9LspnXXZIFDnJnh%2b%2bOCKk%3d
Cache-Control: no-cache
User-Agent: contoso/1.0
x-ms-version: 2015-08-06
Accept: application/json
Host: contosomarketing.documents.azure.com
Cookie: x-ms-session-token=28
Content-Length: 171
Expect: 100-continue
Connection: Keep-Alive
{
"body": "function () {\r\n var context = getContext();\r\n var response = context.getResponse();\r\n\r\n response.setBody(\"Hello, World\");\r\n}",
"id": "sproc_1"
}
HTTP/1.1 201 Created
Cache-Control: no-store, no-cache
Pragma: no-cache
Content-Type: application/json
Server: Microsoft-HTTPAPI/2.0
Strict-Transport-Security: max-age=31536000
x-ms-last-state-change-utc: Sun, 29 Nov 2015 19:20:18.154 GMT
etag: "0600ffe0-0000-0000-0000-56685eb90000"
x-ms-resource-quota: storedProcedures=25;
x-ms-resource-usage: storedProcedures=1;
x-ms-schemaversion: 1.1
x-ms-alt-content-path: dbs/volcanodb/colls/volcano1
x-ms-content-path: Sl8fALN4sw4=
x-ms-quorum-acked-lsn: 28
x-ms-session-token: 29
x-ms-current-write-quorum: 3
x-ms-current-replica-set-size: 4
x-ms-request-charge: 4.95
x-ms-serviceversion: version=1.5.57.3
x-ms-activity-id: 6540fd9a-2428-49d8-b14d-31e7f0af7175
x-ms-gatewayversion: version=1.5.57.3
Date: Wed, 09 Dec 2015 17:02:48 GMT
Content-Length: 354
{
"body": "function () {\r\n var context = getContext();\r\n var response = context.getResponse();\r\n\r\n response.setBody(\"Hello, World\");\r\n}",
"id": "sproc_1",
"_rid": "Sl8fALN4sw4CAAAAAAAAgA==",
"_ts": 1449680569,
"_self": "dbs\/Sl8fAA==\/colls\/Sl8fALN4sw4=\/sprocs\/Sl8fALN4sw4CAAAAAAAAgA==\/",
"_etag": "\"0600ffe0-0000-0000-0000-56685eb90000\""
}