Clusters de alta disponibilidade para gateway de dados locaisHigh availability clusters for On-premises data gateway

Esta página é útil?

Você pode criar clusters de alta disponibilidade de instalações de gateway de dados locais, para garantir que sua organização possa acessar recursos de dados locais usados em relatórios e painéis do Power BI.You can create high availability clusters of On-premises data gateway installations, to ensure your organization can access on-premises data resources used in Power BI reports and dashboards. Esses clusters permitem que os administradores de gateway agrupem gateways para evitar pontos únicos de falha ao acessar os recursos de dados locais.Such clusters allow gateway administrators to group gateways to avoid single points of failure in accessing on-premises data resources. O serviço do Power BI sempre usa o gateway primário do cluster, a menos que ele não esteja disponível.The Power BI service always uses the primary gateway in the cluster, unless it’s not available. Nesse caso, o serviço muda para o próximo gateway do cluster e assim por diante.In that case, the service switches to the next gateway in the cluster, and so on.

Este artigo descreve as etapas a serem seguidas para criar um cluster de alta disponibilidade de gateways de dados locais e compartilha práticas recomendadas ao configurá-los.This article describes the steps you can take to create a high availability cluster of On-premises data gateways and shares best practices when setting them up. Os clusters de gateway de alta disponibilidade requerem a atualização de novembro de 2017 para o gateway de dados locais, ou posterior.High availability gateway clusters require the November 2017 update to On-premises data gateway, or later.

Configuração de clusters de alta disponibilidade de gatewaysSetting up high availability clusters of gateways

Durante o processo de instalação do gateway de dados locais, você pode especificar se o gateway deve ser adicionado a um cluster existente do gateway.During the On-premises data gateway installation process, you can specify whether the gateway should be added to an existing gateway cluster.

Para adicionar um gateway a um cluster existente, é necessário fornecer a Chave de recuperação da instância de gateway primário para o cluster em que você deseja ingressar o novo gateway.To add a gateway to an existing cluster, you must provide the Recovery key for the primary gateway instance for the cluster you want the new gateway to join. O gateway primário para o cluster deve estar executando a atualização do gateway de novembro de 2017 ou posterior.The primary gateway for the cluster must be running the gateway update from November 2017 or later.

Gerenciar um cluster de gatewayManaging a gateway cluster

Quando um cluster de gateway consiste em dois ou mais gateways, todas as operações de gerenciamento de gateway, como adicionar uma fonte de dados ou conceder permissões administrativas para um gateway, se aplicam a todos os gateways que fazem parte do cluster.Once a gateway cluster consists of two or more gateways, all gateway management operations, such as adding a data source or granting administrative permissions to a gateway, apply to all gateways that are part of the cluster.

Quando os administradores usam o item do menu Gerenciar gateways encontrado sob o ícone de engrenagem no Serviço do Power BI, eles veem a lista de clusters registrados ou gateways individuais, mas não veem as instâncias individuais de gateway que são membros do cluster.When administrators use the Manage gateways menu item, found under the gear icon in the Power BI service, they see the list of registered clusters or individual gateways, but do not see the individual gateway instances that are members of the cluster.

Todas as novas solicitações de Atualização Agendada e operações de DirectQuery são automaticamente direcionadas para a instância primária de um cluster de gateways específico.All new Scheduled Refresh requests and DirectQuery operations are automatically routed to the primary instance of a given gateway cluster. Se a instância do gateway primário não estiver online, a solicitação é encaminhada para outra instância de gateway no cluster.If the primary gateway instance is not online, the request is routed to another gateway instance in the cluster.

Distribuir o tráfego de solicitações entre todos os gateways em um clusterDistribute requests traffic across all gateways in a cluster

