此 CLI 命令创建 JDBC 连接并将其存储在本地。要使用此命令，您至少需要具有“服务管理员”角色。
说明
您必须先使用此命令创建和保存本地连接，然后才能使用带有流式选项的 CLI dataload 或 dimbuild 命令。您还需要设置环境变量 EXTERNAL_CLASSPATH，指向数据库驱动程序的 .jar 文件。有关设置此变量的示例，请参见通过从远程数据库流式传输来构建维并加载数据。
语法
createLocalConnection [-verbose] -name streamConnection -connectionstring connectionString -user userName [-driver jdbcDriver] [-password password]
| 选项 | 缩写 | 说明 |
|---|---|---|
| -verbose | -v | 显示扩展的说明 |
| -name | -N | 连接名称 |
| -connectionstring | -cs | JDBC 连接字符串。格式可以带有 SID，如下所示：
jdbc:oracle:thin:@host:port:SID 或者带有服务名称，如下所示 jdbc:oracle:thin:@host:port/service_name 请参见“示例”。 |
| -user | -u | 用户名 |
| -driver | -D | JDBC 驱动程序。如果未提供，则将 Oracle 数据库视为默认值，例如 oracle.jdbc.driver.OracleDriver |
| -password | -p | 密码（可选） |
示例
以下示例反映了各个数据源。
如果未提供 -driver 选项和 jdbcDriver 参数，则默认情况下假定数据库为 Oracle 数据库。
Oracle 数据库 — 使用 SID（服务 ID）的示例
esscs createLocalConnection -N OracleDBConnection1 -cs jdbc:oracle:thin:@myhostname01:1521:ORCL -u OracleUser -D oracle.jdbc.driver.OracleDriver
Oracle 数据库 — 使用服务名称的示例
esscs createLocalConnection -N OracleDBConnection2 -cs jdbc:oracle:thin:@host1.example.com:1521/ORCL.esscs.host1.oraclecloud.com -u OracleUser
DB2
esscs createLocalConnection -N DB2conn -cs jdbc:db2://myhostname02.example.com:50000/TBC -u myDB2User -D com.ibm.db2.jcc.DB2Driver
MySQL
esscs createLocalConnection -N MySQLconn -cs jdbc:mysql://myhostname03.example.com:3306/tbc -u MySQLUsr -D com.mysql.jdbc.Driver
Microsoft SQL Server
esscs createLocalConnection -N MSSQLConn -cs jdbc:sqlserver://myhostname04.example.com:1433 -u MSSQLUsr -D com.microsoft.sqlserver.jdbc.SQLServerDriver
Teradata
esscs createLocalConnection -N TeraDconn -cs jdbc:teradata://myhostname05.example.com/DBS_PORT=1025 -u MSSQLUsr -D com.teradata.jdbc.TeraDriver
如果在外部数据源和 Essbase 之间有网络连接，最有效的方式是在 Essbase Web 界面中定义应用程序级别或全局连接和数据源。这些定义有助于您轻松地从外部源“拉取”数据。如果在 Essbase 和外部数据源之间没有网络连接，可以使用 CLI 通过流式传输完成数据加载或维构建，方法是首先使用此命令创建本地连接，然后发出带 stream 选项的 dataload 或 dimbuild 命令。