SnowConvert AI - Oracle - SQL*Plus¶

Description¶

Lit une ligne d’entrée et la stocke dans une variable de substitution donnée. (Référence et guide de l’utilisateur Oracle SQL Plus)

ACC[EPT] variable [NUM[BER] | CHAR | DATE | BINARY_FLOAT | BINARY_DOUBLE] [FOR[MAT] format] [DEF[AULT] default] [PROMPT text|NOPR[OMPT]] [HIDE]

ACCEPT variable_name CHAR PROMPT 'Enter the variable value >'

!print Enter the value
!system read aux && echo '!define variable_name='"$aux" > sc_aux_file.sql 
!load sc_aux_file.sql
!system rm sc_aux_file.sql

Problèmes connus¶

Aucun problème connu.

EWIs connexes¶

Pas d’EWIs connexes.

Description¶

Ajoute le texte spécifié à la fin de la ligne actuelle dans le tampon SQL. (Référence et guide de l’utilisateur Oracle SQL Plus)

A[PPEND] text

APPEND SOME TEXT

!!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 'APPEND STATEMENT' NODE ***/!!!
APPEND SOME TEXT;

Problèmes connus¶

Aucun problème connu.

EWIs connexes¶

1. SSC-EWI-0073 : En attente de l’examen de l’équivalence fonctionnelle.

Description¶

La commande ARCHIVE LOG affiche des informations sur les fichiers journaux de reprise. (Référence et guide de l’utilisateur Oracle SQL Plus)

ARCHIVE LOG LIST

ARCHIVE LOG LIST

!!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 'ARCHIVE LOG STATEMENT' NODE ***/!!!
ARCHIVE LOG LIST;

Problèmes connus¶

Aucun problème connu.

EWIs connexes¶

• SSC-EWI-0073 : En attente de l’examen de l’équivalence fonctionnelle.

Description¶

La commande ATTRIBUTE spécifie les caractéristiques d’affichage d’un attribut donné d’une colonne de type objet. (Référence et guide de l’utilisateur Oracle SQL Plus)

ATTR[IBUTE] [type_name.attribute_name [option ...]]

ATTRIBUTE Address.street_address FORMAT A10

!!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 'ATTRIBUTE STATEMENT' NODE ***/!!!
ATTRIBUTE Address.street_address FORMAT A10;

Problèmes connus¶

1. SnowSQL peut définir le format d’une colonne

Actuellement, SnowSQL ne prend pas en charge les types personnalisés et ne dispose pas non plus d’une commande permettant de formater les colonnes. Toutefois, vous pouvez utiliser la solution suivante pour formater les colonnes dans le résultat de votre requête :

SELECT SUBSTR(street_address, 1, 4) FROM person

SELECT TO_VARCHAR(1000.89, '$9,999.99')

SELECT to_varchar('03-Feb-2023'::DATE, 'yyyy.mm.dd');

Cette solution alternative doit envisager une stratégie supplémentaire à désactiver lorsque, dans Oracle, la commande ATTRIBUTE reçoit l’option OFF.

EWIs connexes¶

Pas d’EWIs connexes.

Description¶

Spécifie l’emplacement des modifications dans un rapport et l’action de formatage à effectuer. (Référence et guide de l’utilisateur Oracle SQL Plus)

BRE[AK] [ON report_element [action [action]]] ...

report_element := {column|expr|ROW|REPORT}

action := [SKI[P] n|[SKI[P]] PAGE] [NODUP[LICATES]|DUP[LICATES]]

BREAK ON customer_age SKIP 5 DUPLICATES;

!!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 'BREAK STATEMENT' NODE ***/!!!
BREAK ON customer_age SKIP 5 DUPLICATES;

Problèmes connus¶

Aucun problème connu.

EWIs connexes¶

1. SSC-EWI-0073 : En attente de l’examen de l’équivalence fonctionnelle.

Description¶

La commande BTITLE place et formate un titre spécifié au bas de chaque page du rapport, ou donne la liste de la définition actuelle de BTITLE. (Référence et guide de l’utilisateur Oracle SQL Plus)

