View Categories

macOS에 Query Streams 에이전트를 설치하는 방법

Apple macOS 설정 · macOS

Query Streams 에이전트를 설치하세요. macOS

에이전트는 데이터 옆에 상주하며 연결 작업을 수행하는 작은 프로그램입니다. 한 번 설치하면 나머지 설정은 브라우저에서 진행하면 됩니다.

약 10분 코딩이 필요 없습니다 데이터는 안전하게 보관됩니다.
진행 과정에서 막히는 부분이 있나요? 언제든지 저희에게 문의하세요. 열려 있는 지원 쿼리 스트림(오른쪽 상단 메뉴 → 지원)에서 메시지를 보내주세요. 담당자가 직접 확인하며, "이 화면에서 무엇을 묻는지 모르겠습니다"라는 질문은 전혀 문제없습니다.

Query Streams를 사용하면 데이터베이스와 비즈니스 앱에서 실시간 데이터를 가져와 Excel, Google Sheets, 보고서 또는 AI 비서로 바로 내보낼 수 있습니다. 데이터를 먼저 복사할 필요가 전혀 없습니다. 이를 위해서는 데이터에 접근할 수 있는 환경에서 실행되는 작은 도우미 프로그램 하나만 있으면 됩니다. 그 도우미 프로그램이 바로 Query Streams입니다. 대리인.

시작하기 전에 필요한 것

깨어있는 맥

사용자가 쿼리를 실행할 때는 시스템이 활성화되어 있어야 하므로 에너지 설정을 확인하는 것이 좋습니다. Apple Silicon(M1~M4) 및 Intel Mac에서 기본적으로 실행됩니다.

로그인 키

이 에이전트를 조직에 연결하는 일회성 코드입니다. 다운로드 페이지의 쿼리 스트림에서 설치 프로그램 바로 옆에 있습니다.

데이터베이스 정보

서버 이름, 데이터베이스 이름, 그리고 해당 데이터베이스를 읽을 수 있는 사용자 이름과 비밀번호가 필요합니다. 다른 사람이 데이터베이스를 관리하는 경우, 이 정보는 그 사람에게 문의해야 합니다.

어디에 놓아야 할까요? 에이전트는 현재 데이터베이스를 열 수 있는 컴퓨터(일반적으로 데이터베이스 서버 자체 또는 동일한 사무실 네트워크에 있는 모든 PC)에 설치하십시오. 해당 컴퓨터에서 데이터에 액세스할 수 있다면 에이전트도 액세스할 수 있습니다.

