Indicazioni per la distribuzione di un gateway dati per Power BIGuidance for deploying a data gateway for Power BI

Questo articolo fornisce indicazioni e considerazioni per la distribuzione di un gateway dati nell'ambiente di rete.This article provides guidance and considerations for deploying a data gateway in your network environment. Il termine gateway indica il software usato per agevolare l'accesso a dati che risiedono in una rete privata locale allo scopo di usarli in un servizio cloud, come Power BI.A gateway is software that facilitates access to data that resides on a private, on-premises network, for subsequent use in a cloud service like Power BI. Questo articolo fornisce indicazioni per l'installazione del gateway dati locale e la distribuzione.This article walks you through the deployment, and provides guidance for, the on-premises data gateway setup.

Per altre informazioni sul gateway dati locale, incluso un collegamento per installarlo, vedere questo post di blog.For more about on-premises data gateway, including a link to install it, take a look at the blog post.

Considerazioni sull'installazione per il gateway dati localeInstallation considerations for the on-premises data gateway

Prima di approfondire ulteriormente i dettagli relativi a installazione e distribuzione, ci sono alcune considerazioni da tenere in mente.Before getting too far into the details of installation and deployment, there are a handful of considerations you should keep in mind. Le sezioni seguenti descrivono informazioni importanti da tenere sempre ben presenti.The following sections describe important things to keep in mind.

Numero di utentiNumber of users

Il numero di utenti che utilizzano un report che usa il gateway è un parametro importante per decidere dove installare il gateway.The number of users consuming a report that's using the gateway is an important metric in deciding where to install the gateway. Di seguito sono riportate alcune domande da considerare:Here are some questions to consider:

  • Gli utenti useranno questi report in momenti diversi del giorno?Are users using these reports at different times of the day?
  • Quali tipi di connessioni sono in uso (DirectQuery o importazione)?What types of connections are they using (DirectQuery or Import)?
  • Tutti gli utenti usano lo stesso report?Are all users using the same report?

Se gli utenti hanno tutti accesso a un determinato report alla stessa ora di ogni giorno, è consigliabile assicurarsi di installare il gateway in un computer che possa gestire tutte le richieste (vedere le sezioni seguenti per i contatori delle prestazioni e i requisiti minimi che consentono di determinarlo).If users are all accessing a given report at the same time each day, you'll want to make sure you install the gateway on a machine that's capable of handling all those requests (see following sections for performance counters and minimum requirements that can help you determine this).

In Power BI esiste un vincolo che consente un solo gateway per report, pertanto anche se un report si basa su più origini dati, tutte queste origini dati devono transitare attraverso un singolo gateway.There is a constraint in Power BI that allows only one gateway per report, so even if a report is based on multiple data sources, all such data sources must go through a single gateway. Tuttavia, se un dashboard è basato su più report, è possibile usare un gateway dedicato per ogni report partecipante e quindi distribuire il carico di gateway tra quei report che contribuiscono a tale dashboard singolo.However, if a dashboard is based on multiple reports, you can use a dedicated gateway for each contributing report, and thereby distribute the gateway load among those multiple reports that contribute to that single dashboard.

Tipo di connessioneConnection type

Power BI offre due tipi di connessioni: DirectQuery e importazione.Power BI offers two types of connections, DirectQuery and Import. Non tutte le origini dati supportano entrambi i tipi di connessione e diversi motivi possono contribuire alla scelta di uno di essi, ad esempio requisiti di sicurezza, prestazioni, limiti di dati e le dimensioni dei modelli di dati.Not all data sources support both connection types, and many reasons may contribute to choosing one over the other, such as security requirements, performance, data limits, and data model sizes. Per altre informazioni sul tipo di connessione e sulle origini dati supportate vedere la sezione dell'elenco dei tipi di origini dati disponibili dell'articolo sul gateway dati locale.You can learn more about connection type and supported data sources in the list of available data source types section of the On-premises data gateway article.

