Contribuez à la FAQ SQL*PLUS

Bonjour :P

Nous allons lancer une FAQ SQL*PLUS.

En effet SQL*PLUS est un outil de base de l'administration et de l'utilisation d'Oracle.

Outil très puissant (surtout couplé à du shell), SQL*Plus mérite donc une FAQ pour lui tout seul !

Veuillez ajouter à cette discussion vos suggestions de questions / réponses.

Les remarques pertinentes seront ainsi ajoutées à la FAQ.

Pour proposer une Q/R, merci de bien vouloir procéder comme ci-dessous :

Citation:

---

[QR] Comment présenter la question ?

La Q/R doit commencer par un texte introductif pour poser clairement et
brièvement le problème et donner la démarche pour le résoudre.

---

Merci à tous de votre collaboration

Quelle est ma version d'SQL*Plus ?

Pour vérifier la version d'SQL*Plus, tapez la commande suivante :

Code:

---

sqlplus -V

---

Comment se connecter à SQL*Plus ?

Allez dans le dossier $ORACLE_HOME/bin.

Ici se trouve l'exécutable sqlplus. Vous pouvez lancer directement sqlplus, on vous demandera un login et mot de passe pour vous connecter à votre base. Par contre cette méthode ne vous permettra pas de vous connecter à une autre base que celle par défaut ou avec un compte de type SYSDBA ou SYSOPER.

C'est pour cela qu'il convient de spécifier des paramètres de connection.

Voici la syntaxe pour ce connecter à SQL*Plus :

Code:

---

sqlplus (utilisateur[/mot_de_passe][@identifiant_BDD] | /) [AS SYSDBA | AS SYSOPER] | /NOLOG

---

Exemple pour se connecter avec l'utilisateur scott :

Code:

---

sqlplus scott/tiger

---

Exemple pour se connecter avec un compte SYSDBA

Code:

---

sqlplus sys/change_on_install as SYSDBA

---

Vous pouvez également taper la commande suivante et spécifier les paramètre de connexion directement dans le prompte sqlplus>

Code:

---

sqlplus /nolog

---

Ensuite pour ce connecter à un compte on utilise la même syntaxe que précédement mais avec la commande CONNECT

Code:

---

connect scott/tigger

---

ou

Code:

---

connect sys/change_on_install as SYSDBA

---

Comment afficher les propriétés liées à SQL*Plus ?

Tapez la commande suivante :

Code:

---

define

---

Le résultat sera le suivant (enfin suivant votre version) :

Code:

---

1 2 3 4 5 6 7 8

DEFINE _DATE = "30/03/09" (CHAR) DEFINE _CONNECT_IDENTIFIER = "XE" (CHAR) DEFINE _USER = "HR" (CHAR) DEFINE _PRIVILEGE = "" (CHAR) DEFINE _SQLPLUS_RELEASE = "1002000100" (CHAR) DEFINE _EDITOR = "Notepad" (CHAR) DEFINE _O_VERSION = "Oracle Database 10g Express Edition Release 10.2.0.1.0 - Production" (CHAR) DEFINE _O_RELEASE = "1002000100" (CHAR)

---

• _DATE : date courante
• _CONNECT_IDENTIFIER : identifiant de la base de données
• _USER : utilisateur avec lequel vous être connecté
• _PRIVILEGE : privilège utiliser pour se connecter (AS SYSDBA, AS SYSOPER)
• _SQLPLUS_RELEASE : numéro de version
• _EDITOR : éditeur qui sera utilisé pour modifier les requêtes
• _O_VERSION : nom de version de la base de données Oracle
• _O_RELEASE : numéro de version de la base de données

Vous pouvez évidement afficher séparément toutes ces valeurs en utilisant toujours la commande define et en spécifiant à la suite, la variable à afficher. Comme par exemple :

Code:

---

define _CONNECT_IDENTIFIER

---

Comment modifier le nombre de lignes par page au résultat d'un requête ?

Par défaut le nombre de lignes affiché par page est 11.

Exemple :