BTI[TLE] [printspec [text | variable] ...] | [ON | OFF]

BTITLE BOLD 'This is the banner title'

!!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 'BTITLE STATEMENT' NODE ***/!!!
BTITLE BOLD 'This is the banner title';

Problèmes connus¶

1. SnowSQL ne permet pas l’affichage d’en-têtes et de pieds de page personnalisés dans les requêtes

Actuellement, SnowSQL ne prend pas en charge l’affichage d’en-têtes et de pieds de page personnalisés dans la sortie des requêtes. Toutefois, vous pouvez utiliser la solution suivante pour afficher les informations d’en-tête et de pied de page dans la sortie de votre requête :

SELECT column1,
       column2
FROM my_table;

SELECT 'This is the banner title' AS BTITLE;

--Another alternative
!print 'This is the banner title'

--To emulate BTITLE COL 5 'This is the banner title'
SELECT CONCAT(SPACE(5), 'This is the banner title');

Cette solution alternative doit envisager une stratégie supplémentaire à désactiver lorsque, dans Oracle, la commande BTITLE reçoit l’option OFF.

EWIs connexes¶

1. SSC-EWI-0073 : En attente de l’examen de l’équivalence fonctionnelle.

Description¶

La commande CHANGE modifie la première occurrence du texte spécifié sur la ligne en cours dans la mémoire tampon. (Référence et guide de l’utilisateur Oracle SQL Plus)

C[HANGE] sepchar old [sepchar [new [sepchar]]]

CHANGE /old/new/

!!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 'CHANGE STATEMENT' NODE ***/!!!
CHANGE /old/new/;

Problèmes connus¶

1. Scénarios non pris en charge

La commande CHANGE peut être présentée de différentes manières, dont 2 ne sont actuellement pas prises en charge par le traducteur :

3  WHERE col_id = 1

La saisie d’un numéro de ligne suivi d’une chaîne remplacera la ligne, quel que soit le texte qui suit le numéro de ligne. Ce scénario n’est pas pris en charge car il ne respecte pas la grammaire de la commande.

CHANGE/OLD/NEW/

Saisissez le texte à remplacer suivi de la commande sans utiliser d’espaces. Ce scénario n’est pas pris en charge car il ne suit pas la logique de tokenisation par espaces.

EWIs connexes¶

1. SSC-EWI-0073 : En attente de l’examen de l’équivalence fonctionnelle.

Description¶

La commande COLUMN spécifie les attributs d’affichage pour une colonne donnée. (Référence et guide de l’utilisateur Oracle SQL Plus)

COL[UMN] [{column | expr} [option ...]]

COLUMN column_id ALIAS col_id NOPRINT

!!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 'COLUMN STATEMENT' NODE ***/!!!
COLUMN column_id ALIAS col_id NOPRINT;

Problèmes connus¶

Aucun problème connu.

EWIs connexes¶

1. SSC-EWI-0073 : En attente de l’examen de l’équivalence fonctionnelle.

Description¶

La commande DEFINE spécifie une variable utilisateur ou prédéfinie et lui affecte une valeur CHAR, ou annonce la valeur et le type de variable d’une seule variable ou de toutes les variables. (Référence et guide de l’utilisateur Oracle SQL Plus)

DEF[INE] [variable] | [variable = text]

!define [variable] | [variable=text]

DEFINE column_id = test

DEFINE column_id = &column_reference

!define column_id = test

!define column_id = &column_reference

DEFINE column_id

!define column_id

select '&column_id';

Problèmes connus¶

1. Activation de la substitution de variables

Pour permettre à SnowSQL CLI de substituer des valeurs aux variables, vous devez donner la valeur true à l’option de configuration variable_substitution. Cette opération peut être effectuée lors de l’installation, au démarrage d’une instance de base de données ou en exécutant la commande suivante :

!set variable_substitution=true

Description¶

La commande HOST exécute une commande du système d’opérateur sans quitter SQL*Plus. (Référence et guide de l’utilisateur Oracle SQL Plus)

HO[ST] [command]

!system <command>

HOST dir *.sql

!system dir *.sql

Problèmes connus¶

