Class: DatasourceConnectionInfo

DatasourceConnectionInfo

数据源连接信息类。该类包括了进行数据源连接的所有信息,如所要连接的服务器名称、数据库名称、用户名以及密码等。 当保存为工作空间时,工作空间中的数据源的连接信息都将存储到工作空间文件中。对于不同类型的数据源,其连接信息有所区别。 所以在使用该类所包含的成员时,请注意该成员所适用的数据源类型。对于从数据源对象中返回的数据连接信息对象,只有 connect 方法可以被修改, 其他内容是不可以被修改的。对于用户创建的数据源连接信息对象,其内容都可以修改。

new DatasourceConnectionInfo(options)

Usage
// 浏览器
<script type="text/javascript" src="https://iclient.supermap.io/dist/openlayers/iclient-ol.js"></script>
<script>
  new ol.supermap.DatasourceConnectionInfo(options);
  
  // 弃用的写法
  new SuperMap.DatasourceConnectionInfo(options);

</script>

// ES6 Import
import { DatasourceConnectionInfo } from '@supermapgis/iclient-ol';

new DatasourceConnectionInfo(options);

common/iServer/DatasourceConnectionInfo.js, line 7
Name Type Description
options Object

参数。

Name Type Description
alias string

数据源别名。

dataBase string

数据源连接的数据库名。

connect boolean 可选

数据源是否自动连接数据。

driver string 可选

使用 ODBC(Open Database Connectivity,开放数据库互连)的数据库的驱动程序名。

engineType EngineType 可选

数据源连接的引擎类型。

exclusive boolean 可选

是否以独占方式打开数据源。

OpenLinkTable boolean 可选

是否把数据库中的其他非 SuperMap 数据表作为 LinkTable 打开。

password string 可选

登录数据源连接的数据库或文件的密码。

readOnly boolean 可选

是否以只读方式打开数据源。

server string 可选

数据库服务器名或 SDB 文件名。

user string 可选

登录数据库的用户名。

Members

aliasstring

数据源别名。

connectboolean

数据源是否自动连接数据。

dataBasestring

数据源连接的数据库名。

driverstring

使用 ODBC(Open Database Connectivity,开放数据库互连) 的数据库的驱动程序名。 其中,对于 SQL Server 数据库与 SuperMap iServer 发布的 WMTS 服务,此为必设参数。 对于 SQL Server 数据库,它使用 ODBC 连接,所设置的驱动程序名为 "SQL Server" 或 "SQL Native Client"; 对于 SuperMap iServer 发布的 WMTS 服务,设置的驱动名称为 "WMTS"。

engineTypeEngineType

数据源连接的引擎类型。

exclusiveboolean

是否以独占方式打开数据源。

OpenLinkTableboolean

是否把数据库中的其他非 SuperMap 数据表作为 LinkTable 打开。

passwordstring

登录数据源连接的数据库或文件的密码。

readOnlyboolean

是否以只读方式打开数据源。

serverstring

数据库服务器名、文件名或服务地址。
1.对于 SDB 和 UDB 文件,为其文件的绝对路径。注意:当绝对路径的长度超过 UTF-8 编码格式的 260 字节长度,该数据源无法打开。
2.对于 Oracle 数据库,其服务器名为其 TNS 服务名称。
3.对于 SQL Server 数据库,其服务器名为其系统的 DSN(Database Source Name) 名称。
4.对于 PostgreSQL 数据库,其服务器名为 “IP:端口号”,默认的端口号是 5432。
5.对于 DB2 数据库,已经进行了编目,所以不需要进行服务器的设置。
6.对于 Kingbase 数据库,其服务器名为其 IP 地址。
7.对于 GoogleMaps 数据源,其服务器地址,默认设置为 “http://maps.google.com”,且不可更改。
8.对于 SuperMapCould 数据源,为其服务地址。
9.对于 MAPWORLD 数据源,为其服务地址,默认设置为 “http://www.tianditu.cn”,且不可更改。
10.对于 OGC 和 REST 数据源,为其服务地址。

userstring

登录数据库的用户名。

Methods

destroy()

common/iServer/DatasourceConnectionInfo.js, line 120

释放资源,将引用资源的属性置空。