Code:

---

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

EMPLOYEE_ID FIRST_NAME LAST_NAME ----------- -------------------- ------------------------- 100 Steven King 101 Neena Kochhar 102 Lex De Haan 103 Alexander Hunold 104 Bruce Ernst 105 David Austin 106 Valli Pataballa 107 Diana Lorentz 108 Nancy Greenberg 109 Daniel Faviet 110 John Chen   EMPLOYEE_ID FIRST_NAME LAST_NAME ----------- -------------------- ------------------------- 111 Ismael Sciarra 112 Jose Manuel Urman 113 Luis Popp 114 Den Raphaely

---

Pour modifier cette valeur il suffit de taper la commande suivante pour afficher par exemple 100 lignes par page :

Code:

---

set pagesize 100

---

Résultat :

Code:

---

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17

EMPLOYEE_ID FIRST_NAME LAST_NAME ----------- -------------------- ------------------------- 100 Steven King 101 Neena Kochhar 102 Lex De Haan 103 Alexander Hunold 104 Bruce Ernst 105 David Austin 106 Valli Pataballa 107 Diana Lorentz 108 Nancy Greenberg 109 Daniel Faviet 110 John Chen 111 Ismael Sciarra 112 Jose Manuel Urman 113 Luis Popp 114 Den Raphaely

---

Comment modifier le nombre de caractères par ligne au résultat d'un requête ?

Par défaut le nombre de caractères par lignes est de 72. Pour modifier ce nombre tapez la commande suivante :

Code:

---

set linesize 200

---

Comment exécuter la dernière commande tapée ?

Utiliser le caractère slash "/" et taper sur entrée.

Code:

---

/

---

Comment savoir avec quel compte je suis connecté à SQL*Plus ?

Utiliser la commande suivante :

Code:

---

SHOW USER

---

Résultat (si mon nom d'utilisateur est JSD03) :

Code:

---

USER is "JSD03"

---

De quelles variables d'environnement j'ai besoins pour lancer SQL*Plus ?

Les variables suivantes sont nécessaires :

• $ORACLE_HOME : chemin vers l'installation Oracle
• $ORACLE_SID : nom de l'instance qui sera utilisé par SQL*Plus
• $PATH : chemin vers les binaires d'Oracle

D'où par exemple le résultat suivant (pour un serveur Unix) :

• $ORACLE_HOME : /oracle01/11gR1
• $ORACLE_SID : orcl
• $PATH : $PATH:$ORACLE_HOME/bin

L'initialisation de la variable $PATH vous permettra d'accéder directement à SQL*Plus sans aller dans le dossier des binaires d'Oracle.

Comment afficher le shéma et le nom de l'instance dans le prompt (à partir de la 10G) ?

Modifier le fichier <ORACLE_HOME>/sqlplus/admin/glogin.sql

et ajouter :

Code:

---

set sqlprompt "&_USER@&_CONNECT_IDENTIFIER> "

---

Comment compléter une ligne d'une requête ?

Prenons la requête suivante afin d'ajouter une nouvelle colonne dans la requête :

Code:

---

1 2	SQL> select EMPLOYEE_ID, FIRST_NAME 2 from employees

---

Maintenant il faut sélectionner la ligne voulue en tapant le numéro de ligne (ici 1)

Code:

---

1

---

Ensuite il suffit de taper la commande "a " (pour append) suivit de la nouvelle colonne

Code:

---

a , LAST_NAME

---

Maintenant la requête va être la suivante :

Code:

---

1 2	SQL> select EMPLOYEE_ID, FIRST_NAME, LAST_NAME 2 from employees

---

Sauvegarder La session de Travail

Code:

---

SPOOL fichier

---

enregistre dans le fichier les commandes tapées ensuite par l'utilisateur, et les réponses d'Oracle.

Code:

---

SPOOL OFF

---

arrête cette sauvegarde.

Comment afficher le temps d'exécution d'une requête ?

Code:

---

SET TIMI[ING] ON/OFF

---

Exemple :

Code:

---

1 2 3 4 5 6 7 8 9 10

SQL> set timing on SQL> select sysdate from dual;   SYSDATE -------- 15/05/09   Ecoulé : 00 :00 :00.04 SQL>

---

Afficher le contenu du Buffer

Code:

---

LIST

---

La commande LIST (abréviation : L) permet d'afficher le contenu du
buffer. Chaque ligne est précédée de son numéro. La dernière est précédée
de *
exemple :

Citation:

---

SQL> list
1* select * from account
SQL>

---

comment changer le mot de passe de l'utilisateur courant

Code:

---

password

---

Exemple

Citation:

---

SQL> conn scott
Enter password:
Connecte.
SQL> password
Modification de mot de passe pour SCOTT
Ancien mot de passe :
Nouveau mot de passe :
Ressaisir le nouveau mot de passe :
Mot de passe modifie
SQL>

---

comment executer un fichier .sql

Code:

---

@NomFichier

---

Exemple :
le fichier CreateSchema.sql il se trouve dans /home/oracle/scripts/

Citation:

---

@/home/oracle/scripts/CreateSchema.sql

---

Citation:

---

Envoyé par umarus

Afficher le contenu du Buffer

Code:

---

LIST

---

La commande LIST (abréviation : L) permet d'afficher le contenu du
buffer. Chaque ligne est précédée de son numéro. La dernière est précédée
de *
exemple :

---

Et ; fait la même chose :)

