DuckDB → Excel · Query Streams 사용
Query Streams를 사용하면 DuckDB 파일은 원래 위치에 그대로 유지됩니다. 새로고침할 때마다 Agent가 파일을 열고, 복사되는 내용은 없으며, Query Streams 추가 기능을 통해 행이 Excel에 실시간으로 표시됩니다. 처음 설정하는 데 약 10분이 걸리며, Free 플랜으로 이용할 수 있습니다.
무료로 시작하세요
당신이 최종적으로 얻게 될 것
DuckDB 파일에 대한 SQL 쿼리 결과를 실시간으로 보여주는 워크시트입니다. 데이터가 변경될 때마다 최신 행을 가져오는 버튼도 있습니다. 예를 들어 다음과 같습니다.
| A | B | C | D | E | |
|---|---|---|---|---|---|
| 1 | customer_id | 첫 번째 이름 | 성 | 국가 | 총 |
| 2 | 1042 | 마리아 | 알바레스 | 미국 | 1,284.50 |
| 3 | 1043 | 다니엘 | 오카포르 | 미국 | 612.00 |
| 4 | 1047 | 프리야 | 나이르 | 미국 | 2,090.75 |
| 5 | 1051 | 도마 | 산 | 미국 | 338.20 |
| 6 | 1056 | 루시아 | 페레이라 | 미국 | 1,455.00 |
| 7 | 1060 | 켄지 | 사토 | 미국 | 874.10 |
| 8 |
DuckDB 데이터베이스는 일반적으로 .dpm으로 끝나는 단일 파일입니다. .duckdbExcel은 이러한 파일을 자체적으로 열 수 없으며, 일반적인 해결 방법은 ODBC 드라이버를 설치하고 연결 문자열을 설정하는 것입니다. Query Streams는 이러한 과정을 생략합니다. 작은 도우미 프로그램이 파일이 있는 위치에서 파일을 읽어오고, Excel 추가 기능이 해당 파일에서 원하는 행을 요청합니다. 두 프로그램은 같은 컴퓨터에 있을 필요가 없습니다. 파일은 회사 컴퓨터에 있어도 되고, 사용자는 집의 노트북, 멀리 떨어진 동료의 컴퓨터, 또는 웹 브라우저를 통해 Excel에서 작업할 수 있습니다.
필요한 것
파일을 열 수 있는 컴퓨터의 에이전트
백그라운드에서 실행되는 작은 프로그램으로, Excel에서 파일을 요청할 때 파일을 읽어줍니다. 아래 2단계에서 해당 프로그램을 어디에서 구할 수 있는지 보여줍니다.
DuckDB 파일
예를 들어, 그것이 어디에 있는지 알아두세요. C:\Data\sales.duckdb 또는 \\server\share\sales.duckdbOneDrive, Dropbox 또는 Google Drive에 파일이 있는 경우 에이전트 컴퓨터와 동기화되어 있는지 확인하십시오.
어떤 컴퓨터가 에이전트를 갖게 되나요? 파일이 있는 위치 또는 네트워크 공유에서 파일을 열 수 있는 권한(참조) 네트워크 공유의 파일에 접근하기 아래). 저 컴퓨터는 켜져 있어야 합니다. 엑셀은 어디에든 있을 수 있습니다.집의 노트북, 멀리 떨어진 동료의 컴퓨터, 또는 웹상의 Excel 등 어떤 환경에서든 Excel이 실행될 때 다른 프로그램을 설치할 필요가 없습니다.
5단계로 연결하세요
-
계정을 만드세요
가다 my.querystreams.com 가입하세요. 선택하세요. 무료 정식 플랜입니다. 체험판이 아니라 실제 플랜이며, DuckDB 파일을 연결하고 Excel에서 쿼리를 실행하는 방법을 포함합니다.
해당 파일을 열 수 있는 컴퓨터에 에이전트를 설치하세요.



