Executando o Código SQL, PL/SQL e JavaScript no Editor de Planilhas

Você pode executar instruções SQL, scripts PL/SQL e código JavaScript no editor de Planilha SQL. Alguns recursos importantes do editor são a conclusão do código em contexto, o destaque da sintaxe e a depuração de erros.

Observação

Os modos de editor PL/SQL e JavaScript não estão disponíveis para serviços de banco de dados MySQL.

Você pode inserir instruções SQL ou blocos de código PL/SQL para especificar ações como criar uma tabela, inserir dados, selecionar dados ou excluir dados de uma tabela. As palavras-chave SQL são realçadas automaticamente. Para várias instruções, você deve encerrar o seguinte:

  • Cada instrução que não seja PL/SQL com ponto e vírgula (;) ou uma barra (/) em uma nova linha
  • Cada instrução PL/SQL com barra (/) em uma nova linha

Para obter instruções SQL*Plus e SQLcl suportadas na planilha, consulte Comandos SQL*Plus e SQLcl Suportados na Planilha SQL.

O modo de editor PL/SQL é acionado na planilha ao abrir os seguintes tipos de objeto: Funções, Procedimentos, Pacotes e Tipos. Esse editor ajuda a detectar erros no código PL/SQL durante a compilação. A saída inclui detalhes do erro, como a linha e a coluna específicas em que o erro é detectado, juntamente com um link para ir para a posição relevante no bloco de código.

O modo de planilha JavaScript suporta o recurso do Multilingual Engine introduzido no Oracle Database release 21c. Para obter mais informações, consulte Suporte ao Multilingual Engine.

Assistência ao Code Editor

Se você pressionar Ctrl+Space, o editor fornecerá uma lista de possíveis conclusões no ponto de inserção que você pode usar para completar automaticamente o código que está editando. Essa lista é baseada no contexto do código no ponto de inserção.

Esta imagem mostra uma lista de possíveis conclusões que podem ser usadas para completar automaticamente o código.

O editor também oferece uma lista abrangente de comandos disponíveis por meio da Paleta de Comandos. Para abrir a Paleta de Comandos, pressione Ctrl+Shift+P. Para obter uma lista de teclas de atalho de teclado, consulte Keyboard Shortcuts.

Um erro no código é significado por um ponto vermelho na calha esquerda e uma linha de squiggle abaixo do texto específico. Quando você passa o mouse sobre ele, aparece um pop-up exibindo possíveis correções para resolver o erro.

Esta imagem mostra como um erro no código é identificado junto com uma lista de sugestões sobre como resolver o erro.

Arrastar e Soltar Objetos para Gerar Automaticamente Instruções SQL

Observação

Este recurso não está disponível para serviços de banco de dados MySQL.

Você pode arrastar objetos do painel esquerdo e soltá-los no editor de planilha no painel direito.

  • Se você arrastar e soltar uma tabela ou view, será solicitado a selecionar uma das seguintes instruções SQL: Inserir, Atualizar, Selecionar ou Excluir.

    Por exemplo, se você escolher Selecionar, uma instrução Select será construída com todas as colunas na tabela ou view. É possível editar a instrução, por exemplo, modificar a lista de colunas ou adicionar uma cláusula WHERE.

    Esta imagem mostra o código SQL gerado para um objeto no editor de planilha quando a instrução SELECT é selecionada.

    Se você escolher Nome do Objeto, o nome do objeto prefixado pelo nome do esquema será adicionado à planilha.

  • Se você arrastar e soltar uma função ou procedimento, poderá optar por inserir o nome ou o código PL/SQL da função ou procedimento na planilha. Se você selecionar o código PL/SQL, poderá inserir os parâmetros antes de inserir o código na planilha.

Definir Preferências do Editor

Você pode definir as preferências do editor de código usando a opção Preferências disponível na barra lateral esquerda. Algumas das opções do editor de código que você pode personalizar são Tema (Luz, Escuro e Alto contraste escuro), Tamanho da fonte e família, Tamanho da guia, Quebra de palavra, Régua, Números de linha etc.

Ícones da Barra de Ferramentas

A barra de ferramentas do editor de Planilha SQL contém ícones para as seguintes operações:

  • Lista drop-down Planilha

    • Abrir: Abra um arquivo do browser, dispositivo ou armazenamento de objetos.
    • Abrir Recente: Exibe os arquivos acessados recentemente. Se houver mais de cinco arquivos na lista recente, um link Mais será exibido para exibir os arquivos adicionais.
    • Salvar Como: Salve um arquivo no browser, no dispositivo ou no armazenamento de objetos.
  • Novo Arquivo
    • Selecione Planilha: Crie uma planilha.
    • Selecione PL/SQL: Crie um tipo de objeto PL/SQL. O editor alterna para um modo PL/SQL.
  • Abrir: Abra um arquivo do seu browser, dispositivo ou armazenamento de objetos. Para abrir um arquivo de seu dispositivo, no controle deslizante Abrir Arquivo, clique em Abrir Arquivo e navegue para selecionar o arquivo ou arraste e solte o arquivo no controle deslizante.
  • Executar Instrução: Execute as instruções selecionadas ou a instrução no ponteiro do mouse no editor da planilha. As instruções SQL podem incluir variáveis de bind e variáveis de substituição do tipo VARCHAR2. Uma caixa de diálogo é exibida para inserir valores de variáveis.

  • Executar Script: Execute todas as instruções no editor de planilha usando o Executor de Script. As instruções SQL podem incluir variáveis de bind (mas não variáveis de substituição) do tipo VARCHAR2. Uma caixa de diálogo é exibida para inserir valores de variáveis de vínculo.

  • Compilar (para a barra de ferramentas PL/SQL): Executar uma compilação PL/SQL do subprograma.

    Observação

    O ícone Compilar não está disponível para serviços de banco de dados MySQL.
  • Plano de Execução: Gere o plano de execução para a instrução. A saída é exibida na guia Plano de Explicação do painel de saída. Consulte Usando o Diagrama do Plano de Explicação

    Observação

    O ícone Plano de Explicação não está disponível para serviços de banco de dados MySQL.
  • Rastreamento Automático: Execute a instrução e mostre as estatísticas de execução da instrução SQL e o plano de execução real. A saída é exibida na guia Autotrace no painel de saída.

    Observação

    O ícone de Corrida Automática não está disponível para serviços de banco de dados MySQL.
  • Fazer Download do Conteúdo do Editor: Faça download do conteúdo da planilha como um arquivo SQL para o sistema local.

  • Formatar: Formate a instrução SQL no editor, como capitalizar os nomes das instruções, cláusulas, palavras-chave e adicionar quebras de linha e recuo.

  • Limpar: Remova as instruções do editor.

  • Abrir em Tela Inteira: Abra o editor no modo de tela inteira.

  • Carga de Dados: Abra o assistente de Carga de Dados. Consulte Carregamento de Dados.

    Observação

    O ícone Carga de Dados não está disponível para serviços de banco de dados MySQL.