Installare il gateway dati locale per le app per la logica di AzureInstall the on-premises data gateway for Azure Logic Apps

Prima che le app per la logica possano accedere alle origini di dati in locale, è necessario installare e configurare il gateway dati locale.Before your logic apps can access data sources on premises, you must install and set up the on-premises data gateway. Il gateway funge da ponte che fornisce il trasferimento rapido dei dati e la crittografia tra sistemi locali e le app per la logica.The gateway acts as a bridge that provides quick data transfer and encryption between on-premises systems and your logic apps. Il gateway inoltra i dati da origini locali sui canali crittografati tramite il bus di servizio di Azure.The gateway relays data from on-premises sources on encrypted channels through the Azure Service Bus. Tutto il traffico ha origine come traffico sicuro in uscita dall'agente di gateway.All traffic originates as secure outbound traffic from the gateway agent. Altre informazioni sul funzionamento del gateway dati.Learn more about how the data gateway works.

Il gateway supporta le connessioni alle origine dati locali seguenti:The gateway supports connections to these data sources on premises:

  • BizTalk Server 2016BizTalk Server 2016
  • DB2DB2
  • File systemFile System
  • InformixInformix
  • MQMQ
  • MySQLMySQL
  • Oracle DatabaseOracle Database
  • PostgreSQLPostgreSQL
  • Server applicazioni SAPSAP Application Server
  • Server messaggi SAPSAP Message Server
  • SharePointSharePoint
  • SQL ServerSQL Server
  • TeradataTeradata

Questa procedura mostra come installare il gateway dati locale prima di impostare una connessione tra il gateway e le app per la logica.These steps show how to first install the on-premises data gateway before you set up a connection between the gateway and your logic apps. Per altre informazioni sui connettori supportati, vedere Connettori per le app per la logica di Azure.For more information about supported connectors, see Connectors for Azure Logic Apps.

Per informazioni su come usare il gateway con altri servizi, vedere i seguenti articoli:For information about how to use the gateway with other services, see these articles:

RequisitiRequirements

Minimo:Minimum:

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

Consigliato:Recommended:

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

Considerazioni importanti:Important considerations:

  • Installare il gateway dati locale solo su un computer locale.Install the on-premises data gateway only on a local computer. Non è possibile installare il gateway in un controller di dominio.You can't install the gateway on a domain controller.

    Suggerimento

    Non è necessario installare il gateway nello stesso computer dell'origine dati.You don't have to install the gateway on the same computer as your data source. Per ridurre al minimo la latenza, è possibile installare il gateway il più vicino possibile all'origine dati o nello stesso computer, presupponendo che si disponga delle autorizzazioni.To minimize latency, you can install the gateway as close as possible to your data source, or on the same computer, assuming that you have permissions.

  • Non installare il gateway su un computer che si disattiva o che non può connettersi a Internet perché il gateway non può essere eseguito in tali circostanze.Don't install the gateway on a computer that turns off, goes to sleep, or doesn't connect to the Internet because the gateway can't run under those circumstances. Le prestazioni del gateway possono anche diminuire su una rete wireless.Also, gateway performance might suffer over a wireless network.

  • Durante l'installazione, è necessario accedere con un account aziendale o dell'istituto di istruzione gestito da Azure Active Directory (Azure AD), non con un account Microsoft.During installation, you must sign in with a work or school account that's managed by Azure Active Directory (Azure AD), not a Microsoft account.

    Suggerimento

    Se si vuole usare un account Microsoft che ha un abbonamento a Visual Studio con MSDN, prima di tutto creare una directory (tenant) in Azure Active Directory con l'account Microsoft oppure usare la directory predefinita.If you want to use a Microsoft account that has a Visual Studio with MSDN subscription, first create a directory (tenant) in Azure Active Directory with your Microsoft account, or use the default directory. Aggiungere un utente con una password per la directory e quindi concedere all'utente l'accesso alla sottoscrizione.Add a user with a password to the directory, then give that user access to your subscription. Sarà quindi possibile accedere durante l'installazione del gateway con questo nome utente e questa password.You can then sign in during gateway installation with this username and password.

    Successivamente sarà necessario usare lo stesso account aziendale o dell'istituto di istruzione nel portale di Azure quando si crea e si associa una risorsa gateway all'installazione del gateway.You must use the same work or school account later in the Azure portal when you create and associate a gateway resource with your gateway installation. Si seleziona quindi la risorsa del gateway quando si crea la connessione tra l'app per la logica e l'origine dati locale.You then select this gateway resource when you create the connection between your logic app and the on-premises data source. Perché è necessario usare un account di Azure AD aziendale o dell'istituto di istruzione?Why must I use an Azure AD work or school account?

    Suggerimento

    Se si è effettuata l'iscrizione a un'offerta di Office 365 senza fornire l'indirizzo di posta elettronica aziendale effettivo, l'indirizzo di accesso sarà simile a jeff@contoso.onmicrosoft.com.If you signed up for an Office 365 offering and didn't supply your actual work email, your sign-in address might look like jeff@contoso.onmicrosoft.com.

  • Se si dispone di un gateway esistente impostato con un programma di installazione che è precedente alla versione 14.16.6317.4, non è possibile modificare il percorso del gateway eseguendo il programma di installazione più recente.If you have an existing gateway that you set up with an installer that's earlier than version 14.16.6317.4, you can't change your gateway's location by running the latest installer. Tuttavia, è possibile usare il programma di installazione più recente per configurare un nuovo gateway con il percorso che si desidera.However, you can use the latest installer to set up a new gateway with the location that you want instead.

    Se si dispone di un programma di installazione di gateway che è precedente alla versione 14.16.6317.4, ma non è ancora stato installato il gateway, è possibile scaricare e usare il programma di installazione più recente.If you have a gateway installer that's earlier than version 14.16.6317.4, but you haven't installed your gateway yet, you can download and use the latest installer.

