Delen via


sneeuwvlok

Samenvatting

Artikel Beschrijving
Status van de release Algemene beschikbaarheid
Producten Power BI (Semantische modellen)
Power BI (gegevensstromen)
Fabric (Dataflow Gen2)
Power Apps (gegevensstromen)
Ondersteunde verificatietypen Snowflake (gebruikersnaam/wachtwoord), Microsoft-account (Microsoft Entra-id), verificatie van sleutelpaar
Documentatie voor functiereferenties

Notitie

De Implementatie van de Snowflake-connector 2.0 is algemeen beschikbaar sinds juli 2025. Meer informatie over deze functie .

Notitie

Het invoerveld voor de wachtwoordzin wordt automatisch alleen weergegeven als dat nodig is, op basis van het type certificaat dat is geüpload. Nadat de gebruiker een certificaat heeft geüpload, detecteert het systeem of het is versleuteld of niet-versleuteld en geeft het dialoogvenster wachtwoordzin voorwaardelijk weer. Zowel versleutelde als niet-versleutelde sleutels worden ondersteund.

Notitie

Sommige mogelijkheden zijn mogelijk aanwezig in één product, maar niet in andere vanwege implementatieschema's en hostspecifieke mogelijkheden.

Notitie

De verificatiemodus voor gebruikersnaam en wachtwoord wordt afgeschaft door Snowflake ( lees hier meer). Meer informatie vindt u onder Connectiviteit in onze Fabric-roadmap.

Ondersteunde mogelijkheden

  • Importeren
  • DirectQuery (semantische Power BI-modellen)
  • Geavanceerde opties
    • Geef een tekstwaarde op die moet worden gebruikt als rolnaam
    • Relatiekolommen
    • Verbindingstime-out in seconden
    • Tijdslimiet voor opdracht in seconden
    • Gegevensbank
    • Systeemeigen SQL-verklaring

Verbinding maken met Snowflake-datawarehouse vanuit Power Query Desktop

Notitie

Sinds de versie van maart 2025 van Power BI Desktop is de implementatie van de Snowflake-connector 2.0 standaard ingeschakeld.

Voer de volgende stappen uit om verbinding te maken met een Snowflake-computingwarehouse :

  1. Selecteer Gegevens ophalen van het Start-lint in Power BI Desktop, selecteer Database uit de categorieën aan de linkerkant, selecteer Snowflake en selecteer vervolgens Verbinding maken.

    Schermopname van het dialoogvenster Gegevens ophalen, met de selectie van de Snowflake-database.

  2. Voer in het venster Snowflake dat wordt weergegeven de naam in van uw Snowflake-server in Server en de naam van uw Snowflake-computingwarehouse in Warehouse.

    Schermopname van het dialoogvenster Snowflake met het keuzerondje Importeren geselecteerd.

  3. U kunt desgewenst waarden invoeren in alle geavanceerde opties die u wilt gebruiken om de verbindingsquery te wijzigen, zoals een tekstwaarde die moet worden gebruikt als rolnaam of een time-out van een opdracht. Ga voor meer informatie naar Verbinding maken met behulp van geavanceerde opties.

  4. Selecteer OK.

  5. Als u zich wilt aanmelden bij uw Snowflake Computing-magazijn, voert u uw gebruikersnaam en wachtwoord in en selecteert u Verbinding maken.

    Schermopname van de referentieprompt snowflake, met de velden Gebruikersnaam en Wachtwoord.

    Notitie

    Zodra u uw gebruikersnaam en wachtwoord voor een bepaalde Snowflake-server hebt ingevoerd, gebruikt Power BI Desktop dezelfde referenties in volgende verbindingspogingen. U kunt deze referenties wijzigen door naar Instellingen > voor bestandsopties en > instellingen voor gegevensbron te gaan. Ga naar De verificatiemethode wijzigen voor meer informatie.

    Als u de optie Microsoft-account wilt gebruiken, moet de Integratie van Snowflake Microsoft Entra ID aan de zijde van Snowflake worden geconfigureerd. Ga voor meer informatie naar Power BI SSO naar Snowflake - Aan de slag.

  6. Selecteer in Navigator een of meer elementen die u wilt importeren en gebruiken in Power BI Desktop. Selecteer vervolgens Laden om de tabel in Power BI Desktop te laden of Gegevens transformeren om de Power Query-editor te openen, waar u de set gegevens die u wilt gebruiken kunt filteren en verfijnen en vervolgens die verfijnde set gegevens in Power BI Desktop kunt laden.

    Schermopname van navigator met de testschemadatabase geopend en de tabel DimProduct geselecteerd.

  7. Selecteer Importeren om gegevens rechtstreeks in Power BI te importeren of selecteer DirectQuery en selecteer VERVOLGENS OK. Ga naar DirectQuery gebruiken in Power BI Desktop voor meer informatie.

    Notitie

    Eenmalige aanmelding van Microsoft Entra ID ondersteunt alleen DirectQuery.

    Schermopname van de verbindingsinstellingen, die de selecties Importeren en DirectQuery bevatten.

