LLI Wiki — My Digital Knowledge Base

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

Mastodon LLIMastodon SocialFosstodon