A seconda del tipo di connessione in uso, l'utilizzo del gateway può essere diverso.Depending on which type of connection are use, gateway usage can be different. Ad esempio, è consigliabile separare le origini dati DirectQuery dalle origini dati di Aggiornamento pianificato laddove possibile (presupponendo che si trovino in report diversi e possano essere separate).For example, you should try to separate DirectQuery data sources from Scheduled Refresh data sources whenever possible (assuming they're in different reports and can be separated). Ciò impedisce al gateway di accumulare migliaia di richieste DirectQuery in coda, contemporaneamente all'aggiornamento pianificato del mattino di un modello di dati di grandi dimensioni che viene usato per il dashboard principale della società.Doing so prevents the gateway from having thousands of DirectQuery requests queued up, at the same time as the morning's scheduled refresh of a large size data model that's used for the company's main dashboard. Ecco i fattori da considerare per ciascuno di essi:Here's what to consider for each:

  • Per Aggiornamento pianificato: a seconda delle dimensioni della query e del numero di aggiornamenti che si verificano ogni giorno, è possibile scegliere di restare nei requisiti hardware minimi consigliati oppure eseguire l'aggiornamento a un computer con prestazioni superiori.For Scheduled Refresh: depending on your query size and the number of refreshes occurring per day, you can choose to stay between the recommended minimum hardware requirements or upgrade to a higher performance machine. Se una determinata query non è stata ridotta, si verificano trasformazioni nel computer del gateway e, di conseguenza, il computer del gateway trae vantaggio dalla maggiore quantità di RAM disponibile.If a given query is not folded, transformations occur on the gateway machine, and as such, the gateway machine benefits from having more available RAM.
  • Per DirectQuery: viene inviata una query ogni volta che un utente apre il report o esamina i dati.For DirectQuery: a query is be sent each time any user opens the report or looks at data. Dunque, se si prevede l'accesso simultaneo di più di 1.000 utenti, è consigliabile assicurarsi che il computer abbia componenti hardware soli di affidabili.So if you anticipate more than 1,000 users accessing the data concurrently, you'll want to make sure your computer has robust and capable hardware components. Un numero maggiore di memorie centrali CPU garantisce una migliore velocità effettiva per una connessione DirectQuery.More CPU cores will result in better throughput for a DirectQuery connection.

I requisiti per un computer in cui si installa un gateway dati locale sono i seguenti:The requirements for a machine on which you install an on-premises data gateway are the following:

Minimo:Minimum:

  • .NET Framework 4.5.NET 4.5 Framework
  • Versione a 64 bit di Windows 7/Windows Server 2008 R2 (o versione successiva)64-bit version of Windows 7 / Windows Server 2008 R2 (or later)

Consigliato:Recommended:

  • CPU 8 core8 Core CPU
  • 8 GB di memoria8 GB Memory
  • Versione a 64 bit di Windows 2012 R2 (o versione successiva)64-bit version of Windows 2012 R2 (or later)

PosizioneLocation

La posizione di installazione del gateway può avere un impatto significativo sulle prestazioni delle query, quindi assicurarsi che il gateway, i percorsi di origine dati e il tenant di Power BI siano più vicino possibile tra loro per ridurre al minimo la latenza di rete.The location of the gateway installation can have significant impact on your query performance, so try to make sure your gateway, data source locations, and the Power BI tenant are as close as possible to each other to minimize network latency. Per determinare la posizione del tenant di Power BI, nel servizio Power BI selezionare l'icona ?To determine your Power BI tenant location, in the Power BI service select the ? nell'angolo in alto a destra e quindi scegliere Informazioni su Power BI.icon in the upper-right corner, and then select About Power BI.

Monitoraggio dei gatewayMonitoring gateways

Esistono alcuni strumenti che è possibile usare per monitorare l'uso e le prestazioni dei gateway installati.There are a few tools that you can use to monitor the use and performance of your installed gateways.

Contatori delle prestazioniPerformance counters

Esistono molti contatori delle prestazioni che possono essere usati per valutare e stimare l'attività che si verificano nel gateway.There are many performance counters that can be used to evaluate and assess activity occurring on the gateway. I contatori consentono di comprendere se è disponibile un volume elevato di attività per tipo specifico, che può richiedere la distribuzione di un nuovo gateway.The counters can help you understand whether you have large volume of activities by the specific type, which may prompt you to deploy a new gateway.

Nota

Questi contatori non acquisiscono la durata dell'attività specifica.These counters will not capture specific task duration time.

Il contatore del gateway, oltre ai contatori del computer, offre un'idea della quantità di carico gestita dal computer e può indicare se la capacità di risorse del server viene estesa o superata.The gateway counter, in addition to your machine's counters, provide you with an idea of how much load your machine is handling, and can provide an indication of whether the server resource capacity is becoming stretched or exceeded.

È possibile accedere a questi contatori da Windows Performance Monitor e utilizzarli da qualsiasi strumento di creazione report utile a questo scopo.These counters can be accessed from Windows Performance Monitor, and can be consumed by any reporting tools you use for this purpose. Per una panoramica dettagliata dell'uso del monitor delle prestazioni del gateway con Power BI, leggere il seguente post di blog creato dalla community.For a detailed walk-through of how to use the gateway performance monitor with Power BI, take a look at the following community-create blog post.

LogLogs

I log di configurazione e servizio offrono un'altra dimensione su quanto avviene nel gateway.Configuration and service logs provide another dimension on what's happening with your gateway. Verificare sempre i log del gateway quando la connessione non funziona come previsto, perché non tutti i messaggi di errore emergono nel servizio Power BI.Always check your gateway logs when your connection is not working as expected, as not all error messages are surfaced on the Power BI service.