네 단계에 걸쳐 설치하세요

  1. 설치 프로그램을 다운로드하고 실행하세요.

    로그인하세요 my.querystreams.com/download macOS 다운로드를 선택하세요. Apple Silicon 및 Intel 네이티브 빌드가 있습니다. 사용 중인 Mac에 맞는 빌드를 다운로드한 다음 터미널에서 몇 줄의 명령어로 설치하세요. 관리자 암호가 필요합니다.

    열려 있는 단말기 (누르다 ⌘ 공간 "터미널"을 입력하고 Mac에 맞는 명령어를 붙여넣으세요. 어떤 Mac을 사용하고 있는지 모르시겠나요? Apple 메뉴를 참조하세요. 이 Mac에 대하여: 칩: 애플 M… 애플 실리콘을 의미합니다. 프로세서: 인텔… 인텔을 의미합니다.

    애플 실리콘(M1~M4)
    cd ~/Downloads mkdir -p querystreams-agent tar -xzf querystreams-agent_*_osx-arm64.tar.gz -C querystreams-agent cd querystreams-agent sudo ./install.sh
    인텔 맥
    cd ~/Downloads mkdir -p querystreams-agent tar -xzf querystreams-agent_*_osx-x64.tar.gz -C querystreams-agent cd querystreams-agent sudo ./install.sh

    그만큼 * 버전 번호를 대신하므로 직접 입력할 필요가 없습니다. 해당 폴더에 여러 버전을 다운로드한 경우 전체 파일 이름을 입력하세요.

    슈도 맥 암호를 입력하라는 메시지가 나타납니다. 입력하는 동안 아무것도 표시되지 않습니다. 이는 정상입니다. 버튼을 누르세요. 반품 다 끝나면.

    Safari로 다운로드했다면, Safari가 이미 다운로드한 파일 이름으로 된 폴더에 압축을 풀어놓았을 수도 있습니다 (Safari는 이렇게 합니다). 다운로드 후 "안전한" 파일을 열어보세요 켜져 있습니다.) 그런 경우에는 타르 해당 파일을 찾을 수 없다는 메시지가 표시될 수 있습니다. 그럴 때는 해당 폴더로 이동하여 거기서 설치 프로그램을 실행하세요.

    Safari가 이미 압축을 푼 경우
    cd ~/Downloads/querystreams-agent_*_osx-* sudo ./install.sh

    그런 다음 실행 중인지 확인하세요. 그러면 끝에 로 끝나는 줄이 표시될 것입니다. com.querystreams.agent:

    서비스를 확인하세요
    sudo launchctl list | grep querystreams

    아무런 응답이 없으면 로그는 다음과 같습니다. /usr/local/querystreams/agent/logs/agent-stdout.log — 그것을 ~에 부착하세요 지원 요청 그 다음 단계는 저희가 진행하겠습니다. 설치가 완료되면 삭제하시면 됩니다. 쿼리스트림 에이전트 다운로드 폴더에 있습니다.

    에이전트는 백그라운드 서비스로 등록되는데, 이는 맥이 부팅될 때마다 자동으로 시작된다는 뜻입니다. 따라서 사용자가 따로 실행할 필요가 없으며, 다운로드는 부팅 시에만 필요합니다. 이후부터는 자동으로 업데이트됩니다..

  2. 키를 사용하여 로그인하세요

    에이전트가 설치되면 해당 컴퓨터에서 에이전트 페이지를 엽니다.

    방금 설치한 Mac에서
    http://localhost:1823

    로그인 키를 붙여넣으세요. 배지를 확인하세요. 왼쪽 상단 모서리일단 읽으면 "쿼리 스트림에 연결됨" 초록색 점이 표시되면 완료입니다. 에이전트가 사용자 계정에 자신을 소개하는 과정이며, 이 컴퓨터에서 해야 할 마지막 작업입니다.

    페이지 자체에도 같은 내용이 나와 있습니다. "이 에이전트는 연결을 로컬에서 실행하며, 일상적인 관리는 쿼리 스트림 포털에서 이루어집니다." 이제 창을 닫고 브라우저에서 계속 작업할 때입니다.

  3. 브라우저에서 첫 번째 연결을 추가하세요

    이제 브라우저에서 Query Streams로 돌아가서 열어보세요. 데이터 에이전트 (아래에 있습니다) 데이터 상단 메뉴에서 담당 에이전트를 확인하세요. 새 에이전트 정보가 거기에 표시됩니다. 클릭하세요. 커넥터 추가 다음 질문에 답하세요. 어떤 종류의 데이터베이스 또는 앱인지 선택한 다음, 이전에 수집한 세부 정보를 입력하세요.

    저장하기 전에 연결을 테스트할 수 있으므로 세부 정보가 올바른지 나중에 확인하는 대신 즉시 알 수 있습니다. Query Streams는 일반적인 데이터베이스에 대한 적절한 설정을 제안하고, 바로 실행할 수 있는 몇 가지 예제 쿼리를 제공합니다.

    저장되면 쿼리 스트림은 데이터베이스를 살펴보고 테이블, 열, 그리고 이들 간의 관계 등 데이터베이스에 있는 모든 정보를 기록합니다. 이 정보가 쿼리 빌더에서 선택하는 목록을 채우는 데 사용되며, Nova가 테이블 이름을 하나도 지정하지 않고도 "지난달에 몇 건의 주문을 배송했습니까?"와 같은 질문에 답할 수 있는 이유입니다. 쿼리 스트림은 별도로 활성화하거나 설정할 필요가 없으며, 데이터베이스 변경 사항에 따라 자동으로 업데이트됩니다.

    그것은 내용물이 아니라 모양을 읽는 것이다. 이 단계는 행이 아닌 테이블 및 열 이름에 관한 것입니다. 대규모 데이터베이스의 경우 완료하는 데 몇 분 정도 걸릴 수 있습니다. 기다릴 필요는 없으며, 완료되면 커넥터에서 확인할 수 있습니다. 데이터 에이전트.

    비밀번호는 절대로 그 컴퓨터 밖으로 나가지 않습니다. 연결을 저장하면 세부 정보가 암호화된 링크를 통해 에이전트로 전송되고 자격 증명은 당사가 아닌 사용자 컴퓨터에 저장됩니다.

  4. 첫 번째 쿼리를 실행하세요

    가장 빠른 방법은 커넥터 설정의 마지막 화면에서 "쿼리 시작"을 누르는 것입니다. 그것이 열립니다 쿼리 빌더 새로운 연결이 이미 선택되어 있으므로 따로 찾을 필요가 없습니다. 상단 메뉴에서도 언제든지 해당 설정으로 이동할 수 있습니다.

    그다음에는 미리 만들어진 예제 쿼리 중 하나를 실행하거나, 직접 쿼리를 작성하거나, 또는 저희 도우미인 Nova에게 일반적인 영어로 질문하여 쿼리를 작성하도록 할 수 있습니다.

    쿼리를 저장하면 어디에서든 재사용할 수 있습니다. Excel이나 Google Sheets에서 새로 고치거나, 일정을 예약하거나, 동료와 공유하거나, AI 비서에게 전달하거나, 다른 시스템에서 호출할 수 있는 웹 링크로 변환할 수 있습니다.

