나일 로고

멀티테넌트 포스트그레스 PostgreSQL을 사용합니다

연결하다 나일 강 엑셀, 구글 시트, AI 및 REST로

Nile은 멀티테넌트 B2B 앱을 위한 PostgreSQL 기반 데이터베이스입니다. 여기서는 모든 테넌트의 데이터를 종합적으로 보고하는데, 이것이 바로 Nile의 주요 목적입니다.

하나의 연결, 모든 표면

나일 데이터가 저장될 수 있는 곳

Query Streams는 Microsoft Excel, Google Sheets, Power BI, MCP를 통한 AI 어시스턴트 및 REST 엔드포인트에서 Nile 데이터를 단일 읽기 전용 연결을 통해 읽어옵니다. Nile은 각 고객에게 개별 데이터베이스를 제공하는 대신 단일 PostgreSQL 데이터베이스 내에 테넌트를 가상화하므로 테넌트 인식 테이블에는 tenant_id 열이 있으며 단일 연결로 모든 테넌트를 볼 수 있습니다. 애플리케이션은 한 번에 하나의 테넌트만 대상으로 하지만, 보고 연결은 그렇지 않으며, 고객 간 분석에는 바로 이러한 동작이 필요합니다.

Nile은 네트워크를 통한 PostgreSQL입니다. — 표준 드라이버이므로 아래의 모든 지침이 변경 없이 적용됩니다. Nile 전용 부분은 연결 문자열뿐이며, 이는 다음에서 다룹니다. 연결 정보.

  1. 귀사 팀, 협력업체 및 파트너 여러분께
  2. 나일에서 엑셀까지 마이크로소프트 엑셀 · 엑셀 추가 기능

    실시간 Nile 결과를 워크시트로 바로 가져오고 필요에 따라 새로 고칠 수 있습니다. 데스크톱 Excel, Excel Online, Microsoft 365에서 사용 가능합니다.

    PostgreSQL 가이드
  3. 나일에서 구글 시트로 스프레드시트 추가 기능

    사이드바에서 저장된 Nile 쿼리를 실행하고 결과를 시트에 드래그 앤 드롭하세요. 공동 작업자는 직접 시트를 새로 고칠 수 있습니다.

    PostgreSQL 가이드
  4. 노바에게 나일강에 대해 물어보세요 Nova AI · 텍스트를 SQL로 변환

    쉬운 영어로 질문하세요. Nova는 이미 사용자의 Nile 테이블을 알고 있으므로 SQL을 작성하고 실행한 다음 답변을 설명하고 차트로 보여줍니다. 쿼리를 작성할 필요도 없고 자격 증명을 제공할 필요도 없습니다.

    Nova는 어떻게 작동하나요?
  5. 나일강에서 데이터 뷰어까지 결과 공유 · 팀, 협력업체, 파트너 · 휴대폰, 태블릿, 데스크톱

    Nile 분석 결과를 동료, 협력업체, 파트너 등 누구와도 북마크 가능한 그리드 형식으로 공유하세요. 휴대폰, 태블릿, 데스크톱 등 어떤 기기에서든 열 때마다 최신 결과가 표시됩니다. 상대방은 결과만 볼 뿐 SQL 쿼리나 자격 증명은 절대 볼 수 없습니다.

    데이터 뷰어 작동 방식
  6. 앱 및 시스템용
  7. 나일 REST API HTTP 엔드포인트

    인증된 JSON 엔드포인트로 Nile 쿼리를 게시하여 모든 애플리케이션에서 호출할 수 있도록 하며, OpenAPI 3.1 사양과 Postman, Insomnia, Hoppscotch 컬렉션을 바로 사용할 수 있도록 지원합니다. 데이터베이스 포트는 열지 않습니다.

    PostgreSQL 가이드
  8. Nile에서 Power BI로 파워 쿼리 M

    생성된 Power Query M을 Power BI 고급 편집기에 붙여넣으면 보고서가 HTTPS를 통해 Nile 결과를 실시간으로 읽어옵니다. ODBC 드라이버도 필요 없고 데이터베이스 포트도 열 필요가 없습니다.

    Power BI 작동 방식
  9. 나일에서 에어테이블까지 자동화 플랫폼

    Nile 행을 예약된 시간에 Airtable 베이스에 동기화하거나 Airtable 자동화 스크립트 내에서 가져올 수 있습니다.

    PostgreSQL 가이드
  10. 나일강에서 바세로까지 자동화 플랫폼

    Nile에서 Baserow 테이블을 REST 엔드포인트를 통해 제공합니다(자체 호스팅 또는 Baserow 클라우드).

    PostgreSQL 가이드
  11. 나일에서 시테이블까지 자동화 플랫폼

    파일을 내보내거나 데이터베이스를 노출하지 않고도 SeaTable 데이터베이스를 Nile 데이터로 최신 상태로 유지하세요.

    PostgreSQL 가이드
  12. 나일강에서 스마트시트까지 자동화 플랫폼

    Nile 결과를 Smartsheet 그리드에 추가하여 계획 및 보고서가 지난주 내보내기가 아닌 원본 시스템에서 읽어오도록 하세요.

    PostgreSQL 가이드
  13. 나일 강에서 앤빌까지 앤빌 웍스 · 앱 플랫폼

    Anvil Python 앱을 Nile로 백업하려면 앱에 데이터베이스 자격 증명을 직접 포함하는 대신 REST 엔드포인트를 사용하면 됩니다.

    PostgreSQL 가이드
  14. AI 도구의 경우
  15. 나일 MCP 서버 Claude, Cursor 및 MCP 고객

    AI 비서에게 올바른 SQL을 작성하는 데 필요한 스키마와 함께 Nile에 대한 읽기 전용 액세스 권한을 부여하세요. 채팅에서 자격 증명을 입력할 필요는 없습니다.

    PostgreSQL 가이드
  16. 사람들에게 전달됨
  17. 나일강 경보 및 보고서 슬랙 · 디스코드 · 이메일 · 웹훅

    Nile 쿼리를 예약 실행하고 결과를 Slack, Discord, 이메일 또는 서명된 웹훅으로 전송하거나, 설정한 행 수, 임계값 또는 백분율 변화 기준치를 초과할 때까지 메시지 전송을 보류할 수 있습니다.

    알림 및 보고서 작동 방식

