Help Contents

Interface utilisateur iSQL*Plus


Ressources SQL*Plus

Navigation dans iSQL*Plus

Il existe plusieurs façons de naviguer dans iSQL*Plus :

Icônes

Les icônes de navigation globale sont affichées dans chaque écran, dans l'un des deux états suivants :

Trois icônes de navigation sont toujours disponibles une fois que vous êtes connecté à iSQL*Plus :

Déconnecter

logout.gif : image de l'icône Déconnexion d'iSQL*Plus

Supprime la liste d'historique, met fin à la session iSQL*Plus et affiche l'écran de connexion avec un message confirmant la déconnexion.

Préférences

prefs.gif : image de l'icône Préférences d'iSQL*Plus

Ouvre l'écran Préférences, où vous pouvez configurer des paramètres d'interface et des paramètres système, ou modifier votre mot de passe.

Aide

help.gif : image de l'icône Aide d'iSQL*Plus

Ouvre l'aide iSQL*Plus dans une fenêtre de navigateur Web distincte. L'aide est également disponible à partir de l'écran de connexion.

Onglets

Les onglets apparaissent dans l'angle supérieur droit de l'écran en cours. Cliquez sur un onglet pour accéder à l'écran correspondant.

Menus

Des menus latéraux permettent d'accéder aux écrans comprenant des sections comme Préférences. Cliquez sur le lien pour accéder à l'écran souhaité.

Liens de pied de page

Les liens de pied de page sont des liens de navigation permettant d'accéder aux écrans disponibles indiqués au bas de chaque page. Cliquez sur un lien pour accéder à l'écran correspondant.

Ecran de connexion iSQL*Plus

Vous obtenez l'écran de connexion à partir de votre navigateur Web en utilisant une URL du type :

http://machine_name.domain:port/isqlplus

L'écran Connexion apparaît :

Nom utilisateur :

Entrez un nom utilisateur valide pour la connexion à Oracle Database (obligatoire).

Mot de passe :

Saisissez un mot de passe valide pour l'utilisateur indiqué (obligatoire).

Identificateur de connexion :

Pour utiliser la base de données Oracle par défaut, laissez ce champ vide. Sinon, saisissez l'identificateur de connexion de la base de données à laquelle vous voulez vous connecter.