Installare il gateway datiInstall the data gateway

  1. Scaricare ed eseguire il programma di installazione di gateway in un computer locale.Download and run the gateway installer on a local computer.

  2. Leggere e accettare le condizioni per l'utilizzo e l'informativa sulla privacy.Review and accept the terms of use and privacy statement.

  3. Specificare il percorso nel computer locale in cui si desidera installare il gateway.Specify the path on your local computer where you want to install the gateway.

  4. Quando richiesto, accedere con il proprio account aziendale o dell'istituzione di istruzione di Azure, non con un account Microsoft.When prompted, sign in with your Azure work or school account, not a Microsoft account.

    Accedere con l'account aziendale o dell'istituto di istruzione di Azure

  5. Ora registrare il gateway installato con il servizio cloud gateway.Now register your installed gateway with the gateway cloud service. Scegliere l'opzione che consente di registrare un nuovo gateway in questo computer.Choose Register a new gateway on this computer.

    Il servizio cloud gateway crittografa e archivia le credenziali dell'origine dati e i dettagli del gateway.The gateway cloud service encrypts and stores your data source credentials and gateway details. Il servizio instrada anche le query e i relativi risultati tra l'app per la logica, il gateway dati locale e l'origine dati in locale.The service also routes queries and their results between your logic app, the on-premises data gateway, and your data source on premises.

  6. Specificare un nome per l'installazione del gateway.Provide a name for your gateway installation. Creare una chiave di ripristino, quindi confermarla.Create a recovery key, then confirm your recovery key.

    Importante

    La chiave di ripristino deve contenere almeno otto caratteri.Your recovery key must contain at least eight characters. Assicurarsi di salvare e conservare la chiave in un luogo sicuro.Make sure that you save and keep the key in a safe place. Questa chiave è necessaria anche per eseguire la migrazione, ripristinare o acquisire la proprietà di un gateway esistente.You also need this key when you want to migrate, restore, or take over an existing gateway.

    1. Per modificare l'area predefinita per il servizio cloud gateway e per il bus di servizio di Azure usato per l'installazione del gateway, scegliere Cambia area.To change the default region for the gateway cloud service and Azure Service Bus used by your gateway installation, choose Change Region.

      Cambiare area

      L'area predefinita è l'area associata al tenant di Azure AD.The default region is the region associated with your Azure AD tenant.

    2. Nel riquadro successivo aprire Selezionare l'area per scegliere un'area diversa.On the next pane, open the Select Region to choose a different region.

      Selezionare un'altra area

      Si potrebbe ad esempio selezionare la stessa area come app per la logica o selezionare l'area più vicina all'origine dati in locale in modo da ridurre la latenza.For example, you might select the same region as your logic app, or select the region closest to your on-premises data source so you can reduce latency. Le risorse gateway e l'app per la logica possono avere posizioni diverse.Your gateway resource and logic app can have different locations.

      Importante

      Dopo l'installazione non è possibile modificare questa area.You can't change this region after installation. L'area determina e limita anche la posizione in cui è possibile creare la risorsa di Azure per il gateway.This region also determines and restricts the location where you can create the Azure resource for your gateway. Pertanto, quando si crea la risorsa del gateway in Azure, assicurarsi che il percorso della risorsa corrisponda all'area selezionata durante l'installazione del gateway.So when you create your gateway resource in Azure, make sure that the resource location matches the region that you selected during gateway installation.

      Se si desidera usare un'area diversa per il gateway in un secondo momento, è necessario configurare un nuovo gateway.If you want to use a different region for your gateway later, you must set up a new gateway.

    3. Al termine, scegliere Fine.When you're ready, choose Done.

  7. Seguire ora la procedura seguente nel portale di Azure per creare una risorsa di Azure per il gateway.Now follow these steps in the Azure portal so you can create an Azure resource for your gateway.

