눈송이

요약

지원되는 기능

• 가져오기
• DirectQuery(Power BI 의미 체계 모델)
• 고급 옵션
  • 역할 이름으로 사용할 텍스트 값 지정
  • 관계 열
  • 연결 시간 제한(초)
  • 명령 시간 제한(초)
  • 데이터베이스
  • 고유 SQL 문

파워 쿼리 데스크톱에서 Snowflake 데이터 웨어하우스에 연결

Snowflake 컴퓨팅 웨어하우스에 연결하려면 다음 단계를 수행합니다.

1. Power BI Desktop의 홈 리본에서 데이터 가져오기를 선택하고, 왼쪽의 범주에서 데이터베이스를 선택하고, Snowflake를 선택한 다음, 연결을 선택합니다.

   

2. 표시되는 Snowflake 창에서 서버의 Snowflake 서버 이름과 Warehouse의 Snowflake 컴퓨팅 웨어하우스 이름을 입력합니다.

   

3. 필요에 따라 역할 이름 또는 명령 시간 제한으로 사용할 텍스트 값과 같이 연결 쿼리를 수정하는 데 사용할 고급 옵션에 값을 입력합니다. 추가 정보: 고급 옵션을 사용하여 연결

4. 확인을 선택합니다.

5. Snowflake 컴퓨팅 웨어하우스에 로그인하려면 사용자 이름과 암호를 입력한 다음 연결을 선택합니다.

   

   참고

   특정 Snowflake 서버에 대한 사용자 이름과 암호를 입력하면 Power BI Desktop은 후속 연결 시도에서 동일한 자격 증명을 사용합니다. 파일 > 옵션 및 설정 > 데이터 원본 설정으로 이동하여 해당 자격 증명을 수정할 수 있습니다. 추가 정보: 인증 방법 변경

   Microsoft 계정 옵션을 사용하려면 Snowflake 쪽에서 Snowflake Microsoft Entra ID 통합을 구성해야 합니다. 추가 정보: Snowflake에 대한 Power BI SSO - 시작

6. 탐색기에서 Power BI Desktop에서 가져오고 사용할 하나 이상의 요소를 선택합니다. 그런 다음 로드를 선택하여 Power BI Desktop에서 테이블을 로드하거나 데이터 변환을 선택하여 사용하려는 데이터 집합을 필터링 및 구체화할 수 있는 Power Query 편집기 연 다음, 구체화된 데이터 집합을 Power BI Desktop으로 로드합니다.

   

7. 가져오기를 선택하여 Power BI로 직접 데이터를 가져오거나 DirectQuery를 선택한 다음 확인을 선택합니다. 자세한 정보: Power BI Desktop에서 DirectQuery 사용

   참고

   Microsoft Entra ID SSO(Single Sign-On)는 DirectQuery만 지원합니다.

   

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

연결을 설정하려면 다음 단계를 수행합니다.

1. 커넥터 선택에서 Snowflake 옵션을 선택합니다.

2. 표시되는 Snowflake 대화 상자에서 서버 및 웨어하우스의 이름을 입력합니다.

   

3. 사용하려는 고급 옵션에 값을 입력합니다. UI에 표시되지 않는 고급 옵션이 있는 경우 나중에 파워 쿼리의 고급 편집기 편집할 수 있습니다.

4. 새 연결 선택 또는 만들기, 사용하려는 게이트웨이, 사용자 이름 및 암호를 포함하여 연결 자격 증명을 입력합니다.

5. 데이터베이스에 연결하려면 다음을 선택합니다.

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

   

고급 옵션을 사용하여 연결

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

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

필요한 고급 옵션을 선택한 후, 파워 쿼리 데스크톱에서는 확인을, 파워 쿼리 온라인에서는 다음을 선택하여 Snowflake 데이터베이스에 연결합니다.

Snowflake 커넥터 구현 2.0

2025년 1월에 Snowflake 커넥터에 대한 새로운 구현을 도입하여 Snowflake와의 통합을 개선했습니다. 이 커넥터는 2025년 7월부터 일반 공급됩니다. 최신 기능을 활용하려면 Power BI Desktop 및 온-프레미스 데이터 게이트웨이를 최신 버전으로 업그레이드하는 것이 좋습니다. 커넥터를 계속 개선하는 데 도움이 되는 피드백을 제공합니다.

