Snowflake

Summary

Item Description
Udgivelsestilstand Generel tilgængelighed
Products Power BI (Semantiske modeller)
Power BI (Dataflows)
Fabric (Dataflow Gen2)
Power Apps (Dataflows)
Understøttede autentificeringstyper Snowflake (brugernavn/adgangskode), Microsoft-konto (Microsoft Entra ID), Key Pair Auth (ADBC), Service Principal (SPN)
Dokumentation til funktionsreference

Note

Adgangsfrasen-indtastningsfeltet vises automatisk kun om nødvendigt, baseret på typen af certifikat, der uploades. Når brugeren har overført et certifikat, registrerer systemet, om det er krypteret eller ukrypteret, og viser adgangssætningsdialogen betinget. Både krypterede og ukrypterede nøgler understøttes.

Note

Nogle funktioner kan være til stede i ét produkt, men ikke andre på grund af installationsplaner og værtsspecifikke egenskaber.

Understøttede funktioner

  • Import
  • DirectQuery (Power BI semantiske modeller)
  • Avancerede indstillinger
    • Angiv en tekstværdi, der skal bruges som rollenavn
    • Kolonner med relationer
    • Timeout for forbindelse i sekunder
    • Timeout for kommando i sekunder
    • Database
    • Oprindelig SQL-sætning

Understøttede godkendelsestyper

Note

  • Brugernavn/adgangskode-autentificeringstilstand vil blive afskaffet. Læs mere her. Mere information kan findes under Forbindelse på vores Fabric køreplan.

  • Key Pair Auth understøttes ikke for Dataflows Gen1.

Snowflake-forbindelsen understøtter følgende autentificeringsmetoder:

  • Microsoft Entra ID (anbefalet): Muliggør stærk, identitetsbaseret autentificering uden at gemme brugernavne eller adgangskoder.

    • I Microsoft Fabric kan denne autentificeringsmetode understøttes af arbejdsområdeidentitet i understøttede oplevelser (såsom Datasets og Dataflows Gen2), hvilket gør det muligt for Fabric at autentificere til Snowflake ved hjælp af arbejdsområdets administrerede identitet.
  • Workspace Identity: En administreret identitet tilknyttet et Microsoft Fabric-arbejdsområde. Når du autentificerer med Microsoft Entra ID, kan understøttede Fabric-oplevelser (såsom Datasets og Dataflows Gen2) bruge arbejdsområdets identitet til at autentificere til Snowflake. Denne metode tillader Fabric at få adgang til Snowflake ved hjælp af en identitet knyttet til arbejdsområdet i stedet for individuelle brugeroplysninger.

  • Nøgleparautentificering (ADBC): Certifikatbaseret autentificering for understøttede scenarier.

  • Service Principal (SPN): Service principals understøttes med Snowflake i situationer, hvor en ikke-bruger, applikationsniveau identitet er nødvendig. Understøttelsen afhænger af Snowflake-konfigurationen og den anvendte autentificeringsmetode.

Forbind til Snowflake data warehouse fra Power Query Desktop

Note

Alle nye forbindelser bruger som standard Snowflake-connector-implementering 2.0 .

Vi anbefaler, at du opdaterer alle forbindelser oprettet før marts 2025 til denne nye implementering.

