다음을 통해 공유

PostgreSQL

요약

항목 묘사
릴리스 상태 일반 공급
제품 엑셀
Power BI (시맨틱 모델)
Power BI(데이터 흐름)
패브릭(데이터플로우 Gen2)
Power Apps (데이터 흐름)
Dynamics 365 Customer Insights
분석 서비스
지원되는 인증 유형 데이터베이스(사용자 이름/암호)
함수 참조 설명서 PostgreSQL.Database

메모

일부 기능은 한 제품에 있을 수 있지만 배포 일정 및 호스트별 기능으로 인해 다른 기능은 없을 수 있습니다.

필수 구성 요소

Power BI Desktop은 2019년 12월부터 PostgreSQL 커넥터용 Npgsql 공급자를 포함하므로 추가 설치가 필요하지 않습니다. 2024년 10월 버전부터 Npgsql 버전 4.0.17을 통합합니다. 별도로 설치된 Npgsql GAC는 이 기본 설정을 재정의합니다.

PostgreSQL 커넥터는 클라우드 연결 및 VNet 데이터 게이트웨이 또는 온-프레미스 데이터 게이트웨이를 통해 지원됩니다. 2025년 6월 릴리스 이후 온-프레미스 데이터 게이트웨이에는 Npgsql 공급자가 포함되어 있으므로 추가 설치가 필요하지 않습니다. 별도의 Npgsql GAC 설치는 이 기본 버전을 덮어쓰게 됩니다.

2019년 12월 이전에 릴리스된 Power BI Desktop 버전과 2025년 6월 이전에 릴리스된 온-프레미스 데이터 게이트웨이의 경우 PostgreSQL 커넥터를 사용하려면 로컬 컴퓨터에 Npgsql 공급자를 설치해야 합니다. Npgsql 공급자를 설치하려면 버전 4.0.17의 릴리스 페이지 로 이동하여 .msi 파일을 다운로드하여 실행합니다. 공급자 아키텍처(32비트 또는 64비트)는 커넥터를 사용하려는 제품의 아키텍처와 일치해야 합니다. 설치할 때 Npgsql GAC 설치를 선택하여 Npgsql 자체가 컴퓨터에 추가되었는지 확인합니다. .NET 버전 비호환성으로 인해 Npgsql 4.1 이상은 지원되지 않습니다.

GAC 설치가 선택된 Npgsql 설치 프로그램의 스크린샷

지원되는 기능

  • 수입
  • DirectQuery(Power BI 의미 체계 모델)
  • 고급 옵션
    • 명령 시간 제한(분)
    • 고유 SQL 문
    • 관계 열
    • 전체 계층을 사용하여 탐색

파워 쿼리 데스크톱에서 PostgreSQL 데이터베이스에 연결

일치하는 Npgsql 공급자가 설치되면 PostgreSQL 데이터베이스에 연결할 수 있습니다. 연결을 만들려면 다음 단계를 수행합니다.

  1. 커넥터 선택 영역에서 PostgreSQL 데이터베이스 옵션을 선택합니다. 자세한 내용을 보려면 데이터 수집 위치로 이동하세요.

  2. 표시되는 PostgreSQL 데이터베이스 대화 상자에서 서버 및 데이터베이스의 이름을 제공합니다.

    Power BI의 PostgreSQL 연결 작성기의 스크린샷.

  3. 가져오기 또는 DirectQuery 데이터 연결 모드를 선택합니다.

  4. 이 데이터베이스에 처음으로 연결하는 경우 데이터베이스 인증 유형의 사용자 이름 및 암호 상자에 PostgreSQL 자격 증명을 입력합니다. 인증 설정을 적용할 수준을 선택합니다. 그런 다음 연결선택합니다.

    PostgreSQL 사용자 이름 및 암호를 입력하는 인증 대화 상자의 스크린샷.

    인증 방법 사용에 대한 더 많은 정보를 보려면 데이터 원본 인증으로 이동하세요.

  5. 연결이 암호화되지 않은 경우 다음 메시지가 표시됩니다.

    Azure SQL 데이터베이스 암호화 지원 대화 상자의 스크린샷.

    확인을 선택하여 암호화되지 않은 연결을 통해 데이터베이스에 연결하거나 데이터베이스 엔진의 암호화 연결 활성화 지침에 따라 PostgreSQL 데이터베이스에 대한 암호화된 연결을 설정하십시오.

  6. 탐색기에서 원하는 데이터베이스 정보를 선택한 다음 로드를 선택하여 데이터를 로드하거나 데이터 변환을 선택하여 파워 쿼리 편집기에서 데이터를 계속 변환합니다.

    PostgreSQL 데이터베이스의 인사 직원 데이터를 보여 주는 파워 쿼리 데스크톱 탐색기의 스크린샷.