Snowflake 커넥터 구현 2.0은 오픈 소스 ADBC( Arrow Database Connectivity ) 드라이버를 사용하여 빌드됩니다. ADBC는 화살표 데이터와 상호 작용하기 위한 표준 인터페이스 집합을 제공하며, 특히 오버헤드가 최소화되고 serialization 또는 복사가 없는 큰 데이터 세트를 가져오는 데 특히 효율적입니다. 또한 ADBC 드라이버는 메모리 안전성 및 가비지 수집과 같은 보안 향상 기능을 통합합니다. 또한 오픈 소스 커뮤니티와의 협업을 통해 최신 도구와 SDL(보안 개발 수명 주기) 프로세스를 활용하여 더 빠른 업데이트를 수행할 수 있습니다.

이러한 성능 및 보안 향상 기능을 활용할 수 있도록 2025년 7월부터 Desktop에서 새로 만든 모든 연결은 자동으로 2.0 구현을 사용합니다. 기존 쿼리를 업데이트하고 다음과 같이 Implementation="2.0" 플래그를 추가하여 2.0 구현을 Snowflake.Databases 테스트할 수도 있습니다.

Source = Snowflake.Databases("contoso.snowflakecomputing.com", "CONTOSO_WH", [Implementation="2.0"])

잠재적인 문제를 진단하는 데 도움이 되도록 Implementation 및 DriverType 세부 정보를 다음 예제처럼 매시업 로그에서 찾을 수 있습니다. 전환 중에 문제가 발생하면 지원에 문의하세요. 한편, 자체 완화를 위해 문제를 해결하기 전에 비즈니스 중단을 방지하기 위해 ODBC 커넥터를 계속 사용하도록 제거할 Implementation="2.0" 수 있습니다.

{"Start":"2024-11-02T00:14:02.7968686Z","Action":"Engine/Module/Snowflake/IO/Snowflake/Implementation","ResourceKind":"Snowflake","ResourcePath":"powerbi.snowflakecomputing.com ;DEMO_WH","HostProcessId":"29200","Implementation":"2.0","DriverType":"ADBC","ProductVersion":"2.139.0.0 (Main)+eda56ecd858054173a4d11db9c63a6da5cf92a99","ActivityId":"106f16b6-cfbb-4853-9f20-ed45486486d2","Process":"Microsoft.Mashup.Container.NetFX45","Pid":38560,"Tid":1,"Duration":"00:00:00.0000291"}

다음 옵션은 2025년 7월 릴리스 이후 사용할 수 있습니다.

• UseHighPrecision: Snowflake NUMBER(38,0) 필드의 정밀도를 제어합니다. 값이 지정되지 않은 경우 커넥터는 SHOW PARAMETERS LIKE 'ODBC_TREAT_DECIMAL_AS_INT' 쿼리를 사용하여 Snowflake를 쿼리합니다. 값이 설정되지 않은 경우 커넥터는 열에 지정된 배율을 사용합니다. 값은 true NUMBER(38,0)를 10진수 유형으로 간주합니다. 이 값 false 은 NUMBER(38,0)를 Int64 형식으로 처리합니다. 눈금이 0보다 큰 경우 열은 Double 형식으로 간주됩니다.
• DateTimePrecision: Snowflake 타임스탬프 값의 처리 정확도를 제어합니다. Snowflake는 일반적으로 타임스탬프 값을 나노초 정밀도로 저장합니다. Snowflake에 따르면 ADBC에서는 1677 이전 또는 2262년 이후 날짜에 대한 오버플로 예외가 발생할 수 있습니다. 이 옵션의 유효한 값은 nullnanoseconds 또는 microseconds. null 값은 기본적으로 사용됩니다nanoseconds. 1677 이전 또는 2262 이후 날짜가 필요한 사용자는 이 설정을 사용하는 microseconds 것이 좋습니다. 사용자가 1677년 이전 또는 2262년 이후에 1,000만 위까지 정밀도를 유지해야 하는 경우 ODBC 드라이버와 함께 유지하는 것이 좋습니다.

프록시를 사용하여 Snowflake에 연결해야 하는 경우 프록시 설정 지침을 참조하세요. 드라이버는 프록시 설정에 환경 변수를 사용합니다.