Hvis du vil oprette forbindelse til et Snowflake-databehandlingslager , skal du gøre følgende:

  1. Vælg Get Data fra båndet Home i Power BI Desktop, vælg Database fra kategorierne til venstre, vælg Snowflake, og vælg derefter Connect.

    Skærmbillede af hent data-dialogen, der viser Snowflake-databasevalget.

  2. I vinduet Snowflake , der vises, skal du indtaste navnet på din Snowflake-server i Server og navnet på dit Snowflake-databehandlingslager i Warehouse.

    Skærmbillede af Snowflake-dialogen, hvor Import-radioknappen er valgt.

  3. Du kan også angive værdier i de avancerede indstillinger, du vil bruge til at ændre forbindelsesforespørgslen, f.eks. en tekstværdi, der skal bruges som et rollenavn eller en kommandotimeout. Du kan få flere oplysninger ved at gå til Opret forbindelse ved hjælp af avancerede indstillinger.

  4. Vælg OK.

  5. Hvis du vil logge på dit Snowflake computing-lagersted, skal du angive dit brugernavn og din adgangskode og derefter vælge Opret forbindelse.

    Skærmbillede af Snowflake-legitimationsprompten, der viser felterne Brugernavn og Adgangskode.

    Note

    Når du indtaster dit brugernavn og adgangskode til en bestemt Snowflake server, bruger Power BI Desktop de samme oplysninger ved efterfølgende forbindelsesforsøg. Du kan ændre disse legitimationsoplysninger ved at gå til Filindstillinger >> Indstillinger Indstillinger for datakilde. For mere information, gå til Ændr autentificeringsmetoden.

    Hvis du vil bruge Microsoft account-muligheden, skal Snowflake Microsoft Entra ID-integrationen konfigureres på Snowflake-siden. For mere information, gå til Power BI SSO to Snowflake - Getting Started.

  6. I Navigator skal du vælge et eller flere elementer, der skal importeres og bruges i Power BI Desktop. Vælg derefter enten Load for at indlæse tabellen i Power BI Desktop, eller Transform Data for at åbne Power Query-editoren, hvor du kan filtrere og forfine det datasæt, du vil bruge, og indlæs derefter det forfinede datasæt i Power BI Desktop.

    Skærmbillede af Navigator, hvor testskemadatabasen er åben, og tabellen DimProduct er valgt.

  7. Vælg Import for at importere data direkte til Power BI, eller vælg DirectQuery, og vælg derefter OK. For mere information, gå til Brug DirectQuery i Power BI Desktop.

    Note

    Microsoft Entra ID single sign-on (SSO) understøtter kun DirectQuery.

    Skærmbillede af Forbindelsesindstillinger, som indeholder valgmulighederne Import og DirectQuery.

Forbind til en Snowflake-database fra Power Query Online

Hvis du vil oprette forbindelse, skal du benytte følgende fremgangsmåde:

  1. Vælg indstillingen Snefnug i connectorvalget.

  2. I dialogboksen Snefnug , der vises, skal du angive navnet på serveren og lagerstedet.

    Skærmbillede af Snowflake-forbindelsesgeneratoren i Power Query Online.

  3. Angiv værdier i de avancerede indstillinger, du vil bruge. Hvis der er avancerede indstillinger, der ikke er repræsenteret i brugerfladen, kan du redigere dem i Advanced Editor i Power Query senere.

  4. Angiv dine legitimationsoplysninger for forbindelsen, herunder valg eller oprettelse af en ny forbindelse, hvilken gateway du vil bruge, samt et brugernavn og en adgangskode.

  5. Vælg Næste for at oprette forbindelse til databasen.

  6. I Navigator vælger du de data, du har brug for, og vælg derefter Transformér data for at transformere dataene i Power Query Editor.

    Skærmbillede af online navigatoren, hvor testskemadatabasen er åben, og tabellen DimProduct er valgt.

Opret forbindelse ved hjælp af avancerede indstillinger

Power Query tilbyder et sæt avancerede muligheder, som du kan tilføje til din forespørgsel, hvis det er nødvendigt.

Følgende tabel viser alle de avancerede indstillinger, du kan sætte i Power Query.

Avanceret mulighed Description
Rollenavn Angiver den rolle, som rapporten bruger via driveren. Denne rolle skal være tilgængelig for brugeren. Ellers er der ikke fastsat nogen rolle.
Inkluder relationskolonner Hvis afkrydsningsfeltet er markeret, medtages kolonner, der kan have relationer til andre tabeller. Hvis dette afkrydsningsfelt ikke er markeret, kan du ikke se disse kolonner.
Timeout for forbindelse i sekunder Angiver, hvor længe der skal ventes på et svar, når der interageres med Snowflake-tjenesten, før der returneres en fejl. Standard er 0 (ingen timeout).
Timeout for kommando i sekunder Angiver, hvor længe der skal ventes på, at en forespørgsel fuldføres, før der returneres en fejl. Standard er 0 (ingen timeout).
Database Angiver en bestemt database på lageret. Denne mulighed er kun tilgængelig i Power Query Desktop.
SQL-sætning Du kan få flere oplysninger ved at gå til Importér data fra en database ved hjælp af oprindelig databaseforespørgsel. Denne mulighed er kun tilgængelig i Power Query Desktop.

