Configurar o pool de clientes do Bridge

Este tópico descreve como os administradores do site podem configurar e gerenciar o pooling para clientes do Bridge. O pooling permite que os clientes em todo o site carregue-m tarefas de atualização de dados de balanceamento de carga para fontes de dados ou conexões virtuais que se conectam a dados de rede privada.

Configurar o pooling

O objetivo de um pool é distribuir (ou balancear carga) de tarefas de atualização de dados entre os clientes disponíveis em um pool cujo acesso tem como escopo um domínio dentro de sua rede privada. Os pools mapeiam para domínios, dando a você a capacidade de dedicar pools para manter dados específicos atualizados e manter a segurança, restringindo o acesso a domínios protegidos em sua rede privada.

Embora o cliente no pool que executa a tarefa de atualização de dados seja escolhido aleatoriamente, se por qualquer motivo um cliente não puder mais executar a tarefa, ela é automaticamente redirecionada para outro cliente disponível no pool. Não é necessária uma intervenção adicional de sua parte ou dos seus usuários para suportar ou gerenciar o pool de clientes.

O pooling é otimizado para manter as fontes de dados ou conexões virtuais que se conectam aos dados em uma ou mais redes privadas atualizadas. O suporte ao pool não se estende a fontes de dados que usam agendas Bridge (herdado).

O Bridge não oferece suporte à atualização de conexões ao vivo com pools para algumas fontes de dados baseadas em nuvem privada. Para obter mais informações, consulte Configurar o pool de clientes do Bridge.Configurar o pool de clientes do Bridge

Em geral, o pooling é otimizado para as seguintes situações:

  • O Bridge é usado como um serviço crítico. Se a sua organização precisa que a consulta em tempo real e o suporte de atualização agendado estejam disponíveis, mesmo que um cliente fique indisponível.

  • O cliente está dentro da capacidade. Se o tráfego de site existente ultrapassar a capacidade atual do cliente.

  • Agendamentos gerenciados pelo Tableau Cloud para fontes de dados baseadas em arquivo. A partir do cliente Bridge versão 2021.4.3, os pools de Bridge permitem agendamentos online para fontes de dados baseadas em arquivo.

  • Manter os dados atualizados em várias redes privadas.

  • Conexões virtuais. (Requer Data Management) A ponte é necessária para atualizar os dados em conexões virtuais que se conectam aos dados da rede privada. Para obter mais informações sobre conexões virtuais, consulte Sobre conexões virtuais e políticas de dados.

Antes de configurar o pool

Antes de configurar o pool de um clientes do site, consulte o seguinte:

  • Os clientes devem estar instalados e funcionando. Para obter mais informações sobre software e hardware, consulte O Bridge foi desenvolvido para escalabilidade vertical e horizontal. Ao configurar a implantação do Bridge considere o seguinte:.
  • Os clientes são configurados para executar como serviço. Para obter mais informações, consulte Modo Aplicativo e Serviço.
  • O usuário autenticado em um cliente é um administrador de site do Tableau Cloud. Para obter mais informações sobre a implantação do Bridge, consulte Planejar a implantação do Bridge.
  • Para manter as conexões virtuais atualizadas, certifique-se de que todos os clientes no pool estejam executando o Bridge 2021.4 (ou posterior).
  • Para balancear a carga de fontes de dados baseadas em arquivo, verifique o seguinte:
    • Todos os clientes no pool estejam executando o Bridge 2021.4.3 (ou posterior).
    • As referências aos dados do arquivo devem usar o caminho UNC completo que inclui o nome do servidor ou o nome do host. Para obter mais informações, consulte Sobre o cliente do Bridge.
    • As fontes de dados baseadas em arquivo são apenas extraídas.

Observação sobre as funções de usuário

Somente administradores de site ou usuários com a função de Administrador de site ou Creator (Administrador de site) podem configurar e manter clientes agrupados. Independentemente do tipo de usuário autenticado no cliente, apenas os administradores de site podem adicionar novos pools, adicionar clientes ao pool, remover clientes do pool e monitorar clientes no pool.

Observação sobre trabalhos de atualização

A página Trabalhos pode mostrar os trabalhos de atualização do Bridge concluídos, em andamento, pendentes, cancelados e suspensos que usam agendas do Online. Isso inclui atualizações para fontes de dados baseadas em arquivo e não baseadas em arquivo. Para obter mais informações, consulte Sobre os trabalhos de atualização do Bridge. Para obter mais informações sobre várias maneiras de monitorar a atividade do Bridge, consulte Monitorar tarefas de atualização de dados.