로그인, 열기 다운로드그런 다음 해당 파일이 있는 컴퓨터 또는 네트워크 공유에서 파일을 열 수 있는 컴퓨터에 시스템용 에이전트를 설치하십시오. 설치하는 데 1분 정도 소요되며, 이후에는 자동으로 시작됩니다.
드라이버 대신 작은 프로그램을 사용하는 이유는 무엇인가요? 에이전트는 Windows, Mac 또는 Linux용으로 한 번만 설치하면 되며(Windows에서는 약 85MB, Mac 및 Linux에서는 100MB 조금 넘음), 백그라운드에서 조용히 실행됩니다. 웹 브라우저와 마찬가지로 쿼리 스트림에 암호화된 연결을 한 번만 생성하므로 방화벽 포트를 열거나 VPN을 설정할 필요가 없습니다. 파일은 원래 위치에 그대로 유지되고, 필요한 경우 인터넷을 통해 행 데이터가 사용자의 위치로 전송됩니다. 사용자가 해야 할 일은 추가 기능 설치뿐입니다.
다운로드 페이지가 표시됩니다 액세스 키에이전트가 요청할 때 해당 코드를 붙여넣고 배지가 인식될 때까지 기다리세요. 쿼리 스트림에 연결됨에이전트 자체에서 할 수 있는 일은 그게 전부입니다.
-
DuckDB 파일을 가리키도록 설정하세요.
브라우저로 돌아가서 열기 데이터 에이전트 (아래에 데이터 상단 메뉴에서 담당 에이전트를 확인하세요. (상단 메뉴에 있습니다.) 커넥터 추가, 선택하다 DuckDB그리고 다음 내용을 기입하세요:
- 연결 이름
- 나중에 알아볼 수 있는 이름들입니다. 예를 들어, 판매 데이터베이스 같은 것이죠.
- 데이터베이스 파일 경로
- DuckDB 파일(.duckdb 또는 .db)의 위치는 에이전트 컴퓨터의 경로 또는 네트워크 경로(예: \\server\share\folder\sales.duckdb)여야 하며, S:와 같은 매핑된 드라이브 문자는 사용할 수 없습니다. 찾아보기를 사용하여 파일을 선택하십시오.
클릭 테스트 연결읽을 때 연결됨클릭 저장연결은 몇 초 내에 에이전트에 도달합니다.
테스트에 실패했나요? 일반적으로 경로에 오타가 있거나 매핑된 드라이브 문자(예: )가 사용됩니다. 에스:에이전트가 볼 수 없는 파일입니다. 폴더를 열고 주소 표시줄에서 경로를 복사한 다음 다시 붙여넣으세요. 다른 컴퓨터에 있는 파일의 경우 다음을 참조하세요. 네트워크 공유의 파일에 접근하기 아래에.
-
쿼리 빌더에서 데이터를 확인하세요 선택 과목
엑셀을 사용하기 전에도 DuckDB 파일을 확인할 수 있습니다. 열기 쿼리 빌더 포털에 접속하여 방금 연결한 연결을 선택하세요. 스키마 탭에는 테이블과 열 목록이 표시되며, 하나를 클릭하면 편집기에 해당 이름이 입력되므로 정확한 이름을 기억하지 않고도 쿼리를 작성할 수 있습니다. 클릭하세요. 실행 그리고 행들은 아래에 나타납니다 결과쿼리 빌더는 무료 플랜을 포함한 모든 플랜에 포함되어 있습니다.
비즈니스 플랜에서는 Nova에 일반적인 영어 표현("미국 고객을 보여줘")으로 요청할 수도 있으며, Nova가 해당 SQL 쿼리를 자동으로 작성해 줍니다. 쿼리가 올바르게 작성되면 저장하세요. Personal Core 플랜 이상에서는 저장된 쿼리가 추가 기능의 "저장된 쿼리" 목록에 표시되며, 모든 플랜에서 해당 SQL 쿼리를 다음 단계로 복사할 수 있습니다.
-
Excel에 쿼리 스트림 추가
엑셀에서 다음으로 이동하세요. 삽입 → 추가 기능 가져오기검색하세요 쿼리 스트림그리고 클릭하세요 추가하다또는 바로 열어보세요. Microsoft AppSource에서 Query Streams를 검색하세요.리본 메뉴에 '스트림 쿼리' 버튼이 나타납니다. 동일한 계정으로 로그인하세요.
Windows 및 Mac용 Microsoft 365 Excel과 웹 버전 Excel에서 작동합니다.
-
첫 번째 테이블을 가져오세요
"쿼리 스트림" 버튼을 클릭하고 선택하세요. 쿼리를 스트리밍하세요그리고 방금 연결한 연결을 선택하세요.
실행하려는 쿼리를 입력하세요. 이 쿼리는 테이블에서 몇 개의 열을 가져옵니다. 주문 테이블:
예시 · SQLSELECT order_id, customer_name, order_total FROM main.orders ORDER BY order_total DESC LIMIT 100;
아래에 목적지 정보 선택하다 새 시트를 만드세요그런 다음 재생 버튼(▶ 화살표)을 누르세요. 1~2초 안에 행이 Excel에 나타납니다. 데이터가 변경될 때마다 재생 버튼을 다시 누르면 시트가 자동으로 업데이트됩니다.
SQL을 모르시나요? 내장 쿼리 빌더 먼저 내용을 복사해서 여기에 붙여넣거나, 저장해둔 쿼리가 있다면 저장된 쿼리에서 선택하세요.
네트워크 공유의 파일에 접근하기
에이전트는 사용자가 아닌 백그라운드 서비스로 파일을 열기 때문에 다른 컴퓨터에 있는 파일을 열려면 추가 단계가 필요합니다. 어떤 단계가 필요한지는 에이전트가 실행되는 컴퓨터에 따라 다릅니다.
테스트가 공유 폴더에 접근할 수 없는 경우, 결과에서 다음 단어들을 찾아보세요. 도달할 수 없음 에이전트 컴퓨터가 서버로부터 응답을 받지 못했다는 의미입니다. Linux 또는 Mac 환경에서는 장착되지 않음 이는 공유 폴더가 아직 마운트되지 않았다는 의미이며, 해당 메시지에는 서버에 맞는 정확한 마운트 명령이 포함되어 있습니다.
공유 폴더에 DuckDB 파일이 있나요? DuckDB는 한 번에 한 프로그램만 쓰기 작업을 허용하므로, 에이전트는 다른 프로그램에서 쓰기 모드로 열려 있는 파일을 열 수 없습니다. \\서버\공유 테스트에서 경로라고 나와 있습니다. 다른 프로그램에서 쓰기 작업을 할 수 있도록 열려 있습니다.거기서 닫거나, 아무도 쓰지 않는 파일을 커넥터로 지정하세요. 모든 쿼리는 네트워크를 통해 파일을 읽기 때문에 큰 파일은 로컬 디스크에서 읽을 때보다 응답 속도가 느립니다.
공유 관련 테스트가 실패했나요?
Windows 에이전트는 파일 서버 자체에 로그인하므로 테스트 결과에 다음과 같은 내용도 포함될 수 있습니다.
| 메시지 | 원인 | 고치다 |
|---|---|---|
| 에이전트 서비스 계정에 대한 액세스가 거부되었습니다. 길 아래, 또는 접근 불가 시험 결과에서 | 해당 공유 폴더에는 지정된 사용자만 접근할 수 있는데, 에이전트 본인의 Windows 계정은 그 사용자 목록에 포함되어 있지 않습니다. 또는 해당 서버에 저장된 로그인 정보로 이 공유 폴더를 읽을 수 없는 것일 수도 있습니다. | 클릭 서비스 ID 해당 경로 아래에 공유 폴더를 읽을 수 있는 로그인 정보를 저장하세요. 이미 저장된 로그인 정보가 있다면 서버 관리자에게 해당 계정에 읽기 권한을 부여해 달라고 요청하세요. |
| 자격 증명이 거부되었습니다. | 서버에서 저장된 로그인 정보를 거부했습니다. 오타, 잘못된 도메인 또는 저장된 이후 변경된 비밀번호 때문일 수 있습니다. | 경로 아래에 있는 계정 이름을 클릭하고 로그인 정보를 다시 입력하세요. 서버 자체에서 생성한 계정의 경우, 그대로 두세요. 도메인 공백. 방금 전에 거절당했습니다. 즉, 에이전트가 동일한 로그인 시도를 다시 하기 전에 1분 동안 대기하므로 계정이 잠기지 않습니다. 수정된 비밀번호를 저장하면 즉시 다시 시도합니다. |
| 이 에이전트의 다른 커넥터가 이미 로그인되어 있습니다., 또는 Windows에는 이미 로그인 정보가 있습니다. | 이 Windows 컴퓨터는 이미 다른 커넥터 또는 다른 프로그램을 통해 다른 계정으로 해당 서버에 로그인되어 있습니다. Windows는 서버당 하나의 계정만 허용합니다. | 다른 커넥터에서 사용하는 로그인 정보를 저장하거나, 해당 서버를 읽는 모든 커넥터에서 로그인 정보를 변경하십시오. Windows에는 이미 로그인 기능이 있습니다.나머지 메시지에는 어떤 계정인지, 그리고 어떻게 해야 하는지가 나와 있습니다. |
| 이 에이전트 빌드는 로그인할 수 없습니다. | 해당 에이전트는 저장된 공유 로그인 정보를 사용할 수 없는 이전 버전입니다. | 에이전트를 업데이트한 다음 다시 테스트하십시오. |
그게 다예요. 데이터는 스프레드시트에 저장되어 있으며 한 번의 클릭으로 최신 상태를 유지할 수 있습니다. 요청하신 행 외에는 네트워크를 통해 전송된 데이터가 없습니다.
좋은 다음 행보입니다
- 쿼리를 저장하세요 포털에 저장되므로 엑셀이나 구글 시트에서 한 번의 클릭으로 다시 실행할 수 있습니다.
- 필터를 추가하세요 날짜 범위를 지정할 수 있으므로 편집 없이 동일한 쿼리로 "이번 달"이라는 답변을 얻을 수 있습니다.
- 결과를 공유하세요 동료와 함께 작업할 때, 그들은 파일이나 파일 경로가 아닌 행만 보게 됩니다.
사람들이 묻는 질문
Excel과 DuckDB 파일이 같은 컴퓨터에 있어야 하나요?
아니요. DuckDB 파일을 열 수 있는 권한은 에이전트에만 있으면 됩니다. Excel은 인터넷에 연결된 모든 컴퓨터에서 실행 가능하며, 웹 버전 Excel이나 Mac용 Excel도 포함됩니다. 계정으로 추가 기능에 로그인하면 연결이 자동으로 설정됩니다.
내 데이터베이스 파일은 어디에 업로드되나요?
아니요. 에이전트는 파일이 있는 위치에서 파일을 읽고 쿼리에서 요청한 행만 전송합니다. 파일은 원래 위치에 그대로 있습니다.
해당 파일이 OneDrive, Dropbox 또는 Google Drive에 있을 수 있나요?
예, 에이전트가 실행되는 컴퓨터와 동기화되어 에이전트가 일반 로컬 파일처럼 인식하는 한 가능합니다. 동기화된 파일을 가리키도록 연결을 설정하십시오.
무료 플랜으로 이 모든 기능을 이용할 수 있나요?
네. 무료 플랜은 만료되는 체험판이 아니라, 계속 사용하실 수 있는 플랜입니다. 자세한 내용은 해당 페이지에서 확인하세요. 가격 페이지.
맥용 엑셀과 호환되나요?
예. 맥과 윈도우용 Microsoft 365 Excel, 그리고 웹 버전 Excel 모두 가능합니다.
관련 가이드
모든 가이드 DuckDB
원하는 설정이 아닌가요?
- DuckDB 데이터베이스 파일 대신 Parquet 파일이 담긴 폴더를 가지고 계신가요? Parquet Folder는 모든 파일을 하나의 테이블로 읽어들입니다. Parquet Folder
- 엑셀 통합 문서 자체를 쿼리하고 싶으신가요? Excel Folder는 통합 문서가 담긴 폴더를 테이블로 읽어들입니다. → Excel Folder
설치에 문제가 있으신가요?
- 에이전트에서 파일이나 폴더가 존재하지 않거나 액세스가 거부되었다고 표시되나요? 매핑된 드라이브, 네트워크 공유, OneDrive 및 Linux 홈 폴더 각각에 대한 해결 방법이 다릅니다. → 에이전트가 파일을 읽을 수 있는 위치
- 에이전트가 오프라인으로 표시되거나, 연결 테스트 및 찾아보기 옵션이 비활성화되어 있습니까? 에이전트가 온라인 상태인지 확인하십시오. 상담원이 온라인 상태인가요?