É possível optar por permitir que o tráfego seja distribuído entre todos os gateways em um cluster.You can choose to allow traffic to be distributed across all gateways in a cluster. Na página Gerenciar gateways no serviço do Power BI, quando você clica em um cluster de gateway na lista na árvore de navegação à esquerda, é possível habilitar a opção para "Distribuir solicitações entre todos os gateways ativos neste cluster".In the Manage gateways page in the Power BI service, when you click on a gateway cluster in the list on the left navigation tree, you can enable the option to "Distribute requests across all active gateways in this cluster."

Balancear carga

Suporte do PowerShell para clusters de gatewayPowerShell support for gateway clusters

Os scripts do PowerShell estão disponíveis na pasta de instalação do gateway de dados locais.PowerShell scripts are available in the On-premises data gateway installation folder. Por padrão, esse arquivo está localizado em C:\Arquivos de Programas\Gateway de dados locais.By default, that folder is C:\Program Files\On-premises data gateway. É necessário estar usando o PowerShell versão 5 ou mais recente para que esses scripts funcionem corretamente.You must be using PowerShell version 5 or newer for these scripts to work correctly. Os scripts do PowerShell permitem que os usuários executem as seguintes operações:The PowerShell scripts let users perform the following operations:

  • Recuperar a lista de clusters de gateway disponíveis para um usuárioRetrieve the list of gateway clusters available for a user
  • Recuperar a lista de instâncias de gateway registradas em um cluster, bem como seu status online ou offlineRetrieve the list of gateway instances registered in a cluster, as well as their online or offline status
  • Modificar o status habilitar/desabilitar para uma instância de gateway em um cluster, bem como outras propriedades do gatewayModify the enable/disable status for a gateway instance within a cluster, as well as other gateway properties
  • Excluir um gatewayDelete a gateway

