Partager via


Flocon de neige

Résumé

Élément Descriptif
État de la publication Disponibilité générale
PRODUITS Power BI (Modèles sémantiques)
Power BI (Flux de données)
Fabric (Dataflow Gen2)
Power Apps (Flux de données)
Types d'authentification pris en charge Snowflake (nom d’utilisateur/mot de passe), compte Microsoft (ID Microsoft Entra), authentification par paire de clés
Documentation de référence sur la fonction

Remarque

L’implémentation du connecteur Snowflake 2.0 est généralement disponible depuis juillet 2025. En savoir plus sur cette fonctionnalité.

Remarque

Le champ d’entrée de mot de passe s’affiche automatiquement uniquement si nécessaire, en fonction du type de certificat téléchargé. Une fois que l’utilisateur a chargé un certificat, le système détecte s’il est chiffré ou non chiffré et affiche conditionnellement la boîte de dialogue de phrase secrète. Les clés chiffrées et non chiffrées sont prises en charge.

Remarque

Certaines fonctionnalités peuvent être présentes dans un produit, mais pas d’autres en raison de planifications de déploiement et de fonctionnalités spécifiques à l’hôte.

Remarque

Le mode d’authentification par nom d’utilisateur/mot de passe sera déconseillé par Snowflake (en savoir plus ici). Vous trouverez plus d’informations sous Connectivité sur notre feuille de route Fabric.

Fonctionnalités prises en charge

  • Importer
  • DirectQuery (pour les modèles sémantiques Power BI)
  • Options avancées
    • Spécifier une valeur de texte à utiliser en tant que nom de rôle
    • Colonnes de relation
    • Délai d’expiration de la connexion en secondes
    • Délai d’expiration de la commande en secondes
    • Base de données
    • Instruction SQL native

Se connecter à l’entrepôt de données Snowflake à partir de Power Query Desktop

Remarque

Depuis la version de mars 2025 de Power BI Desktop, l’option Snowflake connector implementation 2.0 est activée par défaut.

Pour établir la connexion à un entrepôt de calcul Snowflake , procédez comme suit :

  1. Sélectionnez Obtenir des données dans le ruban Accueil de Power BI Desktop, sélectionnez Base de données dans les catégories à gauche, sélectionnez Snowflake, puis Connect.

    Capture d’écran de la boîte de dialogue Obtenir des données, montrant la sélection de la base de données Snowflake.

  2. Dans la fenêtre Snowflake qui s’affiche, entrez le nom de votre serveur Snowflake dans le serveur et le nom de votre entrepôt de calcul Snowflake dans l’entrepôt.

    Capture d’écran de la boîte de dialogue Snowflake, montrant la case d’option Importer sélectionnée.

  3. Si vous le souhaitez, entrez des valeurs dans toutes les options avancées que vous souhaitez utiliser pour modifier la requête de connexion, comme une valeur de texte à utiliser comme nom de rôle ou un délai d’expiration de commande. Pour plus d’informations, accédez à Se connecter à l’aide d’options avancées.

  4. Sélectionnez OK.

  5. Pour vous connecter à votre entrepôt de calcul Snowflake, entrez votre nom d’utilisateur et votre mot de passe, puis sélectionnez Se connecter.

    Capture d’écran de l’invite d’informations d’identification Snowflake, montrant les champs Nom d’utilisateur et Mot de passe.

    Remarque

    Une fois que vous avez entré votre nom d’utilisateur et votre mot de passe pour un serveur Snowflake particulier, Power BI Desktop utilise ces mêmes informations d’identification dans les tentatives de connexion suivantes. Vous pouvez modifier ces informations d’identification en accédant aux paramètres des options de fichier > et des paramètres > de la source de données. Pour plus d’informations, accédez à Modifier la méthode d’authentification.

    Si vous souhaitez utiliser l’option Compte Microsoft, l’intégration Microsoft Entra ID avec Snowflake doit être configurée côté Snowflake. Pour plus d’informations, accédez à SSO Power BI vers Snowflake - Guide de démarrage.

  6. Dans le navigateur, sélectionnez un ou plusieurs éléments à importer et utiliser dans Power BI Desktop. Sélectionnez Ensuite Charger pour charger la table dans Power BI Desktop ou transformer des données pour ouvrir l’éditeur Power Query dans lequel vous pouvez filtrer et affiner le jeu de données que vous souhaitez utiliser, puis charger ce jeu de données affiné dans Power BI Desktop.

    Capture d’écran du navigateur avec la base de données de schéma de test ouverte et la table DimProduct sélectionnée.

  7. Sélectionnez Importer pour importer des données directement dans Power BI, ou sélectionnez DirectQuery, puis ok. Pour plus d’informations, accédez à Utiliser DirectQuery dans Power BI Desktop.

    Remarque

    L’authentification unique Microsoft Entra ID prend uniquement en charge DirectQuery.

    Capture d’écran des paramètres de connexion, qui contient les sélections Import et DirectQuery.