Etapa 1: certifique-se de que os clientes possam se conectar ao site

Para que a Bridge trabalhe com seu site, você deve permitir que os clientes se autentiquem no site.

  1. Entre no Tableau Cloud usando as credenciais de administrador de site e ir para a página de Configurações.

  2. Clique na guia Autenticação e valide se a caixa de seleção Permitir que os clientes se conectem automaticamente a este site do Tableau Cloud, do cabeçalho Clientes conectados, está marcada. Para obter mais informações sobre a caixa de seleção, consulte Acessar sites de clientes conectados.

    Observação: se habilitada, a opção de clientes conectados deve ser habilitada para oferecer suporte à autenticação multifator com autenticação do Tableau. Se os clientes conectados estiverem desabilitados para o site, o Bridge só pode oferecer suporte à autenticação de nome de usuário e senha do Tableau.

Etapa 2: configurar um pool

Os pools, que requerem clientes Bridge 2021.4 (ou posterior), ajudam a encaminhar consultas em tempo real e extrair trabalhos de atualização para a rede privada apropriada. Use pools para acessar dados distribuídos por várias redes privadas, habilite atualizações de extração para fontes de dados baseadas em arquivo, e para oferecer suporte a tarefas de atualização de dados para conexões virtuais.

  1. Na guia Bridge, em Pooling, clique no botão Adicionar novo pool.
  2. Na caixa de diálogo, insira um novo nome de pool na caixa de texto Pool e clique em Salvar.

Depois de configurar pelo menos um pool, como parte do processo de publicação, o Tableau Cloud associa automaticamente certas fontes de dados ou conexões virtuais com Bridge e pools de clientes.

Etapa 3: especificar um domínio para um pool

Cada novo pool requer que um domínio seja especificado por meio da Lista de permissões de rede privada. Essas informações são necessárias para habilitar o acesso do Bridge aos dados na rede privada em nome do Tableau Cloud.

Usando a lista de permissões, você deve especificar os domínios da rede privada ou endereços IP da rede privada em que deseja habilitar o acesso do cliente.

Nomes de domínio

Os nomes de domínio que você especifica na lista de permissões são os nomes de servidor usados na conexão da fonte de dados ou na conexão virtual. Em alguns casos, você pode encontrar o nome do servidor listado na guia Conexões da página da fonte de dados no Tableau Cloud.

Por exemplo, para manter fontes de dados como “Starbucks” atualizadas, você pode especificar “mssql.myco.lan” e “oracle.myco.lan” ou “*.myco.lan” na lista de permissões.

Para manter fontes de dados como "Desafio Fitness" atualizadas, especifique "fitness-challenge" na lista de permissões.

Em outros casos, para fontes de dados como "Desafio Fitness", a guia Conexões pode não listar o nome do servidor. Quando o nome do servidor não estiver listado, considere trabalhar com o proprietário do conteúdo para identificar onde os dados estão hospedados e especificar o nome do servidor na lista de permissões quando tiver as informações. Como alternativa temporária, você pode pular para a Etapa 4: adicionar clientes a um pool para atribuir clientes a usar o Pool padrão.

Endereços IP

Em vez de nomes de domínio, você pode especificar endereços IPv4 na lista de permissões. Recomendamos que você especifique endereços IPv4 na lista de permissões se eles forem usados nas conexões de fonte de dados ou conexões virtuais. Considere trabalhar com seus proprietários de conteúdo para obter essas informações. Se você não tiver essas informações, como alternativa temporária, você pode pular para a Etapa 4: adicionar clientes a um pool para atribuir clientes a usar o Pool padrão.

Observações:

  • Por motivos de segurança, a lista de permissões está vazia por padrão para impedir o acesso ao Tableau. Isso garante que os administradores do site especifiquem quais dados podem ser enviados ao Tableau Cloud usando o Bridge.
  • Você pode usar o Fiddler com o Tableau Desktop para capturar o URI usado ao se conectar a uma fonte de dados. Para obter mais informações, consulte Fiddler.
  • Você pode atribuir um ou mais domínios a um pool.
  • Se o seu site foi configurado para usar pool antes do Tableau 2021.4, o Pool padrão permanece para fins de compatibilidade retroativa, mas não pode ser configurado para acessar uma rede privada específica. Para reduzir o escopo de acesso desse pool e habilitar recursos de agendamento mais avançados, recomendamos que você crie novos pools e os mapeie para domínios específicos.