작동 방식

5단계, 인바운드 방화벽 변경 없음

01

인터넷에 접속할 수 있는 컴퓨터에 네트워크 에이전트를 설치하십시오. 이 에이전트는 하나의 아웃바운드 연결을 열고 수신 대기하지 않으므로 인바운드 방화벽 규칙이 필요하지 않습니다.

02

Nile 콘솔에서 데이터베이스를 열고, 설정 및 연결을 클릭한 다음 PostgreSQL 옵션을 선택합니다.

03

자격 증명이 없으면 생성하세요. Nile은 비밀번호를 한 번만 표시하므로 페이지를 나가기 전에 복사해 두세요.

04

연결 문자열을 첫 번째 필드에 붙여넣으세요. 호스트, 포트, 데이터베이스, 사용자 이름 및 비밀번호는 연결 문자열에서 읽어옵니다.

05

SSL 사용을 켜둔 상태로 테스트하고 저장하세요. 해당 연결을 통해 Microsoft Excel, Google Sheets, Power BI, MCP 또는 REST에서 데이터를 읽어올 수 있습니다.

기능 심층 분석

나일강이 당신에게 주는 것

하나의 데이터베이스, 모든 테넌트, 하나의 쿼리

나일의 모델은 이 커넥터에서 흥미로운 부분이며, 보고 연결의 용도에 대한 인식을 바꿔놓습니다.

  • Nile은 모든 테넌트를 하나의 PostgreSQL 데이터베이스에 저장하고, 각 고객에게 별도의 데이터베이스나 스키마를 제공하는 대신 테넌트 인식 테이블의 tenant_id 열을 사용하여 테넌트를 구분합니다.
  • 애플리케이션은 연결별로 테넌트 컨텍스트를 설정하므로 한 번에 한 명의 고객만 볼 수 있습니다. 반면, 쿼리 스트림 연결은 해당 컨텍스트를 설정하지 않으므로 모든 고객을 한꺼번에 볼 수 있습니다.
  • 이렇게 하면 테넌트 간 보고가 통합 프로젝트가 아닌 단순한 GROUP BY 구문으로 가능해집니다. 고객별 사용량, 요금제별 수익, 이번 달에 로그인하지 않은 계정 등 모든 정보가 하나의 보고서로 제공됩니다.
  • 이는 액세스 제어를 직접 설계할 수 있다는 의미이기도 합니다. 여기에서의 연결은 테넌트에 한정되지 않으므로 고객별 보고서가 필요한 경우 저장된 쿼리에서 tenant_id로 필터링하고 연결 자체가 아닌 해당 쿼리를 공유하세요.
  • 에이전트가 실행하는 모든 작업은 읽기 전용이므로 쿼리 내용과 관계없이 여기서는 테넌트 데이터를 수정할 수 없습니다.
