Se connecter à Oracle : variables d'environnement, SQL*Plus et SQLcl
Aide-mémoire des variables d'environnement Oracle (Linux, Windows, AIX) et des syntaxes de connexion SQL*Plus et SQLcl.
Aide-mémoire pour se connecter à des bases Oracle en ligne de commande : variables d'environnement sous Linux, Windows et AIX, syntaxes de connexion SQL*Plus et SQLcl.
Variables d'environnement
Linux
Repérer les instances actives, puis définir l'environnement de l'instance visée :
ps -ef | grep pmon
export ORACLE_SID=orcl
export ORACLE_HOME=/u01/app/oracle/product/19.0.0/dbhome_1
export PATH=$PATH:$ORACLE_HOME/bin
export NLS_LANG='english_united kingdom.we8iso8859p1'
export NLS_DATE_FORMAT="YYYY-MM-DD HH24:MI:SS"
L'ORACLE_HOME de chaque instance figure dans /etc/oratab (format SID:ORACLE_HOME:Y|N). Une commande unique qui affiche les instances actives et l'environnement courant avant de définir les variables :
ps -ef | grep pmon && env && export ORACLE_SID=orcl && export ORACLE_HOME=/u01/app/oracle/product/19.0.0/dbhome_1 && export PATH=$PATH:$ORACLE_HOME/bin
Certaines installations nécessitent aussi ORACLE_BASE :
export ORACLE_BASE=/u01/app/oracle
Windows
Faire pointer TNS_ADMIN vers le répertoire contenant tnsnames.ora (variable d'environnement système), puis choisir l'instance et se connecter :
TNS_ADMIN=C:\oracle\product\19.3.0\client_1\network\admin
set ORACLE_SID=ORCL
sqlplus sys/<PASSWORD>@ORCL as sysdba
sqlplus "sys/<PASSWORD>@ORCL as sysdba"
Pour l'authentification locale par le système d'exploitation (sans mot de passe) :
sqlplus "/@ORCL as sysdba"
AIX
Configuration du shell et commandes de supervision utiles :
set -o vi # édition de la ligne de commande façon vi (Esc k pour rappeler la commande précédente)
topas # moniteur système en temps réel
errpt -a # journal d'erreurs détaillé
vmstat 2 5 # statistiques mémoire/CPU, 5 échantillons toutes les 2 secondes
svmon -G # utilisation mémoire globale
Méthodes de connexion SQL*Plus
Via un alias TNS (nom de service réseau)
L'alias doit exister dans tnsnames.ora.
sqlplus username/password@NET_SERVICE_NAME
Via Easy Connect (hôte, port, nom de service)
sqlplus username/password@host:1521/SERVICE_NAME
sqlplus app_user/<PASSWORD>@oradb01:1521/orcl.example.com
Via un descripteur de connexion complet
Utile en l'absence d'entrée dans tnsnames.ora. L'option -L limite SQL*Plus à une seule tentative de connexion, ce qui évite la boucle de nouvelle saisie en cas de mauvais mot de passe.
sqlplus -L "app_user/<PASSWORD>@(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=192.0.2.11)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=orcl.example.com)))"
sqlplus -L "app_user/<PASSWORD>@(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SID=XE)))"
Utiliser SERVICE_NAME ou SID dans CONNECT_DATA selon ce qu'expose le listener.
Connexion en SYSDBA
sqlplus / as sysdba
sqlplus "sys/<PASSWORD>@ORCL as sysdba"
Connexion quand l'instance est bloquée : -prelim
L'option -prelim s'attache à la SGA sans créer de session SQL*Plus complète, ce qui aide quand les connexions normales se bloquent (par exemple pour lancer oradebug).
sqlplus -prelim "/ as sysdba"
Éditer le tampon de commande sous Linux
define _editor=vim
ed
/
SQLcl
SQLcl est le client en ligne de commande d'Oracle (voir la documentation SQLcl). Il accepte les mêmes chaînes Easy Connect et peut aussi se connecter par SID avec hôte:port:SID.
sql /nolog
CONN sys/<PASSWORD>@oradb01:1521:ORCL as sysdba
CONN monitor_user/<PASSWORD>@oradb01:1521:ORCL
-- par nom de service
sql sys/<PASSWORD>@oradb01:1521/ORCL.example.com as sysdba
-- par alias TNS
sql "monitor_user/<PASSWORD>@ORCL"
Historique des commandes dans SQLcl :
history
history 1 run
history 1 edit
Remarques
- Les mots de passe ont été remplacés par
<PASSWORD>; évitez de les saisir en ligne de commande sur un hôte partagé, car ils sont visibles dans la liste des processus et l'historique du shell. Préférezsqlplus /nologsuivi deCONNECT, ou l'authentification par le système d'exploitation. - Les noms d'hôtes, d'instances, de services, le domaine et les adresses IP sont des exemples génériques.
- L'installation du client Oracle et la syntaxe de
tnsnames.orasont décrites dans la documentation Oracle.