Utilitaire runSQL

L'utilitaire runSQL exécute des instructions SQL définies dans un ou plusieurs fichiers par rapport à une base de données.

Syntaxe de commande

./runSQL.sh [-dbProfile profileName] [-dbName dbname] [-dbSchema schemaName] [-dbType dbType] 
[-dbUser username] [-dbPassword password] [-file sqlfile] [-listFile listfile -listFileDir directory] 
[-help] [-trace integer] [-log logName] [-:propertyName propertyValue] [-:propertyName propertyValue] ...

Valeurs des paramètres

dbProfile

Le nom de profil de base de données, qui est utilisé pour rechercher un profil dans le fichier alldbconnector.xml. Le paramètre dbType est requis. Un seul dbProfile ou dbName peut être fourni. Si aucun n'est renseigné, la valeur par défaut, -dbProfile default, est utilisée.

dbName

Le nom d'hôte ou l'URL JDBC. Un seul dbProfile ou dbName peut être fourni.

dbSchema

Le nom du schéma dans lequel exécuter SQL. Si ce paramètre n'est pas fourni, la valeur par défaut wcs est utilisée.

dbType

Cette valeur peut être db2 ou oracle.

dbUser

Le nom d'utilisateur utilisé pour se connecter. Si dbProfile est fourni, cette valeur sera ignorée et n'est pas requise.

dbPassword

Le mot de passe correspondant au nom d'utilisateur donné. Si dbProfile est fourni, cette valeur sera ignorée et n'est pas requise.

fichier

Le chemin d'accès complet ou relatif d'un fichier qui contient des instructions SQL à exécuter. Ce paramètre ou listFile est requis.

listFile

Nom d'un fichier qui contient une liste d'autres fichiers SQL à exécuter. Chaque ligne contient un nom de fichier SQL, qui doit être un chemin d'accès relatif à listFileDir. Les fichiers SQL seront exécutés dans l'ordre dans lequel ils se produisent dans le fichier. Ce paramètre ou fichier est requis.

listFileDir

Le répertoire de base des chemins relatifs répertoriés dans le fichier spécifié par listFile. Ce paramètre est requis si listFile est utilisé.

Aide

Imprime ce message et ignore tous les autres paramètres.

trace

Défini la quantité d'informations de journalisation à fournir. La valeur par défaut est 2 et inclut les informations de base, les erreurs et les avertissements. La valeur doit être comprise entre 0 et 3.

0 est le niveau minimum de journalisation.
1 inclut toutes les lignes du niveau de journalisation 0, mais consigne également les erreurs.
2 inclut toutes les lignes du niveau de journalisation 1, mais consigne également les avertissements.
3 inclut toutes les lignes du niveau de journalisation 2, mais consigne également des informations de diagnostic supplémentaires.

log

Spécifie le nom de base du fichier journal La valeur par défaut est runSQL.log. Un horodatage est ajouté au nom de fichier.

:propertyName

Il est possible de spécifier un nombre quelconque de propriétés de connexion qui seront définies sur la connexion. Cela peut être utilisé pour spécifier des propriétés spécifiques à la base de données. Si une substitution dans alldbconnector.xml est utilisée et spécifie la même propriété, la valeur dans alldbconnector.xml sera prioritaire.

Remarques sur l'utilisation

Les propriétés système incluent les éléments suivants :
- Une propriété système appelée WCInstallDir qui spécifie le répertoire d'installation HCL Commerce (WCInstallDir) doit être définie. En général, cela se fait par le script d'appel.
  Par exemple : -propertyname:DWCInstallDir=/opt/WebSphere/CommerceServer90
- Une propriété système appelée sslConnection indique que la base de données en cours d'exécution requiert ou prend en charge les connexions chiffrées SSL. Définissez cette valeur de propriété sur true pour que l'utilitaire utilise SSL lors de l'établissement d'une connexion avec la base de données.
  Par exemple : -propertyname:sslConnection=true
DbName peut être spécifié de l'une des deux manières suivantes :
- S'il s'agit d'une URL JDBC, elle se présente sous l'une des formes suivantes :
```
jdbc:db2://hostname:port/name
jdbc:oracle:thin:@hostname:port:SID
jdbc:oracle:thin:@//hostname:port/service
```
  Dans ce style, les paramètres dbUser et dbPassword sont requis.
- Si dbName est un nom d'hôte, il peut être spécifié sous la forme suivante :
```
hostname:port/name
```
  où name est le nom de la base de données. Dans ce style, les paramètres dbType, dbUser et dbPassword sont requis.

Exemple

Exemple d'utilisation avec une URL :

./runSQL.sh -dbUser wcs -dbPassword password -dbName jdbc:db2://DB2_host:ssl_DB2_port/mall -file insert.sql -:sslConnection true

Exemple d'utilisation avec un profil :

./runSQL.sh -dbType db2 -dbProfile mall -file insert.sql -:sslConnection true

Exemple d'utilisation avec le profil default :

./runSQL.sh -dbType db2 -file insert.sql -:sslConnection true