Altre informazioni sul funzionamento del gateway dati.Learn more about how the data gateway works.

Eseguire la migrazione, ripristinare o sostituire un gateway esistenteMigrate, restore, or take over an existing gateway

Per eseguire queste attività, è necessario disporre della chiave di ripristino che è stata specificata all'installazione del gateway.To perform these tasks, you must have the recovery key that was specified when the gateway was installed.

  1. Dal menu di avvio del computer, scegliere Gateway dati locale.From your computer's Start menu, choose On-premises data gateway.

  2. Quando viene aperto il programma di installazione accedere con lo stesso account di Azure aziendale o dell'istituto di istruzione usato in precedenza per installare il gateway.After the installer opens, sign in with the same Azure work or school account that was previously used to install the gateway.

  3. Scegliere Eseguire la migrazione, ripristinare o acquisire la proprietà di un gateway esistente.Choose Migrate, restore, or take over an existing gateway.

  4. Specificare la chiave di ripristino per il gateway di cui si vuole eseguire la migrazione o il ripristino o acquisire la proprietà.Provide the name and recovery key for the gateway that you want to migrate, restore, or take over.

Account del servizio WindowsWindows service account

Il gateway dati locale viene eseguito come servizio di Windows ed è configurato per usare NT SERVICE\PBIEgwService come credenziali di accesso al servizio di Windows.The on-premises data gateway runs as a Windows service and is set up to use NT SERVICE\PBIEgwService for the Windows service logon credentials. Per impostazione predefinita, il gateway ha il diritto di "Accesso come servizio", per il computer in cui si installa il gateway.By default, the gateway has the "Log on as a service" right for the machine where you install the gateway. Per creare e gestire il gateway nel portale di Azure, l'account del servizio di Windows deve avere almeno autorizzazioni di Collaboratore.To create and maintain the gateway in the Azure portal, the Windows service account must have at least Contributor permissions.

Nota

Questo account del servizio Windows è diverso dall'account usato per la connessione a origini dati locali e dall'account di Azure aziendale o dell'istituto di istruzione usato per accedere ai servizi cloud.The Windows service account differs from the account used for connecting to on-premises data sources, and from the Azure work or school account used to sign in to cloud services.

Riavviare il gatewayRestart the gateway

Come qualsiasi altro servizio Windows, può essere avviato e arrestato in diversi modi.Like any other Windows service, you can start and stop the service in multiple ways. Ad esempio, è possibile aprire un prompt dei comandi con autorizzazioni elevate nel computer in cui è in esecuzione il gateway e quindi eseguire uno dei comandi seguenti:For example, you can open a command prompt with elevated permissions on the computer where the gateway is running, and run either these commands:

  • Per arrestare il servizio, eseguire questo comando:To stop the service, run this command:

    net stop PBIEgwService

  • Per avviare il servizio, eseguire questo comando:To start the service, run this command:

    net start PBIEgwService

Configurare un firewall o proxyConfigure a firewall or proxy

Il gateway crea una connessione in uscita al bus di servizio di Azure.The gateway creates an outbound connection to Azure Service Bus. Per fornire al gateway informazioni sul proxy, vedere Configurazione delle impostazioni proxy.To provide proxy information for your gateway, see Configure proxy settings.

