Condividi tramite


Fiocco di neve

Riepilogo

Articolo Descrizione
Stato di rilascio Disponibilità generale
Prodotti Power BI (modelli semantici)
Power BI (flussi di dati)
Fabric (Dataflow Gen2)
Power Apps (flussi di dati)
Tipi di autenticazione supportati Snowflake (nome utente/password), account Microsoft (Microsoft Entra ID), Autenticazione con coppia di chiavi (ADBC), Principale del servizio (SPN)
Documentazione di riferimento sulle funzioni

Nota

Il campo di input passphrase viene visualizzato automaticamente solo se necessario, in base al tipo di certificato caricato. Dopo che l'utente carica un certificato, il sistema rileva se è crittografato o non crittografato e visualizza in modo condizionale la finestra di dialogo passphrase. Sono supportate sia chiavi crittografate che non crittografate.

Nota

Alcune funzionalità potrebbero essere presenti in un prodotto, ma non altre a causa di pianificazioni della distribuzione e funzionalità specifiche dell'host.

Funzionalità supportate

  • Importazione
  • DirectQuery (modelli semantici Power BI)
  • Opzioni avanzate
    • Specificare un valore di testo da usare come nome ruolo
    • Colonne delle relazioni
    • Timeout della connessione in secondi
    • Timeout del comando in secondi
    • Banca dati
    • Istruzione SQL nativa

Tipi di autenticazione supportati

Nota

  • La modalità di autenticazione nome utente/password sarà deprecata. Altre informazioni sono disponibili qui. Altre informazioni sono disponibili in Connettività nella roadmap Fabric.

  • L'autenticazione della coppia di chiavi non è supportata per i flussi di dati Gen1.

Il connettore Snowflake supporta i metodi di autenticazione seguenti:

  • Microsoft Entra ID (scelta consigliata): abilita l'autenticazione avanzata basata su identità senza archiviare nomi utente o password.

    • In Microsoft Fabric questo metodo di autenticazione può essere supportato dall'identità dell'area di lavoro nelle esperienze supportate (ad esempio set di dati e flussi di dati Gen2), consentendo a Fabric di eseguire l'autenticazione a Snowflake usando l'identità gestita dell'area di lavoro.
  • Identità dell'area di lavoro: identità gestita associata a un'area di lavoro di Microsoft Fabric. Quando si esegue l'autenticazione con Microsoft Entra ID, le esperienze di Fabric supportate( ad esempio Set di dati e Flussi di dati Gen2) possono usare l'identità dell'area di lavoro per eseguire l'autenticazione a Snowflake. Questo metodo consente a Fabric di accedere a Snowflake usando un'identità associata all'area di lavoro, anziché le singole credenziali utente.

  • Autenticazione della coppia di chiavi (ADBC): autenticazione basata su certificati per scenari supportati.

  • Entità servizio (SPN): le entità servizio sono supportate con Snowflake per scenari in cui è richiesta un'identità a livello di applicazione non utente. Il supporto dipende dalla configurazione snowflake e dal metodo di autenticazione usato.

Connettersi al data warehouse Snowflake da Power Query Desktop

Nota

Per impostazione predefinita, tutte le nuove connessioni usano l'implementazione del connettore Snowflake 2.0 .

È consigliabile aggiornare tutte le connessioni create prima di marzo 2025 a questa nuova implementazione.