[//]host[:port][/[service_name]]

Vous pouvez éventuellement utiliser l'expression (INSTANCE_NAME=instance) au lieu de l'expression (SERVICE_NAME=name). Lorsque vous vous connectez à une base de données Oracle8 ou antérieure, vous utilisez (SID=name). Sinon, vous pouvez utiliser un alias Oracle Net. Dans ce cas, cet alias doit être défini sur l'ordinateur exécutant le serveur iSQL*Plus Server, qui n'est pas forcément le même que celui qui exécute votre navigateur Web.

iSQL*Plus peut être configuré de sorte à limiter les connexions à des bases de données spécifiques. Lorsque l'accès restreint aux bases de données est activé, une liste déroulante proposant les bases de données disponibles apparaît à la place du champ de texte Identificateur de connexion. La sécurité est ainsi renforcée sur les serveurs iSQL*Plus Server dans les environnements hébergés. Vous effectuez cette configuration via le paramètre iSQLPlusConnectIdList du fichier de configuration. Pour plus d'informations, reportez-vous à Activation de l'accès restreint aux bases de données.

Pour plus de détails sur la définition d'identificateurs de connexion, reportez-vous au manuel Oracle Database Net Services Administrator's Guide.

Connexion

Cliquez sur le bouton Se connecter pour vous connecter à iSQL*Plus. Si vous entrez un nom utilisateur ou un mot de passe non valide, l'écran Se connecter réapparaît avec un message d'erreur.

Ecran de connexion DBA iSQL*Plus

Vous pouvez vous connecter à iSQL*Plus avec des privilèges SYSDBA ou SYSOPER pour effectuer des tâches d'administration de base de données, et exécuter des commandes DBA via iSQL*Plus. Vous devez vous authentifier auprès du serveur d'applications, et disposer de privilèges SYSDBA ou SYSOPER Oracle.

Pour se connecter avec des privilèges SYSDBA ou SYSOPER, les utilisateurs doivent avoir été créés via le gestionnaire d'utilisateurs OC4J. Pour ajouter des utilisateurs en vue de la connexion DBA, reportez-vous à Activation de l'accès DBA à iSQL*Plus.

Pour les opérations DBA d'exécution longue, il est recommandé d'utiliser la ligne de commande SQL*Plus, en raison du risque de temporisation réseau HTTP.

Pour vous connecter avec des privilèges SYSDBA ou SYSOPER, vous devez saisir l'URL DBA iSQL*Plus dans le champ Adresse de votre navigateur Web. Cette URL se présente comme suit :

http://machine_name.domain:port/isqlplus/dba

La boîte de dialogue Entrez les informations de réseau apparaît.

Nom utilisateur

Saisissez un nom utilisateur d'authentification auprès du serveur d'applications valide. Ce nom n'est pas forcément identique à votre nom utilisateur Oracle Database.

Mot de passe

Saisissez un mot de passe d'authentification auprès du serveur d'applications valide pour le nom utilisateur entré. Ce mot de passe n'est pas forcément identique à votre mot de passe Oracle Database.

Une fois que vous vous êtes authentifié avec succès, l'écran de connexion DBA iSQL*Plus apparaît.

Nom utilisateur :

Entrez un nom utilisateur valide pour la connexion à Oracle Database (obligatoire).

Mot de passe :

Saisissez un mot de passe valide pour l'utilisateur indiqué.

Identificateur de connexion :

Pour utiliser la base de données Oracle par défaut, laissez ce champ vide. Sinon, saisissez l'identificateur de connexion de la base de données à laquelle vous voulez vous connecter.

[//]host[:port][/[service_name]]

Vous pouvez éventuellement utiliser l'expression (INSTANCE_NAME=instance) au lieu de l'expression (SERVICE_NAME=name). Lorsque vous vous connectez à une base de données Oracle8 ou antérieure, vous utilisez (SID=name). Sinon, vous pouvez utiliser un alias Oracle Net. Dans ce cas, cet alias doit être défini sur l'ordinateur exécutant le serveur iSQL*Plus Server, qui n'est pas forcément le même que celui qui exécute votre navigateur Web.

iSQL*Plus peut être configuré de sorte à limiter les connexions à des bases de données spécifiques. Lorsque l'accès restreint aux bases de données est activé, une liste déroulante proposant les bases de données disponibles apparaît à la place du champ de texte Identificateur de connexion. La sécurité est ainsi renforcée sur les serveurs iSQL*Plus Server dans les environnements hébergés. Vous effectuez cette configuration via le paramètre iSQLPlusConnectIdList du fichier de configuration. Pour plus d'informations, reportez-vous à Activation de l'accès restreint aux bases de données.

Privilège :

La liste déroulante Privilège comporte deux options :

Connexion

Cliquez sur le bouton Se connecter pour vous connecter à iSQL*Plus avec le nom utilisateur, le mot de passe, l'identificateur de connexion et le privilège DBA fournis. Si vous entrez un nom utilisateur ou un mot de passe non valide, vous revenez à l'écran de connexion et un message apparaît.

Espace de travail iSQL*Plus

L'espace de travail se compose des écrans Espace de travail, Historique et Charger le script. Une fois la connexion établie, l'espace de travail apparaît. A partir de cet espace, vous pouvez :

Les écrans Espace de travail et Historique affichent les informations de connexion utilisateur dans l'angle supérieur droit. Ces informations apparaissent sous la forme suivante :

Connected as [username]@[connection_identifier] [AS SYSDBA| AS SYSOPER]

ou

Not connected 

Effacer

Efface toutes les instructions dans la zone d'entrée et toutes les sorties affichées. Annule tout script en cours d'exécution.

Cette opération n'efface pas le tampon SQL, ni les valeurs de variable modifiées par le changement des préférences ou des options de la commande SET.

Exécuter

Exécute le contenu de la zone d'entrée. Selon les préférences que vous avez définies, les résultats apparaissent dans la zone de sortie ou dans une nouvelle fenêtre de navigateur Web, ou sont enregistrés dans un fichier.

Charger le script

Affiche l'écran Charger script, dans lequel vous pouvez saisir un chemin et un nom de fichier, ou l'URL du script à charger dans la zone d'entrée afin de le modifier ou de l'exécuter.

Enregistrer le script

Affiche la boîte de dialogue Fichier > Enregistrer sous, où vous pouvez entrer un nom de fichier pour le script à enregistrer à partir de la zone d'entrée en tant que fichier texte. Il peut être utile d'identifier les scripts par l'extension .SQL.

Annuler

Annule tous les scripts en cours d'exécution, mais n'efface pas la zone d'entrée ou de sortie. Un message indiquant que le script a été annulé apparaît.

Page suivante

Affiche la page suivante de la sortie du rapport. Le bouton Page suivante est affiché lorsque les résultats ne tiennent pas tous sur la page de sortie en cours ou lorsque le script contient une commande PAUSE.

Vous pouvez indiquer si les pages doivent être affichées sur une seule page ou sur plusieurs pages via Préférences > Configuration de l'interface > Configuration de la page de sortie, ou en exécutant la commande SET PAUSE ON ou SET PAUSE OFF.

Vous pouvez utiliser le bouton Précédente de votre navigateur Web pour visualiser les pages précédentes des résultats d'iSQL*Plus. Certains navigateurs Web ne prennent pas en charge cette utilisation du bouton Précédente.

Espace de travail DBA iSQL*Plus

Lorsque vous vous connectez avec des privilèges SYSDBA ou SYSOPER, l'espace de travail DBA iSQL*Plus apparaît pour vous rappeler que vous disposez d'une connexion avec privilèges. Sinon, il est identique à l'espace de travail iSQL*Plus décrit précédemment.

Renseignez les champs de l'espace de travail DBA de la même manière que ceux de l'espace de travail iSQL*Plus standard.

Les informations de connexion n'apparaissent pas dans l'écran Préférences.

Ecran Historique iSQL*Plus

Cliquez sur l'onglet Historique pour afficher l'écran de même nom. Cet écran permet de recharger des scripts exécutés précédemment au cours de la même session.

Une entrée d'historique est créée chaque fois que vous exécutez dans l'espace de travail un script autre que le dernier script exécuté. L'écran Historique affiche les 80 premiers caractères du script.

Une fois la limite de l'historique atteinte, les scripts les plus anciens sont enlevés. Lorsque vous quittez une session, l'historique est perdu ; il n'est pas conservé d'une session à l'autre.

Vous pouvez modifier le nombre par défaut d'entrées de l'historique dans l'écran Options d'interface, accessible à partir de l'écran Préférences.

Script

Affiche la liste en cours des scripts de l'historique. Ces scripts sont présentés dans l'ordre d'exécution, les scripts exécutés le plus récemment étant en tête de liste. Cochez les cases correspondant aux scripts à charger dans la zone d'entrée.

Attention, les scripts sont affichés mot pour mot. Or, ils peuvent contenir par exemple des commandes CONNECT avec des mots de passe.

Charger

Charge les scripts sélectionnés dans la zone d'entrée de l'espace de travail.

Supprimer

Supprime les scripts sélectionnés de l'historique.

Cliquez sur l'onglet Espace de travail pour revenir à la zone d'entrée sans charger ni supprimer les scripts de la liste d'historique.

Ecran Entrée obligatoire iSQL*Plus

Lorsqu'iSQL*Plus exécute un script contenant des variables de substitution, l'écran Entrée obligatoire apparaît pour chacune de ces variables. Par exemple, si vous saisissez :

BREAK ON &&SORTCOL SELECT &SORTCOL, SALARY FROM &MYTABLE WHERE SALARY > 12000 ORDER BY &SORTCOL;

L'écran Entrée obligatoire apparaît.

Saisie de la valeur de sortcol

Entrez une valeur pour la variable sortcol. Par exemple, entrez LAST_NAME. Quand une variable de substitution n'est pas définie et qu'elle est référencée avec une seule perluète, vous êtes invité à saisir sa valeur à chaque occurrence. Si vous définissez la variable avec deux perluètes, la valeur entrée est conservée pour toute la durée de la session en cours.

A l'invite, entrez une valeur pour la variable mytable. Par exemple, entrez EMP_DETAILS_VIEW.

Continuer

Cliquez sur le bouton Continuer pour exécuter le script dans la zone d'entrée avec les valeurs que vous avez saisies.

Annuler

Cliquez sur le bouton Annuler pour annuler l'exécution du script et revenir à l'espace de travail.

Ecran Préférences iSQL*Plus

L'écran Préférences permet de modifier les paramètres d'interface, les paramètres système et le mot de passe. Les boutons Annuler et Appliquer apparaissent sur chaque écran de préférences, et ont la même fonction sur tous ces écrans. Cliquez sur l'onglet Espace de travail ou Historique pour revenir à l'écran correspondant.

Annuler

Cliquez sur le bouton Annuler pour annuler les modifications apportées à cet écran de préférences.

Appliquer

Cliquez sur le bouton Appliquer pour appliquer les modifications apportées à cet écran de préférences.

Configuration de l'interface

Cliquez sur Configuration de l'interface dans le menu latéral pour ouvrir l'écran de même nom.

Configuration système

Vous pouvez cliquer sur l'une des trois entrées sous Configuration système dans le menu latéral pour ouvrir les trois écrans suivants :

Formatage du script

Cliquez sur Formatage du script dans le menu latéral pour ouvrir l'écran de même nom. Vous pouvez utiliser cet écran pour définir les options d'affichage de la sortie du script.

Chacune de ces options contient un champ, des boutons d'option ou une zone de texte permettant de modifier le paramètre, avec un texte explicatif.

Exécution du script

Cliquez sur Exécution du script dans le menu latéral pour ouvrir l'écran de même nom. Vous pouvez utiliser cet écran pour définir les options d'exécution des scripts.

Chacune de ces options contient un champ, des boutons d'option ou une zone de texte permettant de modifier le paramètre, avec un texte explicatif.

Administration de base de données

Cliquez sur Administration de base de données dans le menu latéral pour ouvrir l'écran de même nom. Vous pouvez utiliser cet écran pour définir les options d'administration de base de données.

Chacune de ces options contient un champ, des boutons d'option ou une zone de texte permettant de modifier le paramètre, avec un texte explicatif.

Modifier le mot de passe

Cliquez sur Modifier le mot de passe dans le menu latéral pour accéder à l'écran correspondant.

Préférences et commandes SET équivalentes

Les tableaux suivants indiquent les préférences disponibles dans chacun des quatre écrans de préférences, ainsi que les variables système équivalentes qui peuvent être définies à l'aide de la commande SET.

Configuration de l'interface

Préférence iSQL*Plus Commande SET équivalente
Taille de l'historique Non applicable
Taille de la zone de saisie Non applicable
Emplacement de sortie Non applicable
Configuration de la page de sortie SET PAGESIZE, SET PAUSE

Formatage du script

Préférence iSQL*Plus Commande SET équivalente
Description des objets SET DESCRIBE
Affichage des variables attachées (bind variables) SET AUTOPRINT
Afficher les commandes SET ECHO
Affichage des en-têtes SET HEADING
Afficher le nombre d'enregistrements SET FEEDBACK
Affichage de la sortie du serveur SET SERVEROUTPUT
Affichage des variables de substitution SET VERIFY
*Balise HTML HEAD SET MARKUP HTML HEAD
*Balise HTML BODY SET MARKUP HTML BODY
*Balise HTML TABLE SET MARKUP HTML TABLE
Taille de la ligne SET LINESIZE
*Mapping de caractères spéciaux avec des entités HTML SET MARKUP HTML ENTMAP
Texte Null SET NULL
Format numérique SET NUMFORMAT
Largeur des nombres SET NUMWIDTH
Sortie préformatée SET MARKUP HTML PREFORMAT
Séparateur de colonnes SET COLSEP
Affichage du séparateur d'enregistrements SET RECSEP, SET RECSEPCHAR
En-têtes sur plusieurs lignes SET HEADSEP
En-têtes soulignés SET UNDERLINE
Démarrer la sortie SET EMBEDDED
Statistiques de durée SET TIMIMG
Renvois à la ligne SET WRAP

* Les éléments précédés d'un astérisque ne sont disponibles que si l'option de configuration iSQLPlusAllowUserMarkup est paramétrée sur ALL. La valeur par défaut est NONE. Pour plus d'informations, reportez-vous à Activation des balises HTML définies par l'utilisateur.

Exécution du script

Préférence iSQL*Plus Commande SET équivalente
Taille du tableau SET ARRAYSIZE
Vérification de la syntaxe SQL SET FLAGGER
Validation des modifications SET AUTOCOMMIT
Valider lors de la copie SET COPYCOMMIT
Comparer les types de données lors de la copie SET COPYTYPECHECK
Caractère d'échappement SET ESCAPE
Adresse LOB SET LOBOFFSET
Taille des valeurs LOB, LONG et XMLType SET LONG
Plusieurs commandes SQL*Plus sur une seule ligne SET CMDSEP
Inscrire les scripts SET APPINFO
Caractère de fin SQL et PL/SQL SET BLOCKTERMINATOR
Casse SQL SET SQLCASE
Compatibilité SQL SET COMPATIBILITY
Caractère de fin SQL SET SQLTERMINATOR
Compatibilité de SQL*Plus SET SQLPLUSCOMPATIBILITY
Préfixe de la variable de substitution SET DEFINE
Caractère de fin de référence de la variable de substitution SET CONCAT
Enregistrement de la trace des instructions SET AUTOTRACE
URI de base XQuery SET XQUERY BASEURI
Tri XQuery SET XQUERY ORDERING
Identité de noeud XQUERY SET XQUERY NODE
Contexte XQUERY SET XQUERY CONTEXT

Administration de base de données

Préférence iSQL*Plus Commande SET équivalente
Source des journaux archivés SET LOGSOURCE
Récupération automatique SET AUTORECOVERY