Skip to content

Commit 665b191

Browse files
committed
Update HTTP docs
1 parent bb6d5d8 commit 665b191

File tree

1 file changed

+10
-0
lines changed

1 file changed

+10
-0
lines changed

docs/en/interfaces/http.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -346,6 +346,16 @@ To overcome this limitation, you could use the `role` query parameter instead:
346346
curl -sS "http://localhost:8123?role=my_role" --data-binary "SELECT * FROM my_table;"
347347
```
348348

349+
This will be an equivalent of executing `SET ROLE my_role` before the statement.
350+
351+
Additionally, it is possible to specify multiple `role` query parameters:
352+
353+
```
354+
curl -sS "http://localhost:8123?role=my_role&role=my_other_role" --data-binary "SELECT * FROM my_table;"
355+
```
356+
357+
In this case, `?role=my_role&role=my_other_role` works similarly to executing `SET ROLE my_role, my_other_role` before the statement.
358+
349359
## HTTP response codes caveats {#http_response_codes_caveats}
350360

351361
Because of limitation of HTTP protocol, HTTP 200 response code does not guarantee that a query was successful.

0 commit comments

Comments
 (0)