조각들이 어떻게 맞춰지는지

당신의 네트워크 쿼리 스트림 브라우저에서 에이전트 Windows PC에서 데이터베이스 절대 움직이지 않는다 설정 전용 결과 읽어요
브라우저에서 설정을 완료하면 에이전트가 네트워크 내부에서 데이터를 읽어옵니다. 쿼리에서 요청한 행만 전송되며, 에이전트는 항상 외부로 데이터를 전송하므로 작동을 위해 인터넷에 아무것도 개방할 필요가 없습니다.

브라우저에서 모든 것을 관리할 수 있습니다.

에이전트를 설치하고 로그인하면, 그 기계로 다시 돌아갈 필요는 없을 겁니다. 연결, 포함할 데이터베이스, 데이터 새로 고침 빈도, 에이전트 자체 설정 등 모든 것이 한 곳에서 관리됩니다. 데이터 에이전트 어디에 있든 브라우저에서 접속할 수 있습니다.

브라우저에서 스트림을 쿼리하세요

어디에서든 실제로 할 수 있는 모든 것:

  • 연결 추가, 편집 및 삭제
  • 연결 테스트 중
  • 포함할 데이터베이스 선택하기
  • 데이터 새로 고침 빈도 설정
  • 모든 에이전트 설정

에이전트 개인 페이지

단 하나의 직업, 그리고 어쩌면 평생 필요 없을지도 모릅니다:

  • 에이전트가 쿼리 스트림에 연결할 수 없는 이유 확인

브라우저에서 상담원이 오프라인으로 표시되고 이유를 알 수 없는 경우, 다음을 열어 보세요. 로컬호스트:1823 해당 기기에 있습니다. 왼쪽 상단 모서리에 있는 배지를 보면 바로 알 수 있습니다.네 가지 상태가 무엇을 의미하는지 알아보세요또한, 브라우저가 할 수 없는 것처럼, 해당 위치에서 네트워크를 볼 수 있습니다.