Se connecter à une base de données Snowflake à partir de Power Query Online

Pour établir la connexion, effectuez les étapes suivantes :

  1. Sélectionnez l’option Snowflake dans la sélection du connecteur.

  2. Dans la boîte de dialogue Snowflake qui s’affiche, entrez le nom du serveur et de l’entrepôt.

    Capture d’écran du générateur de connexions Snowflake dans Power Query Online.

  3. Entrez des valeurs pour les options avancées que vous souhaitez utiliser. S’il existe des options avancées non représentées dans l’interface utilisateur, vous pouvez les modifier dans l’éditeur avancé dans Power Query ultérieurement.

  4. Entrez vos informations d’identification de connexion, notamment en sélectionnant ou en créant une nouvelle connexion, la passerelle que vous souhaitez utiliser, un nom d’utilisateur et un mot de passe.

  5. Sélectionnez Suivant pour vous connecter à la base de données.

  6. Dans navigateur, sélectionnez les données dont vous avez besoin, puis transformez les données pour transformer les données dans l’éditeur Power Query.

    Capture d’écran du navigateur en ligne avec la base de données de schéma de test ouverte et la table DimProduct sélectionnée.

Se connecter à l’aide d’options avancées

Power Query fournit un ensemble d’options avancées que vous pouvez ajouter à votre requête si nécessaire.

Le tableau suivant répertorie toutes les options avancées que vous pouvez définir dans Power Query.

Option avancée Descriptif
Nom de rôle Spécifie le rôle que le rapport utilise via le pilote. Ce rôle doit être disponible pour l’utilisateur. Sinon, aucun rôle n’est défini.
Inclure des colonnes de relation Si cette option est activée, elle inclut des colonnes qui peuvent avoir des relations avec d’autres tables. Si cette zone est désactivée, vous ne voyez pas ces colonnes.
Délai d’expiration de la connexion en secondes Spécifie la durée d’attente d’une réponse lors de l’interaction avec le service Snowflake avant de retourner une erreur. La valeur par défaut est 0 (aucun délai d’expiration).
Délai d’expiration de la commande en secondes Spécifie la durée d’attente de fin d’une requête avant le retour d’une erreur. La valeur par défaut est 0 (aucun délai d’expiration).
Base de données Spécifie une base de données spécifique dans l’entrepôt. Cette option n’est disponible que dans Power Query Desktop.
Instruction SQL Pour plus d’informations, accédez à Importer des données à partir d’une base de données à l’aide d’une requête de base de données native. Cette option n’est disponible que dans Power Query Desktop.

Une fois que vous avez sélectionné les options avancées dont vous avez besoin, sélectionnez OK dans Power Query Desktop ou Suivant dans Power Query Online pour vous connecter à votre base de données Snowflake.

Implémentation du connecteur Snowflake 2.0

En janvier 2025, nous avons introduit une nouvelle implémentation pour le connecteur Snowflake afin d’améliorer l’intégration à Snowflake. Ce connecteur est généralement disponible depuis juillet 2025. Nous vous recommandons de mettre à niveau Power BI Desktop et la passerelle de données locale vers la dernière version pour bénéficier des fonctionnalités les plus récentes. Fournissez-nous des commentaires pour nous aider à continuer à améliorer le connecteur.

