Introdução ao Oracle SQL Developer no Windows

Introdução

O Oracle SQL Developer é uma poderosa ferramenta de desenvolvimento com muitos recursos para interagir com bancos de dados Oracle. Além de escrever e enviar instruções SQL usando o SQL Worksheet, o SQL Developer possui ferramentas poderosas para gerenciar bancos de dados, projetar e fazer engenharia reversa de bancos de dados usando modelos de dados e executar trabalhos de mineração de dados. A versão mais recente (versão 19.4 em 20 de dezembro de 2019) inclui algumas ferramentas básicas de administração de banco de dados, suporte para consultas REST e análise de documentos JSON também.

Se você estiver trabalhando no MacOSX, as instruções sobre como instalar e trabalhar com o SQL Developer no MacOSX podem ser encontradas aqui.

A próxima seção deste tutorial abrange o download e a instalação do SQL Developer. Se você já tiver o SQL Developer baixado e instalado, talvez queira pular para a próxima página para saber como criar uma nova conexão de banco de dados.

No final deste tutorial, há algumas páginas que abordam como escrever, executar e salvar instruções SQL, como exportar dados usando o SQL Developer e como importar dados para o Oracle usando o SQL Developer. Você também pode estar interessado em usar o SQL Developer para fazer engenharia reversa de um esquema Oracle. Esse tutorial está linkado aqui.

Baixando e instalando o SQL Developer

O SQL Developer pode ser baixado gratuitamente da rede do Oracle Developer. O SQL Developer requer um Java Development Kit para ser executado. Por exemplo, o SQL Developer versão 4.1.3 e posterior requer o JDK 1.8.

Visite o seguinte link para baixar os arquivos do SQL Developer:

http://www.oracle.com/technetwork/developer-tools/sql-developer/downloads/index.html

Selecione a versão que corresponde ao seu sistema operacional (e ou que inclua o JDK, se necessário). O restante deste tutorial foi concluído usando a versão do Windows.

O download do SQL Developer é um único arquivo .zip, por exemplo:sqldeveloper-4.1.3.20.78-no-jre.zip (ou uma versão mais recente, como sqldeveloper-17.4.0.355.2349-x64.zip)

Descompacte o arquivo zip do SQL Developer em uma unidade apropriada. O resultado deve ser uma pasta sqldeveloper simples.

Clique duas vezes no executável sqldeveloper.exe. Uma caixa de diálogo pode aparecer solicitando a especificação do caminho para o diretório inicial do Java Development Kit (JDK).

Clique no botão Procurar e navegue até a pasta inicial do JDK.

Clique em Selecionar pasta e o caminho para o JDK aparecerá na caixa de diálogo:

Clique no botão OK e o SQL Developer será iniciado

Quando o SQL Developer estiver em execução, você verá a seguinte tela:

Configurando uma nova conexão de banco de dados

A primeira ordem do dia é criar uma nova conexão com seu banco de dados Oracle. Para configurar uma nova conexão, você precisará saber:

O nome (ou endereço IP) do servidor que está executando o Oracle. Se você instalou o Oracle em seu computador local, é provável que você possa usar o “localhost” (ou 127.0.01).
O número da porta TCP/IP em que o processo do Oracle Listener está sendo executado. O padrão para Oracle é usar a porta 1521. A menos que você tenha configurado isso de forma diferente, use 1521.
O Identificador do Sistema Oracle (SID) ou Nome do Serviço que identifica a instância específica do Oracle no servidor.

Algumas combinações comuns podem ser:

Oracle 11g ou 12c Enterprise Edition instalado no mesmo servidor (local) ou PC:Host:localhost, Porta:1521, SID:orcl
Oracle 11g Express Edition instalado no mesmo servidor (local) ou PC:Host:localhost, Porta:1521, SID:xe
Oracle 11g ou 12c Enterprise Edition instalado no servidor remoto:Host:myhostname.domain.com, Porta:1521, SID:orcl
Oracle 12c Enterprise Edition instalado no servidor remoto usando banco de dados multilocatário:Host:myhostname.domain.com, Porta:1521, Nome do serviço:pdb1
Oracle Autonomous Data Warehouse ou banco de dados Autonomous Transaction Processing executando Oracle Cloud:Altere o Tipo de Conexão para Carteira na Nuvem e, em seguida, selecione o arquivo .zip da carteira baixado da instância do banco de dados na nuvem. Siga estas instruções (Página 6).

