DuckDB 스마트 시트
쿼리 스트림
Query Streams는 Smartsheet와 DuckDB를 원활하게 통합하여 DuckDB의 실시간 데이터를 Smartsheet 시트에 자동으로 동기화합니다. QueryStreams.com에서 무료로 가입하세요. DuckDB에서 Smartsheet로의 데이터 파이프라인 자동화를 단 몇 분 만에 시작하세요.
이 가이드에서는 Query Streams를 사용하여 DuckDB에서 Smartsheet로 데이터를 자동 동기화하는 방법을 설명합니다. 프로젝트 관리 시트를 데이터베이스 기록으로 최신 상태로 유지하거나, 재고 데이터를 공동 작업 공간에 동기화하거나, 보고 워크플로를 자동화해야 하는 경우, Query Streams는 DuckDB와 Smartsheet를 통합하는 안전하고 코딩이 필요 없는 솔루션을 제공합니다.
예약된 자동화
시간별, 일별 또는 사용자 지정 일정에 따라 동기화
보안 설계
자격 증명은 네트워크에 저장됩니다.
번개처럼 빠른
최적화된 데이터 스트리밍
스마트 싱크
자동으로 삽입, 업데이트, 삭제
Smartsheet와 DuckDB 연동이란 무엇인가요?
Smartsheet의 DuckDB 통합 기능은 DuckDB 데이터베이스를 Smartsheet에 연결하여 수동으로 내보내거나 가져올 필요 없이 자동으로 데이터를 동기화합니다. 쿼리 스트림은 데이터베이스와 Smartsheet 간의 안전한 연결 고리 역할을 하며, 저장된 SQL 쿼리를 예약된 시간에 실행하고 결과를 스프레드시트에 직접 푸시합니다.
주요 기능:
- 자동 동기화: 쿼리를 시간별, 일별 또는 사용자 지정 간격으로 실행하도록 예약합니다.
- 완전 동기화 모드: 새 행을 삽입하고, 기존 행을 업데이트하고, 삭제된 레코드를 자동으로 제거합니다.
- 추가 모드: 기존 데이터를 수정하지 않고 새 레코드를 추가합니다(로그 및 기록 관리에 적합).
- 안전한 연결: 데이터베이스 자격 증명은 네트워크 내에서 안전하게 보호됩니다.
- 코딩이 필요 없습니다. Query Streams 웹 포털을 통해 모든 설정을 구성하세요.
전제 조건
스마트시트 계정
API 접근 권한이 있는 Smartsheet 계정(비즈니스 및 엔터프라이즈 요금제 또는 무료 체험판을 통해 이용 가능).
저장된 쿼리
동기화하려는 데이터를 반환하는 쿼리가 쿼리 스트림에 하나 이상 저장되어 있어야 합니다.
1단계: DuckDB 쿼리 생성
연동을 설정하기 전에 Smartsheet와 동기화할 데이터를 반환하는 저장된 쿼리가 필요합니다.
- Query Streams 포털에 로그인하세요. 방문하다 my.querystreams.com 로그인하세요
- 쿼리 빌더를 엽니다. 대시보드에서 쿼리 빌더로 이동합니다.
- DuckDB 데이터 소스를 선택하세요: 왼쪽의 데이터 탐색기 사이드바에서 데이터 영역을 확장한 다음 DuckDB 커넥터를 선택하고 쿼리할 데이터베이스를 선택합니다.
- SQL 쿼리를 작성하세요: 동기화하려는 데이터를 반환하는 쿼리를 생성하세요.
SELECT order_id, customer_name, order_date, total_amount, status FROM orders WHERE order_date >= NOW() - INTERVAL '30 days' ORDER BY order_date DESC LIMIT 1000;
- 테스트 후 저장: 쿼리를 실행하여 결과를 확인한 다음 "Smartsheet 최근 주문"과 같이 설명적인 이름으로 저장하세요.
주문 IDSmartsheet에서 행을 일치시키는 데 사용할 수 있는 정보입니다.
2단계: Smartsheet 연동 생성
이제 자동화 기능을 통해 저장된 쿼리를 Smartsheet에 연결할 수 있습니다.
- 자동화 메뉴로 이동하세요: Query Streams 포털에서 클릭하세요. 자동화 왼쪽 사이드바에
- 새로운 통합을 생성하세요: 클릭 새로운 통합 설정 마법사를 시작하려면
- 저장된 쿼리를 선택하세요: 1단계에서 생성한 DuckDB 쿼리를 선택하세요.
- 대상 플랫폼으로 Smartsheet를 선택하세요. 선택하다 스마트 시트 사용 가능한 플랫폼 목록에서
3단계: Smartsheet 계정 연결
Query Streams는 OAuth와 API 액세스 토큰 인증을 모두 지원하여 Smartsheet 시트로 안전하게 데이터를 푸시할 수 있습니다.
Smartsheet에 연결하기(OAuth 또는 API 토큰)
- Smartsheet 계정에 로그인하세요.
- 프로필 아이콘을 클릭하고 선택하세요 앱 및 통합
- 선택하다 API 액세스
- 클릭 새 액세스 토큰을 생성합니다. (또는 자동 갱신을 위해 OAuth를 사용하세요)
- 토큰을 복사하세요(이 토큰은 한 번만 표시됩니다).
API 토큰을 입력하세요
Smartsheet API 토큰을 쿼리 스트림에 붙여넣으세요.
연결 상태를 테스트하세요
클릭 연결 테스트 Query Streams가 Smartsheet 계정에 액세스할 수 있는지 확인하려면
4단계: 목적지 선택 시트
Smartsheet에서 DuckDB 데이터를 동기화할 위치를 선택하세요.
- 시트를 찾아보세요: 쿼리 스트림을 사용하면 사용 가능한 Smartsheet 시트 및 작업 공간이 표시됩니다.
- 용지를 선택하세요: 데이터를 동기화할 기존 시트를 선택하거나, 새 시트를 만드세요
- 컬럼 매핑: 쿼리 스트림은 SQL 쿼리 열을 Smartsheet 열에 자동으로 매핑합니다. 필요에 따라 검토하고 조정하십시오.
5단계: 동기화 모드 구성
쿼리 스트림에서 데이터 동기화를 처리하는 방법을 선택하세요.
Append 모드
- 아래쪽에 새 행 추가
- 기존 행을 수정하지 않음
- 데이터를 절대 삭제하지 않습니다.
- 역사 기록을 보존합니다
Full Sync 모드
인기 있는- 삽입물 새로운 기록
- 업데이트 변경된 기록
- 삭제 삭제된 기록
- 키 열이 필요합니다
주요 열 선택: 전체 동기화 모드를 사용하는 경우 각 행을 고유하게 식별하는 열을 선택하십시오. 이 열은 SQL 쿼리 결과와 Smartsheet 시트 모두에 존재해야 합니다.
컬럼 동기화 동작(동기화 vs. 유지)
필드 매핑의 각 열에 대해 쿼리 스트림이 동기화 중에 해당 열을 처리하는 방법을 선택하세요.
동기화(기본값)
원천 값 항상 덮어씁니다 목표
보존하다
목표값은 덮어쓰기되지 않음
주문 ID– 주요 필드고객 이름– 동기화상태– 동기화총– 동기화
담당자에게 배정됨- 보존하다메모- 보존하다우선 사항- 보존하다
6단계: 동기화 일정 설정
DuckDB에서 Smartsheet로 데이터를 동기화하는 쿼리 스트림의 동기화 시점을 구성합니다.
7단계: 검토 및 활성화
- 구성을 검토합니다: 쿼리, 대상, 동기화 모드 및 일정 등 모든 설정을 확인하십시오.
- 통합 기능에 이름을 지정하세요: "스마트시트 일일 동기화 주문"처럼 설명적인 이름을 지정하세요.
- 활성화: 클릭 통합 생성 저장하고 활성화하려면
- 초기 동기화를 실행합니다. 클릭 지금 실행하세요 첫 번째 동기화를 수행하고 모든 것이 제대로 작동하는지 확인합니다.
축하해요!
DuckDB와 Smartsheet 연동 기능이 이제 활성화되었습니다. 설정하신 일정에 따라 데이터가 자동으로 동기화됩니다.
통합 모니터링
활성화 후에는 자동화 대시보드에서 Smartsheet DuckDB 통합을 모니터링할 수 있습니다.
마지막 동기화 시간
데이터가 마지막으로 동기화된 시점을 확인하세요.
행 동기화됨
삽입, 업데이트 및 삭제된 행 수를 확인하세요.
오류 알림
동기화 실패 시 알림을 받으세요
동기화 기록
이전 동기화 작업 및 그 결과를 검토합니다.
Smartsheet와 DuckDB 연동의 일반적인 사용 사례
프로젝트 관리
DuckDB 데이터베이스의 프로젝트 데이터, 마일스톤 및 리소스 할당을 Smartsheet와 동기화하여 팀 협업 및 가시성을 확보하세요.
영업 파이프라인
CRM 데이터베이스에서 가져온 최신 영업 기회, 거래 및 고객 정보를 영업팀의 스마트시트에 지속적으로 업데이트하세요.
재고 추적
창고 및 운영팀을 위해 Smartsheet에서 재고 수준, 재고 수량 및 제품 정보를 자동으로 업데이트합니다.
재무 보고
예산 데이터, 경비 보고서 및 재무 지표를 Smartsheet에 동기화하여 경영진 대시보드와 이해관계자 보고에 활용하세요.
인사 및 운영
인사정보시스템(HRIS) 데이터베이스와 Smartsheet 간에 직원 명부, 부서 명단 및 조직 데이터를 동기화 상태로 유지하세요.
스프레드시트를 넘어서: DuckDB를 위한 REST API + AI MCP
이미 DuckDB 데이터를 스프레드시트에 가져오고 계신가요? 저장된 쿼리를 파트너를 위한 실시간 REST 엔드포인트 또는 AI 도구가 일반 영어로 쿼리할 수 있는 MCP 서버로도 활용할 수 있습니다. 동일한 네트워크 에이전트와 자격 증명으로 두 가지 새로운 대상을 설정할 수 있습니다.
자주 묻는 질문
❓ DuckDB의 데이터를 Smartsheet와 얼마나 자주 동기화할 수 있나요? +
Query Streams는 매시간부터 사용자 지정 간격까지 다양한 동기화 일정을 지원합니다. 대부분의 경우, 일별 또는 시간별 동기화는 데이터의 최신성과 시스템 리소스 측면에서 적절한 균형을 제공합니다.
🔒 DuckDB 데이터 동기화 중 안전한가요? +
예. 데이터베이스 자격 증명은 Query Streams 에이전트를 통해 네트워크 내에서 안전하게 보호됩니다. 데이터는 전송 중에 암호화되며 Smartsheet API 토큰은 안전하게 저장됩니다. Query Streams는 데이터베이스의 원시 데이터를 절대 저장하지 않습니다.
⚠ 동기화가 실패하면 어떻게 되나요? +
Query Streams는 동기화 실패 시 재시도를 수행하고 지속적인 오류가 발생하면 알려줍니다. 동기화 기록에서 오류 세부 정보를 확인할 수 있으며, 문제가 해결되면 수동으로 재시도를 실행할 수 있습니다.
📂 DuckDB 데이터베이스를 사용하여 여러 Smartsheet 시트와 동기화할 수 있나요? +
예. 대상 시트별로 별도의 통합을 생성하세요. 각 통합은 서로 다른 SQL 쿼리, 동기화 모드 및 일정을 사용할 수 있습니다.
☁ 이 기능은 클라우드 기반 DuckDB 서비스와 호환되나요? +
예. Query Streams는 Amazon RDS for DuckDB, Azure Database for DuckDB, Google Cloud SQL for DuckDB, Heroku duckdb 및 자체 호스팅 인스턴스를 포함한 모든 DuckDB 변형을 지원합니다.