파워 쿼리 Online에서 PostgreSQL 데이터베이스에 연결

연결을 만들려면 다음 단계를 수행합니다.

  1. 커넥터 선택 영역에서 PostgreSQL 데이터베이스 옵션을 선택합니다. 자세한 내용을 보려면 데이터 수집 위치로 이동하세요.

  2. 표시되는 PostgreSQL 데이터베이스 대화 상자에서 서버 및 데이터베이스의 이름을 제공합니다.

    파워 쿼리 Online에서 PostgreSQL 연결 작성기 .

  3. 사용하려는 온-프레미스 데이터 게이트웨이의 이름을 선택합니다.

  4. 기본 인증 종류를 선택하고 사용자 이름 및 암호 상자에 PostgreSQL 자격 증명을 입력합니다.

  5. 연결이 암호화되지 않은 경우 암호화된 연결사용합니다.

  6. 다음 선택하여 데이터베이스에 연결합니다.

  7. 탐색기에서 필요한 데이터를 선택한 다음 데이터 변환을 선택하여 파워 쿼리 편집기에서 데이터를 변환합니다.

고급 옵션을 사용하여 연결

파워 쿼리 데스크톱은 필요한 경우 쿼리에 추가할 수 있는 고급 옵션 집합을 제공합니다.

PostgreSQL 연결 대화 상자에 포함된 고급 옵션의 스크린샷

다음 표에서는 파워 쿼리 데스크톱에서 설정할 수 있는 모든 고급 옵션을 나열합니다.

고급 옵션 묘사
명령 시간 제한(분) 연결이 10분(기본 제한 시간)보다 오래 지속되는 경우 다른 값을 분 단위로 입력하여 연결을 더 오래 열어 둘 수 있습니다. 이 옵션은 파워 쿼리 데스크톱에서만 사용할 수 있습니다.
SQL 문 정보를 확인하려면 네이티브 데이터베이스 쿼리를 사용하여 데이터베이스에서 데이터를 가져오는 방법으로 이동하십시오.
관계 열 포함 선택한 경우 다른 테이블과 관계가 있을 수 있는 열을 포함합니다. 이 상자가 지워지면 해당 열이 표시되지 않습니다.
전체 계층을 사용하여 탐색 이 옵션을 선택하면 탐색기는 연결하려는 데이터베이스에 있는 테이블의 전체 계층 구조를 표시합니다. 삭제되면 네비게이터는 열과 행에 데이터가 있는 테이블만 표시합니다.

필요한 고급 옵션을 선택하면 Power Query Desktop에서 확인을 선택하여 PostgreSQL 데이터베이스에 연결합니다.

네이티브 쿼리 접기

기본적으로 네이티브 쿼리 폴딩은 사용하도록 설정됩니다. 접을 수 있는 작업은 일반 가져오기 또는 직접 쿼리 논리에 따라 네이티브 쿼리 위에 적용됩니다. 네이티브 쿼리 폴딩은 Value.NativeQuery에 있는 선택적 매개 변수에는 적용되지 않습니다.

드문 경우지만 네이티브 쿼리 폴딩이 설정된 상태에서 접기가 작동하지 않을 때는 비활성화할 수 있습니다. 네이티브 쿼리 폴딩을 사용하지 않도록 설정하려면 고급 편집기에서 EnableFolding에 대한 플래그 false 를 설정합니다.

샘플: Value.NativeQuery(target as any, query, null, [EnableFolding=false])

문제 해결

네이티브 쿼리에서 다음 오류가 발생할 수 있습니다.

We cannot fold on top of this native query. Please modify the native query or remove the 'EnableFolding' option.

기본 문제 해결 단계는 Value.NativeQuery의 쿼리가 주변에 limit 1 절을 사용하여 동일한 오류를 발생시키는지 확인하는 것입니다.

select * from (query) _ limit 1