Per verificare se il firewall, o proxy, potrebbe bloccare le connessioni, verificare che il computer riesca effettivamente a connettersi a Internet e al bus di servizio di Azure.To check whether your firewall, or proxy, might block connections, confirm whether your machine can actually connect to the internet and the Azure Service Bus. Da un prompt di PowerShell eseguire questo comando:From a PowerShell prompt, run this command:

Test-NetConnection -ComputerName watchdog.servicebus.windows.net -Port 9350

Nota

Questo comando verifica solo la connettività di rete e la connettività per il bus di servizio di Azure.This command only tests network connectivity and connectivity to the Azure Service Bus. Pertanto, il comando non ha nulla a che fare con il gateway o con il servizio cloud del gateway che crittografa e archivia le credenziali e i dettagli di gateway.So the command doesn't have anything to do with the gateway or the gateway cloud service that encrypts and stores your credentials and gateway details.

Questo comando è disponibile solo in Windows Server 2012 R2 o in una versione successiva e in Windows 8.1 o in una versione successiva.Also, this command is only available on Windows Server 2012 R2 or later, and Windows 8.1 or later. Nelle versioni precedenti del sistema operativo, è possibile usare Telnet per testare la connettività.On earlier OS versions, you can use Telnet to test connectivity. Altre informazioni su bus di servizio di Azure e soluzioni ibride.Learn more about Azure Service Bus and hybrid solutions.

I risultati dovrebbero essere simili all'esempio seguente:Your results should look similar to this example:

ComputerName           : watchdog.servicebus.windows.net
RemoteAddress          : 70.37.104.240
RemotePort             : 5672
InterfaceAlias         : vEthernet (Broadcom NetXtreme Gigabit Ethernet - Virtual Switch)
SourceAddress          : 10.120.60.105
PingSucceeded          : False
PingReplyDetails (RTT) : 0 ms
TcpTestSucceeded       : True

Se TcpTestSucceeded non è impostato su True, il firewall potrebbe essere la causa del blocco.If TcpTestSucceeded is not set to True, you might be blocked by a firewall. Per la massima completezza sostituire i valori ComputerName e Porta con quelli elencati in Configurare le porte in questo argomento.If you want to be comprehensive, substitute the ComputerName and Port values with the values listed under Configure ports in this topic.

Il firewall può anche bloccare le connessioni tra il bus di servizio e i data center di Azure.The firewall might also block connections that the Azure Service Bus makes to the Azure datacenters. Se si verifica questo scenario, approvare (sbloccare) tutti gli indirizzi IP per i data center nell'area geografica.If this scenario happens, approve (unblock) all the IP addresses for those datacenters in your region. Per gli indirizzi IP, ottenere l'elenco di indirizzi IP Azure qui.For those IP addresses, get the Azure IP addresses list here.

Configurare le porteConfigure ports

Il gateway crea una connessione in uscita al Bus di servizio di Azure e comunica sulle porte in uscita: TCP 443 (predefinita), 5671, 5672, 9350 attraverso 9354.The gateway creates an outbound connection to Azure Service Bus and communicates on outbound ports: TCP 443 (default), 5671, 5672, 9350 through 9354. Non sono richieste porte in ingresso.The gateway doesn't require inbound ports. Altre informazioni su bus di servizio di Azure e soluzioni ibride.Learn more about Azure Service Bus and hybrid solutions.

