CONNECTION_EXTENDED_PROPERTY 函数 [String]

CONNECTION_EXTENDED_PROPERTY( 
{ property-id | property-name }
[, property-specific-argument [, connection-id ] ]
)

property-id 连接属性 ID。
property-name 连接属性名称。支持的属性名称有：
- CharSet 返回指定标准所知的连接的 CHAR 字符集标签。可以接受的值包括：ASE、IANA、MIME、JAVA、WINDOWS、UTR22、IBM 和 ICU。缺省值为 IANA，但如果数据库连接是通过 TDS 建立的，则缺省值为 ASE。
- NcharCharSet 返回指定标准所知的连接的 NCHAR 字符集标签。可以接受的值与以上列出的 CharSet 的可接受值相同。
- Progress 返回关于语句已执行时长的信息。指定 property-specific-argument，后跟 connection-id，以返回特定于语句进度的信息。
  下列语句和过程支持进度属性：
  - BACKUP DATABASE（映像以及档案）
  - LOAD TABLE（仅 USING FILE 和 USING CLIENT FILE）
  - MESSAGE
  - REORGANIZE TABLE
  - RESTORE DATABASE
  - UNLOAD（所有类型）
  - sa_table_page_usage 系统过程

property-specific-argument 与以下连接属性关联的可选属性特定字符串参数：

Progress

Formatted 指定 Formatted 以获取人工可读的格式。例如：

43% ( 9728 of 22230 pages ) complete after 00:00:05; estimated 00:00:06 remaining

如果剩余时间尚未估计，或者已完成的单元数比原始估计的值大，则 Remaining 值可能为空。

对于除 Formatted 以外的所有属性特定参数，大字节值永远不会转换为千字节或兆字节。

返回扩展的连接属性。返回值为 VARCHAR。

CONNECTION_EXTENDED_PROPERTY 函数类似于 CONNECTION_PROPERTY 函数，不同之处是它允许指定一个可选的属性特定的字符串参数。属性特定参数的解释取决于在第一个参数中指定的属性 ID 或属性名。

可以使用 CONNECTION_EXTENDED_PROPERTY 函数返回任何连接属性的值。但是，扩展信息只可用于扩展属性。

云注意事项： 由于租户数据库的隔离规则，当在云中调用此函数时，仅会返回关于当前租户数据库的信息。

以下示例返回 Java 标准所知的当前连接的 CHAR 字符集：

SELECT CONNECTION_EXTENDED_PROPERTY( 'charset', 'Java' );