Executar um procedimento armazenado
Execute um procedimento armazenado executando um POST em um recurso de procedimento armazenado. Um procedimento armazenado é uma parte da lógica de aplicativo escrita em JavaScript que é registrada e executada em uma coleção como uma única transação.
Solicitação
| Método | URI da solicitação | Descrição |
|---|---|---|
| POST | https://{databaseaccount}.documents.azure.com/dbs/{db-id}/colls/{coll-id}/sprocs/{sproc-name} |
O {databaseaccount} é o nome da conta do Azure Cosmos DB criada em sua assinatura. O valor {db-id} é o nome/ID gerado pelo usuário do banco de dados em que reside o procedimento armazenado, não a ID gerada pelo sistema (rid). O valor de {coll-id} é o nome da coleção em que reside o procedimento armazenado. O valor {sproc-name} é o nome do procedimento armazenado a ser executado. |
Cabeçalhos
Consulte Cabeçalhos comuns de solicitação REST para cabeçalhos que são usados por todas as solicitações da API do SQL.
Corpo
| Propriedade | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| < Parâmetros> | Necessário | Array | Uma matriz dos parâmetros a serem passados para o procedimento armazenado. |
[“World”]
Resposta
Cabeçalhos
Confira Cabeçalhos comuns de resposta REST do Azure Cosmos DB para cabeçalhos retornados por todas as respostas do Cosmos DB.
Códigos de status
A tabela a seguir lista os códigos de status comuns retornados por esta operação. Para obter uma lista completa de códigos de status, consulte Códigos de status HTTP.
| Código de status HTTP | Descrição |
|---|---|
| 200 Ok | A operação foi bem-sucedida. |
Corpo
| Propriedade | Descrição |
|---|---|
| <Resposta> | A resposta do procedimento armazenado. |
"Hello, World"
Exemplo
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"