Parcourir la référence complète
La recherche et la navigation par thème nécessitent JavaScript. Le texte complet est disponible ci-dessous.
Premiers pas avec SQL Hop
Ce dont vous avez besoin
- Un compte SQL Hop activé dans une organisation approuvée, avec un essai actif admissible ou un abonnement payant.
- SQL Hop Desktop pour votre ordinateur et une connexion Internet pour la première activation.
- Une instance de votre organisation configurée par votre administrateur client, ainsi que vos propres identifiants Oracle autorisés.
Site web du compte et application de requêtes
Les comptes web ordinaires n'affichent pas l'espace SQL, les menus de requêtes enregistrées et d'historique ni les outils de requête. Les administrateurs d'organisation configurent toujours les instances et les membres sur le site web. L'éditeur web est conservé en vue d'une éventuelle activation explicite ; il n'est actuellement pas une option de requête pour les clients.
Première requête réussie
- Créez et activez votre compte, puis attendez l'approbation requise pour l'organisation ou l'invitation.
- Ouvrez Téléchargements et choisissez Windows, Mac Intel ou Mac Apple Silicon. Installez SQL Hop Desktop.
- Connectez-vous en ligne avec votre compte SQL Hop. Cela enregistre un ordinateur pour votre utilisateur ou votre place.
- Sélectionnez l'instance de votre organisation et connectez-vous avec vos identifiants Oracle.
- Exécutez le SQL sans risque ci-dessous. Un résultat réussi contient CONNECTION_OK = 1.
SQLSELECT 1 AS CONNECTION_OK
FROM dual
Poursuivre votre travail
Consultez les guides sur l'édition, le concepteur, les résultats et les exportations. Les requêtes enregistrées sur Desktop restent sur cet ordinateur ; le site web n'est pas une copie synchronisée de cette base de données locale.
Web, bureau et règles d'accès
Une organisation approuvée et admissible bénéficie d'un essai unique de 30 jours à compter de son approbation, pour un maximum de 10 utilisateurs, administrateurs et invitations en attente compris. Les requêtes d'essai s'exécutent dans SQL Hop Desktop.
Les utilisateurs payants exécutent également leurs requêtes dans Desktop. Le site web donne accès à la sécurité du compte, à l'abonnement, à la facturation et à l'assistance. Les administrateurs clients y configurent les membres, les instances et les accès à l'IA autorisés de leur organisation. Le site web client masque l'édition et l'exécution SQL, les requêtes enregistrées, l'historique et les outils de requête par IA. Le super administrateur conserve l'exécution web privilégiée.
Desktop envoie le SQL directement au service de rapports Oracle configuré. Les résultats, les requêtes locales, l'état du concepteur, l'historique et les tâches d'exportation restent sur l'ordinateur. L'IA facultative envoie le SQL et les instructions vérifiés à son service configuré, jamais les lignes de résultats. Les vérifications du compte, de l'appareil et de l'abonnement contactent SQL Hop.
La première activation nécessite une connexion en ligne. L'autorisation du bureau enregistré est vérifiée au démarrage et toutes les 24 heures tant que l'application est ouverte. Si le serveur de comptes est inaccessible, l'autorisation signée existante peut permettre le travail local pendant un maximum de 48 heures depuis la dernière validation réussie, sans dépasser la fin connue de l'essai ou de l'abonnement. Une réponse explicite indiquant un blocage, une expiration ou une révocation arrête les nouvelles requêtes et exportations. Un redémarrage ne réinitialise pas ce délai.
Le travail sur Desktop n'est pas automatiquement synchronisé avec le web ni avec un autre ordinateur. Les brouillons web et les requêtes enregistrées existants sont conservés ; le changement d'accès ne les migre ni ne les supprime. Utilisez l'importation et le téléchargement de fichiers SQL là où l'espace de travail est disponible. L'opérateur pourra réactiver explicitement l'exécution web lors d'un déploiement ultérieur.
Créer une organisation et activer votre compte
Créer un compte
- Sélectionnez Créer un compte sur le site web public.
- Saisissez les informations demandées sur l'organisation, le contact et le compte. Utilisez une boîte de réception que vous contrôlez.
- Ouvrez l'courriel d'activation et suivez son lien pour définir votre mot de passe.
- Attendez que le propriétaire de la plateforme approuve l'organisation.
Approbation et début de l'essai
L'activation prouve l'accès à la boîte de réception. Elle n'approuve pas une organisation. L'accès à l'espace de travail reste bloqué jusqu'à l'approbation du super administrateur. L'essai de 30 jours commence à l'approbation, pas à l'inscription ni à l'activation par courriel.
Comptes existants ou désactivés
Utilisez vos identifiants existants ou la réinitialisation du mot de passe plutôt que de créer un autre compte. Contactez l'administrateur de votre organisation si le compte est désactivé. Les nouvelles organisations ayant le même domaine professionnel ou la même instance Oracle peuvent s'abonner indépendamment ; l'utilisation antérieure de l'essai est néanmoins vérifiée pour chaque utilisateur.
Courriel non reçu
Vérifiez les courriels indésirables et l'adresse. Les liens expirés ou annulés doivent être remplacés. Pendant un déploiement d'courriels en environnement de test, le fournisseur d'envoi peut exiger une vérification du destinataire ; contactez le propriétaire de la plateforme plutôt que de réessayer à répétition.
Essais uniques et admissibilité
Droit à l'essai
L'essai de l'organisation dure 30 jours à compter de l'approbation et comprend jusqu'à 10 places. Les administrateurs et les invitations en attente comptent dans cette limite. Les requêtes d'essai s'exécutent dans SQL Hop Desktop.
Chaque utilisateur participant compte
L'utilisation de l'essai est suivie pour les utilisateurs, pas seulement pour l'administrateur fondateur. Devenir administrateur, créer une nouvelle organisation, annuler ou se réinscrire ne donne pas droit à un second essai. Inviter un utilisateur ayant déjà utilisé l'essai ne permet pas de répéter l'accès gratuit. Seul le super administrateur peut accorder une exception.
Équipes indépendantes
Partager un domaine de messagerie ou un serveur Oracle n'empêche pas à lui seul des équipes distinctes de s'abonner. Les vérifications d'identité liées à l'essai s'appliquent toujours à leurs utilisateurs individuels.
À l'expiration de l'essai
L'accès aux requêtes s'arrête ; les comptes et le SQL enregistré sont conservés. L'accès au compte et à la facturation reste disponible sur le web pour permettre à l'organisation de s'abonner. Une fois l'essai terminé, les requêtes sur bureau nécessitent un abonnement payant actif.
Appareil de bureau et validation
Chaque utilisateur nommé dispose d'un ordinateur enregistré. Activez-le en ligne dans SQL Hop Desktop. La validation s'effectue au démarrage et toutes les 24 heures tant que l'application est ouverte. Si le serveur de comptes est indisponible, l'autorisation signée existante permet le travail local pendant un maximum de 48 heures depuis la dernière validation réussie, dans la limite de la fin connue de l'essai ou de l'abonnement. Une réponse explicite indiquant un blocage, une révocation ou une expiration arrête les nouvelles requêtes et exportations. Le SQL et les résultats existants sont conservés. Un redémarrage ne prolonge jamais l'autorisation.
Remplacer un ordinateur
Sur le site web, ouvrez Sécurité du compte, vérifiez votre identité avec votre mot de passe et un facteur existant, puis sélectionnez Transférer vers un autre ordinateur. Connectez-vous sur le nouvel ordinateur. L'ancien ordinateur ne peut continuer que jusqu'à sa prochaine validation ou à l'échéance signée existante.
Connexion, déconnexion et remplacement de session
Se connecter
Utilisez votre courriel et votre mot de passe SQL Hop, pas vos identifiants Oracle. Effectuez toute étape MFA configurée. Desktop propose les méthodes de vérification enregistrées sur votre compte : code d'authentification, code de récupération ou clé de sécurité/clé d'accès. La vérification par clé de sécurité ouvre une fenêtre sécurisée temporaire pour le nom d'hôte SQL Hop enregistré.
Sessions web et bureau
Les sessions web et bureau sont distinctes. Une connexion au site web ne met pas à elle seule fin à l'autorisation du bureau. Une nouvelle connexion sur le même type de client peut remplacer sa session précédente ; les changements de mot de passe, de facteur ou de compte peuvent invalider l'accès. Un ordinateur enregistré est autorisé par utilisateur ou place.
Visite guidée du web
Un nouveau compte admissible peut recevoir une visite en trois étapes lors de sa première connexion web. Les comptes existants, les connexions sur bureau et le super administrateur ne la déclenchent pas automatiquement. La préférence du compte est enregistrée avant l'affichage de la visite : la fermer, la terminer ou actualiser la page ne la fait donc pas réapparaître. Visite de démarrage dans la barre latérale la rouvre manuellement sans rétablir l'affichage automatique.
Se déconnecter
Utilisez l'icône de porte avec flèche dans la barre supérieure. La déconnexion web ramène à la page d'accueil. La déconnexion sur bureau supprime les cookies actifs et l'autorisation en cache, mais conserve les identifiants chiffrés de l'application enregistrés avec votre accord. Utilisez Se connecter avec les identifiants enregistrés de l'application pour une nouvelle connexion en ligne ; Oublier les identifiants enregistrés supprime ces identifiants.
Inactivité
Tous les comptes web, y compris le super administrateur, sont déconnectés après dix minutes d’inactivité et nécessitent une nouvelle connexion après huit heures. Les vérifications de session en arrière-plan ne prolongent pas ces délais. Le super administrateur reste exempté de la déconnexion pour inactivité dans l’application de bureau. Les comptes de bureau ordinaires reçoivent un avertissement de 30 secondes avant l'expiration pour inactivité ; Prolonger ajoute cinq minutes, y compris pour les prolongations suivantes. Ignorer l'avertissement met fin à la session. La déconnexion explicite, la révocation et les restrictions du compte s'appliquent toujours. Les règles d'inactivité sont distinctes de la vérification de l'appareil toutes les 24 heures et ne prolongent pas l'autorisation hors ligne.
Activer ou réinitialiser le mot de passe de l'application
Réinitialiser un mot de passe
- Sélectionnez Mot de passe oublié sur la page de connexion web.
- Saisissez l'courriel de votre compte et envoyez la demande.
- Ouvrez le dernier courriel de réinitialisation et utilisez son lien.
- Saisissez et confirmez un mot de passe respectant les exigences du formulaire.
- Revenez à la connexion et utilisez le nouveau mot de passe.
Erreurs de lien
Les liens de réinitialisation et d'activation expirent et sont à usage unique. Les anciens liens peuvent devenir invalides après une nouvelle demande. Ne les transférez pas et ne les collez pas dans un message d'assistance. Demandez un nouveau lien si nécessaire.
Organisations en attente
La réinitialisation du mot de passe peut fonctionner avant l'approbation de l'organisation. Elle ne contourne pas l'exigence d'approbation et ne lance pas un nouvel essai. Les réinitialisations réussies sont consignées dans le journal d'audit.
Deux identités distinctes
Réinitialiser le mot de passe de l'application ne réinitialise pas les identifiants Oracle et ne supprime pas l'authentification à deux facteurs. Contactez l'administrateur concerné pour ces changements.
Codes d'authentification, clés physiques et codes de récupération
Ouvrir la sécurité du compte sur le web
Utilisez Sécurité du compte dans la navigation ou l'icône de compte en haut. Avant d'effectuer des changements, vérifiez votre mot de passe actuel de l'application et un facteur existant si nécessaire. La période d'accès vérifié aux paramètres de sécurité est temporaire.
Application d'authentification
Choisissez Configurer une application d'authentification, scannez le code QR avec l'application de votre choix et saisissez son code actuel à six chiffres. Confirmez la configuration avant de vous y fier.
Clé de sécurité physique
Enregistrer une clé de sécurité physique demande une clé USB/NFC externe. Choisissez la clé physique dans l'invite du navigateur, puis effectuez la demande de PIN ou de contact. Une clé d'accès de plateforme stockée sur l'ordinateur est différente d'une clé physique. La prise en charge du navigateur et la politique de l'appareil peuvent influer sur l'invite.
Codes de récupération
Générez des codes et conservez-les en sécurité hors de l'application. Chacun est utilisable une seule fois. Générer un autre jeu invalide le précédent. N'envoyez jamais de codes de récupération à l'assistance.
Bureau et noms d'hôte
Desktop affiche les méthodes de vérification enregistrées disponibles pour le compte. Choisissez Clé de sécurité / clé d'accès pour ouvrir sa fenêtre temporaire de vérification HTTPS ; effectuez la demande de clé du navigateur et laissez l'application terminer la connexion. Les clés WebAuthn appartiennent au nom d'hôte sur lequel elles ont été enregistrées. Une adresse IP numérique de réseau local ne convient pas à la configuration actuelle de clé physique ; utilisez le nom d'hôte approuvé indiqué dans Sécurité du compte. Ne contournez pas les avertissements de certificat.
Accès perdu
Un administrateur d'organisation autorisé ou un super administrateur peut réinitialiser les facteurs enregistrés dans le périmètre de comptes qui lui est permis après avoir vérifié la demande et sa propre identité. L'utilisateur doit s'inscrire de nouveau ; réinitialiser un facteur ne modifie pas l'authentification Oracle.
Mémoriser les identifiants de l'application et d'Oracle
Mémoriser le compte de l'application
Sélectionnez Mémoriser ma connexion à l'application et maintenir ma connexion sur cet ordinateur lors de la connexion sur bureau. Le serveur de comptes, le nom d'utilisateur, le mot de passe et la session enregistrée sont chiffrés avec la protection du système d'exploitation. Au redémarrage, Mémoriser peut reprendre un compte déjà enregistré à l'aide de l'autorisation signée de l'appareil après une tentative de validation en ligne. Si le serveur de comptes est indisponible, seul le délai de grâce autorisé restant s'applique. Sinon, utilisez Se connecter avec les identifiants enregistrés de l'application et effectuez une nouvelle vérification MFA si nécessaire. Une déconnexion explicite supprime l'autorisation en cache ; elle ne crée pas de connexion hors ligne.
Mémoriser Oracle séparément
Dans le formulaire de connexion Oracle, sélectionnez Mémoriser les identifiants Oracle sur cet ordinateur avant une connexion réussie. La prochaine fois, utilisez Se connecter avec les identifiants enregistrés. Les champs de mot de passe peuvent rester volontairement vides ; cela ne signifie pas que l'entrée chiffrée manque. La case à cocher reflète l'existence d'une entrée enregistrée.
Suppression et isolation
Oublier les identifiants enregistrés supprime ceux de l'application. La déconnexion explicite sur bureau met fin à la session et supprime ses cookies de session enregistrés, mais conserve le nom d'utilisateur et le mot de passe chiffrés enregistrés avec votre accord pour une nouvelle connexion. L'expiration pour inactivité met fin à la session sans supprimer ses identifiants chiffrés de l'application. Déconnecter Oracle efface la connexion active ; Oublier les identifiants enregistrés d'Oracle supprime son entrée enregistrée. L'enregistrement est indisponible si le chiffrement protégé du système est indisponible.
Périmètre
Les entrées Oracle sont isolées selon le compte de l'application, l'adresse du serveur de comptes, l'instance et les paramètres du rapport. Un autre compte de l'application ou une configuration d'instance modifiée ne réutilise pas une autre entrée. Une connexion via localhost plutôt qu'une URL du réseau local peut sélectionner un autre périmètre de compte local.
Résolution des problèmes
Utilisez la même application empaquetée et la même URL de serveur de comptes. Après une mise à jour, rouvrez vous-même l'application reconstruite. Si une version antérieure a supprimé une entrée enregistrée, saisissez-la une fois et sélectionnez Mémoriser. Le stockage chiffré par le système ne garantit pas qu'une personne contrôlant votre ordinateur connecté ne puisse jamais accéder aux secrets.
Ouvrir et mettre à jour SQL Hop Desktop
Télécharger et activer
- Ouvrez Téléchargements sur le site web. La détection du système recommande Windows ou Mac ; choisissez Intel ou Apple Silicon sur Mac si l'architecture ne peut pas être détectée.
- Consultez la version, les notes de version, la taille du fichier et la somme de contrôle SHA-256. Seuls les installateurs publiés sont proposés.
- Installez et ouvrez SQL Hop Desktop. L'application se connecte automatiquement à https://sqlhop.com. Aucune URL de serveur de comptes n'est à saisir. L'instance Oracle est configurée séparément par l'administrateur de votre organisation.
- Connectez-vous avec un compte SQL Hop disposant d'un essai actif approuvé ou d'un abonnement payant et effectuez la MFA prise en charge. La première activation en ligne enregistre cet ordinateur pour votre place.
- Choisissez l'instance Oracle configurée par l'administrateur et connectez-vous avec vos propres identifiants Oracle.
Mise à jour
Aide → Rechercher des mises à jour…
Installez la version publiée correspondant à votre plateforme et rouvrez-la vous-même. Une mise à jour du site web ne met pas à jour un exécutable de bureau déjà lancé. Conservez le répertoire de données de l'application, qui contient le travail local et les identifiants chiffrés. L'écran de démarrage affiche la version ; À propos de SQL Hop affiche aussi la date de compilation.
Travail local et autorisation
Les requêtes enregistrées, l'état du concepteur, les brouillons, les instantanés de résultats, l'historique, les exportations et les métadonnées téléchargées sont locaux. L'autorisation signée de l'appareil permet une interruption limitée du serveur de comptes, pas un usage hors ligne illimité. Oracle et l'IA ont toujours besoin de leurs services réseau respectifs.
Administration
La sécurité du compte, le transfert d'appareil, l'administration de l'organisation et la facturation se gèrent sur le site web. Desktop ne possède pas de console d'administration.
HTTPS, tests locaux et adresses du serveur de comptes
Connexion au bureau en production
SQL Hop Desktop se connecte automatiquement à https://sqlhop.com. L'écran de connexion ne demande pas d'URL de serveur. L'adresse de votre instance Oracle est un paramètre distinct de l'organisation, géré par votre administrateur.
Développement web local
Sur l'ordinateur serveur
localhost et 127.0.0.1 désignent cet ordinateur. Un autre appareil Windows ou Mac ne peut pas les utiliser pour joindre votre serveur.
Sur un réseau domestique
Utilisez l'adresse HTTPS fournie par l'opérateur, avec son port. L'exemple de développement est https://192.168.86.20:8443. L'adresse peut changer selon le réseau. Suivez les instructions de configuration du certificat pour cet appareil et contactez l'opérateur si la confiance n'est pas configurée.
Distinguer les échecs
- Site inaccessible : vérifiez l'état du serveur, l'adresse, le port, le réseau et le pare-feu.
- Avertissement de certificat : la configuration de confiance ou du nom d'hôte est incomplète. N'envoyez pas d'identifiants via une connexion non approuvée.
- Restriction de connexion distante Oracle : utilisez la passerelle HTTPS configurée plutôt que le port de développement HTTP.
- Domaine invalide lors de l'enregistrement d'une clé : les paramètres d'origine des clés physiques/WebAuthn exigent un nom d'hôte pris en charge ; ceci est distinct de la connexion normale par mot de passe.
Périmètre stable du compte de bureau
Conservez la même URL HTTPS de serveur de comptes pour un profil local. Changer d'origine de serveur crée un périmètre de compte distinct et peut donner l'impression que le travail local enregistré ou les identifiants Oracle sont absents.
Connecter et déconnecter Oracle
Se connecter
- Dans l'espace de travail, choisissez l'instance configurée.
- Sélectionnez Connecter. Si vous appuyez sur Exécuter sans être connecté, SQL Hop ouvre le formulaire et mémorise cette demande d'exécution.
- Saisissez le nom d'utilisateur et le mot de passe Oracle, puis sélectionnez Connecter ou Vérifier et connecter.
- Attendez la vérification QueryRunner d'une ligne. Les champs sont désactivés pendant la requête.
- Un indicateur de connexion vert confirme la connexion active. Une exécution en attente se poursuit après la réussite uniquement si l'onglet, le SQL et la sélection concernés n'ont pas changé.
Gestion des identifiants
Pour l'exécution web du super administrateur uniquement, les identifiants Oracle sont conservés temporairement dans la session du serveur connecté, pendant un maximum de 30 minutes, et ne sont pas enregistrés dans notre base de données, nos fichiers ou le stockage du navigateur. Les identifiants de bureau restent sur l'ordinateur et peuvent facultativement être enregistrés avec le chiffrement du système. Ne saisissez jamais les identifiants de l'application dans le formulaire Oracle.
Se déconnecter
Utilisez le bouton de prise connectée ou déconnectée. Déconnecter ou se déconnecter de l'application efface la connexion active. Une connexion de bureau est indépendante d'un redémarrage du serveur de comptes. Reconnectez-vous si la connexion Oracle locale expire ou est interrompue ; les connexions web du super administrateur doivent être rétablies après un redémarrage du serveur. L'état de connexion appartient à votre session ; la connexion d'un autre utilisateur ne vous authentifie pas.
Limites
Les comptes d'essai et payants se connectent dans SQL Hop Desktop. Aucun cookie SSO Oracle existant du navigateur n'est réutilisé. Un échec de vérification Oracle ne doit pas être considéré comme une connexion réussie.
Configurer automatiquement les objets Oracle de SQL Hop
Prérequis
Utilisez un administrateur Oracle ou un développeur de rapports autorisé disposant des permissions de création dans le catalogue, de modèle de données et d'exécution de rapports. SQL Hop ne peut pas accorder de permissions Oracle ni corriger une politique d'identité Oracle. Configurez la bonne instance HTTPS et le bon référentiel de données Oracle avant la configuration.
Configuration automatique
- Sur le site web, ouvrez Environnements et choisissez l'action de configuration de l'instance. Un administrateur d'organisation peut aussi choisir la configuration automatique des objets SQL Hop manquants dans le formulaire de connexion Oracle de bureau.
- Vérifiez les chemins de modèle de données et de rapport affichés. Les valeurs par défaut de la marque sont /Custom/SQLHop.com/SQLHop_DM.xdm et /Custom/SQLHop.com/SQLHop_Report.xdo. Un ancien profil existant peut encore utiliser /Custom/QueryTool/QueryRunner.xdo ; ne changez pas les chemins involontairement.
- Confirmez le référentiel de données Oracle, généralement ApplicationDB_FSCM, et fournissez votre nom d'utilisateur et votre mot de passe Oracle autorisés pour l'opération.
- Lancez la configuration et attendez que SQL Hop crée les objets manquants et vérifie le rapport avec CONNECTION_OK = 1. Le simple fait de voir des objets dans le catalogue Oracle ne constitue pas une vérification d'exécution réussie.
- Après la vérification, fermez la boîte de dialogue de réussite et connectez-vous à l'instance avant d'exécuter des requêtes. Une configuration vérifiée ne crée pas à elle seule une connexion active pour les requêtes.
Configuration en attente et réparation
Si Oracle traite peut-être encore une demande de création, utilisez Vérifier l'état de la configuration au lieu d'envoyer des demandes en double. Réparer ne modifie qu'un modèle correspondant généré par SQL Hop et en fait d'abord une sauvegarde ; les modèles existants sans rapport ne sont pas remplacés. Utilisez l'action de réparation affichée si SQL Hop détecte un problème de correspondance de sortie.
Solution manuelle de repli
Utilisez le guide de configuration manuelle uniquement si la configuration automatique est indisponible ou si votre administrateur Oracle l'exige. Installez la définition actuelle complète de SQLHop_DM avec xdo_cursor et p_sql_base64, la bonne correspondance de sortie et le rapport associé. Collez le SQL dans le jeu de données du modèle de données, pas dans la mise en page du rapport ni dans un paquet de base de données. Un ZIP source n'est pas automatiquement une archive importable dans le catalogue Oracle.
Compatibilité des versions et permissions
Les anciennes définitions de modèle peuvent limiter les résultats à 200 lignes, restreindre les commentaires ou rejeter les SQL plus longs. Les exportations en arrière-plan nécessitent aussi l'accès au téléchargement de fragments de rapport. Un rapport qui fonctionne dans l'éditeur Oracle seul ne prouve pas que l'identifiant du service peut l'exécuter et le télécharger. Les identifiants de configuration servent à cette opération ; les identifiants facultatifs de connexion de bureau chiffrés sont gérés séparément.
Application et objets Oracle
Supprimer une instance dans SQL Hop supprime la configuration de l'application, pas les rapports Oracle ni les requêtes enregistrées. Les objets existants sont conservés lors du passage à un emplacement de catalogue vérifié portant la marque. Testez la configuration sur DEV avant d'utiliser un autre environnement.
Gérer organization instances
Table 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
Table 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 Oracle et authentification prise en charge
Fonctionnement actuellement pris en charge
Les utilisateurs d'essai et payants utilisent la connexion Oracle existante par nom d'utilisateur et mot de passe dans Desktop ; le super administrateur peut aussi utiliser le connecteur web conservé. La connexion à SQL Hop et ses paramètres à deux facteurs protègent le compte de l'application ; ils ne mettent pas en œuvre le SSO Oracle.
Le SSO du navigateur est distinct
Un bouton de connexion Oracle peut rediriger vers Microsoft, mais une session de navigateur ou un jeton d'identité n'autorise pas automatiquement le service BI Publisher. SQL Hop ne copie pas les cookies Oracle du navigateur.
Fonctionnalités différées
Le SSO Oracle général pour l'exécution des requêtes reste différé. Le plan d'exécution possède sa propre fenêtre de connexion Oracle sur bureau lorsque le service natif de plans l'exige ; cela n'authentifie pas la connexion QueryRunner et ne copie pas les cookies Safari. Le SSO réel du locataire nécessite toujours une vérification de connexion en direct. Le SSO Microsoft pour la connexion à SQL Hop n'est pas non plus activé en remplacement de la connexion actuelle par mot de passe. Ne supposez pas que les identifiants Office 365 fonctionneront dans la connexion Oracle directe, sauf si l'administrateur Oracle prend explicitement ce fonctionnement en charge.
Si l'authentification directe échoue
Demandez à l'administrateur Oracle quelle identité de service et quelle politique d'authentification permettent d'exécuter le rapport configuré. Ne désactivez pas la MFA et ne réutilisez pas les cookies du navigateur pour contourner le problème.
Écrire du SQL et organiser l'espace de travail
Disposition
L'éditeur SQL et les résultats occupent la hauteur restante de la fenêtre. Faites glisser le séparateur horizontal pour modifier leurs proportions. Placez le focus sur le séparateur et utilisez les flèches pour le redimensionner au clavier ; un double-clic le réinitialise. Agrandissez l'un des volets pour disposer de plus de place, puis restaurez-le ou appuyez sur Escape.
Utilisez les icônes de la barre d'outils pour Exécuter, Tout exécuter, Plan d'exécution, Arrêter, Annuler, Rétablir, mettre la sélection en majuscules ou minuscules, modifier la taille de police, Rechercher et remplacer, Formater le SQL, le concepteur, Colonnes, Décrire, Enregistrer, importer ou télécharger du SQL, Tout enregistrer, Enregistrer sous et l'IA autorisée. Survolez une icône ou placez-y le focus pour afficher son libellé.
Résultats existants
Modifier le texte de l'éditeur, le formater ou appliquer ou annuler une proposition d'IA conserve les résultats actuels jusqu'à ce qu'une autre exécution les remplace. Les résultats visibles peuvent donc provenir d'un SQL antérieur. Les exportations utilisent l'instantané du SQL exécuté lorsqu'il est disponible.
Navigation adaptative
Dans les fenêtres plus étroites, utilisez le bouton du menu de navigation. Ouvrez-le pour accéder aux pages du compte et de l'espace de travail ; fermez-le avec Escape, l'arrière-plan ou un lien de navigation. Desktop utilise la même apparence d'espace de travail avec les conventions de raccourcis du système d'exploitation.
Onglets de requête et restauration de l'espace de travail
Ajouter et renommer
Utilisez le bouton plus pour créer un onglet. Les noms sont uniques dans l'espace de travail. Double-cliquez sur le nom d'un onglet ou utilisez Renommer l'onglet pour le modifier. Les numéros affichés pour les requêtes enregistrées sont propres à chaque utilisateur et commencent à 1 ; les identifiants internes de base de données sont distincts.
Jusqu'à 100 onglets
L'espace de travail prend en charge jusqu'à 100 onglets ouverts, y compris pour Tout enregistrer et les espaces restaurés. Faites défiler la barre d'onglets si nécessaire ; le bouton plus reste accessible. Fermez les onglets devenus inutiles. Une confirmation d'abandon apparaît pour les modifications SQL ou du concepteur non enregistrées.
Restauration
Les brouillons web sont enregistrés dans le compte connecté ; les brouillons de bureau sont enregistrés dans son espace local propre au compte. Le SQL des onglets et les données du concepteur peuvent être restaurés à la réouverture. Les instantanés temporaires de résultats et les valeurs de paramètres ne sont pas des sauvegardes permanentes de l'espace de travail. Utilisez Enregistrer pour les requêtes nommées et exportez les résultats à conserver.
Résultats indépendants
Les onglets conservent leur propre état de requête et de résultats. Tout exécuter ajoute des onglets de jeux de résultats à l'intérieur de l'onglet de requête actuel. Ne les confondez pas avec les onglets de requête principaux.
Enregistrer, Enregistrer sous et Tout enregistrer
Enregistrer
L'icône d'enregistrement et Ctrl+S / Cmd+S font la même chose. Si l'onglet est lié à une requête enregistrée, Enregistrer la met directement à jour. Pour une nouvelle requête, une boîte de dialogue s'ouvre avec le nom de l'onglet prérempli. L'enregistrement conserve les marqueurs SQL et l'état du concepteur ; les valeurs des paramètres ne sont pas enregistrées.
Enregistrer sous
Utilisez Enregistrer sous ou Ctrl+Shift+S / Cmd+Shift+S pour créer une autre requête nommée. L'onglet actuel est lié à la nouvelle copie. L'original reste inchangé et son état de concepteur est indépendant.
Tout enregistrer
Tout enregistrer sauvegarde tous les onglets non vides avec leurs noms, en mettant à jour les requêtes liées et en en créant de nouvelles au besoin. Les modifications du concepteur seul sont incluses même si vous n'avez pas généré de nouveau SQL. Utilisez Ctrl+Alt+S sous Windows/Linux ou Cmd+Option+S sur Mac.
Réouverture
Ouvrez une requête enregistrée depuis Requêtes enregistrées. Son concepteur peut être restauré pour l'édition. Si une requête enregistrée liée a été supprimée ou est indisponible, conservez le SQL de l'éditeur et enregistrez une nouvelle copie plutôt que d'abandonner votre travail. Les enregistrements de bureau restent locaux ; ceux du web appartiennent au compte web.
Dossiers des requêtes enregistrées
- Ouvrez Requêtes enregistrées pour créer ou renommer un dossier. Cliquez sur son en-tête pour le développer ou le réduire. La recherche porte sur les numéros, les noms et le SQL des requêtes dans tous les dossiers, y compris les dossiers réduits.
- Utilisez Déplacer vers, à côté d’une requête, pour choisir un dossier ou Non classées. Les requêtes existantes et celles que vous enregistrez pour la première fois sont placées dans Non classées; la mise à jour d’une requête enregistrée conserve son dossier. Les dossiers sont privés. Les dossiers et le SQL enregistrés dans l’application de bureau restent sur votre ordinateur et sont distincts des requêtes enregistrées sur le Web.
- La suppression d’un dossier déplace ses requêtes vers Non classées et conserve leur SQL ainsi que leurs numéros de requête.
Ouvrir et télécharger des fichiers SQL
Importer
Utilisez Ouvrir un fichier SQL et sélectionnez un fichier .sql. Son contenu s'ouvre dans un onglet d'éditeur sans être exécuté. Vérifiez le texte et les éventuels messages de syntaxe locaux avant l'exécution. Des autorisations du sélecteur de fichiers du navigateur ou du système peuvent être nécessaires.
Télécharger
Utilisez Télécharger le fichier SQL pour enregistrer le contenu de l'éditeur au format .sql. Cela exporte le SQL, pas les lignes de résultats ni les valeurs de paramètres enregistrées. Un fichier texte ne contient pas l'état modifiable complet du concepteur visuel.
Téléchargez le SQL depuis l'espace de travail source et ouvrez-le à destination. Les requêtes enregistrées sur le web et celles enregistrées localement sur bureau sont distinctes. Importer un fichier ne donne pas accès à Oracle et ne vous connecte pas.
Si le sélecteur ne s'ouvre pas
Vérifiez si un autre sélecteur de fichiers ou une fenêtre modale est déjà ouvert. Sur bureau, utilisez l'application empaquetée reconstruite et son action native d'ouverture de fichier. Ne collez pas d'identifiants dans un fichier SQL pour contourner un problème de connexion.
Formatage, casse, taille de police et annulation
Utilisez Formater le SQL à côté de Formatage automatique à l'exécution. Le formatage manuel modifie uniquement le texte de l'éditeur ; activer le formatage automatique l'applique pendant l'exécution. L'alignement des clauses suit le style SQL Hop. ORDER BY fait exception pour l'alignement.
Sélectionnez du texte pour activer les outils majuscules et minuscules. Utilisez Ctrl/Cmd+Shift+U ou Ctrl/Cmd+Shift+L. La conversion de casse affecte le texte sélectionné, y compris les littéraux sélectionnés ; vérifiez avant d'exécuter.
Utilisez A− et A+ pour régler la taille du texte de l'éditeur. L'éditeur SQL utilise une police à chasse fixe pour aligner les colonnes et l'indentation. Le zoom du navigateur affecte aussi le reste de l'interface.
Annuler revient sur les modifications de l'éditeur, y compris les remplacements globaux et le SQL d'IA appliqué. Rétablir les applique de nouveau. Ces actions n'exécutent pas de SQL et n'effacent pas un jeu de résultats existant. Les raccourcis standard du système sont indiqués dans Raccourcis clavier.
Ouvrez l'icône de réglages à côté de Formater le SQL pour personnaliser la casse des mots-clés, tables/vues, alias, fonctions et types de données ; l'alignement des clauses ; la taille de l'indentation ou les tabulations ; les retours à la ligne des expressions ; les sauts de ligne AND/OR ; l'espacement des instructions ; l'espacement des opérateurs ; et la position des points-virgules. Prévisualisez les changements avant de les enregistrer. Les préférences sont mémorisées pour votre compte sur cet appareil et s'appliquent au formatage manuel et au formatage automatique à l'exécution. Enregistrer les préférences ne modifie ni n'exécute le SQL de l'éditeur. Rétablir les valeurs par défaut remet l'aperçu au style SQL Hop ; sélectionnez Enregistrer les préférences pour conserver cette réinitialisation. Le style par défaut utilise des mots-clés SQL et noms de fonctions en majuscules, et des noms de tables/vues et alias non délimités en minuscules. Les identifiants délimités, noms de colonnes, littéraux et noms de paramètres conservent leur casse. Utilisez Annuler après le formatage pour restaurer le SQL d'origine.
Rechercher et remplacer dans le SQL
Ouvrir le panneau combiné
Utilisez l'icône unique Rechercher et remplacer. Ctrl+F / Cmd+F ouvre la recherche ; Ctrl+H ou Cmd+Option+F ouvre le remplacement. Saisissez le texte à rechercher et, si nécessaire, le remplacement.
Parcourir les occurrences
Utilisez les commandes suivante et précédente, F3/Shift+F3 si pris en charge, ou Ctrl/Cmd+G et sa variante avec Shift. Dans le champ de recherche, Enter et Shift+Enter passent d'une occurrence à l'autre. Vérifiez les options de correspondance disponibles avant de remplacer.
Remplacer
Lorsqu'un champ du panneau de recherche a le focus, Ctrl/Cmd+Enter remplace l'occurrence suivante. Ctrl+Alt+Enter sous Windows/Linux ou Cmd+Option+Enter sur Mac remplace tout. Ces raccourcis n'exécutent pas de SQL depuis le panneau de recherche. Annuler peut restaurer un remplacement global.
Fermer
Appuyez sur Escape pour fermer le panneau et rendre le focus à l'éditeur. Les résultats de requête existants restent visibles.
Vérifications SQL en temps réel et autocomplétion
Retour grammatical local
L'éditeur vérifie le SQL de style Oracle pendant la saisie, y compris les jointures, sous-requêtes et CTE. Corriger le SQL efface le diagnostic après la vérification suivante. La vérification locale n'exécute pas la requête, ne contacte pas Oracle et n'efface pas les résultats.
Oracle reste la référence
Les vérifications grammaticales locales sont indicatives et ne bloquent pas l'exécution. Une syntaxe Oracle valide propre à une version peut dépasser la grammaire locale. L'existence des objets, les permissions, les règles de types, la sémantique des paramètres et les plans d'exécution doivent toujours être validés par Oracle. Un statut local vert ne garantit pas une exécution réussie.
Suggestions
Table Utilisez Ctrl+Space pour demander des suggestions. Les suggestions de tables utilisent les métadonnées disponibles. Après avoir déclaré les alias de dans FROM/JOIN, saisissez alias. pour demander les colonnes de cette table, y compris dans la liste SELECT. Toutes les colonnes ne sont pas insérées ou chargées automatiquement dans le SQL.
Suggestions manquantes
Vérifiez l'orthographe de la table, la déclaration d'alias et la publication de métadonnées choisie. Desktop nécessite le téléchargement et l'activation de son paquet facultatif d'autocomplétion. Décrire et Colonnes dépendent des métadonnées importées, sans garantie d'introspection du schéma en direct.
Exécuter une requête, récupérer des lignes et arrêter l'attente
Exécuter
Exécuter lance le SQL sélectionné lorsque l'éditeur contient une sélection ; sinon, il exécute l'unique instruction de l'éditeur. Le raccourci est Ctrl+Enter / Cmd+Enter. En présence de plusieurs instructions, l'application vous invite à utiliser Tout exécuter plutôt que d'envoyer un script entier comme une seule requête.
Lignes à récupérer
Lignes à récupérer est le nombre maximal de lignes collectées pour l'exécution, actuellement proposé jusqu'à 10,000 pour l'utilisation interactive. Ce paramètre est distinct de Lignes par page, qui modifie seulement le nombre de lignes déjà récupérées affichées simultanément. Votre dernier réglage de récupération est mémorisé.
Pendant l'exécution
L'indicateur et le chronomètre continuent pendant l'exécution Oracle, la récupération et le premier affichage. Le chronomètre s'arrête lorsque les données sont présentées. Le temps de saisie des paramètres est exclu. Les requêtes Oracle s'exécutent localement dans SQL Hop Desktop.
Arrêter
Utilisez Arrêter à côté d'Exécuter pour annuler l'attente dans l'application. Une demande en file d'attente peut être retirée avant de contacter Oracle. Pour une demande déjà envoyée, l'exécution dans la base Oracle peut continuer ; Arrêter ne garantit pas l'arrêt dans la base.
En cas d'échec
Lisez les détails de l'erreur. Le SQL reste dans l'éditeur. Une exécution échouée n'affiche pas les lignes de résultats précédentes comme s'il s'agissait du nouveau résultat.
Générer un plan d'exécution Oracle
Générer un plan
- Connectez-vous à l'environnement Oracle voulu.
- Sélectionnez une requête SELECT ou WITH, ou laissez une seule instruction dans l'éditeur.
- Choisissez Plan d'exécution dans la barre d'outils SQL.
- Saisissez les valeurs typées des paramètres demandés.
- Si une fenêtre de connexion Oracle apparaît, connectez-vous avec le compte Oracle voulu. Le plan s'ouvre automatiquement après la connexion.
Aucun copier-coller ni importation de fichier téléchargé n'est nécessaire. Plan d'exécution n'exécute pas la requête sélectionnée pour obtenir des lignes de résultats. Les résultats existants et le SQL de l'éditeur restent disponibles.
Lire le plan
Développez ou réduisez les opérations pour examiner l'arborescence, les lignes estimées, le coût, les objets, les prédicats et les notes Oracle. Le coût est une estimation de l'optimiseur, pas une durée en secondes ; les coûts parents incluent déjà le travail des enfants. Ce sont des plans estimés, pas des statistiques d'exécution mesurées.
Comparer et télécharger
Choisissez Utiliser comme référence de comparaison pour comparer un autre plan dans la même visionneuse. Comparez le même SQL et les mêmes valeurs de paramètres ; un coût estimé inférieur ne prouve pas à lui seul qu'une requête est plus rapide. Télécharger le plan enregistre le texte original du plan Oracle.
Accès Oracle et connexion
SQL Hop utilise le service natif Generate Explain Plan d'Oracle et le référentiel de données du rapport configuré. Il ne crée pas de rapport de plan d'exécution distinct. La session de connexion sur bureau est séparée de Safari et effacée lors d'une déconnexion Oracle, d'une reconnexion, d'une déconnexion du compte ou de l'expiration de la connexion. Reconnectez-vous lorsque cela est demandé. Ce fonctionnement de connexion concerne le plan d'exécution ; l'exécution normale des requêtes utilise toujours la connexion Oracle existante.
Disponibilité et résolution des problèmes
Les instructions multiples et les blocs PL/SQL sont rejetés. Le service natif et la politique d'authentification dépendent de votre instance Oracle. La demande native authentifiée et le plan sans risque SELECT 1 FROM DUAL ont été vérifiés ; le fonctionnement réel du SSO du locataire sur bureau nécessite encore une vérification de connexion en direct. Si la connexion est annulée, réessayez Plan d'exécution. En cas d'erreur d'accès ou de SQL, vérifiez le même SQL et le même référentiel de données dans BI Publisher et communiquez à votre administrateur les codes d'erreur sans données sensibles. Ne désactivez pas les vérifications de sécurité Oracle. L'exécution web reste limitée aux comptes autorisés ; les plans natifs sur le web exigent aussi qu'Oracle accepte les identifiants de connexion existants.
Différence avec l'explication par IA
L'explication par IA décrit le SQL à l'aide du service d'IA configuré. Le plan d'exécution récupère le plan de l'optimiseur Oracle sans utiliser l'IA.
Tout exécuter et jeux de résultats distincts
Préparer l'éditeur
Séparez les requêtes de lecture par des points-virgules. Utilisez Tout exécuter ou Ctrl/Cmd+Shift+Enter. SQL Hop exécute les instructions séquentiellement plutôt que comme un seul script Oracle.
Paramètres
Chaque instruction paramétrée demande ses valeurs. Les valeurs ne servent qu'à cette exécution. Annulez une boîte de dialogue de paramètres pour ne pas exécuter la demande en attente. Vérifiez les paramètres lexicaux mixtes avant de continuer.
Résultats
Passez d'un onglet de jeu de résultats à l'autre pour voir la sortie de chaque instruction. Chaque jeu conserve ses propres filtres, son ordre de tri et ses lignes sélectionnées. Ses exportations utilisent les commandes de ce jeu et l'instantané du SQL exécuté.
Erreurs et annulation
Tout exécuter s'arrête après une erreur ; les instructions restantes ne sont pas exécutées. Arrêter annule la demande de l'application, sous réserve des limites d'exécution d'Oracle. Le temps affiché pour un lot représente l'exécution globale et ne prouve pas que les instructions ont été exécutées en parallèle.
Paramètres nommés :NAME
Écrire des marqueurs
SQLSELECT :P_NAME AS NAME
FROM dual
Utilisez les marqueurs :NAME aux emplacements ordinaires de valeurs, comme WHERE item_number = :X. Exécuter ouvre une boîte de dialogue proposant les types texte, nombre, date ou NULL. Saisissez une apostrophe comme du texte ordinaire, par exemple O'Brien ; n'ajoutez pas vous-même de guillemets SQL autour de la valeur.
Exécuter ou annuler
Enter valide la boîte de dialogue une seule fois. Annuler, Escape ou un clic à l'extérieur la ferme sans exécuter la requête ni ajouter d'entrée à l'historique. Les dernières valeurs et les derniers types confirmés préremplissent les exécutions suivantes dans le même onglet de requête et le même environnement Oracle, y compris après un échec de requête. Les instructions de Tout exécuter conservent des entrées distinctes. Annuler ne remplace pas les dernières valeurs confirmées. Fermer l'onglet, se déconnecter, actualiser la page ou fermer l'application efface les valeurs conservées.
Mémoire de session et confidentialité
Les valeurs conservées restent uniquement dans la mémoire de l'application. Elles ne sont pas incluses dans les onglets restaurés, les enregistrements de base de données, le stockage du navigateur ni les fichiers de requêtes enregistrés. Un autre onglet ou environnement démarre séparément.
Les requêtes enregistrées, les téléchargements de fichiers SQL et la feuille SQL facultative d'une exportation de résultats Excel conservent les marqueurs. Les valeurs de paramètres ne sont pas enregistrées dans l'historique des requêtes ni les journaux de l'application ; l'historique des requêtes paramétrées échouées utilise des erreurs expurgées. Les valeurs peuvent néanmoins influer sur les lignes de résultats que vous exportez volontairement ou y apparaître.
Limite d'implémentation
La prise en charge actuelle de :NAME utilise une substitution typée et échappée avant la demande de rapport. Il ne s'agit pas de paramètres liés natifs Oracle DBMS_SQL. Les paramètres liés natifs Oracle sont différés. Conservez les marqueurs pour les valeurs ; utilisez les paramètres lexicaux uniquement pour les fragments SQL intentionnels.
Paramètres lexicaux &NAME et &&NAME
Paramètre lexical ou valeur
Un paramètre :NAME représente une valeur typée. Un paramètre lexical &NAME ou &&NAME insère un fragment SQL, comme une liste de colonnes ou une condition. Les fragments SQL ne sont pas automatiquement délimités comme des valeurs.
SQLSELECT &COLUMNS
FROM egp_system_items_b esib
WHERE esib.item_number = :ITEM_NUMBER
Vérifier avant l'exécution
Exécuter demande les fragments lexicaux et les autres valeurs. Sélectionnez Vérifier le SQL, examinez le SQL développé, puis exécutez la version vérifiée. Si un fragment introduit d'autres marqueurs :NAME, remplissez les champs supplémentaires et vérifiez de nouveau. Modifier une valeur invalide la vérification précédente.
Réutilisation limitée à la session
Les deux formes lexicales peuvent préremplir leur dernier fragment confirmé pour cet onglet et cet environnement, mais Vérifier le SQL est requis à chaque exécution. Aucune des deux formes n'enregistre sa valeur définitivement. Fermer l'onglet, se déconnecter ou fermer l'application efface les fragments conservés. Annuler ou Escape n'exécute pas la requête.
Utiliser délibérément
Un fragment lexical peut modifier la structure de la requête. Ne considérez pas les fragments non fiables comme des valeurs scalaires inoffensives. Les marqueurs d'origine de l'éditeur restent inchangés et les valeurs ne sont pas stockées avec le SQL enregistré.
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.
Construire une requête visuellement
Ouvrir le concepteur
Sélectionnez Concepteur de requêtes dans la barre d'outils de l'éditeur. Recherchez dans les métadonnées disponibles pour ajouter des tables. Attribuez des alias distincts pour clarifier les références de colonnes et les jointures.
Choisir les colonnes
Table Sélectionnez les colonnes de sortie et les alias nécessaires. Les métadonnées doivent contenir les tables et colonnes pour que les sélecteurs puissent les afficher. Sélectionner une n'accorde pas d'accès à la base de données.
Ajouter des jointures
Table Choisissez les alias de participants, le type de jointure et les colonnes correspondantes. Vérifiez que la condition représente la relation voulue ; le concepteur ne peut pas déduire le sens métier ni garantir qu'une jointure évite les lignes en double.
Générer et vérifier
Générez le SQL dans l'éditeur lorsque vous êtes prêt. Vérifiez l'instruction complète et exécutez-la explicitement. Les filtres, le tri et les agrégats ont leurs propres guides du concepteur. La génération n'exécute pas automatiquement le SQL Oracle.
SQL écrit manuellement
Le concepteur conserve un modèle de conception enregistré pour une requête. Ne supposez pas que les modifications arbitraires de l'éditeur sont répercutées par rétro-ingénierie dans ce modèle. Vérifiez le SQL généré avant de remplacer du SQL modifié manuellement.
Conditions WHERE et ORDER BY du concepteur
Conditions WHERE
Table Ajoutez une condition à l'aide d'un alias de et d'une colonne sélectionnés. Choisissez une comparaison disponible et fournissez la valeur ou le paramètre voulu. Vérifiez la gestion de NULL et la distinction entre valeurs textuelles et numériques. Combinez les conditions avec les commandes proposées ; examinez le regroupement obtenu dans le SQL généré.
ORDER BY
Ajoutez des colonnes à la liste de tri et sélectionnez le sens croissant ou décroissant. L'ordre des champs de tri détermine leur priorité. Un ORDER BY SQL stable est différent du tri d'une grille de résultats déjà collectés.
Vérifier
Générez le SQL et vérifiez les clauses WHERE et ORDER BY dans l'éditeur. Utilisez des paramètres :NAME pour les valeurs variables plutôt que de modifier les littéraux à chaque exécution. Oracle valide les noms d'objets, les types et les permissions lors de l'exécution.
Les filtres de résultats sont distincts
Un filtre de colonne de résultats réduit uniquement l'instantané collecté. Il n'ajoute pas de clause WHERE et ne relance pas Oracle. Utilisez les conditions du concepteur pour réduire la sortie réelle de la requête.
GROUP BY, HAVING et fonctions d'agrégation
Choisir les agrégats
Dans le concepteur, choisissez un agrégat pour une colonne de sortie, comme COUNT, SUM ou AVG. Utilisez des colonnes numériques adaptées aux agrégats arithmétiques. COUNT(*) compte les lignes ; COUNT(column) exclut les valeurs NULL.
Regroupement
Ajoutez des colonnes de regroupement pour les champs de sortie non agrégés. Une colonne de détail associée à des agrégats nécessite généralement GROUP BY. Vérifiez le SQL généré plutôt que de supposer que la simple sélection d'une fonction produit la synthèse voulue.
HAVING
Utilisez HAVING pour filtrer les résultats regroupés ou agrégés. WHERE filtre les lignes sources avant le regroupement. Choisissez l'expression d'agrégation et la comparaison avec les commandes disponibles du concepteur.
Vérifier les résultats
Vérifiez les alias, GROUP BY, HAVING et ORDER BY dans l'instruction générée. Oracle peut rejeter des combinaisons invalides ou des types de données incompatibles. Le concepteur ne valide pas les totaux métier par rapport aux rapports sources.
Enregistrer et restaurer des conceptions modifiables
Éléments mémorisés
L'état du concepteur d'une requête comprend les tables sélectionnées, les alias, les colonnes, les jointures, les conditions, le tri, le regroupement et les paramètres d'agrégation. Rouvrez le concepteur sur cette requête pour poursuivre plutôt que de recommencer.
Enregistrer sans générer de SQL
Les modifications du concepteur seul peuvent être enregistrées même si vous n'avez pas généré de nouveau SQL dans l'éditeur. Enregistrer et Tout enregistrer conservent la conception avec cette requête. Tout enregistrer traite chaque requête indépendamment.
Enregistrer sous
Enregistrer sous crée une copie de conception modifiable distincte. Modifier la copie ne doit pas changer l'original. Rouvrez l'original depuis Requêtes enregistrées pour examiner son propre modèle.
Déconnexion et transfert
Les conceptions web enregistrées sont restaurées dans le même compte autorisé après connexion. Les conceptions de bureau appartiennent à l'espace local du compte. Un fichier .sql contient le texte SQL, pas la conception visuelle complète. N'utilisez pas le transfert de fichiers SQL comme sauvegarde complète d'une conception.
Choisir des colonnes dans les tables et alias
Table Déclarez la et l'alias dans votre SQL, ouvrez Colonnes, choisissez la table ou l'alias reconnu, puis sélectionnez les colonnes requises. Confirmez l'insertion et vérifiez la liste SELECT modifiée. Les cases sélectionnent les champs ; elles n'exécutent pas de requête.
Suggestions d'alias
Après avoir déclaré un alias, saisissez alias. dans l'éditeur pour demander les colonnes de cette table, y compris dans SELECT. Ctrl+Space peut rouvrir les suggestions. Plusieurs tables et jointures doivent utiliser des alias distincts.
Table Si une manque
Table Vérifiez l'orthographe et la syntaxe FROM/JOIN, puis confirmez que la existe dans les métadonnées publiées. Les portées SQL complexes peuvent nécessiter une modification manuelle lorsque la reconnaissance des alias ne peut pas les résoudre. Les métadonnées sont un catalogue de descriptions partagé, pas une vérification en direct des permissions Oracle.
Si des colonnes manquent
Demandez au propriétaire de la plateforme de vérifier que les lots de colonnes ont été importés et publiés. Sur bureau, téléchargez et activez les données d'autocomplétion. Actualisez le catalogue après publication ou téléchargement plutôt que d'insérer automatiquement toutes les colonnes.
Décrire les types, tailles et commentaires des colonnes
Décrire une table
Table Utilisez Décrire la dans la barre d'outils et identifiez la table. Examinez les noms de colonnes, types, longueurs ou précision/échelle, possibilité de valeurs nulles et commentaires lorsque ces champs existent dans les données chargées.
Origine des détails
Décrire utilise les métadonnées importées. Cela ne garantit pas que l'instance Oracle actuelle possède exactement le même schéma. Le catalogue publié peut être plus ancien que l'instance.
Un commentaire vide peut signifier qu'Oracle n'en a pas fourni ou que l'extraction n'incluait pas le champ de commentaire. L'importateur ne peut pas inventer de descriptions métier. Demandez au propriétaire de la plateforme de vérifier le classeur d'origine et ses en-têtes reconnus.
Tailles vides ou colonnes manquantes
Table Confirmez que le fichier de colonnes concerné comprend ces champs et a été publié. Téléchargez le paquet de métadonnées de bureau actuel si vous utilisez le bureau. L'accès aux requêtes sur une et la disponibilité de sa description dans le catalogue sont des vérifications distinctes.
Métadonnées partagées et publication
Le propriétaire de la plateforme charge centralement les descriptions d'objets, tables et colonnes Oracle. Les données publiées peuvent servir aux utilisateurs de plusieurs organisations. Il ne s'agit pas d'un chargement de lignes de résultats métier et cela n'accorde pas de permission de requête Oracle.
Les fichiers de tables et objets et les fichiers de colonnes peuvent être chargés séparément. L'identification des feuilles utilise les en-têtes reconnus sans exiger un nom de feuille particulier. Les grands lots alphabétiques sont fusionnés au lieu de remplacer toutes les données de colonnes antérieures.
Les données importées sont préparées avant leur publication. Les utilisateurs utilisent le catalogue publié, pas les préparations incomplètes. Après une publication, actualisez ou téléchargez le catalogue mis à jour selon le cas.
Seules les tables et colonnes présentes dans l'extraction peuvent apparaître dans les outils de métadonnées. Les commentaires et tailles sont des données sources facultatives. Aucune fonction automatique de mise à jour des tables Oracle ou de planification des métadonnées ne maintient ce catalogue à jour.
La documentation publique Oracle peut enrichir les descriptions de tables et colonnes correspondantes et les domaines fonctionnels. Les pages indisponibles et les commentaires manquants sont des situations différentes ; la documentation manquante reste vide. Les paquets de bureau doivent être reconstruits et publiés séparément, puis téléchargés à nouveau. Ne supposez pas qu'un ancien instantané local a reçu des commentaires plus récents.
Télécharger les données d'autocomplétion sur bureau
Télécharger
- Connectez-vous au bureau avec un essai actif approuvé ou un accès payant.
- Ouvrez Données d'autocomplétion dans la navigation.
- Téléchargez le paquet de métadonnées disponible et activez-le.
- Attendez la fin de la vérification et de l'installation, puis revenez à l'éditeur.
Fonctionnalités activées
Le catalogue local permet les suggestions de tables, les suggestions de colonnes par alias, Colonnes, Décrire et les sélecteurs de tables et colonnes du concepteur. L'exécution SQL peut toujours utiliser des noms saisis manuellement en l'absence de métadonnées.
Stockage et mises à jour
Le paquet de métadonnées est téléchargé dans le répertoire local de données de l'application plutôt qu'intégré à chaque installateur. Téléchargez un paquet publié plus récent lorsque le propriétaire de la plateforme le met à jour. Vous pouvez désactiver son utilisation avec la commande de cet écran. L'action d'importation distincte accepte un paquet de métadonnées compatible, pas des données métier XLSX quelconques.
Résolution des problèmes
Un téléchargement nécessite un droit d'accès valide du compte, un accès réseau, de l'espace disque et un paquet valide. Ne supprimez pas la base de données locale de l'espace de travail pour actualiser l'autocomplétion. Aucun identifiant ni résultat de requête n'est inclus dans le paquet de métadonnées.
Livraison du téléchargement
Le serveur de comptes vérifie les permissions et fournit un lien privé Cloudflare R2 de courte durée. Les octets des métadonnées sont téléchargés directement depuis le stockage, avec vérification de la somme de contrôle avant installation. Il s'agit d'un instantané publié : l'enrichissement de la documentation ou une mise à jour du serveur n'actualise pas silencieusement un téléchargement de bureau existant.
Lire les résultats et examiner un enregistrement
Commandes de la grille
Les en-têtes de colonnes restent visibles lors du défilement de la grille. Faites glisser un séparateur d'en-tête pour redimensionner une colonne, double-cliquez sur le séparateur pour l'ajuster au contenu ou utilisez Ajuster automatiquement les colonnes pour l'ensemble. Les largeurs sont mémorisées par requête lorsque l'espace de travail le prend en charge.
Enregistrement développé
Sélectionnez Afficher l'enregistrement à côté du numéro de ligne pour ouvrir un enregistrement avec les noms de colonnes à gauche et les valeurs à droite. Cela est utile pour les tables larges. Il s'agit d'une vue de la ligne de résultats sélectionnée, pas d'un formulaire de modification de base de données.
Faites un clic droit sur la grille de résultats ou utilisez Shift+F10 avec le focus sur la grille pour afficher les actions disponibles. Utilisez uniquement les actions proposées pour la cellule, la ligne ou la sélection actuelle.
Volet complet
Agrandissez les résultats pour disposer de plus de place et appuyez sur Escape ou Restaurer la taille des résultats pour revenir. Les filtres, le tri et la sélection restent associés au jeu de résultats. Modifier le SQL de l'éditeur ne remplace pas silencieusement la grille.
Lignes par page et nombre total de lignes
Choisissez Lignes par page pour afficher 10, 25, 50, 100 ou 200 lignes à la fois. Le dernier réglage est mémorisé pour l'utilisateur et l'espace de travail. Utilisez les commandes Première page, Page précédente, Page suivante et Dernière page lorsqu'elles sont disponibles.
Nombre total et nombre de correspondances
Table Le total décrit les lignes de l'instantané de résultats collecté, pas nécessairement toutes les lignes de la source Oracle. Les filtres peuvent réduire le nombre de correspondances. Une limite de récupération peut signifier qu'il existe plus de lignes sources que de lignes collectées.
Lignes par page modifie uniquement la page visible. Lignes à récupérer contrôle le maximum collecté pour une nouvelle exécution. Définir une taille de page de 25 ne signifie pas qu'une exportation de tous les résultats doit contenir seulement 25 lignes.
Le tri, les filtres et les sélections s'appliquent à tout l'instantané collecté. Les instantanés chargés à la demande récupèrent les pages au besoin au lieu de placer toutes les lignes dans le navigateur en une fois.
Filtrer les résultats par colonne
Filtre de colonne
Sélectionnez l'icône d'entonnoir dans un en-tête de colonne et définissez une condition de filtre prise en charge. Appliquez-la pour réduire les lignes correspondantes dans tout le jeu de résultats collecté, pas seulement sur la page visible. Utilisez Effacer les filtres de colonnes pour les supprimer.
Recherche textuelle
Utilisez le champ de recherche des résultats pour le filtre textuel général. La recherche et les conditions de colonne peuvent se combiner. Un nombre de correspondances nul ne prouve pas qu'Oracle ne contient aucune ligne correspondante en dehors de l'instantané récupéré.
Sélection
Les lignes sélectionnées restent sélectionnées lorsque les filtres sont appliqués ou effacés. Les lignes masquées par un nouveau filtre peuvent encore faire partie de la sélection. Effacez explicitement la sélection si elles ne doivent pas être exportées.
Filtre de requête et filtre de résultats
Un filtre de résultats agit sur les données récupérées. Pour modifier ce qu'Oracle renvoie ou réduire une extraction coûteuse, ajoutez une condition WHERE dans le SQL ou le concepteur et exécutez de nouveau.
Trier sur plusieurs pages et dans les exportations
Appliquer un tri
Choisissez l'icône de tri croissant ou décroissant dans un en-tête. Le tri actif est mis en évidence. Cliquez de nouveau sur le tri actif pour l'effacer lorsque cette fonction est proposée. Le tri s'applique à tout l'instantané de résultats, y compris aux lignes filtrées, pas seulement à la page actuelle.
Sélection stable
Passer du tri croissant au tri décroissant ne change pas les lignes sous-jacentes sélectionnées. La position affichée d'une ligne peut changer ; sa sélection doit rester associée à cette ligne.
Exportations
Les exportations CSV et Excel suivent le tri actuel des résultats. Les exportations filtrées utilisent l'ordre filtré ; les exportations de lignes sélectionnées conservent les lignes sélectionnées dans l'ordre actuel des résultats sur toutes les pages.
ORDER BY SQL
Le tri de la grille ne relance pas Oracle et ne modifie pas le SQL de l'éditeur. Utilisez ORDER BY SQL si Oracle doit lui-même produire un ordre donné avant la collecte. Conservez un tri distinct pour chaque jeu de résultats de Tout exécuter.
Sélectionner des lignes sur plusieurs pages et avec des filtres
Sélection individuelle et par page
Utilisez la case d'une ligne pour la sélectionner. La case d'en-tête sélectionne les lignes de la page visible. Changez de page sans perdre les lignes sélectionnées.
Sélectionner toutes les lignes correspondantes
Table Utilisez Sélectionner toutes les lignes correspondantes pour sélectionner les lignes répondant aux filtres actifs sur toutes les pages du résultat collecté. Cela ne sélectionne pas les lignes de la source en dehors de l'instantané et ne désigne pas toutes les lignes non filtrées.
Filtres et tri
Modifier ou effacer les filtres ou changer le sens du tri conserve les lignes sélectionnées. Une ligne sélectionnée peut être masquée par un filtre. Le nombre de lignes sélectionnées peut donc dépasser celui des lignes correspondantes visibles.
Exporter
Choisissez l'option des lignes sélectionnées dans la boîte de dialogue d'exportation pour inclure les sélections de toutes les pages, y compris les lignes sélectionnées actuellement masquées par un filtre. Utilisez Effacer la sélection pour la réinitialiser volontairement. Chaque onglet de résultats de Tout exécuter possède sa propre sélection.
Exporter les résultats en CSV ou Excel
Exporter les données
- Ouvrez Exporter les données pour le jeu de résultats actuel.
- Choisissez CSV ou Excel et vérifiez si l'exportation porte sur toutes les lignes récupérées concernées, les lignes filtrées ou les lignes sélectionnées.
- Vérifiez le nom du fichier et son extension, puis téléchargez-le ou choisissez l'emplacement d'enregistrement natif.
Périmètre et ordre
L'exportation n'est pas limitée à la page visible. Elle suit le tri des résultats et le périmètre d'exportation choisi. Les exportations de lignes sélectionnées incluent la sélection des autres pages. Un filtre de grille peut masquer des lignes sélectionnées sans les désélectionner.
Nom du fichier
Le nom par défaut utilise celui de l'onglet de requête suivi d'une date et d'un horodatage, avec la bonne extension .csv ou .xlsx. Les caractères de nom de fichier invalides sont normalisés.
Séparateurs CSV
Choisissez le séparateur proposé dans la boîte de dialogue, comme la virgule, le point-virgule ou la tabulation. Le texte contenant des séparateurs, guillemets ou sauts de ligne est correctement délimité. Les apostrophes comme dans O'Brien restent des données ordinaires. Configurez l'importation de votre tableur pour correspondre au séparateur choisi.
Excel avec SQL
Choisissez l'option d'inclusion du SQL dans une deuxième feuille. Elle utilise l'instantané du SQL exécuté lorsqu'il est disponible et conserve les marqueurs de paramètres ; les valeurs de paramètres ne sont pas enregistrées dans la feuille SQL. Les lignes de résultats peuvent néanmoins contenir ces valeurs si votre requête les a renvoyées.
Résultats volumineux et chargement à la demande
Instantanés interactifs
Choisissez une valeur Lignes à récupérer plus élevée, dans les options interactives proposées, et exécutez. Les résultats volumineux utilisent un instantané temporaire avec des demandes de pages au lieu d'afficher chaque ligne dans la grille. Les filtres, le tri, les sélections et les exportations portent sur l'instantané collecté.
La récupération reste un travail
L'affichage à la demande ne rend pas gratuite une requête Oracle illimitée. L'exécution du rapport Oracle, le transfert, les limites de disque et de mémoire et le temps réseau restent importants. Un SELECT * très large peut être beaucoup plus volumineux que le même nombre de lignes étroites.
Si un résultat est trop volumineux
Sélectionnez moins de colonnes, utilisez une clause WHERE restrictive, réduisez Lignes à récupérer ou utilisez l'exportation de bureau en arrière-plan. Lisez l'erreur réelle de taille ou de limite de cellules plutôt que de supposer que des lignes partielles forment un résultat complet.
Temporaire signifie temporaire
Les instantanés sont propres à la session et peuvent expirer ou disparaître après une déconnexion, un nettoyage ou un redémarrage. Si un instantané est indisponible, réexécutez la requête. Téléchargez les résultats à conserver. Le chargement à la demande n'est pas un curseur de base de données ouvert indéfiniment.
Exportations de bureau en arrière-plan
Créer une tâche
- Connectez Oracle sur bureau.
- Utilisez Exportation en arrière-plan dans la barre d'outils de requête.
- Choisissez CSV ou XLSX, le nombre maximal de lignes et les options disponibles ; vérifiez les éventuels paramètres.
- Ouvrez Exportations en arrière-plan pour suivre la tâche locale, l'annuler au besoin ou télécharger le fichier terminé.
Fonctionnement
Le connecteur pris en charge exécute un rapport BI Publisher et télécharge sa sortie par fragments. Vous n'avez pas besoin de colonnes de tri uniques ni d'une case de confirmation du tri. Le maximum actuel d'une tâche est de 100,000 lignes, sous réserve des limites de rapport et de sortie ; une tâche terminée à son maximum peut indiquer qu'il existe davantage de lignes sources.
Emplacement des fichiers
Les tâches et téléchargements temporaires sont sur l'ordinateur portable, pas sur le serveur de comptes. Les fichiers temporaires terminés expirent 24 heures après la fin ; l'expiration est affichée dans la tâche. Téléchargez ou enregistrez une copie pour les conserver plus longtemps. Un fichier enregistré dans votre propre dossier est distinct de la tâche temporaire qui expire.
Garder Desktop ouvert
La tâche est locale, ce n'est pas un planificateur de serveur persistant. Fermer l'application, se déconnecter, déconnecter Oracle, la veille, une perte de réseau ou l'expiration de la licence peuvent l'interrompre. Ne vous attendez pas à ce qu'elle se termine lorsque l'ordinateur est éteint.
Problèmes
Si seules 200 lignes arrivent, vérifiez le maximum réel de l'exportation et la limite actuelle de QueryRunner. Si les téléchargements de fragments sont rejetés, vérifiez les permissions du service et du rapport. Un résultat interactif volumineux et une exportation en arrière-plan sont des procédures différentes.
Permissions d'IA et clés personnelles
Trois modes d'accès
Qui décide
Les administrateurs clients accordent les modes uniquement aux utilisateurs de leur organisation. Le super administrateur contrôle la configuration du service partagé et les paramètres de plateforme. Les utilisateurs ne peuvent pas modifier l'accès d'un autre utilisateur ni contourner le mode Bloqué en saisissant leur propre clé.
Application des changements
Les demandes d'IA partagée sont autorisées par le serveur. Les permissions de bureau sont actualisées au démarrage et lors de la validation quotidienne réussie ; les restrictions de clé personnelle peuvent donc attendre cette vérification pour s'appliquer. Pendant une interruption du serveur de comptes, une permission signée existante peut rester valide jusqu'à son échéance fixe. Une clé personnelle stockée ne remplace pas un mode Bloqué nouvellement validé. Les permissions persistent après déconnexion et reconnexion.
Configuration personnelle
Si vous y êtes autorisé, ouvrez Ma clé OpenAI dans Desktop et utilisez les commandes de clé et de modèle disponibles. Les clés sont des secrets et ne sont pas réaffichées intégralement. Vérifiez le statut plutôt que d'attendre qu'un champ secret vide affiche une valeur existante.
Rédiger, expliquer et corriger du SQL
Ouvrir l'assistant
Sélectionnez l'icône d'IA lorsque votre administrateur a accordé l'accès. Choisissez Rédiger pour décrire une requête, Expliquer pour comprendre du SQL ou Corriger pour demander une correction. Vérifiez le SQL de l'éditeur et les instructions que vous envoyez.
Limite des données
Les lignes de résultats ne sont pas incluses dans les demandes d'IA. Le SQL peut lui-même contenir des noms, littéraux ou conditions sensibles ; retirez tout ce que vous ne souhaitez pas envoyer. L'IA de bureau est un service réseau même si l'exécution Oracle est locale.
Vérifier avant d'exécuter
La sortie de l'IA est une proposition, pas du SQL Oracle vérifié. Contrôlez les noms de tables et colonnes, les jointures, les filtres et la syntaxe de votre version Oracle. Appliquez uniquement lorsque vous êtes satisfait, puis exécutez explicitement. L'application n'exécute pas automatiquement le SQL proposé.
Erreurs
La disponibilité de l'IA dépend des permissions, de la clé et du modèle configurés, de la disponibilité du fournisseur et des limites. Une erreur du fournisseur n'est pas une erreur Oracle. Une réponse d'IA réussie ne prouve pas que les résultats métier sont corrects.
Affiner, vérifier, appliquer ou abandonner les modifications d'IA
Proposer et affiner
Décrivez le changement voulu. Vérifiez la proposition et sa comparaison avec le SQL d'origine. Demandez un affinement pour produire une proposition mise à jour ; la nouvelle version nécessite toujours une vérification avant Appliquer.
Appliquer
Appliquer modifie uniquement l'éditeur. Cela n'exécute pas de SQL, n'efface pas la grille de résultats actuelle, ne supprime pas les filtres de résultats et ne modifie pas les lignes sélectionnées. Ces résultats peuvent appartenir au SQL exécuté précédemment jusqu'à votre prochaine exécution.
Annuler et rétablir
Après l'application d'une proposition affinée, Annuler restaure le SQL précédent. Rétablir remet la proposition. Aucune action n'exécute la requête ni n'efface les résultats existants.
Abandonner
Annuler, fermer, Escape ou fermer par l'arrière-plan sans appliquer laisse le SQL de l'éditeur, les résultats, les filtres et les sélections inchangés. N'interprétez pas la fermeture d'une proposition comme son acceptation.
Offres, places et dates d'abonnement
Ouvrir Abonnement
Les utilisateurs d'essai et payants peuvent accéder à l'écran web d'abonnement. Il affiche le statut, les places utilisées, la fin de l'essai le cas échéant et la date de la période payée actuelle. Seul l'administrateur d'organisation peut lancer le paiement ou gérer la facturation. Le titulaire du compte d'une organisation à une place peut en être l'administrateur ; l'administrateur utilise cette place.
Offres publiques actuelles
Le prix promotionnel pour un utilisateur est de USD 14.99 par mois ou USD 149.90 par an (deux mois offerts), plus les taxes applicables lorsqu'elles sont configurées. Le site web actuel et la confirmation Stripe font référence. Les totaux d'équipe sont calculés en privé dans Abonnement selon le nombre d'utilisateurs nommés. Les tarifs dégressifs par volume ne sont pas publiés sur le site web. Les conditions promotionnelles sont conservées tant que l'abonnement est continu ; l'annulation met fin à leur maintien. Des offres personnalisées peuvent aussi être convenues en privé.
Abonnements actifs
Les boutons de nouveau paiement sont désactivés lorsqu'un abonnement actif existe déjà. Utilisez Gérer la facturation / les factures pour modifier l'offre existante, le moyen de paiement ou l'annulation. Sur bureau, un administrateur client peut utiliser Gérer la facturation / les factures sur le web ; l'administration reste sur le site web.
Dates et rappels
Une offre à renouvellement automatique affiche la fin de sa période payée ou la prochaine échéance, sans prétendre que le compte expirera à cette date. Une annulation programmée affiche Expiration de l'abonnement. Les rappels sur bureau commencent trois jours avant l'expiration ou le renouvellement mensuel, et quinze jours avant l'expiration ou le renouvellement annuel.
Mode test
Le mode test de Stripe n'est pas un paiement réel. Le simple retour depuis Checkout ne confirme pas l'accès ; le serveur utilise les événements de paiement signés et l'état de l'abonnement.
Passer à une offre supérieure, inférieure ou changer de périodicité
Ouvrir l'abonnement existant
Utilisez Gérer la facturation / les factures plutôt que de démarrer un second abonnement. Sélectionnez l'offre ou la périodicité proposée et vérifiez la confirmation Stripe.
Offres supérieures
Les passages à une offre supérieure sont calculés au prorata et facturés immédiatement. Vérifiez le crédit de temps prépayé inutilisé, les nouveaux frais, les taxes et le montant dû. Si le paiement échoue, l'offre et la limite de places existantes restent en vigueur ; les comptes et les requêtes enregistrées sont conservés.
Offres inférieures
Les passages à une offre inférieure prennent effet au renouvellement. L'offre actuelle reste disponible jusque-là. Le passage à une périodicité de facturation plus courte est programmé pour le renouvellement. Vérifiez la date d'effet et tout changement programmé affiché dans SQL Hop.
Changements mensuel/annuel
Lisez l'aperçu avant de confirmer : le crédit inutilisé, les taxes et le montant à payer dépendent de la périodicité, de la date d'effet et de l'état des factures existantes. Ouvrez Voir les détails dans la confirmation pour obtenir la ventilation. Un solde créditeur réduit les factures futures ; il ne constitue pas automatiquement un remboursement en espèces.
Places et maintien des conditions
Réduisez les membres excédentaires ou les invitations en attente avant l'entrée en vigueur d'une limite de places inférieure. Les offres retirées peuvent rester disponibles pour les abonnés existants, mais changer d'offre peut rendre leur ancien tarif inaccessible.
Annuler ou renouveler un abonnement
Annuler
Ouvrez Abonnement sur le web et sélectionnez Gérer la facturation / les factures. Utilisez l'option d'annulation proposée dans Stripe, vérifiez la date d'effet et confirmez sur place. Revenez à SQL Hop et actualisez le statut de facturation.
À la fin de la période
Lorsqu'une annulation est programmée, la fin de la période payée est affichée comme date d'expiration de l'abonnement. L'accès payant aux requêtes se termine lorsque le droit d'accès n'est plus actif. Les comptes et les requêtes enregistrées sont conservés ; annuler ne supprime pas l'organisation et n'accorde pas un autre essai.
Changer d'avis
Utilisez Gérer la facturation pour vérifier si une annulation programmée peut être annulée ou un abonnement renouvelé. La confirmation du paiement et l'état signé de l'abonnement doivent rétablir le droit d'accès ; le simple retour depuis une page ne suffit pas.
Remboursements
Une annulation ne promet pas un remboursement automatique en espèces. Consultez la confirmation et les conditions publiées. Les crédits issus de changements d'offre réduisent normalement les factures futures. Contactez l'assistance pour un problème de facturation sans envoyer de coordonnées de carte.
Échecs de paiement, expiration et blocages de facturation
Échec de paiement ou abonnement expiré
Les requêtes peuvent être refusées si le droit d'accès est en retard de paiement, impayé, incomplet, suspendu, annulé ou expiré. Le compte et les requêtes enregistrées restent présents. Desktop refuse les nouvelles requêtes et exportations lorsque la validation renvoie explicitement la restriction ou lorsque l'autorisation existante expire ; les résultats en cache sont conservés. Les administrateurs d'organisation peuvent toujours utiliser la facturation web pour vérifier le paiement et le renouvellement.
Échec de passage à une offre supérieure
Un échec de paiement immédiat pour une offre supérieure ne doit pas remplacer l'offre payante ni la limite de places existantes. Vérifiez l'état du paiement dans le portail avant de réessayer et évitez de créer un second abonnement.
Notifications
Les courriels d'échec de paiement sont envoyés à l'administrateur d'organisation au format des courriels de compte SQL Hop, avec une action Gérer la facturation et une protection contre les doublons. La réception d'un courriel ne remplace pas la vérification d'Abonnement.
Litiges
Une rétrofacturation peut entraîner un blocage de facturation et une politique de liste de blocage. Les actions concernant tout un domaine excluent les fournisseurs de messagerie publics et nécessitent l'approbation du super administrateur. Gagner un litige ne supprime pas automatiquement une adresse d'une liste de blocage permanente ; contactez le propriétaire de la plateforme pour examen.
Sécurité
N'envoyez jamais de mots de passe, numéros de carte complets, liens de réinitialisation ou clés d'API à l'assistance. Incluez une erreur sans données sensibles, l'heure approximative et le statut de l'abonnement.
Limites de places et nombre de membres
Ce qui compte
Les limites de places incluent les administrateurs d'organisation et les invitations en attente, pas seulement les utilisateurs ayant exécuté du SQL. Une offre à un utilisateur peut donc contenir un compte administrateur sans qu'il s'agisse d'une place d'administration gratuite distincte.
Ajouter ou réactiver des utilisateurs
Vérifiez le nombre actuel de places utilisées et autorisées avant d'inviter ou d'activer des comptes. La création, les invitations et la réactivation ne doivent pas contourner la limite de places. Les organisations d'essai comprennent dix utilisateurs ; les offres payantes ou personnalisées utilisent leur nombre de places configuré.
Offre inférieure
Si vous programmez une offre plus petite, réduisez les membres actifs et annulez les invitations inutiles avant l'entrée en vigueur de la nouvelle limite. Dépasser le droit d'accès peut suspendre les requêtes ; cela ne supprime pas les comptes ni le SQL enregistré.
Organisations indépendantes
Une équipe distincte peut s'abonner sous le même domaine professionnel ou la même instance Oracle. Les utilisateurs ont toujours besoin de leur propre compte autorisé et doivent remplir les conditions de l'essai. Le partage des places n'autorise pas le partage d'une connexion entre plusieurs personnes.
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.
Administrateur client
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.
Super administrateur
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.
Gérer 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.
Colonne 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.
Colonne 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.
Colonne 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.
Historique des requêtes et conservation
Contenu de l'historique
L'historique enregistre le SQL exécuté et le résultat de l'exécution. Ouvrez une entrée pour l'examiner ou la réexécuter ; le SQL paramétré doit conserver ses marqueurs et demander de nouvelles valeurs.
Conservation automatique
L'historique automatique conserve le dernier mois d'activité, ou au moins les dix dernières requêtes si elles sont plus anciennes. Le nettoyage est planifié pendant le week-end plutôt que toutes les heures. L'historique de bureau est local à l'espace du compte.
Différence avec les requêtes enregistrées
Enregistrez par nom les requêtes à conserver. L'historique n'est pas une sauvegarde permanente. Effacer votre historique est une action explicite et ne signifie pas que des données Oracle ont été supprimées.
Saisie de paramètres annulée
Annuler, Escape ou cliquer à l'extérieur de la boîte de dialogue des paramètres n'exécute pas de SQL et ne crée pas d'entrée d'historique d'exécution. Les requêtes paramétrées échouées conservent des erreurs d'historique expurgées sans enregistrer les valeurs des paramètres.
Avis de maintenance et état du service
Avis
Un message de maintenance planifiée peut afficher le début, la fin prévue, le fuseau horaire et les instructions de l'opérateur. Pendant une maintenance active, l'animation de connexion publique peut être remplacée par la vue de maintenance.
Restrictions d'accès
Lorsque la maintenance est imposée, les utilisateurs web autres que le super administrateur sont déconnectés et l'accès normal est restreint. L'opérateur conserve l'accès privilégié nécessaire à la maintenance. Le début programmé est évalué par le serveur, pas seulement par le compte à rebours visuel d'une page.
Travail existant
Enregistrez votre travail avant la période annoncée. Le SQL enregistré et les comptes doivent rester intacts. Les connexions Oracle web du super administrateur et les instantanés temporaires du serveur peuvent être perdus lors d'un redémarrage du serveur. Les résultats et connexions Oracle locaux de bureau ne sont pas hébergés sur ce serveur. Gardez Desktop ouvert et enregistrez les exportations importantes.
Autorisation du bureau pendant l'interruption
Un ordinateur enregistré déjà autorisé peut poursuivre le travail local jusqu'à son échéance signée lorsque le serveur de comptes est indisponible. La limite est de 48 heures depuis la dernière validation réussie, sans dépasser l'expiration de l'essai ou de l'abonnement. La première activation et le compte ou la facturation web nécessitent le serveur ; Oracle et l'IA ont toujours besoin de leurs propres services. Les refus explicites du serveur ne bénéficient pas d'une prolongation pour interruption.
Pannes
Utilisez État du service depuis la connexion ou le pied de page du site. Une page d'état servie par la même application peut elle-même être indisponible pendant une panne complète du serveur ; elle ne garantit pas une surveillance indépendante.
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
Sauvegardes et récupération
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.
Demandes de contact et confirmation
Envoyer une demande
Utilisez Contact pour les ventes, les tarifs d'équipe personnalisés ou l'assistance. Saisissez une boîte de réception que vous contrôlez et les détails du message. Le site envoie un courriel de confirmation ; la demande n'est pas transmise au propriétaire avant que vous suiviez le lien et confirmiez l'envoi.
Envois répétés
Des envois répétés sans confirmation ne doivent pas entraîner des courriels de confirmation répétés. Le site vous indique de confirmer la demande existante. Vérifiez la boîte de réception d'origine et les courriels indésirables plutôt que de soumettre à nouveau.
Après confirmation
Seule la demande confirmée est transmise pour réponse. Ouvrir un lien n'est pas toujours la dernière étape ; utilisez Confirmer et envoyer sur la page de confirmation. Les messages de demande n'utilisent pas la signature d'équipe des courriels de compte.
Confidentialité et examen par le propriétaire
Le propriétaire de la plateforme peut consulter les messages, horodatages, IP sources et statuts de confirmation et d'envoi dans Demandes du site web. Les enregistrements IP aident à examiner les abus mais ne prouvent pas l'identité d'une personne. Le propriétaire répond à l'courriel reçu plutôt que de traiter chaque soumission non confirmée comme une conversation.
Cloudflare Turnstile vérifie le visiteur avant que le serveur enregistre une demande ou envoie un courriel de confirmation. Les jetons échoués, expirés, réutilisés ou absents sont rejetés. Le serveur vérifie aussi le nom d'hôte et l'action pour les contrôles réels. Une panne du fournisseur empêche l'envoi au lieu de contourner la vérification. Les limites de fréquence, le champ antispam masqué et la règle d'un seul courriel de confirmation restent en vigueur. Le développement local utilise des clés de test officielles clairement identifiées ; la production exige un véritable composant et un secret réservé au serveur. Le CAPTCHA ne remplace pas la confirmation par courriel et ne garantit pas la légitimité d'un message.
Ce qui est stocké, envoyé ou conservé localement
Compte de l'application
Notre base de données conserve le compte, l'organisation, le SQL web enregistré, l'état de facturation et les données d'audit autorisées. Les courriels et noms des comptes utilisent le chiffrement applicatif et une protection des recherches ; les mots de passe sont hachés plutôt que conservés en texte clair récupérable. Le chiffrement ne rend pas inoffensive une application en cours d'exécution compromise.
Oracle
Pour l'exécution web du super administrateur, les identifiants Oracle sont des valeurs temporaires en mémoire serveur, pas des enregistrements persistants en base. Les comptes web clients n'ont pas d'espace de requête. Les demandes et résultats Oracle de bureau sont locaux ; les identifiants enregistrés facultatifs utilisent le chiffrement protégé du système. Votre requête autorisée envoie toujours le SQL à Oracle.
Paramètres et exportations
Les valeurs de paramètres ne sont pas stockées avec le SQL enregistré, l'historique ni la feuille SQL d'exportation facultative. Les lignes renvoyées peuvent contenir des valeurs sensibles, et un fichier exporté constitue une copie intentionnelle. Vérifiez les exportations avant de les partager.
IA
Seuls le SQL demandé et les instructions sont envoyés pour l'assistance par IA, jamais les lignes de résultats. Les littéraux SQL peuvent eux-mêmes contenir des informations sensibles.
Récupération
Les sauvegardes serveur excluent les clés et le travail local de bureau. Protégez séparément les clés de l'application, les données locales de l'espace de travail et les exportations téléchargées. Évitez de partager des jetons, journaux bruts ou identifiants pendant le dépannage.
Autorisation des appareils et téléchargements
Le serveur stocke l'identifiant de l'appareil enregistré, le nom de l'ordinateur, la clé publique et les heures d'enregistrement et de validation. La clé privée et l'autorisation signée restent dans le stockage protégé du système sur l'ordinateur. L'enveloppe signée inclut l'identité du compte, les permissions et la configuration des instances, pas les mots de passe Oracle, le SQL ni les résultats. Les installateurs et fichiers de métadonnées sont livrés depuis un stockage R2 privé avec des liens de courte durée ; les sauvegardes de récupération utilisent un stockage S3 privé distinct.
Confidentialité, traitement des données et sécurité de l'assistance
Lisez Traitement des données et Informations d'utilisation dans le pied de page du site pour connaître les informations actuellement publiées. Ces articles d'aide expliquent le comportement du produit ; ils ne remplacent pas les conditions publiées ni un accord de confidentialité.
Informations sûres pour l'assistance
Incluez la plateforme (web/bureau), la version de l'application si disponible, l'heure approximative, l'action effectuée et l'erreur exacte sans données sensibles. Une requête de reproduction sans risque est préférable aux données métier. Les captures doivent exclure les mots de passe, jetons, littéraux SQL privés et lignes de résultats que vous n'êtes pas autorisé à partager.
Ne jamais partager
N'envoyez pas de mots de passe Oracle ou de l'application, clés d'API, codes MFA, codes de récupération, liens de réinitialisation ou d'activation ni coordonnées complètes de carte. Un administrateur n'a pas besoin de votre mot de passe pour examiner une politique d'accès.
Périmètre
Les permissions Oracle indépendantes, la livraison du fournisseur de messagerie et les politiques réseau ou d'appareil peuvent affecter le comportement en dehors de SQL Hop. Contactez l'administrateur concerné plutôt que d'affaiblir les protections du compte.
Résoudre les erreurs de requête et de connexion Oracle
Commencer par les détails
Échec de l'exécution de la requête indique le résultat de l'exécution, suivi des détails Oracle ou du service expurgés lorsqu'ils sont disponibles. Le SQL de l'éditeur est conservé. Ne supposez pas qu'une erreur générique de service signifie un mot de passe incorrect.
Cas courants
Échecs de connexion
Utilisez le bon hôte HTTPS configuré et le bon chemin de rapport. Une connexion réussie à Oracle dans le navigateur n'authentifie pas le connecteur BI Publisher. Ne réessayez pas à répétition des identifiants rejetés au risque de verrouiller le compte.
Transmettre le problème en sécurité
Partagez le code d'erreur, l'heure, la plateforme et une reproduction sans risque. N'incluez jamais de valeurs de paramètres ni d'identifiants dans les journaux ou messages d'assistance.
Résoudre les problèmes d'accès au compte et à la facturation
Identifier la restriction
- Approbation en attente : l'activation est terminée, mais pas l'approbation de l'organisation ou du membre.
- Essai terminé ou déjà utilisé : abonnez-vous ou demandez au super administrateur d'examiner une exception.
- Compte d'essai ou payant sur le web : l'espace SQL est masqué. Téléchargez Desktop ; le compte, la facturation et les paramètres d'organisation autorisés restent disponibles.
- Compte d'essai sur bureau : vérifiez l'approbation, l'admissibilité à l'essai et l'ordinateur enregistré.
- Limite de places : l'administrateur doit réduire les utilisateurs ou invitations, ou changer d'offre.
- Blocage de paiement ou de litige : examinez la facturation web avec l'administrateur d'organisation.
- Connexion ailleurs : une connexion plus récente sur le même type de client a pu remplacer cette session. Les sessions web et bureau sont distinctes.
Administrateur avec une seule place
L'unique titulaire du compte peut être l'administrateur client et consomme une place. Desktop conserve ce rôle de facturation tout en masquant l'administration. Utilisez Gérer la facturation / les factures sur le web. Les abonnements actifs désactivent les nouveaux paiements Checkout car les changements doivent se faire dans le portail de l'abonnement existant.
Mot de passe enregistré, mais connexion impossible
Vérifiez l'URL et le port exacts, l'origine du serveur de comptes, le statut du compte et toute étape MFA. Un mot de passe enregistré n'exclut pas une session expirée, une connexion remplacée ou un mauvais serveur. Ne réinitialisez pas un mot de passe uniquement parce qu'une page est inaccessible.
Erreurs d'appareil et d'interruption
Un autre ordinateur enregistré signifie que la place nécessite un transfert avec vérification d'identité dans Sécurité du compte sur le web. Autorisation expirée signifie qu'il faut se reconnecter à SQL Hop et valider ; réinstaller ou rouvrir ne prolonge pas le délai. Un avertissement de retour en arrière de l'horloge nécessite de corriger l'heure avant la validation. Un refus explicite du compte n'est pas une prolongation de grâce pour interruption. Ces restrictions ne suppriment pas le SQL enregistré ni les résultats existants.
Vérifier la disponibilité du service
Page d'état
Utilisez État du service sur l'écran de connexion ou dans le pied de page du site. Elle affiche l'état de maintenance actuel de l'application et le message de période planifiée s'il existe.
Si la page ne se charge pas
Vérifiez d'abord l'adresse, le port, le réseau et le certificat. Une page d'état servie par le même serveur peut échouer pendant une panne ; une page inaccessible ne prouve donc pas que tout fonctionne.
Ce que cela ne prouve pas
La disponibilité de l'application ne vérifie pas chaque instance client Oracle, réponse OpenAI ou livraison d'courriel. Les erreurs de connexion ou de requête Oracle nécessitent leurs propres vérifications.
Reprise après maintenance
Après un redémarrage du serveur, la connexion peut encore exister alors que les identifiants Oracle temporaires ou instantanés ont disparu. Reconnectez-vous et réexécutez du SQL sans risque avant de reprendre le travail.
Obtenir de l'aide avec les bonnes informations
Première vérification
Recherchez l'action ou le code d'erreur exact dans ce centre d'aide. Utilisez les libellés de plateforme et de rôle pour éviter de suivre une procédure de super administrateur en tant qu'utilisateur ordinaire. Vérifiez État du service pour la maintenance.
Envoyer un message d'assistance
Une fois connecté, ouvrez Assistance dans la barre latérale, saisissez votre question et sélectionnez Envoyer le message. Revenez dans Assistance pour lire les réponses ; votre conversation est enregistrée. L'assistance est disponible sur le web et le bureau. Seule votre propre conversation est visible. Les réponses sont vérifiées et envoyées par le propriétaire de la plateforme ; elles ne sont pas automatiques. Pour un accès propre à l'organisation, contactez d'abord votre administrateur d'organisation.
Utilisez le formulaire Contact du site pour les questions avant inscription ou les offres d'équipe personnalisées. Confirmez votre courriel avant d'attendre une transmission au propriétaire.
Inclure
- Web ou bureau et système d'exploitation.
- La page ou l'action de la barre d'outils et l'horodatage approximatif avec le fuseau horaire.
- L'erreur exacte après suppression des secrets et données privées.
- Si un SELECT 1 FROM dual sans risque réussit.
- Pour la facturation, le mode test ou réel et le statut visible, sans détails de paiement.
Exclure
Mots de passe, clés d'API, codes MFA ou de récupération, liens de réinitialisation, fichiers de résultats clients et littéraux privés de requête. Ne contournez pas un avertissement de certificat et ne désactivez pas la sécurité pour faire fonctionner une reproduction destinée à l'assistance.
Effectuez Cloudflare Turnstile avant d'envoyer une demande. Si le composant ne se charge pas, utilisez Réessayer la vérification et autorisez challenges.cloudflare.com dans votre navigateur. Une vérification expirée est actualisée ; aucun courriel de confirmation n'est envoyé si la vérification serveur échoue. L'étape distincte de confirmation par courriel reste requise avant qu'une demande atteigne le propriétaire de la plateforme.
Statut de la conversation
Votre conversation d'assistance peut être Ouverte, En attente de l'utilisateur ou Résolue. Les réponses de l'assistance la placent En attente de l'utilisateur. Les messages résolus restent enregistrés. Envoyer un autre message rouvre automatiquement la conversation pour que l'assistance puisse vous aider de nouveau.
Référence des raccourcis clavier
Le focus compte
Les raccourcis s'appliquent à l'éditeur, au champ de recherche, à l'onglet de requête ou au séparateur ayant le focus. Desktop utilise les conventions du système d'exploitation. Un raccourci de remplacement du panneau de recherche ne doit pas exécuter de SQL. Ouvrez l'aide avec le point d'interrogation ou F1 dans l'espace de travail pour consulter la même référence.
Espace de requêtes
Éditeur SQL
Navigation et résultats
Boîtes de dialogue et aide
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.
Gérer 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.
Télécharger le bon installateur de bureau
Ouvrez Téléchargements sur le site web ou suivez Télécharger SQL Hop Desktop après connexion. Windows et Mac sont détectés lorsque c'est possible ; changez manuellement de plateforme si nécessaire. Sur Mac, À propos de ce Mac affiche Puce pour Apple Silicon ou Processeur : Intel pour le matériel Intel. La détection automatique du système peut ne pas identifier le processeur.
Vérifier la version
Chaque plateforme publiée indique la version, les notes de version, la taille et SHA-256. Une plateforme sans version publiée ne propose pas encore de téléchargement. Choisissez le fichier correspondant à votre système ; un installateur pour un autre processeur n'est pas une voie de mise à jour automatique.
Liens de téléchargement
Les liens privés R2 signés durent 15 minutes. Si un lien expire, revenez dans Téléchargements pour en obtenir un nouveau. Un fichier déjà enregistré sur votre ordinateur reste à votre disposition ; cette expiration est différente de celle d'un fichier temporaire d'exportation en arrière-plan.
Installer et se connecter
Utilisez un compte SQL Hop d'essai approuvé ou payant pour l'activation en ligne, puis connectez Oracle séparément. Mettre à jour une application ne synchronise pas automatiquement le SQL local enregistré entre ordinateurs.
Enregistrer ou remplacer votre ordinateur de bureau
Un ordinateur par utilisateur
La première connexion de bureau en ligne réussie enregistre une clé publique cryptographique d'appareil. Un compte ou une place possède un seul enregistrement. L'enregistrement d'un autre ordinateur est rejeté tant que l'enregistrement actuel n'est pas libéré. SQL Hop n'utilise pas d'adresse MAC ni de numéro de série du disque pour cet enregistrement.
Transférer vers un nouvel ordinateur
- Connectez-vous sur le site web et ouvrez Sécurité du compte.
- Vérifiez votre identité avec votre mot de passe de l'application et un facteur existant s'il est activé.
- Repérez Ordinateur de bureau enregistré et choisissez Transférer vers un autre ordinateur.
- Confirmez Libérer l'enregistrement, puis connectez-vous en ligne dans Desktop sur le nouvel ordinateur.
Ancien ordinateur
L'ancien appareil est rejeté lors de sa prochaine validation. S'il est hors ligne, il ne peut utiliser que son autorisation déjà signée, pendant un maximum de 48 heures depuis la dernière réussite et sans dépasser l'expiration connue de l'abonnement ou de l'essai. Le transfert ne garantit pas une révocation hors ligne immédiate.
Protéger le travail local
Le SQL local, les résultats et les identifiants Oracle ne sont pas transférés automatiquement. Exportez des fichiers SQL ou protégez une sauvegarde locale autorisée avant de remplacer un ordinateur. Ne supprimez pas le dossier de données de l'application pour accélérer un transfert.
Validation quotidienne et interruptions du serveur de comptes
Première activation et vérifications normales
La première activation nécessite une connexion en ligne. Un ordinateur enregistré tente une validation au démarrage et toutes les 24 heures tant que l'application reste ouverte. Les opérations locales répétées n'envoient pas une demande de licence toutes les quelques secondes. L'IA partagée, l'assistance, les téléchargements de métadonnées et les autres fonctions en ligne peuvent effectuer leurs propres demandes.
Serveur de comptes indisponible
Un échec de transport ou une panne temporaire du serveur ne permet que l'autorisation signée restante. La nouvelle tentative est prévue 24 heures après un échec de vérification ; le démarrage tente aussi une validation. L'accès s'arrête au plus tard 48 heures après la dernière réussite, ou à la fin connue de l'essai ou de l'abonnement si elle survient avant. Rouvrir, réinstaller ou une demande échouée n'accorde pas de temps supplémentaire. Mémoriser est nécessaire pour reprendre automatiquement un compte autorisé existant ; une déconnexion explicite supprime l'autorisation en cache.
Refus explicite
Une réponse indiquant un blocage, une révocation ou une expiration arrête les nouvelles requêtes, les nouvelles connexions et les exportations. Le SQL, les résultats, les filtres et les sélections existants restent disponibles. Une validation en ligne réussie ou une nouvelle connexion autorisée est nécessaire pour reprendre ; une panne réseau n'efface pas un refus explicite antérieur.
Autres services
Les requêtes Oracle ont toujours besoin d'un accès réseau à Oracle. L'IA d'organisation nécessite le service de comptes et le fournisseur d'IA ; l'IA personnelle nécessite son fournisseur et une autorisation permise existante. L'autorisation hors ligne ne fait pas fonctionner ces services sans réseau.
Horloge et permissions
Maintenez l'horloge de l'ordinateur à l'heure. Un retour en arrière peut bloquer l'autorisation jusqu'à sa correction. Les changements d'accès à l'appareil, de configuration d'instance et de permissions d'IA personnelle peuvent attendre la prochaine vérification pour atteindre un appareil en cours d'utilisation. La période d'interruption est une autorisation limitée, pas une garantie de disponibilité.
Visite de démarrage et rappel de téléchargement du bureau
Quand elle apparaît
Un compte admissible autre que celui du super administrateur peut voir la visite en trois étapes à sa première connexion web, uniquement s'il ne s'est jamais connecté auparavant. Les comptes existants et les connexions sur bureau ne la lancent pas automatiquement. La visite explique les téléchargements, les connexions SQL Hop et Oracle distinctes et la gestion du compte et de la facturation sur le web.
Affichage unique
SQL Hop enregistre la préférence du compte avant d'ouvrir la visite. La fermer, Escape, Terminer, actualiser la page ou se reconnecter ne la fait pas réapparaître. Si la préférence du compte ne peut pas être enregistrée, l'application n'affiche pas de visite non attribuée et n'interrompt pas la connexion.
La rouvrir
Sélectionnez Visite de démarrage dans la barre latérale du compte pour la revoir manuellement. Cela ne rétablit pas l'affichage automatique. Les liens de téléchargement s'ouvrent séparément pour garder disponible votre page de compte connectée.