NOMI DI DOMINIODOMAIN NAMES PORTE IN USCITAOUTBOUND PORTS DescrizioneDESCRIPTION
. analysis.windows.net.analysis.windows.net 443443 HTTPSHTTPS
.login.windows.net.login.windows.net 443443 HTTPSHTTPS
.servicebus.windows.net.servicebus.windows.net 5671-56725671-5672 Advanced Message Queuing Protocol (AMQP)Advanced Message Queuing Protocol (AMQP)
.servicebus.windows.net.servicebus.windows.net 443, 9350-9354443, 9350-9354 Listener in Inoltro del Bus di servizio su TCP (richiede 443 per l'acquisizione del token di Controllo di accesso)Listeners on Service Bus Relay over TCP (requires 443 for Access Control token acquisition)
.frontend.clouddatahub.net.frontend.clouddatahub.net 443443 HTTPSHTTPS
.core.windows.net.core.windows.net 443443 HTTPSHTTPS
login.microsoftonline.comlogin.microsoftonline.com 443443 HTTPSHTTPS
.msftncsi.com.msftncsi.com 443443 Usato per testare la connettività a Internet se il gateway non è raggiungibile dal servizio Power BI.Used to test internet connectivity when the gateway is unreachable by the Power BI service.

Se è necessario approvare gli indirizzi IP anziché i domini, è possibile scaricare e usare l'elenco di intervalli IP dei data center di Microsoft Azure.If you have to approve IP addresses instead of the domains, you can download and use the Microsoft Azure Datacenter IP ranges list. In alcuni casi, le connessioni al Bus di servizio di Azure verranno stabilite con l'indirizzo IP anziché con i nomi di dominio completo.In some cases, the Azure Service Bus connections are made with IP Address rather than fully qualified domain names.

Come funziona il gateway dati?How does the data gateway work?

Il gateway dati facilita la comunicazione rapida e sicura tra l'app per la logica, il servizio cloud del gateway e l'origine dati locale.The data gateway facilitates quick and secure communication between your logic app, the gateway cloud service, and your on-premises data source.

diagram-for-on-premises-data-gateway-flow

Pertanto quando l'utente nel cloud interagisce con un elemento connesso a un'origine dati in locale:So when the user in the cloud interacts with an element that's connected to your on-premises data source:

  1. Il servizio cloud del gateway crea una query, insieme alle credenziali crittografate per l'origine dati, e invia la query alla coda affinché venga elaborata dal gateway.The gateway cloud service creates a query, along with the encrypted credentials for the data source, and sends the query to the queue for the gateway to process.

  2. Il servizio cloud del gateway analizza la query e inserisce la richiesta nel bus di servizio di Azure.The gateway cloud service analyzes the query and pushes the request to the Azure Service Bus.

  3. Il gateway dati locale esegue il polling del bus di servizio per le richieste in sospeso.The on-premises data gateway polls the Azure Service Bus for pending requests.

  4. Il gateway riceve la query, decrittografa le credenziali e le usa per la connessione alle origini dati.The gateway gets the query, decrypts the credentials, and connects to the data source with those credentials.

  5. Invia quindi la query all'origine dati per l'esecuzione.The gateway sends the query to the data source for execution.

  6. I risultati vengono quindi inviati dall'origine dati al gateway e quindi al servizio cloud del gateway.The results are sent from the data source, back to the gateway, and then to the gateway cloud service. Infine, il servizio cloud del gateway usa i risultati.The gateway cloud service then uses the results.

Domande frequentiFrequently asked questions

GeneraleGeneral

D: È necessario un gateway per le origini dati nel cloud, ad esempio SQL Azure?Q: Do I need a gateway for data sources in the cloud, such as SQL Azure?
R: No. A: No. Il gateway si connette solo alle origini dati locali.A gateway connects to on-premises data sources only.

D: Il gateway deve essere installato nello stesso computer dell'origine dati?Q: Does the gateway have to be installed on the same machine as the data source?
R: No. A: No. Il gateway si connette all'origine dati tramite le informazioni di connessione fornite.The gateway connects to the data source using the connection information that was provided. In questo senso il gateway può essere paragonato a un'applicazione client.Consider the gateway as a client application in this sense. Il gateway deve solo potersi connettere al nome del server specificato.The gateway just needs the capability to connect to the server name that was provided.

D: Perché è necessario usare un account di Azure aziendale o dell'istituto di istruzione per accedere?Q: Why must I use an Azure work or school account to sign in?
R: È possibile usare solo un account di Azure aziendale o dell'istituto di istruzione quando si installa il gateway dati locale. A: You can only use an Azure work or school account when you install the on-premises data gateway. L'account di accesso viene archiviato in un tenant gestito da Azure Active Directory (Azure AD).Your sign-in account is stored in a tenant that's managed by Azure Active Directory (Azure AD). Il nome dell'entità utente (UPN) dell'account di Azure AD in genere corrisponde all'indirizzo di posta elettronica.Usually, your Azure AD account's user principal name (UPN) matches the email address.

D: Dove sono archiviate le credenziali?Q: Where are my credentials stored?
R: Le credenziali immesse per un'origine dati vengono crittografate e archiviate nel servizio cloud del gateway. A: The credentials that you enter for a data source are encrypted and stored in the gateway cloud service. Le credenziali vengono quindi decrittografate nel gateway dati locale.The credentials are decrypted at the on-premises data gateway.

D: Sono previsti requisiti per la larghezza di banda della rete?Q: Are there any requirements for network bandwidth?
R: È consigliabile che la connessione di rete abbia una buona velocità effettiva. A: We recommend that your network connection has good throughput. Ogni ambiente è diverso e la quantità di dati inviati influisce sui risultati.Every environment is different, and the amount of data being sent affects the results. L'uso di ExpressRoute può contribuire a garantire un livello di velocità effettiva tra i data center di Azure e quelli locali.Using ExpressRoute could help to guarantee a level of throughput between on-premises and the Azure datacenters. Lo strumenti di terze parti Azure Speed Test può aiutare a valutare la velocità effettiva.You can use the third-party tool Azure Speed Test app to help gauge your throughput.

D: Qual è la latenza per l'esecuzione di query a un'origine dati dal gateway?Q: What is the latency for running queries to a data source from the gateway? Qual è l'architettura ottimale?What is the best architecture?
R: Per ridurre la latenza di rete è consigliabile installare il gateway il più vicino possibile all'origine dati. A: To reduce network latency, install the gateway as close to the data source as possible. Installando il gateway nell'origine dati effettiva, la latenza introdotta risulterà ridotta al minimo grazie a questa prossimità.If you can install the gateway on the actual data source, this proximity minimizes the latency introduced. Si considerino anche i data center.Consider the datacenters too. Se, ad esempio, il servizio usa il data center degli Stati Uniti occidentali e SQL Server è ospitato in una macchina virtuale di Azure, è opportuno che anche la macchina virtuale di Azure sia ubicata negli Stati Uniti occidentali.For example, if your service uses the West US datacenter, and you have SQL Server hosted in an Azure VM, your Azure VM should be in the West US too. Grazie a questa prossimità la latenza è ridotta al minimo e si evitano addebiti relativi ai dati in uscita sulla macchina virtuale di Azure.This proximity minimizes latency and avoids egress charges on the Azure VM.

D: In che modo i risultati vengono inviati al cloud?Q: How are results sent back to the cloud?
R: I risultati vengono inviati tramite il Bus di servizio di Azure. A: Results are sent through the Azure Service Bus.

D: Esistono connessioni in ingresso al gateway dal cloud?Q: Are there any inbound connections to the gateway from the cloud?
R: No. A: No. Il gateway usa le connessioni in uscita al bus di servizio di Azure.The gateway uses outbound connections to Azure Service Bus.

D: Cosa accade se si bloccano le connessioni in uscita?Q: What if I block outbound connections? Cosa fare per sbloccarle?What do I need to open?
R: Visualizzare le porte e gli host usati dal gateway. A: See the ports and hosts that the gateway uses.

D: Come viene chiamato il servizio Windows effettivo?Q: What is the actual Windows service called?
R: Nei servizi il gateway è denominato servizio Power BI Gateway Enterprise. A: In Services, the gateway is called Power BI Enterprise Gateway Service.

D: Il servizio gateway di Windows può essere eseguito con un account Azure Active Directory?Q: Can the gateway Windows service run with an Azure Active Directory account?
R: No. A: No. Il servizio Windows deve disporre di un account Windows valido.The Windows service must have a valid Windows account. Per impostazione predefinita, il sevizio viene eseguito con il SID servizio NT SERVICE\PBIEgwService.By default, the service runs with the Service SID, NT SERVICE\PBIEgwService.

Disponibilità elevata e ripristino di emergenzaHigh availability and disaster recovery

D: Quali opzioni sono disponibili per il ripristino di emergenza?Q: What options are available for disaster recovery?
R: È possibile usare la chiave di ripristino per ripristinare o spostare un gateway. A: You can use the recovery key to restore or move a gateway. La chiave di ripristino viene specificata al momento dell'installazione del gateway.When you install the gateway, specify the recovery key.

D: Qual è il vantaggio della chiave di ripristino?Q: What is the benefit of the recovery key?
R: La chiave di ripristino consente di eseguire la migrazione o di ripristinare le impostazioni del gateway in caso di emergenza. A: The recovery key provides a way to migrate or recover your gateway settings after a disaster.

D: Esistono piani per l'abilitazione di scenari a disponibilità elevata con il gateway?Q: Are there any plans for enabling high availability scenarios with the gateway?
R: Questi scenari verranno implementati in futuro, ma non è ancora stato definito quando. A: These scenarios are on the roadmap, but we don't have a timeline yet.

Risoluzione dei problemiTroubleshooting

D: perché la posizione del gateway esistente è cambiata?Q: Why did the location for my existing gateway change?
R: le risorse gateway create prima del 3 maggio 2017 sono state spostate nelle posizioni originali del tenant di Azure AD relativo all'account aziendale o dell'istituto di istruzione che ha creato i gateway. A: Gateway resources created before May 3, 2017 were moved to the original locations of the Azure AD tenant for the work or school account that created those gateways. Queste modifiche non dovrebbero tuttavia interessare le app per la logica attualmente in esecuzione, che continueranno a funzionare come di consueto.However, these changes shouldn't affect currently running logic apps, which should continue working as usual. Con la disponibilità generale del gateway nel mese di maggio, le posizioni delle risorse gateway possono differire da quelle delle app per la logica.With the gateway's general availability in May, gateway resource locations can differ from logic app locations.

D: Come è possibile visualizzare le query inviate all'origine dati locale?Q: How can I see what queries are being sent to the on-premises data source?
R: È possibile abilitare la funzione di tracciamento delle query, che include le query inviate. A: You can enable query tracing, which includes the queries that are sent. Dopo aver risolto il problema, ripristinare il valore originale per il tracciamento delle query.Remember to change query tracing back to the original value when done troubleshooting. Se il tracciamento delle query non viene disabilitato, si creeranno dei log più grandi.Leaving query tracing turned on creates larger logs.

È anche possibile usare gli strumenti per il tracciamento delle query di cui è dotata l'origine dati.You can also look at tools that your data source has for tracing queries. Ad esempio, è possibile usare Eventi estesi o SQL Profiler per SQL Server e Analysis Services.For example, you can use Extended Events or SQL Profiler for SQL Server and Analysis Services.

D: Dove si trovano i log del gateway?Q: Where are the gateway logs?
R: Vedere la sezione Strumenti più avanti in questo argomento. A: See Tools later in this topic.

Aggiornare alla versione più recenteUpdate to the latest version

Quando la versione del gateway non è aggiornata, possono emergere numerosi problemi.Many issues can surface when the gateway version becomes outdated. Come buona pratica, assicurarsi di usare la versione più recente.As good general practice, make sure that you use the latest version. Se il gateway non è stato aggiornato per un mese o più è consigliabile installarne la versione più recente e verificare se è possibile riprodurre il problema.If you haven't updated the gateway for a month or longer, you might consider installing the latest version of the gateway, and see if you can reproduce the issue.

Errore: Impossibile aggiungere l'utente al gruppo.Error: Failed to add user to group. (Utenti log delle prestazioni -2147463168 PBIEgwService)(-2147463168 PBIEgwService Performance Log Users)

Questo errore viene visualizzato se si sta tentando di installare il gateway in un controller di dominio, un'operazione non consentita.You might get this error if you try to install the gateway on a domain controller, which isn't supported. Assicurarsi di distribuire il gateway in un computer che non sia un controller di dominio.Make sure that you deploy the gateway on a machine that isn't a domain controller.

StrumentiTools

Raccolta di log dallo strumento di configurazione del gatewayCollect logs from the gateway configurer

È possibile raccogliere numerosi log per il gateway.You can collect several logs for the gateway. La raccolta dei log è sempre la prima operazione da eseguire.Always start with the logs!

Log dei programmi di installazioneInstaller logs

%localappdata%\Temp\Power_BI_Gateway_–Enterprise.log

Log di configurazioneConfiguration logs

%localappdata%\Microsoft\Power BI Enterprise Gateway\GatewayConfigurator.log

Log del servizio gateway EnterpriseEnterprise gateway service logs

C:\Users\PBIEgwService\AppData\Local\Microsoft\Power BI Enterprise Gateway\EnterpriseGateway.log

Log eventiEvent logs

I log di Gateway di gestione dati e PowerBIGateway sono reperibili in Registri applicazioni e servizi.You can find the Data Management Gateway and PowerBIGateway logs under Application and Services Logs.

Fiddler TraceFiddler Trace

Fiddler è uno strumento gratuito di Telerik che consente di monitorare il traffico HTTP.Fiddler is a free tool from Telerik that monitors HTTP traffic. Dal computer client è possibile visualizzare il traffico con il sevizio Power BI e il computer client.You can see this traffic with the Power BI service from the client machine. Questo servizio consente di visualizzare errori e altre informazioni correlate.This service might show errors and other related information.

Passaggi successiviNext steps