전체 참고 문서 보기
검색과 주제 탐색에는 JavaScript가 필요합니다. 전체 내용은 아래에서 볼 수 있습니다.
SQL Hop 시작하기
필요한 사항
- 승인된 조직에 속한 활성화된 SQL Hop 계정과, 이용 자격을 갖춘 유효한 체험 또는 유료 구독.
- 컴퓨터에 맞는 SQL Hop Desktop과 최초 활성화에 필요한 인터넷 연결.
- 조직 관리자가 설정한 조직 인스턴스와 본인에게 허가된 Oracle 자격 증명.
계정 웹사이트와 쿼리 앱
일반 웹 계정에는 SQL 작업 공간, 저장된 쿼리/기록 메뉴 또는 쿼리 도구가 표시되지 않습니다. 조직 관리자는 웹사이트에서 인스턴스와 구성원을 계속 설정합니다. 웹 편집기는 향후 명시적으로 활성화할 수 있도록 유지되지만, 현재 고객이 쿼리를 실행하는 수단은 아닙니다.
첫 쿼리 성공하기
- 계정을 만들고 활성화한 다음 필요한 조직 또는 초대 승인을 기다립니다.
- 다운로드를 열고 Windows, Mac Intel 또는 Mac Apple Silicon을 선택합니다. SQL Hop Desktop을 설치합니다.
- SQL Hop 계정으로 온라인 로그인합니다. 사용자/좌석에 컴퓨터 한 대가 등록됩니다.
- 조직의 인스턴스를 선택하고 본인의 Oracle 자격 증명으로 연결합니다.
- 아래의 안전한 SQL을 실행합니다. 성공한 결과에는 CONNECTION_OK = 1이 포함됩니다.
SQLSELECT 1 AS CONNECTION_OK
FROM dual
작업 계속하기
편집, 디자이너, 결과 및 내보내기 가이드를 살펴보세요. 데스크톱에서 저장한 쿼리는 해당 컴퓨터에 남습니다. 웹사이트는 이 로컬 데이터베이스의 동기화된 사본이 아닙니다.
웹, 데스크톱 및 접근 규칙
승인되고 이용 자격을 갖춘 조직에는 승인 시점부터 시작하는 일회성 30일 체험이 제공되며, 관리자와 대기 중인 초대를 포함해 최대 10명이 이용할 수 있습니다. 체험 쿼리는 SQL Hop Desktop에서 실행합니다.
유료 사용자도 데스크톱에서 쿼리합니다. 웹사이트는 계정 보안, 구독/결제 및 지원을 제공합니다. 조직 관리자는 웹사이트에서 조직 구성원, 인스턴스 및 허용할 AI 접근을 설정합니다. 고객 웹사이트에서는 SQL 편집, 실행, 저장된 쿼리/기록 및 AI 쿼리 도구가 숨겨집니다. 최고 관리자는 권한이 부여된 웹 실행을 유지합니다.
데스크톱은 설정된 Oracle 보고 서비스로 SQL을 직접 전송합니다. 결과, 로컬 쿼리, 디자이너 상태, 기록 및 내보내기 작업은 컴퓨터에 남습니다. 선택적 AI 기능은 검토한 SQL과 지시 사항을 설정된 서비스로 보내며, 결과 행은 보내지 않습니다. 계정/장치/구독 확인은 SQL Hop에 연결합니다.
최초 활성화에는 온라인 로그인이 필요합니다. 등록된 데스크톱 이용 권한은 시작 시 및 앱이 열려 있는 동안 24시간마다 확인됩니다. 계정 서버에 연결할 수 없으면 기존 서명된 권한으로 마지막 검증 성공 이후 최대 48시간까지 로컬 작업을 허용할 수 있으나, 알려진 체험 또는 구독 종료 시점을 넘을 수 없습니다. 명시적 차단/만료/철회 응답은 새 쿼리와 내보내기를 중단합니다. 재시작해도 기한은 초기화되지 않습니다.
데스크톱 작업은 웹이나 다른 컴퓨터로 자동 동기화되지 않습니다. 기존 웹 초안과 저장된 쿼리는 유지되며, 접근 방식 변경으로 이동되거나 삭제되지 않습니다. 작업 공간을 이용할 수 있는 곳에서 SQL 파일 가져오기/다운로드를 사용하세요. 운영자는 향후 배포에서 웹 실행을 명시적으로 다시 활성화할 수 있습니다.
조직 만들기 및 계정 활성화
계정 만들기
- 공개 웹사이트에서 계정 만들기를 선택합니다.
- 요청된 조직, 연락처 및 계정 정보를 입력합니다. 본인이 관리하는 이메일을 사용하세요.
- 활성화 이메일을 열고 링크를 따라 비밀번호를 설정합니다.
- 플랫폼 소유자가 조직을 승인할 때까지 기다립니다.
승인과 체험 시작
활성화는 이메일 수신함에 접근할 수 있음을 증명하며, 조직 승인은 아닙니다. 최고 관리자 승인 전까지 작업 공간 접근은 차단됩니다. 30일 체험은 가입이나 이메일 활성화가 아닌 승인 시 시작합니다.
기존 또는 비활성화된 계정
새 계정을 만들지 말고 기존 자격 증명이나 비밀번호 재설정을 사용하세요. 계정이 비활성화되었다면 조직 관리자에게 문의하세요. 같은 회사 도메인이나 Oracle 인스턴스를 사용하는 새 조직도 독립적으로 구독할 수 있으나, 각 사용자의 이전 체험 사용 여부는 계속 확인됩니다.
이메일을 받지 못한 경우
스팸함을 확인하고 주소가 맞는지 확인하세요. 만료되거나 취소된 링크는 교체해야 합니다. 샌드박스 이메일 도입 기간에는 전송 제공업체가 수신자 확인을 요구할 수 있습니다. 반복 시도하지 말고 플랫폼 소유자에게 문의하세요.
일회성 체험과 이용 자격
체험 권한
조직 체험은 승인일부터 30일간 지속되며 최대 10개 좌석을 포함합니다. 관리자와 대기 중인 초대도 이 한도에 포함됩니다. 체험 쿼리는 SQL Hop Desktop에서 실행합니다.
모든 참여 사용자 확인
체험 사용은 최초 관리자뿐 아니라 사용자별로 추적됩니다. 관리자가 되거나 새 조직을 만들거나 취소 또는 재가입해도 두 번째 체험이 제공되지 않습니다. 이전 체험 사용자를 초대해 무료 이용을 반복할 수 없습니다. 예외는 최고 관리자만 허용할 수 있습니다.
독립적인 팀
이메일 도메인이나 Oracle 서버가 같다는 이유만으로 별도 팀의 구독이 차단되지는 않습니다. 각 사용자의 체험 신원 확인은 계속 적용됩니다.
체험 만료 시
쿼리 접근은 중단되지만 계정과 저장된 SQL은 유지됩니다. 조직이 구독할 수 있도록 계정 및 결제 접근은 웹에 남습니다. 체험 종료 후 데스크톱 쿼리에는 활성 유료 요금제가 필요합니다.
데스크톱 장치와 검증
기명 사용자마다 등록된 컴퓨터 한 대를 사용합니다. SQL Hop Desktop에서 온라인으로 활성화하세요. 검증은 시작 시 및 열려 있는 동안 24시간마다 실행됩니다. 계정 서버를 이용할 수 없으면 기존 서명된 권한으로 마지막 검증 성공부터 최대 48시간까지 로컬 작업을 허용하되, 알려진 체험 또는 구독 종료 시점이 상한입니다. 명시적 차단, 철회 또는 만료 응답은 새 쿼리와 내보내기를 중단합니다. 기존 SQL과 결과는 유지됩니다. 재시작으로 권한이 연장되지는 않습니다.
컴퓨터 교체
웹사이트에서 계정 보안을 열고 비밀번호와 기존 인증 수단으로 본인 확인한 뒤 다른 컴퓨터로 이전을 선택합니다. 새 컴퓨터에서 로그인하세요. 이전 컴퓨터는 다음 검증이나 기존 서명된 기한까지만 계속 이용할 수 있습니다.
로그인, 로그아웃 및 세션 교체
로그인
Oracle 자격 증명이 아닌 SQL Hop 이메일과 비밀번호를 사용하세요. 설정된 MFA 단계를 완료합니다. 데스크톱은 계정에 등록된 인증 방법인 인증 앱 코드, 복구 코드 또는 보안 키/패스키를 제공합니다. 보안 키 인증은 등록된 SQL Hop 호스트 이름용 임시 보안 창을 엽니다.
웹 및 데스크톱 세션
웹과 데스크톱 세션은 별개입니다. 웹사이트 로그인 자체로 데스크톱 권한이 종료되지는 않습니다. 같은 클라이언트 유형의 새 로그인은 이전 세션을 교체할 수 있고, 비밀번호·인증 수단·계정 변경으로 접근이 무효화될 수 있습니다. 사용자/좌석당 등록된 컴퓨터 한 대가 허용됩니다.
웹 시작 안내
대상 신규 계정에는 첫 웹 로그인 시 세 단계 안내가 제공될 수 있습니다. 재방문 계정, 데스크톱 로그인 및 최고 관리자에게는 자동으로 시작되지 않습니다. 안내 표시 전에 계정 설정을 기록하므로 닫기, 완료 또는 새로고침으로 반복되지 않습니다. 사이드바의 시작 안내로 수동 재실행할 수 있으며 자동 표시는 복원되지 않습니다.
로그아웃
상단 표시줄의 문과 화살표 아이콘을 사용합니다. 웹 로그아웃은 홈페이지로 돌아갑니다. 데스크톱 로그아웃은 활성 쿠키와 캐시된 권한을 제거하지만, 저장에 동의한 암호화 앱 자격 증명은 유지합니다. 저장된 앱 자격 증명으로 로그인을 사용해 새 온라인 로그인을 시작하세요. 저장된 로그인 삭제는 해당 자격 증명을 제거합니다.
유휴 시간
최고 관리자를 포함한 모든 웹 계정은 10분간 활동이 없으면 로그아웃되며, 8시간이 지나면 다시 로그인해야 합니다. 백그라운드 세션 확인은 이 시간 제한을 연장하지 않습니다. 데스크톱 앱에서는 최고 관리자의 비활동 로그아웃 면제가 유지됩니다. 일반 데스크톱 계정에는 유휴 만료 30초 전에 경고가 표시되며, 연장은 5분을 추가하고 이후 연장도 같습니다. 경고를 무시하면 세션이 종료됩니다. 명시적 로그아웃, 철회 및 계정 제한은 계속 적용됩니다. 유휴 규칙은 24시간 장치 확인과 별개이며 오프라인 권한을 연장하지 않습니다.
앱 비밀번호 활성화 또는 재설정
비밀번호 재설정
- 웹 로그인 페이지에서 비밀번호 찾기를 선택합니다.
- 계정 이메일을 입력하고 요청을 제출합니다.
- 가장 최근 재설정 이메일을 열고 링크를 사용합니다.
- 양식 요구 사항에 맞는 비밀번호를 입력하고 확인합니다.
- 로그인으로 돌아가 새 비밀번호를 사용합니다.
링크 오류
재설정 및 활성화 링크는 만료되며 한 번만 사용할 수 있습니다. 새 요청 후 이전 링크가 무효가 될 수 있습니다. 전달하거나 지원 메시지에 붙여 넣지 마세요. 필요하면 새 링크를 요청하세요.
승인 대기 조직
조직 승인 전에도 비밀번호 재설정은 가능할 수 있습니다. 승인 요건을 우회하거나 새 체험을 시작하지는 않습니다. 성공한 재설정은 감사 로그에 기록됩니다.
두 가지 별도 신원
앱 비밀번호를 재설정해도 Oracle 자격 증명은 재설정되지 않고 2단계 인증도 제거되지 않습니다. 해당 변경은 관련 관리자에게 문의하세요.
인증 앱 코드, 물리 키 및 복구 코드
웹에서 계정 보안 열기
탐색 메뉴의 계정 보안 또는 상단 계정 아이콘을 사용합니다. 변경 전에 요구되는 경우 현재 앱 비밀번호와 기존 인증 수단을 확인합니다. 인증된 보안 설정 창은 일시적으로만 유효합니다.
인증 앱
인증 앱 설정을 선택하고 원하는 인증 앱으로 QR 코드를 스캔한 뒤 현재 6자리 코드를 입력합니다. 설정 완료를 확인한 후 사용하세요.
물리 보안 키
물리 보안 키 등록은 외부 USB/NFC 키를 요청합니다. 브라우저 안내에서 물리 키를 선택한 뒤 PIN 또는 터치 요청을 완료합니다. 컴퓨터에 저장된 플랫폼 패스키는 물리 키와 다릅니다. 브라우저 지원 및 장치 정책이 안내에 영향을 줄 수 있습니다.
복구 코드
코드를 생성해 앱 외부에 안전하게 보관하세요. 각 코드는 한 번만 사용할 수 있습니다. 새 세트를 생성하면 이전 세트는 무효화됩니다. 복구 코드를 지원팀에 보내지 마세요.
데스크톱과 호스트 이름
데스크톱은 계정에서 사용할 수 있는 등록된 인증 방법을 표시합니다. 보안 키 / 패스키를 선택해 임시 HTTPS 인증 창을 열고, 브라우저 키 안내를 완료한 뒤 앱의 로그인이 끝나도록 기다립니다. WebAuthn 키는 등록한 호스트 이름에 속합니다. 숫자 LAN IP는 현재 물리 키 설정에 적합하지 않습니다. 계정 보안에 표시된 승인된 호스트 이름을 사용하세요. 인증서 경고를 우회하지 마세요.
접근할 수 없게 된 경우
권한 있는 조직 관리자 또는 최고 관리자는 요청과 자신의 신원을 확인한 뒤 허용된 계정 범위 내에서 등록된 인증 수단을 재설정할 수 있습니다. 사용자는 다시 등록해야 합니다. 인증 수단 재설정은 Oracle 인증을 변경하지 않습니다.
앱 및 Oracle 자격 증명 기억하기
앱 계정 기억하기
데스크톱 로그인 시 앱 로그인 기억 및 이 컴퓨터에서 로그인 유지를 선택합니다. 계정 서버, 사용자 이름, 비밀번호 및 저장된 세션은 운영체제 보호로 암호화됩니다. 재시작 시 로그인 기억 기능은 온라인 검증을 시도한 다음 서명된 장치 권한으로 이전에 등록한 계정을 재개할 수 있습니다. 계정 서버를 이용할 수 없으면 남은 승인 유예 기간만 적용됩니다. 그 외에는 저장된 앱 자격 증명으로 로그인을 사용하고 필요하면 새 MFA를 완료하세요. 명시적 로그아웃은 캐시된 권한을 제거하며 오프라인 로그인을 만들지 않습니다.
Oracle은 별도로 기억하기
Oracle 연결 양식에서 연결에 성공하기 전에 이 컴퓨터에 Oracle 자격 증명 기억을 선택합니다. 다음에는 저장된 자격 증명으로 연결을 사용합니다. 비밀번호 필드는 의도적으로 비어 있을 수 있으며, 암호화 항목이 없다는 뜻은 아닙니다. 체크박스는 기존 저장 항목을 반영합니다.
제거 및 격리
저장된 로그인 삭제는 앱 자격 증명을 제거합니다. 명시적 데스크톱 로그아웃은 세션을 종료하고 저장된 세션 쿠키를 제거하지만, 새 로그인을 위해 저장에 동의한 암호화 사용자 이름과 비밀번호는 유지합니다. 유휴 만료는 암호화 앱 자격 증명을 삭제하지 않고 세션을 종료합니다. Oracle 연결 해제는 활성 연결을 지우고, Oracle 저장된 자격 증명 삭제는 저장 항목을 제거합니다. 보호된 OS 암호화를 이용할 수 없으면 저장할 수 없습니다.
범위
Oracle 항목은 앱 계정, 계정 서버 주소, 인스턴스 및 보고서 설정별로 격리됩니다. 다른 앱 계정이나 변경된 인스턴스 설정은 다른 항목을 재사용하지 않습니다. localhost와 LAN URL 중 어디로 로그인하느냐에 따라 다른 로컬 계정 범위가 선택될 수 있습니다.
문제 해결
동일한 패키지 앱과 계정 서버 URL을 사용하세요. 업데이트 후에는 재빌드된 앱을 직접 다시 여세요. 이전 버전이 저장 항목을 제거했다면 한 번 다시 입력하고 기억을 선택하세요. OS 암호화 저장소는 로그인된 컴퓨터를 제어하는 사람이 비밀 정보에 절대로 접근할 수 없다는 보장은 아닙니다.
SQL Hop Desktop 열기 및 업데이트
다운로드 및 활성화
- 웹사이트에서 다운로드를 엽니다. OS 감지는 Windows 또는 Mac을 추천합니다. Mac에서 아키텍처를 감지하지 못하면 Intel 또는 Apple Silicon을 선택하세요.
- 버전, 릴리스 노트, 파일 크기 및 SHA-256 체크섬을 확인합니다. 게시된 설치 프로그램만 제공됩니다.
- SQL Hop Desktop을 설치하고 엽니다. 앱은 https://sqlhop.com에 자동 연결됩니다. 입력할 계정 서버 URL은 없습니다. Oracle 인스턴스는 조직 관리자가 별도로 설정합니다.
- 승인된 활성 체험 또는 유료 SQL Hop 계정으로 로그인하고 지원되는 MFA를 완료합니다. 최초 온라인 활성화로 이 컴퓨터가 좌석에 등록됩니다.
- 관리자가 설정한 Oracle 인스턴스를 선택하고 본인의 Oracle 자격 증명으로 연결합니다.
업데이트
도움말 → 업데이트 확인…
플랫폼에 맞는 게시된 릴리스를 설치하고 직접 다시 여세요. 웹사이트 업데이트는 이미 실행 중인 데스크톱 바이너리를 업데이트하지 않습니다. 로컬 작업과 암호화 자격 증명을 보관하는 앱 데이터 디렉터리를 유지하세요. 시작 화면에 버전이 표시되며 SQL Hop 정보에는 빌드 날짜도 표시됩니다.
로컬 작업과 권한
저장된 쿼리, 디자이너 상태, 초안, 결과 스냅샷, 기록, 내보내기 및 다운로드된 메타데이터는 로컬에 있습니다. 서명된 장치 권한은 제한된 계정 서버 중단을 지원하며 무제한 오프라인 사용은 아닙니다. Oracle과 AI에는 각각의 네트워크 서비스가 여전히 필요합니다.
관리
계정 보안, 장치 이전, 조직 관리 및 결제는 웹사이트에서 관리합니다. 데스크톱에는 관리 콘솔이 없습니다.
HTTPS, 로컬 테스트 및 계정 서버 주소
운영 데스크톱 로그인
SQL Hop Desktop은 https://sqlhop.com에 자동 연결됩니다. 로그인 화면은 서버 URL을 요청하지 않습니다. Oracle 인스턴스 주소는 관리자가 관리하는 별도 조직 설정입니다.
로컬 웹 개발
서버 컴퓨터에서
localhost와 127.0.0.1은 해당 컴퓨터를 가리킵니다. 별도의 Windows 또는 Mac 장치는 이 주소로 서버에 접근할 수 없습니다.
홈 네트워크를 통해
운영자가 제공한 HTTPS 주소를 포트와 함께 사용하세요. 개발 예시는 https://192.168.86.20:8443입니다. 주소는 네트워크에 따라 바뀔 수 있습니다. 해당 장치의 인증서 설정 지침을 사용하고 신뢰가 설정되지 않았다면 운영자에게 문의하세요.
오류 구분
- 사이트에 연결할 수 없음: 서버 상태, 주소, 포트, 네트워크 및 방화벽을 확인하세요.
- 인증서 경고: 신뢰/호스트 이름 설정이 불완전합니다. 신뢰할 수 없는 연결로 자격 증명을 보내지 마세요.
- Oracle 원격 로그인 제한: HTTP 개발 포트 대신 설정된 HTTPS 게이트웨이를 사용하세요.
- 키 등록 중 잘못된 도메인: 물리 키/WebAuthn 출처 설정에는 지원되는 호스트 이름이 필요합니다. 일반 비밀번호 로그인과는 별개입니다.
일관된 데스크톱 계정 범위
로컬 프로필에는 동일한 HTTPS 계정 서버 URL을 유지하세요. 서버 출처를 바꾸면 별도 계정 범위가 만들어져 로컬 저장 작업이나 Oracle 자격 증명이 없는 것처럼 보일 수 있습니다.
Oracle 연결 및 연결 해제
연결
- 작업 공간에서 설정된 인스턴스를 선택합니다.
- 연결을 선택합니다. 연결이 끊긴 상태에서 실행을 누르면 SQL Hop이 양식을 열고 해당 실행 요청을 기억합니다.
- Oracle 사용자 이름과 비밀번호를 입력한 뒤 연결 또는 검증 후 연결을 선택합니다.
- 한 행의 QueryRunner 확인을 기다립니다. 요청이 진행되는 동안 입력은 비활성화됩니다.
- 녹색 연결 표시가 활성 연결을 확인합니다. 대기 중인 실행은 관련 탭, SQL 및 선택 영역이 바뀌지 않은 경우에만 성공 후 계속됩니다.
자격 증명 처리
최고 관리자 웹 실행에 한해 Oracle 자격 증명은 로그인된 백엔드 세션에 최대 30분 동안 임시 보관되며 데이터베이스, 파일 또는 브라우저 저장소에는 저장되지 않습니다. 데스크톱 자격 증명은 컴퓨터에 남으며 선택적으로 OS 암호화로 저장할 수 있습니다. Oracle 양식에 앱 자격 증명을 입력하지 마세요.
연결 해제
연결 해제/연결 상태의 플러그 버튼을 사용합니다. 연결 해제 또는 앱 로그아웃은 활성 연결을 지웁니다. 데스크톱 연결은 계정 서버 재시작과 독립적입니다. 로컬 Oracle 연결이 만료되거나 끊기면 다시 연결하세요. 최고 관리자 웹 연결은 백엔드 재시작 후 재연결해야 합니다. 연결 상태는 본인 세션에 속하며 다른 사용자의 연결은 본인을 인증하지 않습니다.
경계
체험 및 유료 계정은 SQL Hop Desktop에서 연결합니다. 기존 Oracle 브라우저 SSO 쿠키는 재사용하지 않습니다. Oracle 확인 실패를 연결 성공으로 간주해서는 안 됩니다.
SQL Hop Oracle 객체 자동 설정
사전 조건
카탈로그 작성, 데이터 모델 및 보고서 실행 권한을 가진 Oracle 관리자 또는 승인된 보고서 개발자를 사용하세요. SQL Hop은 Oracle 권한을 부여하거나 Oracle 신원 정책을 수정할 수 없습니다. 설정 전에 올바른 HTTPS 인스턴스와 Oracle 데이터 소스를 구성하세요.
자동 설정
- 웹사이트에서 환경을 열고 인스턴스의 설정 작업을 선택합니다. 조직 관리자는 데스크톱 Oracle 연결 양식에서도 누락된 SQL Hop 객체의 자동 설정을 선택할 수 있습니다.
- 표시된 데이터 모델 및 보고서 경로를 검토합니다. 브랜드 기본 경로는 /Custom/SQLHop.com/SQLHop_DM.xdm 및 /Custom/SQLHop.com/SQLHop_Report.xdo입니다. 기존 레거시 프로필은 /Custom/QueryTool/QueryRunner.xdo를 사용할 수 있으므로 의도치 않게 경로를 바꾸지 마세요.
- 일반적으로 ApplicationDB_FSCM인 Oracle 데이터 소스를 확인하고 작업에 사용할 승인된 Oracle 사용자 이름과 비밀번호를 제공합니다.
- 설정을 실행하고 SQL Hop이 누락된 객체를 만들고 CONNECTION_OK = 1로 보고서를 검증할 때까지 기다립니다. Oracle 카탈로그에 객체가 보이는 것만으로 실행 확인이 성공한 것은 아닙니다.
- 검증 후 성공 대화상자를 닫고 쿼리 실행 전에 인스턴스에 연결합니다. 설정 검증 자체로 활성 쿼리 연결이 만들어지지는 않습니다.
처리 중인 설정과 복구
Oracle이 생성 요청을 처리 중일 수 있다면 중복 요청을 제출하지 말고 설정 상태 확인을 사용하세요. 복구는 일치하는 SQL Hop 생성 모델만 변경하고 먼저 백업하며, 관련 없는 기존 모델은 교체하지 않습니다. SQL Hop이 출력 매핑 문제를 식별하면 표시된 복구 작업을 사용하세요.
수동 대안
자동 설정을 이용할 수 없거나 Oracle 관리자가 요구하는 경우에만 수동 설정 가이드를 사용하세요. xdo_cursor와 p_sql_base64, 올바른 출력 매핑 및 일치하는 보고서를 포함한 현재의 완전한 SQLHop_DM 정의를 설치합니다. SQL은 보고서 레이아웃이나 데이터베이스 패키지가 아닌 데이터 모델 데이터셋에 붙여 넣습니다. 소스 ZIP이 자동으로 Oracle 카탈로그 가져오기 아카이브가 되는 것은 아닙니다.
버전 호환성과 권한
이전 모델 정의는 결과를 200행으로 제한하거나 주석 또는 긴 SQL을 거부할 수 있습니다. 백그라운드 내보내기에는 보고서 청크 다운로드 접근도 필요합니다. Oracle 편집기에서 보고서가 작동하는 것만으로 서비스 로그인이 이를 실행하고 다운로드할 수 있다는 증거는 아닙니다. 설정 자격 증명은 해당 작업에 사용하며 선택적 암호화 데스크톱 연결 자격 증명은 별도로 관리합니다.
앱과 Oracle 객체
SQL Hop에서 인스턴스를 제거하면 앱 설정이 제거될 뿐 Oracle 보고서나 저장된 쿼리는 삭제되지 않습니다. 검증된 브랜드 카탈로그 위치로 변경해도 기존 객체는 유지됩니다. 다른 환경에서 사용하기 전에 DEV에서 설정을 테스트하세요.
organization instances 관리
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
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.
Oracle SSO와 지원되는 인증
현재 지원되는 흐름
체험 및 유료 사용자는 데스크톱에서 기존 Oracle 사용자 이름/비밀번호 연결을 사용하며, 최고 관리자는 유지된 웹 커넥터도 사용할 수 있습니다. SQL Hop 앱 로그인과 2단계 설정은 앱 계정을 보호하며 Oracle SSO를 구현하지 않습니다.
브라우저 SSO는 별개
Oracle 로그인 버튼이 Microsoft로 리디렉션되더라도 브라우저 세션이나 신원 토큰이 BI Publisher 서비스를 자동 승인하지는 않습니다. SQL Hop은 브라우저의 Oracle 쿠키를 복사하지 않습니다.
보류된 기능
쿼리 실행을 위한 일반 Oracle SSO는 계속 보류되어 있습니다. 실행 계획에는 네이티브 계획 서비스가 요구할 때 사용하는 자체 데스크톱 Oracle 로그인 창이 있습니다. 이는 QueryRunner 연결을 인증하거나 Safari 쿠키를 복사하지 않습니다. 실제 테넌트 SSO에는 실제 로그인 확인이 여전히 필요합니다. SQL Hop 앱 로그인의 Microsoft SSO도 현재 비밀번호 로그인의 대체 수단으로 활성화되어 있지 않습니다. Oracle 관리자가 해당 흐름을 명시적으로 지원하지 않는 한 Office 365 자격 증명이 Oracle 직접 연결에서 작동한다고 기대하지 마세요.
직접 인증 실패 시
어떤 서비스 신원과 인증 정책으로 설정된 보고서를 실행할 수 있는지 Oracle 관리자에게 문의하세요. 해결책으로 MFA를 비활성화하거나 브라우저 쿠키를 재사용하지 마세요.
SQL 작성과 작업 공간 정리
레이아웃
SQL 편집기와 결과는 창의 남은 높이를 사용합니다. 가로 구분선을 끌어 비율을 바꿀 수 있습니다. 구분선에 초점을 두고 방향키로 크기를 조정하거나 두 번 클릭해 초기화하세요. 어느 창이든 확장해 공간을 확보한 뒤 복원하거나 Escape를 누릅니다.
도구 모음 아이콘으로 실행, 모두 실행, 실행 계획, 중지, 실행 취소, 다시 실행, 선택 영역 대문자/소문자 변환, 글꼴 크기, 찾기 및 바꾸기, SQL 서식 지정, 디자이너, 열, 테이블 설명, 저장, SQL 가져오기/다운로드, 모두 저장, 다른 이름으로 저장 및 허용된 AI를 사용합니다. 아이콘에 마우스를 올리거나 초점을 두면 이름을 확인할 수 있습니다.
기존 결과
편집기 텍스트 변경, 서식 지정 또는 AI 제안 적용/실행 취소를 해도 다른 실행이 대체할 때까지 현재 결과는 유지됩니다. 따라서 표시된 결과가 이전 SQL의 결과일 수 있습니다. 내보내기는 가능한 경우 실행된 SQL 스냅샷을 사용합니다.
반응형 탐색
좁은 창에서는 탐색 메뉴 버튼을 사용합니다. 메뉴를 열어 계정 및 작업 공간 페이지로 이동하고 Escape, 배경 또는 탐색 링크로 닫습니다. 데스크톱은 같은 작업 공간 외관을 사용하며 OS 기본 단축키 관례를 따릅니다.
쿼리 탭과 작업 공간 복원
추가 및 이름 변경
더하기 버튼으로 새 탭을 만듭니다. 이름은 작업 공간 내에서 고유합니다. 탭 이름을 두 번 클릭하거나 탭 이름 변경을 사용합니다. 저장된 쿼리에 표시되는 쿼리 번호는 사용자별로 1부터 시작하며 내부 데이터베이스 ID와는 별개입니다.
최대 100개 탭
작업 공간은 모두 저장 및 복원된 작업 공간을 포함해 열린 탭을 최대 100개 지원합니다. 필요하면 탭 표시줄을 스크롤하세요. 더하기 버튼은 계속 사용할 수 있습니다. 불필요한 탭은 닫으세요. 저장되지 않은 SQL 또는 디자이너 변경이 있으면 버리기 확인이 표시됩니다.
복원
웹 초안은 로그인한 계정에 저장되고 데스크톱 초안은 계정별 로컬 작업 공간에 저장됩니다. 다시 열 때 탭 SQL과 디자이너 데이터를 복원할 수 있습니다. 임시 결과 스냅샷과 매개변수 값은 영구 작업 공간 백업이 아닙니다. 이름을 붙인 쿼리에는 저장을 사용하고 보관할 결과는 내보내세요.
독립적인 결과
탭마다 자체 쿼리/결과 상태를 유지합니다. 모두 실행은 현재 쿼리 탭 안에 결과 집합 탭을 추가합니다. 이를 최상위 쿼리 탭과 혼동하지 마세요.
저장, 다른 이름으로 저장 및 모두 저장
저장
저장 아이콘과 Ctrl+S / Cmd+S는 동일하게 작동합니다. 탭이 저장된 쿼리에 연결되어 있으면 저장이 직접 업데이트합니다. 새 쿼리라면 탭 이름이 미리 입력된 대화상자가 열립니다. 저장은 SQL 자리표시자와 디자이너 상태를 기록하며 매개변수 값은 저장하지 않습니다.
다른 이름으로 저장
다른 이름으로 저장 또는 Ctrl+Shift+S / Cmd+Shift+S로 다른 이름의 쿼리를 만듭니다. 현재 탭은 새 사본에 연결됩니다. 원본은 변경되지 않으며 디자이너 상태도 독립적입니다.
모두 저장
모두 저장은 비어 있지 않은 모든 탭을 해당 이름으로 저장하고 연결된 쿼리를 업데이트하거나 필요하면 새로 만듭니다. 새 SQL을 생성하지 않아도 디자이너만의 변경이 포함됩니다. Windows/Linux는 Ctrl+Alt+S, Mac은 Cmd+Option+S를 사용합니다.
다시 열기
저장된 쿼리에서 쿼리를 엽니다. 디자이너를 복원해 편집할 수 있습니다. 연결된 저장 쿼리가 제거되었거나 이용할 수 없다면 작업을 버리지 말고 편집기 SQL을 유지해 새 사본으로 저장하세요. 데스크톱 저장은 로컬에 남고 웹 저장은 웹 계정에 속합니다.
저장된 쿼리의 폴더
- 저장된 쿼리를 열어 폴더를 만들거나 이름을 변경하세요. 폴더 제목을 클릭하면 펼치거나 접을 수 있습니다. 검색은 접힌 폴더를 포함한 모든 폴더에서 쿼리 번호, 이름 및 SQL을 확인합니다.
- 쿼리 옆의 이동 위치에서 폴더 또는 미분류를 선택하세요. 기존 쿼리와 처음 저장하는 쿼리는 처음에는 미분류에 들어갑니다. 저장된 쿼리를 업데이트해도 폴더는 유지됩니다. 폴더는 본인 계정에만 공개됩니다. 데스크톱 앱의 폴더와 저장된 SQL은 사용자의 컴퓨터에 보관되며 웹에 저장된 쿼리와 별도로 관리됩니다.
- 폴더를 삭제하면 해당 폴더의 쿼리가 미분류로 이동하며, SQL과 쿼리 번호는 유지됩니다.
SQL 파일 열기 및 다운로드
가져오기
SQL 파일 열기를 사용해 .sql 파일을 선택합니다. 내용은 실행 없이 편집기 탭에서 열립니다. 실행 전에 텍스트와 로컬 구문 메시지를 검토하세요. 브라우저 파일 선택기 또는 OS 권한이 필요할 수 있습니다.
다운로드
SQL 파일 다운로드로 편집기 내용을 .sql로 저장합니다. 이는 SQL을 내보내며 결과 행이나 저장된 매개변수 값은 포함하지 않습니다. 텍스트 파일에는 편집 가능한 전체 시각적 디자이너 상태가 포함되지 않습니다.
원본 작업 공간에서 SQL을 다운로드해 대상에서 엽니다. 웹 저장 쿼리와 데스크톱 로컬 저장 쿼리는 별개입니다. 파일을 가져와도 Oracle 접근 권한이 부여되거나 로그인되지는 않습니다.
선택기가 열리지 않을 때
다른 파일 선택기나 모달이 열려 있는지 확인하세요. 데스크톱에서는 재빌드된 패키지 앱과 기본 파일 열기 작업을 사용합니다. 연결 문제를 우회하려고 SQL 파일에 자격 증명을 붙여 넣지 마세요.
서식, 대소문자, 글꼴 크기 및 실행 취소
실행 시 자동 서식 지정 옆의 SQL 서식 지정을 사용합니다. 수동 서식 지정은 편집기 텍스트만 변경하며 자동 서식을 활성화하면 실행 과정에서 서식을 적용합니다. 절 정렬은 SQL Hop 스타일을 따릅니다. ORDER BY는 정렬 예외입니다.
텍스트를 선택하면 대문자 및 소문자 도구가 활성화됩니다. Ctrl/Cmd+Shift+U 또는 Ctrl/Cmd+Shift+L을 사용합니다. 변환은 선택한 리터럴을 포함한 선택 텍스트에 영향을 주므로 실행 전에 검토하세요.
A− 및 A+로 편집기 글자 크기를 조정합니다. SQL 편집기는 고정폭 글꼴로 열과 들여쓰기를 맞춥니다. 브라우저 확대/축소는 전체 인터페이스에도 영향을 줍니다.
실행 취소는 모두 바꾸기와 적용한 AI SQL을 포함한 편집기 변경을 되돌립니다. 다시 실행은 재적용합니다. 이 작업은 SQL을 실행하거나 기존 결과 집합을 지우지 않습니다. 표준 OS 단축키는 키보드 단축키에 나와 있습니다.
SQL 서식 지정 옆 슬라이더 아이콘을 열어 키워드, 테이블/뷰, 별칭, 함수 및 데이터 타입의 대소문자, 절 정렬, 들여쓰기 크기 또는 탭, 표현식 줄바꿈, AND/OR 줄바꿈, 문장 간격, 연산자 간격 및 세미콜론 위치를 설정합니다. 저장 전에 미리 보세요. 설정은 이 장치의 계정별로 기억되며 수동 서식과 실행 시 자동 서식에 적용됩니다. 설정 저장은 편집기 SQL을 변경하거나 실행하지 않습니다. 기본값 복원은 미리보기를 SQL Hop 스타일로 되돌립니다. 초기화를 유지하려면 설정 저장을 선택하세요. 기본값은 SQL 키워드와 함수 이름을 대문자로, 따옴표 없는 테이블/뷰 이름과 별칭을 소문자로 만듭니다. 따옴표로 묶인 식별자, 열 이름, 리터럴 및 매개변수 이름은 대소문자를 유지합니다. 서식 지정 후 실행 취소로 원래 SQL을 복원할 수 있습니다.
SQL 찾기 및 바꾸기
통합 패널 열기
하나의 찾기 및 바꾸기 아이콘을 사용합니다. Ctrl+F / Cmd+F는 찾기, Ctrl+H 또는 Cmd+Option+F는 바꾸기를 엽니다. 찾을 텍스트와 필요할 경우 대체 텍스트를 입력합니다.
일치 항목 탐색
다음 및 이전 버튼, 지원되는 경우 F3/Shift+F3, 또는 Ctrl/Cmd+G와 Shift 조합을 사용합니다. 검색 필드에서 Enter와 Shift+Enter로 항목 사이를 이동합니다. 바꾸기 전에 일치 옵션을 확인하세요.
바꾸기
검색 패널 필드에 초점이 있으면 Ctrl/Cmd+Enter가 다음 일치 항목을 바꿉니다. Windows/Linux의 Ctrl+Alt+Enter 또는 Mac의 Cmd+Option+Enter는 모두 바꿉니다. 이 단축키는 검색 패널에서 SQL을 실행하지 않습니다. 실행 취소로 모두 바꾸기를 되돌릴 수 있습니다.
닫기
Escape를 눌러 패널을 닫고 편집기로 초점을 돌립니다. 기존 쿼리 결과는 계속 표시됩니다.
실시간 SQL 검사와 자동 완성
로컬 문법 피드백
편집기는 입력 중 조인, 하위 쿼리 및 CTE를 포함한 Oracle 스타일 SQL을 검사합니다. SQL을 수정하면 다음 검사 후 진단이 지워집니다. 로컬 검사는 쿼리를 실행하거나 Oracle에 연결하거나 결과를 지우지 않습니다.
최종 판단은 Oracle
로컬 문법 검사는 참고용이며 실행을 차단하지 않습니다. 특정 Oracle 버전의 유효한 구문이 로컬 문법 범위를 벗어날 수 있습니다. 객체 존재, 권한, 타입 규칙, 바인드 의미 및 실행 계획은 여전히 Oracle 검증이 필요합니다. 로컬의 녹색 상태가 실행 성공을 보장하지는 않습니다.
제안
Ctrl+Space로 제안을 요청합니다. 테이블 제안은 사용 가능한 메타데이터를 사용합니다. FROM/JOIN에서 테이블 별칭을 선언한 뒤 alias.를 입력하면 SELECT 목록을 포함해 해당 테이블의 열을 요청할 수 있습니다. 모든 열이 자동으로 SQL에 삽입되거나 로드되지는 않습니다.
제안이 없는 경우
테이블 철자, 별칭 선언 및 선택된 메타데이터 게시본을 확인하세요. 데스크톱은 선택적 자동 완성 패키지를 내려받아 활성화해야 합니다. 테이블 설명과 열은 가져온 메타데이터에 의존하며 실시간 스키마 검사를 보장하지 않습니다.
쿼리 실행, 행 가져오기 및 대기 중지
실행
편집기에 선택 영역이 있으면 선택한 SQL을 실행하고, 없으면 편집기의 단일 문장을 실행합니다. 단축키는 Ctrl+Enter / Cmd+Enter입니다. 여러 문장이 있으면 전체 스크립트를 한 쿼리로 보내지 않고 모두 실행을 사용하도록 안내합니다.
가져올 행 수
가져올 행 수는 한 번의 실행에서 수집할 최대 행 수이며, 현재 대화형 사용에는 최대 10,000행이 제공됩니다. 이미 가져온 행을 한 번에 몇 개 표시할지만 바꾸는 페이지당 행 수와는 별개입니다. 마지막 가져오기 설정은 기억됩니다.
실행 중
Oracle 실행, 가져오기 및 최초 표시까지 회전 표시와 경과 시간이 계속 작동합니다. 데이터가 표시되면 시간이 멈춥니다. 매개변수 입력 시간은 제외됩니다. Oracle 쿼리는 SQL Hop Desktop에서 로컬로 실행됩니다.
중지
실행 옆 중지를 사용해 앱에서 대기를 취소합니다. 대기 요청은 Oracle에 접속하기 전에 제거할 수 있습니다. 이미 제출된 요청은 Oracle 데이터베이스 실행이 계속될 수 있습니다. 중지는 데이터베이스 실행의 강제 종료를 보장하지 않습니다.
실패 시
오류 세부 정보를 읽으세요. SQL은 편집기에 남습니다. 실패한 실행은 이전 결과 행을 새 결과인 것처럼 표시하지 않습니다.
Oracle 실행 계획 생성
계획 생성
- 원하는 Oracle 환경에 연결합니다.
- SELECT 또는 WITH 쿼리 하나를 선택하거나 편집기에 단일 문장만 둡니다.
- SQL 도구 모음에서 실행 계획을 선택합니다.
- 요청되는 타입 지정 매개변수 값을 입력합니다.
- Oracle 로그인 창이 나타나면 원하는 Oracle 계정으로 로그인합니다. 로그인 후 계획이 자동으로 열립니다.
복사/붙여넣기나 다운로드 파일 가져오기는 필요하지 않습니다. 실행 계획은 결과 행을 얻기 위해 선택 쿼리를 실행하지 않습니다. 기존 결과와 편집기 SQL은 계속 사용할 수 있습니다.
계획 읽기
작업을 확장하거나 접어 트리, 예상 행 수, 비용, 객체, 조건 및 Oracle 참고 사항을 확인합니다. 비용은 최적화 도구의 추정치이며 경과 초가 아닙니다. 상위 비용에는 하위 작업이 이미 포함됩니다. 이는 예상 계획이며 실측 실행 통계가 아닙니다.
비교 및 다운로드
비교 기준으로 사용을 선택해 같은 뷰어에서 다른 계획을 비교합니다. 동일한 SQL과 매개변수 값을 비교하세요. 예상 비용이 낮다는 사실만으로 쿼리가 빠르다는 증거는 아닙니다. 계획 다운로드는 원래 Oracle 계획 텍스트를 저장합니다.
Oracle 접근과 로그인
SQL Hop은 Oracle의 기본 Generate Explain Plan 서비스와 설정된 보고서의 데이터 소스를 사용합니다. 별도의 실행 계획 보고서는 만들지 않습니다. 데스크톱 로그인 세션은 Safari와 별개이며 Oracle 연결 해제, 재연결, 계정 로그아웃 또는 연결 만료 시 지워집니다. 요청되면 다시 로그인하세요. 이 로그인 흐름은 실행 계획용이며 일반 쿼리 실행은 기존 Oracle 연결을 계속 사용합니다.
가용성과 문제 해결
여러 문장과 PL/SQL 블록은 거부됩니다. 기본 서비스와 인증 정책은 Oracle 인스턴스에 따라 다릅니다. 로그인된 기본 요청과 안전한 SELECT 1 FROM DUAL 계획은 검증되었지만, 테넌트의 실제 데스크톱 SSO 흐름은 실제 로그인 확인이 여전히 필요합니다. 로그인을 취소했다면 실행 계획을 다시 시도하세요. 접근 또는 SQL 오류라면 BI Publisher에서 같은 SQL과 데이터 소스를 확인하고 민감 정보를 제거한 오류 코드를 관리자에게 전달하세요. Oracle 보안 검사를 비활성화하지 마세요. 웹 실행은 허용된 계정으로 제한되며 웹 기본 계획에는 Oracle이 기존 연결 자격 증명을 수락해야 한다는 조건도 있습니다.
AI 설명과의 차이
AI 설명은 설정된 AI 서비스로 SQL을 설명합니다. 실행 계획은 Oracle 최적화 계획을 가져오며 AI를 사용하지 않습니다.
모두 실행과 개별 결과 집합
편집기 준비
읽기 쿼리를 세미콜론으로 구분합니다. 모두 실행 또는 Ctrl/Cmd+Shift+Enter를 사용합니다. SQL Hop은 하나의 Oracle 스크립트가 아닌 문장별 순차 실행을 수행합니다.
매개변수
매개변수가 있는 문장마다 값을 요청합니다. 값은 해당 실행에만 사용됩니다. 대기 요청을 실행하지 않으려면 매개변수 대화상자를 취소하세요. 계속하기 전에 혼합된 렉시컬 매개변수를 검토하세요.
결과
결과 집합 탭을 전환해 각 문장 출력을 확인합니다. 결과 집합마다 자체 필터, 정렬 순서 및 선택 행을 유지합니다. 내보내기는 해당 집합의 제어와 실행된 SQL 스냅샷을 사용합니다.
오류와 취소
모두 실행은 오류 후 중단하며 나머지 문장을 실행하지 않습니다. 중지는 Oracle 실행 제약 범위에서 앱 요청을 취소합니다. 배치 경과 시간은 전체 실행을 나타내며 병렬 실행의 증거가 아닙니다.
이름 있는 :NAME 매개변수
자리표시자 작성
SQLSELECT :P_NAME AS NAME
FROM dual
WHERE item_number = :X처럼 일반 값 위치에 :NAME 자리표시자를 사용합니다. 실행하면 텍스트, 숫자, 날짜 또는 NULL 타입의 대화상자가 열립니다. O'Brien 같은 아포스트로피는 일반 텍스트로 입력하고 직접 SQL 따옴표로 감싸지 마세요.
실행 또는 취소
Enter는 대화상자를 한 번 제출합니다. 취소, Escape 또는 바깥 클릭은 쿼리를 실행하거나 쿼리 기록을 추가하지 않고 닫습니다. 마지막으로 확인한 값과 타입은 실패한 쿼리 이후를 포함해 동일 쿼리 탭과 Oracle 환경의 후속 실행에 미리 입력됩니다. 모두 실행의 문장마다 별도 항목을 유지합니다. 취소는 마지막 확정 값을 바꾸지 않습니다. 탭 닫기, 로그아웃, 페이지 새로고침 또는 앱 닫기는 유지된 값을 지웁니다.
세션 메모리와 개인정보
유지된 값은 앱 메모리에만 있습니다. 복원된 탭, 데이터베이스 기록, 브라우저 저장소 또는 저장된 쿼리 파일에는 포함되지 않습니다. 다른 탭이나 환경은 별도로 시작합니다.
저장된 쿼리, SQL 파일 다운로드 및 Excel 결과 내보내기의 선택적 SQL 워크시트는 자리표시자를 유지합니다. 매개변수 값은 쿼리 기록이나 앱 로그에 저장되지 않으며 실패한 매개변수 기록은 민감 정보를 제거한 오류를 사용합니다. 값은 의도적으로 내보내는 결과 행에 영향을 주거나 표시될 수 있습니다.
구현 제한
현재 :NAME 지원은 보고서 요청 전에 타입에 맞게 이스케이프한 치환을 사용합니다. Oracle 기본 DBMS_SQL 바인딩은 아닙니다. Oracle 기본 바인딩은 보류되어 있습니다. 값에는 자리표시자를 유지하고 렉시컬 매개변수는 의도한 SQL 조각에만 사용하세요.
렉시컬 &NAME 및 &&NAME 매개변수
렉시컬과 값의 차이
:NAME 매개변수는 타입이 있는 값을 나타냅니다. 렉시컬 &NAME 또는 &&NAME은 열 목록이나 조건 같은 SQL 조각을 삽입합니다. SQL 조각은 값처럼 자동으로 따옴표 처리되지 않습니다.
SQLSELECT &COLUMNS
FROM egp_system_items_b esib
WHERE esib.item_number = :ITEM_NUMBER
실행 전 검토
실행은 렉시컬 조각과 기타 값을 요청합니다. SQL 검토를 선택해 확장된 SQL을 확인한 뒤 검토된 버전을 실행합니다. 조각에 추가 :NAME 자리표시자가 있으면 추가 필드를 채우고 다시 검토합니다. 값을 바꾸면 이전 검토는 무효가 됩니다.
세션 내에서만 재사용
두 렉시컬 형식 모두 이 탭과 환경의 마지막 확정 조각을 미리 입력할 수 있지만 실행할 때마다 SQL 검토가 필요합니다. 어느 형식도 값을 영구 저장하지 않습니다. 탭 닫기, 로그아웃 또는 앱 닫기는 유지된 조각을 지웁니다. 취소나 Escape는 쿼리를 실행하지 않습니다.
의도적으로 사용
렉시컬 조각은 쿼리 구조를 바꿀 수 있습니다. 신뢰할 수 없는 조각을 무해한 스칼라 값처럼 취급하지 마세요. 원래 편집기 자리표시자는 그대로 유지되며 값은 저장된 SQL과 함께 보관되지 않습니다.
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.
시각적으로 쿼리 만들기
디자이너 열기
편집기 도구 모음에서 쿼리 디자이너를 선택합니다. 사용 가능한 메타데이터를 검색해 테이블을 추가합니다. 열 참조와 조인이 명확하도록 서로 다른 별칭을 지정하세요.
열 선택
필요한 출력 열과 별칭을 선택합니다. 선택기에 표시되려면 메타데이터에 테이블과 열이 있어야 합니다. 테이블 선택은 데이터베이스 접근 권한을 부여하지 않습니다.
조인 추가
참여하는 테이블 별칭, 조인 유형 및 일치하는 열을 선택합니다. 조건이 의도한 관계를 나타내는지 확인하세요. 디자이너는 업무 의미를 추론하거나 중복 행이 없는 조인을 보장할 수 없습니다.
생성 및 검토
준비되면 편집기에 SQL을 생성합니다. 전체 문장을 검토하고 명시적으로 실행하세요. 필터, 정렬 및 집계에는 별도 디자이너 가이드가 있습니다. 생성은 Oracle SQL을 자동 실행하지 않습니다.
직접 작성한 SQL
디자이너는 쿼리의 설계 모델을 저장합니다. 임의의 편집기 변경이 모델로 역변환된다고 생각하지 마세요. 수동 편집 SQL을 대체하기 전에 생성된 SQL을 검토하세요.
디자이너 WHERE 조건 및 ORDER BY
WHERE 조건
선택한 테이블 별칭과 열로 조건을 추가합니다. 제공되는 비교를 선택하고 원하는 값이나 매개변수를 지정합니다. NULL 처리와 텍스트/숫자 값의 차이를 확인하세요. 제공된 제어로 조건을 결합하고 생성된 SQL에서 그룹 구성을 확인합니다.
ORDER BY
정렬 목록에 열을 추가하고 오름차순 또는 내림차순을 선택합니다. 정렬 필드 순서가 우선순위를 정합니다. 안정적인 SQL ORDER BY는 이미 수집한 결과 표를 정렬하는 것과 다릅니다.
검토
SQL을 생성하고 편집기에서 WHERE 및 ORDER BY 절을 확인합니다. 변경되는 값은 매번 리터럴을 편집하는 대신 :NAME 매개변수를 사용하세요. Oracle은 실행 중 객체 이름, 타입 및 권한을 검증합니다.
결과 필터는 별개
결과 열 필터는 수집된 스냅샷만 좁힙니다. WHERE 절을 추가하거나 Oracle을 재실행하지 않습니다. 실제 쿼리 출력을 줄이려면 디자이너 조건을 사용하세요.
GROUP BY, HAVING 및 집계 함수
집계 선택
디자이너에서 출력 열에 COUNT, SUM 또는 AVG 같은 집계를 선택합니다. 산술 집계에는 적합한 숫자 열을 사용하세요. COUNT(*)는 행 수를 세며 COUNT(column)은 NULL 값을 제외합니다.
그룹화
집계하지 않는 출력 필드에 그룹 열을 추가합니다. 상세 열과 집계를 혼합하면 보통 GROUP BY가 필요합니다. 함수 선택만으로 의도한 요약이 된다고 생각하지 말고 생성된 SQL을 확인하세요.
HAVING
HAVING으로 그룹화/집계 결과를 필터링합니다. WHERE는 그룹화 전에 원본 행을 필터링합니다. 디자이너에서 제공하는 제어로 집계 표현식과 비교를 선택합니다.
결과 검토
생성된 문장의 별칭, GROUP BY, HAVING 및 ORDER BY를 확인합니다. Oracle은 잘못된 조합이나 호환되지 않는 데이터 타입을 거부할 수 있습니다. 디자이너는 업무 합계를 원본 보고서와 대조해 검증하지 않습니다.
편집 가능한 설계 저장 및 복원
기억되는 내용
쿼리의 디자이너 상태에는 선택한 테이블, 별칭, 열, 조인, 조건, 정렬, 그룹화 및 집계 설정이 포함됩니다. 해당 쿼리에서 디자이너를 다시 열어 처음부터 시작하지 않고 계속 작업합니다.
SQL 생성 없이 저장
새 편집기 SQL을 생성하지 않았어도 디자이너만의 변경을 저장할 수 있습니다. 저장과 모두 저장은 설계를 해당 쿼리와 함께 보관합니다. 모두 저장은 각 쿼리를 독립적으로 처리합니다.
다른 이름으로 저장
다른 이름으로 저장은 별도로 편집 가능한 설계 사본을 만듭니다. 사본 편집이 원본을 바꾸어서는 안 됩니다. 저장된 쿼리에서 원본을 다시 열어 고유 모델을 확인하세요.
로그아웃 및 이전
저장된 웹 설계는 로그인 후 동일한 승인 계정에 복원됩니다. 데스크톱 설계는 로컬 계정 작업 공간에 속합니다. .sql 파일은 SQL 텍스트이며 전체 시각적 설계가 아닙니다. SQL 파일 이전을 전체 설계 백업으로 사용하지 마세요.
테이블과 별칭에서 열 선택
SQL에서 테이블과 별칭을 선언하고 열을 연 뒤 인식된 테이블/별칭과 필요한 열을 선택합니다. 삽입을 확인하고 수정된 SELECT 목록을 검토합니다. 체크박스는 필드를 선택하며 쿼리는 실행하지 않습니다.
별칭 제안
별칭 선언 후 편집기에 alias.를 입력하면 SELECT 안을 포함해 해당 테이블의 열을 요청합니다. Ctrl+Space로 제안을 다시 열 수 있습니다. 여러 테이블과 조인에는 서로 다른 별칭을 사용하세요.
테이블이 없는 경우
철자와 FROM/JOIN 구문을 확인하고 게시된 메타데이터에 테이블이 있는지 확인합니다. 별칭을 인식하지 못하는 복잡한 SQL 범위는 수동 편집이 필요할 수 있습니다. 메타데이터는 공유 설명 카탈로그이며 실시간 Oracle 권한 검사가 아닙니다.
열이 없는 경우
플랫폼 소유자에게 열 배치를 가져와 게시했는지 확인해 달라고 요청하세요. 데스크톱에서는 자동 완성 데이터를 내려받아 활성화합니다. 모든 열을 자동 삽입하는 대신 게시 또는 다운로드 후 카탈로그를 새로고침하세요.
열 타입, 크기 및 주석 확인
테이블 설명
도구 모음의 테이블 설명에서 테이블을 지정합니다. 업로드 데이터에 해당 필드가 있으면 열 이름, 타입, 길이 또는 정밀도/소수 자릿수, NULL 허용 여부 및 주석을 검토합니다.
세부 정보의 출처
테이블 설명은 가져온 메타데이터를 사용합니다. 현재 Oracle 인스턴스가 정확히 동일한 스키마라는 보장은 아닙니다. 게시 카탈로그가 인스턴스보다 오래되었을 수 있습니다.
주석이 비어 있으면 Oracle이 제공하지 않았거나 추출에 주석 필드가 없을 수 있습니다. 가져오기 도구가 업무 설명을 만들어 낼 수는 없습니다. 플랫폼 소유자에게 원본 통합 문서와 인식된 헤더를 확인해 달라고 요청하세요.
빈 크기 또는 누락된 열
관련 열 파일에 해당 필드가 있고 게시되었는지 확인합니다. 데스크톱에서는 최신 메타데이터 패키지를 내려받으세요. 테이블 쿼리 권한과 카탈로그 설명의 가용성은 별도 확인 사항입니다.
공유 메타데이터와 게시
플랫폼 소유자가 Oracle 객체/테이블 및 열 설명을 중앙에 업로드합니다. 게시 데이터는 여러 조직 사용자에게 제공할 수 있습니다. 업무 결과 행 업로드가 아니며 Oracle 쿼리 권한을 부여하지 않습니다.
테이블/객체 파일과 열 파일은 별도로 업로드할 수 있습니다. 워크시트는 특정 시트 이름이 아닌 인식된 헤더로 구분합니다. 대규모 알파벳 배치는 이전 전체 열 데이터를 대체하지 않고 병합됩니다.
가져온 데이터는 게시 전에 준비 영역에 저장됩니다. 사용자는 미완성 준비 데이터가 아닌 게시 카탈로그를 사용합니다. 게시 후 필요에 따라 최신 카탈로그를 새로고침하거나 내려받으세요.
추출에 있는 테이블과 열만 메타데이터 도구에 표시될 수 있습니다. 주석과 크기는 선택적 원본 데이터입니다. 카탈로그를 최신으로 유지하는 자동 Oracle 테이블 업데이트 또는 메타데이터 예약 기능은 없습니다.
공개 Oracle 문서는 일치하는 테이블/열 설명과 기능 영역을 보완할 수 있습니다. 페이지 이용 불가와 주석 누락은 다르며 없는 문서는 빈 상태로 남습니다. 데스크톱 패키지는 별도로 재빌드/게시한 뒤 다시 내려받아야 합니다. 이전 로컬 스냅샷에 새 주석이 반영되었다고 가정하지 마세요.
데스크톱에서 자동 완성 데이터 다운로드
다운로드
- 승인된 활성 체험 또는 유료 권한으로 데스크톱에 로그인합니다.
- 탐색 메뉴에서 자동 완성 데이터를 엽니다.
- 제공되는 메타데이터 패키지를 내려받고 활성화합니다.
- 검증과 설치가 끝날 때까지 기다린 뒤 편집기로 돌아갑니다.
지원 기능
로컬 카탈로그는 테이블 제안, 별칭 열 제안, 열, 테이블 설명 및 디자이너 테이블/열 선택기를 지원합니다. 메타데이터가 없어도 직접 작성한 이름으로 SQL을 실행할 수 있습니다.
저장 및 업데이트
메타데이터 패키지는 모든 설치 프로그램에 포함하지 않고 로컬 앱 데이터 디렉터리에 내려받습니다. 플랫폼 소유자가 업데이트하면 새 게시 패키지를 내려받으세요. 화면 제어로 패키지 사용을 끌 수 있습니다. 별도 가져오기는 호환 메타데이터 패키지만 받으며 임의 XLSX 업무 데이터는 받지 않습니다.
문제 해결
다운로드에는 유효한 계정 권한, 네트워크 접근, 여유 디스크 공간 및 유효한 패키지가 필요합니다. 자동 완성을 갱신하려고 로컬 작업 공간 데이터베이스를 삭제하지 마세요. 메타데이터 패키지에는 자격 증명이나 쿼리 결과가 없습니다.
다운로드 전달
계정 서버가 권한을 확인하고 수명이 짧은 비공개 Cloudflare R2 다운로드 링크를 제공합니다. 메타데이터는 저장소에서 직접 내려받으며 설치 전에 체크섬을 검증합니다. 이는 게시된 스냅샷입니다. 문서 보완이나 서버 업데이트가 기존 데스크톱 다운로드를 자동 갱신하지 않습니다.
결과 읽기 및 레코드 확인
표 제어
표를 스크롤해도 열 헤더는 보입니다. 헤더 구분선을 끌어 한 열 너비를 바꾸거나 두 번 클릭해 내용에 맞추거나 열 자동 맞춤으로 전체를 조정합니다. 지원되는 작업 공간에서는 쿼리별 너비가 기억됩니다.
확장 레코드
행 번호 옆 레코드 보기를 선택하면 왼쪽 열 이름과 오른쪽 값을 표시한 레코드가 열립니다. 넓은 테이블에 유용합니다. 선택 결과 행의 보기이며 데이터베이스 편집 양식이 아닙니다.
결과 표를 우클릭하거나 표에 초점이 있을 때 Shift+F10을 눌러 제공되는 결과 작업을 봅니다. 현재 셀, 행 또는 선택 영역에 제공되는 작업만 사용하세요.
전체 창
결과를 확장해 공간을 확보하고 Escape 또는 결과 크기 복원으로 돌아갑니다. 필터, 정렬 및 선택은 결과 집합에 유지됩니다. 편집기 SQL 변경이 표를 자동 교체하지는 않습니다.
페이지당 행 수와 총 행 수
페이지당 행 수로 한 번에 10, 25, 50, 100 또는 200행을 표시합니다. 마지막 설정은 사용자/작업 공간별로 기억됩니다. 제공되는 처음, 이전, 다음 및 마지막 페이지 제어를 사용하세요.
총수와 일치 수
총수는 수집된 결과 스냅샷의 행 수이며 Oracle 원본 테이블 전체 행 수는 아닐 수 있습니다. 필터는 일치 수를 줄일 수 있습니다. 가져오기 상한으로 수집한 것보다 더 많은 원본 행이 있을 수 있습니다.
페이지당 행 수는 보이는 페이지만 바꿉니다. 가져올 행 수는 새 실행에서 수집할 최대 수를 제어합니다. 페이지 크기가 25라고 전체 결과 내보내기가 25행만 포함해야 하는 것은 아닙니다.
정렬, 필터 및 선택은 수집된 스냅샷 전체에 적용됩니다. 지연 스냅샷은 모든 행을 브라우저에 한꺼번에 넣지 않고 필요할 때 페이지를 요청합니다.
열별 결과 필터링
열 필터
열 헤더의 깔때기 아이콘을 선택하고 지원되는 필터 조건을 설정합니다. 적용하면 현재 페이지만이 아닌 수집된 전체 결과 집합의 일치 행을 좁힙니다. 열 필터 지우기로 제거합니다.
텍스트 검색
결과 검색 필드로 더 넓은 텍스트 필터를 사용합니다. 검색과 열 조건을 함께 사용할 수 있습니다. 일치 수가 0이어도 가져온 스냅샷 밖 Oracle에 해당 행이 없다는 증거는 아닙니다.
선택
필터를 적용하거나 지워도 선택 행은 유지됩니다. 새 필터로 숨겨진 행도 선택에 남을 수 있습니다. 내보내지 않을 행이라면 선택을 명시적으로 지우세요.
쿼리와 결과 필터
결과 필터는 가져온 데이터에 작동합니다. Oracle 반환 내용을 바꾸거나 비용이 큰 추출을 줄이려면 SQL 또는 디자이너에 WHERE 조건을 추가하고 다시 실행하세요.
페이지와 내보내기를 아우르는 정렬
정렬 적용
헤더의 오름차순 또는 내림차순 아이콘을 선택합니다. 활성 정렬은 강조 표시됩니다. 지원되면 활성 정렬을 다시 클릭해 지웁니다. 정렬은 현재 페이지만이 아닌 필터된 행을 포함한 결과 스냅샷 전체에 적용됩니다.
안정적인 선택
오름차순과 내림차순을 바꿔도 선택된 원래 행은 바뀌지 않습니다. 행의 표시 위치가 달라져도 선택은 해당 행에 유지됩니다.
내보내기
CSV 및 Excel 내보내기는 현재 결과 정렬을 따릅니다. 필터 내보내기는 필터 순서를 사용하며 선택 행 내보내기는 여러 페이지의 현재 결과 순서대로 선택 행을 유지합니다.
SQL ORDER BY
표 정렬은 Oracle을 재실행하거나 편집기 SQL을 바꾸지 않습니다. 수집 전에 Oracle이 특정 순서를 만들어야 하면 SQL ORDER BY를 사용하세요. 모두 실행의 각 결과 집합 정렬은 별도로 유지됩니다.
페이지 및 필터를 넘어 행 선택
개별 및 페이지 선택
행 체크박스로 해당 행을 선택합니다. 헤더 체크박스는 보이는 페이지의 행을 선택합니다. 페이지를 이동해도 선택 행은 사라지지 않습니다.
모든 일치 행 선택
모든 일치 행 선택으로 수집 결과의 모든 페이지에서 활성 필터를 충족하는 행을 선택합니다. 스냅샷 밖 원본 테이블 행은 선택하지 않으며 모든 필터 미적용 행을 뜻하지도 않습니다.
필터와 정렬
필터 변경, 지우기 또는 정렬 방향 전환에도 선택 행은 유지됩니다. 선택 행이 필터로 숨겨질 수 있어 선택 수가 보이는 일치 행 수보다 클 수 있습니다.
내보내기
내보내기 대화상자에서 선택 행 옵션을 사용하면 현재 필터로 숨겨진 선택 행을 포함해 모든 페이지 선택이 포함됩니다. 선택 지우기로 의도적으로 초기화하세요. 모두 실행의 각 결과 탭은 자체 선택을 가집니다.
CSV 또는 Excel 결과 내보내기
데이터 내보내기
- 현재 결과 집합의 데이터 내보내기를 엽니다.
- CSV 또는 Excel을 선택하고 적용되는 전체 가져온 행, 필터 행 또는 선택 행 중 무엇을 내보내는지 확인합니다.
- 확장자를 포함한 파일 이름을 확인한 뒤 내려받거나 기본 저장 위치를 선택합니다.
범위와 순서
내보내기는 보이는 페이지에 한정되지 않습니다. 결과 정렬과 선택한 내보내기 범위를 따릅니다. 선택 행 내보내기에는 다른 페이지의 선택도 포함됩니다. 표 필터는 선택을 해제하지 않고 선택 행을 숨길 수 있습니다.
파일 이름
기본 이름은 쿼리 탭 이름 뒤에 날짜와 타임스탬프를 붙이고 올바른 .csv 또는 .xlsx 확장자를 사용합니다. 잘못된 파일 이름 문자는 정규화됩니다.
CSV 구분자
대화상자에서 쉼표, 세미콜론 또는 탭 같은 구분자를 선택합니다. 구분자, 따옴표 또는 줄바꿈이 있는 텍스트는 적절히 따옴표 처리됩니다. O'Brien 같은 아포스트로피는 일반 데이터로 남습니다. 스프레드시트 가져오기 설정을 선택한 구분자에 맞추세요.
SQL을 포함한 Excel
두 번째 워크시트에 SQL 포함 옵션을 선택합니다. 가능한 경우 실행된 SQL 스냅샷을 사용하고 매개변수 자리표시자를 유지하며 매개변수 값은 SQL 시트에 저장하지 않습니다. 쿼리가 반환했다면 결과 행에는 해당 값이 포함될 수 있습니다.
큰 결과와 지연 로딩
대화형 스냅샷
제공되는 대화형 옵션 범위에서 가져올 행 수를 늘려 실행합니다. 큰 결과는 모든 행을 표에 표시하는 대신 임시 스냅샷과 페이지 요청을 사용합니다. 필터, 정렬, 선택 및 내보내기는 수집된 스냅샷에 적용됩니다.
가져오기도 작업입니다
지연 표시는 무제한 Oracle 쿼리를 무비용으로 만들지 않습니다. Oracle 보고서 실행, 전송, 디스크/메모리 한도 및 네트워크 시간은 여전히 중요합니다. 매우 넓은 SELECT *는 같은 수의 좁은 행보다 훨씬 클 수 있습니다.
결과가 너무 큰 경우
열을 줄이거나 제한적인 WHERE 절을 사용하거나 가져올 행 수를 낮추거나 데스크톱 백그라운드 내보내기를 사용하세요. 일부 행을 전체 결과로 가정하지 말고 실제 크기/셀 한도 오류를 읽으세요.
임시는 임시입니다
스냅샷은 세션 범위이며 로그아웃, 정리 또는 재시작 후 만료되거나 사라질 수 있습니다. 이용할 수 없다면 쿼리를 다시 실행하세요. 보관할 결과는 내려받으세요. 지연 로딩은 영원히 열린 데이터베이스 커서가 아닙니다.
데스크톱 백그라운드 내보내기
작업 만들기
- 데스크톱에서 Oracle에 연결합니다.
- 쿼리 도구 모음에서 백그라운드 내보내기를 사용합니다.
- CSV 또는 XLSX, 최대 행 수 및 제공되는 내보내기 옵션을 선택하고 매개변수를 검토합니다.
- 백그라운드 내보내기를 열어 로컬 작업을 확인하고 필요하면 취소하거나 완료된 파일을 내려받습니다.
작동 방식
지원되는 커넥터는 BI Publisher 보고서를 한 번 실행하고 출력을 청크로 내려받습니다. 고유 정렬 열이나 정렬 확인 체크박스는 필요하지 않습니다. 현재 작업 최대치는 100,000행이며 보고서/출력 제한이 적용됩니다. 완료된 작업이 최대치에 도달했다면 원본 행이 더 있을 수 있습니다.
파일 위치
작업과 임시 다운로드는 계정 서버가 아닌 컴퓨터에 있습니다. 완료된 임시 파일은 완료 후 24시간 뒤 만료되며 작업에 만료 시각이 표시됩니다. 오래 보관하려면 사본을 내려받아 저장하세요. 직접 폴더에 저장한 파일은 만료되는 임시 작업과 별개입니다.
데스크톱 실행 유지
작업은 로컬에서 실행되며 영구적인 서버 스케줄러가 아닙니다. 앱 닫기, 로그아웃, Oracle 연결 해제, 절전/네트워크 끊김 또는 라이선스 만료로 중단될 수 있습니다. 컴퓨터가 꺼진 상태에서 완료될 것으로 기대하지 마세요.
문제
200행만 받았다면 실제 내보내기 최대치와 현재 QueryRunner 한도를 확인하세요. 청크 다운로드가 거부되면 서비스와 보고서 권한을 검증하세요. 큰 대화형 결과와 백그라운드 내보내기는 별도 작업 흐름입니다.
AI 권한과 개인 키
세 가지 접근 모드
결정 권한
조직 관리자는 자신의 조직 사용자에게만 모드를 부여합니다. 최고 관리자는 공유 서비스 구성과 플랫폼 설정을 제어합니다. 사용자는 다른 사용자의 접근을 바꾸거나 자신의 키를 입력해 차단을 우회할 수 없습니다.
변경 적용
공유 AI 요청은 백엔드에서 승인됩니다. 데스크톱 권한은 시작 시 및 일일 검증 성공 시 갱신되므로 개인 키 제한이 다음 확인 때 도착할 수 있습니다. 계정 서버 중단 중에는 기존 서명된 권한이 고정 기한까지 유지될 수 있습니다. 저장된 개인 키는 새로 검증된 차단 모드를 무시하지 못합니다. 권한은 로그아웃/로그인 후에도 유지됩니다.
개인 설정
허용되면 데스크톱의 내 OpenAI 키에서 제공되는 키/모델 제어를 사용합니다. 키는 비밀 정보로 전체가 다시 표시되지 않습니다. 비밀 필드가 비어 있어도 기존 값이 표시될 것으로 기대하지 말고 상태를 확인하세요.
SQL 초안 작성, 설명 및 수정
도우미 열기
관리자가 권한을 부여했다면 AI 아이콘을 선택합니다. 초안으로 쿼리를 설명하거나, 설명으로 SQL을 이해하거나, 수정으로 교정을 요청합니다. 제출하는 편집기 SQL과 지시 사항을 검토하세요.
데이터 경계
AI 요청에는 쿼리 결과 행이 포함되지 않습니다. SQL 자체에 이름, 리터럴 또는 민감한 조건이 있을 수 있으므로 보내고 싶지 않은 내용은 제거하세요. Oracle 실행이 로컬이어도 데스크톱 AI는 네트워크 서비스입니다.
실행 전 검토
AI 출력은 제안이며 검증된 Oracle SQL이 아닙니다. 테이블과 열 이름, 조인, 필터 및 Oracle 버전 구문을 확인하세요. 만족한 경우에만 적용한 뒤 명시적으로 실행합니다. 앱은 제안 SQL을 자동 실행하지 않습니다.
오류
AI 가용성은 권한, 설정된 키/모델, 제공업체 가용성 및 한도에 달려 있습니다. 제공업체 오류는 Oracle 오류가 아닙니다. AI 응답 성공은 업무 결과가 정확하다는 증거가 아닙니다.
AI 변경 다듬기, 검토, 적용 또는 버리기
제안과 다듬기
원하는 변경을 설명합니다. 제안과 원래 SQL의 비교를 검토합니다. 다듬기를 요청하면 새 제안이 나오며 새 버전도 적용 전에 검토해야 합니다.
적용
적용은 편집기만 변경합니다. SQL 실행, 현재 결과 표 지우기, 결과 필터 제거 또는 선택 행 변경을 하지 않습니다. 다시 실행하기 전까지 결과는 이전 SQL에 해당할 수 있습니다.
실행 취소와 다시 실행
다듬은 제안을 적용한 뒤 실행 취소는 이전 SQL을 복원합니다. 다시 실행은 제안을 되돌립니다. 어느 작업도 쿼리를 실행하거나 기존 결과를 지우지 않습니다.
버리기
적용하지 않고 취소, 닫기, Escape 또는 배경 클릭으로 닫으면 편집기 SQL, 결과, 필터 및 선택은 바뀌지 않습니다. 제안 닫기를 수락으로 해석하지 마세요.
요금제, 좌석 및 구독 날짜
구독 열기
체험 및 유료 사용자 모두 웹 구독 화면에 접근할 수 있습니다. 상태, 좌석 사용, 해당되는 체험 종료 및 현재 유료 기간 날짜를 표시합니다. 조직 관리자만 결제를 시작하거나 관리할 수 있습니다. 한 좌석 조직의 계정 소유자가 관리자가 될 수 있으며 그 관리자가 한 좌석을 사용합니다.
현재 공개 요금제
1인 프로모션 가격은 월 USD 14.99 또는 연 USD 149.90이며 두 달 무료에 해당합니다. 설정된 경우 해당 세금이 추가됩니다. 현재 웹사이트와 Stripe 확인 내용이 기준입니다. 팀 총액은 구독 화면에서 기명 사용자 수에 따라 비공개로 계산합니다. 단계별 대량 요율은 웹사이트에 공개하지 않습니다. 구독을 계속 유지하는 동안 프로모션 조건이 유지되며 취소 시 기존 조건 유지가 끝납니다. 맞춤 제안도 별도로 협의할 수 있습니다.
활성 구독
이미 활성 구독이 있으면 새 결제 버튼은 비활성화됩니다. 결제 / 청구서 관리로 기존 요금제, 결제 수단 또는 취소를 변경하세요. 데스크톱에서 조직 관리자는 웹에서 결제 / 청구서 관리를 사용할 수 있으며 관리는 웹사이트에서 이루어집니다.
날짜와 알림
자동 갱신 요금제는 유료 기간 종료/다음 갱신을 표시하며 계정이 그날 만료된다는 뜻은 아닙니다. 취소 예정이면 구독 만료로 표시합니다. 데스크톱 알림은 월간 만료/갱신 3일 전, 연간 만료/갱신 15일 전에 시작됩니다.
테스트 모드
Stripe 테스트 모드는 실제 결제가 아닙니다. Checkout에서 돌아오는 것만으로 접근이 확인되지 않으며 서버는 서명된 결제 이벤트와 구독 상태를 사용합니다.
업그레이드, 다운그레이드 및 월간·연간 전환
기존 구독 열기
두 번째 구독을 시작하지 말고 결제 / 청구서 관리를 사용합니다. 제공되는 요금제 또는 주기를 선택하고 Stripe 확인 화면을 검토합니다.
업그레이드
업그레이드는 비례 계산되어 즉시 청구됩니다. 미사용 선불 기간 크레딧, 새 요금, 세금 및 결제 금액을 확인하세요. 업그레이드 결제가 실패하면 기존 요금제와 좌석 제한은 유지되며 계정과 저장된 쿼리도 보존됩니다.
다운그레이드
다운그레이드는 갱신 시 적용됩니다. 그때까지 현재 요금제를 사용할 수 있습니다. 더 짧은 결제 주기로 전환하면 갱신 시점으로 예약됩니다. SQL Hop의 적용 날짜와 예약된 변경을 확인하세요.
월간/연간 전환
확인 전에 미리보기를 읽으세요. 미사용 크레딧, 세금 및 결제액은 주기, 적용 시간 및 기존 청구서 상태에 따라 달라집니다. 확인 화면의 세부 정보 보기에서 내역을 엽니다. 크레딧 잔액은 향후 청구서를 차감하며 자동 현금 환불은 아닙니다.
좌석과 기존 조건 유지
더 낮은 좌석 한도가 적용되기 전에 초과 구성원이나 대기 초대를 줄이세요. 판매 종료 요금제는 기존 구독자에게 유지될 수 있지만 다른 요금제로 바꾸면 해당 기존 가격을 다시 이용할 수 없을 수 있습니다.
구독 취소 또는 갱신
취소
웹에서 구독을 열고 결제 / 청구서 관리를 선택합니다. Stripe에서 제공하는 취소 옵션으로 적용 날짜를 확인하고 확정합니다. SQL Hop으로 돌아와 결제 상태를 새로고침하세요.
기간 종료 시
취소가 예약되면 유료 기간 종료가 구독 만료일로 표시됩니다. 이용 권한이 더 이상 활성 상태가 아니면 유료 쿼리 접근이 끝납니다. 계정과 저장된 쿼리는 유지되며 취소가 조직을 삭제하거나 새 체험을 부여하지는 않습니다.
마음이 바뀐 경우
결제 관리에서 예약 취소를 철회하거나 구독을 갱신할 수 있는지 검토합니다. 결제 확인 및 서명된 구독 상태로 권한이 복원되어야 하며 페이지에서 돌아오는 것만으로는 부족합니다.
환불
취소는 자동 현금 환불을 약속하지 않습니다. 확인 내용과 게시된 조건을 검토하세요. 요금제 변경 크레딧은 일반적으로 향후 청구서를 차감합니다. 카드 정보를 보내지 말고 결제 문제를 지원팀에 문의하세요.
결제 실패, 만료 및 결제 보류
결제 실패 또는 구독 만료
연체, 미납, 미완료, 일시 중지, 취소 또는 만료된 권한은 쿼리가 거부될 수 있습니다. 계정과 저장된 쿼리는 유지됩니다. 검증에서 명시적 제한을 반환하거나 기존 권한이 만료되면 데스크톱은 새 쿼리와 내보내기를 거부하며 캐시 결과는 유지합니다. 조직 관리자는 웹 결제에서 지급 및 갱신을 계속 확인할 수 있습니다.
업그레이드 실패
즉시 업그레이드 실패가 기존 유료 요금제나 좌석 제한을 대체해서는 안 됩니다. 재시도 전에 포털 결제 상태를 확인하고 두 번째 구독을 만들지 마세요.
알림
결제 실패 이메일은 SQL Hop 계정 이메일 형식으로 조직 관리자에게 발송되며 결제 관리 작업과 중복 방지를 포함합니다. 이메일 수신은 구독 확인을 대신하지 않습니다.
분쟁
지급 거절은 결제 보류와 차단 목록 정책을 적용할 수 있습니다. 도메인 전체 작업은 공개 이메일 제공업체를 제외하며 최고 관리자 승인이 필요합니다. 분쟁 승소가 영구 이메일 차단을 자동 제거하지는 않으므로 플랫폼 소유자에게 검토를 요청하세요.
안전
비밀번호, 전체 카드 번호, 재설정 링크 또는 API 키를 지원팀에 보내지 마세요. 민감 정보를 제거한 오류, 대략적 시간 및 구독 상태를 포함하세요.
좌석 제한과 구성원 수
계산 대상
좌석 제한에는 SQL을 실행한 사용자뿐 아니라 조직 관리자와 대기 중인 초대도 포함됩니다. 따라서 1인 요금제에 관리자 계정 하나를 둘 수 있으나 별도 무료 관리자 좌석은 아닙니다.
사용자 추가 또는 재활성화
초대하거나 계정을 활성화하기 전에 현재 사용/허용 수를 확인하세요. 생성, 초대 및 재활성화로 좌석 제한을 우회해서는 안 됩니다. 체험 조직은 10명을 포함하며 유료/맞춤 요금제는 설정된 좌석 수를 사용합니다.
다운그레이드
더 작은 요금제를 예약했다면 새 한도가 적용되기 전에 활성 구성원을 줄이고 불필요한 초대를 취소하세요. 권한을 초과하면 쿼리가 일시 중지될 수 있지만 계정이나 저장된 SQL은 삭제되지 않습니다.
독립 조직
별도 팀은 같은 회사 도메인이나 Oracle 인스턴스에서도 구독할 수 있습니다. 각 사용자는 본인의 승인 계정과 체험 자격이 필요합니다. 좌석 공유는 여러 사람이 한 로그인을 공유할 수 있다는 허가가 아닙니다.
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.
조직 관리자
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.
최고 관리자
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.
데스크톱
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.
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.
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.
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.
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.
쿼리 기록과 보관 기간
기록 내용
쿼리 기록은 실행된 SQL과 실행 결과를 기록합니다. 기록 항목을 열어 검토하거나 다시 실행할 수 있으며 매개변수 SQL은 자리표시자를 유지하고 새 값을 요청해야 합니다.
자동 보관
자동 쿼리 기록은 최근 한 달 활동을 보관하며 그보다 오래되어도 최소 최근 10개 쿼리를 유지합니다. 정리는 매시간이 아니라 주말에 예약됩니다. 데스크톱 기록은 계정 작업 공간의 로컬 데이터입니다.
저장된 쿼리와의 차이
보관할 쿼리는 이름을 붙여 저장하세요. 기록은 영구 백업이 아닙니다. 기록 지우기는 명시적 작업이며 Oracle 데이터가 삭제되었다는 의미가 아닙니다.
매개변수 입력 취소
취소, Escape 또는 매개변수 대화상자 바깥 클릭은 SQL을 실행하거나 실행 기록을 만들지 않습니다. 실패한 매개변수 쿼리는 매개변수 값을 저장하지 않고 민감 정보를 제거한 오류 기록을 유지합니다.
유지보수 알림과 서비스 상태
알림
예정된 유지보수 메시지에는 시작, 예상 종료, 시간대 및 운영자 지침이 표시될 수 있습니다. 유지보수 중에는 공개 로그인 애니메이션이 유지보수 화면으로 대체될 수 있습니다.
접근 제한
유지보수가 적용되면 최고 관리자가 아닌 웹 사용자는 로그아웃되고 일반 접근이 제한됩니다. 운영자는 유지보수에 필요한 권한을 유지합니다. 예약 시작은 페이지의 시각적 타이머뿐 아니라 백엔드에서 판단됩니다.
기존 작업
예고된 시간 전에 작업을 저장하세요. 저장된 SQL과 계정은 그대로 유지되어야 합니다. 백엔드 재시작 시 최고 관리자 웹 Oracle 연결 및 임시 서버 스냅샷이 사라질 수 있습니다. 로컬 데스크톱 결과와 Oracle 연결은 해당 서버에 호스팅되지 않습니다. 데스크톱을 계속 실행하고 중요한 내보내기를 저장하세요.
중단 중 데스크톱 권한
이미 승인된 등록 컴퓨터는 계정 서버를 이용할 수 없을 때 서명된 기한 내에서 로컬 작업을 계속할 수 있습니다. 한도는 마지막 검증 성공 후 48시간이며 체험/구독 만료를 넘지 않습니다. 최초 활성화와 웹 계정/결제에는 서버가 필요하고 Oracle과 AI에는 각자의 서비스가 필요합니다. 명시적 서버 거부는 중단 연장을 받지 않습니다.
서비스 중단
로그인 또는 웹사이트 바닥글의 서비스 상태를 사용합니다. 같은 앱에서 제공되는 상태 페이지는 서버 전체 중단 시 함께 이용 불가일 수 있으며 독립적 모니터링을 보장하지 않습니다.
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
백업 및 복구
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.
연락 문의와 확인
문의 보내기
영업, 맞춤 팀 가격 또는 지원에는 연락처 양식을 사용합니다. 본인이 관리하는 이메일과 메시지를 입력합니다. 사이트는 확인 이메일 한 통을 보내며 링크를 따라 발송을 확인하기 전에는 소유자에게 전달하지 않습니다.
반복 제출
확인 없이 반복 제출해도 확인 이메일이 반복 발송되어서는 안 됩니다. 사이트는 기존 요청을 확인하도록 안내합니다. 다시 제출하지 말고 원래 수신함과 스팸함을 확인하세요.
확인 후
확인된 문의만 응답을 위해 전달됩니다. 링크 열기가 최종 단계는 아닐 수 있으므로 확인 페이지에서 확인 후 보내기를 사용하세요. 문의 메시지는 계정 이메일 팀 서명을 사용하지 않습니다.
개인정보와 소유자 검토
플랫폼 소유자는 웹사이트 문의에서 메시지, 타임스탬프, 출처 IP 및 확인/전달 상태를 검토할 수 있습니다. IP 기록은 악용 조사에 도움이 되지만 개인 신원의 증거는 아닙니다. 소유자는 모든 미확인 제출을 대화로 취급하지 않고 전달된 이메일에 답합니다.
Cloudflare Turnstile은 서버가 문의를 기록하거나 확인 이메일을 보내기 전에 방문자를 검증합니다. 실패, 만료, 재사용 또는 누락된 토큰은 거부됩니다. 서버는 실제 챌린지의 호스트 이름과 작업도 검증합니다. 제공업체 중단 시 검증을 생략하지 않고 제출을 막습니다. 속도 제한, 숨김 스팸 필드 및 확인 이메일 한 통 규칙은 유지됩니다. 로컬 개발은 명확히 표시된 공식 테스트 키를 사용하며 운영에는 실제 위젯과 서버 전용 비밀 키가 필요합니다. CAPTCHA는 이메일 확인을 대체하거나 메시지의 정당성을 보장하지 않습니다.
저장·전송되거나 로컬에 남는 정보
앱 계정
데이터베이스에는 계정, 조직, 저장된 웹 SQL, 결제 상태 및 허용된 감사 데이터가 보관됩니다. 계정 이메일과 이름은 앱 암호화와 조회 보호를 사용하며 비밀번호는 복구 가능한 평문 대신 해시 처리됩니다. 암호화가 침해된 실행 중 앱을 무해하게 만들지는 않습니다.
Oracle
최고 관리자 웹 실행에서 Oracle 자격 증명은 임시 서버 메모리 값이며 영구 데이터베이스 기록이 아닙니다. 고객 웹 계정에는 쿼리 작업 공간이 없습니다. 데스크톱 Oracle 요청과 결과는 로컬에 있으며 선택적 저장 자격 증명은 OS 보호 암호화를 사용합니다. 승인된 쿼리도 SQL을 Oracle에 전송합니다.
매개변수와 내보내기
매개변수 값은 저장된 SQL, 기록 또는 선택적 SQL 내보내기 시트에 저장되지 않습니다. 반환된 결과 행에는 민감한 값이 있을 수 있으며 내보낸 파일은 의도적으로 만든 사본입니다. 공유 전에 내보내기를 검토하세요.
AI
AI 지원에는 요청한 SQL과 지시 사항만 보내며 쿼리 결과 행은 보내지 않습니다. SQL 리터럴 자체에 민감한 정보가 있을 수 있습니다.
복구
서버 백업에는 키와 데스크톱 로컬 작업이 포함되지 않습니다. 별도 보관 앱 키, 로컬 작업 공간 데이터 및 다운로드한 내보내기를 보호하세요. 문제 해결 중 토큰, 원시 로그 또는 자격 증명을 공유하지 마세요.
장치 권한과 다운로드
서버는 등록 장치 ID, 컴퓨터 이름, 공개 키 및 등록/검증 시간을 저장합니다. 개인 키와 서명된 권한은 컴퓨터의 OS 보호 저장소에 남습니다. 서명 봉투에는 계정 신원, 권한 및 인스턴스 설정이 포함되지만 Oracle 비밀번호, SQL 또는 결과는 없습니다. 설치 프로그램과 메타데이터는 짧은 링크로 비공개 R2 저장소에서 전달되며 복구 백업은 별도 비공개 S3 저장소를 사용합니다.
개인정보, 데이터 처리 및 지원 안전
웹사이트 바닥글의 데이터 처리 및 사용 정보에서 현재 게시된 안내를 읽으세요. 도움말 문서는 제품 동작을 설명하며 게시된 약관이나 개인정보 계약을 대체하지 않습니다.
안전한 지원 정보
플랫폼(웹/데스크톱), 알 수 있다면 앱 버전, 대략적 시간, 수행한 작업 및 민감 정보를 제거한 정확한 오류를 포함하세요. 업무 데이터보다 무해한 재현 쿼리가 좋습니다. 스크린샷에서 비밀번호, 토큰, 비공개 SQL 리터럴 및 공유 권한이 없는 결과 행을 제외하세요.
공유하면 안 되는 정보
Oracle/앱 비밀번호, API 키, MFA 코드, 복구 코드, 재설정/활성화 링크 또는 전체 카드 정보를 보내지 마세요. 관리자는 접근 정책 조사에 사용자 비밀번호가 필요하지 않습니다.
범위
독립적인 Oracle 권한, 이메일 제공업체 전송 및 네트워크/장치 정책은 SQL Hop 외부 동작에 영향을 줄 수 있습니다. 계정 보호를 약화하지 말고 관련 관리자에게 문의하세요.
Oracle 쿼리 및 연결 오류 해결
세부 정보부터 확인
쿼리 실행 실패는 실행 결과를 나타내며 가능한 경우 민감 정보를 제거한 Oracle/서비스 세부 정보가 뒤따릅니다. 편집기 SQL은 유지됩니다. 일반 서비스 오류가 잘못된 비밀번호를 뜻한다고 단정하지 마세요.
일반적인 경우
연결 실패
올바르게 설정된 HTTPS 호스트와 보고서 경로를 사용합니다. Oracle 브라우저 로그인 성공이 BI Publisher 커넥터를 인증하지는 않습니다. 거부된 자격 증명을 반복 시도해 계정 잠금을 유발하지 마세요.
안전한 상위 문의
오류 코드, 시간, 플랫폼 및 무해한 재현을 공유합니다. 로그나 지원 메시지에 매개변수 값이나 자격 증명을 포함하지 마세요.
계정 및 결제 접근 문제 해결
제한 식별
- 승인 대기: 활성화는 완료되었지만 조직/구성원 승인은 아직입니다.
- 체험 종료 또는 사용 이력 있음: 구독하거나 최고 관리자에게 예외 검토를 요청합니다.
- 웹의 체험 또는 유료 계정: SQL 작업 공간이 숨겨집니다. 데스크톱을 내려받으세요. 계정, 결제 및 허용된 조직 설정은 계속 이용할 수 있습니다.
- 데스크톱 체험 계정: 승인, 체험 자격 및 등록 컴퓨터를 확인합니다.
- 좌석 한도: 관리자가 사용자/초대를 줄이거나 요금제를 바꿔야 합니다.
- 결제/분쟁 보류: 조직 관리자와 웹 결제를 검토합니다.
- 다른 곳에서 로그인됨: 같은 클라이언트 유형의 새 로그인이 세션을 교체했을 수 있습니다. 웹과 데스크톱 세션은 별개입니다.
한 좌석 관리자
단독 계정 소유자가 조직 관리자일 수 있으며 한 좌석을 사용합니다. 데스크톱은 결제 역할을 유지하면서 관리 기능을 숨깁니다. 웹에서 결제 / 청구서 관리를 사용하세요. 변경은 기존 구독 포털에서 해야 하므로 활성 구독은 새 Checkout을 비활성화합니다.
저장된 비밀번호로 로그인 실패
정확한 URL과 포트, 계정 서버 출처, 계정 상태 및 MFA 단계를 확인합니다. 비밀번호가 저장되어도 만료된 세션, 교체된 로그인 또는 잘못된 서버일 수 있습니다. 페이지에 연결할 수 없다는 이유만으로 비밀번호를 재설정하지 마세요.
장치와 중단 오류
다른 컴퓨터가 등록되었다면 웹 계정 보안에서 신원을 확인한 뒤 좌석을 이전해야 합니다. 권한 만료는 SQL Hop에 재연결해 검증해야 한다는 뜻이며 재설치나 다시 열기로 연장되지 않습니다. 시계가 뒤로 이동했다는 경고는 검증 전에 시계를 수정해야 합니다. 명시적 계정 거부는 중단 유예 연장이 아닙니다. 이 제한은 저장된 SQL이나 기존 결과를 삭제하지 않습니다.
서비스 가용성 확인
상태 페이지
로그인 화면이나 웹사이트 바닥글의 서비스 상태를 사용합니다. 가능한 경우 현재 앱 유지보수 상태와 예정된 시간대 메시지를 보여 줍니다.
페이지를 불러올 수 없을 때
먼저 주소, 포트, 네트워크 및 인증서를 확인합니다. 같은 백엔드의 상태 페이지도 중단 중 실패할 수 있으므로 접근 불가 페이지가 모든 서비스 정상의 증거는 아닙니다.
증명하지 않는 사항
앱 가용성은 모든 Oracle 고객 인스턴스, OpenAI 응답 또는 이메일 전달을 검증하지 않습니다. Oracle 연결/쿼리 오류는 별도 검사가 필요합니다.
유지보수 후 복구
백엔드 재시작 뒤 로그인은 남아 있어도 임시 Oracle 자격 증명이나 스냅샷은 없어질 수 있습니다. 작업 재개 전에 재연결하고 무해한 SQL을 다시 실행하세요.
올바른 정보로 도움 받기
먼저 확인
이 도움말 센터에서 작업 또는 정확한 오류 코드를 검색합니다. 일반 사용자가 최고 관리자 절차를 따르지 않도록 플랫폼과 역할 표시를 확인합니다. 서비스 상태에서 유지보수를 확인하세요.
지원 메시지 보내기
로그인 후 사이드바에서 지원을 열고 질문을 입력해 메시지 보내기를 선택합니다. 지원으로 돌아와 답변을 읽으세요. 대화는 저장됩니다. 지원은 웹과 데스크톱에서 가능하며 본인의 대화만 보입니다. 답변은 플랫폼 소유자가 검토해 보내며 자동 응답이 아닙니다. 조직별 접근은 먼저 조직 관리자에게 문의하세요.
가입 전 질문이나 맞춤 팀 요금제는 웹사이트 연락 양식을 사용합니다. 소유자에게 전달되기를 기다리기 전에 이메일을 확인하세요.
포함할 정보
- 웹 또는 데스크톱과 운영체제.
- 페이지 또는 도구 모음 작업과 대략적인 타임스탬프/시간대.
- 비밀과 비공개 데이터를 제거한 정확한 오류.
- 무해한 SELECT 1 FROM dual의 성공 여부.
- 결제의 경우 지급 정보를 제외한 테스트/실제 모드와 표시 상태.
제외할 정보
비밀번호, API 키, MFA/복구 코드, 재설정 링크, 고객 결과 파일 및 비공개 쿼리 리터럴. 지원용 재현을 위해 인증서 경고를 우회하거나 보안을 끄지 마세요.
문의 제출 전에 Cloudflare Turnstile을 완료합니다. 로드되지 않으면 검증 재시도를 사용하고 브라우저에서 challenges.cloudflare.com을 허용하세요. 만료된 검증은 갱신되며 서버 검증 실패 시 확인 이메일은 발송되지 않습니다. 플랫폼 소유자에게 문의가 도달하기 전에 별도 이메일 확인 단계도 필요합니다.
대화 상태
지원 대화 상태는 열림, 사용자 응답 대기 또는 해결됨일 수 있습니다. 지원팀 답변은 사용자 응답 대기로 바꿉니다. 해결된 메시지도 저장됩니다. 새 메시지를 보내면 대화가 자동으로 다시 열려 지원이 이어집니다.
키보드 단축키 참고
초점이 중요합니다
단축키는 초점이 있는 편집기, 검색 필드, 쿼리 탭 또는 구분선에 적용됩니다. 데스크톱은 OS 기본 관례를 사용합니다. 검색 패널의 바꾸기 단축키는 SQL을 실행해서는 안 됩니다. 작업 공간의 물음표 도움말 또는 F1로 같은 참고를 열 수 있습니다.
쿼리 작업 공간
SQL 편집기
탐색 및 결과
대화 상자 및 도움말
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.
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.
올바른 데스크톱 설치 프로그램 다운로드
웹사이트에서 다운로드를 열거나 로그인 후 SQL Hop Desktop 다운로드를 따릅니다. 가능하면 Windows와 Mac을 감지하며 필요하면 수동으로 바꾸세요. Mac의 이 Mac에 관하여에서 칩은 Apple Silicon, 프로세서: Intel은 Intel 하드웨어를 나타냅니다. 자동 OS 감지가 프로세서를 식별하지 못할 수 있습니다.
릴리스 확인
게시된 플랫폼마다 버전, 릴리스 노트, 크기 및 SHA-256을 표시합니다. 게시 릴리스가 없는 플랫폼에는 다운로드가 없습니다. 시스템에 맞는 파일을 선택하세요. 다른 프로세서용 설치 프로그램은 자동 업그레이드 경로가 아닙니다.
다운로드 링크
비공개 R2 서명 링크는 15분간 유효합니다. 만료되면 다운로드로 돌아와 새 링크를 받으세요. 이미 컴퓨터에 저장한 파일은 계속 보관할 수 있으며 이 만료는 임시 백그라운드 내보내기 파일과 다릅니다.
설치와 로그인
승인된 체험 또는 유료 SQL Hop 계정으로 온라인 활성화한 뒤 Oracle은 별도 연결합니다. 앱 업그레이드가 로컬 저장 SQL을 컴퓨터 간 자동 동기화하지는 않습니다.
데스크톱 컴퓨터 등록 또는 교체
사용자당 컴퓨터 한 대
첫 온라인 데스크톱 로그인 성공 시 암호화 장치 공개 키를 등록합니다. 계정/좌석 하나에 등록 하나를 가집니다. 현재 등록을 해제하기 전에는 다른 컴퓨터 등록이 거부됩니다. SQL Hop은 이 등록에 MAC 주소나 디스크 일련번호를 사용하지 않습니다.
교체 컴퓨터로 이전
- 웹사이트에 로그인하고 계정 보안을 엽니다.
- 앱 비밀번호와 활성화된 경우 기존 인증 수단으로 본인 확인합니다.
- 등록된 데스크톱 컴퓨터에서 다른 컴퓨터로 이전을 선택합니다.
- 등록 해제를 확인한 뒤 교체 컴퓨터의 데스크톱에서 온라인 로그인합니다.
이전 컴퓨터
이전 장치는 다음 검증에서 거부됩니다. 오프라인이면 이미 서명된 권한만 사용할 수 있으며 마지막 성공 후 최대 48시간이고 알려진 구독/체험 만료를 넘지 않습니다. 이전은 즉각적인 오프라인 철회를 보장하지 않습니다.
로컬 작업 보호
로컬 SQL, 결과 및 Oracle 자격 증명은 자동 이동되지 않습니다. 교체 전에 SQL 파일을 내보내거나 허용된 로컬 백업을 보호하세요. 이전의 지름길로 앱 데이터 폴더를 삭제하지 마세요.
일일 검증과 계정 서버 중단
최초 활성화와 일반 확인
최초 활성화에는 온라인 로그인이 필요합니다. 등록 컴퓨터는 시작 시 및 앱이 열려 있는 동안 24시간마다 검증을 시도합니다. 반복 로컬 작업이 몇 초마다 라이선스 요청을 보내지는 않습니다. 공유 AI, 지원, 메타데이터 다운로드 및 기타 온라인 기능은 자체 요청을 할 수 있습니다.
계정 서버 이용 불가
전송 실패 또는 일시적 서버 실패는 남은 서명 권한만 허용합니다. 실패 확인 후 24시간에 재시도가 예약되며 시작 시에도 검증합니다. 마지막 성공 후 48시간 또는 알려진 체험/구독 종료 중 더 이른 시점까지 접근이 중단됩니다. 다시 열기, 재설치 또는 실패 요청이 추가 시간을 주지 않습니다. 기존 승인 계정의 자동 재개에는 로그인 기억이 필요하며 명시적 로그아웃은 캐시 권한을 제거합니다.
명시적 거부
차단, 철회 또는 만료 응답은 새 쿼리, 새 연결 및 내보내기를 중단합니다. 기존 SQL, 결과, 필터 및 선택은 계속 사용할 수 있습니다. 재개하려면 온라인 검증 성공 또는 새 승인 로그인이 필요하며 네트워크 실패가 이전 명시적 거부를 지우지는 않습니다.
기타 서비스
Oracle 쿼리는 Oracle에 대한 네트워크 접근이 필요합니다. 조직 AI는 계정 서비스와 AI 제공업체가 필요하며 개인 AI는 제공업체와 기존 허용 권한이 필요합니다. 오프라인 권한이 이 서비스를 네트워크 없이 작동하게 만들지는 않습니다.
시계와 권한
컴퓨터 시계를 정확히 유지하세요. 뒤로 이동하면 수정 전까지 권한이 차단될 수 있습니다. 장치 접근, 인스턴스 설정 및 개인 AI 권한 변경은 다음 확인 때 실행 장치에 도달할 수 있습니다. 중단 기간은 제한된 권한이며 가동 시간 보장이 아닙니다.
시작 안내와 데스크톱 다운로드 알림
표시 시점
이전에 로그인한 적이 없는 대상 일반 계정은 최초 웹 로그인 시 세 단계 안내를 볼 수 있습니다. 최고 관리자, 재방문 계정 및 데스크톱 로그인에는 자동으로 시작되지 않습니다. 안내는 다운로드, 별도의 SQL Hop 및 Oracle 로그인, 웹 계정/결제 관리를 설명합니다.
한 번만 표시
SQL Hop은 안내를 열기 전에 계정 설정을 기록합니다. 닫기, Escape, 완료, 새로고침 또는 재로그인으로 반복되지 않습니다. 설정을 저장할 수 없으면 미기록 안내를 표시하거나 로그인을 방해하지 않습니다.
다시 열기
계정 사이드바의 시작 안내를 선택해 수동 재생합니다. 자동 표시를 복원하지는 않습니다. 다운로드 링크는 따로 열려 로그인된 계정 페이지를 계속 사용할 수 있습니다.