-- 테넌트 간 보고는 일반적인 GROUP BY SELECT t.name AS tenant, COUNT(o.id) AS orders, SUM(o.amount) AS revenue FROM public.tenants AS t JOIN public.orders AS o ON o.tenant_id = t.id WHERE o.placed_at >= now() - interval '30 days' GROUP BY t.name ORDER BY revenue DESC; 와 같습니다.

자격 증명은 한 번만 표시되며, 지역 엔드포인트는 일반적인 PostgreSQL 엔드포인트입니다.

이 설정을 할 때 발생하는 대부분의 상황을 다루는 두 가지 실용적인 참고 사항입니다.

  • Nile은 사용자 이름으로 자격 증명 ID를 생성하고 비밀번호를 한 번만 표시합니다. 자격 증명 ID를 분실한 경우 이전 ID를 복구하려고 하지 말고 새로 생성하십시오.
  • 엔드포인트는 지역별로 다르며 .db.thenile.dev로 끝나고 표준 포트는 5432입니다. 이 경로에는 풀러가 없으며 에이전트는 풀러 관련 설정을 적용하지 않습니다.
  • TLS는 필수이며 에이전트가 Nile 호스트 이름에 대해 이를 강제 적용하므로 SSL 확인란을 선택 해제해도 암호화되지 않은 연결이 생성되지 않습니다. 인증서 체인은 검증되지 않습니다. — 이는 트래픽을 누군가가 읽는 것을 방지하기 위한 보호 장치이지, 어떤 서버가 응답했는지에 대한 증거가 아닙니다.
  • 입력란이 모두 채워지면 붙여넣은 연결 문자열은 삭제되므로 비밀번호는 두 곳이 아닌 한 곳에 저장됩니다.

모든 데이터베이스 커넥터에서 공유됨

모든 데이터베이스 커넥터에 해당되는 사항입니다.

  • 출국 전용 — 에이전트는 쿼리 스트림으로 암호화된 연결을 하나만 엽니다. 포트 포워딩도 필요 없고, VPN도 필요 없고, IP 허용 목록도 필요 없으며, 데이터베이스 정보가 인터넷에 노출되는 것도 없습니다.
  • 자격 증명은 그대로 유지됩니다. — 데이터베이스 사용자 이름과 비밀번호는 에이전트를 설치한 컴퓨터에 있습니다. Query Streams는 이러한 정보를 수신하지 않으며 자체적으로 데이터베이스에 접근할 수 없습니다.
  • 읽기 전용, 강제 적용됨 — 한 번에 하나의 명령문만 사용 가능하며, SELECT 및 관련 명령만 허용됩니다. 쓰기 작업은 서버로 전송되기 전에 사용자 컴퓨터에서 거부되므로, 다른 사용자가 설정해 둔 권한에 의존하지 않습니다.
  • 원하는 만큼 에이전트를 배포하세요 사이트, 지역 또는 클라우드별로 하나씩만 있으면 됩니다. 모든 데이터 소스가 단일 드롭다운 메뉴에 표시되므로 어떤 에이전트가 무엇을 호스팅하는지 알 필요가 없습니다.

쿼리가 저장되면 다음과 같은 결과가 나타납니다.

  • SQL이 아니라 기능을 공유하세요. — 동료나 외부 파트너는 쿼리를 실행하고 해당 쿼리의 바탕이 된 구문을 전혀 보지 않고도 필터를 변경할 수 있습니다.
  • 양방향 필터 — 직접 @variables로 선언하거나, 커넥터가 WHERE 절에 이미 있는 리터럴 값을 감지하여 드롭다운 메뉴로 제공하도록 할 수 있습니다.
  • 어디서든 읽어보세요 — Microsoft Excel, Google Sheets, Power BI, REST API, MCP 기반 AI 비서, 쿼리 빌더 및 Nova는 모두 동일한 저장된 쿼리를 읽습니다.
  • 여러 개를 동시에 실행하세요 — 5개의 저장된 쿼리가 5개의 워크시트 탭에 동시에 스트리밍되며, 결과 크기에 관계없이 실행됩니다.
  • 이미 연결된 다른 항목과 연결하세요. — 다른 데이터베이스, 비즈니스 API 또는 파일 폴더를 하나의 읽기 전용 명령으로 액세스할 수 있습니다.