Observe que, se seu DBMS de destino for um Autonomous Database no Oracle Cloud, você precisará seguir instruções ligeiramente diferentes que fazem uso do Oracle Cloud Wallet. Siga estas instruções (Página 6) para configurar uma conexão com um banco de dados autônomo.

Para começar a configurar a nova conexão, clique na seta para baixo ao lado do sinal + verde e selecione Nova conexão…

A janela padrão “Nova/Selecionar conexão de banco de dados” será exibida.

Dê um novo nome para sua conexão e preencha o nome de usuário e a senha da conta do banco de dados Oracle à qual você deseja se conectar.

Preencha o Hostname com o nome do host da Internet ou o endereço IP do servidor em que o banco de dados Oracle está sendo executado. Defina a porta para corresponder onde o Oracle Listener está sendo executado (1521 é o padrão típico).

Se o host tiver um Oracle System Identifier (SID) definido, digite-o. Caso contrário, se o servidor Oracle estiver usando multi-tenant (via oracle 12c ou mais recente), selecione Service Name e forneça o nome do serviço para a instância do banco de dados.

Outras configurações avançadas de autenticação, criptografia e segurança podem ser específicas, se necessário.

Abaixo está um exemplo de conexão a uma instância Oracle 12c no servidor local usando a conta do sistema Oracle. A senha para esta conta foi configurada durante a instalação do banco de dados.

Teste a conexão clicando no botão de teste. Observe o Status no canto inferior esquerdo para ver se há alguma mensagem de erro. A imagem abaixo mostra o “sucesso”:

Erros típicos de login e itens a serem verificados

Há vários motivos pelos quais o SQL Developer pode não fazer uma conexão bem-sucedida com o Oracle Server. Alguns dos problemas e soluções potenciais mais comuns estão listados abaixo. Tenha em mente a arquitetura Oracle “Cliente/Servidor” e o fato de que existe uma rede entre eles.

Status :Failure -Test failed:IO Error:O adaptador de rede não pôde estabelecer a conexão

Há um problema de conexão pela rede entre o cliente SQL Developer e o servidor de banco de dados Oracle. O nome do host (ou endereço IP) ou o número da porta está incorreto. Ou algum outro problema de rede (DNS, Firewall, etc.) está impedindo o SQL Developer de se conectar ao servidor Oracle. Também é possível que o Oracle Listener (o serviço de rede que aceita conexões de entrada) não esteja em execução ou esteja escutando uma porta de rede diferente. Tente usar o traceroute (tracert no Windows) para ver se o servidor pode ser alcançado. Verifique se o Oracle Database está funcionando junto com o serviço Oracle Listener e se nenhum firewall está bloqueando as conexões com a porta 1521.

Status:Failure -Test failed:Listener recusou a conexão com o seguinte erro:
ORA-12505, TNS:listener atualmente não sabe do SID fornecido no descritor de conexão

O SQL Developer está se conectando com sucesso ao processo Listener do servidor Oracle, porém o SID fornecido não corresponde ao que está configurado no servidor de banco de dados.

Status :Failure -Test failed:Listener recusou a conexão com o seguinte erro:
ORA-12514, TNS:listener atualmente não sabe do serviço solicitado no descritor de conexão

O SQL Developer está se conectando com sucesso ao servidor Oracle, porém o Nome do Serviço fornecido não corresponde ao que está configurado no servidor de banco de dados.

Status:Falha -Falha no teste:ORA-01017:nome de usuário/senha inválidos; logon negado

O SQL Developer está se conectando com sucesso ao servidor Oracle e à instância (portanto, o nome do host, a porta e o SID ou o nome do serviço estão corretos). No entanto, o nome de usuário e/ou senha não coincidem.

Status:Falha -Teste falhou:ORA-28000:a conta está bloqueada

O SQL Developer está se conectando com sucesso ao servidor Oracle e à instância (portanto, o nome do host, a porta e o SID ou o nome do serviço estão corretos). No entanto, a conta Oracle foi bloqueada (por exemplo, muitas tentativas de login com falha ou a senha expirou).

ORA-12518:TNS:listener não pôde entregar a conexão do cliente