Basique, mais bon...

Citation:

---

Comment faire un copier-coller ?

Sélectionnez à la souris la partie à copier, puis appuyez sur le bouton droit de la souris tout en maintenant le bouton gauche. Le texte sélectionné est automatiquement copié et collé à l'emplacement du curseur d'écriture.

Comment passer ma requête dans un éditeur de code normal ?

Tapez la commande ed, ou bien utilisez le menu Edition > Editeur > Appeler Editeur. La dernière requête exécutée apparaît dans l'éditeur de texte externe défini par la configuration de SQL*Plus. Vous pouvez alors la modifier plus confortablement et la renvoyer dans SQL*Plus simplement en fermant l'éditeur.

---

Citation:

---

Envoyé par Antoun

Basique, mais bon...

---

Le soucis c'est que tu fais fais référence à sqlplusw, version graphique ms windows de sqlplus qui n'est pas sqlplus et spécifique à ms windows...

je pense qu'il faut se limiter à la version ligne de commande qui est dispo sur toute les plateformes oracle et qui est utiliseé pour les scripts et qui combinée au shell

Comment exécuter une commande système depuis SQL*Plus ?

Depuis le prompt SQL>, il est possible d'éxécuter une commande propre au système dexploitation à l'aide de ces deux commandes :

Code:

---

1 2	SQL> ! commande SQL> host commande

---

Exemple (pour un serveur Unix) :

Code:

---

1 2	SQL> ! date lun jan 10 10:29:06 CEST 2009

---

Il est possible de taper plusieurs commande à la suite en spécifiant uniquement "!" ou "HOST" puis en tapant sur la touche "ENTREE". Le prompt SQL> va se fermer et vous aurez accès au prompt système. Pour revenir à votre session SQL, tapez EXIT.

Comment désactiver le caractère & commercial dans une requête ?

Le caractère & permet de demander à un utilisateur une valeur de substitution via un prompt. Pour désactiver cette fonctionnalité, tapez la commande suivante :

Code:

---

SET DEFINE OFF

---

ou

Code:

---

SET SCAN OFF

---

Citation:

---

Envoyé par jsd03

Code:

---

1 2	SQL> ! commande SQL> host commande

---

---

Petite précision : le raccourci "!" n'est valable que pour les OS de la famille Unix, pour Windows c'est "$".

Citation:

---

Envoyé par jsd03

Comment désactiver le caractère & commercial dans une requête ?

Le caractère & permet de demander à un utilisateur une valeur de substitution via un prompt. Pour désactiver cette fonctionnalité, tapez la commande suivante :

Code:

