此 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 Database 作為預設值，像是 oracle.jdbc.driver.OracleDriver。 |
| -password | -p | 密碼 (選擇性) |
範例
以下為反映各種不同資料來源的範例。
若未提供 -driver 選項和 jdbcDriver 參數，會以 Oracle Database 作為預設資料庫。
Oracle DB – 使用 SID (服務 ID) 的範例
esscs createLocalConnection -N OracleDBConnection1 -cs jdbc:oracle:thin:@myhostname01:1521:ORCL -u OracleUser -D oracle.jdbc.driver.OracleDriver
Oracle DB – 使用服務名稱的範例
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 與外部資料來源之間沒有網路連線，您就要先使用此命令建立本機連線，然後發出 dataload 或 dimbuild 命令搭配串流選項，使用 CLI 串流處理資料載入或維度建置。