Ejecutar un procedimiento almacenado
Ejecute un procedimiento almacenado realizando una solicitud POST en un recurso de procedimiento almacenado. Un procedimiento almacenado es un trozo de lógica de aplicación escrito en JavaScript que se registra y ejecuta contra una colección como una sola transacción.
Solicitud
| Método | URI de solicitud | Descripción |
|---|---|---|
| POST | https://{databaseaccount}.documents.azure.com/dbs/{db-id}/colls/{coll-id}/sprocs/{sproc-name} |
{databaseaccount} es el nombre de la cuenta de Azure Cosmos DB creada en la suscripción. El valor {db-id} es el nombre o identificador generado por el usuario de la base de datos donde reside el procedimiento almacenado, no el identificador generado por el sistema (rid). El valor {coll-id} es el nombre de la colección donde reside el procedimiento almacenado. El valor {sproc-name} es el nombre del procedimiento almacenado que se va a ejecutar. |
encabezados
Consulte Encabezados de solicitud REST comunes para los encabezados que usan todas las solicitudes de LA API de SQL.
Body
| Propiedad | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| < Parámetros> | Obligatorio | Array | Matriz de los parámetros que se van a pasar al procedimiento almacenado. |
[“World”]
Response
encabezados
Consulte Encabezados de respuesta REST comunes de Azure Cosmos DB para ver los encabezados devueltos por todas las respuestas de Cosmos DB.
Códigos de estado
La tabla siguiente muestra los códigos de estado comunes que devuelve esta operación. Para obtener una lista completa de los códigos de estado, consulte Códigos de estado HTTP.
| Código de estado HTTP | Descripción |
|---|---|
| 200 Ok | La operación se realizó correctamente. |
Body
| Propiedad | Descripción |
|---|---|
| <Respuesta> | Respuesta del procedimiento almacenado. |
"Hello, World"
Ejemplo
POST https://contosomarketing.documents.azure.com/dbs/volcanodb/colls/volcano1/sprocs/sproc_hello_world HTTP/1.1
x-ms-date: Wed, 09 Dec 2015 18:05:07 GMT
authorization: type%3dmaster%26ver%3d1.0%26sig%3dwG%2f1OgCtY8aoSRprHecXxL%2fewTrqEIPjfCLcHDlVZQA%3d
Cache-Control: no-cache
User-Agent: contoso/1.0
x-ms-version: 2015-08-06
Accept: application/json
Content-Type: application/json
Host: contosomarketing.documents.azure.com
Content-Length: 9
Expect: 100-continue
["World"]
HTTP/1.1 200 Ok
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
x-ms-schemaversion: 1.1
x-ms-alt-content-path: dbs/volcanodb/colls/volcano1/sprocs/sproc_hello_world
x-ms-content-path: Sl8fALN4sw4=
x-ms-quorum-acked-lsn: 37
x-ms-session-token: 37
x-ms-current-write-quorum: 3
x-ms-current-replica-set-size: 4
x-ms-request-charge: 7.3
x-ms-serviceversion: version=1.5.57.3
x-ms-activity-id: 92012d9b-7d0d-4d4e-acd7-3db487c267f9
Set-Cookie: x-ms-session-token=37; Domain=contosomarketing.documents.azure.com; Path=/dbs/volcanodb/colls/volcano1
x-ms-gatewayversion: version=1.5.57.3
Date: Wed, 09 Dec 2015 18:05:06 GMT
Content-Length: 14
"Hello, World"