Når du har valgt de avancerede indstillinger, du har brug for, skal du vælge OK i Power Query Desktop eller Next i Power Query Online for at forbinde til din Snowflake-database.

Implementering af Snowflake-connector 2.0

I januar 2025 introducerede vi en ny implementering af Snowflake-connectoren for at forbedre integrationen med Snowflake. Denne forbindelse har generelt været tilgængelig siden juli 2025. Vi anbefaler, at du opgraderer Power BI Desktop og den lokale datagateway til den nyeste version for at få de nyeste funktioner. Giv os feedback for at hjælpe os med at fortsætte med at forbedre connectoren.

Snowflake-connectorimplementering 2.0 er bygget ved hjælp af ADBC-driveren ( Arrow Database Connectivity med åben kildekode). ADBC indeholder et sæt standardgrænseflader til interaktion med piledata, hvilket især er effektivt til hentning af store datasæt med minimale omkostninger og ingen serialisering eller kopiering. ADBC-driveren indeholder også sikkerhedsforbedringer, såsom hukommelsessikkerhed og affaldsindsamling. Derudover muliggør samarbejde med community'et med åben kildekode hurtigere opdateringer ved hjælp af moderne værktøjer og sikre SDL-processer (Development Lifecycle).

For at gøre det muligt for dig at drage fordel af disse forbedringer af ydeevnen og sikkerheden bruger alle nyoprettede forbindelser i Desktop automatisk 2.0-implementeringen fra juli 2025. Du kan også teste 2.0-implementeringen ved at opdatere dine eksisterende forespørgsler og tilføje flaget Implementation="2.0"Snowflake.Databases på følgende måde.

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

For at hjælpe med at diagnosticere eventuelle problemer kan du finde detaljerne Implementation og DriverType i dine Miks-logge som følgende eksempel. Hvis du støder på et problem under overgangen, skal du kontakte support. I mellemtiden kan du fjerne Implementation="2.0" for at fortsætte med at bruge ODBC-connectoren for at undgå forretningsafbrydelse, før problemet er løst. Men hvis du bruger Key Pair-autentificering, bruges ADBC-driveren altid uanset denne indstilling.

{
   "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"
}

Følgende muligheder er tilgængelige siden juli 2025-udgivelsen:

  • UseHighPrecision: Styrer præcisionen af, hvordan Snowflake NUMBER(38,0) felter skal håndteres. Hvis der ikke er angivet en værdi, forespørger connectoren Snowflake ved hjælp af forespørgslen SHOW PARAMETERS LIKE 'ODBC_TREAT_DECIMAL_AS_INT' . Hvis der ikke er angivet nogen værdi, bruger connectoren den skala, der er angivet af kolonnen. En true værdi behandler NUMBER(38,0) som decimaltype. Værdien false behandler NUMBER(38,0) som en Int64-type. Hvis skalaen er højere end 0, betragtes kolonnen som en dobbelttype.
  • DateTimePrecision: Styrer nøjagtigheden af, hvordan Snowflake Timestamp-værdier behandles. Snowflake gemmer typisk tidsstempelværdier med præcision i nanosekunder. I ADBC kan denne præcision forårsage en overløbsundtagelse for datoer før 1677 eller efter 2262, ifølge Snowflake. Gyldige værdier for denne mulighed er null, nanoseconds, eller microseconds. En null-værdi bruges nanoseconds som standard. Vi anbefaler, at brugere, der har brug for datoer før 1677 eller efter 2262, bruger indstillingen microseconds . Hvis brugere har brug for at bevare præcisionen til den tiende millionte plads før 1677 eller efter 2262, anbefaler vi at blive hos ODBC-driveren.

Hvis du har brug for at bruge proxy til at oprette forbindelse til Snowflake, skal du se instruktionen for proxyindstilling. Driveren bruger miljøvariabler til proxyindstillingerne.