Verbinding maken met een Snowflake-database vanuit Power Query Online

Voer de volgende stappen uit om de verbinding te maken:

  1. Selecteer de optie Snowflake in de verbindingslijnselectie.

  2. Voer in het dialoogvenster Snowflake dat wordt weergegeven de naam van de server en het magazijn in.

    Schermopname van de opbouwfunctie voor Snowflake-verbindingen in Power Query Online.

  3. Voer waarden in de geavanceerde opties in die u wilt gebruiken. Als er geavanceerde opties niet worden weergegeven in de gebruikersinterface, kunt u deze later bewerken in de Geavanceerde editor in Power Query.

  4. Voer uw verbindingsreferenties in, inclusief het selecteren of maken van een nieuwe verbinding, welke gateway u wilt gebruiken en een gebruikersnaam en wachtwoord.

  5. Selecteer Volgende om verbinding te maken met de database.

  6. Selecteer in Navigator de gegevens die u nodig hebt en selecteer vervolgens Gegevens transformeren om de gegevens in Power Query-editor te transformeren.

    Schermopname van de online Navigator met de testschemadatabase geopend en de tabel DimProduct geselecteerd.

Verbinding maken met behulp van geavanceerde opties

Power Query biedt een set geavanceerde opties die u indien nodig aan uw query kunt toevoegen.

De volgende tabel bevat alle geavanceerde opties die u in Power Query kunt instellen.

Geavanceerde optie Beschrijving
Rolnaam Hiermee geeft u de rol op die het rapport via het stuurprogramma gebruikt. Deze rol moet beschikbaar zijn voor de gebruiker. Anders is er geen rol ingesteld.
Relatiekolommen opnemen Indien aangevinkt, bevat het kolommen die mogelijk relaties hebben met andere tabellen. Als dit vak is uitgeschakeld, ziet u deze kolommen niet.
Verbindingstime-out in seconden Hiermee geeft u op hoe lang moet worden gewacht op een reactie bij interactie met de Snowflake-service voordat er een fout wordt geretourneerd. De standaardwaarde is 0 (geen time-out).
Tijdslimiet voor opdracht in seconden Hiermee geeft u op hoe lang moet worden gewacht totdat een query is voltooid voordat een fout wordt geretourneerd. De standaardwaarde is 0 (geen time-out).
Gegevensbank Specificeert een specifieke database in het datawarehouse. Deze optie is alleen beschikbaar in Power Query Desktop.
SQL-verklaring Ga voor informatie naar Gegevens importeren uit een database met behulp van een systeemeigen databasequery. Deze optie is alleen beschikbaar in Power Query Desktop.

Zodra u de geavanceerde opties hebt geselecteerd die u nodig hebt, selecteert u OK in Power Query Desktop of Volgende in Power Query Online om verbinding te maken met uw Snowflake-database.

Implementatie van Snowflake-connector 2.0

In januari 2025 hebben we een nieuwe implementatie geïntroduceerd voor de Snowflake-connector om de integratie met Snowflake te verbeteren. Deze connector is algemeen beschikbaar sinds juli 2025. U wordt aangeraden Power BI Desktop en de on-premises gegevensgateway te upgraden naar de nieuwste versie om te profiteren van de meest recente mogelijkheden. Geef ons feedback om ons te helpen de connector te blijven verbeteren.