L’implémentation du connecteur Snowflake 2.0 est générée à l’aide du pilote ADBC (Open Source Arrow Database Connectivity ). ADBC fournit un ensemble d’interfaces standard permettant d’interagir avec les données Arrow, ce qui est particulièrement efficace pour extraire des jeux de données volumineux avec une surcharge minimale et aucune sérialisation ni copie. Le pilote ADBC intègre également des améliorations de sécurité, telles que la sécurité de la mémoire et le garbage collection. En outre, la collaboration avec la communauté open source permet des mises à jour plus rapides, en utilisant des outils modernes et des processus de cycle de vie de développement sécurisé (SDL).

Pour vous permettre de tirer parti de ces améliorations de performances et de sécurité, à compter de juillet 2025, toutes les connexions nouvellement créées dans Desktop utilisent automatiquement l’implémentation 2.0. Vous pouvez également tester l’implémentation 2.0 en mettant à jour vos requêtes existantes et en ajoutant l’indicateur Implementation="2.0" de la manière suivante: Snowflake.Databases.

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

Pour faciliter le diagnostic de tout problème potentiel, vous pouvez trouver les Implementation et DriverType détails dans vos journaux Mashup, comme dans l’exemple suivant. Si vous rencontrez un problème pendant la transition, contactez le support technique. Pendant ce temps, pour atténuer automatiquement, vous pouvez supprimer Implementation="2.0" pour continuer à utiliser le connecteur ODBC pour éviter l’interruption de l’activité avant la résolution du problème.

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

Les options suivantes sont disponibles depuis la version de juillet 2025 :

  • UseHighPrecision: contrôle la précision de la façon dont les champs Snowflake NUMBER(38,0) doivent être gérés. Si aucune valeur n’est spécifiée, le connecteur interroge Snowflake à l’aide de la SHOW PARAMETERS LIKE 'ODBC_TREAT_DECIMAL_AS_INT' requête. Si aucune valeur n’est définie, le connecteur utilise l’échelle spécifiée par la colonne. Une true valeur traite NUMBER(38,0) comme un type décimal. La valeur false traite NUMBER(38,0) comme un type Int64. Si l’échelle est supérieure à 0, la colonne est considérée comme un type Double.
  • DateTimePrecision: contrôle la précision de la manière dont les valeurs d’horodatage Snowflake sont traitées. Snowflake stocke généralement les valeurs d’horodatage avec une précision nanoseconde. Dans ADBC, cette précision peut entraîner une exception de dépassement de capacité pour les dates antérieures à 1677 ou après 2262, selon Snowflake. Les valeurs valides pour cette option sont null, nanosecondsou microseconds. Une valeur null utilise nanoseconds par défaut. Nous recommandons aux utilisateurs qui ont besoin de dates avant 1677 ou après 2262 d’utiliser le microseconds paramètre. Si les utilisateurs doivent conserver la précision aux dix millionièmes places avant 1677 ou après 2262, nous leur recommandons de continuer à utiliser le pilote ODBC.

Si vous devez utiliser le proxy pour vous connecter à Snowflake, reportez-vous à l’instruction de paramètre de proxy. Le pilote utilise des variables d’environnement pour les paramètres de proxy.

Le tableau suivant contient un résumé des améliorations apportées aux connecteurs publiées dans les versions précédentes :

Libération Amélioration du connecteur
Juillet 2025 • Les colonnes booléennes retournent des types booléens, en corrigeant le problème où les colonnes booléennes ont été traitées comme des types String dans un schéma de jeu d’enregistrements vide (y compris les métadonnées).
• Nouveau paramètre pour définir la précision d’horodatage maximale sur microsecondes.
• Prise en charge améliorée de la durée.
• Ajout de la prise en charge des propriétés de navigation à ADBC.
• Amélioration du suivi dans le pilote ADBC, où le « ActivityId » peut maintenant être suivi via la couche de pilote.
Avril 2025 • Ajout de la prise en charge de la balise de requête Snowflake. Par exemple : {"PowerQuery":true,"Host":"PBI_SemanticModel_MWC","HostContext":"PowerBIPremium-DirectQuery"}
mars 2025 • Amélioration des performances lors de la récupération de données à partir de Snowflake.
• Activé par défaut dans Power BI Desktop afin que les connexions nouvellement créées utilisent automatiquement la nouvelle implémentation du connecteur.
• Correction du problème des vues non visibles depuis la dernière version de mars.
Février 2025 • Amélioration des performances en réduisant le nombre d’appels de métadonnées.
• Résolution du problème des valeurs dupliquées pour les jeux de résultats volumineux.