Para mapear um domínio para um pool, faça o seguinte:

  1. Na guia Bridge, em Lista de permissão de rede privada, clique no botão Adicionar novo domínio.

  2. Na caixa de texto Domínio, insira o URI do domínio usando as informações descritas em Regras de registro da lista de permissões.

  3. Em Permissões de domínio, certifique-se de que o botão de opção Permitir esteja selecionado.

  4. Em Pool, selecione o pool cujo escopo de acesso deve ser limitado ao URI que você especificou na etapa 2.

  5. Repita as etapas 1 a 4 para cada domínio adicional.
  6. Quando concluir, clique em Salvar.

Regras de registro da lista de permissões

Use as seguintes regras ao especificar os domínios para os quais deseja habilitar o acesso à ponte. Isso permite que o Bridge, em nome do Tableau Cloud, acesse os dados em sua rede privada para realizar tarefas de atualização de dados. Um domínio permite que o Bridge se conecte aos bancos de dados e aos dados do arquivo hospedado nesse domínio.

Observações:

  • Os domínios não são verificados quando adicionados às listas de permissão. quando as fontes de dados ou conexões virtuais no momento da publicação ou quando as agendas de atualização são configuradas.
  • Duplicação devido à adição do mesmo domínio à lista de permissões, pois o nome do domínio e seu endereço IP não são verificados. Nesse cenário, se um pool for mapeado para o nome de domínio e outro pool for mapeado para o endereço IP, o formato especificado na conexão da fonte de dados ou na conexão virtual determinará qual pool mantém os dados atualizados.
  • Os domínios devem ser acessíveis pelo Bridge. Isso significa que todos os clientes do pool devem ter acesso ao domínio especificado.
  • Se nenhum domínio for especificado, o Bridge não consegue executar tarefas de atualização de dados para fontes de dados ou conexões virtuais configuradas para agendamentos online. Observação: as fontes de dados configuradas para agendamentos de Bridge (legado) continuarão a funcionar da mesma maneira.
CenárioDescriçãoExemplo
Nome de domínio exatoPode ser um FQDN ou PQDN. Números de porta não são permitidos.

myco.com
marketing.myco.com
oracle.myco.com

Faixa de nomes de domínio

Use um caractere curinga opcional (*) para incluir todos os subdomínios. O * deve ser seguido diretamente por um ponto (.).

*.myco.com
Endereço IPv4 exatoUse um literal IPv4 (abreviações não são permitidas). Os endereços IPv6 não são permitidos

255.255.0.1
192.168.0.0

Faixa de endereços IPv4Use uma máscara de sub-rede para incluir um intervalo de endereços IPv4.255.255.0.1/16
Bloquear domínios(Pools nomeados somente) Bloqueia a conectividade do Bridge para hosts neste domínio.

Ao adicionar ou editar um domínio na lista de permissões da rede privada, selecione a opção do botão de opção Bloquear.

Exemplos de registro de lista de permissões

Exemplo 1 - dados do banco de dados

Pressuponha que você deseja que o Bridge faça o seguinte:

  • Execute tarefas de atualização de dados para dados localizados em data.lan e sqlserver.myco.lan .
  • Evite tarefas de atualização de dados para dados localizados em oracle.myco.lan.

Para permitir que o Bridge ofereça suporte a esses cenários, você pode mapear os domínios para dois pools (A e B) e bloquear o terceiro domínio.

Se você especificar...e mapear para o pool......os dados são atualizados em locais
*.lanGrupo Adata.lan
sqlserver.myco.lanGrupo Bsqlserver.myco.lan

*.myco.lan

Observação: embora esse intervalo de domínio bloqueie as tarefas de atualização de dados em oracle.myco.lan, um intervalo de domínio bloqueado pode desbloquear um domínio específico dentro dele se o domínio for explicitamente permitido, como sqlserver.myco.lan.

(Bloqueado)-

Exemplo 2 - dados do arquivo

Suponha que você tenha dados do arquivo, C:\Shared\employees.csv, localizados em fileserv.myco.lan. Para habilitar o acesso do Bridge a esses dados, mapeie o domínio da máquina para um pool. Você pode especificar um dos seguintes domínios para um pool:

  • Opção nº 1: *.lan
  • Opção nº 2: *.myco.lan
  • Opção nº 3: fileserv.myco.lan

Observação: a máquina host deve permitir o acesso da rede à pasta "Compartilhada".

Etapa 4: adicionar clientes a um pool