에이전트가 완전히 개입하지 않게 되었습니다. 한 번 설치하면 신경 쓸 필요 없이 바로 사용할 수 있도록 설계되었습니다. 모든 운영 환경이 이러한 방향으로 나아가고 있습니다. 데이터 에이전트 브라우저에서 확인하는 것이 가장 좋으며, 에이전트 자체 페이지에는 쿼리 스트림에 연결할 수 없는 이유를 파악하는 데 도움이 되는 정보만 저장됩니다. 따라서 가이드나 동료가 에이전트 컴퓨터에서 설정을 구성하라고 하면 먼저 브라우저를 확인하세요.

이 가이드의 이전 버전을 읽으셨다면: 연결은 에이전트 본인의 페이지에서 설정해야 한다고 나와 있었습니다. ~ 아니다 브라우저에서 설정하셨나요? 더 이상 그렇지 않습니다. 이제 브라우저에서 설정하는 것이 가장 좋습니다. 기존 방식으로 설정한 모든 항목은 여전히 작동하며, 데이터 에이전트에서 확인하실 수 있습니다.

에이전트가 쿼리 스트림과 통신하고 있습니까?

요원 페이지 왼쪽 상단에 있는 배지가 거의 모든 "이게 왜 작동하지 않지?"라는 질문에 대한 답입니다. 항상 네 가지 중 하나를 나타내며, 그 문구를 통해 현재 상황을 정확하게 알 수 있습니다. 바로 이것을 찾으시면 됩니다.

쿼리 스트림에 연결됨
쿼리 스트림에 연결하기 쿼리 스트림에 다시 연결 중
쿼리 스트림에서 연결이 끊어졌습니다.

연결 중이거나 연결이 끊어진 상태는 동일하게 표시됩니다. 움직이는 색상 띠는 "처리 중"을 의미하고, 고정된 녹색 불빛은 연결 완료를 의미합니다. 흐릿하고 평평한 배지는 연결되지 않았음을 나타냅니다.

저 작은 불빛은 버튼이 아닙니다. 상태만 표시할 뿐, 클릭하면 아무런 반응이 없습니다. 연결하다, 다시 연결 그리고 연결을 끊으세요 제어 기능은 페이지 하단의 연결 패널에 있는 버튼으로 이름이 지정되어 있는데, 이는 의도적인 것입니다. 클릭하면 에이전트를 조용히 오프라인으로 전환하는 레이블 없는 표시등은 제거해야 할 함정이었기 때문입니다.

다 좋아요쿼리 스트림에 연결됨

모든 것이 정상 작동합니다. 쿼리가 실행되고 브라우저에서 변경한 내용이 몇 초 내에 이 에이전트에 반영됩니다. 더 이상 하실 일은 없습니다.

시작쿼리 스트림에 연결하기

기기가 부팅되거나 에이전트가 다시 시작된 후 몇 초 동안은 정상적인 현상입니다. 잠시 기다려 주십시오.

처리 중입니다쿼리 스트림에 다시 연결 중

연결이 끊어졌지만 에이전트가 자동으로 다시 연결하고 있습니다. 이는 일반적으로 일시적인 네트워크 오류이며 사용자의 도움은 필요하지 않습니다.

만약 이 상태가 몇 분 이상 지속된다면, 네트워크상의 어떤 문제가 연결을 차단하고 있는 것입니다. 그런 경우에는 저희에게 알려주시기 바랍니다.

주의가 필요합니다쿼리 스트림에서 연결이 끊어졌습니다.

이 상태에서는 해당 에이전트의 어떤 기능도 작동하지 않습니다. 실제로 자료를 읽는 것은 담당자가 하는 일이므로, 담당자와 연락이 닿지 않으면 작업을 진행할 사람이 아무도 없습니다.

기기가 온라인 상태인지 확인한 후 누르십시오. 다시 연결 연결 패널에서 확인해 보세요. 만약 연결이 되지 않는다면, 방화벽이나 프록시가 나가는 트래픽을 차단하고 있는 경우가 많습니다. 저희에게 메시지를 보내주시면 문제 해결을 도와드리겠습니다.