크로스 소스 SQL

Nile을 나머지 데이터와 연결하세요

하나의 명령문으로 Nile과 다른 연결을 동시에 관리할 수 있습니다. 각 소스는 실행 가능한 부분만 실행하고 결과를 다시 스트리밍하며, 조인은 중앙에서 이루어집니다. 소스들은 서로 통신하지 않으며 어떤 데이터도 복사되지 않습니다.

3개의 연결 · 3명의 에이전트

나일 강 멀티테넌트 포스트그레스
Microsoft SQL Server 관계형 엔진
스트라이프 결제 및 청구

한 가지 진술

-- 아무것도 복사되지 않았고, 아무것도 병합되지 않았으며, 아무것도 예약되지 않았습니다.
선택   c.region, COUNT(*) AS orders, SUM(i.amount_due) AS invoiced
FROM     나일 앱.공공.명령1  f
JOIN     erp_sql.dbo.customers2   c ON c.id = f.customer_id
JOIN     청구.stripe.invoices3 i ON i.customer = c.stripe_id
그룹 기준 c.지역
주문 기준 청구서 발행 DESC;

세 가지 요소는 연결, 스키마, 테이블이며, 연결 이름은 사용자가 지정한 대로 지정할 수 있습니다. 열은 예시일 뿐이며, 테이블은 실제 테이블이어야 합니다. 모든 부분은 읽기 전용으로 적용됩니다. SELECT, WITH, EXPLAIN만 사용할 수 있으며, 단일 쿼리에 대해 특정 소스에서 제공할 수 있는 데이터의 양에는 제한이 있습니다. 연합 쿼리의 작동 방식

연결 정보

나일강에 필요한 것

주인
<region>.db.thenile.dev
포트
5432
운전사
에이전트에 의해 제공되는 Npgsql이므로 Nile 측에서 설치할 필요가 없습니다.
붙여넣기 형식
데이터베이스, 설정, 연결, PostgreSQL의 문자열을 postgres:// URI 형식으로 표시합니다.
사용자 이름
콘솔에서 생성된 자격 증명 ID이며 이메일 주소가 아닙니다.
TLS
Nile 호스트 이름에 필수이며 강제 적용됩니다. 암호화되어 있으며 인증서 체인은 검증되지 않습니다.
풀링
없음. 해당 에이전트는 Nile에 대해 풀러 적응 기능을 적용하지 않습니다.
임차인 범위
테넌트 컨텍스트가 설정되지 않았으므로 연결은 모든 테넌트를 볼 수 있습니다. 필요한 경우 쿼리에서 tenant_id로 필터링하세요.
저장됨
PostgreSQL, Nile을 상징으로 간직함
기본 스키마
연방 참조가 의미하는 바는 바로 '공공'입니다.

Nile은 특히 이 부분에서 Nile이 하지 않는 일 때문에 보고 대상으로서 이해할 가치가 있습니다. Nile을 유용하게 만드는 테넌트 격리는 애플리케이션이 테넌트 컨텍스트를 설정할 때 연결별로 적용됩니다. 테넌트 컨텍스트를 설정하지 않는 보고 연결은 제어를 우회하는 것이 아니라, 전체 환경을 확인해야 하는 운영자를 위해 모델이 의도한 방식대로 데이터베이스를 사용하는 것입니다.

실질적인 결과는 범위 지정 결정이 연결이 아닌 쿼리 자체로 이동한다는 것입니다. 저장된 쿼리에 tenant_id 필터를 추가하고 해당 쿼리를 공유하면 연결 정보를 누구에게도 제공하지 않고 고객별 보기를 제공할 수 있습니다. 이는 Query Streams가 다른 모든 곳에서 사용하는 패턴과 동일합니다. 즉, 무언가를 실행할 수 있는 권한은 공유하되, 그 실행에 필요한 자격 증명은 공유하지 않는 것입니다.

여러 소스를 연결하는 쿼리의 경우 Nile은 일반 PostgreSQL처럼 작동합니다. 사용자가 nile_app이라고 명명한 연결은 nile_app.public.orders로 기록되며, CSV 파일이 있는 폴더, 온프레미스 시스템 기록 장치 또는 청구 API와 하나의 읽기 전용 명령으로 연결됩니다. 이때 아무것도 복사되거나 예약되지 않습니다.

