Cette commande CLI crée une connexion JDBC et la stocke localement. Pour l'utiliser, vous devez disposer au moins du rôle Administrateur de service.
Description
Vous devez utiliser cette commande afin de créer et d'enregistrer la connexion locale pour pouvoir utiliser les commandes CLI dataload ou dimbuild avec l'option de transmission en continu. Vous devez également définir une variable d'environnement EXTERNAL_CLASSPATH de sorte qu'elle pointe vers le fichier .jar de votre pilote de base de données. Pour voir des exemples de configuration de cette variable, reportez-vous à la section Construction de dimensions et chargement de données par transmission en continu à partir d'une base de données distante.
Syntaxe
createLocalConnection [-verbose] -name streamConnection -connectionstring connectionString -user userName [-driver jdbcDriver] [-password password]
| Option | Abréviation | Description |
|---|---|---|
| -verbose | -v | Affiche des descriptions étendues. |
| -name | -N | Nom de la connexion |
| -connectionstring | -cs | Chaîne de connexion JDBC. Le format peut être avec SID, comme suit :
jdbc:oracle:thin:@host:port:SID ou avec un nom de service, comme suit : jdbc:oracle:thin:@host:port/service_name Reportez-vous aux exemples. |
| -user | -u | Nom d'utilisateur |
| -driver | -D | Pilote JDBC. S'il n'est pas indiqué, la base de données Oracle est considérée comme celle par défaut, sous la forme suivante : oracle.jdbc.driver.OracleDriver. |
| -password | -p | Mot de passe (facultatif) |
Exemples
Les exemples suivants illustrent différentes sources de données.
Si l'option -driver et le paramètre jdbcDriver ne sont pas indiqués, la base de données Oracle est la base de données par défaut.
Base de données Oracle – Exemple avec un SID (ID de service)
esscs createLocalConnection -N OracleDBConnection1 -cs jdbc:oracle:thin:@myhostname01:1521:ORCL -u OracleUser -D oracle.jdbc.driver.OracleDriver
Base de données Oracle – Exemple avec un nom de service
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
Si vous disposez d'une connectivité réseau entre une source de données externe et Essbase, il est plus efficace de définir des connexions et des sources de données globales ou de niveau application dans l'interface Web Essbase. Ces définitions vous aident à facilement "extraire" les données de la source externe. Si vous ne disposez pas d'une connectivité réseau entre Essbase et la source de données externe, vous devez alors transmettre les chargements de données ou les constructions de dimension à l'aide de l'interface de ligne de commande, en utilisant d'abord cette commande pour créer une connexion locale et en émettant ensuite le chargement de données ou la commande dimbuild avec l'option de flux de données.