SnowConvert AI - Oracle - SQL*Plus¶

Descrição¶

Lê uma linha de entrada e a armazena em uma determinada variável de substituição. (Guia do usuário e referência do 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

Problemas conhecidos¶

Nenhum problema conhecido.

EWIs relacionados¶

Sem EWIs relacionados.

Descrição¶

Adiciona o texto especificado ao final da linha atual no buffer SQL. (Guia do Usuário e Referência do 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;

Problemas conhecidos¶

Nenhum problema conhecido.

EWIs relacionados¶

1. SSC-EWI-0073: Revisão de equivalência funcional pendente.

Descrição¶

O comando ARCHIVE LOG exibe informações sobre arquivos de registro de refazer. (Guia do usuário e referência do 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;

Problemas conhecidos¶

Nenhum problema conhecido.

EWIs relacionados¶

• SSC-EWI-0073: Revisão de equivalência funcional pendente.

Descrição¶

O comando ATTRIBUTE especifica as características de exibição de um determinado atributo de uma coluna Object Type. (Guia do usuário e referência do 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;

Problemas conhecidos¶

1. O SnowSQL pode definir o formato de uma coluna

Atualmente, o SnowSQL não oferece suporte a tipos personalizados nem tem um comando para formatar colunas. No entanto, você pode usar a seguinte solução alternativa para formatar colunas no resultado da consulta:

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

Essa solução alternativa deve considerar uma estratégia adicional para desativar quando, no Oracle, o comando ATTRIBUTE receber a opção OFF.

EWIs relacionados¶

Sem EWIs relacionados.

Descrição¶

Especifica onde as alterações ocorrem em um relatório e a ação de formatação a ser executada. (Guia do Usuário e Referência do 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;

Problemas conhecidos¶

Nenhum problema conhecido.

EWIs relacionados¶

1. SSC-EWI-0073: Revisão de equivalência funcional pendente.

Descrição¶

O comando BTITLE coloca e formata um título especificado na parte inferior de cada página do relatório ou lista a definição atual de BTITLE. (Guia do Usuário e Referência do 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';

Problemas conhecidos¶

1. O SnowSQL não é compatível com a exibição de cabeçalhos e rodapés personalizados na consulta

Atualmente, o SnowSQL não oferece suporte à exibição de cabeçalhos e rodapés personalizados na saída da consulta. No entanto, você pode usar a seguinte solução alternativa para exibir informações de cabeçalho e rodapé na saída da consulta:

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

Essa solução alternativa deve considerar uma estratégia adicional para desativar quando, no Oracle, o comando BTITLE receber a opção OFF.

EWIs relacionados¶

1. SSC-EWI-0073: Revisão de equivalência funcional pendente.

Descrição¶

O comando CHANGE altera a primeira ocorrência do texto especificado na linha atual do buffer. (Guia do usuário e referência do 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/;

Problemas conhecidos¶

1. Cenários sem suporte

O comando CHANGE pode ser apresentado de várias maneiras, sendo que duas delas não são compatíveis com o conversor no momento, e são apresentadas a seguir:

3  WHERE col_id = 1

A inserção de um número de linha seguido de uma cadeia de caracteres substituirá a linha independentemente do texto que segue o número da linha. Esse cenário não é compatível, pois não segue a gramática do comando.

CHANGE/OLD/NEW/

Digite o texto a ser substituído seguido pelo comando sem usar espaços. Esse cenário não é compatível, pois não segue a lógica da tokenização por espaços.

EWIs relacionados¶

1. SSC-EWI-0073: Revisão de equivalência funcional pendente.

Descrição¶

O comando COLUMN especifica os atributos de exibição de uma determinada coluna. (Guia do usuário e referência do 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;

Problemas conhecidos¶

Nenhum problema conhecido.

EWIs relacionados¶

1. SSC-EWI-0073: Revisão de equivalência funcional pendente.

Descrição¶

O comando DEFINE especifica uma variável de usuário ou predefinida e atribui a ela um valor CHAR ou lista o valor e o tipo de variável de uma única variável ou de todas as variáveis. (Guia do Usuário e Referência do 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';

Problemas conhecidos¶

1. Habilitação da substituição de variáveis

Para permitir que o SnowSQL CLI substitua os valores das variáveis, você deve definir a opção de configuração variable_substitution como true. Esse processo pode ser feito na instalação, ao iniciar uma instância de banco de dados ou executando o seguinte comando:

!set variable_substitution=true

Descrição¶

O comando HOST executa um comando do sistema operacional sem sair do SQL*Plus. (Guia do usuário e referência do Oracle SQL Plus)

HO[ST] [command]

!system <command>

HOST dir *.sql

!system dir *.sql

Problemas conhecidos¶

Nenhum problema conhecido.

EWIs relacionados¶

Sem EWIs relacionados.

Descrição¶

O comando PROMPT envia a mensagem especificada ou uma linha em branco para a tela do usuário. Se o usuário omitir um texto, PROMPT exibirá uma linha em branco na tela do usuário. (Guia do usuário e referência do Oracle SQL Plus)

PRO[MPT] [text]

!print [text]

PROMPT

PROMPT text

PROMPT db_link_name = "&1"

!print

!print text

!print db_link_name = "&1"

Problemas conhecidos¶

Nenhum problema conhecido

EWIs relacionados¶

Sem EWIs relacionados.

Descrição¶

O comando REMARK inicia um comentário em um script. O SQL*Plus não interpreta o comentário como um comando. (Guia do usuário e referência do 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;

Problemas conhecidos¶

Nenhum problema conhecido.

EWIs relacionados¶

1. SSC-EWI-0073: Revisão de equivalência funcional pendente.

Descrição¶

O comando SET define uma variável de sistema para alterar as configurações de ambiente do SQL*Plus para sua sessão atual. (Guia do usuário e referência do Oracle SQL Plus)

SET system_variable value

!set <option>=<value>

SET wrap on

!set wrap=true

SET pagesize

!set rowset_size=0

Problemas conhecidos¶

1. Variáveis predefinidas

O comando SET funciona apenas para variáveis do sistema, que podem diferir em quantidade, nome ou domínio entre as duas linguagens, portanto, é necessário analisar a variável que está sendo usada no comando para encontrar sua equivalência correta no Snowflake. Para ver a lista de variáveis do sistema no Oracle, você pode usar o comando SHOW ALL, enquanto no Snowflake pode usar !options.

EWIs relacionados¶

Sem EWIs relacionados.

Descrição¶

Mostra o valor de uma variável de sistema SQLPlus ou o ambiente SQLPlus atual. (Guia do usuário e referência do 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

Problemas conhecidos¶

1. Não é possível no SnowCLI exibir o valor de uma única opção.

O SnowCLI não oferece uma maneira de exibir o valor de uma opção específica. Você pode usar !options para observar o valor da opção.

2. A pesquisa está pendente para fazer a correspondência entre cada opção do SQLPLUS e um equivalente no SnowflakeCLI.

Está pendente a definição de um equivalente para cada opção do SQLPLUS.

EWIs relacionados¶

1. SSC-EWI-0073: Revisão de equivalência funcional pendente.

Descrição¶

O comando SPOOL armazena os resultados da consulta em um arquivo ou, opcionalmente, envia o arquivo para uma impressora. (Guia do usuário e referência do 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

Problemas conhecidos¶

Nenhum problema conhecido.

EWIs relacionados¶

Sem EWIs relacionados.

Descrição¶

O comando START executa as instruções SQL*Plus no script especificado. O script pode ser chamado a partir do sistema de arquivos local ou de um servidor da Web. (Guia do usuário e referência do 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

Problemas conhecidos¶

1. Os argumentos não são compatíveis com o cliente SnowSQL CLI

O Oracle pode passar vários argumentos para um script e pode ser acessado com &1, &2 e assim por diante, mas isso não pode ser feito no Cliente SnowSQL CLI. Você pode simular argumentos declarando variáveis com o comando !define. Lembre-se de que esses valores são definidos globalmente para todos os scripts, portanto, o comportamento pode não ser equivalente.

Essa solução alternativa seria mais ou menos assim:

!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 relacionados¶

Sem EWIs relacionados.

Descrição¶

O comando WHENEVER OSERROR executa a ação especificada (encerra o SQL*Plus por padrão) se ocorrer um erro no sistema operacional. (Guia do usuário e referência do 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;

Problemas conhecidos¶

Nenhum problema conhecido.

EWIs relacionados¶

1. SSC-EWI-0073: Revisão de equivalência funcional pendente.

Descrição¶

O comando WHENEVER SQLERROR executa a ação especificada (sai do SQL*Plus por padrão) se um comando SQL ou um bloco PL/SQL gerar um erro. (Guia do usuário e referência do 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;

Problemas conhecidos¶

Nenhum problema conhecido.

EWIs relacionados¶

1. SSC-EWI-0073: Revisão de equivalência funcional pendente.