---

SET DEFINE OFF

---

ou

Code:

---

SET SCAN OFF

---

---

Selon la doc Oracle, SCAN OFF est considéré comme périmé depuis des lustres, même s'il fonctionne encore.

On peut préciser que & est le marqueur par défaut qui indique que le mot qui suit est une variable de substitution.
Si on ne veut pas que & soit interprété comme tel, mais qu'on a néanmoins besoin des variables de substitution, on peut utiliser comme marqueur un caractère un peu exotique de son choix, dont on sait qu'il n'apparaîtra pas dans les chaînes de caractères qu'on manipule.
Ici, } a le même effet que le & avait, et le & est désormais considéré comme caractère normal.

Code:

---

1 2	SET DEFINE } }MAVAR

---

Comment activer l'affichage du buffer pour la session Sqlplus en cours?

Code:

---

Set serveroutput on

---

Comment augmenter la taille du buffer?

Code:

---

Set serveroutput on size 1000000

---

Comment changer une chaine par une autre dans une requête ?

Prenons la requête suivante afin de modifier la chaine de caractère 'EMPLOYEE_ID' par 'DEPARTEMENT_ID'

Code:

---

1 2	SQL> SELECT EMPLOYEE_ID, FIRST_NAME 2 FROM employees

---

Maintenant il faut sélectionner la ligne voulue en tapant le numéro de ligne (ici 1 pour modifier la première ligne)

Code:

---

SQL> 1

---

Ensuite il suffit de taper la commande "c" (pour CHANGE) de la chain de caractère à modifier ainsi que la nouvelle chaine.

Code:

---

SQL> c /EMPLOYEE_ID/DEPARTEMENT_ID

---

Maintenant la requête va être la suivante :

Code:

---

1 2	SQL> SELECT DEPARTEMENT_ID, FIRST_NAME 2 FROM employees

---

Comment définir la taille d'une colonne de type VARCHAR2 à l'affichage d'un requête ?

Prenons pour exemple la requête suivante :

Code:

---

select employee_id, first_name, last_name from employees where rownum < 10;

---

qui renvoit les lignes suivantes :

Code:

---

1 2 3 4 5 6 7 8 9 10 11

EMPLOYEE_ID FIRST_NAME LAST_NAME ----------- -------------------- ------------------------- 100 Steven King 101 Neena Kochhar 102 Lex De Haan 103 Alexander Hunold 104 Bruce Ernst 105 David Austin 106 Valli Pataballa 107 Diana Lorentz 108 Nancy Greenberg

---

Je vais modifier la taille de la colonne first_name pour n'afficher que 8 caractères.

Code:

---

COLUMN first_name FORMAT A8;

---

Maintenant l'affichage sera :

Code:

---

1 2 3 4 5 6 7 8 9 10 11 12 13

EMPLOYEE_ID FIRST_NA LAST_NAME ----------- -------- ------------------------- 100 Steven King 101 Neena Kochhar 102 Lex De Haan 103 Alexande Hunold r   104 Bruce Ernst 105 David Austin 106 Valli Pataballa 107 Diana Lorentz 108 Nancy Greenberg

---

Explication :

COLUMN first_name : on spécifie que l'on sélectionne la colonne first_name
FORMAT A8 : on définit que l'on souhaite modifier la longueur de la colonne pour ne prendre plus que 8 caractères et renvoyer les autres à la lignes.

On voit que pour l'employé 103, son prénom se trouve maintenant sur 2 ligne car il contient plus de 8 caractères.

Cette fonction est très utile quand on a, par exemple, une colonne de type VARCHAR2(200) et que l'on sait que la longueur maximum que l'on peut trouver dans cette colonne est 50, on va donc spécifier A50 pour éviter d'afficher des espaces superflu à l'affichage de la requête.

On peut aussi spécifier de tronquer la colonne une fois le nombre de caractère afficher au lieu de retourner à la ligne avec le mot TRUNCATE.

Exemple :

Code:

---

COLUMN first_name FORMAT A8 TRUNCATE;