다음은 이전 버전에서 릴리스된 커넥터 개선 사항에 대한 요약입니다.

문제 해결

오류: SQL 컴파일 오류: 개체가 없거나 작업을 수행할 수 없습니다.

시스템에서 지정된 개체를 찾을 수 없을 때 오류가 발생합니다. 이 오류는 사용자가 잘못된 데이터베이스 이름을 기본 데이터베이스로 설정했기 때문입니다.

속성 DEFAULT_NAMESPACE 유효한 기본 데이터베이스 이름이 사용되는지 확인합니다. DESC USERusername

기본 데이터베이스 이름을 업데이트하려면 : alter userusername set DEFAULT_NAMESPACE=<database name>.<schema name>. 자세한 내용은 Snowflake 설명서를 참조하세요. https://docs.snowflake.com/en/sql-reference/sql/alter-user

제한 사항 및 알려진 문제

Snowflake 커넥터 구현 2.0의 알려진 문제

현재 Snowflake 커넥터 구현 2.0 에는 다음과 같은 알려진 문제가 있습니다. 수정을 위한 작업이 진행 중이며 수정 사항이 릴리스되면 설명서가 업데이트됩니다.

• 논리가 있는 Snowflake 쿼리는 count distinct 잘못된 결과를 반환합니다.
• 관계를 만들 때 오류가 발생합니다 Object reference not set to an instance of an object. 팝업 창을 취소한 후에도 관계를 정의할 수 있습니다.
• 메모리 사용이 증가했습니다. 전체 로드 시간은 일반적으로 사용 Implementation="2.0"속도가 빠르지만 메모리 사용량도 더 높을 수 있으며 경우에 따라 다음과 같은 문제가 발생할 수 있습니다. Resource Governing: This operation was canceled because there wasn't enough memory to finish running it. Either reduce the memory footprint of your dataset by doing things such as limiting the amount of imported data, or if using Power BI Premium, increase the memory of the Premium capacity where this dataset is hosted.

해결된 문제

데이터베이스 이름의 하이픈

데이터베이스 이름에 하이픈이 있으면 ODBC: ERROR[42000] SQL compilation error을(를) 만날 수 있습니다. 이 문제는 2024년 9월 릴리스에서 해결되었습니다.

부울 형식의 데이터 슬라이서 시각화

2024년 6월 릴리스에서는 부울 데이터 형식의 슬라이서 시각적 개체가 예상대로 작동하지 않습니다. 이 비기능성은 알려진 문제입니다. 임시 솔루션으로 사용자는 전송 - 데이터 형식 ->> 텍스트로 이동하여 보고서의 부울 데이터 형식을 텍스트로 변환할 수 있습니다. 수정 사항은 2024년 10월 릴리스에서 제공됩니다.

Implementation="2.0"으로 표시되지 않는 뷰

Power BI Desktop 2025년 3월 릴리스의 일부 버전에서는 Snowflake 커넥터 구현 2.0 (Implementation="2.0")을 사용할 때 보기가 표시되지 않는 문제가 발생할 수 있습니다. 이 문제는 Power BI Desktop의 2025년 3월 최신 릴리스 이후 해결되었습니다. 설치를 업그레이드하여 다시 시도합니다.

TIMESTAMP_NTZ 값은 Implementation="2.0"이 있는 UTC입니다.

TIMESTAMP_LTZ 형식은 현지 표준 시간대로 변환되지 않지만 Snowflake 커넥터 구현 2.0 (Implementation="2.0")을 사용할 때 UTC 값을 반환합니다. 예를 들어 Snowflake에서 수행 SELECT CURRENT_TIMESTAMP 하면 사용자의 현지 표준 시간대가 아닌 UTC 시간이 반환됩니다. 이 문제는 2025년 7월 릴리스에서 해결됩니다.

Implementation="2.0"을 사용할 때 인덱스가 배열 범위를 벗어났습니다.

일부 시나리오에서는 Index was outside the bounds of the array()을 사용할 때, Implementation="2.0" 오류가 발생합니다. 이 문제는 2025년 6월 릴리스에서 해결됩니다.

추가 정보

• Power BI 서비스에서 Snowflake에 연결