Un modo semplice per visualizzare tutti i file di log nel computer locale consiste nell'usare il pulsante Esporta log nel gateway dati locale quando si apre nuovamente il gateway dopo che l'installazione iniziale è stata completata, quindi selezionare Diagnostica > Esporta log.An easy way to view all the log files on your local machine is to use the Export Logs button on the on-premises data gateway when you re-open the gateway after the initial installation is complete, and then select Diagnostics > Export Logs.

Registrazione aggiuntivaAdditional logging

Per impostazione predefinita il gateway esegue la registrazione di base.By default the gateway performs basic logging. Se si sta ricercando la causa di problemi del gateway e servono altre informazioni sui dettagli di connessione di query, è possibile abilitare temporaneamente la registrazione dettagliata per raccogliere informazioni di log aggiuntive.If you're investigating gateway issues, and need more information about query connection details, you can temporarily enable verbose logging to gather additional log information. A tale scopo, nel gateway installato selezionare Diagnostica > Registrazione aggiuntiva.To do this, in the installed gateway select Diagnostics > Additional logging.

A seconda dell'utilizzo di gateway, l'abilitazione di questa impostazione può aumentare notevolmente le dimensioni del log.Enabling this setting likely will increase the log size significantly, based on gateway usage. Una volta completata l'analisi dei registri, è consigliabile disabilitare la Registrazione aggiuntiva.It's recommended that once you're done reviewing the logs, you disable Additional logging. Non è consigliabile lasciare questa impostazione abilitata durante il normale utilizzo del gateway.It's not recommended to leave this setting enabled during normal gateway usage.

Configurazione di reteNetwork configuration

Il gateway crea una connessione in uscita al Bus di servizio di Azure.The gateway creates an outbound connection to the Azure Service Bus. Il gateway comunica sulle seguenti porte in uscita:The gateway communicates on the following outbound ports:

  • TCP 443 (predefinita)TCP 443 (default)
  • 56715671
  • 56725672
  • Da 9350 a 93549350 thru 9354

Il gateway non richiede porte in entrata.The gateway does not require inbound ports. Tutte le porte richieste sono elencate nell'elenco precedente.All required ports are listed in the above list.

È consigliabile aggiungere all'elenco elementi consentiti nel firewall gli indirizzi IP per l'area dati.It is recommended that you whitelist the IP addresses, for your data region, in your firewall. È possibile scaricare l'elenco di indirizzi, IP, disponibile nell'elenco di IP del data center di Microsoft Azure.You can download list of IP addresses, which are found in the Microsoft Azure Datacenter IP list. Questo elenco viene aggiornato ogni settimana.That list is updated weekly. Il gateway comunicherà con un Bus di servizio di Azure usando l'indirizzo IP specificato insieme al nome di dominio completo (FQDN).The gateway will communicate with Azure Service Bus using the specified IP address, along with the fully qualified domain name (FQDN). Se si impone al gateway di comunicare tramite HTTPS, verrà usato esclusivamente il nome di dominio completo e non avrà luogo alcuna comunicazione usando gli indirizzi IP.If you're forcing the gateway to communicate using HTTPS, the gateway strictly uses FQDN only, and no communication will occur using IP addresses.

Forzare la comunicazione HTTPS con il bus di servizio di AzureForcing HTTPS communication with Azure Service Bus

È possibile imporre al gateway di comunicare con il bus di servizio di Azure usando HTTPS anziché TCP diretto.You can force the gateway to communicate with the Azure Service Bus by using HTTPS, instead of direct TCP. Questo però determina una lieve riduzione delle prestazioni.Doing so will slightly reduce performance. È anche possibile forzare il gateway a comunicare con il bus di servizio di Azure usando HTTPS con l'interfaccia utente del gateway (a partire dalla versione di marzo 2017 del gateway).You can also force the gateway to communicate with the Azure Service Bus by using HTTPS by using the gateway's user interface (beginning with the March 2017 release of the gateway).

A tale scopo, nel gateway selezionare Rete, quindi impostare Modalità di connettività del bus di servizio di Azure su Attiva.To do so, in the gateway select Network, then turn the Azure Service Bus connectivity mode On.

Informazioni aggiuntiveAdditional guidance