Siga o procedimento abaixo para atribuir clientes ainda não atribuídos a um pool.

Observação: para aceitar tarefas de atualização de dados para todos os dados, certifique-se de que os clientes no pool estejam executando o Bridge 2021.4 (ou posterior).

  1. Na guia Bridge na tabela Clientes não atribuídos, navegue até o cliente que deseja atribuir a um pool e clique em Atribuir.
  2. No menu suspenso Pool, selecione o pool que deseja associar ao cliente.
  3. Repita a etapa 2 para cada cliente não atribuído que você deseja incluir no pool.

Solução de problemas de pooling

Os trabalhos de atualização do Bridge apresentam falha com um dos erros listados abaixo.

Os seguintes erros podem ser observados na página Trabalhos e na exibição administrativa Tarefas em segundo plano para não extrações.

  • "errorID=NO_POOLED_AGENTS_ASSIGNED"

    Esse problema é específico para pools padrão e pode ocorrer por um destes dois motivos: 

    • Quando o endereço do servidor ou endereço IP de uma fonte de dados não corresponde a um domínio especificado na Lista de permissões de rede privada. Isso faz com que os trabalhos de atualização sejam enviados para o pool padrão onde não há clientes atribuídos.

      Para resolver esse problema, verifique se 1) a lista de permissões contém os domínios (endereços de servidor ou endereços IP) usados pelas fontes de dados e 2) pelo menos um pool está associado a esses domínios (ou endereços de servidor ou endereços IP). Para obter mais informações, consulte Etapa 3: especificar um domínio para um pool.

    • Quando não há clientes no pool padrão. Para resolver esse problema, adicione pelo menos um cliente do Bridge 2020.2 (ou posterior) ao pool padrão. Para obter mais informações, consulte Etapa 4: adicionar clientes a um pool.
  • "errorID=NO_POOLED_AGENTS_ASSIGNED_NAMED_POOL"

    Esse problema pode ocorrer se não houver clientes no pool nomeado. Para resolver esse problema, adicione pelo menos um cliente do Bridge 2021.4 (ou posterior) ao pool nomeado. Para obter mais informações, consulte Etapa 4: adicionar clientes a um pool.

  • "errorID=NO_AGENT_IN_POOL_SUPPORTS_REMOTE_EXTRACT_REFRESH"

    Esse problema pode ocorrer quando um trabalho de atualização tenta ser executado, sem pelo menos um cliente do Bridge 2020.2 (ou posterior) no pool. Para resolver esse problema, adicione pelo menos um cliente do Bridge 2020.2 (ou posterior) ao pool. Para obter mais informações, consulte Etapa 3: especificar um domínio para um pool.

  • "errorID=NO_POOLED_AGENTS_CONNECTED"

    Esse problema pode ocorrer quando nenhum dos clientes no pool está disponível para executar tarefas de atualização de dados. Para obter mais informações, consulte a seção Configurar o pool de clientes do Bridge acima.

  • "errorID=REMOTE_EXTRACT_REFRESH_ALL_AGENTS_BUSY" ou "errorMessage: Maximum concurrency reached" no cliente

    Esses problemas podem ocorrer se o número de trabalhos de atualização em execução em determinado momento exceder a capacidade do pool de clientes. Para ajudar a resolver esse problema, tente as soluções a seguir: 

  • "errorID= AGENTS_IN_POOL_REQUIRE_UPGRADE"

    A partir do Tableau 2021.4, esse problema pode ocorrer quando os clientes no pool precisam ser atualizados para Bridge 2021.4 (ou posterior) para executar tarefas de atualização de dados. Para obter mais informações sobre a atualização de clientes, consulte Instalação do Bridge.

Clientes do Bridge estão sendo desconectados

Esse problema pode acontecer se você implantar um grande número de clientes na mesma conta de serviços do Windows. Quando há mais de 10 clientes executados em uma conta de serviços do Windows, as medidas de segurança da conta podem fazer com que os clientes sejam desconectados. Para obter mais informações, consulte Conta de serviços do Windows.

Outros possíveis problemas de pool

Ao tentar diagnosticar problemas relacionados ao pool, considere revisar os seguintes arquivos de registro para um cliente na máquina do cliente Bridge: tabbridgeclijob_<process_id>, jprotocolserver_<process_id>, stdout_jprotocolserver_<process_id>. Para obter mais informações, consulte Alterar as configurações do cliente do Bridge.

Agradecemos seu feedback!Seu feedback foi enviado. Obrigado!