Este comando CLI cria uma conexão JDBC e a armazena no local. Para usá-la, você precisa pelo menos, da atribuição de Administrador de Serviço.
Descrição
Você deve usar esse comando para criar e salvar a conexão local, a fim de que possa usar os comandos dataload ou dimbuild da CLI com a opção de streaming. Defina também uma variável de ambiente EXTERNAL_CLASSPATH para indicar o arquivo .jar para o seu driver de banco de dados. Para ver exemplos de definição dessa variável, consulte Criar Dimensões e Carregar Dados por Streaming com Base em um Banco de Dados Remoto.
Sintaxe
createLocalConnection [-verbose] -name streamConnection -connectionstring connectionString -user userName [-driver jdbcDriver] [-password password]
| Opção | Abreviação | Descrição |
|---|---|---|
| -verbose | -v | Mostrar descrições detalhadas |
| -name | -N | Nome da conexão |
| -connectionstring | -cs | String de conexão JDBC. O formato pode ser com SID, como se segue:
jdbc:oracle:thin:@host:port:SID ou com o nome do serviço, como se segue jdbc:oracle:thin:@host:port/service_name Ver Exemplos. |
| -user | -u | Nome de usuário |
| -driver | -D | Driver JDBC. Se não for fornecido, o Oracle Database será considerado o padrão, como oracle.jdbc.driver.OracleDriver |
| -password | -p | Senha (opcional) |
Exemplos
Os exemplos a seguir refletem várias origens de dados.
Se a opção -driver e o parâmetro jdbcDriver não forem fornecidos, o banco de dados Oracle será adotado como o padrão.
BD Oracle – Exemplo com SID (ID de Serviço)
esscs createLocalConnection -N OracleDBConnection1 -cs jdbc:oracle:thin:@myhostname01:1521:ORCL -u OracleUser -D oracle.jdbc.driver.OracleDriver
BD Oracle – Exemplo com Nome de Serviço
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
Se você possui conectividade de rede entre uma origem externa de dados e o Essbase, é mais eficiente definir conexões e origens de dados globais ou no nível do aplicativo na Interface Web do Essbase. Essas definições o ajudam a "extrair" dados facilmente da origem externa. Se não houver conectividade de rede entre o Essbase e a origem externa de dados, você deverá transmitir as cargas de dados ou criações de dimensões usando a CLI, primeiro usando este comando para criar uma conexão local e depois emitindo o comando dataload ou dimbuild com a opção de stream.