Эта команда 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 не используется и не задан параметр DB.driver, то базой данных по умолчанию считается база данных Oracle.
База данных Oracle – пример со служебным идентификатором (SID)
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. Такие определения облегчают "извлечение" данных из внешнего источника. Если сетевое соединение между Essbase и внешним источником данных отсутствует, можно выполнить потоковую загрузку данных или построение измерений с помощью интерфейса командной строки, сначала создав локальное подключение с помощью этой команды, а затем выполнив команду dataload или dimbuild с параметром stream.