O SQL Developer está se conectando com sucesso ao servidor Oracle e à instância (portanto, o nome do host, a porta e o SID ou o nome do serviço estão corretos). No entanto, o ouvinte por sua vez não pode fazer uma conexão com o banco de dados Oracle. Isso pode acontecer se o banco de dados não estiver em execução ou aberto, ou se o servidor que executa o Oracle estiver sem RAM. Isso também pode acontecer se houver um problema de permissões de usuário entre o processo do ouvinte e os processos do banco de dados.

Salvando a conexão do desenvolvedor SQL

Se o teste for bem-sucedido, clique no botão Salvar para salvar esta conexão.

Conectando-se ao banco de dados Oracle

Finalmente, agora que a conexão foi testada e salva, clique no botão Conectar para conectar-se ao servidor de banco de dados.

As quatro áreas principais da tela agora incluem:

Janela de conexão, janela Reports Navigator, planilha SQL e janela de saída de script. Você pode não ver a janela Script Output até executar uma instrução SQL na planilha SQL. Se por algum motivo a planilha SQL não for visitável, abra as Ferramentas menu e selecione a Planilha SQL item do menu.

Quaisquer instruções SQL podem ser digitadas diretamente na planilha SQL ou coladas de outro documento, página da web, e-mail etc.

A planilha SQL recebe um nome de arquivo padrão, como orcl_localhost.sql

Este arquivo pode ser salvo em qualquer pasta local do PC. Salvar esse arquivo é uma ótima maneira de acompanhar o histórico de instruções SQL à medida que você as grava e reescreve.

Para abrir um arquivo de script SQL existente, abra o menu Arquivo e selecione Abrir. Navegue até a pasta com o arquivo de script SQL, destaque-o e clique no botão Abrir.

Exportação de dados Oracle com SQL Developer

O SQL Developer possui um recurso que facilita muito a exportação de dados de uma tabela ou exibição Oracle. Há muitas maneiras diferentes de exportar dados do Oracle, dependendo dos recursos do banco de dados de destino ou das ferramentas de dados. Alguns exemplos comuns de exportação de dados incluem:

Arquivo de instruções SQL Data Definition Language e SQL INSERT usado para recriar a tabela com dados em outro banco de dados.
Arquivo e scripts do Oracle SQL Loader que podem ser usados para importar os dados para outro banco de dados ou esquema Oracle.
Arquivo de valores separados por vírgula (.csv) que pode ser importado por várias ferramentas de software, bancos de dados etc.
Arquivo do Microsoft Excel
Arquivo eXtensible Markup Language (XML) que pode ser importado para diferentes ferramentas de software
Arquivo HTML (HyperText Markup Language) que pode ser exibido em uma página da Web
Arquivo de texto simples com espaçamento fixo ou usando algum outro delimitador que pode ser importado por muitas ferramentas de software e bancos de dados diferentes.

Este exemplo pressupõe que você tenha pelo menos uma tabela ou exibição com dados em seu esquema (conexão) que podem ser exportados. Se você não tiver nada em seu esquema, crie uma tabela básica e adicione alguns dados usando as instruções SQL abaixo:

-- Create a simple Employee table
CREATE TABLE employee
(  employee_id  INTEGER NOT NULL, 
   first_name VARCHAR2(35), 
   last_name VARCHAR2(65), 
   salary NUMBER(12,2), 
   department_number INTEGER
);

