この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データベースが想定のデータベースとなります。
Oracle DB – SID (Service 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とデータの外部ソースの間にネットワーク接続がない場合は、CLIを使用し、まずこのコマンドを使用してローカル接続を作成し、ストリーム・オプションを指定してdataloadまたはdimbuildコマンドを発行し、データ・ロードまたはディメンション構築をストリームできます。