Aucun problème connu.

EWIs connexes¶

Pas d’EWIs connexes.

Description¶

La commande PROMPT envoie le message spécifié ou une ligne vide à l’écran de l’utilisateur. Si vous omettez un texte, PROMPT affiche une ligne vierge sur l’écran de l’utilisateur. (Référence et guide de l’utilisateur Oracle SQL Plus)

PRO[MPT] [text]

!print [text]

PROMPT

PROMPT text

PROMPT db_link_name = "&1"

!print

!print text

!print db_link_name = "&1"

Problèmes connus¶

Aucun problème connu

EWIs connexes¶

Pas d’EWIs connexes.

Description¶

La commande REMARK permet de commencer un commentaire dans un script. SQL*Plus n’interprète pas le commentaire comme une commande. (Référence et guide de l’utilisateur Oracle SQL Plus)

REM[ARK] comment

SELECT 'hello world' FROM dual;
REMARK and now exit the session
EXIT;

select 'hello world';
-- and now exit the session
!exit

REMARK single line

REMARK first line
HOST dir *.sql

REMARK first line
SELECT 'hello world' FROM dual;

!!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 'REMARK STATEMENT' NODE ***/!!!
REMARK single line;

!!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 'REMARK STATEMENT' NODE ***/!!!
REMARK first line;

!!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 'HOST STATEMENT' NODE ***/!!!
HOST dir *.sql;

!!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 'REMARK STATEMENT' NODE ***/!!!
REMARK first line;
SELECT 'hello world' FROM dual;

Problèmes connus¶

Aucun problème connu.

EWIs connexes¶

1. SSC-EWI-0073 : En attente de l’examen de l’équivalence fonctionnelle.

Description¶

La commande SET définit une variable système pour modifier les paramètres de l’environnement de SQL*Plus pour votre session en cours. (Référence et guide de l’utilisateur Oracle SQL Plus)

SET system_variable value

!set <option>=<value>

SET wrap on

!set wrap=true

SET pagesize

!set rowset_size=0

Problèmes connus¶

1. Variables prédéfinies

La commande SET ne fonctionne que pour les variables de système, qui peuvent différer en termes de quantité, de nom ou de domaine entre les deux langues. Il convient donc d’examiner la variable utilisée dans la commande pour trouver son équivalence correcte dans Snowflake. Pour voir la liste des variables du système dans Oracle, vous pouvez utiliser la commande SHOW ALL alors que dans Snowflake, vous pouvez utiliser !options.

EWIs connexes¶

Pas d’EWIs connexes.

Description¶

Affiche la valeur d’une variable système SQLPlus ou l’environnement actuel SQLPlus. (Référence et guide de l’utilisateur Oracle SQL Plus)

SHO[W] system_variable  ALL BTI[TLE]  CON_ID  CON_NAME EDITION  ERR[ORS] [ {ANALYTIC VIEW | ATTRIBUTE DIMENSION | HIERARCHY | FUNCTION | PROCEDURE | PACKAGE | PACKAGE BODY | TRIGGER | VIEW | TYPE | TYPE BODY | DIMENSION | JAVA CLASS } [schema.]name]HISTORY  LNO  LOBPREF[ETCH]  PARAMETER[S] [parameter_name]  PDBS PNO  RECYC[LEBIN] [original_name]  REL[EASE]  REPF[OOTER]  REPH[EADER]  ROWPREF[ETCH] SGA SPOO[L]  SPPARAMETER[S] [parameter_name]  SQLCODE STATEMENTC[ACHE] TTI[TLE] USER XQUERY

CREATE OR REPLACE PROCEDURE RANCOM_PROC
AS
BEGIN
  INSERT INTO NE_TABLE SELECT 1 FROM DUAL;
END;

SHOW ERRORS

LINE/COL ERROR
-------- -----------------------------------------------------------------
4/3      PL/SQL: SQL Statement ignored
4/10     PL/SQL: ORA-00925: missing INTO keyword

CREATE OR REPLACE PROCEDURE RANCOM_PROC ()
RETURNS VARCHAR
LANGUAGE SQL
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
  BEGIN
    INSERT INTO NE_TABLE
    SELECT 1 FROM DUAL;
  END;