De Implementatie van de Snowflake-connector 2.0 wordt gebouwd met behulp van het OPENSOURCE Arrow Database Connectivity-stuurprogramma (ADBC). ADBC biedt een set standaardinterfaces voor interactie met pijlgegevens. Dit is met name efficiënt bij het ophalen van grote gegevenssets met minimale overhead en geen serialisatie of kopiëren. Het ADBC-stuurprogramma bevat ook beveiligingsverbeteringen, zoals geheugenveiligheid en afvalverzameling. Daarnaast maakt samenwerking met de opensource-community snellere updates mogelijk, waarbij gebruik wordt gemaakt van moderne hulpprogramma's en SDL-processen (Secure Development Lifecycle).

Om u in staat te stellen gebruik te maken van deze prestatie- en beveiligingsverbeteringen, vanaf juli 2025, gebruiken alle zojuist gemaakte verbindingen in Desktop automatisch de 2.0-implementatie. U kunt ook de 2.0-implementatie testen door uw bestaande query's bij te werken en de Implementation="2.0" vlag Snowflake.Databases als volgt toe te voegen.

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

Om te helpen bij het diagnosticeren van mogelijke problemen, vindt u de Implementation en DriverType details in uw Mashup-logboeken, zoals in het volgende voorbeeld. Neem contact op met ondersteuning als er een probleem optreedt tijdens de overgang. Ondertussen kunt u, om zelf te beperken, verwijderen Implementation="2.0" om de ODBC-connector te blijven gebruiken om bedrijfsonderbreking te voorkomen voordat het probleem wordt opgelost.

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

De volgende opties zijn beschikbaar sinds de release van juli 2025:

  • UseHighPrecision: Bepaalt de precisie waarmee Snowflake NUMBER(38,0)-velden moeten worden behandeld. Als er geen waarde is opgegeven, voert de connector een query uit op Snowflake met behulp van de SHOW PARAMETERS LIKE 'ODBC_TREAT_DECIMAL_AS_INT' query. Als de waarde niet is ingesteld, gebruikt de connector de schaal die door de kolom is opgegeven. Een true waarde behandelt GETAL(38;0) als een decimaal type. De waarde false behandelt GETAL(38,0) als een Int64-type. Als de schaal hoger is dan 0, wordt de kolom beschouwd als een dubbel type.
  • DateTimePrecision: Bepaalt de precisie van hoe Snowflake Timestamp-waarden worden behandeld. Snowflake slaat doorgaans timestampwaarden op met nanoseconde precisie. In ADBC kan deze precisie een overloopuitzondering veroorzaken voor datums vóór 1677 of na 2262, volgens Snowflake. Geldige waarden voor deze optie zijn null, nanosecondsof microseconds. Een null-waarde wordt standaard gebruikt nanoseconds . Het is raadzaam dat gebruikers die datums vóór 1677 of na 2262 nodig hebben, de microseconds instelling gebruiken. Als gebruikers precisie moeten behouden tot de tien miljoenste plaats vóór 1677 of na 2262, raden we u aan om het ODBC-stuurprogramma te blijven gebruiken.

Als u een proxy wilt gebruiken om verbinding te maken met Snowflake, raadpleegt u de instructies voor de proxy-instelling. Het stuurprogramma maakt gebruik van omgevingsvariabelen voor de proxy-instellingen.

De volgende tabel bevat een overzicht van de connectorverbeteringen die zijn uitgebracht in eerdere versies:

Vrijgeven Verbetering van de connector
juli 2025 • Booleaanse kolommen retourneren Booleaanse typen, waardoor het probleem wordt opgelost waarbij Booleaanse kolommen werden behandeld als tekenreekstypen in een leeg schema voor recordset (inclusief metagegevens).
• Nieuwe instelling om de maximale tijdstempelprecisie in te stellen op microseconden.
• Verbeterde duurondersteuning.
• Ondersteuning toegevoegd voor navigatie-eigenschappen aan ADBC.
• Verbeterde tracering in het ADBC-stuurprogramma, waar de 'ActivityId' nu kan worden getraceerd via de stuurprogrammalaag.
April 2025 • Ondersteuning toegevoegd voor snowflake-querytag. Als voorbeeld: {"PowerQuery":true,"Host":"PBI_SemanticModel_MWC","HostContext":"PowerBIPremium-DirectQuery"}
Maart 2025 • Verbeterde prestaties bij het ophalen van gegevens uit Snowflake.
• Standaard ingeschakeld in Power BI Desktop, zodat de zojuist gemaakte verbindingen automatisch gebruikmaken van de implementatie van de nieuwe connector.
• Het probleem dat weergaven niet zichtbaar waren is opgelost sinds de laatste release in maart.
Februari 2025 • Verbeterde prestaties door het aantal aanroepen van metagegevens te verminderen.
• Probleem met dubbele waarden opgelost voor grote resultatensets.