에이전트 연결이 끊어진 동안 무엇이 중단됩니까? 데이터와 접촉해야 하는 모든 것:

  • 해당 연결에 대한 쿼리는 쿼리 빌더, Excel 또는 Google Sheets, REST API 또는 AI 비서에서 실행되지 않습니다.
  • 해당 데이터에 대한 예약된 새로 고침 및 자동화 작업이 실행되지 않습니다.
  • 해당 연결은 브라우저에서 테스트, 검색 또는 새로 고침할 수 없습니다.
  • 데이터 에이전트에서는 오프라인으로 표시되며, 표시되는 수치는 다음과 같습니다. 마지막으로 알려진 사는 것보다 차라리 다른 것

하지만 아무것도 손실되지 않습니다. 브라우저가 연결이 끊긴 동안 저장한 변경 사항은 그대로 유지되며 다시 연결되는 즉시 적용됩니다. 따라서 기다릴 필요 없이 설정을 계속 진행할 수 있습니다.

연결 문제에 대해 문의하고 싶으신가요? 해당 페이지의 연결 패널에는 저희에게 가장 도움이 되는 네 가지 사항이 나열되어 있습니다. 그것들을 복사해서 붙여넣으세요. 지원 메시지를 주고받으면 대개 주고받는 과정을 생략할 수 있습니다.

기계
에이전트가 실행 중인 컴퓨터
조직
어떤 계정에 연결되어 있나요?
에이전트 버전
현재 실행 중인 빌드는 무엇입니까?
연결됨
마지막으로 연결에 성공했을 때

스스로 최신 정보를 유지합니다.

에이전트는 한 번만 설치하면 됩니다. 다시 다운로드하라는 메시지가 뜨지 않으며, "업데이트 가능" 알림에 신경 쓸 필요도 없습니다. 새 버전이 출시되면 에이전트가 자동으로 업데이트를 처리하며, 보통 몇 초 안에 완료됩니다.

업데이트를 놓치지 않도록 확인하는 세 가지 방법이 있습니다.

대개 순식간에

업데이트를 게시하는 즉시 에이전트가 이미 열어 놓은 연결을 통해 업데이트를 바로 전송합니다. 에이전트는 제자리에서 업데이트되고 자동으로 재시작됩니다.

전원이 꺼져 있다면 재연결 후 몇 초

다시 온라인에 접속한 후 몇 초 뒤에 놓친 것이 있는지 묻고, 그 후에 따라잡습니다.

벨트와 멜빵 하루에 한 번, 혼자서

또한 자체 발신 연결을 사용하여 하루에 한 번씩 상태를 확인하므로, 엄격하게 통제된 네트워크 환경에서도 최신 상태를 유지합니다.

제대로 따라가고 있는지 어떻게 알 수 있을까요? 에이전트 페이지의 연결 패널에는 다음이 표시됩니다. 에이전트 버전정상적인 상황에서는 현재 릴리스 버전을 자동으로 추적합니다. 하지만 업데이트가 며칠 동안 지연되는 것을 발견했다면 네트워크상의 문제로 업데이트 경로가 차단되고 있는 것이므로, 해당 문제는 점검이 필요할 수 있습니다. 저희에게 메시지를 보내주세요왜냐하면 그것은 요원이 말로 빠져나갈 수 있는 문제가 아니기 때문입니다.

새로운 연결은 언제부터 작동하기 시작하나요?

거의 항상 몇 초 이내에 답변드립니다. 정확한 답변은 상담원에 따라 다릅니다.

대개 몇 초

에이전트가 실행 중이고 최신 상태이므로 변경 사항을 즉시 감지합니다. 재시작이 필요하지 않습니다.

전원이 꺼져 있다면 다시 연결될 때

잔돈은 안전하게 보관되며, 기기가 다시 작동되는 즉시 적용됩니다.