$$;

!!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 'SHOW STATEMENT' NODE ***/!!!

SHOW ERRORS;

001003 (42000): SQL compilation error:
syntax error line 3 at position 7 unexpected 'INT'.
syntax error line 3 at position 11 unexpected 'PUBLIC'.

show all;

appinfo is OFF and set to "SQL*Plus"
arraysize 15
autocommit OFF
autoprint OFF
autorecovery OFF
autotrace OFF
blockterminator "." (hex 2e)
btitle OFF and is the first few characters of the next SELECT statement
cmdsep OFF
colinvisible OFF
coljson OFF
colsep " "
compatibility version NATIVE
concat "." (hex 2e)
copycommit 0
COPYTYPECHECK is ON
define "&" (hex 26)
describe DEPTH 1 LINENUM OFF INDENT ON
echo OFF
editfile "afiedt.buf"
embedded OFF
errorlogging is OFF
escape OFF
escchar OFF
exitcommit ON
FEEDBACK ON for 6 or more rows SQL_ID OFF
flagger OFF
flush ON
fullcolname OFF
heading ON
headsep "|" (hex 7c)
history is OFF
instance "local"
jsonprint NORMAL
linesize 80
lno 5
loboffset 1
lobprefetch 0
logsource ""
long 80
longchunksize 80
markup HTML OFF HEAD "<style type='text/css'> body {font:10pt Arial,Helvetica,sans-serif; color:black; background:White;} p {font:10pt Arial,Helvetica,sans-serif; color:black; background:White;} table,tr,td {font:10pt Arial,Helvetica,sans-serif; color:Black; background:#f7f7e7; padding:0px 0px 0px 0px; margin:0px 0px 0px 0px;} th {font:bold 10pt Arial,Helvetica,sans-serif; color:#336699; background:#cccc99; padding:0px 0px 0px 0px;} h1 {font:16pt Arial,Helvetica,Geneva,sans-serif; color:#336699; background-color:White; border-bottom:1px solid #cccc99; margin-top:0pt; margin-bottom:0pt; padding:0px 0px 0px 0px;-
} h2 {font:bold 10pt Arial,Helvetica,Geneva,sans-serif; color:#336699; background-color:White; margin-top:4pt; margin-bottom:0pt;} a {font:9pt Arial,Helvetica,sans-serif; color:#663300; background:#ffffff; margin-top:0pt; margin-bottom:0pt; vertical-align:top;}</style><title>SQL*Plus Report</title>" BODY "" TABLE "border='1' width='90%' align='center' summary='Script output'" SPOOL OFF ENTMAP ON PREFORMAT OFF
markup CSV OFF DELIMITER , QUOTE ON
newpage 1
null ""
numformat ""
numwidth 10
pagesize 14
PAUSE is OFF
pno 1
recsep WRAP
recsepchar " " (hex 20)
release 2103000000
repfooter OFF and is NULL
repheader OFF and is NULL
rowlimit OFF
rowprefetch 1
securedcol is OFF
serveroutput OFF
shiftinout INVISIBLE
showmode OFF
spool OFF
sqlblanklines OFF
sqlcase MIXED
sqlcode 0
sqlcontinue "> "
sqlnumber ON
sqlpluscompatibility 21.0.0
sqlprefix "#" (hex 23)
sqlprompt "SQL> "
sqlterminator ";" (hex 3b)
statementcache is 0
suffix "sql"
tab ON
termout ON
timing OFF
trimout ON
trimspool OFF
ttitle OFF and is the first few characters of the next SELECT statement
underline "-" (hex 2d)
USER is "SYSTEM"
verify ON
wrap : lines will be wrapped
xmloptimizationcheck OFF

!options

Problèmes connus¶

1. It’s not possible in SnowCLI to display the value of a single option.

SnowCLI ne permet pas d’afficher la valeur d’une option spécifique. Vous pouvez utiliser !options pour surveiller la valeur de l’option.

2. Des recherches sont en attente pour faire correspondre chaque option de SQLPLUS à un équivalent de SnowflakeCLI.

La définition d’une équivalence pour chaque option de SQLPLUS reste en attente.

EWIs connexes¶

1. SSC-EWI-0073 : En attente de l’examen de l’équivalence fonctionnelle.

Description¶

La commande SPOOL stocke les résultats de la requête dans un fichier ou, en option, envoie le fichier à une imprimante. (Référence et guide de l’utilisateur Oracle SQL Plus)

SPO[OL] [file_name[.ext] [CRE[ATE] | REP[LACE] | APP[END]] | OFF | OUT]

!spool [<file_name>] | [off]

SPOOL temp
SPOOL temp.txt

!spool temp
!spool temp.txt

SPOOL temp.txt CREATE
SPOOL temp.txt APPEND
SPOOL temp.txt REPLACE

!spool temp.txt
!spool temp.txt

!system del temp.txt
!spool temp.txt

SPOOL OFF
SPOOL OUT

!spool off
!spool off

Problèmes connus¶

Aucun problème connu.

EWIs connexes¶

Pas d’EWIs connexes.

Description¶

La commande START exécute les instructions SQL*Plus dans le script spécifié. Le script peut être appelé à partir du système de fichiers local ou d’un serveur web. (Référence et guide de l’utilisateur Oracle SQL Plus)

STA[RT] {url | file_name[.ext] } [arg...]

!(load | source) {url | file_name[.ext] }

START C:\Users\My_User\Desktop\My\Path\insert_script.sql

!load C:\Users\My_User\Desktop\My\Path\insert_script.sql

START C:\Users\My_User\Desktop\My\Path\insert_script.sql 123 456 789

!load C:\Users\My_User\Desktop\My\Path\insert_script.sql

Problèmes connus¶

1. Les arguments ne sont pas pris en charge par le client SnowSQL CLI

Oracle peut transmettre plusieurs arguments à un script et être accessible avec &1, &2, et ainsi de suite, mais cela n’est pas possible dans le client SnowSQL CLI. Vous pouvez simuler des arguments en déclarant des variables à l’aide de la commande !define. Gardez à l’esprit que ces valeurs sont définies globalement pour tous les scripts, de sorte que le comportement peut ne pas être équivalent.

Cette solution de contournement ressemblerait à quelque chose comme ceci :

!set variable_substitution=true
!define 1=123
!define 2=456
!define 3=789
!load C:\Users\My_User\Desktop\My\Path\insert_script.sql

EWIs connexes¶

Pas d’EWIs connexes.

Description¶

La commande WHENEVER OSERROR effectue l’action spécifiée (quitte SQL*Plus par défaut) en cas d’erreur du système d’exploitation. (Référence et guide de l’utilisateur Oracle SQL Plus)

WHENEVER OSERROR {EXIT [SUCCESS | FAILURE | n | variable | :BindVariable]  [COMMIT | ROLLBACK] | CONTINUE [COMMIT | ROLLBACK | NONE]}

WHENEVER OSERROR EXIT

!!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 'WHENEVER ERROR STATEMENT' NODE ***/!!!
WHENEVER OSERROR EXIT;

Problèmes connus¶

Aucun problème connu.

EWIs connexes¶

1. SSC-EWI-0073 : En attente de l’examen de l’équivalence fonctionnelle.

Description¶

La commande WHENEVER SQLERROR exécute l’action spécifiée (quitte SQL*Plus par défaut) si une commande SQL ou un bloc PL/SQL génère une erreur. (Référence et guide de l’utilisateur Oracle SQL Plus)

WHENEVER SQLERROR {EXIT [SUCCESS | FAILURE | WARNING | n | variable  | :BindVariable] [COMMIT | ROLLBACK] | CONTINUE [COMMIT | ROLLBACK | NONE]}

WHENEVER SQLERROR EXIT

!!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 'WHENEVER ERROR STATEMENT' NODE ***/!!!
WHENEVER SQLERROR EXIT;

Problèmes connus¶

Aucun problème connu.

EWIs connexes¶

1. SSC-EWI-0073 : En attente de l’examen de l’équivalence fonctionnelle.