---

Résultat :

Code:

---

1 2 3 4 5 6 7 8 9 10 11

EMPLOYEE_ID FIRST_NA LAST_NAME ----------- -------- ------------------------- 100 Steven King 101 Neena Kochhar 102 Lex De Haan 103 Alexande Hunold 104 Bruce Ernst 105 David Austin 106 Valli Pataballa 107 Diana Lorentz 108 Nancy Greenberg

---

Notez que le prénom de l'employé 103 est tronqué.

Comment afficher un titre en début de chaque page de mon résultat de requête ?

Pour cela il faut utiliser la la fonction TTITLE :

Code:

---

TTITLE 'Mon titre'

---

Retour :

Code:

---

1 2 3 4 5 6 7 8 9 10 11 12 13 14

Ven. Juin 05 page 1   Mon titre   EMPLOYEE_ID FIRST_NAME LAST_NAME ----------- -------------------- ------------------------- 100 Steven King 101 Neena Kochhar 102 Lex De Haan 103 Alexander Hunold 104 Bruce Ernst 105 David Austin 106 Valli Pataballa 107 Diana Lorentz

---

Comme vous pouvez le voir maintenant en haute de chaque page mon titre s'affiche ainsi que la date du jour et le numéro de la page.

Pour arrêter l'affichage du titre utilisez la commande suivante :

Code:

---

TTITLE OFF

---

Dans le même esprit on peut ajouter du texte à la fin d'une page :

Code:

---

BTITLE 'Fin de page'

---

Retour :

Code:

---

1 2 3 4 5 6 7 8 9 10 11 12 13

EMPLOYEE_ID FIRST_NAME LAST_NAME ----------- -------------------- ------------------------- 100 Steven King 101 Neena Kochhar 102 Lex De Haan 103 Alexander Hunold 104 Bruce Ernst 105 David Austin 106 Valli Pataballa 107 Diana Lorentz 108 Nancy Greenberg   Fin de page

---

Comment exécuter un script *.sql sans ouvrir SQL*Plus ?

Il vous suffit de combiner les commandes de connexion et d'ajouter à la suite < Fichier.SQL

Exemple :

Code:

---

sqlplus scott/tigger < "c:/script.sql"

---

Le script "script.sql" sera exécuté avec le compte scott et rendra la main au système d'exploitation une fois le script terminé.

Comment quitter correctement SQL*Plus ?

Pour quitter correctement SQL*Plus, tapez la commande :

Code:

---

SQL> exit

---

ou

Code:

---

SQL> quit

---

On peut aussi spécifier de d'appliquer les changements où non aux requêtes précédemment exécutées. En spécifiant à la suite, COMMIT ou ROLLBACK.

Pour information, la commande DISCONNECT permet uniquement de fermer la session de l'utilisateur courant pour permettre par exemple de se connecter avec un autre utilisateur.

Comment exporter toutes les variables d'environnements de SQL*Plus ?

Il peut être nécessaire d'exporter les variables d'environnement afin de les réutiliser sur une autres base de données.

Pour cela taper la commande suivante :

Code:

---

SQL> store set fileName

---

exemple :

Code:

---

SQL> store set "c:/sqlVariables.txt"

---

De la même manière, pour réimporter ces variables, taper la commande :

Code:

---

SQL> @"c:/sqlVariables.txt"

---

Comment afficher la valeur d'une variable d'environnement de SQL*Plus ?

Pour faire cela, il faut utiliser la commande suivante :

Code:

---

SQL> show variableName

---

Exemple pour afficher le nombre de ligne par page :

Code:

---

1 2	SQL> show pagesize pagesize 14

---

Pour afficher toutes les variables :

Code:

---

SQL> show all

---

Comment changer le nom du prompt SQL> ?

On peut parfois vouloir changer le nom du prompt SQL> pour une nouvelle valeur.

Pour ce faire, tapez la commande suivante :

Code:

---

set sqlprompt "nouvelleValeur"

---

Exemple :

Code:

---