Questa sezione contiene indicazioni aggiuntive per la distribuzione e la gestione dei gateway.This section provides additional guidance for deploying and managing gateways.

  • Evitare di avere un singolo punto di errore.Avoid having a single point of failure. Se possibile, distribuire le origini dati locali in gateway diversi; in questo caso, se un computer non è più disponibile, sarà ancora possibile aggiornare parti dei dati e non perdere completamente tale funzionalità.If possible, distribute your on-premises data sources across several gateways; in this case, if one machine becomes unavailable, you'll still be able to refresh portions of your data, and not lose that functionality completely.
  • Il gateway non può essere installato in un controller di dominio, quindi evitare di pianificare o provare questa operazione.The gateway cannot be installed on a domain controller, so don't plan or try to do so.
  • Non installare un gateway in un computer che può essere disattivato, sospeso o non connesso a Internet (ad esempio un portatile), perché il gateway non può essere eseguito in tali circostanze.Don't install a gateway on a computer that may be turned off, go into the sleep mode, or not be connected to the Internet (for example, a laptop computer), because the gateway can't run under any of those circumstances.
  • Evitare di installare un gateway in una rete wireless, perché le prestazioni del gateway potrebbero peggiorare.Avoid installing a gateway on a wireless network, since performance might suffer over a wireless network.

Ripristino del gatewayGateway Recovery

È possibile ripristinare il gateway esistente o spostarlo in un nuovo computer usando la chiave di ripristino,You can recover your existing gateway, or move it to a new machine, using the recovery key. fornita all'utente che installa il gateway, che non può essere cambiata successivamente.The recovery key is provided to the user who installs the gateway, and it cannot be changed later. La chiave di ripristino viene usata per la crittografia dei dati e il ripristino del gateway.The recovery key is used for both data encryption and gateway recovery.

Per ripristinare il gateway, assicurarsi di essere un amministratore del gateway, verificare che si conosca il nome del gateway, verificare di avere la chiave di ripristino corretta e di avere un nuovo computer disponibile con caratteristiche di prestazioni simili.To recover your gateway, make sure you're an admin on the gateway, make sure you know the gateway name, ensure you have the correct recovery key, and that you have a new machine available with similar performance characteristics.

Dopo l'accesso, selezionare l'opzione Migrate an existing gateway (Eseguire la migrazione di un gateway esistente).After you sign in, select the Migrate an existing gateway option. Successivamente, è necessario scegliere il gateway che si vuole ripristinare o di cui eseguire la migrazione e infine specificare la chiave di ripristino, quindi premere Configura.Next, you need to choose the gateway you'd like to recover or migrate, and finally provide the recovery key and hit configure. Al termine di questo passaggio, il gateway precedente verrà sostituito dal nuovo gateway, che erediterà il nome e tutte le origini dati configurate in precedenza.Once that step is done, the old gateway will be replaced by the new gateway, and the new gateway will inherit its name and all data sources previously configured. Tutte le origini dati passeranno dal nuovo computer, senza la necessità di pubblicarle nuovamente.All data sources will now go through the new machine, without the need to re-publish anything. Il failover automatico non è ancora supportato, ma è una funzionalità di cui si sta attivamente occupando il team del gateway.Automatic failover is not yet supported, but it is a feature that the gateway team is actively considering.

AmministratoriAdministrators

È possibile trovare un elenco di amministratori di gateway nel servizio Power BI.You can find a list of gateway administrators in the Power BI service. Dopo aver eseguito l'accesso al servizio Power BI, selezionare Impostazioni (icona a forma di ingranaggio) > Gestisci gateway > interfaccia utente del gateway.When signed into the Power BI service, select Settings (the gear icon) > Manage Gateways > Gateway UI.

Da qui, è possibile selezionare un gateway e visualizzare l'elenco degli amministratori di gateway.From there, you can select a gateway and see the list of gateway administrators. Gli amministratori elencati possono accedere, ripristinare ed eliminare il gateway,The administrators listed can access, recover, and delete the gateway. ma possono anche aggiungere ed eliminare origini dati nel gateway.They can also add and delete data sources in the gateway. Per assicurarsi che tutti gli amministratori dell'organizzazione abbiano accesso a tutti i gateway nel proprio gruppo, si consiglia quanto segue:To make sure all administrators in the organization have access to all gateways in their group, the following is recommended:

  • Creare un gruppo di sicurezza AAD e aggiungervi altri utenti, quindi aggiungere questo gruppo di sicurezza all'elenco dei rispettivi amministratori di gateway.Create an AAD security group and add other users to it, then add this security group to the list of the respective gateway administrators. In questo modo si garantisce che solo una persona possa accedere al gateway in caso di errore o quando è necessario ripristinarlo o eseguirne la migrazione.This ensures that more than one person has access to the gateway in case of a failure, or when you need to recover or migrate the gateway. In più, altri amministratori potranno osservare quali gateway vengono usati nei propri gruppi e quali origini dati esistono in ciascun gateway.This also gives other administrators a view of what gateways are being used in their groups, and which data sources exist on each gateway.

Passaggi successiviNext steps

Configurazione delle impostazioni proxyConfiguring proxy settings
Risoluzione dei problemi del gateway dati localeTroubleshooting the on-premises data gateway
Domande frequenti sul gateway dati localeOn-premises data gateway FAQ

Altre domande?More questions? Provare la community di Power BITry the Power BI Community