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)
Documentatie voor functiereferenties	—

Notitie

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

Notitie

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

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.

   

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.

   

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. Meer informatie: Verbinding maken met 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.

   

   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. Meer informatie: De verificatiemethode wijzigen

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

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

   

7. Selecteer Importeren om gegevens rechtstreeks in Power BI te importeren of selecteer DirectQuery en selecteer VERVOLGENS OK. Meer informatie: DirectQuery gebruiken in Power BI Desktop

   Notitie

   Eenmalige aanmelding van Microsoft Entra ID ondersteunt alleen DirectQuery.

   

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.

   

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.

   

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 om de Power BI Desktop- en 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 garbagecollection. 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, worden in alle zojuist gemaakte verbindingen automatisch gebruikgemaakt van de 2.0-implementatie. Daarnaast zetten we bestaande klanten geleidelijk over op de implementatie van 2.0 in fasen, waarbij updates tot en met november 2025 worden toegepast op verschillende regio's. Gedurende deze periode kunt u de implementatie 2.0 testen door uw bestaande query's bij te werken en de Implementation="2.0" vlag Snowflake.Databases als volgt toe te voegen. Na de overgang worden verbindingen die geen implementatie opgeven, automatisch bijgewerkt naar de 2.0-implementatie.

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 de impact te beperken, Implementation="1.0" opgeven om de 1.0-connector te blijven gebruiken en zo 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 dit een overloopuitzondering veroorzaken voor datums vóór 1677 of na 2262, volgens Snowflake. Geldige waarden voor deze optie zijn null of nanosecondsmicroseconds. Een null-waarde wordt standaard gebruikt nanoseconds . Gebruikers die datums vóór 1677 of na 2262 nodig hebben, worden aanbevolen om de microseconds instelling te gebruiken. Als gebruikers precisie moeten behouden tot op het tien miljoenste cijfer vóór 1677 of na 2262, is het raadzaam om bij het ODBC-stuurprogramma te blijven.

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.

Hieronder ziet u een overzicht van de verbeteringen van de connector die in de vorige versies zijn uitgebracht:

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 recordsetschema (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 de weergaven niet zichtbaar waren, is opgelost sinds de meest recente release van 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>. Zie de Snowflake-documentatie voor meer informatie - https://docs.snowflake.com/en/sql-reference/sql/alter-user

Beperkingen en bekende problemen

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 sommige versies van de maart 2025-release van Power BI Desktop kan het probleem optreden dat weergaven niet zichtbaar zijn bij het gebruik van de Snowflake-connectorimplementatie 2.0 (Implementation="2.0"). Dit probleem is opgelost sinds de nieuwste versie 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 retourneren de UTC-waarde bij het gebruik van de Snowflake-connector-implementatie 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.

Aanvullende informatie

• Verbinding maken met Snowflake in De Power BI-service