set sqlprompt "jsd03 SQL> "

---

Citation:

---

Envoyé par jsd03

Exemple :

Code:

---

set sqlprompt "jsd03 SQL> "

---

---

Pour faire le lien avec "Comment afficher les propriétés liées à SQL*Plus ?", il est commode d'intégrer dans l'invite de SQL*Plus des variables de substitution prédéfinies, par exemple _CONNECT_IDENTIFIER qui sera remplacé par le nom de la base à laquelle on est connecté :

Code:

---

1 2 3

SQL> SQL>SET SQLPROMPT &_USER@&_CONNECT_IDENTIFIER.***&_DATE> SYS@ORA10***12/06/09>

---

Attention cependant : l'invite ne prend pas en compte le changement de valeur des variables de substitution qu'elle contient :

Code:

---

1 2 3 4 5 6 7 8 9

SQL> SQL> SET SQLPROMPT &_USER@&_CONNECT_IDENTIFIER.***&_DATE> SYS@ORA10***12/06/09> SYS@ORA10***12/06/09>connect scott/tiger Connecté. SYS@ORA10***12/06/09> SYS@ORA10***12/06/09>prompt &_USER SCOTT SYS@ORA10***12/06/09>

---

Je me suis connecté sous SCOTT, mais le prompt continue à afficher SYS. Pourtant, la variable _USER a bien été valorisée.

Comment activer / utiliser l'aide SQL*Plus ?

Pour utiliser l'aide sur une commande, il suffit de taper HELP suivit de la commande. Exemple :

Code:

---

help show

---

ou encore

Code:

---

help host

---

Il se peut néanmoins que cette aide ne soit pas installée. Pour cela, connectez allez dans le dossier $ORACLE_HOME/sqlplus/admin/help et lancer les commandes suivantes avec un compte SYS ou SYSTEM :

Code:

---

1 2 3

sqlplus SYS/password @helpdrop.sql --supprime les tables d'aide si elles existent déjà sqlplus SYS/password @helpbld.sql --créée les tables d'aide sqlplus SYS/password @helpus.sql --charge les données dans les tables d'aide

---

Comment créer des rapports HTML ?

Il est possible avec SQL*Plus de générer des fichiers HTML pour afficher le résultat d'un requête.

Pour se faire, créé un fichier avec le code suivant et exécutez le avec la commande

Code:

---

SQL> @generateReport.sql

---

Code:

---

1 2 3 4 5 6 7 8 9 10 11 12

SET MARKUP HTML ON SPOOL ON PREFORMAT OFF ENTMAP ON HEAD "<TITLE>Rapport 1</TITLE> <style>th {background-color: #7FCF00;} td {background-color:#FFEE9F;}</style>" BODY "><div>Mon premier rapport</div" spool c:\rapport01.html   TTITLE "- Liste des employés -"   SELECT * FROM employees; /   set markup html off spool off spool off

---

Explications :
- SET MARKUP HTML : active les rapports HTML
- SPOOL ON : active la sortie vers un fichier
- PREFORMAT OFF : désactive le préformatage du résultat de la requête
- ENTMAP ON : remplace les caractères spéciaux tel que &, >, <... par leur code html
- HEAD : définit le code à l'intérieur des balises <head></head> ; le code qui suit, sera inséré entre ces balise. On peut alors inclure des fichiers styles, du javascript...
- BODY : définit les paramètres des balises body ; par exemple si j'avais mis

Code:

---

BODY " bgcolor='red' "

---

le fond de mon rapport aurait été en rouge. C'est pour cela que dans mon exemple j'ai d'abord fermé la balise <body> pour afficher un bloque <div> à la suite et que je n'ai pas terminé mar balise </div car SQL*Plus s'en chargera quand il génèrera le rapport.
- spool filename : créée le rapport dans le fichier qui suit
- TTITLE : définit le titre du rapport
- la requête
- set markup html off spool off spool off : on réinitialise toutes les variables SQL*Plus

Vous pourrez voir l'exemple de rapport créé en pièce jointe