First draft of new SET/SHOW implementaiton

README.md

@@ -248,7 +248,7 @@ As seen in the examples, you can unspool the array of `http_header` tuples into
 
 ## CURL Options
 
-Select [CURL options](https://curl.se/libcurl/c/curl_easy_setopt.html) are available to set using the `http_set_curlopt(curlopt VARCHAR, value varchar)` function.
+Select [CURL options](https://curl.se/libcurl/c/curl_easy_setopt.html) are available to set using the SQL `SET` command and the appropriate option name.
 
 * [CURLOPT_DNS_SERVERS](https://curl.se/libcurl/c/CURLOPT_DNS_SERVERS.html)
 * [CURLOPT_PROXY](https://curl.se/libcurl/c/CURLOPT_PROXY.html)
@@ -279,53 +279,67 @@ Select [CURL options](https://curl.se/libcurl/c/curl_easy_setopt.html) are avail
 * [CURLOPT_CONNECTTIMEOUT_MS](https://curl.se/libcurl/c/CURLOPT_CONNECTTIMEOUT_MS.html)
 * [CURLOPT_USERAGENT](https://curl.se/libcurl/c/CURLOPT_USERAGENT.html)
 
-
 For example,
 
 ```sql
--- Set the PROXYPORT option
-SELECT http_set_curlopt('CURLOPT_PROXYPORT', '12345');
+-- Set the curlopt_proxyport option
+SET http.curlopt_proxyport = '12345';
+
+-- View the curlopt_proxyport option
+SHOW http.curlopt_proxyport;
 
--- List all currently set options
+-- View *all* currently set options
 SELECT * FROM http_list_curlopt();
 ```
 
 Will set the proxy port option for the lifetime of the database connection. You can reset all CURL options to their defaults using the `http_reset_curlopt()` function.
 
-Using this extension as a background automated process without supervision (e.g as a trigger) may have unintended consequences for other servers.
-It is considered a best practice to share contact information with your requests,
-so that administrators can reach you in case your HTTP calls get out of control.
+You can permanently set the CURL options for a database or role, using the `ALTER DATABASE` and `ALTER ROLE` commands.
+
+```sql
+-- Applies to all roles in the database
+ALTER DATABASE mydb SET http.curlopt_tlsauth_password = 'secret';
+
+-- Applies to just one role in the database
+ALTER ROLE myapp IN mydb SET http.curlopt_tlsauth_password = 'secret';
+```
+
+## User Agents
+
+Using this extension as a background automated process without supervision (e.g as a trigger) may have unintended consequences for other servers. It is considered a best practice to share contact information with your requests, so that administrators can reach you in case your HTTP calls get out of control.
 
 Certain API policies (e.g. [Wikimedia User-Agent policy](https://meta.wikimedia.org/wiki/User-Agent_policy)) may even require sharing specific contact information
 with each request. Others may disallow (via `robots.txt`) certain agents they don't recognize.
 
 For such cases you can set the `CURLOPT_USERAGENT` option
 
 ```sql
-SELECT http_set_curlopt('CURLOPT_USERAGENT',
-                        'Examplebot/2.1 (+http://www.example.com/bot.html) Contact abuse@example.com');
+SET http.curlopt_useragent = 'PgBot/2.1 (+http://www.example.com/bot.html) Contact abuse@pgbot.com';
 
-SELECT status, content::json ->> 'user-agent' FROM http_get('http://httpbun.com/user-agent');
+SELECT status, content::json->'headers'->>'User-Agent'
+  FROM http_get('http://httpbun.com/headers');
 ```
 ```
  status |                         user_agent
 --------+-----------------------------------------------------------
-    200 | Examplebot/2.1 (+http://www.example.com/bot.html) Contact abuse@example.com
+    200 | PgBot/2.1 (+http://www.example.com/bot.html) Contact abuse@pgbot.com
 ```
 
 ## Keep-Alive & Timeouts
 
-*The `http_reset_curlopt()` approach described above is recommended. The global variables below will be deprecated and removed over time.*
-
 By default each request uses a fresh connection and assures that the connection is closed when the request is done.  This behavior reduces the chance of consuming system resources (sockets) as the extension runs over extended periods of time.
 
 High-performance applications may wish to enable keep-alive and connection persistence to reduce latency and enhance throughput.  The following GUC variable changes the behavior of the http extension to maintain connections as long as possible:
 
-    http.keepalive = 'on'
+```sql
+SET http.curlopt_tcp_keepalive = 1;
+```
 
 By default a 5 second timeout is set for the completion of a request.  If a different timeout is desired the following GUC variable can be used to set it in milliseconds:
 
-    http.timeout_msec = 200
+```sql
+SET http.curlopt_timeout_msec = 200;
+```
 
 ## Installation