-- Add three new records to the employee table
INSERT INTO employee VALUES (101, 'Joe', 'Smith', 47000.00, 1);
INSERT INTO employee VALUES (102, 'Alice', 'Jones, 49000.00, 2);
INSERT INTO employee VALUES (103, 'Greg', 'Brown', 42500.00, 1, 2);

Para começar, abra a árvore de navegação na área Conexões à esquerda da tela do SQL Developer. Sob o nome da conexão, serão listadas as Tabelas, Visualizações, Visualizações de Edição, Índices, etc. Abra as Tabelas e Visualizações categorias também.

Para este exemplo, a tabela EMPLOYEE será exportada.

Clique com o botão direito do mouse na tabela EMPLOYEE e selecione o item de menu Export… conforme mostrado abaixo.

Isso abrirá um pequeno Assistente de exportação.

As configurações padrão para exportar uma tabela Oracle

Há muitas maneiras diferentes de exportar dados do Oracle, dependendo dos recursos do banco de dados de destino ou das ferramentas de dados. Para este exemplo, a tabela EMPLOYEE será exportada para uma planilha do Microsoft Excel.

Ao exportar para um arquivo CSV ou planilha, não é necessário incluir a Data Definition Language (DDL) que especifica a estrutura da tabela ou visualização. Portanto, para este exemplo, remova a caixa de seleção ao lado de Exportar DDL .

Em Exportar dados seção, altere o Formato: para excel 2003+ ( xlsx )

Essa configuração de formato usará o formato de arquivo mais recente do Excel que pode acomodar até um milhão de linhas. Para compatibilidade com versões anteriores do Excel, você pode selecionar Excel '95 – 2003 (xls) como o Formato.

Dê um nome à nova planilha na caixa de texto ao lado de Nome da planilha de dados: incitar.

Se você quiser incluir o texto da instrução SQL usada para extrair os dados do Oracle, marque a caixa ao lado de Query Worksheet Name e dê um novo nome para a planilha do Excel onde a sintaxe SQL aparecerá (para este exemplo, optamos por não incluir o código SQL).

A última seção especifica como os dados devem ser armazenados em um arquivo ou conjunto de arquivos. Para este exemplo, os dados serão exportados para um único arquivo. O nome do arquivo é fornecido na caixa de texto ao lado de Arquivo: incitar. Use o botão Procurar… para localizar uma pasta (diretório) que tenha espaço livre em disco suficiente. Em seguida, adicione o nome do arquivo ao caminho.

Depois que tudo estiver configurado (como mostrado abaixo), clique no botão Avançar>.

A próxima tela oferece duas oportunidades para filtrar as colunas e/ou as linhas nos dados a serem exportados.

Por padrão, todas as colunas e todas as linhas serão exportadas. Para selecionar colunas específicas, clique no espaço ao lado da tabela em Colunas cabeçalho. Em seguida, clique no ícone de lápis para editar. Uma nova janela aparecerá com marcas de seleção ao lado das colunas que devem ser incluídas na exportação de dados. Para este exemplo, todas as colunas serão exportadas.

Clique em OK para fechar a janela Colunas de Dados.

Para filtrar as linhas a serem exportadas, uma cláusula WHERE pode ser adicionada. Clique no espaço sob o título Objeto Onde e, em seguida, clique no ícone Lápis para abrir o editor Onde.

Adicione quaisquer condições onde (como número_departamento =1) necessárias. Para este exemplo, nenhuma condição Where foi adicionada, pois gostaríamos que todos os dados fossem exportados. Clique no botão OK para fechar a janela Data Where quando terminar.

Clique no botão Avançar> para acessar a tela Resumo de exportação. Nesta tela, é especificado um resumo de todas as opções de exportação.

Se alguma das opções não estiver configurada corretamente, use o botão
Se todas as opções de exportação estiverem corretas, clique no botão Concluir para iniciar o trabalho de exportação.

Se você receber algum erro, certifique-se de ter especificado uma pasta de destino que realmente existe (não copie cegamente o que tenho neste tutorial). Verifique também se o arquivo de destino ainda não está aberto pelo Excel, por exemplo.

Use o Windows Explorer para navegar até a pasta para ver o novo arquivo exportado. Por exemplo:

Abra o arquivo Excel para visualizar o conteúdo:

Antes de exportar os dados novamente, certifique-se de fechar o arquivo Excel.

Importando dados com o SQL Developer

O SQL Developer possui um recurso que facilita muito a importação de dados de uma ampla variedade de fontes de dados para o Oracle. Existem muitas maneiras diferentes de importar dados para o Oracle, dependendo da origem dos dados. Alguns formatos de dados comuns que o SQL Developer pode importar incluem:

Arquivo de instruções SQL Data Definition Language e SQL INSERT usado para recriar a tabela com dados no Oracle.
Arquivo e scripts do Oracle SQL Loader que podem ser usados para importar os dados para o Oracle.
Arquivo de valores separados por vírgula (.csv)
Arquivo do Microsoft Excel (.xls e .xlsx)
arquivo eXtensible Markup Language (XML)
Arquivo de texto simples com espaçamento fixo ou usando algum outro delimitador

Este exemplo pressupõe que você tenha uma conexão com um banco de dados Oracle feita por meio do SQL Developer.

O arquivo a ser importado será o arquivo clients_export.csv vinculado aqui. Os dados se parecem com o seguinte (319 linhas com 21 colunas):

Introdução à importação de dados

Para começar, abra a árvore de navegação na área Conexões à esquerda da tela do SQL Developer. Clique com o botão direito do mouse nas Tabelas entrada e selecione o item de menu Importar dados… do menu pop-up.

Neste ponto, as versões mais antigas do SQL Developer (anteriores à 4.1.3) abrirão uma caixa de diálogo de seleção de arquivo onde você pode selecionar o arquivo a ser importado. Versões mais recentes do SQL Developer (4.1.3 e posterior) apresentarão a primeira etapa do Data Import Wizard, conforme mostrado abaixo.

Para o SQL Developer mais recente, clique no botão Browser para abrir a caixa de diálogo File Selection para selecionar seu arquivo.

Navegue até a pasta onde o arquivo está localizado e selecione-o. Observe que o Tipo de arquivo foi definido para filtrar arquivos do Excel, arquivos CSV e algumas outras variações de arquivos de texto.

Clique no botão Abrir para iniciar o assistente de importação de dados.

Visualizando os dados a serem importados e confirmando as configurações

A primeira etapa do Assistente de importação de dados fornece uma visualização dos dados a serem importados. Para este exemplo, o arquivo CSV tem uma linha de cabeçalhos que o assistente de importação usará para criar nomes de variáveis. Existem opções adicionais nesta etapa do assistente para pular um certo número de linhas no início (0 neste exemplo), selecione a formatação (csv neste exemplo), codificação de caracteres, símbolos de aspas usados para incluir texto ou strings e linha final/terminador. Na maioria dos casos, essas configurações podem ser deixadas no padrão.

Algumas mudanças que podem ajudar em determinadas situações incluem:

Altere o Line Terminator para Line Feed somente se o arquivo CSV tiver sido criado em um sistema operacional Linux ou Mac.
Altere a codificação para uma página de código específica que corresponda à sua região do mundo (ou à região do mundo na qual o arquivo CSV foi gerado).
Altere o número de linhas de visualização e role pelos dados para verificar se tudo foi analisado corretamente.

Se todas as configurações estiverem corretas e os dados visualizados estiverem corretos, clique no botão Avançar> para passar para a próxima etapa.

Escolhendo o método de importação

A próxima etapa do assistente é especificar o método de importação. Vários métodos de importação diferentes são fornecidos:

Inserir – Insira os dados diretamente em uma tabela nova ou existente.
Inserir script – Crie um arquivo de script SQL que inclua todas as instruções DDL e INSERT necessárias para carregar os dados em um banco de dados. Este script pode ser executado imediatamente ou movido para uma conexão de banco de dados diferente e executado lá.
Tabela Externa – Configura uma estrutura de tabela externa no Oracle onde a tabela aparece no dicionário de dados, mas os dados são mantidos em um arquivo externo.
Utilitário SQL Loader – Escreva o script e os comandos do SQL Loader para importar os dados para o Oracle.

Para este exemplo, o Inserir será usado para que os dados sejam inseridos diretamente em uma nova tabela.

Forneça um nome da tabela. Se houver um motivo para limitar as linhas a serem importadas, verifique o Import Row Limit caixa e especifique o número de linhas. Por exemplo, se seu arquivo de dados tiver milhões de linhas, mas você estiver interessado apenas em saber como são alguns dos dados, poderá limitar o número de linhas importadas. Neste exemplo, todas as linhas serão importadas.

Clique no botão Next> para passar para a próxima etapa.

Selecione as colunas para importar

A etapa 3 do assistente é selecionar as colunas a serem importadas. Realce quaisquer colunas nas Colunas Disponíveis janela e clique na seta para a direita para trazê-los para as Colunas selecionadas janela. Neste exemplo, todas as colunas serão importadas.

Clique no botão Next> para passar para a próxima etapa.

Atribuindo tipos de dados a cada coluna

A etapa 4 do assistente nos permite definir os tipos e tamanhos de dados para as colunas a serem criadas na nova tabela de dados. Esta é uma etapa muito importante! Se o tipo de dados incorreto for selecionado ou se um tipo de dados não tiver espaço suficiente para armazenar os dados de entrada, a importação falhará.

As versões mais recentes do SQL Developer mostrarão uma visualização de dados para cada coluna selecionada:

Alguns problemas comuns encontrados incluem:

Não fornecer espaço suficiente em uma coluna VARACHAR para acomodar o maior valor de string/texto.
Usar um tipo de dados NUMBER em uma coluna quando alguns caracteres de texto estão presentes nos dados.
Usar um formato de data ou hora incorreto ao importar datas e horas.

Visite cada uma das Colunas de dados de origem clicando neles um de cada vez. Faça ajustes nos tipos de dados à medida que avança. Para este exemplo, os seguintes ajustes são feitos:

CUSTOMER_ID mude para INTEGER Data Type e remova a caixa de seleção para Nullable
CUST_FIRST_NAME usa VARCHAR2 com tamanho 30
CUST_LAST_NAME usa VARCHAR2 com tamanho 60
STREET_ADDRESS usa VARCHAR2 com tamanho 65
POST_CODE usa VARCHAR2 com tamanho 20
CITY usa VARCHAR2 com tamanho 35
STATE_PROVINCE usa VARCHAR2 com tamanho 6
COUNTRY_ID usa VARCHAR2 com tamanho 4
COUNTRY_NAME usa VARCHAR2 com tamanho 60
REGION_ID usa VARCHAR2 com tamanho 2
NLS_LANGUAGE usa VARCHAR2 com tamanho 6
NLS_TERRITORY usa VARCHAR2 com tamanho 30
CREDIT_LIMIT use NUMBER com tamanho/precisão de 10 e escala 0
CUST_EMAIL usa VARCHAR2 com tamanho 60
PRIMARY_PHONE_NUMBER use VARCHAR2 com tamanho 30
PHONE_NUMBER_2 usa VARCHAR2 com tamanho 30
ACCOUNT_MGR_ID usa VARCHAR2 com tamanho 6
LOCATION_GTYPE usa INTEGER
LOCATION_SRID usa INTEGER
LOCATION_X usa NUMBER com tamanho/precisão de 14 e escala 6
LOCATION_Y usa NUMBER com tamanho/precisão de 14 e escala 6

Clique no botão Next> para passar para a próxima etapa.

Verifique os parâmetros de importação (Desenvolvedor SQL mais antigo)

Para versões mais antigas (pré 4.1.3) do SQL Developer, a última etapa do Assistente de importação de dados fornece uma chance de verificar se os parâmetros e configurações de dados permitirão que o arquivo de dados seja analisado. Esta tela é mostrada abaixo:

Clique no botão Verificar para verificar se todas as configurações estão funcionando corretamente. Os resultados do processo de verificação são mostrados abaixo:

Se houver algum problema, use o botão

Salvar os parâmetros de importação (versões mais recentes do SQL Developer)

Versões mais recentes do SQL Developer (4.1.3 e mais recentes) têm uma tela final ligeiramente diferente. Neste ponto, as configurações já foram verificadas e, portanto, uma tela de Resumo é exibida. O botão Salvar estado no canto superior direito fornece uma maneira de salvar todas as configurações de importação em um arquivo. Esse arquivo de configurações pode ser carregado na próxima vez que o Assistente de importação de dados for executado.

Para este exemplo, se estiver usando a versão mais recente do SQL Developer, clique no botão Salvar estado e salve as configurações em um arquivo chamado:oracle_sqldev_import_customers.

Executando a importação

Em ambos os casos (versão antiga ou mais recente do SQL Developer) para iniciar a importação dos dados, clique no botão Concluir. Quando a importação for concluída, uma caixa de diálogo será exibida. Quaisquer erros encontrados durante a importação serão exibidos.

Retorne ao SQL Developer e visualize a estrutura da tabela importada.

Em seguida, revise os dados (clique na guia Dados) para certificar-se de que os valores dos dados foram importados corretamente.

Para versões mais recentes do SQL Developer, os arquivos de configurações de importação salvos podem ser importados na primeira etapa do assistente de importação de dados para executar novamente ou alterar as configurações de importação antes de executar novamente a importação de dados.