sp_http_listeners 系统过程

列出用于指定数据库的 HTTP 和 HTTPS 连接监听器。

语法

sp_http_listeners(  )

参数

• <database-ID> HTTP 和 HTTPS 连接监听器正在提供服务的数据库的 ID。缺省值为当前数据库 ID。

  结果集

  列名数据类型说明ip_addressVARCHAR (128)返回连接监听器的 IP 地址。portINTEGER返回连接监听器的端口号。dbnameVARCHAR (255)如果连接监听器可以对任意数据库执行服务则返回 NULL；否则返回数据库名称。uri_prefixLONG VARCHAR返回连接监听器可对其执行服务的任意 URI 的前缀。包括 http:// 或 https:// 标识符、IP 地址、端口号（可选）以及数据库名称（如果需要）。 

  注释

  每一个正在运行的 HTTP 和 HTTPS 连接监听器都有一行出现在结果集中。仅当连接监听器可以在指定数据库上执行 web 服务时才会出现一行。

  特权

  您必须具有系统过程的 EXECUTE 特权。

  要为其它数据库执行该系统过程，必须拥有以下任一系统特权：

• SERVER OPERATOR

• MONITOR

• MANAGE LISTENERS

  示例

  使用以下命令启动数据库服务器：

  dbeng16 database1.db database2.db -xs http(port=80),http(port=8080;dbn=database1)

  📋✓

  连接到数据库 1 并执行以下语句：

  SELECT * FROM dbo.sp_http_listeners();

  📋✓

  数据库服务器将返回一个类似于以下内容的结果集：

  ip_address port dbname uri_prefix 127.0.0.1 80 NULL http://127.0.0.1/database1/ 127.0.0.1 8080 database1 http://127.0.0.1:8080/ 

  如果连接到数据库 2 并运行同一语句，数据库服务器则返回如下结果集：

  ip_address port dbname uri_prefix 127.0.0.1 80 NULL http://127.0.0.1/database2/ 