공급업체 문서: www.thenile.dev

자주 묻는 질문

나일강에 관한 질문

쿼리 스트림을 통해 Nile 데이터를 읽을 수 있는 도구는 무엇입니까?

Excel, Google Sheets, MCP, REST API, Airtable, Baserow, SeaTable, Smartsheet, Anvil, Power BI, 예약 알림 및 보고서 등 모든 기능을 하나의 연결로 이용할 수 있습니다. 데이터베이스를 한 번만 연결하면 모든 플랫폼에서 동일한 읽기 전용 연결을 사용하므로, 도구별 설정이나 데이터 복사본 생성이 필요 없습니다.

Nile 데이터베이스에 접근하려면 방화벽 포트를 열어야 하나요?

아니요. Query Streams 네트워크 에이전트는 사용자 네트워크 내부에서 실행되며 암호화된 외부 연결을 하나만 설정합니다. 수신 트래픽을 감시하는 기능은 없으며 VPN도 필요하지 않고 데이터베이스는 기존 방화벽 규칙을 유지합니다.

Query Streams를 사용하면 Nile의 데이터를 변경할 수 있나요?

아니요. 에이전트는 실행 시점에 읽기 전용을 적용합니다. 즉, 한 번에 하나의 문장만 처리하며, SELECT 및 관련 문만 사용 가능합니다. 자격 증명은 에이전트에 저장되며 쿼리 스트림으로 전송되지 않습니다.

Query Streams가 Nile에 연결하려면 무엇이 필요합니까?

접근 가능한 호스트, 역할 및 암호 - 에이전트가 드라이버를 제공하므로 데이터베이스에 아무것도 설치하지 않습니다. 호스트: <region>.db.thenile.dev. 포트: 5432. 드라이버: 에이전트에서 제공하는 Npgsql - Nile 측에 설치할 필요 없음. 붙여넣기 형식: 데이터베이스, 설정, 연결, PostgreSQL의 문자열을 postgres:// URI 형식으로 붙여넣으세요.

동일한 쿼리로 Nile 데이터베이스를 다른 데이터베이스와 조인할 수 있나요?

네, 맞습니다. 연합 쿼리입니다. 하나의 문장으로 Nile과 다른 연결들을 동시에 참조할 수 있으며, 연결 이름은 `connection.schema.table`입니다. 각 소스는 자신이 처리할 수 있는 부분만 실행하고 결과를 다시 스트리밍합니다. 조인은 중앙에서 이루어지므로 소스들이 서로 연결되지 않고, 데이터 복사나 예약 실행도 없습니다. 읽기 전용은 모든 부분(SELECT, WITH, EXPLAIN)에 적용되며, 단일 쿼리에 대해 각 소스가 제공할 수 있는 데이터 양에는 제한이 있습니다. 연합 쿼리는 실행 계획 기능이며, 연합 쿼리 페이지에서 현재 소스와 크기 제한을 확인할 수 있습니다.

Nile 연결 방식과 PostgreSQL 연결 방식은 다른가요?

연결 문자열만 필요합니다. Nile은 PostgreSQL 와이어 프로토콜을 사용하므로 필터, 예약, 공유, Excel 및 Google Sheets 추가 기능, MCP 서버 모두 동일하게 작동합니다. Nile 카드는 공급자가 예상하는 호스트, 포트 및 SSL 설정을 미리 채워 넣습니다.

나일 강 데이터를 엑셀로 변환하는 가이드가 있나요?

네, 맞습니다. 해당 내용은 PostgreSQL 가이드이며, Nile에 맞게 정확하게 작성되었습니다. Nile은 PostgreSQL 와이어 프로토콜을 사용하므로 Nile에서 Excel, Google Sheets 등으로 데이터를 전송할 때 동일한 단계를 따릅니다. Nile에 특화된 부분은 연결 문자열뿐이며, Nile 카드에서 해당 부분을 자동으로 입력해 줍니다.

일이 이루어지는 곳에 나일강을 놓으세요

에이전트를 설치하고, 데이터베이스를 지정한 다음, 설치 위치를 선택하십시오.

읽기 전용 출국 전용 자격 증명은 에이전트에 저장됩니다.