Remarque

Lorsque vous utilisez la passerelle de données locale, notez que la version minimale prise en charge est janvier 2025. Nous vous recommandons d’utiliser la dernière version avec les fonctionnalités les plus récentes.

Remarque

Cette fonctionnalité est prise en charge dans la version 64 bits de Power BI Desktop et ne fonctionne pas dans la version 32 bits.

Dépannage

Erreur : Erreur de compilation SQL : l’objet n’existe pas ou l’opération ne peut pas être effectuée

Cette erreur se produit lorsque le système ne trouve pas l’objet spécifié. Souvent, cette erreur est due au fait que l’utilisateur a défini un nom de base de données non valide comme base de données par défaut.

Assurez-vous qu’un nom de base de données par défaut valide est utilisé pour la propriété DEFAULT_NAMESPACE : DESC USERusername

Pour mettre à jour le nom de la base de données par défaut : alter userusername set DEFAULT_NAMESPACE=<database name>.<schema name>. Pour plus d’informations, consultez la documentation Snowflake.

Limitations et problèmes connus

Problèmes connus dans l’implémentation du connecteur Snowflake 2.0

Actuellement, l’implémentation du connecteur Snowflake 2.0 présente les problèmes connus suivants. Il existe un travail continu vers un correctif et la documentation sera mise à jour lors de la publication d’un correctif.

  • La requête Snowflake avec la logique count distinct retourne un résultat incorrect.
  • Lors de la création de relations, vous rencontrez une erreur Object reference not set to an instance of an object. La relation peut toujours être définie une fois que vous annulez la fenêtre contextuelle.
  • Augmentation de l’utilisation de la mémoire. Le temps de chargement global est généralement plus rapide à l’aide Implementation="2.0", mais la consommation de mémoire peut également être plus élevée, dans certains cas à l’origine de problèmes tels que 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.

Problèmes résolus

Trait d’union dans les noms de base de données

Si le nom d’une base de données contient un trait d’union, vous pouvez rencontrer une erreur ODBC: ERROR[42000] SQL compilation error. Ce problème est résolu dans la version de septembre 2024.

Visuel de segment pour le type de données booléen

Le visuel de segment pour le type de données booléen ne fonctionne pas comme prévu dans la version de juin 2024. Cette non-fonction est un problème connu. En tant que solution temporaire, les utilisateurs peuvent convertir le type de données booléen dans leurs rapports en texte en accédant à : Transfert -> Type de données -> Texte. Un correctif est fourni dans la version d’octobre 2024.

Vues non visibles avec Implementation="2.0 »

Dans une version de la version de mars 2025 de Power BI Desktop, vous pouvez rencontrer un problème indiquant que les vues ne sont pas visibles lors de l’utilisation de l’implémentation du connecteur Snowflake 2.0 (Implementation="2.0"). Ce problème est résolu depuis la dernière version de mars 2025 de Power BI Desktop. Pour réessayer, mettez à niveau votre installation.

Les valeurs TIMESTAMP_NTZ sont UTC avec Implementation="2.0"

TIMESTAMP_LTZ types ne sont pas convertis en fuseau horaire local, mais retournent la valeur UTC lors de l’utilisation de l’implémentation du connecteur Snowflake 2.0 (Implementation="2.0"). Par exemple, le SELECT CURRENT_TIMESTAMP depuis Snowflake retourne l’heure UTC, et non le fuseau horaire local de l’utilisateur. Ce problème est résolu dans la version de juillet 2025.

L’index était en dehors des limites du tableau lors de l’utilisation de Implementation="2.0 »

Dans certains scénarios, une erreur est renvoyée indiquant le Index was outside the bounds of the array lors de l'utilisation de l'implémentation du connecteur Snowflake 2.0 (Implementation="2.0"). Ce problème est résolu dans la version de juin 2025.