Notitie

Wanneer u de on-premises gegevensgateway gebruikt, moet u er rekening mee houden dat de minimaal ondersteunde versie januari 2025 is. U wordt aangeraden de nieuwste versie te gebruiken met de meest recente mogelijkheden.

Notitie

Deze functie wordt ondersteund in de 64-bits versie van Power BI Desktop en werkt niet in de 32-bits versie.

Probleemoplossing

Fout: SQL-compilatiefout: Object bestaat niet of de bewerking kan niet worden uitgevoerd

De fout treedt op wanneer het systeem het opgegeven object niet kan vinden. Deze fout wordt vaak veroorzaakt doordat de gebruiker een ongeldige databasenaam heeft ingesteld als de standaarddatabase.

Zorg ervoor dat een geldige standaarddatabasenaam wordt gebruikt voor de eigenschap DEFAULT_NAMESPACE: DESC USERusername

De standaarddatabasenaam bijwerken: alter userusername set DEFAULT_NAMESPACE=<database name>.<schema name>. Ga naar de Snowflake-documentatie voor meer informatie.

Beperkingen en bekende problemen

Bekende problemen in de implementatie van de Snowflake-connector 2.0

Momenteel heeft de implementatie van de Snowflake-connector 2.0 de volgende bekende problemen. Er wordt voortdurend gewerkt aan een oplossing en de documentatie wordt bijgewerkt wanneer er een oplossing wordt uitgebracht.

  • Snowflake-query met count distinct logica retourneert een onjuist resultaat.
  • Wanneer je relaties aanmaakt, treedt er een fout Object reference not set to an instance of an object op. De relatie kan nog steeds worden gedefinieerd zodra u het pop-upvenster annuleert.
  • Verhoogd geheugengebruik. De totale laadtijd is doorgaans sneller met behulp van Implementation="2.0", maar het geheugenverbruik kan ook hoger zijn, in sommige gevallen problemen veroorzaken zoals 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.

Problemen opgelost

Afbreekstreepjes in databasenamen

Als een databasenaam een koppelteken in zich heeft, kunt u een ODBC: ERROR[42000] SQL compilation error tegenkomen. Dit probleem is opgelost in de release van september 2024.

Slicervisual voor Booleaans gegevenstype

De filtervisual voor het Booleaanse gegevenstype werkt niet zoals verwacht in de release van juni 2024. Deze niet-functionaliteit is een bekend probleem. Als tijdelijke oplossing kunnen gebruikers het Booleaanse gegevenstype in hun rapporten converteren naar tekst door te navigeren naar: Overdracht -> Gegevenstype -> Tekst. Er is een oplossing beschikbaar in de release van oktober 2024.

Weergaven die niet zichtbaar zijn met Implementation="2.0"

In een versie van de release van maart 2025 van Power BI Desktop kan er een probleem optreden dat weergaven niet zichtbaar zijn bij het gebruik van de implementatie van de Snowflake-connector 2.0 (Implementation="2.0"). Dit probleem is opgelost sinds de nieuwste release van maart 2025 van Power BI Desktop. Voer een upgrade uit van de installatie om het opnieuw te proberen.

TIMESTAMP_NTZ waarden zijn UTC met Implementation="2.0"

TIMESTAMP_LTZ typen worden niet geconverteerd naar de lokale tijdzone, maar worden de UTC-waarde geretourneerd bij gebruik van de implementatie van de Snowflake-connector 2.0 (Implementation="2.0"). Bijvoorbeeld, het uitvoeren van SELECT CURRENT_TIMESTAMP vanuit Snowflake geeft de UTC-tijd terug, niet de lokale tijdzone van de gebruiker. Dit probleem is opgelost in de release van juli 2025.

De index ligt buiten de grenzen van de matrix bij het gebruik van Implementation="2.0"

In sommige scenario's wordt een fout gegenereerd die aangeeft Index was outside the bounds of the array bij het gebruik van de Snowflake-connector-implementatie 2.0 (Implementation="2.0"). Dit probleem is opgelost in de release van juni 2025.