Para executar os comandos do PowerShell na tabela, primeiro é necessário seguir as etapas abaixo:To run the PowerShell commands in the table, you first need to take the following steps: :

  1. Abra uma janela de comando do PowerShell como AdministradorOpen a PowerShell command window, as an Administrator

  2. Em seguida, execute o seguinte comando do PowerShell que deve ser executado somente uma vez (isso pressupõe que você nunca executou comandos do PowerShell no computador atual):Then run the following one-time PowerShell command (this presumes you've never run PowerShell commands on the current machine):

    Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Force
    
  3. Em seguida, navegue até a pasta de instalação do gateway de dados local na janela do PowerShell e importe o módulo necessário usando o seguinte comando:Next, navigate to the On-premises data gateway installation folder in the PowerShell window, and import the necessary module using the following command:

    Import-Module .\OnPremisesDataGatewayHAMgmt.psm1
    

Quando essas etapas forem concluídas, é possível usar os comandos na tabela a seguir para gerenciar os clusters do gateway.Once those steps are complete, you can use the commands in the following table to manage your gateway clusters.

ComandoCommand DescriçãoDescription ParâmetrosParameters
Login-OnPremisesDataGatewayLogin-OnPremisesDataGateway Este comando permite que um usuário faça logon para gerenciar seus clusters de gateway de dados locais.This command allows a user to log in to manage his or her On-premises data gateway clusters. Você deve executar este comando e entrar antes que outros comandos de alta disponibilidade possam funcionar corretamente.You must run this command and log in before other high availability commands can work properly. Observação: o token de autenticação do AAD adquirido como parte de uma chamada de logon é válido somente por 1 hora, após a qual ele expira.Note: the AAD auth token acquired as part of a Login call is only valid for 1 hour, after which it expires. Você pode executar novamente o comando de logon para adquirir um novo token.You can re-run the Login command to acquire a new token. Nome e senha do usuário do AAD (fornecidos como parte da execução do comando, invocação não inicial)AAD username and password (provided as part of the command execution, not initial invocation)
Get-OnPremisesDataGatewayClustersGet-OnPremisesDataGatewayClusters Recupera a lista de clusters do gateway para o usuário conectado.Retrieves the list of gateway clusters for the logged in user. Ou é possível passar parâmetros de formatação para esse comando para ter melhor legibilidade, como Format-Table -AutoSize -WrapOptionally, you can pass formatting parameters to this command for better readability, such as Format-Table -AutoSize -Wrap
Get-OnPremisesDataClusterGatewaysGet-OnPremisesDataClusterGateways Recupera a lista de gateways dentro do cluster especificado, bem como informações adicionais para cada gateway (status online/offline, nome do computador, etc.)Retrieves the list of gateways within the specified cluster, as well as additional information for each gateway (online/offline status, machine name, so on) -ClusterObjectID xyz (onde xyz é substituído por um valor de ID de objeto do cluster real, que pode ser recuperado usando o comando Get-OnPremisesDataGatewayClusters)-ClusterObjectID xyz (where xyz is replaced with an actual cluster object ID value, which can be retrieved using the Get-OnPremisesDataGatewayClusters command)
Set-OnPremisesDataGatewaySet-OnPremisesDataGateway Permite que você defina valores de propriedade para um determinado gateway em um cluster, incluindo a capacidade de habilitar/desabilitar uma instância de gateway específicaLets you set property values for a given gateway within a cluster, including the ability to Enable/Disable a specific gateway instance -ClusterObjectID xyz (xyz deve ser substituído por um valor de ID de objeto do cluster real, que pode ser recuperado usando o comando Get-OnPremisesDataGatewayClusters) -GatewayObjectID abc (abc deve ser substituído por um valor de ID de objeto do gateway real, que pode ser recuperado usando o comando Get-OnPremisesDataClusterGateways, dada uma ID de objeto do cluster)-ClusterObjectID xyz (xyz, should be replaced with an actual cluster object ID value, which can be retrieved using the Get-OnPremisesDataGatewayClusters command) -GatewayObjectID abc (abc should be replaced with an actual gateway object ID value, which can be retrieved using the Get-OnPremisesDataClusterGateways command, given a cluster object ID)
Get-OnPremisesDataGatewayStatusGet-OnPremisesDataGatewayStatus Permite que você recupere o status de uma instância de gateway específica em um clusterLets you retrieve the status for a given gateway instance within a cluster -ClusterObjectID xyz (xyz deve ser substituído por um valor de ID de objeto do cluster real, que pode ser recuperado usando o comando Get-OnPremisesDataGatewayClusters) -GatewayObjectID abc (abc deve ser substituído por um valor de ID de objeto do gateway real, que pode ser recuperado usando o comando Get-OnPremisesDataClusterGateways, dada uma ID de objeto do cluster)-ClusterObjectID xyz (xyz should be replaced with an actual cluster object ID value, which can be retrieved using the Get-OnPremisesDataGatewayClusters command) -GatewayObjectID abc (abc should be replaced with an actual gateway object ID value, which can be retrieved using the Get-OnPremisesDataClusterGateways command, given a cluster object ID)
Remove-OnPremisesDataGatewayRemove-OnPremisesDataGateway Permite que você remova uma instância de gateway de um cluster – observe que o gateway primário no cluster não pode ser removido até que todos os outros gateways no cluster sejam removidos.Lets you remove a gateway instance from a cluster - note that the primary gateway in the cluster cannot be removed until all other gateways in the cluster are removed. -ClusterObjectID xyz (xyz deve ser substituído por um valor de ID de objeto do cluster real, que pode ser recuperado usando o comando Get-OnPremisesDataGatewayClusters) -GatewayObjectID abc (abc deve ser substituído por um valor de ID de objeto do gateway real, que pode ser recuperado usando o comando Get-OnPremisesDataClusterGateways, dada uma ID de objeto do cluster)-ClusterObjectID xyz (xyz should be replaced with an actual cluster object ID value, which can be retrieved using the Get-OnPremisesDataGatewayClusters command) -GatewayObjectID abc (abc should be replaced with an actual gateway object ID value, which can be retrieved using the Get-OnPremisesDataClusterGateways command, given a cluster object ID)

Próximas etapasNext steps

Mais perguntas?More questions? Experimente a Comunidade do Power BITry the Power BI Community