SnowConvert AI – Oracle – SQL*Plus¶

Beschreibung¶

Liest eine Eingabezeile und speichert sie in einer bestimmten Substitutionsvariablen (Oracle SQL Plus Benutzerhandbuch und Referenz)

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

Bekannte Probleme¶

Keine bekannten Probleme.

Zugehörige EWIs¶

Keine zugehörigen EWIs.

Beschreibung¶

Fügt den angegebenen Text an das Ende der aktuellen Zeile im Puffer SQL ein. (Oracle SQL Plus Benutzerhandbuch und Referenz)

A[PPEND] text

APPEND SOME TEXT

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

Bekannte Probleme¶

Keine bekannten Probleme.

Zugehörige EWIs¶

1. [SSC-EWI-0073](../../general/technical-documentation/issues-and-troubleshooting/conversion-issues/generalEWI. md#ssc-ewi-0073): Überprüfung der Funktionsäquivalenz ausstehend.

Beschreibung¶

Der Befehl ARCHIVE LOG zeigt Informationen zum Wiederherstellen von Protokolldateien an. (Oracle SQL Plus Benutzerhandbuch und Referenz)

ARCHIVE LOG LIST

ARCHIVE LOG LIST

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

Bekannte Probleme¶

Keine bekannten Probleme.

Zugehörige EWIs¶

• [SSC-EWI-0073](../../general/technical-documentation/issues-and-troubleshooting/conversion-issues/generalEWI. md#ssc-ewi-0073): Überprüfung der Funktionsäquivalenz ausstehend.

Beschreibung¶

Der Befehl ATTRIBUTE legt die Anzeigemerkmale für ein bestimmtes Attribut einer Objekttypspalte fest. (Oracle SQL Plus Benutzerhandbuch und Referenz)

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;

Bekannte Probleme¶

1. SnowSQL kann das Format einer Spalte festlegen

Derzeit unterstützt SnowSQL weder benutzerdefinierte Typen noch verfügt es über einen Befehl zum Formatieren von Spalten. Sie können jedoch die folgende Umgehungsmöglichkeit verwenden, um Spalten in Ihrem Abfrageergebnis zu formatieren:

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');

Diese alternative Lösung muss eine zusätzliche Strategie zur Deaktivierung berücksichtigen, wenn in Oracle der Befehl ATTRIBUTE die Option OFF erhält.

Zugehörige EWIs¶

Keine zugehörigen EWIs.

Beschreibung¶

Gibt an, wo in einem Bericht Änderungen vorgenommen werden und welche Formatierungsaktion durchgeführt werden soll. (Oracle SQL Plus Benutzerhandbuch und Referenz)

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;

Bekannte Probleme¶

Keine bekannten Probleme.

Zugehörige EWIs¶

1. [SSC-EWI-0073](../../general/technical-documentation/issues-and-troubleshooting/conversion-issues/generalEWI. md#ssc-ewi-0073): Überprüfung der Funktionsäquivalenz ausstehend.

Beschreibung¶

Der Befehl BTITLE platziert und formatiert einen bestimmten Titel am unteren Rand jeder Berichtsseite oder listet die aktuelle BTITLE Definition auf. (Oracle SQL Plus Benutzerhandbuch und Referenz)

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';

Bekannte Probleme¶

1. SnowSQL unterstützt die Anzeige von benutzerdefinierten Kopf- und Fußzeilen in Abfragen nicht

Derzeit unterstützt SnowSQL die Anzeige von benutzerdefinierten Kopf- und Fußzeilen in der Abfrageausgabe nicht. Sie können jedoch den folgenden Workaround verwenden, um Kopf- und Fußzeileninformationen in Ihrer Abfrageausgabe anzuzeigen:

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');

Diese alternative Lösung muss eine zusätzliche Strategie zur Deaktivierung berücksichtigen, wenn in Oracle der Befehl BTITLE die Option OFF erhält.

Zugehörige EWIs¶

1. [SSC-EWI-0073](../../general/technical-documentation/issues-and-troubleshooting/conversion-issues/generalEWI. md#ssc-ewi-0073): Überprüfung der Funktionsäquivalenz ausstehend.

Beschreibung¶

Der Befehl CHANGE ändert das erste Vorkommen des angegebenen Textes in der aktuellen Zeile im Puffer. (Oracle SQL Plus Benutzerhandbuch und Referenz)

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/;

Bekannte Probleme¶

1. Nicht unterstützte Szenarien

Der Befehl CHANGE kann auf verschiedene Arten dargestellt werden, von denen 2 derzeit nicht vom Übersetzer unterstützt werden, diese werden im Folgenden vorgestellt:

3  WHERE col_id = 1

Wenn Sie eine Zeilennummer gefolgt von einer Zeichenfolge eingeben, wird die Zeile unabhängig von dem Text, der auf die Zeilennummer folgt, ersetzt. Dieses Szenario wird nicht unterstützt, da es nicht der Befehlsgrammatik entspricht.

CHANGE/OLD/NEW/

Geben Sie den zu ersetzenden Text gefolgt von dem Befehl ein, ohne Leerzeichen zu verwenden. Dieses Szenario wird nicht unterstützt, da es nicht der Logik der Tokenisierung durch Leerzeichen folgt.

Zugehörige EWIs¶

1. [SSC-EWI-0073](../../general/technical-documentation/issues-and-troubleshooting/conversion-issues/generalEWI. md#ssc-ewi-0073): Überprüfung der Funktionsäquivalenz ausstehend.

Beschreibung¶

Der Befehl COLUMN legt die Anzeigeattribute für eine bestimmte Spalte fest. (Oracle SQL Plus Benutzerhandbuch und Referenz)

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;

Bekannte Probleme¶

Keine bekannten Probleme.

Zugehörige EWIs¶

1. [SSC-EWI-0073](../../general/technical-documentation/issues-and-troubleshooting/conversion-issues/generalEWI. md#ssc-ewi-0073): Überprüfung der Funktionsäquivalenz ausstehend.

Beschreibung¶

Der Befehl DEFINE gibt eine benutzer- oder vordefinierte Variable an und weist ihr einen CHAR-Wert zu oder listet den Wert und den Variablentyp einer einzelnen oder aller Variablen auf. (Oracle SQL Plus Benutzerhandbuch und Referenz)

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';

Bekannte Probleme¶

1. Aktivieren der Variablensubstitution

Um SnowSQL CLI zu ermöglichen, Werte für die Variablen zu ersetzen, müssen Sie die Konfigurationsoption variable_substitution auf „true“ setzen. Dieser Vorgang kann bei der Installation, beim Starten einer Datenbankinstanz oder durch Ausführen des folgenden Befehls durchgeführt werden:

!set variable_substitution=true

Beschreibung¶

Der Befehl HOST führt einen Betriebssystembefehl aus, ohne SQL*Plus zu verlassen. (Oracle SQL Plus Benutzerhandbuch und Referenz)

HO[ST] [command]

!system <command>

HOST dir *.sql

!system dir *.sql

Bekannte Probleme¶

Keine bekannten Probleme.

Zugehörige EWIs¶

Keine zugehörigen EWIs.

Beschreibung¶

Der Befehl PROMPT sendet die angegebene Nachricht oder eine Leerzeile an den Bildschirm des Benutzers. Wenn Sie einen Text auslassen, zeigt PROMPT eine Leerzeile auf dem Bildschirm des Benutzers an. (Oracle SQL Plus Benutzerhandbuch und Referenz)

PRO[MPT] [text]

!print [text]

PROMPT

PROMPT text

PROMPT db_link_name = "&1"

!print

!print text

!print db_link_name = "&1"

Bekannte Probleme¶

Keine bekannten Probleme

Zugehörige EWIs¶

Keine zugehörigen EWIs.

Beschreibung¶

Der Befehl REMARK beginnt einen Kommentar in einem Skript. SQL*Plus interpretiert den Kommentar nicht als Befehl. (Oracle SQL Plus Benutzerhandbuch und Referenz))

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;

Bekannte Probleme¶

Keine bekannten Probleme.

Zugehörige EWIs¶

1. [SSC-EWI-0073](../../general/technical-documentation/issues-and-troubleshooting/conversion-issues/generalEWI. md#ssc-ewi-0073): Überprüfung der Funktionsäquivalenz ausstehend.

Beschreibung¶

Der Befehl SET setzt eine Systemvariable, um die Umgebungseinstellungen von SQL*Plus für Ihre aktuelle Sitzung zu ändern. (Oracle SQL Plus Benutzerhandbuch und Referenz)

SET system_variable value

!set <option>=<value>

SET wrap on

!set wrap=true

SET pagesize

!set rowset_size=0

Bekannte Probleme¶

1. Vordefinierte Variablen

Der Befehl SET funktioniert nur für Systemvariablen, die sich in der Anzahl, dem Namen oder der Domäne zwischen den beiden Sprachen unterscheiden können. Daher sollten Sie die im Befehl verwendete Variable überprüfen, um ihre korrekte Snowflake-Entsprechung zu finden. Um die Liste der Systemvariablen in Oracle anzuzeigen, verwenden Sie den Befehl SHOW ALL, während Sie in Snowflake ! options verwenden.

Zugehörige EWIs¶

Keine zugehörigen EWIs.

Beschreibung¶

Zeigt den Wert einer SQLPlus-Systemvariablen oder die aktuelle SQLPlus-Umgebung an. (Oracle SQL Plus Benutzerhandbuch und Referenz)

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

Bekannte Probleme¶

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

SnowCLI bietet keine Möglichkeit, den Wert einer bestimmten Option anzuzeigen. Sie können ! options verwenden, um den Wert der Option zu beobachten.

2. Es sind noch Untersuchungen erforderlich, um jede SQLPLUS-Option mit einem SnowflakeCLI-Äquivalent abzugleichen.

Es steht noch aus, eine Entsprechung für jede SQLPLUS-Option zu definieren.

Zugehörige EWIs¶

1. [SSC-EWI-0073](../../general/technical-documentation/issues-and-troubleshooting/conversion-issues/generalEWI. md#ssc-ewi-0073): Überprüfung der Funktionsäquivalenz ausstehend.

Beschreibung¶

Der Befehl SPOOL speichert die Abfrageergebnisse in einer Datei oder sendet die Datei optional an einen Drucker. (Oracle SQL Plus Benutzerhandbuch und Referenz)

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

Bekannte Probleme¶

Keine bekannten Probleme.

Zugehörige EWIs¶

Keine zugehörigen EWIs.

Beschreibung¶

Der Befehl START führt die SQL*Plus-Anweisungen in dem angegebenen Skript aus. Das Skript kann vom lokalen Dateisystem oder von einem Webserver aus aufgerufen werden. (Oracle SQL Plus Benutzerhandbuch und Referenz)

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

Bekannte Probleme¶

1. Argumente werden im SnowSQL CLI-Client nicht unterstützt

Oracle kann mehrere Argumente an ein Skript weitergeben und mit &1, &2 usw. aufgerufen werden, aber dies ist im SnowSQL CLI-Client nicht möglich. Sie können Argumente simulieren, indem Sie Variablen mit dem Befehl ! define deklarieren. Beachten Sie, dass diese Werte global für alle Skripte definiert sind, so dass die Verhaltensweise möglicherweise nicht gleich ist.

Diese Umgehungsmöglichkeit würde etwa so aussehen:

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

Zugehörige EWIs¶

Keine zugehörigen EWIs.

Beschreibung¶

Der Befehl WHENEVER OSERROR führt die angegebene Aktion aus (standardmäßig wird SQL*Plus beendet), wenn ein Betriebssystemfehler auftritt. (Oracle SQL Plus Benutzerhandbuch und Referenz)

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;

Bekannte Probleme¶

Keine bekannten Probleme.

Zugehörige EWIs¶

1. [SSC-EWI-0073](../../general/technical-documentation/issues-and-troubleshooting/conversion-issues/generalEWI. md#ssc-ewi-0073): Überprüfung der Funktionsäquivalenz ausstehend.

Beschreibung¶

Der Befehl WHENEVER SQLERROR führt die angegebene Aktion aus (beendet standardmäßig SQL*Plus), wenn ein SQL Befehl oder PL/SQL-Block einen Fehler erzeugt. (Oracle SQL Plus Benutzerhandbuch und Referenz)

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;

Bekannte Probleme¶

Keine bekannten Probleme.

Zugehörige EWIs¶

1. [SSC-EWI-0073](../../general/technical-documentation/issues-and-troubleshooting/conversion-issues/generalEWI. md#ssc-ewi-0073): Überprüfung der Funktionsäquivalenz ausstehend.