Per stabilire la connessione a un warehouse di elaborazione Snowflake , seguire questa procedura:

  1. Selezionare Get Data dalla barra multifunzione Home nella barra multifunzione Power BI Desktop, Selezionare Database dalle categorie a sinistra, selezionare Snowflake e quindi selezionare Connect.

    Screenshot della finestra di dialogo Recupera dati che mostra la selezione del database Snowflake.

  2. Nella finestra Snowflake visualizzata immettere il nome del server Snowflake in Server e il nome del magazzino di calcolo Snowflake in Warehouse.

    Screenshot della finestra di dialogo Snowflake, che mostra il pulsante di opzione Importa selezionato.

  3. Facoltativamente, immettere i valori in qualsiasi opzione avanzata che si desidera usare per modificare la query di connessione, ad esempio un valore di testo da usare come nome del ruolo o un tempo di attesa del comando. Per altre informazioni, vedere Connettersi con le opzioni avanzate.

  4. Seleziona OK.

  5. Per accedere al data warehouse snowflake computing, immettere il nome utente e la password e quindi selezionare Connetti.

    Screenshot del prompt delle credenziali Snowflake, che mostra i campi Nome utente e Password.

    Nota

    Dopo aver immesso il nome utente e la password per un determinato server Snowflake, Power BI Desktop usa le stesse credenziali nei tentativi di connessione successivi. È possibile modificare tali credenziali passando a File Opzioni > e impostazioni e configurazioni dell'origine > dati. Per altre informazioni, vedere Modificare il metodo di autenticazione.

    Se si desidera utilizzare l'opzione account Microsoft, è necessario configurare l'integrazione di Microsoft Entra ID nella parte di Snowflake. Per altre informazioni, vedere Power BI SSO to Snowflake - Getting Started (Accesso Single Sign-On a Snowflake - Introduzione.

  6. In Navigator selezionare uno o più elementi da importare e usare in Power BI Desktop. Selezionare quindi Load per caricare la tabella in Power BI Desktop o Transform Data per aprire l'editor Power Query in cui è possibile filtrare e perfezionare il set di dati da usare e quindi caricare il set di dati perfezionato in Power BI Desktop.

    Screenshot dello strumento di navigazione con il database dello schema di test aperto e la tabella DimProduct selezionata.

  7. Selezionare Importa per importare i dati direttamente in Power BI oppure selezionare DirectQuery, quindi selezionare OK. Per altre informazioni, vedere Use DirectQuery in Power BI Desktop.

    Nota

    Microsoft Entra ID supporta solo l'accesso Single Sign-On (SSO) tramite DirectQuery.

    Screenshot delle impostazioni di connessione, che contiene le selezioni Import e DirectQuery.

Connettersi a un database Snowflake da Power Query Online

Per stabilire la connessione, seguire questa procedura:

  1. Selezionare l'opzione Snowflake nella selezione del connettore.

  2. Nella finestra di dialogo Snowflake visualizzata immettere il nome del server e del magazzino.

    Screenshot del generatore di connessioni Snowflake in Power Query Online.

  3. Immettere i valori nelle opzioni avanzate da usare. Se nell'interfaccia utente sono presenti opzioni avanzate non rappresentate, è possibile modificarle nel Advanced Editor in Power Query versioni successive.

  4. Immettere le credenziali di connessione, inclusa la selezione o la creazione di una nuova connessione, il gateway che si vuole usare e un nome utente e una password.

  5. Selezionare Avanti per connettersi al database.

  6. In Navigator selezionare i dati necessari, quindi selezionare Transform data per trasformare i dati in Power Query Editor.

    Screenshot dello strumento di navigazione online con il database dello schema di test aperto e la tabella DimProduct selezionata.

Connettersi tramite opzioni avanzate

Power Query fornisce un set di opzioni avanzate che è possibile aggiungere alla query, se necessario.

Nella tabella seguente sono elencate tutte le opzioni avanzate che è possibile impostare in Power Query.

Opzione avanzata Descrizione
Nome ruolo Specifica il ruolo che il report utilizza attraverso il driver. Questo ruolo deve essere disponibile per l'utente. In caso contrario, non è impostato alcun ruolo.
Includi colonne di relazione Se selezionata, include colonne che potrebbero avere relazioni con altre tabelle. Se questa casella è deselezionata, queste colonne non vengono visualizzate.
Timeout della connessione in secondi Specifica il tempo di attesa di una risposta durante l'interazione con il servizio Snowflake prima di restituire un errore. Il valore predefinito è 0 (nessun timeout).
Timeout del comando in secondi Specifica per quanto tempo attendere il completamento di un'interrogazione prima di generare un errore. Il valore predefinito è 0 (nessun timeout).
Banca dati Specifica un database specifico nel magazzino. Questa opzione è disponibile solo in Power Query Desktop.
Istruzione SQL Per informazioni, vedere Importare dati da un database usando una query di database nativa. Questa opzione è disponibile solo in Power Query Desktop.

Dopo aver selezionato le opzioni avanzate necessarie, selezionare OK in Power Query Desktop o Next in Power Query Online per connettersi al database Snowflake.

Implementazione del connettore Snowflake 2.0

Nel gennaio 2025 è stata introdotta una nuova implementazione per il connettore Snowflake per migliorare l'integrazione con Snowflake. Questo connettore è disponibile a livello generale a partire da luglio 2025. È consigliabile aggiornare Power BI Desktop e il gateway dati locale alla versione più recente per trarre vantaggio dalle funzionalità più recenti. Inviare commenti e suggerimenti per continuare a migliorare il connettore.

L'implementazione del connettore Snowflake 2.0 viene compilata usando il driver ADBC ( Arrow Database Connectivity ) open source. ADBC offre un set di interfacce standard per l'interazione con i dati Arrow, particolarmente efficienti nel recupero di set di dati di grandi dimensioni con overhead minimo e senza serializzazione o copia. Il driver ADBC incorpora anche miglioramenti della sicurezza, ad esempio sicurezza della memoria e Garbage Collection. Inoltre, la collaborazione con la community open source consente aggiornamenti più rapidi, usando strumenti moderni e processi sdl (Secure Development Lifecycle).

Per consentire di sfruttare questi miglioramenti delle prestazioni e della sicurezza, a partire da luglio 2025, tutte le connessioni appena create in Desktop usano automaticamente l'implementazione 2.0. È anche possibile testare l'implementazione 2.0 aggiornando le query esistenti e aggiungendo il Implementation="2.0" flag in Snowflake.Databases come indicato di seguito.

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

Per facilitare la diagnosi di qualsiasi problema potenziale, puoi trovare i dettagli Implementation e DriverType nei log Mashup, come nell'esempio seguente. Se si verifica un problema durante la transizione, contattare il supporto tecnico. Nel frattempo, per mitigare autonomamente, è possibile rimuovere Implementation="2.0" per continuare a utilizzare il connettore ODBC e evitare interruzioni aziendali prima che il problema venga risolto. Tuttavia, se si usa l'autenticazione coppia di chiavi, il driver ADBC viene sempre usato indipendentemente da questa impostazione.

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

A partire dalla versione di luglio 2025 sono disponibili le opzioni seguenti:

  • UseHighPrecision: controlla la precisione con cui devono essere gestiti i campi Snowflake NUMBER(38,0). Se non viene specificato alcun valore, il connettore esegue query su Snowflake usando la SHOW PARAMETERS LIKE 'ODBC_TREAT_DECIMAL_AS_INT' query. Se non è impostato alcun valore, il connettore usa la scala specificata dalla colonna. Un true valore considera NUMBER(38,0) come tipo Decimal. Il valore false considera NUMBER(38,0) come tipo Int64. Se la scala è superiore a 0, la colonna viene considerata come tipo Double.
  • DateTimePrecision: controlla la precisione della modalità di trattamento dei valori timestamp Snowflake. Snowflake archivia in genere i valori timestamp con precisione nanosecondo. In ADBC, questa precisione può causare un'eccezione di overflow per le date precedenti al 1677 o successive al 2262, in base a Snowflake. I valori validi per questa opzione sono null, nanosecondso microseconds. Viene utilizzato un valore nullnanoseconds per impostazione predefinita. È consigliabile che gli utenti che necessitano di date prima del 1677 o dopo la 2262 usino l'impostazione microseconds . Se gli utenti devono mantenere la precisione al 1 milionesimo posto prima del 1677 o dopo il 2262, è consigliabile rimanere con il driver ODBC.

Se è necessario usare il proxy per connettersi a Snowflake, fare riferimento all'istruzione dell'impostazione proxy. Il driver usa le variabili di ambiente per le impostazioni proxy.

La tabella seguente contiene un riepilogo dei miglioramenti del connettore rilasciati nelle versioni precedenti:

Rilascio Miglioramento del connettore
Luglio 2025 • Le colonne booleane restituiscono tipi booleani, risolvendo il problema in cui le colonne booleane sono state considerate come tipi string in uno schema di set di record vuoto (inclusi i metadati).
• Nuova impostazione per impostare la precisione massima del timestamp su microsecondi.
• Miglioramento del supporto per la durata.
• Aggiunto il supporto alle proprietà di navigazione dell'ADBC.
• Miglioramento del tracciamento nel driver ADBC, in cui è ora possibile tracciare "ActivityId" tramite il livello del driver.
Aprile 2025 • Aggiunta del supporto per il tag di query Snowflake. Ad esempio: {"PowerQuery":true,"Host":"PBI_SemanticModel_MWC","HostContext":"PowerBIPremium-DirectQuery"}
Marzo 2025 • Prestazioni migliorate durante il recupero dei dati da Snowflake.
• Abilitato per impostazione predefinita in Power BI Desktop in modo che le connessioni appena create usino automaticamente la nuova implementazione del connettore.
• Corretti i problemi relativi alle visualizzazioni non visibili dall'ultima release di marzo.
Febbraio 2025 • Prestazioni migliorate riducendo il numero di chiamate ai metadati.
• È stato risolto un problema di valori duplicati per set di risultati di grandi dimensioni.

Nota

Quando si usa il gateway dati locale, è da notare che la versione minima supportata è gennaio 2025. È consigliabile usare la versione più recente con le funzionalità più recenti.

Nota

Questa funzionalità è supportata nella versione a 64 bit di Power BI Desktop e non funziona nella versione a 32 bit.

Risoluzione dei problemi

Errore: Errore di compilazione SQL: L'oggetto non esiste o non è possibile eseguire l'operazione

L'errore si verifica quando il sistema non riesce a trovare l'oggetto specificato. Spesso, questo errore è dovuto al fatto che l'utente ha un nome di database non valido impostato come database predefinito.

Assicurarsi che venga usato un nome di database predefinito valido per la proprietà DEFAULT_NAMESPACE: DESC USERusername

Per aggiornare il nome predefinito del database: alter userusername set DEFAULT_NAMESPACE=<database name>.<schema name>. Per altre informazioni, vedere la documentazione di Snowflake.

Limitazioni e considerazioni

Problemi noti nell'implementazione del connettore Snowflake 2.0

Attualmente, l'implementazione del connettore Snowflake 2.0 presenta i problemi noti seguenti. È in corso un lavoro verso una correzione e la documentazione verrà aggiornata quando viene rilasciata una correzione.

  • La query Snowflake con count distinct logica restituisce un risultato non corretto.
  • Maggiore utilizzo della memoria. Il tempo di caricamento complessivo è in genere più veloce usando Implementation="2.0", ma l'utilizzo della memoria può anche essere superiore, in alcuni casi causando problemi come 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.

Problemi risolti

Trattini nei nomi di database

Se un nome di database contiene un trattino, è possibile riscontrare un oggetto ODBC: ERROR[42000] SQL compilation error. Questo problema viene risolto nella versione di settembre 2024.

Visualizzazione filtro per tipo di dato booleano

L'oggetto di selezione visiva per i tipi di dati booleani non funziona come previsto nella versione di giugno 2024. Questa non funzionalità è un problema noto. Come soluzione temporanea, gli utenti possono convertire il tipo di dati booleano nei report in testo passando a: Trasferimento -> Tipo di dati -> Testo. Una correzione viene fornita nella versione di ottobre 2024.

Visualizzazioni non visibili con Implementation="2.0"

In alcune versioni della release di marzo 2025 di Power BI Desktop, potrebbe verificarsi un problema per cui le visualizzazioni potrebbero non essere visibili quando si usa l'implementazione 2.0 del connettore Snowflake (Implementation="2.0"). Questo problema è stato risolto dall'ultima versione di marzo 2025 di Power BI Desktop. Per riprovare, aggiornare l'installazione.