고령의 에이전트 다음 재시작 시

에이전트는 자체적으로 업데이트되므로 드문 경우입니다. 쿼리 스트림은 해당 사항이 사용자에게 적용되는지 여부를 화면에 알려줍니다.

Reading files on a network share

If a connector needs a file or folder on a network share, mount the share on this Mac before you add the connector. Mount it from Terminal with 슈도, in a folder under /Volumes, so the Agent, which runs as a system background service, can see it. Share logins stored in the Portal are used by Windows Agents only. In the connector you can keep the \\서버\공유 path, which the Agent maps onto the mount, or type the mount path directly. If the share isn’t mounted, 테스트 연결 says it is not mounted and shows the exact command to run.

How to mount a share for the Agent on a Mac

자주 묻는 질문

연결을 추가, 편집 또는 삭제하려면 어디에 있어야 하나요?

브라우저에서, 데이터 에이전트 페이지 — 사용 커넥터 추가변경 사항은 일반적으로 몇 초 내에 에이전트에 반영됩니다. 에이전트가 오프라인 상태였던 경우, 다시 연결되는 즉시 변경 사항이 적용됩니다. 연결을 추가하거나 변경하기 위해 에이전트 시스템을 직접 조작할 필요가 없습니다.

내 데이터가 쿼리 스트림으로 복사되나요?

아니요. 데이터베이스는 원래 위치에 그대로 유지됩니다. 쿼리를 실행하면 에이전트가 데이터베이스를 읽고 쿼리에서 요청한 행만 반환합니다. 데이터베이스 암호는 에이전트 컴퓨터에 저장됩니다.

포트를 열어야 하나요, 아니면 방화벽 설정을 변경해야 하나요?

일반적으로는 그렇지 않습니다. 에이전트는 웹 브라우저와 마찬가지로 우리에게 외부 연결을 설정합니다. 인터넷에서 들어오는 트래픽을 수락할 필요는 없습니다.

에이전트를 두 개 이상 사용할 수 있나요?

네, 많은 조직에서 사이트별 또는 네트워크별로 에이전트를 운영합니다. 모든 에이전트가 계정에 함께 표시되므로 쿼리를 작성하는 사람은 어떤 에이전트가 어떤 연결을 담당하는지 알 수 없습니다.

계속 업데이트해야 하나요?

아니요, 클릭할 것도 없습니다. 새 버전이 게시되면 기존에 열려 있는 연결을 통해 에이전트로 푸시되므로 일반적으로 몇 초 안에 업데이트되고 자동으로 재시작됩니다. 또한 안전 장치로 하루에 한 번 자체적으로 업데이트를 확인합니다. 현재 버전은 [버전 정보]에서 확인할 수 있습니다. 에이전트 버전 연결 패널에서 확인할 수 있습니다.

만약 중간에 막히면 어떡하죠?

저희에게 메시지를 보내주세요 지원 Query Streams 내부에서 어디까지 진행했는지 알려주세요. 더 쉽게 설명드리려면, 어떤 화면을 보고 있었고 어떤 결과를 기대했는지 알려주시면 됩니다. 보통 그 정보만으로도 문제를 파악하는 데 도움이 됩니다.

계획대로 되지 않았나요? 그렇다면 저희에게 알려주세요. 열려 있는 지원 팀에 메시지를 보내려면 쿼리 스트림을 이용하거나, 더 많은 가이드를 보려면 기술 자료 탭을 참조하세요. 이 페이지의 단계가 화면에 표시된 내용과 일치하지 않는 경우 알려주세요. 가이드에 수정이 필요한 것이지, 사용자가 잘못한 것은 아닙니다.
다른 곳에 설치하시겠습니까? 윈도우 리눅스

Setup trouble?

  • Agent shows Offline, or Test connection and Browse are greyed out? Check that the Agent is online → Is the Agent online?
Updated on 10월 12, 2026

Powered by BetterDocs