Følgende tabel indeholder et overblik over de stikforbedringer, der er udgivet i tidligere versioner:

Release Forbedring af stik
Juli 2025 • Booleske kolonner returnerer booleske typer, hvilket løser problemet, hvor booleske kolonner blev behandlet som strengtyper i et tomt postsætskema (inklusive metadata).
• Ny indstilling til at sætte maksimal tidsstempelpræcision til mikrosekunder.
• Forbedret varighedsstøtte.
• Tilføjet understøttelse af navigationsegenskaber til ADBC.
• Forbedret sporing i ADBC-driveren, hvor "ActivityId" nu kan spores gennem driverlaget.
april 2025 • Tilføjet understøttelse af Snowflake-forespørgselstag. Som eksempel: {"PowerQuery":true,"Host":"PBI_SemanticModel_MWC","HostContext":"PowerBIPremium-DirectQuery"}
Marts 2025 • Forbedret ydeevne ved hentning af data fra Snowflake.
• Aktiveret som standard i Power BI Desktop, så de nyoprettede forbindelser automatisk bruger den nye connector-implementering.
• Løste problemet med visninger ikke synlige siden den seneste marts-udgivelse.
Februar 2025 • Forbedret ydeevne ved at reducere antallet af metadata-kald.
• Problemet med dublerede værdier for store resultatmængder løste.

Note

Når du bruger datagatewayen i det lokale miljø, skal du være opmærksom på, at den minimale understøttede version er januar 2025. Vi anbefaler, at du bruger den nyeste version med de nyeste funktioner.

Note

Denne funktion understøttes i 64-bit versionen af Power BI Desktop og virker ikke i 32-bit versionen.

Troubleshooting

Fejl: SQL-kompileringsfejl: Objektet findes ikke, eller handlingen kan ikke udføres

Fejlen opstår, når systemet ikke kan finde det angivne objekt. Denne fejl skyldes ofte, at brugeren har angivet et ugyldigt databasenavn som standarddatabase.

Kontrollér, at der bruges et gyldigt standarddatabasenavn til egenskaben DEFAULT_NAMESPACE: DESC USERusername

Sådan opdaterer du standarddatabasenavnet: alter userusername set DEFAULT_NAMESPACE=<database name>.<schema name>. For mere information, gå til Snowflake-dokumentationen.

Begrænsninger og overvejelser

Kendte problemer i Snowflake-connectorimplementering 2.0

I øjeblikket har implementeringen af Snowflake-connectoren 2.0 følgende kendte problemer. Der arbejdes løbende på at løse problemet, og dokumentationen opdateres, når der udgives en rettelse.

  • Snowflake-forespørgsel med count distinct logik returnerer et forkert resultat.
  • Øget hukommelsesforbrug. Den samlede indlæsningstid er typisk hurtigere med Implementation="2.0", men hukommelsesforbruget kan også være højere, hvilket i nogle tilfælde kan forårsage problemer som 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.

Løste problemer

Bindestreger i databasenavne

Hvis et databasenavn indeholder en bindestreg, kan du støde på en ODBC: ERROR[42000] SQL compilation error. Dette problem er løst i versionen fra september 2024.

Udsnitsvisualisering for boolesk datatype

Udsnitsvisualiseringen for den booleske datatype fungerer ikke som forventet i udgivelsen i juni 2024. Denne ikke-funktionsbaserede funktion er et kendt problem. Som en midlertidig løsning kan brugerne konvertere den booleske datatype i deres rapporter til tekst ved at navigere til: Overførsel –> Datatype –> Tekst. Der findes en rettelse i versionen fra oktober 2024.

Visninger, der ikke er synlige med Implementation="2.0"

I en eller anden version af marts 2025-udgivelsen af Power BI Desktop kan du opleve et problem, hvor visninger ikke er synlige, når du bruger Snowflake-connector-implementeringen 2.0 (Implementation="2.0"). Dette problem er løst siden den seneste marts 2025-udgivelse af Power BI Desktop. For at prøve igen, opgrader din installation.