Executar um Procedimento Armazenado
Execute um procedimento armazenado ao executar um POST num recurso de procedimento armazenado. Um procedimento armazenado é uma parte da lógica da aplicação escrita em JavaScript que é registada e executada numa coleção como uma única transação.
Pedir
| Método | URI do pedido | Description |
|---|---|---|
| POST | https://{databaseaccount}.documents.azure.com/dbs/{db-id}/colls/{coll-id}/sprocs/{sproc-name} |
A {databaseaccount} é o nome da conta do Azure Cosmos DB criada na sua subscrição. O valor {db-id} é o nome/ID gerado pelo utilizador da base de dados onde reside o procedimento armazenado e não o ID gerado pelo sistema (rid). O valor {coll-id} é o nome da coleção onde reside o procedimento armazenado. O valor {sproc-name} é o nome do procedimento armazenado a ser executado. |
Cabeçalhos
Veja Cabeçalhos de pedido REST comuns para cabeçalhos que são utilizados por todos os pedidos da API SQL.
Corpo
| Propriedade | Necessário | Tipo | Description |
|---|---|---|---|
| < parâmetros> | Obrigatório | Matriz | Uma matriz dos parâmetros a transmitir para o procedimento armazenado. |
[“World”]
Resposta
Cabeçalhos
Veja Common Azure Cosmos DB REST response headers for headers that are returned by all Cosmos DB responses (Cabeçalhos de resposta REST do Azure Cosmos DB comuns para cabeçalhos devolvidos por todas as respostas do Cosmos DB).
Códigos de estado
A tabela seguinte lista os códigos de estado comuns devolvidos por esta operação. Para obter uma lista completa dos códigos de estado, veja Códigos de Estado HTTP.
| Código de estado de HTTP | Descrição |
|---|---|
| 200 Ok | A operação foi efetuada com êxito. |
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"