Explore a referência completa
A busca e a navegação por temas precisam de JavaScript. O texto completo está disponível abaixo.
Comece a usar o SQL Hop
Do que você precisa
- Uma conta do SQL Hop ativada em uma organização aprovada, com um período de avaliação ativo e elegível ou uma assinatura paga.
- SQL Hop Desktop para seu computador e uma conexão com a internet para a primeira ativação.
- Uma instância da organização configurada pelo administrador do cliente e suas próprias credenciais autorizadas do Oracle.
Site da conta e aplicativo de consultas
As contas web comuns não exibem o espaço de trabalho SQL, os menus de consultas salvas e histórico nem as ferramentas de consulta. Os administradores da organização continuam configurando instâncias e membros no site. O editor web é mantido para uma futura ativação explícita; atualmente, ele não é uma opção de consulta para clientes.
Primeira consulta bem-sucedida
- Crie e ative sua conta e aguarde a aprovação necessária da organização ou do convite.
- Abra Downloads e escolha Windows, Mac Intel ou Mac Apple Silicon. Instale o SQL Hop Desktop.
- Entre online com sua conta do SQL Hop. Isso registra um computador para seu usuário ou licença.
- Selecione a instância da sua organização e conecte-se com suas credenciais do Oracle.
- Execute o SQL inofensivo abaixo. Um resultado bem-sucedido contém CONNECTION_OK = 1.
SQLSELECT 1 AS CONNECTION_OK
FROM dual
Continue trabalhando
Explore os guias de edição, designer, resultados e exportação. As consultas salvas no Desktop permanecem naquele computador; o site não é uma cópia sincronizada desse banco de dados local.
Web, desktop e regras de acesso
Uma organização aprovada e elegível recebe uma avaliação única de 30 dias, iniciada na aprovação, para até 10 usuários, incluindo administradores e convites pendentes. As consultas de avaliação são executadas no SQL Hop Desktop.
Os usuários pagantes também fazem consultas no Desktop. O site oferece segurança da conta, assinatura, cobrança e suporte. Os administradores do cliente configuram nele os membros, as instâncias e o acesso permitido à IA da organização. O site do cliente oculta a edição e execução de SQL, as consultas salvas, o histórico e as ferramentas de consulta com IA. O superadministrador mantém a execução web privilegiada.
O Desktop envia SQL diretamente ao serviço de relatórios Oracle configurado. Resultados, consultas locais, estado do designer, histórico e tarefas de exportação permanecem no computador. A IA opcional envia o SQL e as instruções revisados ao serviço configurado, nunca linhas de resultados. As verificações de conta, dispositivo e assinatura entram em contato com o SQL Hop.
A primeira ativação exige um login online. A autorização do desktop registrado é verificada na inicialização e a cada 24 horas enquanto o aplicativo permanece aberto. Se o servidor de contas estiver inacessível, a autorização assinada existente poderá permitir trabalho local por no máximo 48 horas desde a última validação bem-sucedida, nunca além do término conhecido da avaliação ou assinatura. Respostas explícitas de bloqueio, expiração ou revogação interrompem novas consultas e exportações. Reiniciar não redefine esse prazo.
O trabalho no Desktop não é sincronizado automaticamente com a web ou outro computador. Os rascunhos web e as consultas salvas existentes são mantidos, sem migração nem exclusão pela mudança de acesso. Use a importação e o download de arquivos SQL onde o espaço de trabalho estiver disponível. O operador poderá reativar explicitamente a execução web em uma implantação futura.
Crie uma organização e ative sua conta
Crie uma conta
- Selecione Criar uma conta no site público.
- Informe os dados solicitados da organização, do contato e da conta. Use uma caixa de entrada que você controle.
- Abra o e-mail de ativação e siga o link para definir sua senha.
- Aguarde o proprietário da plataforma aprovar a organização.
Aprovação e início da avaliação
A ativação comprova o acesso à caixa de entrada. Ela não aprova uma organização. O acesso ao espaço de trabalho permanece bloqueado até a aprovação do superadministrador. A avaliação de 30 dias começa na aprovação, não no cadastro nem na ativação por e-mail.
Contas existentes ou desativadas
Use suas credenciais existentes ou a redefinição de senha em vez de criar outra conta. Entre em contato com o administrador da organização se a conta estiver desativada. Novas organizações com o mesmo domínio empresarial ou a mesma instância Oracle podem assinar de forma independente; o uso anterior da avaliação continua sendo verificado para cada usuário.
O e-mail não chegou
Verifique o Spam e confira o endereço. Links expirados ou cancelados precisam ser substituídos. Durante uma implantação de e-mail em ambiente de testes, o provedor de envio pode exigir a verificação do destinatário; consulte o proprietário da plataforma em vez de tentar repetidamente.
Avaliações únicas e elegibilidade
Direito à avaliação
A avaliação da organização dura 30 dias a partir da aprovação e inclui até 10 licenças. Administradores e convites pendentes contam para esse limite. As consultas de avaliação são executadas no SQL Hop Desktop.
Todos os usuários participantes contam
O uso da avaliação é acompanhado por usuário, não apenas pelo administrador fundador. Tornar-se administrador, criar uma nova organização, cancelar ou cadastrar-se novamente não concede uma segunda avaliação. Convidar alguém que já utilizou a avaliação não permite repetir o acesso gratuito. Somente o superadministrador pode conceder uma exceção.
Equipes independentes
Compartilhar um domínio de e-mail ou servidor Oracle não impede, por si só, que equipes separadas façam assinaturas. As verificações de identidade da avaliação continuam valendo para cada usuário.
Ao expirar a avaliação
O acesso às consultas é interrompido; as contas e o SQL salvo são mantidos. O acesso à conta e à cobrança continua na web para que a organização possa assinar. Após o fim da avaliação, consultas no desktop exigem um plano pago ativo.
Dispositivo desktop e validação
Cada usuário identificado tem um computador registrado. Faça a ativação online no SQL Hop Desktop. A validação ocorre na inicialização e a cada 24 horas enquanto ele permanece aberto. Se o servidor de contas estiver indisponível, a autorização assinada existente permite trabalho local por até 48 horas desde a última validação bem-sucedida, limitado ao término conhecido da avaliação ou assinatura. Uma resposta explícita de bloqueio, revogação ou expiração interrompe novas consultas e exportações. O SQL e os resultados existentes são mantidos. Reiniciar nunca prolonga a autorização.
Substitua um computador
No site, abra Segurança da conta, verifique sua identidade com a senha e um fator existente e selecione Transferir para outro computador. Entre no computador substituto. O computador antigo só poderá continuar até a próxima validação ou o prazo assinado existente.
Login, logout e substituição de sessão
Entre
Use seu e-mail e sua senha do SQL Hop, não as credenciais do Oracle. Conclua qualquer etapa de MFA configurada. O Desktop oferece os métodos de verificação registrados na conta: código de autenticador, código de recuperação ou chave de segurança/chave de acesso. A verificação da chave de segurança abre uma janela segura temporária para o nome de host registrado do SQL Hop.
Sessões web e desktop
As sessões web e desktop são separadas. Entrar no site não encerra, por si só, a autorização do desktop. Um login mais recente no mesmo tipo de cliente pode substituir a sessão anterior; alterações de senha, fator ou conta podem invalidar o acesso. É permitido um computador registrado por usuário ou licença.
Tour guiado da web
Uma nova conta elegível pode receber um tour de três etapas no primeiro login web. Contas que já entraram antes, logins no desktop e o superadministrador não o acionam automaticamente. A preferência da conta é registrada antes de exibir o tour; portanto, fechá-lo, concluí-lo ou atualizar a página não faz com que ele se repita. Tour inicial na barra lateral reabre o tour manualmente sem restaurar a exibição automática.
Saia
Use o ícone de porta com seta na barra superior. O logout web retorna à página inicial. O logout do desktop remove cookies ativos e a autorização em cache, mas mantém as credenciais criptografadas do aplicativo que você optou por salvar. Use Entrar com as credenciais salvas do aplicativo para um novo login online; Esquecer login salvo remove essas credenciais.
Inatividade
Todas as contas web, incluindo o superadministrador, saem após dez minutos de inatividade e exigem um novo login após oito horas. As verificações de sessão em segundo plano não prolongam esses limites. O superadministrador continua isento do logout por inatividade no aplicativo desktop. Contas desktop comuns recebem um aviso de 30 segundos antes de expirar por inatividade; Prolongar adiciona cinco minutos, inclusive nas extensões seguintes. Ignorar o aviso encerra a sessão. Logout explícito, revogação e restrições da conta continuam valendo. As regras de inatividade são separadas da verificação do dispositivo a cada 24 horas e não prolongam a autorização offline.
Ative ou redefina a senha do aplicativo
Redefina uma senha
- Selecione Esqueci a senha na página de login web.
- Informe o e-mail da conta e envie a solicitação.
- Abra o e-mail de redefinição mais recente e use o link.
- Informe e confirme uma senha que atenda aos requisitos do formulário.
- Volte ao login e use a nova senha.
Erros de link
Links de redefinição e ativação expiram e só podem ser usados uma vez. Links antigos podem ficar inválidos após uma nova solicitação. Não os encaminhe nem os cole em mensagens de suporte. Solicite um novo link se necessário.
Organizações pendentes
A redefinição de senha pode funcionar antes da aprovação da organização. Ela não contorna a exigência de aprovação nem inicia uma nova avaliação. Redefinições bem-sucedidas são registradas no log de auditoria.
Duas identidades separadas
Redefinir a senha do aplicativo não redefine as credenciais do Oracle nem remove a autenticação de dois fatores. Entre em contato com o administrador responsável por essas alterações.
Códigos de autenticador, chaves físicas e códigos de recuperação
Abra a segurança da conta na web
Use Segurança da conta na navegação ou o ícone de conta na parte superior. Verifique a senha atual do aplicativo e um fator existente, quando solicitado, antes de fazer alterações. O período verificado de acesso às configurações de segurança é temporário.
Aplicativo autenticador
Escolha Configurar aplicativo autenticador, leia o código QR com o autenticador escolhido e informe o código atual de seis dígitos. Confirme a configuração antes de depender dela.
Chave de segurança física
Registrar chave de segurança física solicita uma chave USB/NFC externa. Escolha a chave física na solicitação do navegador e conclua a solicitação de PIN ou toque. Uma chave de acesso de plataforma armazenada no computador é diferente de uma chave física. O suporte do navegador e a política do dispositivo podem afetar a solicitação.
Códigos de recuperação
Gere códigos e guarde-os com segurança fora do aplicativo. Cada um pode ser usado uma vez. Gerar outro conjunto invalida o anterior. Nunca envie códigos de recuperação ao suporte.
Desktop e nomes de host
O Desktop mostra os métodos de verificação registrados disponíveis para a conta. Escolha Chave de segurança / chave de acesso para abrir a janela temporária de verificação HTTPS; conclua a solicitação de chave do navegador e deixe o aplicativo terminar o login. Chaves WebAuthn pertencem ao nome de host em que foram registradas. Um IP numérico da rede local não é adequado à configuração atual de chave física; use o nome de host aprovado mostrado em Segurança da conta. Não ignore avisos de certificado.
Perda de acesso
Um administrador autorizado da organização ou superadministrador pode redefinir os fatores registrados dentro do escopo de contas permitido, após verificar a solicitação e sua própria identidade. O usuário precisa cadastrar os fatores novamente; redefinir um fator não altera a autenticação do Oracle.
Lembre as credenciais do aplicativo e do Oracle
Lembre a conta do aplicativo
Selecione Lembrar meu login do aplicativo e manter minha conexão neste computador ao entrar no desktop. O servidor de contas, o nome de usuário, a senha e a sessão salva são criptografados com proteção do sistema operacional. Ao reiniciar, Lembrar pode retomar uma conta já registrada usando a autorização assinada do dispositivo após tentar a validação online. Se o servidor de contas estiver indisponível, só se aplica o período de tolerância autorizado restante. Caso contrário, use Entrar com as credenciais salvas do aplicativo e conclua uma nova MFA se necessário. O logout explícito remove a autorização em cache; ele não cria um login offline.
Lembre o Oracle separadamente
No formulário de conexão Oracle, selecione Lembrar credenciais do Oracle neste computador antes de uma conexão bem-sucedida. Na próxima vez, use Conectar com credenciais salvas. Os campos de senha podem ficar vazios de propósito; isso não significa que a entrada criptografada esteja ausente. A caixa de seleção reflete uma entrada salva existente.
Remoção e isolamento
Esquecer login salvo remove as credenciais do aplicativo. O logout explícito do desktop encerra a sessão e remove seus cookies de sessão salvos, mas mantém o nome de usuário e a senha criptografados que você optou por salvar para um novo login. A expiração por inatividade encerra a sessão sem excluir suas credenciais criptografadas do aplicativo. Desconectar Oracle limpa a conexão ativa; Esquecer credenciais salvas do Oracle remove sua entrada salva. Não é possível salvar se a criptografia protegida do sistema estiver indisponível.
Escopo
As entradas Oracle são isoladas por conta do aplicativo, endereço do servidor de contas, instância e configurações do relatório. Uma conta diferente ou uma configuração de instância alterada não reutiliza outra entrada. Entrar por localhost ou por uma URL da rede local pode selecionar um escopo de conta local diferente.
Solução de problemas
Use o mesmo aplicativo empacotado e a mesma URL do servidor de contas. Após uma atualização, reabra você mesmo o aplicativo recompilado. Se uma versão anterior removeu uma entrada salva, informe-a uma vez e selecione Lembrar. O armazenamento criptografado pelo sistema não promete que alguém com controle do seu computador conectado jamais poderá acessar segredos.
Abra e atualize o SQL Hop Desktop
Baixe e ative
- Abra Downloads no site. A detecção do sistema recomenda Windows ou Mac; escolha Intel ou Apple Silicon no Mac se a arquitetura não puder ser detectada.
- Confira a versão, as notas da versão, o tamanho do arquivo e a soma de verificação SHA-256. Somente instaladores publicados são oferecidos.
- Instale e abra o SQL Hop Desktop. O aplicativo se conecta automaticamente a https://sqlhop.com. Não há uma URL de servidor de contas para informar. Sua instância Oracle é configurada separadamente pelo administrador da organização.
- Entre com uma conta SQL Hop com avaliação ativa aprovada ou assinatura paga e conclua a MFA compatível. A primeira ativação online registra este computador na sua licença.
- Escolha a instância Oracle configurada pelo administrador e conecte-se com suas próprias credenciais do Oracle.
Atualização
Ajuda → Verificar atualizações…
Instale a versão publicada correta para a plataforma e reabra você mesmo o aplicativo. Uma atualização do site não atualiza um binário desktop já em execução. Preserve o diretório de dados do aplicativo, que contém trabalho local e credenciais criptografadas. A tela inicial mostra a versão; Sobre o SQL Hop também mostra a data da compilação.
Trabalho local e autorização
Consultas salvas, estado do designer, rascunhos, instantâneos de resultados, histórico, exportações e metadados baixados são locais. A autorização assinada do dispositivo suporta uma indisponibilidade limitada do servidor de contas, não uso offline ilimitado. O Oracle e a IA continuam precisando de seus respectivos serviços de rede.
Administração
Segurança da conta, transferência de dispositivo, administração da organização e cobrança são gerenciadas no site. O Desktop não tem um console de administração.
HTTPS, testes locais e endereços do servidor de contas
Login no desktop em produção
O SQL Hop Desktop se conecta automaticamente a https://sqlhop.com. A tela de login não pede uma URL de servidor. O endereço da instância Oracle é uma configuração separada da organização, gerenciada pelo administrador.
Desenvolvimento web local
No computador servidor
localhost e 127.0.0.1 se referem àquele computador. Outro dispositivo Windows ou Mac não pode usá-los para acessar seu servidor.
Em uma rede doméstica
Use o endereço HTTPS fornecido pelo operador, incluindo a porta. O exemplo de desenvolvimento é https://192.168.86.20:8443. O endereço pode mudar conforme a rede. Siga as instruções de configuração do certificado para o dispositivo e consulte o operador se a confiança não estiver configurada.
Distinga as falhas
- Não é possível acessar o site: verifique o estado do servidor, o endereço, a porta, a rede e o firewall.
- Aviso de certificado: a configuração de confiança ou nome de host está incompleta. Não envie credenciais por uma conexão não confiável.
- Restrição de login remoto do Oracle: use o gateway HTTPS configurado em vez da porta HTTP de desenvolvimento.
- Domínio inválido ao registrar uma chave: as configurações de origem de chave física/WebAuthn exigem um nome de host compatível; isso é separado do login normal com senha.
Escopo estável da conta desktop
Mantenha a mesma URL HTTPS de servidor de contas para um perfil local. Trocar as origens do servidor cria um escopo de conta separado e pode fazer o trabalho local salvo ou as credenciais Oracle parecerem ausentes.
Conecte e desconecte o Oracle
Conecte
- No espaço de trabalho, escolha a instância configurada.
- Selecione Conectar. Se você pressionar Executar enquanto estiver desconectado, o SQL Hop abrirá o formulário e lembrará essa solicitação de execução.
- Informe o usuário e a senha do Oracle e selecione Conectar ou Verificar e conectar.
- Aguarde a verificação de uma linha do QueryRunner. Os campos ficam desativados durante a solicitação.
- Um indicador de conexão verde confirma a conexão ativa. Uma execução pendente só continua após o sucesso se a aba, o SQL e a seleção envolvidos não tiverem mudado.
Tratamento das credenciais
Somente para a execução web do superadministrador, as credenciais Oracle ficam temporariamente na sessão autenticada do backend, por até 30 minutos, e não são salvas em nosso banco de dados, arquivos nem armazenamento do navegador. As credenciais do desktop ficam no computador e podem ser salvas opcionalmente com criptografia do sistema. Nunca informe credenciais do aplicativo no formulário Oracle.
Desconecte
Use o botão de plugue conectado ou desconectado. Desconectar ou sair do aplicativo limpa a conexão ativa. Uma conexão desktop é independente de uma reinicialização do servidor de contas. Reconecte se a conexão Oracle local expirar ou for desconectada; conexões web do superadministrador precisam ser restabelecidas após reiniciar o backend. O estado da conexão pertence à sua sessão; a conexão de outro usuário não autentica você.
Limites
Contas de avaliação e pagas se conectam no SQL Hop Desktop. Nenhum cookie SSO Oracle existente no navegador é reutilizado. Uma verificação Oracle que falhou não deve ser tratada como uma conexão bem-sucedida.
Configure os objetos Oracle do SQL Hop automaticamente
Pré-requisitos
Use um administrador Oracle ou desenvolvedor de relatórios autorizado com permissões de criação no catálogo, modelo de dados e execução de relatórios. O SQL Hop não pode conceder permissões Oracle nem corrigir uma política de identidade Oracle. Configure a instância HTTPS e a origem de dados Oracle corretas antes da configuração.
Configuração automática
- No site, abra Ambientes e escolha a ação de configuração da instância. Um administrador da organização também pode escolher a configuração automática dos objetos SQL Hop ausentes no formulário de conexão Oracle do desktop.
- Revise os caminhos exibidos do modelo de dados e do relatório. Os padrões da marca são /Custom/SQLHop.com/SQLHop_DM.xdm e /Custom/SQLHop.com/SQLHop_Report.xdo. Um perfil legado existente ainda pode usar /Custom/QueryTool/QueryRunner.xdo; não troque os caminhos sem intenção.
- Confirme a origem de dados Oracle, normalmente ApplicationDB_FSCM, e forneça seu usuário e senha Oracle autorizados para a operação.
- Execute a configuração e aguarde o SQL Hop criar os objetos ausentes e verificar o relatório com CONNECTION_OK = 1. Apenas ver os objetos no catálogo Oracle não comprova uma execução bem-sucedida.
- Após a verificação, feche a caixa de diálogo de sucesso e conecte-se à instância antes de executar consultas. Uma configuração verificada não cria, por si só, uma conexão ativa para consultas.
Configuração pendente e reparo
Se o Oracle ainda puder estar processando uma solicitação de criação, use Verificar estado da configuração em vez de enviar solicitações duplicadas. Reparar altera somente um modelo correspondente gerado pelo SQL Hop e faz uma cópia de segurança antes; modelos existentes não relacionados não são substituídos. Use a ação de reparo exibida se o SQL Hop identificar um problema de mapeamento de saída.
Alternativa manual
Use o guia de configuração manual somente quando a configuração automática estiver indisponível ou o administrador Oracle exigir. Instale a definição atual completa do SQLHop_DM com xdo_cursor e p_sql_base64, o mapeamento correto de saída e seu relatório correspondente. Cole o SQL no conjunto de dados do modelo de dados, não no layout do relatório nem em um pacote de banco de dados. Um ZIP de código-fonte não é automaticamente um arquivo de importação do catálogo Oracle.
Compatibilidade de versões e permissões
Definições antigas de modelo podem limitar resultados a 200 linhas, restringir comentários ou rejeitar SQL mais longo. Exportações em segundo plano também precisam de acesso ao download de fragmentos do relatório. Um relatório funcionar apenas no editor Oracle não comprova que o login do serviço pode executá-lo e baixá-lo. As credenciais de configuração são usadas nessa operação; as credenciais opcionais criptografadas de conexão desktop são gerenciadas separadamente.
Aplicativo e objetos Oracle
Remover uma instância no SQL Hop remove a configuração do aplicativo, não os relatórios Oracle nem as consultas salvas. Os objetos existentes são mantidos ao mudar para um local de catálogo verificado da marca. Teste a configuração no DEV antes de usar outro ambiente.
Gerenciar organization instances
Tabela de As a client admin, open Environments on the website. Use the instance and its add/edit controls. Supply a useful name, HTTPS Oracle origin and report path. An origin is the server address without a page path; a report path begins with /.
Edit and delete
Tabela de Edit a row to change its settings. Delete removes access to that configuration in the app; it does not delete anything in Oracle or erase saved queries. Removed entries can be restored where the screen offers Restore. Reconnect after endpoint or report settings change.
Organization scope
Client admins manage only their own organization’s instances and members. The same Oracle server can be configured by independent teams. Each user still needs their own authorized Oracle credentials. The built-in DEV entry is manageable by the platform owner.
Desktop synchronization
Desktop receives allowed instance profiles at sign-in and successful scheduled validation. Changes may take until the next startup or 24-hour check to reach an already-open app. It cannot edit them locally. Changing a profile can invalidate its active connection and select a different encrypted credential entry.
SSO do Oracle e autenticação compatível
Fluxo atualmente compatível
Usuários de avaliação e pagantes usam a conexão Oracle existente com usuário e senha no Desktop; o superadministrador também pode usar o conector web mantido. O login do SQL Hop e as configurações de dois fatores protegem a conta do aplicativo; eles não implementam SSO do Oracle.
O SSO do navegador é separado
Um botão de login do Oracle pode redirecionar para a Microsoft, mas uma sessão do navegador ou um token de identidade não autoriza automaticamente o serviço BI Publisher. O SQL Hop não copia os cookies Oracle do navegador.
O que foi adiado
O SSO geral do Oracle para execução de consultas continua adiado. O plano de execução tem sua própria janela de login Oracle no desktop quando o serviço nativo de planos exige; isso não autentica a conexão QueryRunner nem copia cookies do Safari. O SSO real do ambiente ainda precisa de uma verificação de login ao vivo. O SSO da Microsoft para login no SQL Hop também não está habilitado como substituto do login atual com senha. Não espere que credenciais do Office 365 funcionem na conexão direta com o Oracle, a menos que o administrador Oracle ofereça suporte explícito a esse fluxo.
Se a autenticação direta falhar
Pergunte ao administrador Oracle qual identidade de serviço e política de autenticação podem executar o relatório configurado. Não desative a MFA nem reutilize cookies do navegador como alternativa.
Escreva SQL e organize o espaço de trabalho
Layout
O editor SQL e os resultados usam a altura restante da janela. Arraste o divisor horizontal para mudar suas proporções. Coloque o foco no divisor e use as setas para redimensionar pelo teclado; um clique duplo restaura a posição. Expanda qualquer painel para ter mais espaço e depois restaure-o ou pressione Escape.
Use os ícones da barra de ferramentas para Executar, Executar tudo, Plano de execução, Parar, Desfazer, Refazer, converter a seleção em maiúsculas ou minúsculas, tamanho da fonte, Localizar e substituir, Formatar SQL, designer, Colunas, Descrever, Salvar, importar ou baixar SQL, Salvar tudo, Salvar como e IA permitida. Passe o ponteiro ou coloque o foco em um ícone para ver seu rótulo.
Resultados existentes
Alterar o texto do editor, formatar ou aplicar ou desfazer uma proposta de IA mantém os resultados atuais até outra execução substituí-los. Portanto, os resultados visíveis podem pertencer a um SQL anterior. As exportações usam o instantâneo do SQL executado quando disponível.
Navegação responsiva
Em janelas mais estreitas, use o botão do menu de navegação. Abra-o para acessar páginas da conta e do espaço de trabalho; feche-o com Escape, pelo fundo ou por um link de navegação. O Desktop usa a mesma aparência do espaço de trabalho com as convenções de atalhos nativas do sistema.
Abas de consulta e restauração do espaço de trabalho
Adicione e renomeie
Use o botão de mais para uma nova aba. Os nomes são exclusivos no espaço de trabalho. Clique duas vezes no nome de uma aba ou use Renomear aba para alterá-lo. Os números exibidos nas consultas salvas são por usuário, começando em 1; os IDs internos do banco de dados são separados.
Até 100 abas
O espaço de trabalho suporta até 100 abas abertas, inclusive em Salvar tudo e espaços restaurados. Role a barra de abas quando necessário; o controle de mais continua acessível. Feche as abas de que não precisa mais. Uma confirmação de descarte aparece para alterações não salvas no SQL ou no designer.
Restauração
Rascunhos web são salvos na conta conectada; rascunhos desktop são salvos no espaço local específico da conta. O SQL das abas e os dados do designer podem ser restaurados ao reabrir. Instantâneos temporários de resultados e valores de parâmetros não são backups permanentes do espaço de trabalho. Use Salvar para consultas nomeadas e exporte os resultados que precisar manter.
Resultados independentes
As abas mantêm seu próprio estado de consulta e resultados. Executar tudo adiciona abas de conjuntos de resultados dentro da aba de consulta atual. Não as confunda com as abas de consulta principais.
Salvar, Salvar como e Salvar tudo
Salvar
O ícone de salvar e Ctrl+S / Cmd+S fazem a mesma coisa. Se a aba estiver vinculada a uma consulta salva, Salvar a atualiza diretamente. Para uma nova consulta, abre-se uma caixa de diálogo com o nome da aba preenchido. Salvar registra os marcadores SQL e o estado do designer; os valores dos parâmetros não são salvos.
Salvar como
Use Salvar como ou Ctrl+Shift+S / Cmd+Shift+S para criar outra consulta nomeada. A aba atual fica vinculada à nova cópia. A original permanece inalterada e seu estado do designer é independente.
Salvar tudo
Salvar tudo salva todas as abas não vazias com seus nomes, atualizando consultas vinculadas e criando novas quando necessário. Alterações apenas no designer são incluídas mesmo sem gerar novo SQL. Use Ctrl+Alt+S no Windows/Linux ou Cmd+Option+S no Mac.
Reabertura
Abra uma consulta salva em Consultas salvas. Seu designer pode ser restaurado para edição. Se uma consulta salva vinculada foi removida ou está indisponível, mantenha o SQL do editor e salve uma nova cópia em vez de descartar o trabalho. Os arquivos salvos no desktop permanecem locais; os salvos na web pertencem à conta web.
Pastas de consultas salvas
- Abra Consultas salvas para criar ou renomear uma pasta. Clique no cabeçalho da pasta para expandi-la ou recolhê-la. A pesquisa verifica os números, os nomes e o SQL das consultas em todas as pastas, incluindo as recolhidas.
- Use Mover para, ao lado de uma consulta, para selecionar uma pasta ou Sem pasta. As consultas existentes e as salvas pela primeira vez ficam em Sem pasta; atualizar uma consulta salva mantém sua pasta. As pastas são privadas. As pastas e o SQL salvos no aplicativo de desktop permanecem no seu computador e são separados das consultas salvas na web.
- Ao excluir uma pasta, suas consultas são movidas para Sem pasta, preservando o SQL e os números das consultas.
Abra e baixe arquivos SQL
Importe
Use Abrir arquivo SQL e selecione um arquivo .sql. Seu conteúdo abre em uma aba do editor sem ser executado. Revise o texto e qualquer mensagem local de sintaxe antes de executá-lo. Permissões do seletor de arquivos do navegador ou do sistema podem ser necessárias.
Baixe
Use Baixar arquivo SQL para salvar o conteúdo do editor como .sql. Isso exporta SQL, não linhas de resultados nem valores de parâmetros salvos. Um arquivo de texto não contém todo o estado editável do designer visual.
Baixe o SQL do espaço de trabalho de origem e abra-o no destino. As consultas salvas na web e as salvas localmente no desktop são distintas. Importar um arquivo não concede acesso ao Oracle nem faz login.
Quando o seletor não abre
Verifique se outro seletor de arquivos ou janela modal já está aberto. No desktop, use o aplicativo empacotado recompilado e sua ação nativa de abrir arquivo. Não cole credenciais em um arquivo SQL para contornar um problema de conexão.
Formatação, maiúsculas e minúsculas, fonte e desfazer
Use Formatar SQL ao lado de Formatar automaticamente ao executar. A formatação manual altera apenas o texto do editor; ativar a formatação automática aplica a formatação como parte da execução. O alinhamento das cláusulas segue o estilo do SQL Hop. ORDER BY é uma exceção de alinhamento.
Selecione texto para habilitar as ferramentas de maiúsculas e minúsculas. Use Ctrl/Cmd+Shift+U ou Ctrl/Cmd+Shift+L. A conversão afeta o texto selecionado, incluindo literais selecionados; revise antes de executar.
Use A− e A+ para ajustar o tamanho do texto do editor. O editor SQL usa uma fonte de largura fixa para alinhar colunas e recuos. O zoom do navegador também afeta o restante da interface.
Desfazer reverte alterações do editor, incluindo substituições globais e SQL de IA aplicado. Refazer reaplica essas alterações. Essas ações não executam SQL nem limpam um conjunto de resultados existente. Os atalhos padrão do sistema estão em Atalhos de teclado.
Abra o ícone de ajustes ao lado de Formatar SQL para personalizar maiúsculas e minúsculas de palavras-chave, tabelas/visões, aliases, funções e tipos de dados; alinhamento de cláusulas; tamanho do recuo ou tabulações; quebra de expressões; quebras de linha em AND/OR; espaçamento de instruções; espaçamento de operadores; e posição de ponto e vírgula. Visualize as alterações antes de salvar. As preferências são lembradas para sua conta neste dispositivo e valem para a formatação manual e a formatação automática ao executar. Salvar preferências não altera nem executa o SQL do editor. Restaurar padrões redefine a visualização para o estilo do SQL Hop; selecione Salvar preferências para manter a redefinição. O padrão usa palavras-chave SQL e nomes de funções em maiúsculas, e nomes de tabelas/visões e aliases sem aspas em minúsculas. Identificadores entre aspas, nomes de colunas, literais e nomes de parâmetros mantêm suas maiúsculas e minúsculas. Use Desfazer após formatar para restaurar o SQL original.
Localize e substitua no SQL
Abra o painel combinado
Use o único ícone Localizar e substituir. Ctrl+F / Cmd+F abre a busca; Ctrl+H ou Cmd+Option+F abre a substituição. Informe o texto a localizar e, quando necessário, a substituição.
Percorra as ocorrências
Use os controles de próxima e anterior, F3/Shift+F3 quando compatível, ou Ctrl/Cmd+G e sua variante com Shift. No campo de busca, Enter e Shift+Enter alternam entre ocorrências. Confira as opções de correspondência disponíveis antes de substituir.
Substitua
Enquanto um campo do painel de busca estiver em foco, Ctrl/Cmd+Enter substitui a próxima ocorrência. Ctrl+Alt+Enter no Windows/Linux ou Cmd+Option+Enter no Mac substitui todas. Esses atalhos não executam SQL a partir do painel de busca. Desfazer pode restaurar uma substituição global.
Feche
Pressione Escape para fechar o painel e devolver o foco ao editor. Os resultados de consulta existentes permanecem visíveis.
Verificações SQL em tempo real e preenchimento automático
Retorno gramatical local
O editor verifica SQL no estilo Oracle enquanto você digita, incluindo junções, subconsultas e CTEs. Corrigir o SQL remove o diagnóstico após a próxima verificação. A verificação local não executa a consulta, não contata o Oracle nem limpa os resultados.
O Oracle continua sendo a referência
As verificações gramaticais locais são orientativas e não bloqueiam Executar. A sintaxe Oracle válida específica de uma versão pode ultrapassar a gramática local. Existência de objetos, permissões, regras de tipos, semântica de parâmetros e planos de execução ainda exigem validação pelo Oracle. Um estado local verde não garante uma execução bem-sucedida.
Sugestões
Use Ctrl+Space para solicitar sugestões. As sugestões de tabelas usam os metadados disponíveis. Após declarar aliases de tabela em FROM/JOIN, digite alias. para solicitar as colunas daquela tabela, inclusive na lista SELECT. As colunas não são todas inseridas nem carregadas no SQL automaticamente.
Sugestões ausentes
Verifique a grafia da tabela, a declaração do alias e a publicação de metadados escolhida. O Desktop precisa do pacote opcional de preenchimento automático baixado e habilitado. Descrever e Colunas dependem de metadados importados, não de uma garantia de inspeção do esquema em tempo real.
Execute uma consulta, busque linhas e pare de aguardar
Executar
Executar executa o SQL selecionado quando há uma seleção no editor; caso contrário, executa a única instrução do editor. O atalho é Ctrl+Enter / Cmd+Enter. Várias instruções geram uma orientação para usar Executar tudo em vez de enviar um script inteiro como uma única consulta.
Linhas a buscar
Linhas a buscar é o número máximo de linhas coletadas para a execução, atualmente oferecido até 10,000 para uso interativo. É separado de Linhas por página, que apenas altera quantas linhas já buscadas são exibidas de cada vez. Sua última configuração de busca é lembrada.
Durante a execução
O indicador e o cronômetro continuam durante a execução no Oracle, a busca e a primeira exibição. O cronômetro para quando os dados são apresentados. O tempo de preenchimento de parâmetros é excluído. As consultas Oracle são executadas localmente no SQL Hop Desktop.
Pare
Use Parar ao lado de Executar para cancelar a espera no aplicativo. Uma solicitação na fila pode ser removida antes de contatar o Oracle. Para uma solicitação já enviada, a execução no banco Oracle pode continuar; Parar não garante o encerramento no banco de dados.
Em caso de falha
Leia os detalhes do erro. O SQL permanece no editor. Uma execução com falha não exibe linhas de resultados anteriores como se fossem o novo resultado.
Gere um plano de execução Oracle
Gere um plano
- Conecte-se ao ambiente Oracle desejado.
- Selecione uma consulta SELECT ou WITH ou deixe uma única instrução no editor.
- Escolha Plano de execução na barra de ferramentas SQL.
- Informe os valores tipados de parâmetros solicitados.
- Se uma janela de login Oracle aparecer, entre com a conta Oracle desejada. O plano abre automaticamente após o login.
Não é necessário copiar e colar nem importar um arquivo baixado. Plano de execução não executa a consulta selecionada para obter linhas de resultados. Os resultados existentes e o SQL do editor continuam disponíveis.
Leia o plano
Expanda ou recolha operações para inspecionar a árvore, as linhas estimadas, o custo, os objetos, os predicados e as notas do Oracle. Custo é uma estimativa do otimizador, não segundos decorridos; os custos dos pais já incluem o trabalho dos filhos. São planos estimados, não estatísticas medidas de execução.
Compare e baixe
Escolha Usar como referência de comparação para comparar outro plano no mesmo visualizador. Compare o mesmo SQL e os mesmos valores de parâmetros; um custo estimado menor, por si só, não comprova uma consulta mais rápida. Baixar plano salva o texto original do plano Oracle.
Acesso e login do Oracle
O SQL Hop usa o serviço nativo Generate Explain Plan do Oracle e a origem de dados do relatório configurado. Ele não cria um relatório separado de plano de execução. A sessão de login desktop é separada do Safari e é limpa ao desconectar ou reconectar o Oracle, sair da conta ou expirar a conexão. Faça login novamente quando solicitado. Esse fluxo de login é para Plano de execução; a execução normal de consultas continua usando a conexão Oracle existente.
Disponibilidade e solução de problemas
Várias instruções e blocos PL/SQL são rejeitados. O serviço nativo e a política de autenticação dependem da instância Oracle. A solicitação nativa autenticada e o plano inofensivo SELECT 1 FROM DUAL foram verificados; o fluxo real de SSO desktop do ambiente ainda precisa de uma verificação de login ao vivo. Se o login for cancelado, tente Plano de execução novamente. Para um erro de acesso ou SQL, confira o mesmo SQL e a mesma origem de dados no BI Publisher e compartilhe códigos de erro sem dados sensíveis com o administrador. Não desative as verificações de segurança do Oracle. A execução web continua restrita às contas permitidas; planos nativos na web também exigem que o Oracle aceite as credenciais de conexão existentes.
Diferença em relação a Explicar com IA
Explicar com IA descreve o SQL usando o serviço de IA configurado. Plano de execução obtém o plano do otimizador Oracle e não usa IA.
Execute tudo e separe os conjuntos de resultados
Prepare o editor
Separe consultas de leitura com ponto e vírgula. Use Executar tudo ou Ctrl/Cmd+Shift+Enter. O SQL Hop executa as instruções em sequência, não como um único script Oracle.
Parâmetros
Cada instrução parametrizada solicita seus valores. Os valores valem apenas para aquela execução. Cancele a caixa de diálogo de parâmetros para evitar executar a solicitação pendente. Revise parâmetros lexicais mistos antes de continuar.
Resultados
Alterne as abas de conjuntos de resultados para ver a saída de cada instrução. Cada conjunto mantém seus próprios filtros, ordem de classificação e linhas selecionadas. Suas exportações usam os controles daquele conjunto e o instantâneo do SQL executado.
Erros e cancelamento
Executar tudo para após um erro; as instruções restantes não são executadas. Parar cancela a solicitação do aplicativo, sujeito às limitações de execução do Oracle. O tempo exibido para um lote representa a execução geral, não uma prova de que as instruções foram executadas em paralelo.
Parâmetros nomeados :NAME
Escreva marcadores
SQLSELECT :P_NAME AS NAME
FROM dual
Use marcadores :NAME em posições comuns de valores, como WHERE item_number = :X. Executar abre uma caixa de diálogo com os tipos texto, número, data ou NULL. Informe apóstrofos como texto comum, por exemplo O'Brien; não adicione aspas SQL ao redor do valor.
Execute ou cancele
Enter envia a caixa de diálogo uma vez. Cancelar, Escape ou clicar fora fecha a caixa sem executar a consulta nem adicionar uma entrada ao histórico. Os últimos valores e tipos confirmados preenchem execuções posteriores na mesma aba de consulta e no mesmo ambiente Oracle, inclusive após uma consulta com falha. As instruções de Executar tudo mantêm entradas separadas. Cancelar não substitui os últimos valores confirmados. Fechar a aba, sair, atualizar a página ou fechar o aplicativo limpa os valores mantidos.
Memória da sessão e privacidade
Os valores mantidos existem apenas na memória do aplicativo. Não são incluídos em abas restauradas, registros do banco de dados, armazenamento do navegador ou arquivos de consultas salvas. Outra aba ou ambiente começa separadamente.
Consultas salvas, downloads de arquivos SQL e a planilha SQL opcional em uma exportação Excel mantêm os marcadores. Os valores dos parâmetros não são salvos no histórico nem nos logs do aplicativo; o histórico parametrizado com falha usa erros sem dados sensíveis. Os valores ainda podem afetar ou aparecer nas linhas de resultados que você exporta intencionalmente.
Limite da implementação
O suporte atual a :NAME usa substituição tipada com escape antes da solicitação do relatório. Não é vinculação nativa Oracle DBMS_SQL. Os binds nativos do Oracle foram adiados. Mantenha marcadores para valores; use parâmetros lexicais apenas para fragmentos SQL intencionais.
Parâmetros lexicais &NAME e &&NAME
Lexical versus valor
Um parâmetro :NAME representa um valor tipado. Um lexical &NAME ou &&NAME insere um fragmento SQL, como uma lista de colunas ou condição. Fragmentos SQL não recebem aspas automaticamente como valores.
SQLSELECT &COLUMNS
FROM egp_system_items_b esib
WHERE esib.item_number = :ITEM_NUMBER
Revise antes de executar
Executar solicita os fragmentos lexicais e outros valores. Selecione Revisar SQL, inspecione o SQL expandido e execute a versão revisada. Se um fragmento introduzir mais marcadores :NAME, preencha os campos extras e revise novamente. Alterar um valor invalida a revisão anterior.
Reutilização somente na sessão
As duas formas lexicais podem preencher seu último fragmento confirmado para a aba e o ambiente, mas Revisar SQL é obrigatório em cada execução. Nenhuma forma salva seu valor permanentemente. Fechar a aba, sair ou fechar o aplicativo limpa os fragmentos mantidos. Cancelar ou Escape não executa a consulta.
Use de propósito
Um fragmento lexical pode mudar a estrutura da consulta. Não trate fragmentos não confiáveis como valores escalares inofensivos. Os marcadores originais do editor permanecem inalterados e os valores não são armazenados com o SQL salvo.
Privileged web query queue and concurrency
Who uses the server queue
Customer trial and paid queries execute locally in Desktop and do not enter the web query queue. Super-admin web execution remains available. The retained queue also applies if the operator explicitly enables eligible customer web querying in a future deployment.
Default limits
While waiting
Queued status shows the position before Oracle dispatch. Cancelling removes a queued operation. Authentication, entitlement, seat limits and maintenance are checked again when a slot opens.
Scope and capacity
This queue is process-local, not a distributed scheduler or a capacity promise. A full queue or timeout is a reason to reduce duplicate submissions. Oracle may continue work already submitted after application cancellation.
Crie uma consulta visualmente
Abra o designer
Selecione Designer de consultas na barra de ferramentas do editor. Pesquise os metadados disponíveis para adicionar tabelas. Atribua aliases distintos para deixar claras as referências de colunas e junções.
Escolha colunas
Selecione as colunas de saída e os aliases necessários. Os metadados devem conter as tabelas e colunas antes que os seletores possam exibi-las. Selecionar uma tabela não concede acesso ao banco de dados.
Adicione junções
Escolha os aliases das tabelas participantes, o tipo de junção e as colunas correspondentes. Confira se a condição representa a relação desejada; o designer não pode deduzir o significado de negócio nem garantir que uma junção evite linhas duplicadas.
Gere e revise
Gere SQL no editor quando estiver pronto. Revise a instrução completa e execute-a explicitamente. Filtros, classificação e agregações têm seus próprios guias do designer. A geração não executa SQL Oracle automaticamente.
SQL escrito manualmente
O designer mantém um modelo de design salvo para uma consulta. Não presuma que edições arbitrárias no editor sejam convertidas de volta nesse modelo. Revise o SQL gerado antes de substituir SQL editado manualmente.
Condições WHERE e ORDER BY no designer
Condições WHERE
Adicione uma condição usando um alias de tabela e uma coluna selecionados. Escolha uma comparação disponível e forneça o valor ou parâmetro desejado. Confira o tratamento de NULL e a diferença entre valores textuais e numéricos. Combine condições usando os controles fornecidos; inspecione o agrupamento resultante no SQL gerado.
ORDER BY
Adicione colunas à lista de classificação e selecione a direção crescente ou decrescente. A ordem dos campos determina a precedência. Um ORDER BY SQL estável é diferente de classificar uma grade de resultados já coletados.
Revise
Gere SQL e verifique as cláusulas WHERE e ORDER BY no editor. Use parâmetros :NAME para valores variáveis em vez de editar literais em cada execução. O Oracle valida nomes de objetos, tipos e permissões durante a execução.
Filtros de resultados são separados
Um filtro de coluna de resultados apenas restringe o instantâneo coletado. Ele não adiciona uma cláusula WHERE nem executa o Oracle novamente. Use as condições do designer para reduzir a saída real da consulta.
GROUP BY, HAVING e funções de agregação
Escolha agregações
No designer, escolha uma agregação para uma coluna de saída, como COUNT, SUM ou AVG. Use colunas numéricas adequadas para agregações aritméticas. COUNT(*) conta linhas; COUNT(column) exclui valores NULL.
Agrupamento
Adicione colunas de agrupamento para os campos de saída não agregados. Uma coluna de detalhe misturada com agregações normalmente precisa de GROUP BY. Confira o SQL gerado em vez de presumir que selecionar apenas uma função produz o resumo desejado.
HAVING
Use HAVING para filtrar resultados agrupados ou agregados. WHERE filtra as linhas de origem antes do agrupamento. Escolha a expressão de agregação e a comparação usando os controles disponíveis do designer.
Revise os resultados
Confira aliases, GROUP BY, HAVING e ORDER BY na instrução gerada. O Oracle pode rejeitar combinações inválidas ou tipos de dados incompatíveis. O designer não valida totais de negócio em relação aos relatórios de origem.
Salve e restaure designs editáveis
O que é lembrado
O estado do designer de uma consulta inclui as tabelas selecionadas, aliases, colunas, junções, condições, classificação, agrupamento e configurações de agregação. Reabra o designer naquela consulta para continuar em vez de começar novamente.
Salve sem gerar SQL
Alterações apenas no designer podem ser salvas mesmo sem gerar novo SQL no editor. Salvar e Salvar tudo mantêm o design junto com a consulta. Salvar tudo trata cada consulta de forma independente.
Salvar como
Salvar como cria uma cópia separada e editável do design. Editar a cópia não deve mudar a original. Reabra a original em Consultas salvas para inspecionar seu próprio modelo.
Logout e transferência
Designs web salvos são restaurados na mesma conta autorizada após o login. Designs desktop pertencem ao espaço de trabalho local da conta. Um arquivo .sql contém texto SQL, não o design visual completo. Não use a transferência de arquivos SQL como backup completo do design.
Escolha colunas de tabelas e aliases
Declare a tabela e o alias no SQL, abra Colunas, escolha a tabela ou o alias reconhecido e selecione as colunas necessárias. Confirme a inserção e revise a lista SELECT editada. As caixas de seleção escolhem campos; elas não executam uma consulta.
Sugestões por alias
Após declarar um alias, digite alias. no editor para solicitar as colunas daquela tabela, inclusive em SELECT. Ctrl+Space pode reabrir as sugestões. Várias tabelas e junções devem usar aliases distintos.
Se uma tabela estiver ausente
Confira a grafia e a sintaxe FROM/JOIN e confirme que a tabela existe nos metadados publicados. Escopos SQL complexos podem exigir edição manual quando o reconhecimento de aliases não consegue resolvê-los. Os metadados são um catálogo compartilhado de descrições, não uma verificação ao vivo das permissões Oracle.
Se colunas estiverem ausentes
Peça ao proprietário da plataforma que verifique se os lotes de colunas foram importados e publicados. No desktop, baixe e habilite os dados de preenchimento automático. Atualize o catálogo após a publicação ou o download em vez de inserir todas as colunas automaticamente.
Descreva tipos, tamanhos e comentários das colunas
Descreva uma tabela
Use Descrever tabela na barra de ferramentas e identifique a tabela. Revise nomes de colunas, tipos, comprimentos ou precisão/escala, aceitação de nulos e comentários quando esses campos existirem nos dados carregados.
Origem dos detalhes
Descrever usa metadados importados. Não há garantia de que a instância Oracle atual tenha exatamente o mesmo esquema. O catálogo publicado pode ser mais antigo que a instância.
Um comentário vazio pode significar que o Oracle não o forneceu ou que a extração não incluiu o campo de comentário. O importador não pode inventar descrições de negócio. Peça ao proprietário da plataforma que confira a pasta de trabalho original e os cabeçalhos reconhecidos.
Tamanhos vazios ou colunas ausentes
Confirme que o arquivo de colunas relevante inclui esses campos e foi publicado. Baixe o pacote atual de metadados desktop se estiver usando o desktop. O acesso de consulta a uma tabela e a disponibilidade de sua descrição no catálogo são verificações separadas.
Metadados compartilhados e publicação
O proprietário da plataforma carrega centralmente descrições de objetos, tabelas e colunas Oracle. Os dados publicados podem atender usuários de várias organizações. Não é um carregamento de linhas de resultados de negócio e não concede permissão de consulta Oracle.
Arquivos de tabelas e objetos e arquivos de colunas podem ser carregados separadamente. A identificação de planilhas usa cabeçalhos reconhecidos em vez de exigir um nome específico. Grandes lotes alfabéticos são mesclados em vez de substituir todos os dados de colunas anteriores.
Os dados importados são preparados antes da publicação. Os usuários consomem o catálogo publicado, não um trabalho de preparação incompleto. Após uma publicação, atualize ou baixe o catálogo atualizado conforme apropriado.
Somente tabelas e colunas presentes na extração podem aparecer nas ferramentas de metadados. Comentários e tamanhos são dados de origem opcionais. Não há um recurso automático de atualização de tabelas Oracle nem agendamento de metadados para manter esse catálogo atualizado.
A documentação pública do Oracle pode enriquecer descrições correspondentes de tabelas e colunas e áreas funcionais. Páginas indisponíveis e comentários ausentes são situações diferentes; documentação ausente permanece em branco. Os pacotes desktop precisam ser recompilados e publicados separadamente e depois baixados novamente. Não presuma que um instantâneo local antigo recebeu comentários mais recentes.
Baixe dados de preenchimento automático no desktop
Baixe
- Entre no desktop com uma avaliação ativa aprovada ou acesso pago.
- Abra Dados de preenchimento automático na navegação.
- Baixe o pacote de metadados disponível e habilite-o.
- Aguarde a conclusão da verificação e da instalação e volte ao editor.
O que ele habilita
O catálogo local oferece sugestões de tabelas, sugestões de colunas por alias, Colunas, Descrever e seletores de tabelas e colunas do designer. A execução SQL ainda pode usar nomes escritos manualmente quando não há metadados.
Armazenamento e atualizações
O pacote de metadados é baixado para o diretório local de dados do aplicativo em vez de ser incluído em cada instalador. Baixe um pacote publicado mais recente quando o proprietário da plataforma o atualizar. Você pode desabilitar seu uso pelo controle da tela. A ação separada de importação aceita um pacote de metadados compatível, não dados de negócio XLSX arbitrários.
Solução de problemas
Um download exige um direito de acesso válido da conta, rede, espaço em disco disponível e um pacote válido. Não exclua o banco de dados local do espaço de trabalho para atualizar o preenchimento automático. Nenhuma credencial ou resultado de consulta é incluído no pacote de metadados.
Entrega do download
O servidor de contas verifica a permissão e fornece um link privado de download do Cloudflare R2 de curta duração. Os bytes dos metadados são baixados diretamente do armazenamento, com verificação da soma de controle antes da instalação. Este é um instantâneo publicado: enriquecimento da documentação ou atualização do servidor não atualiza silenciosamente um download desktop existente.
Leia resultados e inspecione um registro
Controles da grade
Os cabeçalhos de coluna permanecem visíveis ao rolar a grade. Arraste um divisor do cabeçalho para redimensionar uma coluna, clique duas vezes no divisor para ajustá-la ao conteúdo ou use Ajustar colunas automaticamente para o conjunto. As larguras são lembradas por consulta quando o espaço de trabalho oferece suporte.
Registro expandido
Selecione Ver registro ao lado do número da linha para abrir um registro com os nomes das colunas à esquerda e os valores à direita. Isso é útil em tabelas largas. É uma visualização da linha de resultados selecionada, não um formulário de edição do banco de dados.
Clique com o botão direito na grade de resultados ou use Shift+F10 com o foco na grade para ver as ações disponíveis. Use somente as ações oferecidas para a célula, linha ou seleção atual.
Painel completo
Expanda os resultados para ter mais espaço e pressione Escape ou Restaurar tamanho dos resultados para voltar. Filtros, classificação e seleção permanecem ligados ao conjunto de resultados. Alterar o SQL do editor não substitui silenciosamente a grade.
Linhas por página e total de linhas
Escolha Linhas por página para exibir 10, 25, 50, 100 ou 200 linhas de cada vez. A última configuração é lembrada para o usuário e o espaço de trabalho. Use os controles Primeira, Anterior, Próxima e Última página quando disponíveis.
Contagem total e de correspondências
O total descreve as linhas no instantâneo coletado, não necessariamente todas as linhas da tabela de origem Oracle. Os filtros podem reduzir a contagem de correspondências. Um limite de busca pode significar que existem mais linhas na origem do que foram coletadas.
Linhas por página altera apenas a página visível. Linhas a buscar controla o máximo coletado em uma nova execução. Definir uma página de 25 linhas não significa que uma exportação de todos os resultados deva conter apenas 25 linhas.
Classificação, filtros e seleções operam sobre todo o instantâneo coletado. Instantâneos com carregamento sob demanda solicitam páginas conforme necessário em vez de colocar todas as linhas no navegador de uma vez.
Filtre resultados por coluna
Filtro de coluna
Selecione o ícone de funil no cabeçalho de uma coluna e defina uma condição de filtro compatível. Aplique-a para restringir as linhas correspondentes em todo o conjunto coletado, não apenas na página visível. Use Limpar filtros de coluna para removê-los.
Busca textual
Use o campo de busca dos resultados para o filtro de texto mais amplo. Busca e condições de coluna podem trabalhar juntas. Uma contagem de zero não comprova que o Oracle não tenha essas linhas fora do instantâneo buscado.
Seleção
As linhas selecionadas permanecem selecionadas ao aplicar ou limpar filtros. Linhas ocultas por um novo filtro ainda podem estar na seleção. Limpe a seleção explicitamente se elas não devem ser exportadas.
Filtro de consulta versus filtro de resultado
Um filtro de resultados opera nos dados buscados. Para alterar o que o Oracle retorna ou reduzir uma extração cara, adicione uma condição WHERE no SQL ou no designer e execute novamente.
Classifique entre páginas e exportações
Aplique a classificação
Escolha o ícone crescente ou decrescente em um cabeçalho. A classificação ativa fica destacada. Clique novamente na classificação ativa para limpá-la quando essa opção estiver disponível. A classificação vale para todo o instantâneo de resultados, incluindo linhas filtradas, não apenas a página atual.
Seleção estável
Alternar entre crescente e decrescente não muda quais linhas subjacentes estão selecionadas. A posição exibida de uma linha pode mudar; sua seleção deve continuar ligada àquela linha.
Exportações
As exportações CSV e Excel seguem a classificação atual dos resultados. Exportações filtradas usam a ordem filtrada; exportações de linhas selecionadas mantêm as linhas selecionadas na ordem atual dos resultados entre páginas.
ORDER BY SQL
A classificação da grade não executa o Oracle novamente nem altera o SQL do editor. Use ORDER BY SQL se o próprio Oracle precisar produzir uma ordem específica antes da coleta. Mantenha separada a classificação de cada conjunto de resultados de Executar tudo.
Selecione linhas entre páginas e filtros
Seleção individual e da página
Use a caixa de uma linha para selecioná-la. A caixa do cabeçalho seleciona as linhas da página visível. Mude de página sem perder essas linhas selecionadas.
Selecione todas as linhas correspondentes
Use Selecionar todas as linhas correspondentes para selecionar as linhas que atendem aos filtros ativos em todas as páginas do resultado coletado. Isso não seleciona linhas da tabela de origem fora do instantâneo nem significa todas as linhas sem filtro.
Filtros e classificação
Alterar filtros, limpá-los ou trocar a direção da classificação mantém as linhas selecionadas. Uma linha selecionada pode ficar oculta por um filtro. Por isso, a contagem selecionada pode ser maior que as linhas correspondentes visíveis.
Exporte
Escolha a opção de linhas selecionadas na caixa de exportação para incluir seleções de todas as páginas, inclusive linhas selecionadas atualmente ocultas por um filtro. Use Limpar seleção para redefini-la de propósito. Cada aba de resultados de Executar tudo tem sua própria seleção.
Exporte resultados CSV ou Excel
Exporte dados
- Abra Exportar dados para o conjunto de resultados atual.
- Escolha CSV ou Excel e confira se serão exportadas todas as linhas buscadas aplicáveis, as linhas filtradas ou as linhas selecionadas.
- Revise o nome do arquivo, incluindo a extensão, e baixe ou escolha o local nativo de salvamento.
Escopo e ordem
A exportação não se limita à página visível. Ela segue a classificação dos resultados e o escopo de exportação escolhido. Exportações de linhas selecionadas incluem seleções de outras páginas. Um filtro da grade pode ocultar linhas selecionadas sem desmarcá-las.
Nome do arquivo
O nome padrão usa o nome da aba de consulta seguido da data e do horário, com a extensão correta .csv ou .xlsx. Caracteres inválidos para nomes de arquivo são normalizados.
Separadores CSV
Escolha o delimitador oferecido na caixa de diálogo, como vírgula, ponto e vírgula ou tabulação. Textos com separadores, aspas ou quebras de linha recebem aspas adequadamente. Apóstrofos como em O'Brien continuam sendo dados comuns. Configure a importação da planilha para corresponder ao delimitador escolhido.
Excel com SQL
Escolha a opção de incluir SQL como segunda planilha. Ela usa o instantâneo do SQL executado quando disponível e mantém os marcadores de parâmetros; os valores dos parâmetros não são salvos na planilha SQL. As linhas de resultados ainda podem conter esses valores se a consulta os retornou.
Resultados grandes e carregamento sob demanda
Instantâneos interativos
Escolha um valor maior em Linhas a buscar, até as opções interativas oferecidas, e execute. Resultados grandes usam um instantâneo temporário com solicitações de páginas em vez de renderizar cada linha na grade. Filtros, classificação, seleções e exportações operam sobre o instantâneo coletado.
Buscar ainda exige trabalho
A exibição sob demanda não torna gratuita uma consulta Oracle ilimitada. Execução do relatório Oracle, transferência, limites de disco e memória e tempo de rede continuam importantes. Um SELECT * muito largo pode ser muito maior que a mesma quantidade de linhas estreitas.
Se um resultado for grande demais
Selecione menos colunas, use uma cláusula WHERE restritiva, reduza Linhas a buscar ou use a exportação desktop em segundo plano. Leia o erro real de tamanho ou limite de células em vez de presumir que linhas parciais são um resultado completo.
Temporário significa temporário
Os instantâneos são específicos da sessão e podem expirar ou desaparecer após logout, limpeza ou reinicialização. Se um instantâneo estiver indisponível, execute a consulta novamente. Baixe os resultados que precisa manter. O carregamento sob demanda não é um cursor de banco de dados que fica aberto para sempre.
Exportações desktop em segundo plano
Crie uma tarefa
- Conecte o Oracle no desktop.
- Use Exportação em segundo plano na barra de ferramentas de consulta.
- Escolha CSV ou XLSX, o máximo de linhas e as opções de exportação disponíveis; revise os parâmetros.
- Abra Exportações em segundo plano para acompanhar a tarefa local, cancelar se necessário ou baixar o arquivo concluído.
Como funciona
O conector compatível executa um relatório BI Publisher e baixa a saída em fragmentos. Você não precisa de colunas de ordenação exclusivas nem de uma caixa de confirmação da ordenação. O máximo atual de uma tarefa é 100,000 linhas, sujeito aos limites de relatório e saída; uma tarefa concluída no máximo pode indicar mais linhas na origem.
Onde os arquivos ficam
Tarefas e downloads temporários ficam no computador, não no servidor de contas. Arquivos temporários concluídos expiram 24 horas após a conclusão; a expiração aparece na tarefa. Baixe ou salve uma cópia para manter por mais tempo. Um arquivo salvo em sua própria pasta é separado da tarefa temporária que expira.
Mantenha o desktop aberto
A tarefa é local, não um agendador durável de servidor. Fechar o aplicativo, sair, desconectar o Oracle, suspender o computador, perder a rede ou expirar a licença pode interrompê-la. Não espere que ela termine com o computador desligado.
Problemas
Se chegarem apenas 200 linhas, confira o máximo real de exportação e o limite atual do QueryRunner. Se downloads de fragmentos forem rejeitados, verifique as permissões do serviço e do relatório. Um resultado interativo grande e uma exportação em segundo plano são fluxos diferentes.
Permissões de IA e chaves pessoais
Três modos de acesso
Quem decide
Administradores do cliente concedem modos apenas a usuários de sua própria organização. O superadministrador controla a configuração do serviço compartilhado e os ajustes da plataforma. Usuários não podem alterar o acesso de outro usuário nem contornar Bloqueado informando sua própria chave.
As alterações entram em vigor
Solicitações de IA compartilhada são autorizadas pelo backend. Permissões desktop são atualizadas na inicialização e na validação diária bem-sucedida; restrições de chave pessoal podem levar até essa verificação para chegar. Durante uma indisponibilidade do servidor de contas, uma permissão assinada existente pode permanecer até seu prazo fixo. Uma chave pessoal armazenada não substitui um modo Bloqueado recém-validado. As permissões persistem após logout e login.
Configuração pessoal
Quando permitido, abra Minha chave OpenAI no Desktop e use os controles disponíveis de chave e modelo. Chaves são segredos e não são exibidas novamente na íntegra. Confira o estado em vez de esperar que um campo secreto vazio mostre um valor existente.
Crie, explique e corrija SQL
Abra o assistente
Selecione o ícone de IA quando o administrador conceder acesso. Escolha Criar para descrever uma consulta, Explicar para entender SQL ou Corrigir para pedir uma correção. Revise quais instruções e SQL do editor você está enviando.
Limite de dados
Linhas de resultados não são incluídas nas solicitações de IA. O próprio SQL pode conter nomes, literais ou condições sensíveis; remova tudo que não deseja enviar. A IA desktop é um serviço de rede, mesmo que a execução Oracle seja local.
Revise antes de executar
A saída da IA é uma proposta, não SQL Oracle verificado. Confira nomes de tabelas e colunas, junções, filtros e sintaxe da versão Oracle. Aplique somente quando estiver satisfeito e execute explicitamente. O aplicativo não executa automaticamente o SQL proposto.
Erros
A disponibilidade da IA depende da permissão, da chave e do modelo configurados, da disponibilidade do provedor e dos limites. Um erro do provedor não é um erro Oracle. Uma resposta bem-sucedida da IA não comprova resultados de negócio corretos.
Refine, revise, aplique ou descarte alterações de IA
Proponha e refine
Descreva a alteração desejada. Revise a proposta e a comparação com o SQL original. Peça um refinamento para produzir uma proposta atualizada; a nova versão ainda exige revisão antes de Aplicar.
Aplique
Aplicar altera apenas o editor. Não executa SQL, não limpa a grade atual, não remove filtros de resultados nem altera linhas selecionadas. Esses resultados podem pertencer ao SQL executado anteriormente até você executar novamente.
Desfaça e refaça
Após aplicar uma proposta refinada, Desfazer restaura o SQL anterior. Refazer traz a proposta de volta. Nenhuma ação executa a consulta nem limpa os resultados existentes.
Descarte
Cancelar, fechar, Escape ou dispensar pelo fundo sem aplicar mantém inalterados o SQL do editor, os resultados, os filtros e as seleções. Não interprete o fechamento de uma proposta como aceitação.
Planos, licenças e datas de assinatura
Abra Assinatura
Usuários de avaliação e pagantes podem acessar a tela web de assinatura. Ela mostra o estado, o uso de licenças, o fim da avaliação quando aplicável e a data do período pago atual. Somente o administrador da organização pode iniciar o pagamento ou gerenciar a cobrança. O titular da conta de uma organização com uma licença pode ser seu administrador; ele usa essa licença.
Planos públicos atuais
O preço promocional de um usuário é USD 14.99 por mês ou USD 149.90 por ano (dois meses grátis), mais impostos aplicáveis quando configurados. O site atual e a confirmação da Stripe são as referências oficiais. Os totais de equipe são calculados de forma privada em Assinatura com base na quantidade de usuários identificados. Tarifas progressivas por volume não são publicadas no site. As condições promocionais são mantidas enquanto a assinatura for contínua; cancelar encerra a manutenção dessas condições. Ofertas personalizadas também podem ser combinadas em particular.
Assinaturas ativas
Os botões de novo pagamento são desativados quando já há uma assinatura ativa. Use Gerenciar cobrança / faturas para atualizar o plano existente, a forma de pagamento ou o cancelamento. No desktop, um administrador do cliente pode usar Gerenciar cobrança / faturas na web; a administração permanece no site.
Datas e lembretes
Um plano com renovação automática mostra o fim do período pago ou a próxima renovação, sem afirmar que a conta expirará nessa data. O cancelamento agendado mostra A assinatura expira. Os lembretes desktop começam três dias antes da expiração ou renovação mensal e quinze dias antes da expiração ou renovação anual.
Modo de teste
O modo de teste da Stripe não é um pagamento real. Voltar do Checkout não confirma o acesso por si só; o servidor usa eventos de pagamento assinados e o estado da assinatura.
Mude para um plano maior, menor ou alterne mensal e anual
Abra a assinatura existente
Use Gerenciar cobrança / faturas em vez de iniciar uma segunda assinatura. Selecione o plano ou intervalo oferecido e revise a confirmação da Stripe.
Planos maiores
Mudanças para planos maiores são proporcionais e cobradas imediatamente. Revise o crédito de tempo pré-pago não utilizado, as novas cobranças, os impostos e o valor devido. Se o pagamento da mudança falhar, o plano pago e o limite de licenças existentes permanecem; as contas e as consultas salvas são mantidas.
Planos menores
Mudanças para planos menores entram em vigor na renovação. O plano atual continua disponível até lá. Mudar para um intervalo de cobrança mais curto é agendado para a renovação. Revise a data de vigência e qualquer alteração agendada exibida no SQL Hop.
Alternância mensal/anual
Leia a prévia antes de confirmar: crédito não utilizado, impostos e valor a pagar dependem do intervalo, da data de vigência e do estado das faturas existentes. Abra Ver detalhes na confirmação para consultar a composição. Um saldo de crédito reduz faturas futuras; ele não é automaticamente um reembolso em dinheiro.
Licenças e condições mantidas
Reduza membros excedentes ou convites pendentes antes de um limite menor de licenças entrar em vigor. Planos encerrados podem continuar para assinantes existentes, mas sair deles pode tornar o preço antigo indisponível.
Cancele ou renove uma assinatura
Cancele
Abra Assinatura na web e selecione Gerenciar cobrança / faturas. Use a opção de cancelamento oferecida na Stripe, revise a data de vigência e confirme lá. Volte ao SQL Hop e atualize o estado da cobrança.
No fim do período
Quando o cancelamento é agendado, o fim do período pago é mostrado como a data de expiração da assinatura. O acesso pago às consultas termina quando o direito de acesso deixa de estar ativo. Contas e consultas salvas são mantidas; cancelar não exclui a organização nem concede outra avaliação.
Mude de ideia
Use Gerenciar cobrança para verificar se é possível reverter um cancelamento agendado ou renovar a assinatura. A confirmação do pagamento e o estado assinado da assinatura precisam restaurar o direito de acesso; apenas voltar de uma página não basta.
Reembolsos
O cancelamento não promete um reembolso automático em dinheiro. Revise a confirmação e as condições publicadas. Créditos de mudanças de plano normalmente reduzem faturas futuras. Entre em contato com o suporte sobre problemas de cobrança sem enviar dados do cartão.
Falhas de pagamento, expiração e bloqueios de cobrança
Falha de pagamento ou assinatura expirada
As consultas podem ser negadas quando o direito de acesso está em atraso, não pago, incompleto, pausado, cancelado ou expirado. A conta e as consultas salvas permanecem. O Desktop nega novas consultas e exportações quando a validação retorna explicitamente a restrição ou a autorização existente expira; os resultados em cache são mantidos. Administradores da organização ainda podem usar a cobrança web para revisar pagamento e renovação.
Falha na mudança para um plano maior
Uma falha no pagamento imediato da mudança não deve substituir o plano pago ou o limite de licenças existente. Revise o estado do pagamento no portal antes de tentar novamente e evite criar uma segunda assinatura.
Notificações
E-mails de falha de pagamento vão para o administrador da organização no formato de e-mail de conta do SQL Hop, com uma ação Gerenciar cobrança e proteção contra duplicatas. A entrega de e-mail não substitui a consulta de Assinatura.
Contestações
Uma contestação de cobrança pode aplicar um bloqueio de faturamento e uma política de lista de bloqueio. Ações para todo um domínio excluem provedores de e-mail públicos e exigem aprovação do superadministrador. Ganhar uma contestação não remove automaticamente um bloqueio permanente de e-mail; contate o proprietário da plataforma para revisão.
Segurança
Nunca envie senhas, números completos de cartão, links de redefinição ou chaves de API ao suporte. Inclua um erro sem dados sensíveis, o horário aproximado e o estado da assinatura.
Limites de licenças e contagem de membros
O que conta
Os limites de licenças incluem administradores da organização e convites pendentes, não apenas usuários que executaram SQL. Assim, um plano de um usuário pode conter uma conta de administrador sem ser uma licença gratuita separada de administração.
Adicione ou reative usuários
Confira a contagem atual de usados e permitidos antes de convidar ou habilitar contas. Criação, convites e reativação não podem contornar o limite de licenças. Organizações em avaliação incluem dez usuários; planos pagos ou personalizados usam a quantidade de licenças configurada.
Plano menor
Se você agendar um plano menor, reduza os membros ativos e cancele convites desnecessários antes da nova vigência. Exceder o direito de acesso pode pausar as consultas; isso não exclui contas nem SQL salvo.
Organizações independentes
Uma equipe separada pode assinar sob o mesmo domínio empresarial ou a mesma instância Oracle. Os usuários ainda precisam de sua própria conta autorizada e elegibilidade à avaliação. Compartilhar licenças não autoriza compartilhar um login entre várias pessoas.
Who can manage what
Regular user
Uses the permitted workspace and configured instances, personal account security and permitted AI. Trial and paid querying use SQL Hop Desktop; web querying is reserved for future enablement. Organization billing information remains accessible, but a regular user cannot start or change billing.
Administrador do cliente
Manages members, invitations, their organization’s instance configurations and assigned AI access. Can manage the organization subscription. A client admin cannot manage another organization or open platform-only Revenue & Stripe, shared AI configuration or email-domain protection.
Superadministrador
The platform owner manages organization approval, trial exceptions, platform settings, shared metadata, billing plans, revenue reports, disputes, maintenance, backups and domain controls. Super-admin web/desktop query exceptions are not representative of ordinary customer access.
Desktop
Administration is excluded. A client admin’s billing identity is preserved separately so they can open web billing without enabling the desktop admin console.
Invite, confirm, approve and manage members
Create an invitation
Open Members & access. Enter the person’s full name and email, then choose User (the default) or Organization admin. Organization admins can manage users, Oracle connections, billing and organization settings. Review the selected role and full recipient address in the confirmation before sending. Super-admin access cannot be assigned here. The name is used in account emails rather than greeting users by their email address.
Activation then approval
The invitee opens the activation link and sets their app password, proving inbox access. For either invited role, an existing organization admin then approves the activated account before it can use the workspace. Email confirmation is not automatic workspace approval.
Resend or cancel
Use the row actions to resend an invitation or cancel it. A cancelled or superseded activation link should no longer be used. Pending invitations consume seats, so cancel unneeded ones before adding others.
Edit and disable
Edit a member’s name or email using the offered row control. Changing the login email invalidates sessions and links and can require fresh confirmation. Disable an account to remove access without deleting saved queries. Only manage members within your own organization.
Reset a member’s authenticator or security keys
Before resetting
Verify the member’s identity through your established process. An email claiming a lost key is not itself proof of ownership. Never ask them to send you a password or recovery code.
Use member security controls
Open Members & access, choose the member’s security action and review the factor-removal confirmation. Remove the authenticator configuration or registered security keys as needed. The user must enroll new factors afterward.
Effects
Removing the final factor can disable two-step sign-in and invalidate recovery codes. Factor changes can invalidate other app sessions. This does not reset Oracle authentication or delete the account’s SQL.
Scope
Client admins can act only on authorized members in their organization. Super-admin and other protected admin changes require the appropriate platform-owner flow. If no removal control appears, confirm your role and which member you selected.
Configure shared AI and user permissions
Shared OpenAI configuration
Super admin opens AI settings, configures the secret API key and chooses an available model. The model list can be refreshed from the provider; unavailable or retired models must not be assumed to remain valid. Use configured/status checks rather than expecting the secret to be displayed.
Client-admin assignment
Client admins use Members & access to set Shared AI, Personal key or Blocked for their own users. The backend enforces shared-service requests. Desktop receives permission changes at startup or successful daily validation; an offline device can retain existing signed permissions only until its fixed deadline. Newly validated Blocked access cannot be bypassed with an old personal key.
Secrets and payloads
Keys stay protected server-side or in the applicable local encrypted store. Result rows are excluded from AI requests. SQL and user instructions can contain sensitive information and are intentionally sent when assistance is requested.
Review policy
AI proposals require review and Apply before replacing editor SQL. They are never executed automatically. Do not grant additional permissions merely to hide a provider or billing error.
Organization approval and trial exceptions
Review organizations
Open Organization approvals and inspect the applicant and organization details. Approve or reject using the screen’s controls. Activation can be completed while pending, but workspace access is still blocked.
Trial start
Approval starts the eligible 30-day organization trial, with ten seats. Approval and email activation are distinct events. Do not backdate or restart a trial merely because an applicant resets a password.
Exceptions
Prior trial use is tracked across all participating users, including users who later become admins. Only super admin can grant an explicit exception. Same-domain and same-Oracle-instance teams can subscribe independently; do not block them solely for sharing infrastructure.
Domain protection
Email-domain controls belong to super admin. Temporary overrides, such as approved test inboxes, must remain deliberate exceptions rather than opening domain protection to client admins.
Email-domain protection
Purpose
Domain protection checks account email domains against the configured downloaded list and platform rules. It is separate from Oracle authentication and separate from a team’s right to use an already shared Oracle instance.
Gerenciar centrally
Only super admin can update protection settings or grant exceptions. Client admins cannot change the global policy. Review list updates and matching behavior on the screen before using a broad exception.
Independent teams
A shared company domain is not a reason by itself to block separate organizations or paid teams. Repeat-trial rules follow user identities. Chargeback domain escalation is a different workflow, excludes public email providers and requires approval for domain-wide actions.
Test inboxes
If a public-domain account is approved for a deliberate test, record the exception and scope. Do not assume that all accounts from that public provider are now allowed.
Coluna de Upload object and metadata
Use the expected Oracle object/table fields, including OWNER, OBJECT_NAME and OBJECT_TYPE for object lists. Column extracts need identifiers including OWNER, TABLE_NAME and COLUMN_NAME, plus the size/type/comment fields recognized by the upload screen. Follow its exact current header list; do not guess unsupported comment-field names.
Coluna de Upload table/object data and data separately. The importer identifies sheets by recognized column headers rather than relying on a sheet name. Put the recognized headers in the actual header row expected by the screen. A file containing columns should not require an unrelated object sheet.
Coluna de Split large extracts by table-name initial or another non-overlapping range. Upload each batch in merge mode; previous batches are retained. Table/column identity uniqueness prevents duplicate entries. Restrict extracts to the intended object set to avoid unnecessary volume.
Inspect staged row counts and sample types, sizes and comments. Publish metadata when the assembled catalog is ready for users. Publication is the step that makes staged data available; an upload alone is not proof that autocomplete has changed. Desktop users download the new package.
Check the original workbook for empty comments before blaming import. Wrong or unrecognized headers, missing owners and source NULLs can explain absent details. Never upload client result data as schema metadata.
Custom plan maker and retired plans
Create plans
Use Plans & seats to define the plan, CAD or supported currency, monthly/yearly amounts and user capacity. Custom pricing is organization-specific and not shown on public plan cards. Public plan publication drives the website’s displayed offers.
Publish and test
Review the Stripe mode, price interval, exclusive-tax treatment and seat count before publishing. Test Checkout and signed events in sandbox. A plan label does not by itself grant seats; the active mapped subscription controls entitlement.
End-date plans
End-date a plan to close it to new customers while existing subscribers can remain on their current price as grandfathered. New customers receive available new plans. Switching away can make the old price unavailable.
Changes and limits
Immediate upgrades require successful prorated payment; downgrades take effect at renewal. Seat checks include admins and pending invitations. Never solve a failed payment by deleting an account or saved SQL.
Revenue, taxes and date-range reporting
Open Revenue & Stripe
Choose the date range and refresh the reporting screen. Review the displayed mode so sandbox totals are not mistaken for live revenue.
Gross customer payments, taxes, Stripe processing fees, refunds/credits, net balance transactions and payouts describe different amounts. Tax collected is not the same as revenue retained. A payout can include transactions from different invoice dates.
Tax
Prices use plus-applicable-tax treatment where configured. Stripe Tax needs the business address and valid registrations for the intended mode/jurisdictions. Invoice tax IDs and tax registration settings are separate. Do not assume live tax collection is enabled because sandbox tests passed.
Data and reconciliation
Invoice and credit-note access is required for actual tax/credit reporting. Reporting uses read-only credentials where configured. Compare date definitions and currencies when reconciling reports; fees are provider charges, not the subscription price itself.
Monthly collections
The report opens on the current calendar month. Use This month, Last month, or choose any Month (UTC) and select Show month. Custom From/To dates and the 7/30/90-day ranges are also available. Total money received is actual charges/payments including tax, not subscription list prices or forecast revenue. Net collections subtract fees and refunds and include dispute adjustments. Invoice tax and credit notes use their separately described basis. Each currency is reported separately. Export report CSV keeps the selected date range. Sandbox figures represent test transactions, not real income.
Chargebacks, blacklists and billing holds
On a chargeback
The configured dispute handler can place a billing hold and permanently blacklist the associated email, with super-admin override. Accounts and saved queries remain intact. Notifications and audit records explain the restriction.
Event handling
Duplicate and out-of-order events must not repeat destructive actions or blindly undo newer state. Won/lost outcomes update dispute handling; winning does not automatically remove the permanent email blacklist.
Domain escalation
A second qualifying chargeback from the same business domain can trigger a domain-level review. Public providers such as Gmail and Outlook are excluded. Domain-wide cancellation and unused-time prorated refund actions require super-admin approval before execution.
Review before approval
Inspect affected organizations, subscriptions and proposed amounts. Confirm the Stripe mode and current state. A client admin cannot approve a platform-wide refund or blacklist override. Never make domain-wide decisions from a forwarded email alone.
Read audit history and old/new values
Access
Audit log is restricted to administrators within their permitted organization scope. It records actor, action, target, time and descriptive change details rather than expecting users to interpret raw IDs.
What changed
For supported account and instance edits, review old/new values such as display name, login email, instance name, URL or report path. Security secrets and parameter values are not an audit-value display feature.
Account lifecycle
Activation, completed password reset, invitation changes and administrative actions can produce separate events. A pending organization may reset passwords without becoming approved.
Retention
Audit records older than 90 days are automatically removed by the retention process. Audit history is not permanent recovery storage. Query history is a separate feature with its own retention rule.
Histórico de consultas e retenção
Conteúdo do histórico
O histórico registra o SQL executado e o resultado da execução. Abra um item para revisar ou executar novamente; SQL parametrizado deve manter os marcadores e pedir novos valores.
Retenção automática
O histórico automático mantém o último mês de atividade ou, no mínimo, as últimas dez consultas quando forem mais antigas. A limpeza é agendada para o fim de semana, não a cada hora. O histórico desktop é local ao espaço de trabalho da conta.
Diferença em relação a consultas salvas
Salve por nome as consultas que deseja manter. O histórico não é um backup permanente. Limpar o histórico é uma ação explícita e não significa que dados Oracle foram excluídos.
Preenchimento de parâmetros cancelado
Cancelar, Escape ou clicar fora da caixa de parâmetros não executa SQL nem cria uma entrada de histórico de execução. Consultas parametrizadas com falha mantêm erros de histórico sem dados sensíveis, sem salvar os valores dos parâmetros.
Avisos de manutenção e estado do serviço
Avisos
Uma mensagem de manutenção planejada pode mostrar o início, o fim previsto, o fuso horário e as instruções do operador. Durante a manutenção ativa, a animação pública de login pode ser substituída pela visualização de manutenção.
Restrições de acesso
Quando a manutenção é imposta, usuários web que não são superadministradores são desconectados e o acesso normal é restrito. O operador mantém o acesso privilegiado necessário para realizar a manutenção. O início agendado é avaliado pelo backend, não apenas por um cronômetro visual da página.
Trabalho existente
Salve o trabalho antes do período anunciado. O SQL salvo e as contas devem permanecer intactos. Conexões Oracle web do superadministrador e instantâneos temporários do servidor podem se perder ao reiniciar o backend. Resultados e conexões Oracle locais do desktop não ficam hospedados nesse servidor. Mantenha o Desktop aberto e salve exportações importantes.
Autorização desktop durante a indisponibilidade
Um computador registrado já autorizado pode continuar trabalhando localmente dentro do prazo assinado quando o servidor de contas estiver indisponível. O limite é de 48 horas desde a última validação bem-sucedida, limitado à expiração da avaliação ou assinatura. A primeira ativação e a conta ou cobrança web precisam do servidor; Oracle e IA ainda precisam de seus próprios serviços. Negações explícitas do servidor não recebem uma extensão por indisponibilidade.
Falhas
Use Estado do serviço no login ou no rodapé do site. Uma página de estado servida pelo mesmo aplicativo também pode ficar indisponível durante uma falha total do servidor; ela não garante monitoramento independente.
Schedule, start and end maintenance
Plan a window
Open Maintenance and enter the title, user-facing message, start, expected end and timezone. Review the schedule before enabling it. A clear message should explain what users need to save and when to retry.
Enforcement
At the active stage, non-super-admin web sessions are logged out and access is restricted. Super admin remains able to work. Query dispatch rechecks maintenance after queue waiting, so queued work does not bypass the window.
End maintenance
Use End to clear the active restriction and publish the updated status. Clients poll for status changes; verify a normal user can reach the intended page afterward. Ending maintenance is distinct from restarting a stopped server.
Operational work
Back up first, use the deployment process and avoid replacing the live database or private settings. After an upgrade, verify application health, sign-in, billing events and Oracle reconnect behavior.
Backups, S3 retention and recovery
Backups e recuperação
Use Create local recovery set or Back up to S3 from the web admin screen. The configured process can package application recovery files and a database backup excluding bulky Oracle table/column metadata contents. Review each job’s status and included/excluded items.
Daily scheduling
The configured daily backup runs only where the application/server schedule is actually installed and running. A prepared development schedule is not proof that a future VPS is configured. Confirm server timezone and last successful upload.
Retention
The private S3 recovery/ prefix has a 30-day lifecycle policy when enabled. AWS processes expiration asynchronously; noncurrent versions follow the configured additional cleanup. Saved downloads outside this prefix or local copies have separate retention.
Encryption keys
S3 storage encryption does not stop an authorized downloader from opening a ZIP. Application fields inside a database backup can still be encrypted with application keys. Those keys and private settings are excluded and need a separate secure recovery copy; losing them can make restored data unreadable.
Recovery testing
Keep backups private, test restore to a separate environment, verify accounts and saved SQL, and do not overwrite a working production database as a test. Desktop-local query files and exports are not covered by the server backup.
Downloads and signing key
R2 installers and metadata are separate from S3 recovery sets. Database recovery alone does not recreate those files. Preserve the desktop signing key in its persistent server volume and make a separate protected copy alongside other secrets. Replacing the key requires a fresh online sign-in on registered desktops; existing signed files cannot be verified with a different key.
Deploy updates without replacing data
Before deployment
Confirm the target server, SSH access, runtime, database, HTTPS and private environment settings. A production VPS/domain deployment is a separate step from local development and packaging.
Safe update process
Use the repository’s prepared deployment and recovery instructions. Keep database data, private credentials, application encryption keys, uploads and runtime files outside replaceable application releases. Back up and review migrations before applying an update.
Web and desktop synchronization
Run the complete build process for a finished change batch. It must build web assets, desktop assets and the packaged desktop application and verify their consistency. Updating shared sources alone does not refresh a running desktop app.
After deployment
Check health endpoints, public pages, login, billing/webhook processing and authorized Oracle connections. Use maintenance for planned downtime and retain a rollback path. Do not assume a rollback can undo a destructive schema change without a backup.
Persistent device authorization and downloads
Preserve the device_license volume/signing key when replacing app containers. Use the optional R2 downloads configuration and restricted credential mount for installers/metadata; keep backup credentials separate. Migrate and verify current published objects before enabling R2. Keep WEB_QUERY_ENABLED disabled for the current customer desktop-only policy. Local backend restarts are not desktop binary updates.
Account email delivery and templates
Transactional email
Account invitations/activation, password resets and payment-failure notifications use the configured HTML account-email format with a plain-text alternative. Full names support a personal greeting. These are operational messages, not marketing-list subscriptions.
Delivery configuration
The platform owner configures the email provider and sender identity. SES sandbox mode can require recipient verification; production access is separate from domain verification. Do not assume every recipient is enabled just because one inbox received a test.
Invitation lifecycle
Resend/cancel and post-activation admin approval are distinct from sending mail. An email accepted by the provider does not prove delivery, activation or workspace approval. Check the account status and audit event.
Secrets
Email links are sensitive, expire and can be single-use. Keep SMTP/API credentials server-only. Do not include passwords, reset tokens, parameter values or card details in a support response or audit description.
Solicitações de contato e confirmação
Envie uma solicitação
Use Contato para vendas, preços personalizados de equipe ou suporte. Informe uma caixa de entrada que você controle e os detalhes da mensagem. O site envia um e-mail de confirmação; a solicitação não é encaminhada ao proprietário até você seguir o link e confirmar o envio.
Envios repetidos
Enviar repetidamente sem confirmar não deve gerar e-mails de confirmação repetidos. O site orienta a confirmar a solicitação existente. Confira a caixa de entrada original e o Spam em vez de reenviar.
Após a confirmação
Somente a solicitação confirmada é encaminhada para resposta. Abrir um link nem sempre é a etapa final; use Confirmar e enviar na página de confirmação. Mensagens de solicitação não usam a assinatura de equipe dos e-mails de conta.
Privacidade e revisão do proprietário
O proprietário da plataforma pode revisar mensagens, horários, IP de origem e estado de confirmação e entrega em Solicitações do site. Os registros de IP ajudam a investigar abuso, mas não comprovam a identidade de uma pessoa. O proprietário responde ao e-mail entregue em vez de tratar cada envio não confirmado como uma conversa.
O Cloudflare Turnstile verifica o visitante antes de o servidor registrar uma solicitação ou enviar um e-mail de confirmação. Tokens inválidos, expirados, reutilizados ou ausentes são rejeitados. O servidor também verifica o nome de host e a ação em desafios reais. Uma falha do provedor impede o envio em vez de ignorar a verificação. Os limites de frequência, o campo oculto antispam e a regra de um e-mail de confirmação continuam valendo. O desenvolvimento local usa chaves oficiais de teste claramente identificadas; a produção exige um widget real e um segredo exclusivo do servidor. CAPTCHA não substitui a confirmação por e-mail nem garante que uma mensagem seja legítima.
O que é armazenado, enviado ou mantido localmente
Conta do aplicativo
Nosso banco de dados mantém conta, organização, SQL web salvo, estado de cobrança e dados de auditoria permitidos. E-mails e nomes das contas usam criptografia do aplicativo e proteção de busca; senhas são armazenadas como hash, não como texto puro recuperável. A criptografia não torna inofensivo um aplicativo em execução comprometido.
Oracle
Na execução web do superadministrador, credenciais Oracle são valores temporários na memória do servidor, não registros persistentes no banco. Contas web de clientes não têm espaço de consultas. Solicitações e resultados Oracle desktop são locais; credenciais salvas opcionais usam criptografia protegida do sistema. Sua consulta autorizada ainda envia SQL ao Oracle.
Parâmetros e exportações
Valores de parâmetros não são armazenados com SQL salvo, histórico ou a planilha SQL opcional da exportação. Linhas retornadas podem conter valores sensíveis, e um arquivo exportado é uma cópia intencional. Revise exportações antes de compartilhá-las.
IA
Somente o SQL solicitado e as instruções são enviados para assistência de IA, nunca linhas de resultados. Literais SQL podem conter informações sensíveis.
Recuperação
Backups do servidor excluem chaves e trabalho local do desktop. Proteja separadamente chaves do aplicativo, dados locais do espaço de trabalho e exportações baixadas. Evite compartilhar tokens, logs brutos ou credenciais durante a solução de problemas.
Autorização de dispositivos e downloads
O servidor armazena o ID do dispositivo registrado, o nome do computador, a chave pública e os horários de registro e validação. A chave privada e a autorização assinada permanecem no armazenamento protegido do sistema no computador. O envelope assinado inclui identidade da conta, permissões e configuração de instâncias, não senhas Oracle, SQL ou resultados. Instaladores e metadados são entregues de armazenamento R2 privado com links de curta duração; backups de recuperação usam um armazenamento S3 privado separado.
Privacidade, tratamento de dados e segurança do suporte
Leia Tratamento de dados e Informações de uso no rodapé do site para consultar as informações publicadas atuais. Estes artigos explicam o comportamento do produto; não substituem os termos publicados nem um acordo de privacidade.
Informações seguras para o suporte
Inclua a plataforma (web/desktop), a versão do aplicativo se disponível, o horário aproximado, a ação realizada e o erro exato sem dados sensíveis. Uma consulta de reprodução inofensiva é preferível a dados de negócio. Capturas de tela devem excluir senhas, tokens, literais SQL privados e linhas de resultados que você não tem permissão para compartilhar.
Nunca compartilhe
Não envie senhas Oracle ou do aplicativo, chaves de API, códigos MFA, códigos de recuperação, links de redefinição ou ativação nem dados completos do cartão. Um administrador não precisa da sua senha para investigar uma política de acesso.
Escopo
Permissões Oracle independentes, entrega do provedor de e-mail e políticas de rede ou dispositivo podem afetar o comportamento fora do SQL Hop. Consulte o administrador responsável em vez de enfraquecer as proteções da conta.
Solucione erros de consulta e conexão Oracle
Comece pelos detalhes
Falha na execução da consulta identifica o resultado da execução, seguido dos detalhes Oracle ou do serviço sem dados sensíveis, quando disponíveis. O SQL do editor é mantido. Não presuma que um erro genérico do serviço significa senha incorreta.
Casos comuns
Falhas de conexão
Use o host HTTPS configurado correto e o caminho do relatório. Um login Oracle bem-sucedido no navegador não autentica o conector BI Publisher. Não repita tentativas com credenciais rejeitadas a ponto de arriscar o bloqueio da conta.
Encaminhe com segurança
Compartilhe o código do erro, o horário, a plataforma e uma reprodução inofensiva. Nunca inclua valores de parâmetros nem credenciais em logs ou mensagens de suporte.
Solucione problemas de acesso à conta e cobrança
Identifique a restrição
- Aprovação pendente: a ativação foi concluída, mas a aprovação da organização ou do membro não.
- Avaliação encerrada ou já usada: assine ou peça ao superadministrador que analise uma exceção.
- Conta de avaliação ou paga na web: o espaço SQL está oculto. Baixe o Desktop; conta, cobrança e configurações permitidas da organização continuam disponíveis.
- Conta de avaliação no desktop: verifique aprovação, elegibilidade à avaliação e computador registrado.
- Limite de licenças: o administrador precisa reduzir usuários ou convites ou mudar o plano.
- Bloqueio de pagamento ou contestação: revise a cobrança web com o administrador da organização.
- Login em outro local: um login mais recente no mesmo tipo de cliente pode ter substituído a sessão. As sessões web e desktop são separadas.
Administrador com uma licença
O único titular pode ser o administrador do cliente e consome uma licença. O Desktop preserva essa função de cobrança enquanto oculta a administração. Use Gerenciar cobrança / faturas na web. Assinaturas ativas desativam novos Checkouts porque as alterações devem ser feitas no portal da assinatura existente.
Senha salva, mas login falha
Confira a URL e a porta exatas, a origem do servidor de contas, o estado da conta e qualquer etapa MFA. Uma senha salva não descarta sessão expirada, login substituído ou servidor incorreto. Não redefina uma senha apenas porque uma página está inacessível.
Erros de dispositivo e indisponibilidade
Outro computador registrado significa que a licença exige uma transferência com verificação de identidade em Segurança da conta na web. Autorização expirada significa reconectar ao SQL Hop e validar; reinstalar ou reabrir não prolonga o prazo. Um aviso de relógio retrocedido exige corrigir o horário antes da validação. Uma negação explícita da conta não é uma extensão de tolerância por indisponibilidade. Essas restrições não excluem o SQL salvo nem os resultados existentes.
Verifique a disponibilidade do serviço
Página de estado
Use Estado do serviço na tela de login ou no rodapé do site. Ela mostra o estado atual de manutenção do aplicativo e a mensagem de período planejado quando disponível.
Se a página não carregar
Verifique primeiro o endereço, a porta, a rede e o certificado. Uma página de estado servida pelo mesmo backend pode falhar durante uma indisponibilidade; uma página inacessível não comprova que tudo esteja funcionando.
O que ela não comprova
A disponibilidade do aplicativo não verifica todas as instâncias Oracle dos clientes, respostas OpenAI ou entregas de e-mail. Erros de conexão e consulta Oracle exigem suas próprias verificações.
Recuperação após manutenção
Após reiniciar o backend, o login pode ainda existir, mas as credenciais Oracle temporárias ou os instantâneos podem ter desaparecido. Reconecte e execute SQL inofensivo antes de retomar o trabalho.
Obtenha ajuda com as informações certas
Primeira verificação
Pesquise neste centro de ajuda pela ação ou pelo código de erro exato. Use os rótulos de plataforma e função para evitar seguir um fluxo de superadministrador como usuário comum. Confira Estado do serviço para manutenção.
Envie uma mensagem de suporte
Quando estiver conectado, abra Suporte na barra lateral, digite sua pergunta e selecione Enviar mensagem. Volte a Suporte para ler respostas; sua conversa fica salva. O suporte está disponível na web e no desktop. Apenas sua própria conversa é visível. As respostas são revisadas e enviadas pelo proprietário da plataforma; não são automáticas. Para acesso específico da organização, consulte primeiro o administrador da organização.
Use o formulário Contato do site para dúvidas antes do cadastro ou planos de equipe personalizados. Confirme seu e-mail antes de esperar o encaminhamento ao proprietário.
Inclua
- Web ou desktop e sistema operacional.
- A página ou ação da barra de ferramentas e o horário aproximado com fuso.
- O erro exato com segredos e dados privados removidos.
- Se um SELECT 1 FROM dual inofensivo funciona.
- Para cobrança, modo de teste ou real e estado visível, sem dados de pagamento.
Deixe de fora
Senhas, chaves de API, códigos MFA ou de recuperação, links de redefinição, arquivos de resultados de clientes e literais privados de consultas. Não ignore avisos de certificado nem desative a segurança para fazer uma reprodução de suporte funcionar.
Conclua o Cloudflare Turnstile antes de enviar uma solicitação. Se ele não carregar, use Tentar verificação novamente e permita challenges.cloudflare.com no navegador. A verificação expirada é atualizada; nenhum e-mail de confirmação é enviado quando a verificação do servidor falha. A etapa separada de confirmação por e-mail continua obrigatória antes de a solicitação chegar ao proprietário da plataforma.
Estado da conversa
Sua conversa de suporte pode estar Aberta, Aguardando usuário ou Resolvida. Respostas do suporte mudam o estado para Aguardando usuário. Mensagens resolvidas continuam salvas. Enviar outra mensagem reabre automaticamente a conversa para que o suporte possa ajudar novamente.
Referência de atalhos de teclado
O foco importa
Os atalhos se aplicam ao editor, campo de busca, aba de consulta ou divisor em foco. O Desktop usa convenções nativas do sistema. Um atalho de Substituir no painel de busca não deve executar SQL. Abra a ajuda pelo ponto de interrogação ou F1 no espaço de trabalho para consultar a mesma referência.
Área de consultas
Editor SQL
Navegação e resultados
Caixas de diálogo e ajuda
Publish desktop downloads
Prepare a release
- Open Desktop releases in the super-admin menu.
- Select the target platform. Enter a version such as 1.2.3 and release notes.
- Choose a .dmg, .pkg or .zip for Mac, or .exe, .msi or .zip for Windows. A Mac .app folder must be packaged as an installer or ZIP first. The maximum file size is 2 GiB.
- Select Upload release and wait for verification to finish. Uploading does not publish it.
- Review the entry and select Publish. It becomes the current download for that platform.
Gerenciar versions
Publishing a replacement retires the previous public link without deleting the stored installer. Edit notes changes the displayed notes. Withdraw removes the public download. Client admins and users cannot manage releases.
Visitor experience
Downloads detects Windows or Mac and shows the matching page. Visitors can switch platforms manually. If Mac processor architecture cannot be detected, both Intel and Apple Silicon options are shown. Version, notes, size and a SHA-256 checksum accompany each published file.
Storage
Published installers are uploaded to a private Cloudflare R2 bucket and checked before the release becomes current. Uploads stage on the server and retain local originals for recovery; customer download bodies come from R2. The website issues a 15-minute signed link after checking that the release is current. Withdrawal blocks new links; an already-issued link can work until expiry. Installer files saved by customers do not expire after 15 minutes. The database backup alone does not include installer files. Metadata downloads use a separate prefix in the downloads bucket; S3 backups use separate storage and credentials.
Baixe o instalador desktop correto
Abra Downloads no site ou siga Baixar SQL Hop Desktop após o login. Windows e Mac são detectados quando possível; troque de plataforma manualmente se necessário. No Mac, Sobre Este Mac mostra Chip para Apple Silicon ou Processador: Intel para hardware Intel. A detecção automática do sistema pode não identificar o processador.
Confira a versão
Cada plataforma publicada lista versão, notas da versão, tamanho e SHA-256. Uma plataforma sem versão publicada ainda não tem download. Escolha o arquivo correspondente ao sistema; um instalador para outro processador não é um caminho automático de atualização.
Links de download
Links privados assinados do R2 duram 15 minutos. Se um link expirar, volte a Downloads para obter outro. Um arquivo já salvo no computador continua sendo seu para guardar; essa expiração é diferente da de um arquivo temporário de exportação em segundo plano.
Instale e entre
Use uma conta SQL Hop de avaliação aprovada ou paga para a ativação online e depois conecte o Oracle separadamente. Atualizar um aplicativo não sincroniza automaticamente SQL salvo localmente entre computadores.
Registre ou substitua seu computador desktop
Um computador por usuário
O primeiro login online bem-sucedido no desktop registra uma chave pública criptográfica do dispositivo. Uma conta ou licença tem um registro. Registrar outro computador é rejeitado até o registro atual ser liberado. O SQL Hop não usa endereço MAC nem número de série do disco para esse registro.
Transfira para um substituto
- Entre no site e abra Segurança da conta.
- Verifique sua identidade usando a senha do aplicativo e um fator existente se habilitado.
- Localize Computador desktop registrado e escolha Transferir para outro computador.
- Confirme Liberar registro e entre online no Desktop no computador substituto.
Computador antigo
O dispositivo antigo é rejeitado na próxima validação. Se estiver offline, pode usar apenas a autorização já assinada, por no máximo 48 horas desde o último sucesso e nunca além da expiração conhecida da assinatura ou avaliação. A transferência não promete revogação offline imediata.
Proteja o trabalho local
SQL local, resultados e credenciais Oracle não são movidos automaticamente. Exporte arquivos SQL ou proteja um backup local autorizado antes de substituir um computador. Não exclua a pasta de dados do aplicativo como atalho para a transferência.
Validação diária e indisponibilidade do servidor de contas
Primeira ativação e verificações normais
A primeira ativação exige login online. Um computador registrado tenta validar na inicialização e a cada 24 horas enquanto o aplicativo permanece aberto. Operações locais repetidas não enviam uma solicitação de licença a cada poucos segundos. IA compartilhada, suporte, downloads de metadados e outros recursos online podem fazer suas próprias solicitações.
Servidor de contas indisponível
Uma falha de transporte ou falha temporária do servidor permite apenas a autorização assinada restante. A nova tentativa é agendada para 24 horas após uma falha de verificação; a inicialização também tenta validar. O acesso para em no máximo 48 horas desde o último sucesso ou no término conhecido da avaliação ou assinatura, o que ocorrer primeiro. Reabrir, reinstalar ou uma solicitação com falha não concede tempo extra. Lembrar é necessário para retomar automaticamente uma conta autorizada existente; logout explícito remove a autorização em cache.
Negação explícita
Uma resposta de bloqueio, revogação ou expiração interrompe novas consultas, novas conexões e exportações. SQL, resultados, filtros e seleções existentes continuam disponíveis. Uma validação online bem-sucedida ou novo login autorizado é necessário para retomar; uma falha de rede não limpa uma negação explícita anterior.
Outros serviços
Consultas Oracle ainda precisam de rede para o Oracle. A IA da organização precisa do serviço de contas e do provedor de IA; a IA pessoal precisa do provedor e de uma autorização permitida existente. A autorização offline não faz esses serviços funcionarem sem rede.
Relógio e permissões
Mantenha o relógio do computador correto. Um salto para trás pode bloquear a autorização até ser corrigido. Alterações de acesso do dispositivo, configuração de instância e permissões de IA pessoal podem levar até a próxima verificação para chegar a um dispositivo em execução. O período de indisponibilidade é uma autorização limitada, não uma garantia de disponibilidade.
Tour inicial e lembrete de download do desktop
Quando ele aparece
Uma conta elegível que não seja de superadministrador pode ver o tour de três etapas no primeiro login web, somente se a conta nunca tiver entrado antes. Contas que já entraram e logins no desktop não o iniciam automaticamente. O tour explica downloads, logins separados do SQL Hop e do Oracle e o gerenciamento web de conta e cobrança.
Exibição única
O SQL Hop registra a preferência da conta antes de abrir o tour. Fechar, Escape, Concluir, atualizar a página ou entrar novamente não faz o tour se repetir. Se a preferência não puder ser salva, o aplicativo não mostra um tour não registrado nem interrompe o login.
Reabra
Selecione Tour inicial na barra lateral da conta para reproduzi-lo manualmente. Isso não restaura a exibição automática. Links de download abrem separadamente para que a página da conta conectada continue disponível.