Ajuda do Tableau Server

Bem-vindo ao Tableau Server
Como um complemento do Tableau Desktop Professional Edition, o Tableau Server permite
compartilhar descobertas por meio de uma experiência na Web interativa e colaborativa. As
pessoas que usam o Tableau Desktop podem criar representações visuais de dados para
responder a perguntas simples e complexas. Essas representações são chamadas de
exibições. Com o Tableau Server, os autores podem então publicar pastas de trabalho cheias
de exibições de modo que os usuários possam ver e interagir com os dados.
Como usar a ajuda
Quando precisar de assistência, clique no menu Ajuda no topo da página. Um menu de ajuda
com tópicos relevantes para a página em que você está é aberto.
Versão: 8.1 | Atualizada em 25.10.2013
Entrar
Na maioria das vezes, você deve ter uma conta no Tableau Server para publicar e navegar.
Além disso, é preciso estar atribuído a um nível de licença Visualizador ou Interagente. As
contas de usuário são configuradas por um administrador. Elas são baseadas na conta de
usuário do Windows, usando o Active Directory, ou no sistema interno de gerenciamento de
usuários do Tableau Server. Contate o administrador se não souber seu nome de usuário ou
sua senha.
Às vezes, dependendo de como o servidor estiver configurado, você entrará
automaticamente. Caso tenha entrado automaticamente como a pessoa errada, você pode
alternar para sua conta clicando em Sair no menu do servidor, no canto superior direito da
página:
Caso você seja solicitado a entrar, digite seu nome de usuário e sua senha e clique em Entrar.
Lembrança de seu nome de usuário
A marcação da caixa de seleção Lembrar-me na página Entrar do Tableau Server
preencherá automaticamente seu nome de usuário sempre que você visitar o servidor. Esta
opção facilita o acesso rápido à conta. Ainda assim, você precisa digitar sua senha em cada
visita para entrar. Quando Lembrar-me é selecionado no logon, Tableau Server cria um
cookie de nome de usuário para lembrá-lo quando você retorna ao site do mesmo
computador. Para parar automaticamente o preenchimento do nome de usuário, limpe os
cookies do navegador.
Tableau Server sempre armazena um cookie de sessão quando você entra,
independentemente de também ter selecionado Lembrar-me. Por esse motivo, seu
navegador deve ser configurado para permitir cookies primários.
Entrada em um site
Caso você seja um membro de um único site no Tableau Server, a escolha de um site não faz
parte do processo de entrada, pois isso acontece automaticamente. A parte superior da
página do servidor é semelhante a isto:
Se você pertence a vários sites, o nome de seu site atual será exibido no menu Sites:
Entrada usando SAML
Se o Tableau Server for configurado para autenticação SAML, você não verá um prompt
Entrar do Tableau Server. Em vez disso, você verá um aviso de um provedor de identidades
externo (IdP). Por exemplo:
Depois de entrar usando SAML habilitado, você não verá um comando Sair no menu de
usuário do Tableau Server. Isso porque sua entrada foi identificada pelo IdP, e não pelo
Tableau Server. Para sair do Tableau Server, você também deve usar seu IdP.
Procurar Tableau Server
Ao entrar pela primeira vez no Tableau Server, você vê uma lista de exibições. As exibições
são classificadas em ordem alfabética, por nome. A página contém várias ferramentas que
ajudam você a navegar e a encontrar exibições no servidor:
Navegar no Server
Há diferentes maneiras de navegar pelo Tableau Server: usando os links de navegação à
esquerda ou os controles de página.
Links de navegação
A área de navegação à esquerda é dividida em uma guia Admin, que pode ser vista somente
por administradores de sistema e site, e uma guia Conteúdo, que pode ser vista por todos os
usuários do servidor:
Admin
Na condição de administrador de sistema, você pode ver tudo no servidor e ter todos os
recursos. Com exceção das páginas Sites e Licenças, os administradores do site podem ver
todas as áreas a que têm direito. Geralmente, os administradores do site têm capacidade
reduzida nas áreas que podem visualizar. A capacidade do administrador de site de adicionar
usuários a um site é algo que os administradores de sistema podem permitir ou impedir
(consulte Adicionar ou editar sites).
Conteúdo
A área Projetos vincula-se a um lista de projetos no servidor. Um projeto é um conjunto de
pastas de trabalho relacionadas. Os administradores criam e mantêm projetos. Consulte
Projetos para saber mais.
Controles de página
Se houver várias páginas, você poderá avançar por elas usando os links Próximo e Anterior
na parte inferior da página. Como alternativa, é possível pular para uma página específica
digitando o número dela na caixa de texto e pressionando Enter no teclado.
Ao inserir o número de itens que você deseja ver e pressionar Enter, é possível aumentar ou
diminuir o número de itens exibidos em cada página.
Guias de planilha
As pastas de trabalho muitas vezes contém várias planilhas, incluindo exibições individuais e
painéis. Como opção, os autores podem publicar essas pastas de trabalho onde as folhas são
exibidas como guias na parte superior da página (usando a opção Mostrar planilhas como
guias do Tableau Desktop). Quando estiver trabalhando com uma pasta de trabalho com
guias, você poderá navegar facilmente entre as planilhas usando as guias de planilha.
Avançar pelas páginas
Algumas exibições apresentam várias páginas, que dividem os dados com base nos valores
de um campo específico. Um exemplo comum é uma exibição que mostra uma página
separada para cada ano, trimestre ou mês. As páginas ajudam a comparar dados e encontrar
exceções. Cada página usa o mesmo intervalo de eixos, de modo que conforme você se move
pelas páginas, pode facilmente ver como os dados vão sendo alterados.
Se a exibição tiver páginas, o controle de página será exibido para que você possa navegar
por elas. É possível usar as setas para a esquerda e para a direita de modo a rolar por cada
uma das páginas ou usar o menu suspenso para pular para uma página específica. Por fim,
você pode usar o controle deslizante para passar pelas páginas.
Por exemplo, na exibição abaixo, as páginas são definidas por Anos. É possível usar o
controle de página para observar o PIB e o percentual de uso da Internet para cada ano.
Selecione Mostrar histórico no controle de página para incluir as marcas das páginas
anteriores à medida que você se move de uma página para outra e quando seleciona marcas.
O autor da exibição pode especificar como as marcas históricas devem ser exibidas.
Sua página Preferências de usuário
As opções em sua página Preferências do usuário afetam suas sessões Web individuais do
Tableau Server. Use-as para gerenciar as configurações de sua assinatura, especificar sua
página inicial, alterar o idioma e a localidade que você vê no Tableau Server, apagar cookies
para senhas de conexão de dados ou alterar sua senha do Tableau Server. É possível
também usar essa página para rapidamente procurar itens que você publicou. Para acessar
sua página Preferências do Usuário, clique no seu nome de usuário na parte superior da
página e selecione Preferências de Usuário no menu suspenso:
Alterar seu endereço de email
Se você tiver uma assinatura de uma exibição ou pasta de trabalho do Tableau Server, a conta
de email que receberá a assinatura será listada na página Preferências do usuário:
Para inserir ou alterar o endereço de e-mail para o qual o Tableau Server envia assinaturas,
insira o novo endereço de e-mail na caixa de texto E-mail, insira-o novamente na caixa de
texto Confirmar e-mail e, em seguida, selecione Definir:
Gerenciar as configurações da sua assinatura
Use as opções da Assinatura para alterar o agendamento para as assinaturas que você
estiver recebendo. Aqui também é onde você pode cancelar a assinatura de uma exibição.
Para ver as etapas, consulte Cancelar a Assinatura de uma Exibição e Alterar as
Configurações da Assinatura.
Personalizar a página inicial
Tableau Server é instalado com Exibições como a página inicial padrão para todos os
usuários, mas o administrador pode especificar uma página inicial diferente. Para descobrir
qual é sua página inicial, clique em Ir para a página inicial:
Você pode designar uma página inicial diferente navegando para a página do servidor
desejada, por exemplo, Pastas de trabalho e selecionando o comando Tornar esta minha
página inicial no menu suspenso no canto superior direito:
Para voltar a usar a página inicial designada pelo seu administrador, em sua página
Preferências de Usuário, clique em Redefinir como o padrão:
Idioma e localidade
A configuração de Idioma controla o idioma que você na interface de usuário do Tableau
Server e Localidade afeta os itens nas exibições, como a formatação dos números e a moeda
usada. Seu administrador pode configurar essas definições para todos os usuários do
servidor, mas você pode alterá-las aqui, apenas para si mesmo. Se você alterar essas
definições, observe que elas entrarão em vigor apenas se forem um idioma com suporte.
Consulte Idioma e localidade para saber mais.
Após fazer as seleções de Idioma e Localidade, clique em Definir.
Na próxima vez em que você entrar, as configurações serão usadas em suas sessões de
servidor.
Alterar sua senha do Tableau Server
Se o servidor for configurado para usar o sistema interno de gerenciamento de usuários
(autenticação local) em vez do Active Directory, você poderá alterar sua senha do Tableau
Server clicando em Alterar senha. Ao clicar nesse link, você será solicitado a inserir sua
Senha atual e a Nova senha (duas vezes). Após ter digitado as informações necessárias,
clique em Alterar para salvar as alterações.
Desmarcar suas senhas de conexão de dados salvas
Se você acessar uma exibição ou pasta de trabalho que tem uma conexão de banco de dados
dinâmico e exige autenticação, o Tableau se oferece para salvar sua senha para você. Se
você aceitar, ele armazenará suas credenciais em um cookie. Clique em Limpar tudo em
Senhas de conexão de dados salvas para remover o cookie do Tableau Server:
Procurar itens publicados
Sua página de conta de usuário lista todas as pastas de trabalho, marcas e os comentários
que você publicou. Use essa página para procurar rapidamente sua própria atividade no
servidor.
Executar ações
Se você tiver um nível de licença Interagente ou se for um administrador, terá acesso aos
comandos na parte superior de muitas páginas de servidor que permitem que você configure
permissões, adicione marcas ou exclua exibições ou pastas de trabalho.
Você pode usar os comandos em combinação com a caixa de seleção exibida ao lado de cada
item na lista. Em vez de selecionar itens individualmente, você pode usar a lista suspensa para
selecionar Todos os itens, apenas os itens na Página atual ou Nenhum dos itens.
Em vez de usar o menu suspenso, você pode clicar várias vezes na caixa de seleção na parte
superior da lista para alternar entre essas opções. A caixa de seleção é atualizada para indicar
quais itens foram selecionados.
Todos os itens
selecionados em várias
páginas
Todos os itens selecionados
apenas na página atual
Nenhum item
selecionado
Depois de selecionar os itens, é possível aplicar ações relevantes como definir permissões ou
adicionar marcas.
Pesquisar conteúdo
Você pode usar a caixa de pesquisa à esquerda da página em combinação com os filtros
abaixo para encontrar rapidamente exibições e outros itens. Você também pode usar os
atributos e os operadores de pesquisa inseridos para a pesquisa.
Usar pesquisa filtrada
As listas suspensas de Projeto, Editor e Marca mostram o que foi definido no servidor, e os
filtros Modificado em ou após/antes de, Favoritos e Usado recentemente podem ajudálo a delimitar ainda mais sua pesquisa:
Para remover um filtro, clique no X à direita do filtro para removê-lo:
Para remover todos os filtros, clique em Limpar tudo na parte superior:
Usar atributos com a pesquisa
Além de uma pesquisa geral, você pode limitar a pesquisa no Tableau Server para um atributo
específico, como nome, pasta de trabalho, fonte de dados, etc. Por exemplo, digitar
name:projeções de vendas (sem espaços em ambos os lados do dois-pontos) retorna apenas
os itens cujos nomes contêm as palavras vendas ou projeções. Os operadores de pesquisa,
por outro lado, ajudam a especificar o tipo de pesquisa que você deseja realizar.
Uma lista completa de atributos é mostrada abaixo.
Este
atributo...
Seguido por... Retorna
name:
termo de
pesquisa
Itens cujos nomes correspondem ao termo
de pesquisa
title:
termo de
pesquisa
Exibições cujos títulos correspondem ao
termo de pesquisa
caption:
termo de
pesquisa
Exibições cujas legendas correspondem
ao termo de pesquisa
publisher:
nome de
usuário
Itens que foram publicados pelos usuários
especificados
project:
termo de
pesquisa
Itens que fazem parte de um projeto cujo
nome corresponde ao termo de pesquisa
comment:
termo de
pesquisa
Exibições cujos comentários
correspondem ao termo de pesquisa
tag:
termo de
pesquisa
Itens cujas marcas correspondem ao termo
de pesquisa
field:
termo de
pesquisa
Exibições com campos correspondentes
nas linhas, nas colunas, no nível de
detalhes, nas páginas ou nas divisórias de
codificação.
type:
workbook,
view,
Itens que são do tipo correspondente
datasource,
project
sheettype:
exibição ou
painel
class:
tipo de fonte de Exibições e fontes de dados que são
dados (p. ex.,
associadas ao tipo correspondente de
mysql)
fonte de dados
dbname:
Exibições e fontes de dados que são
nome do banco
associadas à fonte de dados
de dados
correspondentes
tablename: termo de
Exibições que são do tipo de planilha
correspondente
Exibições e fontes de dados que são
Este
atributo...
nviews:
Seguido por... Retorna
pesquisa
associadas ao nome de tabela
correspondente
number
Pastas de trabalho que contém o número
de exibições especificado
Os termos de pesquisa não diferenciam maiúsculas e minúsculas.
Você pode incluir vários atributos para limitar ainda mais a pesquisa. Por exemplo, para
encontrar todos os painéis que foram publicados por Smith, você pode digitar o seguinte no
campo de pesquisa: sheettype:dashboard publisher:smith.
Usar operadores de pesquisa
Às vezes, é conveniente criar pesquisas com operações lógicas no Tableau Server. Por
exemplo, você pode querer pesquisar por todos os itens que não correspondem a um termo
específico. Ou pode querer encontrar itens que correspondem a um termo ou outro termo,
mas não a ambos. Você pode usar and, or, not e * para criar expressões de pesquisa.
Operador Definição
Exemplos
and
Retorna itens que
correspondem a
vendas and marketing; canetas and papel
ambos os termos de
pesquisa.
or
Retorna itens que
correspondem a um
oeste or leste; futebol and football
dos termos de
pesquisa.
not
Exclui os itens que
correspondem ao
not sheettype:painel
termo de pesquisa
após esse operador
*
Atua como um
substituto para
qualquer outro
caractere ou palavra
seguindo ou como
parte do termo de
dev* vendas*
pesquisa. Esse
operador pode ser
usado sozinho ou no
fim do termo de
pesquisa. Esse
Operador Definição
Exemplos
operador é útil
quando você não
sabe o termo exato
que está
procurando.
Espaços e pesquisa
Se seu termo de pesquisa inclui espaços, pontuação ou as palavras reais and, or ou not,
coloque-o entre aspas.
Usar listas
Ao navegar pelo Tableau Server, você perceberá que os itens são exibidos como miniaturas
ou em listas. Os ícones na parte superior das páginas Pastas de trabalho e Exibição permitem
especificar que conteúdo deve ser exibido como lista ou miniatura:
Você pode alternar rapidamente entre esses dois estados clicando na lista e nos ícones de
miniatura:
Classificar miniaturas
Dependendo do tipo de item que você está listando, pode ser possível classificar pelas
seguintes categorias: Nome, Projeto, número de Folhas, data da última Modificação e
Editor. A classificação dependerá do que você está vendo: miniaturas ou uma lista de texto.
Uma lista classificada é agrupada pela categoria selecionada com títulos que mostram os
diferentes agrupamentos. Por exemplo, as miniaturas em exibição abaixo estão classificadas
alfabeticamente em ordem crescente (A-Z). Note que a seta de classificação aponta para
cima.
Listas de classificação
Em uma lista de texto, você pode usar o cabeçalho da coluna para classificar a lista.
Novamente, a seta indica se os itens estão classificados em ordem crescente (seta para cima)
ou decrescente (seta para baixo). Clique no cabeçalho da coluna que deseja usar para
classificar a lista.
Na exibição de lista, uma coluna Editar está disponível, às vezes. Você pode selecionar uma
exibição e clicar em Editar para modificá-la no servidor. Para obter detalhes sobre como fazer
isso, consulte Editar e criar exibições.
À medida que você altera a classificação em uma lista de pastas de trabalho, exibições
ou projetos, o servidor lembras suas três últimas opções de classificação e as aplica
como uma classificação de várias colunas. Por exemplo, se você classificar por data de
Modificação e, em seguida, classificar por Projeto, a lista será agrupada por projeto e
dentro de cada projeto, as pastas de trabalho ou exibições serão classificadas por data
de modificação.
Armazenar favoritos
É possível marcar qualquer exibição ou pasta de trabalho para armazená-la como uma de
suas favoritas, de modo que você possa encontrá-la rapidamente no futuro. Os favoritos são
mantidos no menu Favoritos, no canto superior direito:
No menu Favoritos, as exibições têm um ícone , e as pastas de trabalho têm um ícone .
Se você tiver um grande número de favoritos, poderá usar a barra de rolagem à direita para
ver todos:
Você pode procurar rapidamente por determinados favoritos usando a caixa de pesquisa na
parte superior:
Adicionar um favorito
Você pode criar um favorito tanto na exibição de miniatura quanto na exibição de lista das
páginas de Exibições e Pastas de trabalho. Na exibição de miniatura, crie um favorito
passando o cursor do mouse sobre uma exibição ou pasta de trabalho e selecionando a
estrela Favoritos na dica de ferramenta que aparece:
Na exibição de lista, crie um favorito clicando na estrela ao lado da exibição ou pasta de
trabalho que você deseja armazenar como um favorito:
A exibição ou a pasta de trabalho é adicionada ao seu menu Favoritos.
Remover um favorito
Para remover uma exibição ou pasta de trabalho de sua lista Favoritos, passe o mouse pela
dica de ferramenta e clique na estrela:
Na exibição de lista, clique na estrela para remover a exibição ou pasta de trabalho dos
Favoritos:
Salvar senhas
Às vezes, uma exibição requer que você insira um nome de usuário e uma senha de banco de
dados. Se você tiver acesso ao banco de dados, será preciso inserir seu nome de usuário e a
senha nas caixas de texto apropriadas. Se selecionar a opção Lembrar minha senha, você
entrará automaticamente sempre que observar a exibição. Suas informações de entrada são
armazenadas criptografadas no servidor para que você entre automaticamente mesmo entre
sessões de navegador e ao acessar a exibição de vários computadores. Isso é conveniente
quando você precisa selecionar várias exibições que acessa o tempo todo.
Observação:
Os administradores podem restringir se permitem aos usuários lembrar senhas de banco de
dados. Se você é um administrador, consulte Configurações de manutenção para saber mais.
Limpeza e redefinição de senhas salvas
Se suas senhas estão sendo salvas (a opção Senhas salvas está habilitada na página
Manutenção), você pode limpá-las. Quando isso é feito, na próxima vez que você visitar o
servidor, serão solicitados seu nome de usuário e sua senha. Isso pode ser conveniente se o
nome de usuário e senha mudarem, assim, você pode começar a usar e salvar suas novas
credenciais.
1. No menu suspenso da parte superior direita, abra sua página Preferências do usuário.
2. Abaixo de Senhas de conexão de dados salvas, clique em Limpar tudo.
Os administradores também podem limpar todas as senhas salvas no servidor usando a
opção Limpar todas as senhas salvas de todos os links de usuários na página
Manutenção.
Trabalhar com exibições
Após encontrar uma exibição ou um painel que seja interessante, você poderá exibir e
interagir com os dados de várias maneiras diferentes. O modo exato dependerá de dois itens:
seu nível de licença e as permissões definidas pelo autor da exibição. Consulte Trabalhar com
permissões para saber mais.
Compartilhar exibições
Cada exibição e pasta de trabalho publicadas podem ser compartilhadas por e-mail ou
inseridas em outra página da Web, wiki ou aplicativo Web. Qualquer pessoa que esteja vendo
uma exibição compartilhada deve ter uma conta no Tableau Server e permissão para acessar
a exibição.
Enviar uma exibição por e-mail
Você pode enviar um link para uma exibição por e-mail com facilidade, clicando no link
Compartilhar no canto superior esquerdo da exibição. Em seguida, copie e cole o link
fornecido na sua mensagem de e-mail.
Inserir exibições
É possível compartilhar uma exibição inserindo-a em outra página da Web, como seu wiki,
blog ou aplicativo Web. Clique no link Compartilhar no canto superior esquerdo da exibição e
copie e cole o código HTML fornecido.
Ajustar a aparência de uma exibição inserida
Você pode alterar a aparência de uma exibição inserida ajustando as Opções de exibição. É
possível especificar uma largura e altura fixas e se a barra de ferramentas ou guias devem ser
mostradas.
Explorar dados por meio de dicas de ferramentas
As dicas de ferramenta são detalhes de dados adicionais quando você focaliza uma ou mais
marcas em uma exibição:
As dicas de ferramenta também oferecem maneiras fáceis de filtrar rapidamente ou remover
marcas e de exibir dados:
l
Manter apenas: Exibe apenas o que você selecionou na exibição.
l
Excluir: Remove da exibição o que você selecionou.
l
Exibir dados: Abre uma janela que exibe os dados. Você pode exibir os dados
resumidos ou os dados subjacentes.
Para filtrar ou excluir um grupo de marcas, basta selecioná-lo e clicar na ação que deseja
executar.
Para observar dados resumidos ou subjacentes, faça uma seleção e clique no ícone Exibir
dados:
Os dados na guia Resumo exibem os dados agregados na exibição ou na sua seleção dentro
da exibição:
Os dados em Subjacente exibem os valores de cada linha na fonte de dados, conforme
restritos pelas marcas selecionadas:
Selecionar Mostrar todas as colunas exibe todas as colunas na fonte de dados subjacente,
independentemente de os dados estarem ou não na exibição:
Baixe todas as linhas como um arquivo de texto usando os links nas partes superior e
inferior da tabela:
Assinar as exibições
Se você puder ver uma exibição no Tableau Server e ela tiver um ícone de assinatura ( ) no
canto superior direito, seu administrador terá assinaturas configuradas para seu site e você
poderá assinar a exibição. Isso significa que, em um intervalo regular, você pode ter um
instantâneo da exibição enviado automaticamente para sua caixa de entrada de e-mail, sem
precisar entrar no Tableau Server. Você também pode assinar as pastas de trabalho. Em vez
de receber uma única exibição, você recebe todas as exibições na pasta de trabalho em um
único email. Você pode alterar qual agenda de assinatura está usando ou cancelar a
assinatura. Consulte abaixo para obter detalhes.
Assinar uma exibição
Para assinar uma exibição ou pasta de trabalho:
1. Selecione a página Exibições ou Pastas de trabalho:
2. Clique em uma exibição ou pasta de trabalho.
3. Clique no ícone de assinatura no canto superior direito:
4. Se sua conta do Tableau Server não tiver sido associada a um endereço de email, você
será solicitado a fornecer um. Insira seu endereço de email e clique em Avançar.
5. Na próxima caixa de diálogo, selecione uma agenda de assinatura. Por padrão, o
Tableau Server fornece uma agenda para todos os dias de manhã e uma agenda para
as manhãs de segunda. O administrador do Tableau Server também pode criar
agendas de assinatura personalizadas.
6. Em seguida, escolha se você quer assinar uma exibição única (Esta folha) ou a pasta
de trabalho inteira (Planilhas na pasta de trabalho) e clique em Assinar.
7. Mais tarde, quando você receber a assinatura por e-mail, clique no instantâneo da
exibição e ela será aberta no Tableau Server:
Cancelar a assinatura de uma exibição
Para cancelar a assinatura de uma exibição ou pasta de trabalho:
1. Acesse sua página Preferências de usuário no Tableau Server clicando no link na parte
inferior de um e-mail de assinatura:
Você também pode abrir a página Preferências do usuário no menu suspenso do
Tableau Server:
2. Ao lado da exibição da qual você quer cancelar a assinatura, marque a caixa de seleção
Cancelar assinatura.
3. Clique em Atualizar.
Alterar as configurações da assinatura
Para alterar a agenda da assinatura:
1. Abra sua página Preferências de usuário:
2. Em Agenda, selecione uma agenda diferente:
3. Clique em Atualizar.
Classificar dados
Você pode alterar rapidamente a ordem de classificação de itens em uma exibição usando os
botões Classificar em um eixo, rótulo de campo ou cabeçalho. Por exemplo, a exibição a
seguir mostra a saída de petróleo por poço. Se você passar o mouse sobre o eixo vertical, um
botão de classificação será exibido mostrando a classificação que será feita quando você clicar
nele - nesse caso, uma classificação em ordem crescente:
Após a classificação, o ícone de classificação permanecerá no eixo vertical:
Clique no ícone Classificar novamente e ele classificará em ordem decrescente, da saída mais
baixa para a saída mais alta:
Um terceiro clique retorna o gráfico de barras para seu estado original:
Você sempre pode reverter para o estado original da exibição inteira usando o botão Reverter
tudo na barra de ferramentas.
Filtrar dados
Com um nível de licença Interagente, você pode filtrar dados em uma exibição para que seja
possível restringir a visualização com os dados do seu interesse. Por exemplo, um relatório de
vendas regional pode mostrar vendas de várias regiões diferentes. Você pode focar em como
sua região está indo usando filtros. Depois você pode reverter os filtros para retornar a
exibição original e comprar sua região com outras.Há duas formas de filtrar a exibição: filtros
rápidos e os comandos de dica de ferramenta Manter apenas e Excluir.
Tipos de filtros rápidos
Há muitos tipos diferentes de filtros rápidos. O autor da exibição escolhe o tipo de filtro que
mostra melhor os valores que você está filtrando. Cada tipo de filtro e como você pode
interagir com eles são descritos abaixo.
Tipo de filtro rápido
Descrição
Lista de valores múltiplos
Mostra uma lista de caixas de seleção. Selecione os
valores a serem incluídos.
Lista de valores únicos
Mostra uma lista de botões de opção. Selecione um
valor a ser incluído por vez.
Lista compacta
Mostra uma lista suspensa de valores. Selecione um
valor a ser incluído por vez.
Controle deslizante
Mostra valores ao longo de um intervalo. Arraste o
controle deslizante ou use as setas para selecionar
um único valor a ser incluído. Para valores
quantitativos, use os dois controles deslizantes para
especificar um intervalo de valores.
Tipo de filtro rápido
Descrição
Correspondência de curinga
Mostra um campo de texto. Inclui todos os valores
que contêm um conjunto específico de caracteres.
Você pode usar o símbolo de asterisco (*) como
caractere curinga.
Digitação
Mostra um campo de texto. Digite um valor e clique
no sinal de mais para incluí-lo no filtro. Como
alternativa, copie e cole uma lista de valores no
campo de texto.
Filtros de data
Os filtros de data podem ser mostrados na maioria
dos tipos de filtro descritos acima. No entanto, existe
mais alguns tipos que são específicos de datas. Por
exemplo, os filtros de data relativos permitem incluir
intervalos de data comuns, como "últimas três
semanas" ou "ano até a data". Ou você pode
selecionar dentre um conjunto de períodos de data
predefinido, como 1 dia, 1 semana, 3 meses, etc.
Lista de valores múltiplos (hierárquica)
Se a exibição usar uma fonte de dados
multidimensional, a lista de valores múltiplos
mostrará os níveis hierárquicos. Use os seletores de
nível no topo para selecionar todos os valores no
nível fornecido.
Opções de filtragem
Muitos filtros rápidos têm opções adicionais que são exibidas quando você focaliza o ponteiro
sobre a área de filtro na página. Por exemplo, às vezes, é mais fácil selecionar o que você não
deseja ver do que tudo aquilo que deseja. As opções no menu suspenso de uma lista de
valores múltiplos permitem alternar entre um filtro Inclusivo e Exclusivo. Cada tipo de filtro
tem seu próprio conjunto de opções disponíveis no menu suspenso, no canto superior direito
da área de filtro. A disponibilidade dessas opções é controlada pelo autor da exibição.
Além disso, se um filtro contiver muitos valores, você poderá usar a pesquisa para encontrar
rapidamente e selecionar o que estava procurando. Clique no botão Pesquisar que é
mostrado quando você focaliza o ponteiro sobre o filtro rápido. Comece a digitar o valor que
está procurando. Os resultados são mostrados logo abaixo da caixa de pesquisa, facilitando a
seleção.
Por fim, você pode limitar os valores mostrados em um filtro rápido usando o botão Mostrar
mais valores/Mostrar menos valores. Quando você mostra mais valores, todos os valores
do campo são exibidos. Quando você mostra menos valores, os outros filtros ativos são
considerados. Somente valores que passam em todos os filtros são mostrados. Por exemplo,
uma exibição pode ser filtrada para mostrar vendas superiores a US$ 5000 nas regiões oeste
e central. Quando você mostra mais valores, o filtro Região mostrará todas as regiões.
Quando você mostra menos valores, o filtro Região mostrará apenas as regiões onde as
vendas foram superiores a US$ 5000.
Reversão de filtros
Se, a qualquer momento, você desejar restaurar os filtros para como eles eram quando a
exibição foi publicada, use o botão Reverter tudo.
Exportar exibições
É possível exportar a exibição como uma Imagem ou um PDF. Como opção, você pode
exportar os dados como uma Tabela de referência cruzada ou um arquivo CSV (Dados).
Selecione uma opção no menu Exportar na barra de ferramentas da parte superior da
exibição.
Se você estiver exportando um painel para PDF e o painel contiver um objeto de página
da Web, o objeto de página da Web não será incluído. Além disso, quando você
seleciona uma opção de exportação, o arquivo de imagem, PDF ou dados deve ser
gerado. Uma mensagem é aberta ao fim da geração para que seja possível continuar
baixando o arquivo.
Mapas de ampliação/redução e panorâmica
Para ajudar você a navegar pelas exibições que incluem mapas, uma barra de ferramentas de
ampliação/redução aparece quando o mouse é movido sobre um mapa em uma exibição. A
barra de ferramentas permite ampliar e reduzir, selecionar marcas, retornar o mapa para seu
estado original e fazer uma panorâmica:
Se o autor da pasta de trabalho optar por ocultar os controles de ampliação/redução (no
Tableau Desktop: Exibir > Controles de zoom > Ocultar), você não verá a barra de
ferramentas de zoom.
Cada modo é descrito abaixo:
Ampliar/reduzir: Use o recurso de ampliar/reduzir em uma
visualização de mapa para ver mais detalhes.
Selecionar: Selecione marcas em uma visualização de mapaa para
identificar um subconjunto dos dados.
Início: Restaure a visualização de mapa para seu estado original.
Panorâmica: Clique e pressione o botão do mouse para mover sua
exibição de um mapa para cima e para baixo, bem como para a
esquerda e a direta. Isso é especialmente útil quando você
amplia/reduz uma exibição e quer mover a exibição para ver outras
áreas de interesse.
Pausar atualizações automáticas
Conforme você interage com a exibição no servidor, às vezes, ele terá que enviar uma
consulta à fonte de dados para atualizar os dados na exibição. Se você estiver trabalhando
com uma exibição densa com vários dados ou uma fonte de dados muito grande, a atualização
automática pode demorar um longo tempo. Para evitar aguardar cada atualização enquanto
você faz várias alterações, é possível clicar em Pausar atualizações automáticas na barra
de ferramentas.
Ao Retomar atualizações automáticas usando o mesmo botão na barra de ferramentas,
você só precisará aguardar uma única consulta à fonte de dados.
Atualizar dados
Se a fonte de dados foi alterada, como novos campos foram adicionados ou valores de dados
e nomes de campo foram modificados, a exibição refletirá essas alterações na próxima vez
que você carregar a página. No entanto, talvez você precise atualizar manualmente a exibição
usando o botão Atualizar dados na barra de ferramentas.
Quando você atualiza os dados, limpa qualquer cache que possa existir e recupera os dados
mais recentes da fonte de dados. Essa opção é diferente da opção Pausar atualizações
automáticas, que ainda pode carregar a exibição com base nos dados armazenados em
cache. Dependendo do tamanho da fonte de dados e da exibição, atualizar os dados pode
levar muito mais tempo do que outras consultas que operam nos dados armazenados em
cache.
Baixar pastas de trabalho
As pastas de trabalho podem ser baixadas usando o link Baixar no canto superior direito da
exibição. A pasta de trabalho baixada pode ser aberta com uma versão do Tableau Desktop.
Baixar a pasta de trabalho do servidor é o mesmo que selecionar Servidor > Abrir pasta de
trabalho no aplicativo de desktop. A pasta de trabalho poderá ser aberta somente se ainda
estiver publicada no servidor.
Essa opção estará disponível somente se você tiver recebido a permissão Baixar/salvar na
Web como do autor da pasta de trabalho ou de um administrador. Consulte Trabalhar com
permissões para saber mais.
Como seguir hiperlinks
Muitas exibições contêm hiperlinks para fora de URLs ou outras planilhas. Esses hiperlinks
são adicionados pelo autor e podem ser úteis para obter mais informações sobre um conjunto
de pontos de dados. Com base em como a exibição foi criada, os hiperlinks podem ser
iniciados em uma destas três maneiras:
l
Selecionar - clique em uma marca na exibição.
l
Focalizar - coloque o ponteiro sobre a marca na exibição.
l
Dica de tela - o hiperlink está disponível na dica de tela que é exibida quando você
coloca o ponteiro sobre uma seleção de marcas.
Links para páginas da Web
Uma exibição pode se vincular a uma página da Web externa para mostrar mais informações
sobre os dados. Por exemplo, uma visualização de mapa pode ser vinculada de um local
específico para mostrar uma imagem satélite. Ou um relatório de vendas pode ser vinculado
de uma seleção de produtos para mostrar o status atual do inventário em uma intranet interna.
Quando você clica em um link, ele o direciona à página da Web externa, que está fora do
Tableau Server. As páginas da Web também são inseridas em um painel. Nesse caso, clicar
em um link carrega a página da Web na mesma janela.
Links para outras exibições
Além de se vincularem a páginas da Web externas, algumas exibições terão hiperlinks para
outras exibições no Tableau Server. Esses links filtram dados na exibição de destino com base
na sua seleção na exibição de origem. Por exemplo, no painel mostrado abaixo, selecionar um
produto da lista de Produtos mais vendidos filtra a exibição do mapa para mostrar onde o
produto foi vendido.
Destacar marcas, legendas e ações
O destaque é uma maneira de chamar a atenção para um subconjunto de dados em uma
exibição. Há três maneiras de dar destaque no Tableau Server: usar marcas, legendas ou
ações.
Uso de marcas para destaque
Quando você seleciona uma ou mais marcas em uma exibição, todas as outras marcas são
esmaecidas para que sua seleção se sobressaia. Selecione marcas individuais ou clique e
arraste o ponteiro para selecionar um grupo de marcas. Mantenha pressionada a tecla Ctrl no
teclado para selecionar várias marcas na exibição.
Uso de legendas para destaque
Você pode usar as legendas (cor, forma e tamanho) para destacar as marcas que
correspondem a cada item na legenda. Por exemplo, se uma exibição for colorida por
categoria de produto, você poderá destacar rapidamente um determinado tipo de produto
usando o destaque da legenda. Para habilitar o destaque de legenda:
1. Clique no botão Destacar que é exibido no canto superior direito quando você coloca o
ponteiro sobre a legenda.
2. Selecione um item na legenda:
3. Você pode manter pressionada a tecla Ctrl no teclado para selecionar vários itens na
legenda. Desative o destaque de legenda selecionando o botão Destacar novamente.
Ações de destaque
Algumas exibições podem ter Ações de destaque, que destacam dados relacionados em uma
ou mais exibições baseadas na sua seleção em uma exibição de origem. As Ações de
destaque são basicamente usadas em exibições de painel onde várias exibições são
mostradas de uma vez. Por exemplo, na exibição de painel abaixo há uma ação de destaque
configurada para destacar a Região. Quando Oeste é selecionada na dispersão, todas as
outras exibições destacam a categoria Oeste.
Dependendo de como a exibição foi criada, as Ações de destaque podem ser iniciadas
selecionando uma marca, deixando o ponteiro sobre uma marca ou na dica de tela que é
exibida quando você coloca o ponteiro sobre uma marca para um período de tempo.
Marcar exibições
Uma marca é a palavra-chave que descreve uma exibição e pode ajudar a categorizar e
encontrar exibições. Os autores podem adicionar marcas às exibições quando eles as
publicam. Uma vez publicada a exibição no Tableau Server, você pode adicionar marcas a
qualquer exibição acessível e pode excluir as marcas que você tenha adicionado. Em uma
exibição publicada, a caixa de texto Marcas está localizada abaixo da exibição:
Adicionar marcas
Você pode adicionar marcas a qualquer exibição no servidor à qual tenha permissão de
acessar. As marcas não diferenciam letras maiúsculas e minúsculas e são convertidas em
letras minúsculas quando você as adiciona.
Para adicionar marcas a uma única exibição:
Digite uma ou mais palavras na caixa de texto Marcas abaixo da exibição e clique em
Adicionar. As palavras podem ser separadas por espaços ou vírgulas.
Para adicionar marcas a várias exibições:
Se você tiver um nível de licença Interagente, também será possível adicionar marcas a várias
exibições de uma vez.
1. Navegue para uma lista de exibições ou pastas de trabalho.
2. Selecione as exibições que você quer marcar e clique em Marca na parte superior da
página. Se ainda não existir nenhuma marca, você poderá Adicionar uma:
Se já existir marcas, selecione uma:
Excluir marcas
É possível excluir todas as marcas que você tenha criado.
1. Abra a exibição marcada.
2. Role até a caixa de texto Marcas abaixo da exibição.
3. Clique no ‘x’ próximo à marca que deseja remover.
Comentários sobre exibições
É possível adicionar comentários a qualquer exibição à qual você tenha acesso no Tableau
Server. Também é possível ver qualquer comentário associado a uma exibição específica.
Digite seu texto na caixa de texto Comentário localizada abaixo da exibição e clique em
Adicionar.
É possível adicionar formatação ao comentário inserindo hiperlinks, negrito, itálico e
sublinhado. Exemplos de como adicionar cada um desses tipos de formatação são mostrados
na tabela abaixo.
Formato
O que digitar
Exemplo
Hiperlink
“Meu link”:
http://www.tableausoftware.com
Meu link
Negrito
*Bold Text*
Texto em
negrito
Itálico
_Italic Text_
Texto em itálico
Sublinhado +Underlined Text+
Texto sublinhado
Exibições personalizadas (Lembrar minhas alterações)
Talvez você tenha uma exibição na qual precisa fazer as mesmas alterações todas as vezes
que a abre. Por exemplo, você pode aplicar um determinado filtro para incluir apenas dados
relevantes ou pode classificar uma exibição de modo diferente de quando ela foi publicada.
Talvez você também queira manter versões diferentes da mesma exibição — por exemplo,
uma com dois filtros selecionados e outra com apenas um selecionado. Se você tiver um nível
de licença do Interagente, em vez de fazer essas alterações cada vez que abrir a exibição, o
Tableau poderá lembrar das suas alterações como uma ou mais exibições personalizadas.
Também é possível compartilhar ou “anunciar” suas exibições personalizadas para outros
usuários. Os usuários com licenças do Interagente ou Visualizador poderão examinar as
exibições que outros usuários anunciaram.
Consulte os tópicos a seguir para obter mais informações:
Acessar Lembrar minhas alterações
A configuração Lembrar minhas alterações é exibida acima da área de exibições quando
você olha uma exibição publicada pela primeira vez (ou abaixo se você estiver examinando
uma exibição inserida):
Se houver versões personalizadas de uma exibição, na primeira vez que você olhar para a
exibição publicada encontrará Exibição original. Depois que você clicar no menu suspenso e
selecionar uma das exibições personalizadas, o nome dessa exibição será exibido.
Salvar sua exibição personalizada
À medida que você filtra, classifica e interage com uma exibição, um ponto cinza aparece ao
lado do menu Lembrar minhas alterações ou do nome da exibição. O ponto indica que
foram feitas alterações. Use esse menu para salvar suas alterações como uma exibição
personalizada.
Qualquer exibição personalizada que você ou outros usuários criem sempre estará
relacionada à exibição original. À medida que a exibição original é atualizada ou republicada,
versões personalizadas da exibição também são atualizadas. Se a exibição original for
excluída do servidor, suas exibições personalizadas relacionadas também serão excluídas. Se
os filtros forem removidos da exibição original e ela for republicada, esses filtros estarão
indisponíveis nas versões personalizadas da exibição. Se os filtros forem restaurados e a
exibição for republicada, as versões personalizadas da exibição serão restauradas.
Aqui estão mais detalhes sobre como salvar uma exibição personalizada:
1. Abra a exibição individual que você deseja personalizar.
2. Filtre os dados, altere as ordens de classificação, destaque, amplie ou reduza etc.
Clique no link Lembrar minhas alterações ou no nome da exibição personalizada. Em
seguida, digite um nome para sua exibição personalizada e clique em Lembrar.
3.
Para tornar a exibição personalizada aquela que você visualiza por padrão quando abre a
exibição, selecione Alterar o padrão para <nome da exibição personalizada>. A palavra
(Padrão) é exibida à direita do nome da exibição personalizada, indicando que essa versão da
exibição é o padrão.
Anunciar sua exibição personalizada
Por padrão, sua exibição personalizada é privada e você pode vê-la somente na sua lista. Se o
seu nível de licença for Interagente, você poderá optar por anunciá-la para outros usuários.
Qualquer pessoa que tenha acesso à exibição publicada original poderá visualizar sua
exibição personalizada anunciada.
Observação:
Mesmo que você não anuncie sua exibição personalizada, ainda poderá compartilhá-la
copiando a URL ou clicando no botão Compartilhar.
1. Quando você estiver examinando a exibição personalizada que deseja anunciar, clique
no nome da exibição e em Gerenciar exibições personalizadas.
2. Em Gerenciar exibições personalizadas, clique no ícone ao lado do nome da exibição
para alternar entre anunciada e privada. O ícone de uma pessoa indica que ela é
privada e o ícone de duas pessoas
significa que a exibição é anunciada.
3. Clique em Concluído.
Acessar outras exibições personalizadas
Conforme você navega pelas exibições, pode acessar exibições personalizadas salvas e
anunciadas por outras pessoas clicando no link Exibição original. Se o link Exibição
original estiver disponível, isso significa que há versões personalizadas da exibição
disponíveis. Exibições personalizadas de outras pessoas são listadas na seção Outras
exibições personalizadas do menu suspenso.
Tornar sua exibição privada
Você pode tornar uma exibição anunciada privada novamente. Quando uma exibição
personalizada é privada, ela não aparece mais na lista suspensa para outros usuários e
somente você pode vê-la na sua lista.
1. Quando você estiver examinando a exibição personalizada que deseja parar de
anunciar, clique no nome da exibição e clique em Gerenciar exibições
personalizadas.
2. Em Gerenciar exibições personalizadas, clique no ícone ao lado do nome da exibição
para alternar entre compartilhada e privada. O ícone de duas pessoas
ela é anunciada e o ícone de uma pessoa
3. Clique em Concluído.
indica que
significa que a exibição é privada.
Excluir uma exibição personalizada
A qualquer momento, você pode excluir uma exibição personalizada. A remoção da exibição
personalizada não afeta a original.
1. Quando você estiver examinando a exibição personalizada que deseja excluir, clique no
nome da exibição e clique em Gerenciar exibições personalizadas.
2. Em Gerenciar exibições personalizadas, clique no x à direita do nome da exibição
personalizada.
3. Após a remoção de uma exibição personalizada, você pode clicar em Desfazer para
restaurá-la. O botão Desfazer não está disponível depois que você clica em Concluído.
4. Clique em Concluído. A exibição personalizada é removida.
Editar e criar exibições
Os usuários com as credenciais apropriadas para o ambiente de edição da Web podem editar
pastas de trabalho existentes ou criar novas pastas de trabalho.
Quando você entra no Tableau Server, a seção Exibições é exibida por padrão. Exibições a
que você tem acesso são exibidas aqui como resultado dos seguintes processos:
l
l
Um usuário do Tableau Desktop publica a pasta de trabalho contendo a exibição para
Tableau Server.
Um usuário cria a exibição e salva a pasta de trabalho diretamente no ambiente de
edição na Web do Tableau Server.
Quem pode criar, editar e salvar exibições
Os administradores sempre podem editar e salvar pastas de trabalho existentes ou criar novas
pastas de trabalho. Eles também podem atribuir permissões a outros usuários e grupos para
editar e salvar exibições em pastas de trabalho, bem como outras ações que podem ser
realizadas no servidor.
Definir licença do usuário e níveis de publicação
Os administradores atribuem um nível de licença e direitos de usuário quando criam ou
modificam usuários. Para permitir que os usuários editem pastas de trabalho, primeiro
provisione os usuários da seguinte forma:
l
O usuário deve ter o nível de licença Interagente.
l
O usuário deve receber o direito de usuário Publicar.
Para obter mais informações, consulte Usuários e Licenças e direitos do usuário.
Permitir edição e gravação de pastas de trabalho
Depois de configurar usuários ou grupos, definir níveis de licença e conceder direitos de
publicação, você precisa definir permissões nos níveis de projeto e pasta de trabalho,
dependendo do tipo de edição que deseja permitir. Na lista de permissões no nível da tarefa
que os administradores podem permitir ou negar usuários e grupos, entre as permissões
primárias para editar e salvar exibições estão as seguintes:
l
l
Edição na Web determina se o usuário pode editar exibições da pasta de trabalho por
meio da criação na Web.
Baixar/salvar como determina se o usuário vê os comandos Salvar e Salvar como
enquanto editam uma exibição, e se conseguem salvar suas alterações em uma nova
pasta de trabalho. Além disso, determina se os usuários podem abrir uma pasta de
trabalho no servidor usando o Tableau Desktop.
l
Gravar/salvar na Web determina se os usuários podem salvar alterações em uma
pasta de trabalho existente no servidor (substitua uma pasta de trabalho).
Para permitir que um usuário ou um grupo salve alterações feitas em pastas de trabalho
existentes ou em pastas de trabalho novas, defina essas três permissões no nível de tarefa de
acordo com as tabelas nas seções a seguir.
Permitir que os usuários salvem alterações feitas em pastas de trabalho existentes e
novas
Permissão
Para o
projeto
Edição na
Permitir
Web
Baixar/salvar
Permitir
como
Gravar/salvar Permitir
Para pastas de trabalho
apropriadas no projeto
Permitir
Permitir
Permitir
Nesse cenário, como as permissões são definidas da mesma maneira para projetos e
pastas de trabalho, caso queira aplicar alterações nas permissões no nível do projeto a
todas as pastas de trabalho dentro do projeto, você pode selecionar Atribuir
permissões ao conteúdo enquanto estiver nas Permissões: Página do projeto.
Permitir que os usuários salvem pastas de trabalho novas, mas não substituam
existentes
Permissão
Para o
projeto
Edição na
Permitir
Web
Baixar/salvar
Permitir
como
Gravar/salvar Permitir
Para pastas de trabalho
apropriadas no projeto
Permitir
Permitir
Negar
Importante: Nesse cenário, as permissões devem ser definidas manualmente em cada
pasta de trabalho. Caso você selecione Atribuir permissões ao conteúdo conforme
descrito em Permitir que os usuários salvem alterações feitas em pastas de trabalho
existentes e novas, as permissões do projeto substituem as permissões da pasta de
trabalho, o que concede aos usuários acesso para salvar alterações feitas em pastas de
trabalho existentes.
Permissões para exibições dentro das pastas de trabalho
As permissões para exibições em pastas de trabalho são herdadas das permissões da pasta
de trabalho quando um usuário publica uma pasta de trabalho usando o Tableau Desktop.
Caso um usuário selecione Mostrar folhas como guias ao publicar uma pasta de trabalho
usando o Tableau Desktop ou ao salvá-la no Tableau Server, as permissões da pasta de
trabalho substituem as permissões em exibições individuais até a pasta de trabalho ser salva
novamente sem guias.
Para obter mais informações, consulte Permissões e também o artigo da base de dados de
conhecimento Criação de permissões com base em projeto.
Caso não seja um administrador, você pode descobrir se está autorizado a editar uma
exibição abrindo-a e, em seguida, verificando se um comando Editar é exibido acima
da área do visualizador.
Criar uma pasta de trabalho e criar uma exibição
Você pode criar uma nova exibição criando uma nova folha em uma pasta de trabalho
existente ou criando uma nova pasta de trabalho. Este tópico mostra como criar uma exibição
em uma nova pasta de trabalho.
O procedimento a seguir usa a fonte de dados de exemplo Superstore que acompanha o
Tableau Desktop, além de ser publicada em Tableau Server, para criar uma exibição que
incorpora informações sobre vendas por categoria e região. Caso tenha acesso à fonte de
dados de exemplo Superstore, você pode seguir as etapas no procedimento.
1. Na guia Conteúdo, selecione Fontes de dados.
2. Na lista de fonte de dados, marque a caixa de seleção próxima à fonte de dados que
você deseja visualizar e, em seguida, selecione Nova pasta de trabalho.
Uma exibição nova, em branco, é aberta no ambiente de criação do Tableau Server.
3. No painel Medidas, arraste Vendas para a divisória Colunas.
4. No painel Dimensões, expanda Produto para exibir suas subcategorias e, em seguida,
arraste Categoria para a divisória Linhas.
O Tableau agora tem o suficiente para converter os dados em uma visualização
(exibição), neste caso, um gráfico de barras horizontais.
5. No painel Dimensões, arraste Região para a divisória Linhas.
A exibição agora contém outra camada de dados – as categorias são dividias por
região.
Agora suponhamos que você queira exibir e comparar vendas por categoria em uma
única região. Você pode fazer isso usando um filtro.
6. No painel Dimensões, arraste Região para a divisória Filtros.
Quando você focaliza a divisória Filtros, um pequeno triângulo à esquerda do campo
indica que é possível soltar Região na divisória.
Um controle Filtro é exibido na margem direita da página.
7. Desmarque as caixas de seleção de todas as regiões, exceto a região que você deseja
analisar e, em seguida, marque-as novamente.
8. Você pode aprimorar a visualização usando cores. Arraste Região para Cor no cartão
Marcas.
Você agora tem uma visualização útil que permite comparar vendas de diferentes
categorias de produto entre regiões:
Dica: Para aprender a selecionar uma paleta de cores diferente para as barras
ou redimensioná-las, consulte Cartão Marcas.
9. Em vez de se concentrar nas vendas regionais de cada produto, talvez você prefira uma
exibição que permita analisar mais facilmente as vendas de produto gerais de uma
região. Na divisória Linhas, arraste Região à esquerda de Categoria.
A exibição é atualizada para mostrar vendas de todos os produtos por região.
10. Caso ache que prefere a versão anterior da exibição, você pode clicar em Desfazer na
Barra de ferramentas.
11. Caso você queira criar uma segunda planilha, selecione a guia Nova planilha na parte
inferior da exibição.
Selecione a guia da planilha e selecione Renomear planilha para dar a ela um nome
mais descritivo.
12. Clique em Salvar para salvar a pasta de trabalho. Na caixa de diálogo Salvar pasta de
trabalho, conclua as seguintes etapas:
l Especifique o nome da pasta de trabalho e deixe Projeto definido como Padrão.
l Selecione Mostrar folhas como guias caso você tenha criado várias folhas e
queira que suas guias sejam exibidas na parte inferior da exibição.
l Selecione Inserir senha para fonte de dados caso você queira que os
usuários que não tenham uma conta no banco de dados possam ver a exibição.
l Quando terminar, clique em Salvar.
Editar uma exibição
Na seção Exibições, você pode abrir uma exibição para edição de uma das seguintes
maneiras:
l
l
Clique em Editar na dica de ferramenta exibida quando você focaliza uma exibição.
Selecione uma exibição para mostrá-la e, em seguida, clique em Editar na parte
superior da exibição.
Se a pasta de trabalho tiver uma conexão de banco de dados ativa, você será solicitado a
autenticar.
Tableau Server Edição de ambiente
O ambiente de edição na Web do servidor é semelhante ao do Tableau Desktop. A janela
Dados é exibida no lado esquerdo, mostrando os nomes das fontes de dados incluídas na
pasta de trabalho, além dos campos, parâmetros e conjuntos incluídos na fonte de dados
ativa.
Da mesma forma, na área principal, uma barra de ferramentas é exibida na parte superior,
cartão Marcas, divisórias Páginas e Filtros à esquerda da exibição, além das divisórias
Colunas e Linhas acima da exibição. Todas as guias de folha incluídas na pasta de trabalho
são exibidas na parte inferior da exibição.
Ao abrir uma exibição para edição, você pode editar as outras exibições na mesma pasta de
trabalho, mas não painéis. Você também pode selecionar a guia Nova Folha para começar a
criar uma nova exibição.
Para ver detalhes sobre como usar cada um desses componentes para editar exibições,
consulte os tópicos listados na parte inferior deste tópico.
Gravação ou descarte das alterações
Enquanto trabalha com uma exibição, você pode salvar ou descartar alterações a qualquer
momento, usando os links acima da área de exibição.
Ao salvar seu trabalho, mesmo que tenha entrado no ambiente de edição usando uma
exibição única, a pasta de trabalho completa é salva, inclusive outras exibições que você
possa ter editado ou não.
l
l
l
l
Salvar substitui a pasta de trabalho original.
Salvar como cria uma nova pasta de trabalho no mesmo projeto.
Caso você queira manter a versão original de uma exibição e sua versão editada, use
Salvar como para criar uma nova pasta de trabalho.
Reverter descarta edições e retorna à versão salva mais recentemente de uma
exibição.
Concluído deixa o ambiente de edição.
Se tiver alterações não salvas, você deverá salvá-las. Caso opte por não salvar
alterações, as alterações não salvas continuam presentes quando você retorna ao
modo de edição da exibição durante o tempo em que permanece na sessão do servidor
atual.
A maneira como você pode salvar pastas de trabalho depende das permissões concedidas
pelo administrador. Para obter mais informações, consulte Quem pode criar, editar e salvar
exibições.
Barra de ferramentas
Ao editar uma exibição, você pode usar a barra de ferramentas na parte superior da exibição
para realizar ações em comum.
Desfazer/Refazer
Desfazer e refazer uma ação ou uma série de ações. Você pode desfazer ou refazer
praticamente qualquer tipo de alteração selecionando esses botões da barra de ferramentas.
Pausar atualizações
Quando você coloca um campo em uma divisória, o Tableau gera a exibição consultando a
fonte de dados. Caso as atualizações pareçam lentas durante a edição da exibição, você pode
pausar as atualizações enquanto faz uma série de edições e, em seguida, reativá-las.
Trocar
Isso move os campos da divisória Linhas para a divisória Colunas e vice-versa. Mais usado
com tipos de exibição que se baseiam em eixos x e y.
Totais
Você pode calcular automaticamente totais gerais e subtotais para os dados em uma exibição.
Selecione Totais para ver quatro opções:
l
l
Mostrar totais gerais da coluna Adiciona uma linha que mostra os totais de todas as
colunas da exibição.
Mostrar totais gerais da linha Adiciona uma coluna que mostra os totais de todas as
linhas da exibição.
l
l
Adicionar todos os subtotais Insere linhas e colunas de subtotal na exibição, caso
você tenha várias dimensões em uma coluna ou linha.
Remover todos os subtotais Remove linhas ou colunas de subtotal.
Mostrar/ocultar rótulos
Marque para mostrar ou ocultar rótulos de marca na exibição.
Tamanho da exibição
Use as opções em Tamanho de exibição para alterar as proporções de sua exibição dentro
da janela do navegador, além de avançar e voltar entre a exibição de detalhes e a exibição de
toda a imagem. Os comandos Tamanho da célula têm efeitos diferentes, dependendo do tipo
de visualização.
Planilha
Contém opções para fazer alterações no nível da planilha. Crie planilhas, modifique nomes de
folha, limpe a formatação de folha ou limpe a folha toda.
Exportar
Use as opções em Exportar para capturar partes da exibição a serem usadas em outros
aplicativos.
l
l
l
l
Imagem: Mostra a exibição ou o painel como uma imagem em uma nova guia do
navegador.
Dados: Exibe os dados da exibição em uma nova janela do navegador com duas guias:
Resumo, que mostra dados agregados para os campos mostrados na exibição, e
Subjacente, que mostra dados subjacentes para as marcas selecionadas na
visualização. Caso a nova janela não abra, você talvez precise desabilitar o bloqueador
de pop-ups de seu navegador.
Tabela de referência cruzada: Salva os dados subjacentes para as marcas
selecionadas na visualização em um arquivo CSV (valores separados por vírgulas) que
pode acabar sendo aberto no Microsoft Excel.
PDF: Abre a exibição atual como um PDF em uma nova janela do navegador. A partir
daí, você pode salvá-la em um arquivo. Caso a nova janela não abra, você talvez
precise desabilitar o bloqueador de pop-ups de seu navegador.
Mostre-me
Abre um controle que mostra um intervalo dos tipos de visualização que você pode usar no
Tableau. Quando você exibe a lista Mostre-me, os dados usados atualmente na exibição
determinam quais tipos de visualização estão disponíveis para seleção. Você também pode
focalizar um tipo de visualização para ver quais tipos de campo são obrigatórios para
disponibilizar esse tipo de visualização.
Janela Dados
Na parte superior da janela Dados está uma lista das fontes de dados disponíveis para a pasta
de trabalho. Se você estiver editando uma pasta de trabalho existente, poderá haver várias
fontes de dados. Selecione uma fonte de dados para ver as dimensões e as medidas para
essa fonte de dados. Se estiver criando uma nova pasta de trabalho, verá apenas a fonte de
dados a partir da qual você criou a pasta de trabalho.
Todas as fontes de dados contêm campos. Esses campos aparecem abaixo da lista de fontes
de dados na janela Dados. As dimensões e as medidas sempre aparecem, outros tipos de
campos aparecerão se estiverem presentes na fonte de dados:
l
l
l
l
Dimensões são campos que contêm dados qualitativos discretos. Exemplos de
dimensões incluem: datas, nomes de clientes e segmentos de cliente.
Medidas são campos que contêm dados numéricos que podem ser agregados.
Exemplos de medidas incluem vendas, lucro, número de funcionários, temperatura,
frequência e pressão.
Conjuntos são campos personalizados que definem um subconjunto de dados com
base em algumas condições. Um conjunto pode ser baseado em uma condição
computada, que é atualizada à medida que os dados são alterados, uma lista constante
de valores. Os conjuntos podem estar presentes em pastas de trabalho que você edita,
mas você não pode criar conjuntos.
Parâmetros são valores dinâmicos que podem substituir valores constantes em
cálculos, filtros e linhas de referência. Os parâmetros podem estar presentes em pastas
de trabalho que você edita, mas você não pode criar parâmetros.
Para criar visualizações, arraste campos da janela Dados para as divisórias Linhas e Colunas,
o cartão Marcas ou uma das outras divisórias disponíveis. Para ver uma demonstração,
consulte Criar uma pasta de trabalho e criar uma exibição.
Divisórias Colunas e Linhas
Arraste os campos para a divisória Colunas para criar as colunas de uma tabela, ou para a
divisória Linhas para criar as linhas de uma tabela. Você pode arrastar vários campos para
cada divisória.
Os valores discretos (geralmente, dimensões) são exibidos em azul nas divisórias Colunas e
Linhas; os valores contínuos (geralmente, medidas) são exibidos em verde.
Na extremidade direita de cada campo que você coloca na divisória Colunas ou Linhas está
um menu suspenso que você pode usar para configurar a dimensão ou medida:
As opções disponíveis dependem do tipo de campo. A lista completa de opções inclui:
l
Incluir na dica de ferramenta
Por padrão, todos os campos na divisória Colunas e Linhas estão incluídas nas dicas de
ferramentas que aparecem quando você passa seu mouse sobre uma ou mais marcas
na exibição. Desmarque esta opção para remover um campo das dicas de ferramentas.
l
Mostrar filtro
Escolha essa opção para adicionar um filtro para esse campo para a exibição. Os
usuários em seguida poderão especificar quais dados serão incluídos e excluídos para
essa dimensão ou medida.
l
Discreto/contínuo
Use essas opções para converter um intervalo contínuo de valores em um conjunto de
valores discretos, ou um conjunto discreto em um intervalo contínuo.
l
Dimensão/atributo/medida
Use este intervalo de opções para converter uma dimensão para uma medida ou uma
medida para uma dimensão.
Você também pode definir a opção como um Atributo, que retorna o valor da expressão
especificada se ela tiver apenas um único valor para todas as linhas no grupo; caso
contrário exibirá um caractere de asterisco (*). Os valores nulos são ignorados.
l
Cálculo de tabela rápido
Fornece um conjunto de opções para redefinir o significado das marcas para o valor.
l
Remover
Remove o valor da divisória Colunas ou Linhas.
Opções para dimensão de data
Um conjunto adicional de opções está disponível para dimensões de data:
Escolha uma das opções do grupo superior para definir a granularidade dos dados como
valores discretos. Por exemplo, se você escolher Mês, sua exibição combinará os dados para
cada mês especificado em seus dados no intervalo inteiro de anos:
Há exatamente doze marcas nos dados, uma para cada mês. A marca de novembro combina
os dados de novembro de 2008, novembro de 2009 etc.
Escolha uma das opções do grupo inferior para definir a granularidade dos dados como
valores contínuos. Por exemplo, se você escolher Mês, sua exibição mostrará seus dados
sequencialmente, sobre o intervalo de meses disponíveis.
Nesse caso, há 48 marcas nos dados, uma para cada mês desde novembro de 2008.
Cartão Marcas
Quando você arrasta campos para a exibição, os dados são exibidos com marcas. Cada
marca representa a interseção de todas as dimensões na exibição. Por exemplo, em uma
exibição com as dimensões Region e Year, há uma marca para cada combinação desses dois
campos (East 2011, East 2012, West 2011, West 2012).
As marcas podem ser exibidas de muitas formas diferentes, incluindo linhas, formas, barras,
mapas e assim por diante. Você pode mostrar informações adicionais sobre os dados usando
propriedades de marca tais como cor, tamanho, forma, rótulos etc. O tipo de marca a ser
usada e as propriedades de marca são controladas pelo cartão Marcas. Para mostrar mais
dados, arraste campos para o cartão Marcas. Por exemplo, a mesma exibição de cima é
mostrada novamente, mas desta vez com Profit em Cor. Com essa informação adicional, ficou
evidente que a região sul não era lucrativa em 2010.
Controle as marcas na exibição usando o cartão Marcas. Use o menu suspenso para
especificar o tipo de marca a ser mostrada. Arraste campos para o cartão Marcas e use os
controles do menu suspenso para adicionar mais informações à exibição e controlar cor,
forma, tamanho, rótulos e número de marcas na exibição.
Tipos de marca
Os tipos de marca estão disponíveis no menu suspenso do cartão Marca.
Propriedades de marca
Você pode controlar as cores, o tamanho, a forma e outras propriedades das marcas na
exibição. Arraste um campo para uma propriedade no cartão Marcas para codificar as marcas
usando seus dados.
As propriedades disponíveis variam entre os tipos de marca. Por exemplo, a propriedade
Forma está disponível apenas para o tipo de marca Forma e a propriedade Ângulo está
disponível apenas para o tipo de marca Pizza.
As propriedades são:
Propriedade
Descrição
Codifica dados atribuindo diferentes cores às marcas em uma
exibição de dados com base nos valores de um campo.
Paletas de cores quantitativas são aplicadas a campos contínuos,
como uma medida de lucro. Paletas categóricas são aplicadas a
campos discretos, como um campo que representa regiões
geográficos.
Altere a paleta de cores ou a transparência selecionando Cor e, em
seguida, usando o controle da paleta e o controle deslizante.
Cor
Tamanho
Separa marcas de acordo com os membros em uma dimensão e
atribui um tamanho exclusivo a cada membro. Como o tamanho tem
uma ordem inerente (de pequeno a grande), os tamanhos
categóricos funcionam melhor para dados organizados, como anos
ou trimestres.
Para alterar o tamanho geral de marcas na exibição, selecione
Tamanho e arraste o controle deslizante.
Codifica dados atribuindo rótulos de texto às marcas. Quando você
trabalha com uma tabela de texto, essa propriedade é chamada de
Texto e mostra os números associados a uma exibição de dados.
Para exibir ou ocultar os rótulos em marcas, selecione Rótulo e, em
seguida, marque ou desmarque a caixa de seleção.
Rótulo/texto
Detalhe
Quando você coloca uma dimensão na divisória Linhas ou Colunas,
os membros categorizados criam cabeçalhos de tabela. Os
cabeçalhos representam níveis de detalhe porque separam as
linhas da fonte de dados em categorias específicas. Você pode
identificar cada categoria pelo nome do membro.
A propriedade Detalhe também permite separar as marcas em uma
exibição de dados de acordo com os membros (níveis de detalhe) de
uma dimensão. Entretanto, ao contrário das divisórias Linhas e
Colunas, essa propriedade não modifica a estrutura da tabela.
Dica de ferramenta
Adiciona o nome do campo e o valor à dica de ferramenta para cada
marca.
Caminho
Permite codificar dados por marcas de conexão usando uma
determinada ordem de desenho. Você pode codificar dados por
caminho usando uma dimensão ou uma medida. Quando você
coloca uma dimensão na divisória Caminho, o Tableau conecta as
marcas de acordo com os membros da dimensão. Se a dimensão for
uma data, a ordem de desenho será especificada de acordo com a
ordem de data. Se houver determinadas palavras na dimensão,
como nomes de cliente ou tipos de produto, a ordem de desenho
será fornecida pela ordem dos membros na fonte de dado. Quando
você coloca uma medida na divisória Caminho, o Tableau conecta
as marcas de acordo com os valores da medida.
A propriedade Caminho só permanece disponível quando você
seleciona o tipo de marca de linha ou polígono no menu Marca.
Forma
Separa as marcas de acordo com os membros da dimensão e atribui
uma forma exclusiva a cada membro.
Divisória Filtros
Use a divisória Filtros para especificar quais dados serão incluídos e excluídos para uma
dimensão ou medida. Por exemplo, talvez você queira analisar o lucro de cada segmento de
cliente, mas somente de alguns contêineres de envio e tempos de entrega. Ao colocar a
dimensão Contêiner na divisória Filtros, você pode especificar quais contêineres serão
incluídos. Da mesma forma, você pode colocar o campo Data de Entrega na divisória Filtros
para definir quais tempos de entrega serão incluídos.
Quando você arrasta uma dimensão ou medida para a divisória Filtros, o Tableau
automaticamente insere um controle de filtro na exibição para selecionar os valores a serem
exibidos. Por exemplo:
Para dimensões, o controle de filtros mostra valores discretos, conforme mostrado acima.
Para medidas, o controle mostra um intervalo contínuo:
Focalize o cursor do mouse à direita do título para o controle de filtro especificar como os
valores no controle deverão ser exibidos:
Divisória Páginas
Arraste uma dimensão ou medida para a divisória Páginas para dividir uma exibição em uma
série de páginas para que se possa analisar melhor como um campo específico afeta o
restante dos dados em uma exibição. Arrastar uma dimensão para a divisória Páginas é como
adicionar uma nova linha para cada membro na dimensão. Arrastar uma medida para a
divisória Páginas automaticamente converte a medida em uma medida discreta que pode ser
quebrada em páginas individuais.
Quando você arrasta uma dimensão ou medida para a divisória Páginas, o Tableau
automaticamente insere um controle na exibição para permitir navegar nas páginas em sua
exibição. Por exemplo:
Você pode avançar manualmente pelas sequência de páginas em qualquer uma das
seguintes maneiras:
l
l
l
Use o menu suspenso para selecionar um valor.
Use os botões de avançar e voltar nos dois lados da lista suspensa para navegar pelas
páginas uma de cada vez.
Use o controle deslizante de página para rolar rapidamente para frente ou para trás na
sequência de páginas.
Selecione Mostrar histórico para mostrar as marcas de páginas anteriores além das marcas
para a página atual.
Dicas de ferramenta
Coloque o cursor sobre uma marca na exibição para ver a dica de ferramenta para essa
marca.
As dicas de ferramentas fornecem informações sobre os valores das dimensões e medidas
para a marca selecionada:
As dicas de ferramentas também fornecem essas opções:
l
Manter apenas
Excluir todas as marcas da exibição exceto esta.
l
Excluir
Excluir apenas esta marca.
l
Agrupar membros
Escolha o ícone de clipe de papel para criar um novo grupo, que é uma dimensão, da
marca selecionada. Geralmente, você selecionaria várias marcas e, em seguida, criaria
um grupo. Por exemplo, se você tivesse uma dimensão Região com valores Norte, Sul,
Leste e Oeste, poderia selecionar Sul e Oeste e, em seguida, criar um grupo a partir
deles.
l
Exibir dados
Escolha o ícone de tabela para abrir uma nova janela de navegador para exibir duas
guias: Resumo, que mostra somente os dados para a marca atual, e Subjacente, que
mostra os dados para a exibição inteira.
Trabalhar com permissões
O que você pode fazer com exibições, pastas de trabalho, projetos e fontes de dados no
Tableau Server é controlado por seu nível de licença (especificado por um administrador) e as
permissões definidas pelo autor da exibição ou fonte de dados.
Você poderá alterar permissões para um item se tiver um nível de licença Interagente e, pelo
menos, uma das afirmações a seguir for verdadeira:
l
Você é o proprietário da pasta de trabalho ou fonte de dados (você a publicou no
servidor).
l
Você recebeu a permissão Definir permissões.
l
Você recebeu a permissão Líder do projeto para o projeto que contém o item.
l
Você recebeu o direito Admin.
Consulte os tópicos a seguir para obter mais informações:
Como as permissões são definidas
O diagrama abaixo ilustra como as permissões são avaliadas.
Se uma pasta de trabalho for configurada para mostrar folhas como guias, todas as
exibições herdarão as permissões da pasta de trabalho, mesmo que diferentes
permissões sejam especificadas em uma exibição individual.
Definir permissões para pastas de trabalho e exibições
Siga as etapas abaixo para definir permissões para uma pasta de trabalho ou exibição.
1. Em uma página que exiba uma ou mais pastas de trabalho, ou uma ou mais exibições,
clique para selecionar uma ou mais pastas de trabalho ou exibições e, em seguida,
clique em Permissões:
2. Clique em Adicionar/editar permissões na página Permissões: Pasta de trabalho ou
Permissões: Exibição:
A opção Atribuir permissões para conteúdo é mostrada para pastas de
trabalho, mas não para exibições.
3. Na janela Adicionar/editar permissões, selecione um usuário ou grupo na listagem à
esquerda:
Você pode configurar a lista para mostrar usuários, grupos ou ambos.
4. Selecione uma função predefinida no menu suspenso Função ou especifique
permissões individuais na área abaixo. A lista de permissões e as funções predefinidas
variam um pouco dependendo do fato de você estar definindo permissões para uma
pasta de trabalho ou uma exibição. Consulte Permissões para ver uma tabela que
define as várias permissões e os itens aos quais elas se aplicam.
As funções disponíveis para pastas de trabalho e exibições são:
Função
Visualizador
Aplicase a...
pastas de
trabalho
exibições
Interagente
pastas de
trabalho
exibições
Editor
pastas de
trabalho
exibições
Conector de fonte
de dados
Editor de fonte de
dados
Descrição
Permite que o usuário ou grupo veja a pasta de
trabalho ou exibição no servidor.
Permite que o usuário ou grupo veja a pasta de
trabalho ou exibição no servidor, edite exibições
de pasta de trabalho, aplique filtros, veja dados
subjacentes, exporte imagens e exporte dados.
Todas as outras permissões são herdadas das
permissões de projeto do grupo ou do usuário.
Concede todas as permissões ao usuário ou
grupo
exibições
Permite que o usuário ou grupo se conecte à fonte
de dados no servidor. Essa permissão é relevante
para exibições no acesso a uma exibição que se
conecta a uma fonte de dados.
exibições
Permite que o usuário ou grupo se conecte às
fontes de dados no servidor. Além de publicar,
editar, baixar, excluir e definir permissões para
uma fonte de dados e agendar atualizações das
fontes de dados que você publicar. Essa
permissão é relevante para exibições no acesso a
uma exibição que se conecta a uma fonte de
dados.
5. É possível configurar permissões para um usuário ou grupo, ou para vários usuários e
grupos. Ao terminar, clique em Enviar.
Definir permissões para uma fonte de dados
Siga as etapas abaixo para definir permissões para uma fonte de dados.
1. Na página Fontes de dados, clique para selecionar uma ou mais fontes de dados e, em
seguida, clique em Permissões.
2. Clique em Adicionar/editar permissões na página Permissões: Fonte de dados:
3. Na janela Adicionar/editar permissões, selecione um usuário ou grupo na listagem à
esquerda:
4. Selecione uma função predefinida no menu suspenso Função ou especifique
permissões individuais na área abaixo. Consulte Permissões para ver uma tabela que
define as várias permissões e os itens aos quais elas se aplicam.
As funções disponíveis para fontes de dados são:
Função
Descrição
Conector de fonte de
dados
Permite que o usuário ou grupo se conecte à fonte de dados
no servidor.
Editor de fonte de
dados
Permite que o usuário ou grupo se conecte às fontes de
dados no servidor. Além de publicar, editar, baixar, excluir e
definir permissões para uma fonte de dados e agendar
atualizações das fontes de dados que você publicar.
5. É possível configurar permissões para um usuário ou grupo, ou para vários usuários e
grupos. Ao terminar, clique em Enviar.
Definir permissões para um projeto
Administradores e Líderes de projeto podem especificar permissões de projeto. Quando você
cria um novo projeto, ele tem as mesmas permissões que o projeto Padrão. É possível definir
permissões para o projeto a fim de conceder ou negar permissão a usuários individuais ou
grupos para acessar o projeto. Para especificar permissões de projeto:
1. Clique em Admin >Projetos.
2. Clique para selecionar um ou mais projetos clique em Permissões:
3. Clique em Adicionar/editar permissões na página Permissões: Projeto:
4. Na janela Adicionar/editar permissões, selecione um usuário ou grupo na listagem à
esquerda:
Você pode configurar a lista para mostrar usuários, grupos ou ambos.
5. Selecione uma função predefinida no menu suspenso Função ou especifique
permissões individuais na área abaixo. Consulte Permissões para ver uma tabela que
define as várias permissões e os itens aos quais elas se aplicam.
As funções disponíveis para projetos são:
Função
Descrição
Visualizador
Permite que o usuário ou grupo veja as pastas de trabalho e
exibições no projeto.
Interagente
Permite que o usuário ou grupo veja as pastas de trabalho e
exibições no projeto, edite exibições de pasta de trabalho,
aplique filtros, veja dados subjacentes, exporte imagens e
exporte dados.
Editor
Concede todas as permissões ao usuário ou grupo
Conector de fonte de
dados
Permite que o usuário ou grupo se conecte às fontes de
dados no projeto.
Editor de fonte de
dados
Permite que o usuário ou grupo se conecte às fontes de
dados no projeto. Além de publicar, editar, baixar, excluir e
definir permissões para uma fonte de dados e agendar
atualizações das fontes de dados que você publicar. Essa
permissão é relevante para exibições no acesso a uma
exibição que se conecta a uma fonte de dados.
Líder do projeto
Permite que o usuário ou grupo defina permissões para todos
os itens de um projeto.
Publicador
Concede ao usuário ou grupo todas as permissões
necessárias para publicar pastas de trabalho no servidor.
As permissões que você especificar se aplicam ao projeto em si. As permissões explícitas
definidas nas pastas de trabalho, exibições e fontes de dados no projeto não são afetadas. No
entanto, você tem a opção de atribuir permissões de projeto a todas as pastas de trabalho,
exibições e fontes de dados do projeto. Nesse caso, essas permissões substituem as
permissões existentes nas pastas de trabalho e exibições. Por exemplo, digamos que há
várias pastas de trabalho que foram publicadas com permissões personalizadas e você
agrupa as pastas de trabalho em um novo projeto com um novo conjunto de permissões. É
possível aplicar as novas permissões a cada uma das pastas de trabalho clicando em Atribuir
permissões para conteúdo na página Permissões.
Verificar permissões atuais
A qualquer momento, você pode ver permissões de um usuário para uma exibição, uma pasta
de trabalho, um projeto ou uma fonte de dados específica. Em qualquer página em que você
possa definir permissões, selecione um usuário na lista suspensa Verificar permissões de
usuário.
As permissões mostradas são específicas à exibição, à pasta de trabalho, à fonte de dados ou
ao projeto que você selecionou.
Permissões
Os administradores e outros usuários autorizados podem permitir ou negar permissões em
ações que os usuários podem executar no Tableau Server. As permissões também podem ser
definidas no Tableau Desktop durante a publicação de uma pasta de trabalho ou fonte de
dados no Tableau Server.
Os administradores sempre têm controle total de todos os ativos no Tableau Server, e os
administradores de site têm controle total de todos os ativos em um site. Se você publicar uma
pasta de trabalho ou fonte de dados no Tableau Server, será o publicador desse ativo, e terá o
controle total sobre ele.
A tabela a seguir mostra que permissões aplicar a que itens no Tableau Server, e descreve as
ações que os usuários podem executar com cada permissão.
Permissão
Afeta...
pastas de
trabalho
Exibir
fontes de
dados
exibições
projetos
Quando autorizados, os usuários podem...
Exibir o item no Tableau Server. Um usuário que
acessa uma exibição que se conecta a uma fonte de
dados deve ter as permissões Exibir, para a pasta de
trabalho, e Conectar, para a fonte de dados.
Permissão
Afeta...
Quando autorizados, os usuários podem...
Editar exibições em pastas de trabalho. Consulte
Quem pode criar, editar e salvar exibições.
pastas de
trabalho
Edição na Web
exibições
projetos
pastas de
trabalho
Gravar/salvar na
Web
fontes de
dados
exibições
Baixar/salvar na
As permissões para planilhas (exibições) em uma
pasta de trabalho são copiadas (substituídas) das
permissões da pasta de trabalho quando você publica
uma pasta de trabalho do Tableau Desktop. Elas
também são copiadas quando você clica em Atribuir
permissões para conteúdo na página
Permissões: Pasta de trabalho. Se você selecionar
Mostrar planilhas como guias ao salvar uma pasta
de trabalho, as permissões para todas as planilhas
(exibições) na pasta de trabalho serão substituídas
pelas permissões para a pasta de trabalho, mas
somente até as guias serem desabilitadas.
Consideração especial para o grupo Todos os
usuários: Com o interesse de proteger o conteúdo
de um editor contra a substituição por outro usuário
(seja publicando no Tableau Desktop ou salvando
uma pasta de trabalho editada na Web no Tableau
Server), sempre que um usuário publicar em um
projeto onde o grupo Todos os usuários tiver
permissões, a permissão Gravar/salvar na Web do
grupo Todos os usuários mudará de Permitir para
Herdar por padrão. Você pode modificar
manualmente essa permissão seguindo as etapas
em Definir permissões para pastas de trabalho e
exibições para mudar de Herdar para Permitir.
Substituir o item no servidor. Quando autorizado, o
usuário pode publicar novamente uma pasta de
trabalho ou fonte de dados do Tableau Desktop,
tornando-se assim o editor e adquirindo todas as
permissões. Subsequentemente, o acesso do
publicador original à pasta de trabalho é determinado
pelas permissões do grupo do usuário, além de
qualquer permissão adicional que o novo publicador
decidir definir.
projetos
Essa permissão também determina a capacidade do
usuário ou do grupo de substituir uma pasta de
trabalho depois de editá-la no servidor. Consulte
Quem pode criar, editar e salvar exibições.
pastas de
Quando autorizado, um usuário pode baixar o item do
Permissão
Web como
Afeta...
Quando autorizados, os usuários podem...
trabalho
servidor, e também salvar uma pasta de trabalho
editada como uma nova pasta de trabalho no
servidor. Consulte Baixar pastas de trabalho e Quem
pode criar, editar e salvar exibições.
fontes de
dados
projetos
pastas de
trabalho
Excluir
fontes de
dados
Excluir o item.
exibições
projetos
pastas de
trabalho
Filtrar
exibições
Modificar filtros rápidos, manter apenas filtros e
excluir dados. Consulte Comentários sobre
exibições.
projetos
Adicionar
comentário
pastas de
trabalho
exibições
Adicionar comentários a exibições em uma pasta de
trabalho.
projetos
pastas de
trabalho
Exibir comentários
exibições
Exibir os comentários associados às exibições em
uma pasta de trabalho.
projetos
Exibir dados de
resumo
pastas de
trabalho
exibições
Ver os dados agregados em uma exibição, ou na
seleção do usuário dentro da exibição, e baixar esses
dados como arquivo de texto.
projetos
Exibir dados
subjacentes
pastas de
trabalho
exibições
projetos
Exportar imagem
pastas de
trabalho
exibições
Ver os dados brutos atrás de cada linha de uma
exibição, conforme restritos pelas marcas
selecionadas pelo usuário, e baixar os dados como
arquivo de texto.
Exportar cada exibição como uma imagem. Consulte
Exportar exibições.
Permissão
Afeta...
Quando autorizados, os usuários podem...
projetos
pastas de
Compartilhamento trabalho
personalizado
exibições
projetos
Criar personalizações salvas em uma exibição
disponível para outras pessoas verem. Os usuários
podem criar exibições personalizadas usando a
opção Lembrar minhas alterações no Tableau
Server. Consulte Exibições personalizadas.
pastas de
trabalho
Mover
exibições
Mover pastas de trabalho entre projetos
projetos
pastas de
trabalho
fontes de
Definir permissões dados
exibições
Especificar permissões para o item. Para as pastas
de trabalho, essa permissão se estende às exibições
em uma pasta de trabalho.
projetos
fontes de
dados
Conectar
exibições
projetos
Líder do projeto
projetos
Conectar-se à fonte de dados. Um usuário que
acessa uma exibição que se conecta a uma fonte de
dados deve ter as permissões Exibir, para a exibição,
e Conectar, para a fonte de dados.
Definir permissões para todos os itens de um projeto
e para o próprio projeto.
Guia do administrador
O Guia do administrador é sua referência completa para lidar com tarefas administrativas no
Tableau Server:
Antes da instalação...
Certifique-se de que o computador no qual você está instalando o Tableau Server atende aos
seguintes requisitos:
l
Sistemas operacionais compatíveis — O Tableau Server está disponível em
versões de 32 e 64 bits. Você pode instalar o Tableau Server no Windows Server 2003
(SP1 ou superior), no Windows Server 2008, no Windows Server 2008 R2, no
Windows Server 2012, no Windows Vista, no Windows 7 ou no Windows 8. A versão de
64 bits do Tableau Server em um sistema operacional de 64 bits é recomendada. Você
poderá instalar o Tableau Server em plataformas virtuais ou físicas.
l
Memória, núcleos e espaço em disco — os requisitos de sistema do Tableau Server
variam com base em muitos fatores. As recomendações a seguir se baseiam no número
de usuários no servidor:
Tipo de implantação
Número de usuários
do servidor
CPU
RAM
Avaliação (somente
Tableau Server 32 bits)
1-2
2 núcleos
4 GB
Pequena
<25
4 núcleos
8 GB
Média
<100
8 núcleos
32 GB
Empresarial
>100
16 núcleos
32 GB ou mais
Os requisitos mínimos para executar a versão de 64 bits do Tableau Server são 4
núcleos e 8 GB de RAM.
l
l
l
Conta administrativa: a conta sob a qual você instala o Tableau Server deve ter
permissão para instalação de software e serviços.
Opcional: Conta Run As— a conta de usuário Run As para execução do serviço do
Tableau Server será útil se você estiver usando a autenticação NT com fontes de dados
ou se você estiver planejando fazer representação do SQL Server. Para obter mais
informações, consulte Usuário Run As e Representação do SQL Server.
IIS e porta 80 — o gateway do Tableau Server escuta na porta 80, que também é
usada pelo IIS (Serviços de Informações da Internet) por padrão. Se você estiver
instalando o Tableau Server em um computador que também executa o IIS, deverá
modificar o número da porta do gateway do Tableau para evitar conflito com o IIS.
Consulte Portas TCP/IP e Editar as portas padrão para obter detalhes.
Informações de configuração
Quando você instala e configura o Tableau Server, podem ser solicitadas as seguintes
informações:
Opção
Descrição
Conta de O servidor deve ter uma conta de usuário que o serviço
servidor possa usar. O padrão é a conta interna Serviço de rede do
Windows. Se você usar uma conta de usuário específica,
será preciso o nome do domínio, o nome de usuário e a
senha.
Active
Em vez de usar o sistema interno de gerenciamento de
Directory usuários do Tableau, você pode autenticar por meio do
Active Directory. Se for esse o caso, você precisará do nome
de domínio totalmente qualificado.
Abrir
Quando selecionado, o Tableau Server abrirá a porta usada
Suas
informações
Nome de
usuário:
Senha:
Domínio:
Domínio Active
Directory:
__ - Sim
Opção
Descrição
porta no para solicitações http no Firewall do Windows para permitir
Firewall que outros computadores da sua rede acessem o servidor.
do
Windows
Suas
informações
__ - Não
Portas
Por padrão, o Tableau Server exige que várias portas TCP/IP estejam disponíveis para o
servidor. Veja o tópico Portas TCP/IP para obter a lista completa, inclusive quais portas devem
estar disponíveis para todas as instalações vs. instalações distribuídas ou instalações prontas
para failover. As portas padrão podem ser alteradas se houver um conflito. Consulte Editar as
portas padrão para saber como.
Drivers
Talvez seja preciso instalar drivers de banco de dados adicionais. Baixe os drivers em
www.tableausoftware.com/support/drivers.
Instalar e configurar
Veja as principais etapas que precisam ser seguidas para instalar e configurar o Tableau
Server:
Executar a instalação do servidor
Após baixar o arquivo de instalação do Tableau Server, siga as instruções abaixo para instalar
o servidor.
1. Clique duas vezes no arquivo de instalação.
2. Siga as instruções na tela para concluir a instalação e instale o aplicativo.
3. Após a conclusão da instalação, clique em Avançar para abrir a janela Gerenciador de
chaves de produto.
Se você precisar oferecer suporte a caracteres que não sejam do conjunto Latin-1,
instale os Pacotes de Idiomas do Windows por meio do Painel de controle > Opções
regionais e de idioma. Os pacotes de idiomas precisarão ser instalados no servidor
primário, bem como em qualquer computador de trabalho.
Ativar o Tableau
O Tableau Server exige pelo menos uma chave de produto que ativa o servidor e especifica o
número de níveis de licença que você pode atribuir aos usuários. É possível acessar as chaves
de produto no Centro de contas do cliente do Tableau. Após instalar e configurar o servidor, o
gerenciador de chaves de produto é aberto automaticamente para que seja possível inserir a
chave de produto e registrar o produto. Se precisar ativar o produto em um computador que
esteja off-line, consulte Ativar o Tableau off-line.
1. Selecione Ativar e colar em sua chave de produto:
2. Consulte a página de ajuda de download no site para obter instruções passo a passo.
Ativar o Tableau off-line
Se estiver trabalhando off-line, você pode seguir as etapas abaixo para concluir a ativação offline.
1. Quando o gerenciador de chaves de produto for aberto, clique em Ativar o produto.
Cole sua chave de produto do servidor na caixa de texto correspondente e clique em
Ativar. Você pode obter sua chave do produto no Portal do cliente do Tableau.
2. Quando estiver off-line, a ativação falhará e você terá a opção de salvar um arquivo que
pode ser usado para a ativação off-line. Clique em Salvar.
3. Selecione um local para o arquivo e clique em Salvar. O arquivo é salvo como offline.tlq.
4. De volta no Tableau, clique em Sair para fechar a caixa de diálogo Ativação.
5. Em um computador com acesso à Internet, abra um navegador da Web e visite a página
Ativações de produto no site do Tableau. Complete as instruções para enviar seu
arquivo offline.tlq.
6. A Tableau enviará por e-mail um arquivo chamado activation.tlf. Mova esse arquivo
para o computador em que você está instalando o Tableau Server. Se o Tableau
Desktop estiver instalado no computador, você poderá clicar duas vezes no novo
arquivo para concluir a ativação. Caso você não tenha o Tableau Desktop instalado,
passe para a etapa 7.
7. No computador em que você está instalando o Tableau Server, abra um prompt de
comando como um administrador e execute o seguinte comando:
cd "C:\Program Files\Tableau\Tableau Server\8.1\bin"
8. Em seguida, digite tabadmin activate --tlf <path>\activation.tlf,
onde <path> é o local do arquivo de resposta que a Tableau enviou a você. Por
exemplo:
tabadmin activate --tlf \Desktop\activation.tlf
Deixe a janela do prompt de comando aberta.
9. Depois que a licença é inicializada, você deve reativar o produto. No Tableau Server,
clique em Iniciar > Todos os Programas > Tableau Server 8.1> Gerenciar chaves
de produto.
10. Clique em Ativar o produto.
11. Digite sua chave de produto novamente (a mesma inserida na etapa 1).
12. Salve o arquivo .tlq.
13. Em um computador com acesso à Internet, abra um navegador da Web e visite a página
Ativações de produto novamente no site do Tableau. Complete as instruções.
14. O Tableau enviará novamente um e-mail para você chamado activation.tlf. Mova esse
arquivo para o computador em que você está instalando o Tableau Server.
15. Novamente na janela do prompt de comando do Tableau Server, digite tabadmin
activate --tlf <path>\activation.tlf, em que <path> é o local do
segundo arquivo de resposta que o Tableau enviou para você. Por exemplo:
tabadmin activate --tlf \Desktop\activation.tlf
Agora o Tableau Server está ativado. Caso você precise de assistência adicional, entre
em contato com o Atendimento ao cliente do Tableau.
Configurar o servidor
A caixa de diálogo Configurar é exibida durante a instalação. Você pode abri-la após a
configuração selecionando Todos os Programas > Tableau Server8.1 > Configurar
Tableau Server no menu Iniciar do Windows. É necessário parar o servidor antes de fazer
quaisquer alterações de configuração. Consulte Reconfigurar o servidor para ver as etapas.
Há duas coisas para se ter em mente sobre as configurações que você especificar na caixa de
diálogo Configuração:
l
l
As configurações abrangem todo o sistema: As configurações especificadas se
aplicam a todo o servidor. Se o servidor estiver executando vários sites, essas
configurações afetarão todos os sites.
A autenticação do usuário é "permanente": Todas as configurações podem ser
alteradas após a instalação, interrompendo o servidor e reconfigurando-o. A exceção é
a configuração Autenticação do usuário (guia Geral). Ela é “permanente” no sentido
de que a alteração de Usar autenticação local para Usar Active Directory requer
que você desinstale e reinstale o servidor.
Consulte os tópicos abaixo para obter detalhes sobre diferentes guias de configuração:
Geral
Siga as etapas abaixo para configurar as opções na guia Geral:
1. Por padrão, o Tableau Server é executado sob a conta Serviço de rede. Para usar uma
conta que se adapte à autenticação NT com fontes de dados, especifique um nome de
usuário e uma senha. O nome do usuário deve incluir o nome do domínio. Consulte
Usuário Run As para saber mais sobre como usar uma conta de usuário específica.
2. Selecione se deseja usar o Active Directory para autenticar usuários no servidor.
Selecione Usar autenticação local para criar usuários e atribuir senhas usando o
sistema interno de gerenciamento de usuários do Tableau Server. Não é possível
alternar entre o Active Directory e a Autenticação local posteriormente.
3. Se você usar o Active Directory:
l
l
Você também pode Habilitar logon automático, que usa o Microsoft SSPI para
conectar automaticamente seus usuários com base em seus nomes de usuário e
suas senhas do Windows. Não selecione Habilitar logon automático caso
você pretenda configurar o Tableau Server para SAML ou autenticação confiável.
Certifique-se de digitar o FQDN (nome de domínio totalmente qualificado) e o
apelido.
Para determinar o FQDN: Selecione Iniciar > Executar e digite sysdm.cpl
na caixa de texto Executar. Na caixa de diálogo Propriedades do sistema,
selecione a guia Nome do computador. O FQDN é mostrado próximo do meio
da caixa de diálogo. Na primeira vez em que entrarem, os usuários precisarão
usar o nome de domínio totalmente qualificado (por exemplo,
myco.lan\jsmith). Nas entradas subsequentes, eles podem usar o apelido
(myco\jsmith).
4. A porta padrão de acesso Web ao Tableau Server (via HTTP) é a porta 80. Talvez você
precise mudar o número da porta se tiver outro servidor em execução na porta 80 ou
outras necessidades de rede. Por exemplo, talvez você tenha um firewall de hardware
ou proxy que proteja o host do Tableau Server, o que pode tornar indesejável a
execução de um sistema back-end na porta 80.
5. Selecione se você deseja abrir uma porta no Firewall do Windows. Se você não abrir
essa porta, os usuários em outras máquinas talvez não possam acessar o servidor.
6. Selecione se deseja incluir usuários e dados de exemplo. Os dados de exemplo podem
ajudar você a se familiarizar com o Tableau Server, especialmente se uma versão de
avaliação do produto estiver sendo instalada. Inicialmente, o usuário de exemplo usa
uma licença Interagente. É possível alterar esse usuário para não licenciado para
resgatar níveis de licença. Consulte Licenças e direitos do usuário para saber como. Se
você optar por incluir o usuário de exemplo, um único usuário será instalado. O nome de
usuário e a senha são mostrados abaixo:
Nome de usuário Senha
Tableau Software test
7. Se desejar, passe para a próxima página para configurar as opções Cache e SQL
inicial. Se não desejar configurar essas opções, clique em OK.
Domínios
Quando você estiver usando a autenticação do Active Directory para o servidor, será possível
exibir uma lista dos domínios que estão sendo usados e editar os respectivos nomes de
domínio e apelidos. Talvez seja preciso fazer isso, por exemplo, para garantir que o Tableau
Server esteja usando o apelido correto para autenticação SSPI ou o nome de domínio correto.
Modificar nomes de domínio
Para modificar um nome de domínio:
1. Selecione o link Usuários na área Administração no lado esquerdo da página.
2. Clique no link Domínios na parte inferior da lista de usuários. A lista de domínios mostra
o número de usuários e grupos que foram adicionados ao servidor de cada domínio.
3. Para exibir uma lista de usuários que fazem parte de um domínio, clique no nome do
domínio.
4. Para modificar o nome do domínio ou apelido, clique no link Editar, digite um nome de
domínio totalmente qualificado ou apelido novo e clique em Modificar.
5.
É possível modificar o apelido para qualquer domínio que o servidor esteja
usando. Em geral, você pode modificar o nome de domínio completo de qualquer
domínio, exceto daquele que você usou para entrar. No entanto, caso o nome de
usuário atualmente usado por você para entrar esteja no domínio atual e no novo
domínio, você pode modificar o nome completo do domínio atual.
Conexões de dados
Use as opções na guia Conexões de dados para configurar o cache e especificar como lidar
com as instruções SQL iniciais de fontes de dados.
Cache
As exibições publicadas no Tableau Server são interativas e, às vezes, têm uma conexão ativa
com um banco de dados. Como os usuários interagem com as exibições em um navegador da
Web, os dados que são consultados são armazenados em um cache. As visitas subsequentes
extrairão os dados desse cachê, se ele estiver disponível. A guia Conexões de dados é onde
você configura aspectos de cache que se aplicarão a todas as conexões de dados:
Para configurar o cache, selecione uma das seguintes opções: :
l
l
Atualizar com menos frequência: os dados são armazenados em cache e
reutilizados sempre que estiverem disponíveis, independentemente de quando eles
foram adicionados ao cache. Essa opção otimiza o número de consultas enviadas ao
banco de dados. Selecione essa opção quando os dados não forem alterados com
frequência. A atualização menos frequente pode melhorar o desempenho.
Balanceado: os dados são removidos do cache após um número de minutos
especificado. Se os dados tiverem sido adicionados ao cache dentro do intervalo de
tempo especificado, os dados armazenados em cache serão usados, caso contrário,
novos dados serão consultados no banco de dados.
l
Atualizar com mais frequência: o banco de dados é consultado toda vez que a
página é carregada. Os dados continuam armazenados no cache e serão reutilizados
até que o usuário recarregue a página. Essa opção garantirá que os usuários vejam os
dados mais recentes; no entanto, isso pode baixar o desempenho.
Independentemente de como o cache foi configurado, o usuário pode clicar no
botão Atualizar dados na barra de ferramentas para forçar o servidor a enviar
uma consulta e acessar novos dados.
SQL inicial
Para exibições que se conectam às fontes de dados Teradata, os criadores da pasta de
trabalho podem especificar um comando SQL que será executado uma vez, quando a pasta
de trabalho for carregada no navegador. Isso é chamado de instrução SQL inicial. Por motivos
de segurança ou desempenho, alguns administradores podem querer desabilitar essa
funcionalidade. É possível fazer isso na guia Conexões de dados:
Para desabilitar a funcionalidade SQL inicial, marque a caixa de seleção Ignorar instruções
SQL iniciais para todas as fontes de dados. As pastas de trabalho criadas com as
instruções SQL iniciais continuarão abertas, mas os comandos SQL iniciais não serão
enviados.
Alertas e assinaturas
O Tableau Server pode enviar um alerta por e-mail, caso haja uma falha no sistema, e também
pode enviar assinaturas por e-mail a usuários do Tableau Server, que são instantâneos de
suas exibições favoritas. A guia Alertas e assinaturas é onde você especifica o servidor
SMTP que o Tableau Server usa para enviar e-mail.
Para alertas e assinaturas, conexões SMTP criptografadas não são aceitas.
Configurar alertas de e-mail
Quando você configura alertas, o Tableau Server envia um email aos destinatários em Enviar
e-mail para sempre que os processos do processador de dados, do repositório ou do servidor
de gateway param ou reiniciam, ou sempre que o Tableau Server primário para ou reinicia. Se
você estiver executando uma instalação de servidor único (todos os processos no mesmo
computador), os alertas INATIVO indicam que o servidor inteiro parou, e os alertas de email
ATIVO indicam que o servidor está novamente em execução. Se você estiver executando uma
instalação distribuída que esteja configurada para failover (consulte Configurar para failover e
vários gateways), um alerta INATIVO indica que o repositório ativo ou a instância de
processador de dados falhou, e o alerta ATIVO subsequente indica que a instância em espera
desse processo assumiu o controle e agora está ativa.
Para configurar um alerta de e-mail:
1. Selecione Enviar alertas de e-mail para problemas de integridade do servidor.
2. Em Servidor SMTP, insira o nome do servidor SMTP. Insira um Nome de usuário e
Senha para sua conta de servidor SMTP somente se isso for necessário. O valor da
porta SMTP padr? O valor da porta SMTP padrão é 25. Em Enviar e-mail de, insira o
endereço de e-mail que enviará um alerta se houver uma falha do sistema. Embora o
endereço de e-mail que você digita deva ter uma sintaxe válida (por exemplo,
[email protected] ou noreply@myco), ele não precisa ser também uma conta de email real no Tableau Server.
3. Em Enviar e-mail para, insira pelo menos um endereço de e-mail que receberá os
alertas. Se você inserir vários endereços de e-mail, separe-os com vírgulas (não pontoe-vírgula).
4. Clique em OK. Quando você iniciar o servidor, ele acionará um alerta de e-mail, e este
confirmará que você configurou os alertas corretamente.
Configurar assinaturas de e-mail
Para configurar um servidor SMTP para enviar assinaturas:
1. Selecione Habilitar assinaturas de e-mail.
2. Em Servidor SMTP, insira o nome do servidor SMTP. Insira um Nome de usuário e
Senha para sua conta de servidor SMTP somente se isso for necessário. O valor da
porta SMTP padr? O valor da porta SMTP padrão é 25. Em Enviar e-mail de, insira o
endereço de e-mail que enviará assinaturas para usuários do Tableau Server.
Embora o endereço de e-mail que você digitar deva ter uma sintaxe válida (como em
<text>@<text>, [email protected] ou noreply@myco), o Tableau Server
não requer que seja uma conta de e-mail real (no entanto, alguns servidores SMTP
podem requerer que seja uma conta de e-mail real). Você também pode substituir esse
endereço Enviar e-mail de de todo o sistema em uma base por site para assinaturas.
Consulte Adicionar ou editar sites para obter detalhes.
3. Em URL do Tableau Server, insira http:// ou https://, seguido pelo nome do
Tableau Server. Esse nome será usado para o rodapé dos e-mails de assinatura.
4. Clique em OK.
SSL
Você pode configurar o Tableau Server para usar comunicações criptografadas por SSL
(Secure Sockets Layer) em todo o tráfego HTTP. Configurar o SSL garante que o acesso ao
aplicativo Web seja seguro e que as informações confidenciais passadas entre o navegador
da Web e o servidor ou o Tableau Desktop e o servidor sejam protegidas. As etapas sobre
como configurar o servidor para SSL são descritas no tópico abaixo; no entanto,
primeiramente, você deve adquirir um certificado de uma autoridade confiável e depois
importar os arquivos de certificado no Tableau Server.
Para configurar o Tableau Server para usar SSL:
1. Adquira um certificado Apache SSL de uma autoridade confiável (p. ex., Verisign,
Thawte, Comodo, GoDaddy, etc.). Você também pode usar um certificado interno
emitido por sua empresa. Certificados curinga, que permitem que você use SSL com
muitos nomes de host dentro do mesmo domínio, também têm suporte.
Alguns navegadores exigirão configuração adicional para aceitar certificados de
determinados provedores. Consulte a documentação fornecida pela sua autoridade de
certificação.
2. Coloque os arquivos de certificado em uma pasta chamada SSL, paralelamente à pasta
do Tableau Server 8.1. Por exemplo:
C:\Program Files\Tableau\Tableau Server\SSL
Esse local fornece à conta que está executando o Tableau Server as permissões
necessárias para os arquivos.
3. Abra o Utilitário de configuração do Tableau Server selecionando Iniciar > Todos os
programas > Tableau Server 8.1 > Configurar o Tableau Server no menu Iniciar.
4. Na caixa de diálogo Configuração do Tableau Server, selecione a guia SSL.
5. Selecione Usar SSL para comunicação do servidor e forneça o local para cada um
dos arquivos de certificado a seguir:
Arquivo de certificado SSL: deve ser um certificado x509 codificado por PEM válido
com a extensão .crt.
Arquivo da chave de certificado SSL: deve ser uma chave RSA ou DSA válida que
não seja protegida por senha com a extensão de arquivo .key.
Arquivo de cadeia de certificado SSL (Opcional): alguns provedores de certificado
emitem dois certificados para Apache. O segundo certificado é um arquivo de cadeia,
que é uma concatenação de todos os certificados que formam a cadeia de certificados
para o certificado do servidor. Todos os certificados no arquivo devem ser x509
codificados por PEM e o arquivo deve ter a extensão .crt (não .pem).
6. Clique em OK. As alterações entrarão em vigor na próxima vez que o servidor for
reiniciado.
Quando o servidor é configurado para SSL, ele aceita solicitações para a porta não SSL
(o padrão é a porta 80) e é redirecionado automaticamente para a porta SSL 443. Os
erros de SSL são registrados no diretório de instalação no local a seguir. Use esse
registro para solucionar problemas de validação e criptografia.
C:\ProgramData\Tableau\Tableau
Server\data\tabsvc\logs\httpd\error.log
O Tableau Server oferece suporte apenas à porta 443 como a porta segura. Ele
não poderá ser executado em um computador onde qualquer outro aplicativo
esteja usando a porta 443.
SAML
Você pode configurar o Tableau Server para usar um provedor de identidade externo (IdP)
para autenticar usuários do Tableau Server usando SAML. Toda a autenticação de usuário é
feita fora do Tableau, independentemente de você estar usando ou não o Active Directory ou a
autenticação local no Tableau Server para gerenciar suas contas de usuário no Tableau
Server. Isso permite oferecer uma experiência de logon único em todos os aplicativos na
organização.
Antes de configurar o Tableau Server for SAML, verifique se você atende aos Requisitos do
SAML.
Configurar SAML
Para configurar o Tableau Server a fim de usar SAML:
1. Coloque os arquivos de certificado em uma pasta chamada SAML, paralela à pasta 8.1
do Tableau Server. Por exemplo:
C:\Program Files\Tableau\Tableau Server\SAML
Esse local fornece à conta que está executando o Tableau Server as permissões
necessárias para os arquivos.
2. A configuração de SAML é identificada na guia SAML, exibida durante a Instalação do
Tableau Server. Caso você esteja configurando o SAML após a Instalação, acesse a
guia SAML abrindo o utilitário de configuração do Tableau Server (Iniciar > Todos os
Programas > Tableau Server8.1 > Configurar Tableau Server) e clicando na guia
SAML.
3. Na guia SAML, selecione Usar SAML para logon único e forneça o local para cada
uma das seguintes opções:
URL de retorno do Tableau Server — A URL que os usuários do Tableau Server
acessarão, como http://tableau_server. Usar http://localhost não é recomendável.
ID da entidade SAML — O ID da entidade identifica com exclusividade a instalação do
Tableau Server para o IdP. Você pode inserir o URL do Tableau Server novamente
aqui, caso queira, mas não precisa ser seu URL do Tableau Server.
Arquivo de certificado SAML — Um certificado x509 com codificação PEM e a
extensão .crt
Arquivo da chave de certificado SAML — Uma chave RSA ou DSA não protegida
por senha com a extensão de arquivo .key
4. Deixe a caixa de texto Arquivo de metadados IdP SAML vazia por enquanto e clique
em Exportar arquivo de metadados.
5. Uma caixa de diálogo que permite salvar as configurações SAML do Tableau Server
como um arquivo XML. Nesse ponto, os metadados de seu IdP não estão incluídos.
Salve o arquivo XML com o nome de sua escolha.
6. No site de seu IdP ou em seu aplicativo:
l
l
Adicione o Tableau Server como um provedor de serviços.Você precisará
consultar a documentação de seus IdPs sobre como fazer isso. Como parte
disso, você importará o arquivo salvo na etapa 5.
Confirme se seu IdP usa nome de usuário como o elemento de atributo a ser
verificado.
7. Ainda dentro de seu IdP, exporte o arquivo XML de metadados de seu IdP.
8. Copie o arquivo XML de metadados de seu IdP para a seguinte pasta em seu
computador do Tableau Server:
C:\Program Files\Tableau\Tableau Server\SAML
9. Na guia SAML, na caixa de diálogo Configuração do Tableau Server, informe o local até
o arquivo na caixa de texto Arquivo de metadados IdP SAML:
10. Clique em OK. O Tableau Server já está configurado para autenticação SAML.
Testar sua configuração
Teste sua configuração SAML abrindo uma nova instância do navegador da Web e digitando o
nome do Tableau Server na janela URL:
O prompt de entrada exibido é de seu IdP, e não do Tableau Server:
Adicionar uma conta de administrador
A etapa final na ativação do Tableau Server é adicionar uma conta de administrador. O
administrador terá acesso completo ao servidor, incluindo a capacidade de gerenciar usuários,
grupos e projetos. A adição de uma conta de administrador pode variar, dependendo do que
você estiver usando, o Active Directory ou a autenticação local.
Active Directory
Se estiver usando o Active Directory, digite Nome de usuário e a Senha para um usuário do
Active Directory existente que será o administrador. Em seguida, clique em Adicionar
usuário.
Observação:
Se a conta de administrador estiver no mesmo domínio que o servidor, basta digitar o nome de
usuário sem o domínio. Caso contrário, você deverá incluir o nome de domínio totalmente
qualificado. Por exemplo, test.lan\username.
Autenticação local
Se estiver usando a Autenticação local, crie uma conta de administrador digitando um Nome
de usuário, Nome para exibição e uma Senha (duas vezes) de sua escolha. Em seguida,
clique em Adicionar usuário.
Reconfigurar o servidor
Inserir suas configurações do Tableau Server faz parte da Instalação, mas você pode abrir a
caixa de diálogo Configuração após a Instalação para fazer alterações. Consulte as etapas
abaixo para obter detalhes. Você também pode usar a ferramenta de linha de comando
tabadmin para fazer alterações de configuração. Independentemente de como você fizer a
alteração, as novas configurações serão gravadas no arquivo de configuração, tabsvc.yml,
que está localizado no diretório config.
Observação: Não é possível alternar entre o Active Directory e a Autenticação local. Essas
opções só podem ser configuradas durante a instalação.
Para alterar uma configuração na caixa de diálogo Configuração do Tableau Server, faça o
seguinte:
1. Interrompa o servidor selecionando Todos os programas > Tableau Server 8.0 >
Interromper Tableau Server no menu Iniciar do Windows.
2. Em seguida, selecione Configurar o Tableau Server no menu Iniciar do Windows.
3. Se você estiver usando uma conta de usuário Active Directory para a conta Usuário
Run As do servidor, digite sua senha na guia Geral.
4. Faça as alterações de configuração.
5. Clique em OK.
6. Inicie o servidor selecionando Todos os programas > Tableau Server 8.0 > Iniciar
o Tableau Server no menu Iniciar do Windows.
Reconfigurar processos
Para alterar como os processos são configurados para uma única instalação de servidor, siga
as etapas abaixo. Se você estiver alterando como os processos são configurados para um
computador de trabalho, consulte Instalar e configurar servidores de trabalho.
1. Para abrir a caixa de diálogo Configuração do Tableau Server no menu Iniciar, navegue
até Todos os programas > Tableau Server 8.1 > Configurar o Tableau Server.
2. Insira sua Senha, se necessário, na guia Geral e clique na guia Servidores:
3. Destaque This Machine e clique em Editar:
4. A caixa de diálogo Editar Tableau Server é onde você muda o número de processos:
5. Você pode executar até oito instâncias do VizQL, servidor de aplicativos, servidor de
dados ou de processos em segundo plano, embora esse limite possa ser alterado se
necessário. Consulte Sobre o limite de processo do servidor para obter mais
informações. Além disso, para que o Tableau Server funcione, sempre deve haver uma
instância ativa do mecanismo de dados e do repositório. Para ver as etapas sobre como
movê-las para outro computador, consulte Mover os processos de mecanismo de dados
e repositório. Para ver as etapas sobre como configurar instâncias em espera delas,
consulte Alta disponibilidade.
Após fazer as alterações, clique em OK duas vezes para sair da caixa de diálogo
Configuração.
Os processos do Tableau Server
Existem seis processos do Tableau Server cuja configuração padrão você pode alterar para
atingir diferentes resultados. Os tópicos Aprimorar o desempenho do servidor e Alta
disponibilidade descrevem algumas das abordagens que podem ser adotadas. O status de
nível alto para cada processo é exibido na página Manutenção do servidor e informações mais
detalhadas relacionadas a alguns dos processos (como processo em segundo plano) estão
em Exibições administrativas. Em termos de arquitetura, a versão 64 bits do Tableau Server
usa processos nativos 64 bits; a versão 32 bits do Tableau Server usa processos 32 bits. A
exceção é o processador de dados. Caso a versão 32 bits do Tableau Server esteja instalada
em um sistema operacional de 64 bits, a versão 64 bits do processador de dados é usada.
Nome do
arquivo
servidor de wgserver.exe
aplicativos
Processo
Finalidade
Lida com o
aplicativo Web,
oferece suporte à
MultiCaracterísticas de
thread? desempenho
Sim
Consome apenas
recursos perceptíveis
MultiCaracterísticas de
thread? desempenho
navegação e
durante operações
pesquisa
raras, como publicação
de uma pasta de
trabalho com uma
extração ou geração de
uma imagem estática
para uma exibição. Sua
carga pode ser criada
pela interação baseada
em navegador e por
tabcmd.
segundo
backgrounder.exe Executa tarefas Não
Um processo de um
plano
de servidor,
único encadeamento
incluindo
onde vários processos
atualizações de
podem ser executados
extrações, tarefas
em qualquer
\"Executar agora\"
computador ou em todos
e tarefas iniciadas
eles no cluster para
em tabcmd.
expandir a capacidade.
Geralmente, o
processador em
segundo plano não
consome muita memória
para processo, mas
pode consumir recursos
de CPU, E/S ou rede, de
acordo com a natureza
da carga de trabalho
apresentada a ele. Por
exemplo, a execução de
grandes atualizações de
extrações pode usar
largura de banda da
rede para recuperação
de dados. Os recursos
de CPU podem ser
consumidos pela
recuperação de dados
ou tarefas tabcmd
complexas.
mecanismo tdeserver64.exe Armazena
Sim
A carga de trabalho do
de dados
extrações de
tdeserver.exe
Processo
Nome do
arquivo
Finalidade
Processo
Nome do
arquivo
servidor de dataserver.exe
dados
MultiCaracterísticas de
thread? desempenho
dados e responde
mecanismo de dados é
às consultas
gerada pelas
solicitações do processo
do VizQL Server. Ela é o
componente que
carrega extrações na
memória e executa
consultas nela.
Basicamente, o
consumo de memória é
baseado no tamanho
das extrações de dados
que estão sendo
carregadas. O binário de
64 bits é usado como o
padrão em sistemas
operacionais de 64 bits,
mesmo que o Tableau
Server 32 bits esteja
instalado. O mecanismo
de dados é
multissegmentado para
lidar com várias
solicitações ao mesmo
tempo. Sob carga alta,
ele pode consumir
recursos de CPU, E/S e
rede, os quais podem
ser um afunilamento de
desempenho sob carga.
Na carga alta, uma única
instância do mecanismo
de dados pode consumir
todos os recursos de
CPU para processar as
solicitações.
Manipula
Sim
Como é um proxy,
conexões com as
normalmente é
fontes de dados
associado somente pela
do Tableau
rede, mas pode ser
Server
associado pela CPU
com sessões de usuário
Finalidade
Processo
Nome do
arquivo
repositório
postgres.exe
VizQL
Server
vizqlserver.exe
MultiCaracterísticas de
thread? desempenho
simultâneo suficientes.
Sua carga é gerada pela
interação baseada no
navegador e no Tableau
Desktop, bem como
pelos trabalhos de
atualização de extrações
para fontes de dados do
Tableau Server.
O banco de dados Geralmente, consome
do Tableau
poucos recursos. Pode
Server
se tornar um
armazenada
afunilamento em casos
metadados da
raros de implantações
pasta de trabalho
muito grandes (milhares
e do usuário
de usuários) enquanto
executa operações
como exibição de todas
as pastas de trabalho
pelo usuário ou
alteração de
permissões.
Carrega e
Sim
Consome recursos
renderiza
perceptíveis durante o
exibições, calcula
carregamento da
e executa
exibição e uso interativo
consultas
de um navegador da
Web. Pode ser
associado por CPU, E/S
ou rede. A carga pode
ser criada apenas pela
interação baseada em
navegador. Pode
esgotar a memória do
processo.
Finalidade
Sobre o limite de processo do servidor
Os processos de servidor wgserver, processador de dados e VizQL foram projetados para
serem multithreaded e multiprocessados. Uma única instância de processo pode executar
mais de 16 encadeamentos. Por padrão, o Tableau Server é instalado com até duas
instâncias de cada processo do servidor.
Caso você esteja executando a versão 64 bits do Tableau Server (disponível a partir da
versão 8.1), duas instâncias de um processo é o máximo que você deve executar.
Caso esteja executando a versão 32 bits do Tableau Server e as configurações padrão
não sejam suficientes, você pode alterá-las até oito instâncias durante a Instalação (apenas
para atualizações) ou após a Instalação, usando a caixa de diálogo Configuração. O limite
superior padrão é de oito instâncias de um processo. Se o seu computador tiver memória
RAM e núcleos de CPU suficientes, você poderá alterar o limite superior usando a
configuração service.max_procs tabadmin. Para cada instância de processo, o Tableau
recomenda que o computador executando o processo tenha pelo menos 1 GB de RAM e 1
núcleo de CPU lógico.
Para alterar o número máximo de processos permitidos:
1. Após a Instalação, interrompa o servidor.
2. Ainda no diretório bin do Tableau Server, insira o seguinte comando, onde number é o
número máximo de instâncias de processo que você deseja permitir:
tabadmin set service.max_procs number
Por exemplo:
tabadmin set service.max_procs 16
3. Inicie o servidor para que as alterações possam ter efeito.
Atualizar para 8.1
Use os tópicos a seguir para atualizar o software Tableau Server para a versão 8.1. Se estiver
atualizando de uma versão anterior à 8.0, consulte a Base de Dados de Conhecimento do
Tableau.
Lista de verificação antes da atualização
Estes são os itens a serem localizados e as etapas a serem executadas antes da atualização
do Tableau Server para a versão 8.1.x.
Credenciais, arquivos de instalação e personalizações
Antes de iniciar a atualização, verifique se você possui os seguintes itens:
l
l
Credenciais da conta de usuário: Em cada computador a ser atualizado, você
precisa de credenciais para uma conta de usuário com permissões de administração
local.
Credenciais da conta Run As: Confirme que você tem o nome de usuário e a senha
da conta Run As do Tableau Server. Se estiver usando NT
AUTHORITY\NetworkService (o padrão), nenhuma senha será necessária.
l
l
Versão de bit: Desde a versão 8.1, o Tableau Server é fornecido como um aplicativo
nativo de 64 bits (bem como um aplicativo de 32 bits). Caso você estivesse executando
a versão de 32 bits do Tableau Server anteriormente em um sistema operacional de 64
bits, é recomendável atualizar a versão de 64 bits do Tableau Server. Consulte Antes da
instalação... para obter os requisitos mínimos para executar a versão de 64 bits do
Tableau Server.
Arquivos de instalação: Além de ter o .exe para a atualização que está prestes a ser
realizada, você deve localizar ou baixar novamente o Setup .exe da versão do servidor
em execução no momento (consulte Baixando produtos do Tableau). Se algo
inesperado ocorrer durante a atualização, isso poderá ajudá-lo a agilizar a recuperação.
Apesar de o Tableau manter as definições de configuração durante uma atualização, convém
também anotar as personalizações executadas para verificá-las mais tarde. Isso inclui a
configuração de SSL, a alteração da porta padrão do Tableau e valores de tempo limite, bem
como o uso de logotipos personalizados. Além disso, se você adicionou sua versão atual do
Tableau Server ao seu ambiente do Windows PATH, você deverá atualizar essa entrada
depois do upgrade para que ela se refira à nova versão do Tableau Server.
Verificar seu status de manutenção de produto
Se você tentar atualizar o Tableau Server de um servidor cuja manutenção expirou, o
resultado será uma instância não licenciada do Tableau Server.
Para verificar se a manutenção do seu servidor expirou:
l
Selecione Iniciar > Todos os programas > Tableau Server > Gerenciar chaves de
produto e verifique na coluna A manutenção expira.
Se a manutenção tiver expirado, contate o Suporte ao cliente Tableau. A reativação da chave
do produto fará parte da instalação. Consulte Ativar o Tableau para obter detalhes. Se o seu
servidor não tiver acesso à Internet, consulte Ativar o Tableau off-line.
Criar um backup “limpo”
Além dos backups regulares do Tableau Server, convém criar um backup antes da
atualização. Antes de criar o backup, execute o comando de limpeza tabadmin para remover
arquivos não essenciais do seu backup. Consulte Execução da limpeza e Fazer backup do
banco de dados do Tableau para obter as etapas.
Apenas instalações distribuídas: Remover ou não computadores de trabalho antes de criar o
backup
O arquivo de backup do Tableau (.tsbak) contém informações de configuração, bem como
dados. Portanto, um backup de uma instalação distribuída do Tableau Server conterá
informações de configuração sobre os computadores de trabalho, inclusive seus endereços
IP. Se você não quiser que essas informações façam parte de seu backup (porque você está
migrando computadores de trabalho para um novo hardware como parte de sua atualização,
por exemplo), escolha uma destas alternativas: remova os computadores de trabalho da
configuração do Tableau Server antes de criar o backup, ou planeje usar a opção --noconfig para restaurar o arquivo de backup em sua nova instalação. Observe que com a
última opção, nenhuma informação de configuração é restaurada — inclusive as do Tableau
Server primário.
Se você estiver executando uma instalação do Tableau Server e você tiver um trabalho que
esteja executando o Windows XP, remova-o da configuração antes da atualização. O
Windows XP não é uma plataforma com suporte na versão 8.1.
Para excluir um trabalho da configuração do Tableau Server:
1. Interrompa o servidor no Tableau Server primário.
2. No servidor primário, abra o utilitário de configuração selecionando Tableau Server
<versão> > Configurar o Tableau Server no menu Iniciar.
3. Na caixa de diálogo Configuração, selecione a guia Servidores.
4. Se o trabalho estiver hospedando extrações e/ou o repositório, mova esses serviços
para outra máquina. Consulte Mover os processos de mecanismo de dados e
repositório para ver as etapas.
5. Em seguida, destaque o trabalho e clique em Excluir.
6. Clique em OK.
7. Inicie o servidor.
Execução da limpeza
A execução do comando de limpeza tabadmin remove arquivos do sistema Tableau Server
que são desnecessários no arquivo de backup. Execute a limpeza uma vez quando o servidor
estiver em execução, permitindo sua ação no banco de dados Tableau, e uma vez com o
servidor parado, permitindo que ele remova arquivos de log.
Para executar a limpeza de tabadmin:
1. Abra um prompt de comando como um administrador:
2. Navegue até o diretório bin do Tableau Server. Por exemplo:
cd “C:\Program Files (x86)\Tableau\Tableau Server\8.0\bin”
3. Confirme que o servidor está em execução:
tabadmin status
4. Execute a limpeza digitando o seguinte:
tabadmin cleanup
5. Interrompa o servidor:
tabadmin stop
6. Execute nova limpeza:
tabadmin cleanup
Mantenha o servidor parado para criar um backup (em seguida).
Crie um arquivo de backup
O comando backup de tabadmin cria um arquivo .tsbak contendo dados do repositório,
extrações de dados e configuração de servidor. Após criar o arquivo, armazene-o em um
computador separado. Consulte Fazer backup do banco de dados do Tableau para ver as
etapas.
Apenas instalações distribuídas: Se você removeu trabalhos da configuração do
servidor antes de criar o backup, e a atualização for da versão 8.1.x para 8.1.x, agora
você poderá readicionar os trabalhos à configuração. A atualização do Tableau Server
primário instala as atualizações nos trabalhos. Caso contrário, se a atualização for da
versão 8.0 para 8.1.x, deixe os trabalhos fora da configuração. Consulte Atualizar para
8.1 para obter detalhes.
Atualizar para 8.1
Ao concluir o Lista de verificação antes da atualização, atualize o Tableau Server existente
para a versão 8.1 seguindo o procedimento abaixo. Caso você esteja migrando para um novo
hardware como parte de sua atualização, consulte Migrar para novo hardware.Caso esteja
atualizando de uma versão de 32 bits do Tableau Server para a versão de 64 bits, não há
nenhuma etapa especial que você possa seguir. Você pode seguir o procedimento abaixo.
1. Use Adicionar/remover programas no Tableau Server (ou Tableau Server primário,
caso tenha uma instalação distribuída), para desinstalar a versão anterior.
A desinstalação remove o software de servidor mas mantém os dados e as definições
de configuração inalteradas.
2. Instale o Tableau Server. Se sua instalação é distribuída, esta etapa se encontra no
Tableau Server primário.
A instalação do Tableau Server tratará da importação de dados e das definições de
configuração da versão anterior.
Mover os processos de mecanismo de dados e repositório
Se você precisar excluir um computador de trabalho da configuração do Tableau Server e
esse computador estiver hospedando a única instância do repositório ou do processador de
dados (que hospeda extrações), será preciso mover primeiramente o processo para outro
computador. Isso é necessário porque deve haver sempre uma instância ativa dos processos
de repositório e processador de dados.
Para mover os processos de processador de dados e repositório:
1. Caso ainda não tenha feito isso, interrompa o Tableau Server primário e abra a caixa de
diálogo Configuração do Tableau Server (Iniciar > Tableau Server 8.1 > Configurar
o Tableau Server) no Tableau Server primário.
2. Na guia Servidores, destaque o endereço IP ou o nome do computador para o qual
você deseja mover o processo. Pode ser outro computador de trabalho ou o primário
(This Computer (Primary)).
3. Clique em Editar.
4. Na caixa de diálogo Editar Tableau Server, marque a caixa de seleção do processo que
está movendo: Processador de dados, Repositório ou ambos, e clique em OK.
5. Clique em OK na caixa de diálogo Configuração do Tableau Server.
6. Inicie o Tableau Server primário para que as alterações entrem em vigor.
7. Interrompa o servidor e abra a caixa de diálogo Configuração do Tableau Server.
8. Na guia Servidores, destaque o endereço IP ou o nome do computador de trabalho do
qual você está removendo o processo e clique em Editar.
9. Desmarque a caixa de seleção do processo movido e clique em OK.
10. Clique em OK novamente e inicie o servidor primário para que as alterações entrem em
vigor.
Se você estiver executando esse procedimento como parte da exclusão de um trabalho da
configuração do Tableau Server (conforme descrito em Lista de verificação antes da
atualização) interrompa o servidor novamente antes de continuar.
Sobre o limite de processo do servidor
Os processos de servidor wgserver, processador de dados e VizQL foram projetados para
serem multithreaded e multiprocessados. Uma única instância de processo pode executar
mais de 16 encadeamentos. Por padrão, o Tableau Server é instalado com até duas
instâncias de cada processo do servidor.
Caso você esteja executando a versão 64 bits do Tableau Server (disponível a partir da
versão 8.1), duas instâncias de um processo é o máximo que você deve executar.
Caso esteja executando a versão 32 bits do Tableau Server e as configurações padrão
não sejam suficientes, você pode alterá-las até oito instâncias durante a Instalação (apenas
para atualizações) ou após a Instalação, usando a caixa de diálogo Configuração. O limite
superior padrão é de oito instâncias de um processo. Se o seu computador tiver memória
RAM e núcleos de CPU suficientes, você poderá alterar o limite superior usando a
configuração service.max_procs tabadmin. Para cada instância de processo, o Tableau
recomenda que o computador executando o processo tenha pelo menos 1 GB de RAM e 1
núcleo de CPU lógico.
Para alterar o número máximo de processos permitidos:
1. Após a Instalação, interrompa o servidor.
2. Ainda no diretório bin do Tableau Server, insira o seguinte comando, onde number é o
número máximo de instâncias de processo que você deseja permitir:
tabadmin set service.max_procs number
Por exemplo:
tabadmin set service.max_procs 16
3. Inicie o servidor para que as alterações possam ter efeito.
Migrar para novo hardware
Use o procedimento a seguir para migrar o Tableau Server de um computador para outro.
Mais especificamente, essas etapas descrevem como mover dados e definições de
configuração do Tableau Server de seu computador em produção para um novo computador
no qual a versão 8.1 do Tableau Server está instalada. Antes de iniciar, verifique se você
seguiu as etapas em Lista de verificação antes da atualização, inclusive a criação de um
arquivo .tsbak.
1. Instale o Tableau Server no novo computador.
2. Copie seu arquivo .tsbak para a pasta bin em seu novo Tableau Server (por exemplo,
C:\Program Files\Tableau\Tableau Server\8.1\bin).
3. Em seguida, interrompa o Tableau Server.
4. Restaure dados e informações de configuração em execução para a nova instalação do
Tableau Server, digitando tabadmin restore <filename>, onde <filename>
é o nome do arquivo .tsbak. Por exemplo:
tabadmin restore mybackup.tsbak
Ou, para restaurar apenas os dados do Tableau Server em execução, sem informações
de configuração, digite o seguinte:
tabadmin restore --no-config mybackup.tsbak
5. Inicie o servidor.
6. Apenas instalações distribuídas: Execute o instalador de trabalho do Tableau em
todos os computadores adicionais que você deseja adicionar a seu cluster do Tableau
Server. Consulte Instalar e configurar servidores de trabalho para ver as etapas.
7. Depois de testar a nova instalação, você deve desativar a versão anterior do Tableau
Server antes de desinstalá-la. Para desativar a versão anterior:
- Selecione Iniciar > Todos os programas > Tableau Server > Gerenciar chaves
de produto.
- Selecione cada chave de produto e clique em Desativar.
Se você não tiver uma conexão com a Internet, será solicitado a criar um arquivo
de retorno off-line para concluir o processo de desativação. Consulte Ativar o
Tableau off-line para ver as etapas.
Ambientes distribuídos
Use os tópicos abaixo para aprender mais sobre como executar uma instalação distribuída do
Tableau Server:
Instalar e configurar servidores de trabalho
Depois de concluir a configuração inicial, você poderá definir o Tableau Server para ser
executado em vários computadores. Esse procedimento se chama instalação distribuída. A
execução de uma instalação distribuída usa portas adicionais no Tableau Server primário e
exige que determinadas portas estejam disponíveis para associação durante a Instalação do
Tableau Worker Server. Consulte Portas TCP/IP para obter mais informações.
Aqui estão algumas outras coisas que devem ser consideradas:
l
l
l
O Tableau Server e o Tableau Worker Server estão disponíveis em versões de 32 e 64
bits. Todos os computadores em uma instalação distribuída devem executar a mesma
"versão de bit" do software Tableau Server. Em outras palavras, os computadores de
trabalho e primário devem executar todos o Tableau Server de 32 bits ou o Tableau
Server de 64 bits.
Todas as máquinas em um ambiente distribuído devem ser membros do mesmo
domínio. A conta Usuário Run As do servidor, especificada no Tableau Server primário,
deve ser uma conta de domínio nesse mesmo domínio.
Todos os computadores em um ambiente distribuído devem ter endereços IP estáticos.
Para instalar e configurar um Tableau Worker Server:
1. Verifique se você instalou o Tableau Server no computador primário.
2. Pare o servidor no computador primário (consulte Tableau Server Monitor para saber
como).
3. Baixe o software Tableau Server Worker do Centro de contas do cliente do Tableau.
4. Execute a Instalação Tableau Server Worker em todos os computadores adicionais que
você deseja incluir no cluster do Tableau Server. Durante a instalação, você deverá
fornecer o endereço IPv4 ou o nome do computador do servidor primário.
Se tiver um trabalho executando o Windows 7 com o Firewall do Windows habilitado,
consulte a Base de dados de conhecimento do Tableau antes de continuar.
5. Assim que o software de trabalho for instalado nos computadores de trabalho, com o
Tableau Server primário ainda parado, retorne ao servidor primário e abra o utilitário de
configuração selecionando Tableau Server 8.1 > Configurar Tableau Server no
menu Iniciar.
6. No Utilitário de Configuração, digite sua senha na guia Geral e selecione a guia
Servidores e clique em Adicionar.
7. Na próxima caixa de diálogo, digite o endereço IPv4 ou o nome do computador de um
dos computadores de trabalho e especifique o número de processos VizQL, Servidor
de aplicativos, Data Server, Em segundo plano e Processador de dados a serem
alocados ao computador. Você pode atribuir até oito instâncias de um processo a um
servidor de trabalho (ou primário).
Por padrão, o processador de dados, o repositório e o gateway são hospedados no
servidor primário. A execução desses processos em um servidor adicional ou a
transferência deles do servidor primário faz parte da configuração de alta
disponibilidade. Consulte Alta disponibilidade para obter mais informações.
8. Clique em OK. A conclusão das atualizações pode levar vários minutos.
9. Repita essas etapas para cada computador que você deseja adicionar ao ambiente
distribuído. Quando você terminar de adicionar trabalhos, clique em OK novamente
para salvar as alterações e, em seguida, inicie o Tableau Server primário.
Drivers de banco de dados
Os instaladores do Tableau Server e Tableau Server Workers instalam drivers
automaticamente para bancos de dados Oracle e Oracle Essbase. Se pretender publicar
pastas de trabalho e fontes de dados que se conectam a outros bancos de dados, você
precisará ter certeza de que os servidores primário e de trabalho tenham os drivers
correspondentes.
Os computadores de trabalho que executam o VizQL, o servidor de aplicativos, o data server
ou processos do processador em segundo plano precisam desses drivers de banco de dados.
Por exemplo, caso tenha um computador de trabalho dedicado como um servidor VizQL e
outro computador dedicado ao armazenamento de extração, você só precisará instalar drivers
no computador que executa o processo de servidor VizQL.
Processo do servidor
VizQL
Servidor de aplicativos
Data server
Em segundo plano
Processador de dados
(armazenamento de extração)
Repositório
Gateway
Exige driver de
banco de
dados?
sim
sim
sim
sim
não
não
não
Manter um ambiente distribuído
Depois de configurar um primário e um ou mais servidores de trabalho para uma instalação
distribuída, você poderá realizar todas as configurações subsequentes e as atualizações no
servidor primário usando as ferramentas de linha de comando e o utilitário de configuração no
servidor primário. As atualizações serão distribuídas aos computadores de trabalho
automaticamente.
Quando instalou servidores de trabalho, você especificou o endereço IPv4 do primário ou o
nome do computador. Se esse endereço IP ou o nome do computador mudar, você precisará
reinstalar os servidores de trabalho.
Você pode monitorar o status do cluster do Tableau Server na página Manutenção do
servidor. Consulte Manutenção do servidor para saber mais sobre a manutenção do servidor.
Alta disponibilidade
Use os links abaixo para aprender mais sobre o suporte do Tableau Server para alta
disponibilidade:
Como entender a alta disponibilidade
Se você estiver configurando um sistema do Tableau Server para alta disponibilidade, as
etapas executadas são relacionadas à criação em redundância, reduzindo assim seu tempo
de inatividade potencial. As quatro áreas que requerem redundância são o processador de
dados, o repositório e os processos de gateway, além do Tableau Server primário, que
executa o componente de licenciamento do servidor. Como sempre deve haver uma instância
ativa dos processos do processador de dados e do repositório, configurar o cluster é um
procedimento em várias fases que requer a parada do Tableau Server primário e sua
reinicialização em determinados pontos, para que as configurações entrem em vigor. Para
obter as etapas exatas, consulte Configurar para failover e vários gateways e Configurar um
primário de backup. Consulte Requisitos da alta disponibilidade também.
Os tópicos abaixo resumem como a topologia de sistema do servidor evolui, à medida que
você a configura para alta disponibilidade. A configuração mínima recomendada para alta
disponibilidade é um sistema de três nós. Isso inclui um servidor primário para executar o
licenciamento e dois computadores de trabalho para hospedar os processos principais. Você
pode aumentar a confiabilidade do sistema adicionando um quarto computador para servir
como um primário de backup. Se você executar um processo de gateway em todos os nós,
também fará sentido usar um balanceador de carga para os gateways.
Um sistema de servidor único
Depois que você instalar o Tableau Server primário, ele estará executando no mínimo uma
instância de todos os processos de servidor. Essa é a configuração mais básica do Tableau
Server. Ela não tem nenhuma redundância.
Em geral, esta é a aparência da tabela Status na página Manutenção para um sistema de
servidor único:
Para criar redundância, você precisa adicionar mais servidores para hospedar os processos
de mecanismo e repositório de dados ativos e em espera. Além disso, para reduzir a
vulnerabilidade do sistema, vários gateways podem ser executados, e o primário deve ser
isolado em seu próprio nó, de preferência executando alguns dos processos do servidor, se
possível. O menor número de computadores necessários para conseguir isso é três (consulte
Um sistema de três nós). Porém, você pode conseguir alguma redundância com dois
computadores.
Um sistema de dois nós
Se tiver restrições de hardware e um cluster de três nós estiver fora de alcance, você poderá
conseguir alguma redundância usando dois computadores e um host externo a seu cluster do
Tableau Server.
No sistema acima, o Tableau Server primário e um servidor de trabalho estão executando as
instâncias ativa e em espera do processador de dados, além do repositório, bem como dos
gateways. Um terceiro computador, externo ao cluster do Tableau Server, está sendo usado
como um terceiro ponto de contato para os dois gateways. Aqui está o porquê: Quando um
Tableau Server executando o processador de dados ou o repositório perde conectividade com
os outros nós, ele consulta um processo de gateway externo a seu respeito(mas ainda dentro
do cluster do Tableau Server) para determinar qual nó falhou e se algum processo em espera
agora precisa se tornar ativo. Em um cluster de dois nós, caso a conectividade seja perdida,
não é possível alcançar o outro processo de gateway do Tableau. Nesses casos, um site ou
um computador fora do cluster do Tableau Server pode ser usado. Consulte Confirmar
failover externamente para saber como configurar isso.
Aqui está como a tabela Status fica para a configuração acima. Como o terceiro computador
não é um Tableau Server, ele não está listado na tabela.
Um sistema de três nós
Embora o sistema de dois nós descrito acima fornecesse algum suporte a failover para o
mecanismo de dados e os processos de repositório, um sistema de três nós ajudaria a reduzir
a vulnerabilidade do computador primário:
A tabela Status na página Manutenção é semelhante à seguinte:
Em um cluster de três nós, os processos de processador de dados e de repositório foram
migrados do computador primário para um de trabalho, e o primário é o único executando o
processo de gateway. Como a pesquisa e a funcionalidade de licenciamento são integrantes
do primário e não podem ser removidos, eles não são exibidos na tabela Status. Nesta
configuração, caso o trabalho ativo falhe, o trabalho em espera se torna ativo
automaticamente. Como criar exatamente esse cluster de três nós, inclusive como adicionar
os computadores de trabalho e remover os processos do primário, é descrito em Configurar
para failover e vários gateways.
Ainda existem mais duas coisas que você pode fazer para melhorar esse cluster de três nós:
1) adicione um balanceador de carga à interface com os três gateways ativos e 2) crie um
backup para resolver o único ponto de falha: o primário. Consulte os tópicos abaixo para obter
detalhes.
Adicionar um balanceador de carga
Nesse ponto, todos os três nós têm gateways, usados para encaminhar solicitações para
processos de servidor disponíveis. Diferentemente do processo de repositório, não há
gateway ativos e em espera. Todos os gateways estão ativos. Para reduzir ainda mais o
potencial de tempo de inatividade de seu cluster, você deve configurar um balanceador de
carga.
Adicionar um primário de backup
Adicionar um primário de backup fornece uma proteção para o sistema. O primário de backup
é um servidor adicional incluído no sistema para estar pronto em caso de falha de seu
primário. Embora não seja um servidor ativo, depois que você concluir o primeiro conjunto de
etapas em Configurar um primário de backup, ele estará pronto para ser ativado.
Aqui está como o sistema se parece com um primário de backup:
A tabela Status da configuração acima será igual à do sistema de três nós. Caso haja falha no
primário e você execute as etapas para que o primário de backup assuma, seu sistema volta a
ficar on-line usando o novo primário:
Requisitos da alta disponibilidade
Antes de começar a configurar um cluster para failover e alta disponibilidade, verifique se os
requisitos a seguir são atendidos.
Equipamentos
Com exceção do gateway, os sistemas usados para failover e alta disponibilidade devem
atender aos requisitos descritos em Antes da instalação..., mas não precisam ser idênticos:
l
Failover—dois ou três computadores: Para configurar um cluster que dê suporte a
failover para os processos de processador de dados e repositório, você precisa de pelo
menos dois computadores ou VMs: um para o Tableau Server primário e um para o
computador de trabalho do Tableau. Nesta configuração, um site ou um computador
que não esteja executando o Tableau também pode ser necessário (saiba mais). A
configuração de failover recomendada exige três computadores ou VMs: um para o
Tableau Server primário r dois para os computadores de trabalho.
l
l
l
Suporte a failover e vários gateways—três computadores e um balanceador de
carga: Para configurar um cluster que dê o suporte acima e além para vários gateways,
você precisa de três computadores ou VMs e um balanceador de carga diante do
cluster.
Alta disponibilidade — quatro computadores e um balanceador de carga: Para
configurar alta disponibilidade, você precisa de três computadores ou VMs descritos
acima, além de um computador adicional para ser o primário de backup de seu Tableau
Server primário.
Computadores primários: Caso você configure para alta disponibilidade, o Tableau
Server primário e o primário de backup podem estar executando menos ou nenhum
processo do Tableau Server. Por isso, os computadores que executam o primário e o
primário de backup não precisam de tantos núcleos quanto aqueles que executam seus
servidores de trabalho. Você irá, no entanto, precisar de espaço em disco adequado
para backups. O primário é usado temporariamente durante os processos de backup e
restauração do banco de dados.
Software
Os produtos de software do Tableau estão disponíveis em versões de 32 e 64 bits. Caso você
esteja executando um cluster do Tableau Server, cada computador deve executar a mesma
versão, 64 ou 32 bits. Por exemplo, caso o Tableau Server primário esteja executando a
versão 64 bits do Tableau Server, os computadores de trabalho no cluster devem executar a
versão 64 bits do Tableau Server Worker. Eles não podem executar a versão 32 bits do
Tableau Server Worker.
O uso da mesma versão de bit não é um problema entre Tableau Desktop e Tableau Server.
Você pode publicar uma pasta de trabalho em um Tableau Server de 64 bits usando uma
versão 32 bits do Tableau Desktop e vice-versa.
Rede e portas
Assim como ocorre com qualquer sistema distribuído, os computadores ou VMs que você usa
precisam ser capazes de se comunicar. Consulte Portas TCP/IP para obter uma lista de
portas que devem estar disponíveis nos gateways e trabalhos.
Práticas recomendadas
Veja aqui algumas considerações que você deve ter em mente antes de começar a instalar e
configurar:
l
Endereços IP ou nomes de computador: Anote os endereços IPv4 ou os nomes de
cada computador ou VM com que você trabalhará. Será necessário fornecê-los durante
a Instalação e a configuração do Tableau Worker. Cada computador no cluster deve
usar um endereço IP estático, mesmo que você use o nome do computador para
identificá-lo durante a configuração.
l
l
l
Registro CNAME: Se você estiver configurando para alta disponibilidade e não estiver
usando um balanceador de carga, verifique se seu Tableau Server primário e o primário
de backup têm o mesmo registro CNAME, de forma que os usuários do Tableau Server
tenham uma experiência tranquila caso um primário falhe e você configure o outro para
assumir. Se você estiver usando um balanceador de carga, será o nome do
balanceador de carga que os usuários utilizarão como a URL do Tableau Server,
independentemente do gateway efetivamente identificando a solicitação.
Credenciais da conta de usuário: Para cada computador, você precisa de
credenciais para uma conta de usuário com permissões admin locais. Se você estiver
configurando para alta disponibilidade, a conta Run As usada para seu Tableau Server
primário deve ser igual à usada para seu Tableau Server primário de backup.
Backup: É uma prática recomendada criar um backup antes de fazer alterações
significativas no sistema. Consulte Fazer backup do banco de dados do Tableau para
ver as etapas.
Configurar para failover e vários gateways
Faça o seguinte para configurar um cluster de três computadores que dê suporte a vários
gateways e failover:A execução de vários gateways só tem sentido caso você planeje usar
também um balanceador de carga.
1. Instale o Tableau Server no seu computador primário.
2. Após a conclusão da Instalação, verifique a tabela Status na página Manutenção. Todos
os processos devem ter um status “aguardando solicitação” verde:
3. Interrompa o servidor no primário.
4. Em seguida, execute a Instalação do Tableau Worker nos dois computadores adicionais
ou VMs que darão suporte ao failover e ao gateway extra. Durante a Instalação do
Worker, você precisará fornecer o endereço IPv4 ou o nome do computador do Tableau
Server primário:
Um endereço IP estático deve ser atribuído ao primário, mesmo que você esteja
usando o nome do computador primário para identificá-lo.
5. Com o servidor primário ainda interrompido, abra sua caixa de diálogo Configuração:
Iniciar > Todos os programas > Tableau Server > Configurar o Tableau Server.
Na guia Geral, insira a senha da conta Executar como.
6. Na guia Servidores, clique em Adicionar para adicionar um computador de trabalho.
7. Digite o endereço IPv4 ou o nome do computador de trabalho, insira 1 para
Processador de dados e marque a caixa de seleção Repositório. Marque a caixa de
seleção Gateway caso você planeje usar também um balanceador de carga.
Se você quiser que o trabalho execute outros processos de servidor, insira o número de
instâncias que deseja executar, como 1 ou 2.
8. Clique em OK para fechar a caixa de diálogo Adicionar Tableau Server e em Adicionar
novamente na guia Servidores para adicionar outro trabalho.
9. Digite o endereço IPv4 ou o nome do computador do segundo trabalho, insira pelo
menos 1 para cada processo, mas também o Processador de dados (defina-o como
0). Desmarque a caixa de seleção Repositório e selecione Gateway.
Não é necessário especificar qual computador de trabalho está ativo e qual está em
espera para o processador de dados e o repositório.
10. Inicie o servidor no primário para que suas alterações possam entrar em vigor (isso
pode demorar alguns minutos) e, em seguida, pare o servidor no primário.
11. Reabra a caixa de diálogo Configuração, na guia Servidores, destaque Este
computador (primário) e clique em Editar.
12. Na caixa de diálogo Editar Tableau Server, defina Processador de dados como 0 e
desmarque a caixa de seleção Repositório. Mantenha Gateway selecionado. Se você
quiser que o Tableau Server primário não execute nada além do Apache (portanto,
nenhum processo do Tableau Server), poderá remover os processos restantes dele
inserindo 0 em cada caixa de texto:
Clique em OK.
13. Na guia Servidores, selecione o segundo computador de trabalho e clique em Editar.
14. Defina Processador de dados como 1 e marque a caixa de seleção Repositório.
Clique em OK. A guia Servidores agora deve ser semelhante à seguinte:
15. Também é possível configurar alertas de e-mail para que você seja notificado sobre
falhas do servidor ou alterações no status dos processos de mecanismo de dados e
repositório. Para isso, clique na guia Alertas e assinaturas da caixa de diálogo
Configuração e siga as etapas em Configurar alertas de e-mail.
16. Clique em OK para fechar a caixa de diálogo Configuração.
17. Inicie o servidor no primário (talvez sejam necessários alguns minutos para que as
alterações tenham efeito). Agora o sistema está configurado para fornecer suporte a
failover para os processos de processador de dados e repositório. Ele também é
configurado para vários gateways. Agora você pode usar um balanceador de carga
para garantir a disponibilidade do cluster em caso de falha do gateway e distribuir a
carga de trabalho do cluster.
A tabela Status na página Manutenção deve ser semelhante à seguinte:
Uma marca de seleção verde-claro indica um processo em espera, pronto para assumir
se o processo ativo (marca de seleção verde-escuro) falhar.
Confirmar failover externamente
Assim que adicionar um segundo servidor à configuração de seu Tableau Server que está
executando o processador de dados ou o repositório, você poderá usar a caixa de seleção
Usar hosts externos para confirmar failover na guia Servidores. Esta opção permite listar
um ou mais computadores ou sites externos ao cluster de seu Tableau Server que será usado
para verificar o status de conectividade do cluster em caso de um failover.
Usar um host ou site externo para confirmar o failover é mais útil em um sistema Tableau
Server de dois nós como o seguinte:
No sistema acima, o Tableau Server primário e um servidor de trabalho estão executando as
instâncias ativa e em espera do processador de dados, além do repositório, bem como dos
gateways. O terceiro computador, externo ao cluster do Tableau Server, está sendo usado
como um terceiro ponto de contato para os dois gateways. Aqui está o porquê: Quando um
Tableau Server executando o mecanismo de dados ou o repositório perde conectividade com
os outros nós, ele consulta um processo de gateway externo a seu respeito(mas ainda dentro
do cluster do Tableau Server) para determinar qual nó falhou e se algum processo em espera
agora precisa se tornar ativo. Em um cluster de dois nós, caso a conectividade seja perdida,
não é possível alcançar o outro processo de gateway do Tableau. Nesses caos, um
computador no qual o Tableau não esteja em execução pode ser usado para estabelecer uma
conexão TCP simples. Se o servidor de trabalho no diagrama acima perdesse conectividade
com o primário, mas ainda conseguisse se conectar ao host externo, isso seria o gatilho para
ele começar a executar as instâncias ativas do processador de dados e do repositório.
Adicionar um balanceador de carga
Você pode aumentar a confiabilidade de um cluster do Tableau Server executando vários
gateways e configurando um balanceador de carga para distribuir solicitações em todos os
gateways. Diferentemente do processo de repositório, que pode ser ativo ou em espera, todos
os processos de gateway são ativos. Caso um gateway em um cluster fique indisponível, o
balanceador de carga para de enviar solicitações para ele. O algoritmo do balanceador de
carga escolhido por você determina como os gateways encaminharão as solicitações do
cliente.
Quando um balanceador de carga está diante de um cluster do Tableau Server, a URL que os
usuários do Tableau Server utilizam pertence ao balanceador de carga, e não ao Tableau
Server primário.
Configurar um primário de backup
Antes de seguir os procedimentos neste tópico, siga as etapas em Configurar para failover e
vários gateways. Depois de passar por essas etapas, você terá dois servidores de trabalho
que dão suporte a failover. Cada servidor também está executando um gateway para o qual
um balanceador de carga pode ser configurado. O Tableau Server primário está executando
um processo de gateway e licenciamento, não exposto ou atribuível como um processo. Agora
que tem redundância para o processador de dados, o repositório e o gateway, você precisa
criar redundância para seu Tableau Server primário. Você faz isso criando um backup dele.
O primeiro procedimento abaixo descreve como criar um backup de seu primário. O segundo
procedimento orienta você em relação ao que fazer caso seu primário atual falhe.
Criação de um gateway de backup
Faça o seguinte para criar um gateway de backup:
1. Pare o servidor em seu Tableau Server primário.
2. No primário, abra um prompt de comando como um administrador e navegue até o
diretório bin do Tableau Server:
C:\Program Files\Tableau\Tableau Server\8.1\bin
3. Digite o seguinte comando, em que <primary1> é o endereço IPv4 do primário atual
ou o nome do computador e <primary2> é o endereço IPv4 do primário de backup ou
o nome do computador:
tabadmin failoverprimary --primary <primary1> --secondary
<primary2>
4. Em seguida, crie uma cópia do arquivo tabsvc.yml do primário (localizado em
ProgramData\Tableau\Tableau Server\config) e coloque a cópia em um local
temporário em seu computador primário de backup.
O arquivo tabsvc.yml contém definições de configuração de servidor. Ele é gravado
quando você altera as definições de configuração na caixa de diálogo Configuração do
Tableau Server ou via tabadmin. Se tabsvc.yml for alterado, você precisará atualizar a
cópia de tabsvc.yml em seu primário de backup.
5. Em seu primário de backup, abra o arquivo tabsvc.yml e substitua o endereço IP ou o
nome do computador do primário na linha worker.hosts pelo endereço IP ou o nome
do computador do primário de backup (o computador em que você está no momento):
6. Em seu primário de backup, instale o Tableau Server. Use a mesma conta Run As e as
mesmas definições de configuração que você usou ao executar a Instalação do Tableau
Server em seu primário.
7. Após a conclusão da Instalação, pare o servidor no primário de backup.
8. Ainda em seu primário de backup, digite o seguinte comando para desabilitar seu
serviço do Tableau Server:
sc config tabsvc start= disabled
Você concluiu a criação de um primário de backup. Consulte o próximo conjunto de
etapas para saber o que fazer caso seu primário atual falhe. Se você estiver
trabalhando em um ambiente de teste, este será um bom momento para testar sua
configuração desligando seu primário atual para simular uma falha no sistema.
Configuração do primário de backup
Siga este segundo conjunto de etapas em caso de uma falha no primário. Todas as etapas
devem ser executadas no computador primário de backup.
1. Em seu primário de backup, use o arquivo tabsvc.yml que você editou na etapa 5 do
procedimento anterior para substituir o arquivo instalado localmente em
ProgramData\Tableau\Tableau Server\config.
2. Abra um prompt de comando como administrador e navegue para o diretório bin do
Tableau Server:
C:\Program Files\Tableau\Tableau Server\8.1\bin
3. Digite o seguinte comando, em que primary2 é o endereço IP ou o nome do
computador de seu primário de backup (logo será seu novo primário) e primary1 é o
endereço IP ou o nome do computador de seu primário anterior (logo será seu backup):
tabadmin failoverprimary --primary <primary2> --secondary
<primary1>
4. Insira o seguinte comando:
sc config tabsvc start= auto
5. Inicie o servidor. Seu primário de backup agora é seu computador primário. Ao observar
a tabela Status na página Manutenção, você deve perceber que o endereço IP ou o
nome do computador do primário foi alterado:
6. Para que seu primário agora atue como seu primário de backup, você precisará fazer o
seguinte:
l
l
l
Use Adicionar/Remover Programas para remover o Tableau Server de seu
primário anterior. Ao final do programa Desinstalar, você receberá um erro de
backup, que poderá ignorar.
Exclua as pastas do Tableau em Arquivos de Programas e ProgramData em seu
gateway primário anterior.
Repita as etapas neste tópico a partir da etapa 4 em “Como criar um gateway de
backup”.
Trabalhar com o Server
Consulte os tópicos a seguir enquanto usa a interface do usuário do Tableau Server para
administrar sua instalação:
Usuários e licenças
Todas as pessoas que precisarem acessar o Tableau Server, seja para publicar, pesquisar ou
administrar, devem ser adicionadas como um usuário. Além disso, os usuários devem ser
atribuídos a um nível de licença.
Usuários
Todas as pessoas que precisarem acessar o Tableau Server, seja para publicar, pesquisar ou
administrar, devem ser adicionadas como um usuário. Se o Tableau Server estiver
executando vários sites, a página Todos os usuários será onde os administradores de
sistema fazem isso. Caso contrário, se o Tableau Server estiver no modo de site único, os
administradores de sistema e site poderá adicionar usuários na página Usuários.
Assim que os usuários forem adicionados, você poderá editá-los e excluí-los, adicioná-los ou
removê-los de sites, bem como atribuir a eles níveis de licença e direitos do usuário. Consulte
os tópicos abaixo para obter mais informações.
Adicionar usuários
Tanto administradores de sistema quanto administradores de site com as permissões corretas
podem adicionar usuários a partir da página Usuários:
Há duas maneiras de adicionar usuários a partir da página Usuários: Interativamente (como
descrito abaixo) ou em lotes usando o comando Importar, que depende de um arquivo CSV
(como descrito em Importar usuários de um arquivo CSV).
Para adicionar um usuário:
Na página Usuários, clique no link Adicionar acima da lista de usuários:
1.
2. Insira um Nome de usuário.
l
l
Autenticação local: Se o servidor estiver configurado para autenticação local,
utilizar um endereço de e-mail em Nome de usuário é a melhor maneira de
evitar conflitos de nome de usuário (por exemplo, [email protected] em vez
de jsmith). Depois de inserir o Nome de usuário, clique em Adicionar usuário.
Active Directory: Se você estiver adicionando um usuário que seja do mesmo
domínio Active Directory no qual o servidor está em execução, basta digitar o
Nome de usuário sem o domínio. O domínio do servidor será adotado.
Se houver uma configuração de confiança bidirecional entre o domínio do
servidor e outro domínio, você poderá adicionar usuários de ambos os domínios.
Na primeira vez que você adicionar um usuário do “domínio fora do servidor”, use
o nome de domínio totalmente qualificado com o nome de usuário. Os usuários
subsequentes podem ser adicionados usando o apelido do domínio. Por
exemplo, presumindo um “domínio fora do servidor” de mybiz.lan, digite o
primeiro usuário desse domínio como [email protected] ou mybiz.lan\user1. O
próximo usuário pode ser inserido usando o apelido do domínio, como
user2@mybiz ou mybiz\user2.
Observação: Não insira o Nome completo do usuário nesse campo, pois isso
pode causar erros durante o processo de importação.
3. Somente autenticação local, forneça o seguinte:
l
Nome completo: digite um nome de exibição para o usuário (p. ex., John Smith).
l
Senha: digite uma senha para o usuário.
l
Confirmação: digite a senha novamente.
4. Nível de licença: Selecione um nível de licença. Consulte Licenças e direitos do
usuário e Permissões para saber mais.
5. Direitos do usuário: Selecione se o usuário pode publicar pastas de trabalho e atribuir
direitos de administrador. Consulte Permitir ou negar direitos do usuário para saber
mais.
6. Clique em Adicionar.
Observação para servidores com vários sites:
Os administradores de site podem editar uma conta de usuário existente, desde que o usuário
seja apenas membro de sites controlados por esse administrador. Por exemplo, se o usuário
Joe for membro dos Sites A e B e o administrador de site somente for administrador do Site B,
o administrador de site não poderá editar o Nome completo de Joe, nem redefinir sua senha.
Adicionar usuários a um site
Ao adicionar um site ao Tableau Server, ele se torna um sistema com vários sites, e o que
antes era a página Usuários passa a ser duas páginas: Todos os usuários e Usuários do
site. Como administrador de sistema, só você pode acessar a página Todos os usuários,
que se aplica a todo o sistema do servidor. Ela é o único local em que você pode adicionar
usuários a vários sites de uma vez, remover usuários e, se o servidor estiver usando a
autenticação local, redefinir senhas de usuários.
A página Usuários do site é uma forma simples de ver rapidamente quais usuários estão no
site em que você entrou no momento. Você pode adicionar usuários a partir daqui, mas eles só
serão adicionados a esse site.
O procedimento a seguir descreve como adicionar usuários de Todos os usuários. Há duas
abordagens que você pode adotar: Um de cada vez (como descrito abaixo) ou em lotes
usando o comando Importar, que depende de um arquivo CSV (como descrito em Importar
usuários de um arquivo CSV).
Para adicionar um usuário:
1. Na página Todos os usuários, clique no link Adicionar na parte superior da lista de
usuários:
2. Insira um Nome de usuário:
l
l
Autenticação local — Se o servidor estiver usando autenticação local, utilizar
um endereço de e-mail como o nome de usuário é a melhor maneira de evitar
conflitos de nome de usuário (por exemplo, [email protected] e não jsmith).
Active Directory— Se você estiver adicionando um usuário do mesmo domínio
do Active Directory em que o servidor está sendo executado, poderá digitar o
Nome de usuário sem o domínio. O domínio do servidor será adotado.
Se houver uma configuração de confiança bidirecional entre o domínio do
servidor e outro domínio, você poderá adicionar usuários de ambos os domínios.
Na primeira vez que você adicionar um usuário do “domínio fora do servidor”, use
o nome de domínio totalmente qualificado com o nome de usuário. Os usuários
subsequentes podem ser adicionados usando o apelido do domínio. Por
exemplo, adotando um “domínio fora do servidor” de mybiz.lan, digite o primeiro
usuário desse domínio como [email protected] ou mybiz.lan\user1. O próximo
usuário pode ser inserido usando o apelido do domínio, como user2@mybiz ou
mybiz\user2.
Observação: Não insira o Nome completo do usuário nesse campo, pois isso
pode causar erros durante o processo de importação.
3. Se o servidor estiver usando autenticação local, forneça o seguinte:
l
Nome completo: digite um nome de exibição para o usuário (p. ex., John Smith).
l
Senha: digite uma senha para o usuário.
l
Confirmação: digite a senha novamente.
4. Associação ao site — Selecione de quais sites o usuário deve ser membro. O site em
que você entra é selecionado por padrão.
5. Nível de licença e direitos do usuário — Selecione o nível de licença, a função
Admin e se o usuário pode publicar pastas de trabalho e fontes de dados. Um usuário
que pertence a vários sites pode ter níveis de licença e direitos de usuário diferentes em
cada site. Consulte Sobre níveis de licença, Permissões e Sobre direitos do usuário
para saber mais.
6. Clique em Adicionar usuário.
Importar usuários de um arquivo CSV
Você pode automatizar o processo de adição de usuários com um arquivo CSV.
Requisitos
l
l
l
l
O arquivo CSV deve ser salvo no formato UTF-8, com a marca de ordem de byte
(BOM).
As codificações de caracteres diferentes de UTF-8, como BIG-5, devem ser
convertidas. É possível fazer isso usando “Salvar como”.
Não use cabeçalhos de coluna. Se você usar cabeçalhos de coluna (Username,
Password etc.), Tableau Server o Tableau Server tentará importá-los como
credenciais literais para o primeiro usuário no arquivo.
As duas colunas seguintes sempre são necessárias:
l
l
l
Username
Password: Se o Tableau Server estiver configurado para utilizar a autenticação
de usuário do Active Directory, deverá haver uma coluna Password, mas a
coluna em si deverá estar vazia. Se o servidor estiver usando autenticação local,
você deverá fornecer senhas para novos usuários. Consulte também “Modo de
vários sites e de onde importar” para obter outras informações.
O arquivo CSV também pode ter as seguintes colunas opcionais, na ordem mostrada
abaixo (após as colunas Username e Password):
l
Full Name
l
License Level (Interagente, Visualizador ou Não licenciado)
l
Administrator (Sistema, Site, Site ou Nenhum)
l
Publisher (sim/verdadeiro/1 ou não/falso/0)
l
Email Address
l
A ordem das colunas é significativa. A primeira coluna é tratada como Username, a
segunda como Password, a terceira como Full Name etc, independentemente do
conteúdo das colunas.
Modo de vários sites e de onde importar
Se o servidor estiver executando vários sites e você for um administrador de sistema, haverá
duas páginas das quais você poderá fazer uma importação de usuários do CSV. Cada uma
delas tem recursos diferentes em relação às contas de usuário do servidor existentes.
Página Todos os usuários: Esta página será exibida se um servidor estive
executando vários sites e somente administradores de sistema puderem acessá-la.
l
As importações do CSV feitas daqui permitem a você atualizar as contas de usuário do
servidor existentes, além de adicionar novas contas. Por exemplo, se você realizar uma
importação do CSV que tenha uma nova senha para cada usuário existente, suas
senhas serão redefinidas.
A página Usuários do site:
l
Quando um administrador de sistema está trabalhando aqui, ele tem os mesmos
recursos de um administrador de site. Isso significa que ele pode adicionar novas contas
de usuário com importações do CSV e, se usuários existentes fizerem parte da
importação, os campos Senha e Nome completo deverão coincidir ou estar em
branco. Se novas senhas ou nomes completos forem usados, haverá falha na
importação.
Se você for um administrador de site em um servidor com vários sites, execute importações de
usuários do CSV na página Usuários.
Um usuário pode pertencer a mais de um site no mesmo sistema de servidor, mas deve usar
as mesmas credenciais para cada site. Isso é importante quando você está adicionando
usuários novos ao site, mas talvez não ao servidor (em outras palavras, eles são membros de
um site diferente no servidor). Se você achar que esse pode ser o caso, tente deixar a coluna
Password em branco (mas mantenha o cabeçalho de coluna Password necessário). Se o
servidor estiver configurado para autenticação local e um novo usuário do site também for
novo no sistema do servidor, você verá uma mensagem na janela de importação do CSV
solicitando o fornecimento de uma senha para o usuário.
Adicionar usuários de um arquivo CSV
Para adicionar usuários de um arquivo CSV:
1. Na página Usuários ou Todos os usuários, clique no link Importar:
2. Clique em Procurar, navegue até o arquivo e clique em Verificar arquivo:
3. Os resultados preliminares são exibidos. Para visualizar informações específicas de
conta, selecione Detalhes da exibição:
4. Para continuar, clique em Importar usuários e clique em Sair na caixa de diálogo final.
Adicionar usuários a um grupo
Uma maneira de facilitar o gerenciamento de usuários é atribuí-los a grupos. Dessa forma, é
possível atribuir permissões a um grupo inteiro, e não a um usuário por vez. Para adicionar um
usuário a um grupo, o grupo já deve existir. Consulte Criar grupos para obter mais
informações.
Para adicionar um usuário a um grupo:
1. Na guia Admin, selecione a página Usuários:
Se você for o administrador do sistema para um servidor de vários sites, precisará fazer
isso em cada site usando a página Usuários do Site.
2. Selecione um ou mais usuários.
3. Clique no link Grupo + acima da lista de usuários e, em seguida, selecione um grupo ao
qual adicionar usuários:
Exibir, editar e excluir usuários
Use este tópico para saber como exibir, editar, e excluir usuários do Tableau Server.
Exibir usuários
Caso o Tableau Server esteja executando vários sites, Todos os usuários lista todos os
usuários no sistema do servidor e Usuários do site exibe todos os usuários do site no qual
você entrou agora:
Observação:
Por padrão, essa lista de usuários é privada e só pode ser vista por administradores. Você
pode tornar a lista de usuários pública habilitando Publicar lista de usuários, na área
Configurações da página Manutenção. Se o servidor estiver executando vários sites, habilitar
essa configuração mostrará apenas os usuários com os nomes de usuários no respectivo site.
Os usuários podem ser listados em várias páginas. Conforme você seleciona os usuários na
lista, eles são adicionados a uma lista rápida no canto superior esquerdo. A lista rápida permite
ver quantos usuários você selecionou e ajuda a removê-los facilmente da seleção. Clique no
botão “x” próximo ao nome de usuário na lista rápida para remover alguém da seleção.
Também é possível usar a caixa Pesquisar em Filtros à esquerda para encontrar
rapidamente um usuário específico na lista.
Digite todo ou parte do nome do usuário e pressione Enter. É possível usar um asterisco (*)
como um curinga na pesquisa. Por exemplo, pesquisar por John* retornará todos os nomes
que comecem com John.
Editar usuários
Se o servidor for configurado para usar o sistema interno de gerenciamento de usuários
(autenticação local), você poderá editar o Nome para exibição e a Senha dos usuários
depois que eles forem adicionados. Se você estiver fazendo muitas alterações, será mais fácil
importar as alterações de um arquivo CSV. Consulte Adicionar usuários para obter detalhes.
Para editar informações de usuário:
1. Selecione um único usuário na lista de usuários.
2. Clique no link Editar no início da lista.
3. Digite um novo Nome para exibição e Senha nas caixas de texto correspondentes.
4. Clique em Enviar.
Observação para servidores com vários sites:
Os administradores de site podem editar uma conta de usuário existente, desde que o usuário
seja apenas membro de sites controlados por esse administrador. Por exemplo, se o usuário
Joe for membro dos Sites A e B e o administrador de site somente for administrador do Site B,
o administrador de site não poderá editar o Nome completo de Joe, nem redefinir sua senha.
Excluir usuários
Para excluir usuários:
1. Selecione u ou mais usuários para excluir.
2. Clique em Excluir no início da lista.
3. Clique em Sim na caixa de diálogo de confirmação.
Você só pode remover um usuário do Tableau Server se ele não for proprietário de
conteúdo (pastas de trabalho, fontes de dados, etc.). Se você usar o procedimento
anterior para excluir um usuário que possui o conteúdo, o usuário será definido como
Não licenciado, mas não será removido.
Licenças e direitos do usuário
O nível de licença e os direitos do usuário que você atribui aos usuários determinam o que eles
podem fazer no Tableau Server.
Sobre níveis de licença
Para abrir a página Licenças, clique no link Licenças na guia Admin:
É necessário atribuir a todos os usuários do Tableau Server um nível de licença, mesmo que
esse nível seja Não licenciado. Os níveis de licença do Tableau Server não correspondem às
licenças de usuário nomeadas do Tableau Server que você comprou da Tableau (se você
estiver usando licenciamento de servidor baseado em usuário em vez de baseado em núcleo).
Essas licenças permitem que você tenha um determinado número de usuários no servidor.
Níveis de licença permitem que os administradores controlem o acesso que os usuários terão
no servidor.
Aqui estão os níveis de licença que você pode atribuir:
Nível de licença
Descrição
Não licenciado
O usuário não pode entrar
no servidor. Todos os
usuários são adicionados
como não licenciados, por
padrão.
Visualizador
O usuário pode entrar e
ver exibições publicadas
no servidor, mas não pode
interagir com as exibições.
Os usuários com esse
nível podem receber
apenas permissão para
exibir, adicionar
comentários e exibir
comentários. Eles não
Nível de licença
Descrição
podem interagir com filtros
rápidos nem classificar
dados em uma exibição.
Interagente
O usuário pode entrar,
navegar no servidor e
interagir com as exibições
publicadas. É importante
notar que exibições,
pastas de trabalho e
projetos específicos
podem ser adicionados
com permissões que
restringem os recursos do
usuário. As configurações
de permissão podem ser
editadas pelo autor da
pasta de trabalho ou por
um administrador.
Convidado
O nível de licença de
convidado está disponível
para permitir que usuários
sem uma conta no
servidor vejam e interajam
com uma exibição
inserida. Quando
habilitado, o usuário pode
carregar uma página da
Web contendo uma
visualização inserida sem
entrar. Essa opção está
disponível somente com
um servidor baseado em
núcleo.
É possível analisar como esses níveis foram distribuídos na página Licenças:
Alterar níveis de licença
Você normalmente atribui um nível de licença ao criar um usuário. Para alterar o nível de
licença para um ou mais usuários existentes, siga estas etapas:
1. Na guia Admin, clique em Usuários.
2. Selecione um ou mais usuários.
3. Clique no link Usuário da licença no início da lista.
4. Selecione Não licenciado, Visualizador ou Interagente para os usuários
selecionados.
A coluna Nível de licença na lista de usuários é atualizada para refletir as alterações.
Sobre direitos do usuário
Além do nível de licença, os privilégios dos usuários no Tableau Server também são afetados
por seus direitos de usuário:
Direito do
usuário
Publicar
Admin
Descrição
Permite que os usuários se conectem
ao Tableau Server do Tableau Desktop
para publicar e baixar pastas de
trabalho ou fontes de dados.
Torna o usuário um administrador.
Há dois tipos de administradores:
Administradores de site e
administradores de sistema.
l
l
Os administradores de site
podem gerenciar grupos,
projetos, pastas de trabalho e
conexões de dados. Por padrão,
os administradores de site
também podem adicionar
usuários e atribuir direitos de
usuário e níveis de licença, mas
um administrador de sistema
pode desabilitar isso (consulte
sites_edit.htm).
Os administradores de
sistema têm todos os direitos de
um administrador de site e ainda
podem licenciar usuários não
licenciados, controlar se os
administradores de site podem
adicionar usuários, criar
administradores de sistema
adicionais e administrar o próprio
servidor. Isso inclui controlar a
manutenção, as definições, as
agendas e o índice de pesquisa.
O direito Admin só pode ser
atribuído a usuários com o nível
de licença Interagente e o direito
Publicar.
Permitir ou negar direitos do usuário
Você normalmente atribui direitos do usuário ao criar um usuário. Para alterar os direitos do
usuário para um ou mais usuários existentes, siga estas etapas:
1. Na guia Admin, clique em Usuários.
2. Selecione um ou mais usuários.
3. Clique em Publicação ou Admin na parte superior da lista.
4. Selecione Permitir ou Negar para alterar o direito de publicação dos usuários
selecionados.
5. Em Admin, selecione Sistema, Site ou Nenhum para alterar o direito Admin para os
usuários selecionados. As colunas Admin e Publicar na lista de usuários são atualizadas
para refletir as alterações.
Grupos e projetos
Grupos e projetos ajudam você a organizar suas pastas de trabalho e usuários no Tableau
Server.
Grupos
Você pode organizar os usuários no Tableau Server em grupos para facilitar o gerenciamento
de vários usuários. É possível criar grupos localmente no servidor ou importar do Active
Directory. Você pode criar e gerenciar grupos na página Grupos, que lista todos os grupos no
servidor ou site, se o servidor hospedar vários sites.
Criar grupos
Dependendo de como o servidor foi configurado, você pode adicionar grupos usando o
sistema interno de gerenciamento de usuários (autenticação local) ou pode importar do Active
Directory.
Criar um grupo local
Um grupo local é aquele criado no Tableau Server usando o sistema interno de
gerenciamento de usuários. Após criar um grupo, você pode adicionar e remover usuários.
Para criar um grupo local:
1. Clique em Novo na parte superior da lista de grupos.
2. Digite um nome para o grupo e clique em Adicionar grupo:
3. Clique em Retornar para grupos para retornar à lista de grupos.
Criar um grupo pelo Active Directory
Os grupos podem ser importados do Active Directory. Quando você importa grupos do Active
Directory, um grupo correspondente é criado no servidor e um usuário é criado no servidor
para cada membro do grupo. Os usuários não são licenciados e não têm permissão para
publicar. Se o usuário já existir no servidor, ele será adicionado ao novo grupo e suas
permissões não serão alteradas. Consulte Licenças e direitos do usuário para saber mais
sobre níveis de licença e direitos de usuário.
1. Clique em Importar grupo do Active Directory no fim da lista de grupo
2. Digite o nome do grupo do Active Directory que você deseja importar e clique em
Importar.
3. Se você não souber o nome exato do grupo, será possível encontrá-lo digitando todo o
nome do grupo, ou parte dele, na caixa de texto Pesquisar. Em seguida, clique em
Pesquisar. Você pode usar o símbolo de asterisco (*) como curinga.
4. Selecione o grupo na lista de resultados da pesquisa.
5. O nome do grupo é adicionado automaticamente à caixa de texto Importar. Clique em
Importar para adicionar o grupo ao Tableau Server.
Não é possível alterar o nome dos grupos importados do Active Directory. O nome do
grupo só pode ser alterado no Active Directory.
Sincronizar um grupo do Active Directory
A qualquer momento, é possível sincronizar um grupo do Active Directory com o Tableau
Server para que todos os novos usuários no Active Directory também sejam adicionados ao
servidor. Você pode sincronizar grupos individuais ou vários grupos de uma vez.
1. Na página Grupos, selecione um ou mais grupos.
2. Clique em Sincronizar.
Se você estiver adicionando um grupo que seja do mesmo domínio Active Directory no
qual o servidor está em execução, basta digitar o nome do grupo. Além disso, se houver
uma configuração de confiança bidirecional entre o domínio que o servidor está usando
e outro domínio, você poderá adicionar grupos de ambos os domínios. Na primeira vez
que você adicionar um grupo de um domínio diferente daquele que o servidor está
usando, será preciso incluir o nome de domínio totalmente qualificado com o nome do
grupo. Por exemplo, domain.lan\group ou [email protected]. Qualquer grupo
subsequente pode ser adicionado usando o apelido do domínio. Consulte Modificar
nomes de domínio para saber mais sobre como gerenciar nomes de domínio.
Excluir grupos
Você pode excluir qualquer grupo do servidor. Quando um grupo é excluído, os usuários são
removidos do grupo, mas não são excluídos do servidor.
1. Na página Grupos, selecione um ou mais grupos a serem excluídos.
2. Clique em Excluir acima da lista de grupos:
Projetos
Um projeto é um conjunto de pastas de trabalho relacionadas. Na condição de administrador,
há dois locais onde você verá Projetos listados: abaixo da guiaConteúdo e abaixo da guia
Admin. Se desejar criar novos projetos, atribuir permissões ou excluir projetos, use a página
Projetos abaixo da guia Admin:
Embora somente administradores possam criar novos projetos, a permissão Líder de projeto
pode ser atribuída a usuários e grupos. As permissões possibilitam ao usuário ou grupo
especificar permissões de projeto e mover pastas de trabalho para projetos. Consulte os
tópicos abaixo para ver os procedimentos e obter mais informações sobre como trabalhar com
projetos:
Adicionar projetos
Para adicionar um ou mais projetos
1. Clique no link Adicionar.
2. Digite o nome e a descrição do projeto e clique em Adicionar. É possível incluir
formatação e hiperlinks na descrição do projeto.
Mover pastas de trabalho para projetos
Todas as pastas de trabalho devem estar em um projeto. Por padrão, as pastas de trabalho
são adicionadas ao projeto Padrão. Depois de criar seus próprios projetos, você poderá
mover pastas de trabalho de um projeto a outro. Será possível transferir pastas de trabalho
para projetos se você tiver um nível de licença Interagente e, pelo menos, uma das afirmações
a seguir for verdadeira:
l
Você tem permissão para Gravar no projeto.
l
Você tem permissão Líder do projeto para o projeto.
l
Você recebeu o direito Admin.
Para transferir uma pasta de trabalho para um projeto:
1. Selecione uma ou mais pastas de trabalho e clique no link Mover na parte superior da
lista de pastas de trabalho.
2. Selecione um projeto para o qual mover a pasta de trabalho.
Como todas as pastas de trabalho devem fazer parte de um projeto, você pode remover
uma pasta de trabalho de um projeto movendo-o para o projeto Padrão. Cada pasta de
trabalho pode fazer parte apenas de um único projeto.
Excluir projetos
Somente administradores podem excluir projetos. Quando você exclui um projeto, todas as
pastas de trabalho e exibições que fazem parte do projeto também são excluídas do servidor.
Para excluir um projeto:
1. Selecione o projeto na lista de projetos.
2. Clique em Excluir abaixo da lista Projetos.
3. Clique em Sim na caixa de diálogo de confirmação.
O projeto Padrão não pode ser excluído.
Agendar atualizações e assinaturas
Atualizações de extrações e entregas de assinaturas são tarefas realizadas pelo Tableau
Server e as agendas controlam quando essas tarefas são executadas.
Na condição de administrador do servidor, você deve ter o nível mais alto de controle sobre as
tarefas e agendas do servidor. No entanto, há dois tipos de tarefas que os usuários do Tableau
Server podem agendar. Os autores de pasta de trabalho podem agendar atualizações de
extrações ao publicarem uma pasta de trabalho ou uma fonte de dados com uma extração e
os usuários do Tableau Server podem assinar exibições, que são entregues de acordo com
uma agend. Como administrador, você pode ajustar uma agenda de assinatura ou extração,
criar novas agendas, atualizar tarefas e excluí-las. Além de determinar se os autores da pasta
de trabalho podem ou não fazer agendamentos (consulte Habilitar agendamento), você pode
determinar se o servidor deve ser configurado para enviar assinaturas (consulte Gerenciar
assinaturas). Qualquer mudança feita em uma agenda de extração é refletida na caixa de
diálogo Agenda do Tableau Desktop na próxima vez que o autor fizer uma publicação. De
modo semelhante, ao criar uma nova agenda de assinaturas ou excluir uma existente, isso se
reflete nas opções da agenda que um usuário do Tableau Server visualiza quando assina uma
exibição.
Consulte os tópicos abaixo para obter mais informações:
Sobre extrações e agendas
O Tableau Desktop permite que os autores criem uma extração de dados, que é uma cópia ou
um subconjunto de dados da fonte de dados original. As pastas de trabalho que usam
extrações de dados geralmente são mais rápidas do que aquelas que usam conexões de
banco de dados ativa, pois os dados extraídos são importados no mecanismo de dados rápido
interno do Tableau. As extrações também podem aumentar a funcionalidade. Após a
publicação de uma pasta de trabalho ou fonte de dados com uma extração, a extração residirá
no Tableau Server.
Atualizando extrações diretamente no Tableau Server:
l
Navegador da Web: Como administrador, você pode alterar ou reatribuir agendas de
atualização de extrações independentemente de a pasta de trabalho ou fonte de dados
com extração ter recebido uma agenda de atualização no momento em que foi
publicada. Qualquer alteração de agendamento feita pelo administrador do site no
Tableau Server é refletida na caixa de diálogo Agenda do Tableau Desktop quando a
pasta de trabalho ou fonte de dados é publicada novamente.
Você também pode atualizar uma extração imediatamente, usando a opção Executar
agora. Consulte Gerenciar tarefas de atualização e Criar ou modificar um
agendamento para obter detalhes. Observe que, antes de criar agendas de atualização,
você deve habilitar o agendamento no servidor. Consulte Habilitar agendamento para
saber mais.
l
Utilitário de linha de comando tabcmd: O utilitário de linha de comando tabcmd
fornece um comando refreshextracts, que você pode usar na linha de comando
ou incorporar em seu próprio script. Consulte Automatizar tarefas de atualização para
obter mais informações.
Atualizando extrações do Tableau Desktop:
l
l
No momento da publicação: Quando um autor publica uma pasta de trabalho ou
fonte de dados que usa uma extração, esse autor pode atribuí-la a uma agenda de
atualização recorrente no Tableau Server. A A atualização pode ser completa ou
incremental. As atualizações incrementais referenciam uma coluna na extração que tem
um tipo de dados de data, data/hora ou inteiro; como um carimbo de data e hora. O
Tableau usa essa coluna para identificar novas linhas que precisam ser adicionadas à
sua extração. Consulte Atualizando extrações e Agendas na ajuda do Tableau Desktop
para obter mais informações.
Interface de usuário: Você pode usar as opções Atualizar da origem e Anexar do
arquivo no Tableau Desktop para carregar um acréscimo ou uma atualização de uma
extração no Tableau Server. Você poderá fazer isso se o Tableau Server não tiver
credenciais suficientes para atualizar os dados da fonte de dados original. Para obter
mais informações, consulte Atualização de extrações no Tableau Server na ajuda online do Tableau Desktop para obter detalhes sobre o upload.
l
Utilitário de linha de comando Extração de DadosO utilitário Extração de Dados
do Tableau é instalado com o Tableau Desktop. Você pode usá-lo para carregar um
acréscimo a uma extração no Tableau Server ou atualizá-la. Consulte Utilitário de linha
de comando Extração de Dados do Tableau Data na ajuda on-line do Tableau Desktop
para obter mais informações sobre como fazer o upload. C
Habilitar agendamento
Para que seja possível agendar uma atualização de extração, o agendamento deve ser
habilitado no servidor. Após habilitar o agendamento, você poderá adicionar pastas de
trabalho e fontes de dados a agendas, criar e editar agendas, gerenciar tarefas agendadas e
alterar configurações de agenda para permitir que editores atribuam pastas de trabalho a
agendas. Essa configuração não afeta o agendamento para assinaturas.
Para habilitar o agendamento, marque a caixa de seleção Agendamento em Configurações
na página Manutenção do Servidor:
Como as senhas de banco de dados podem ser exigidas para atualizar a extração, você
deve habilitar Credenciais inseridas para permitir o agendamento.
Criar ou modificar um agendamento
A página Agendas apresenta uma lista de agendas que inclui o nome, o tipo, a que se
destinam (escopo), o número de tarefas, o comportamento (processamento serial ou
simultâneo) e quando elas estão agendadas para execução.
1. Para criar uma nova agenda, clique em Novo:
2. Para modificar uma agenda existente, selecione-a e clique em Modificar:
3. Especifique um Nome descritivo para a agenda (p. ex., Todo sábado de manhã, Fim do
mês).
4. Escolha um Escopo da agenda, ou seja, o que a agenda manipulará — atualizações
de extrações ou entregas de assinaturas.
5. Como opção, defina uma Prioridade padrão de 0 a 100. Essa é a prioridade que será
atribuída às tarefas por padrão. Se duas tarefas estiverem pendentes na fila, aquela
com a prioridade mais alta será executada primeiro. Consulte Gerenciar tarefas de
atualização para saber mais sobre como modificar a prioridade de uma tarefa.
6. Escolha se as tarefas na agenda serão executadas ao mesmo tempo
(simultaneamente, o padrão) ou uma após a outra (sequencialmente).
7. Termine de definir ou editar a agenda. É possível definir uma agenda por hora, dia,
semana ou mês.
8. Clique em Criar agenda se for uma nova agenda, ou em Salvar agenda se você tiver
modificado uma agenda existente.
Adicionar fonte de dados ou pasta de trabalho à agenda
Uma vez que você tenha habilitado o agendamento, poderá adicionar uma pasta de trabalho a
uma agenda da lista Pastas de trabalho ou adicionar uma fonte de dados a uma agenda da
lista Fontes de dados. Por padrão, o Tableau Server tem três agendas internas para atualizar
extrações. Também é possível criar sua própria agenda. Consulte Criar ou modificar um
agendamento para obter detalhes.
1. Se você está agendando uma pasta de trabalho para uma atualização de extração,
selecione uma ou mais na página Pastas de trabalho e clique em Tarefas agendadas:
Se você está agendando uma fonte de dados para uma atualização de extração,
selecione uma ou mais na página Fontes de dados e clique em Tarefas agendadas:
2. Selecione Adicionar atualização completa ou Adicionar atualização incremental
e, em seguida, selecione uma agenda da lista:
Adicionar atualização completa estará disponível somente se a fonte de dados
selecionada se conectar a uma fonte de dados de extração. Adicionar atualização
incremental está disponível somente se a fonte de dados selecionada se conectar a
uma fonte de dados de extração para a qual você definiu uma atualização incremental.
Tableau Server não pode atualizar as fontes de dados que se conectam a fontes de
dados de arquivo local em uma unidade mapeada. Atualize a conexão para usar o
caminho completo até a fonte de dados.
Gerenciar tarefas de atualização
A página Tarefas exibe todas as tarefas de atualização de extração completa e incremental
que estão sendo gerenciadas pelo servidor. Os administradores de sistema e site podem usar
essa página para alterar a prioridade de uma tarefa, movê-la para uma agenda diferente,
executá-la ou excluí-la. Você pode abrir a página Tarefas clicando em Tarefas na guia Admin:
Editar uma agenda da tarefa
Mova uma tarefa de atualização de extração de uma agenda para outra fazendo o seguinte:
1. Na página Tarefas, selecione uma ou mais tarefas a serem modificadas.
2. Clique em Editar agenda. Selecione uma nova agenda na lista de agendas:
Também é possível excluir e executar tarefas selecionando uma ou mais tarefas na lista e
selecionando uma opção na barra de ferramentas.
Executar uma tarefa agora
Você pode forçar uma atualização imediata de uma tarefa, como uma tarefa de atualização de
extração, usando a opção Executar agora.
1. Na página Tarefas, selecione uma tarefa a ser executada.
2. Clique em Executar agora.
Alterar a prioridade de uma tarefa
Para alterar a prioridade de uma tarefa de atualização de extração:
1. Na página Tarefas, selecione uma ou mais tarefas a serem modificadas.
2. Clique em Editar prioridade.
3. Digite uma nova prioridade de 0 a 100 e clique em Enviar.
Automatizar tarefas de atualização
Você pode associar tarefas de atualização de extração a agendas no Tableau Server para
automatizar a atualização de extrações de dados. Você também pode automatizar
atualizações de extração usando tabcmd, um utilitário de linha de comando fornecido com o
Tableau Server e que pode ser instalado em um computador separado do Tableau Server.
Em particular, você pode usar o comando refreshextracts em combinação com outros
comandos em seu próprio script. Por exemplo:
tabcmd login - http://mytabserver -u jsmith -p P@ssw0rd!
refreshextracts --datasource salesq4
Identificar alertas de atualização da extração
Caso as atualizações de extração não tenham sido bem-sucedidas, o Tableau exibe um menu
Alertas no canto inferior direito:
Você só verá o menu Alertas se houver uma falha na atualização da extração e você estiver:
l
Um administrador de sistema ou do site.
l
Não foi possível atualizar o autor da pasta de trabalho ou da fonte de dados.
l
Não foi possível atualizar o autor de uma pasta de trabalho que se conecta a uma fonte
de dados.
Ao abrir o menu Alertas, você pode ver mais informações sobre as falhas de atualização:
Quando uma Fonte de dados é listada como Inserida isso significa que a definição da fonte
de dados (que inclui coisas como as credenciais da fonte de dados ou o nome do banco de
dados) está inserida ou reside dentro da própria pasta de trabalho. Isso também significa que
o problema deve ser corrigido no Tableau Desktop. Por exemplo, a fonte do problema pode
ser que as credenciais precisem ser inseridas na pasta de trabalho.
Quando o nome de uma fonte de dados ou de uma pasta de trabalho é listado como a Fonte
de dados (por exemplo, Fonte de dados: sales_data), significa que a fonte de dados é uma
Fonte de dados do Tableau Server. A definição da fonte de dados reside no Tableau Server.
Quando a pasta de trabalho ou a fonte de dados foi originalmente criada no Tableau Desktop,
um ícone do Tableau, e não um ícone de banco de dados, era exibido próximo à fonte de
dados, na janela Dados:
Às vezes, você pode corrigir um problema de atualização de extração clicando em Editar
informações da conexão, inserindo informações não encontradas e clicando em Salvar:
Gerenciar assinaturas
Assinatura é uma exibição ou pasta de trabalho no Tableau Server da qual os usuários podem
receber um instantâneo por e-mail. Quando eles clicarem no instantâneo em seus e-mails, a
exibição ou a pasta de trabalho se abrirá no Tableau Server. Para gerenciar assinaturas,
clique em Assinaturas na guia Admin.
Requisitos
Para que os usuários do Tableau Server recebam assinaturas, é necessário definir o seguinte:
l
Definição as configurações de e-mail: Como administrador do sistema, você define
as configurações básicas do servidor SMTP para assinaturas na guia Alertas de email/assinaturas na caixa de diálogo Configuração, que é exibida durante a
Instalação. Essa é a conta remetente que o Tableau Server usa para enviar assinaturas
por e-mail para usuários do servidor. Você também pode acessar essa guia após a
Instalação. Consulte Reconfigurar o servidor e Configurar assinaturas de e-mail para
ver as etapas.
l
l
l
Credenciais inseridas ou não exigidas: Da perspectiva do Tableau Server, uma
assinatura inclui uma pasta de trabalho, dados e uma agenda. Para fornecer os dados,
o Tableau Server precisa ter acesso aos dados sem o envolvimento do usuário final.
Isso pode ser feito usando uma pasta de trabalho com credenciais de banco de dados,
uma fonte de dados do Tableau Server ou usando dados que não exigem credenciais,
como um arquivo que é incluído com a pasta de trabalho no momento da publicação. As
pastas de trabalho que solicitam credenciais para conexões de banco de dados ativas
não podem ser assinadas.
Requisitos do usuário: Se o usuário puder ver uma exibição ou pasta de trabalho no (
) no canto superior direito, ele poderá assiná-la. A capacidade de ver uma exibição ou
pasta de trabalho é controlada pela permissão Exibição. Um usuário também deve ter
um endereço de e-mail. Se Tableau Server ainda não tiver um endereço de e-mail para
um assinante, ele solicitará um no momento do cadastro da assinatura. Os usuários
podem alterar suas opções de entrega, cancelar a assinatura ou atualizar seu endereço
de e-mail na página Preferências do usuário.
Sem autenticação confiável: Se o Tableau Server estiver configurado para a
autenticação confiável, as assinaturas estarão desabilitadas. A autenticação confiável,
em combinação com a autenticação local do Tableau, cria uma experiência "sem
entrada", mas autenticada, para usuários finais. Para criar essa mesma experiência e
usar assinaturas, use o Active Directory (com Habilitar logon automático) como o tipo de
autenticação do usuário. Você escolhe o tipo de autenticação do usuário durante a
Instalação. Consulte Configurar o servidor para obter os detalhes.
Configurações de assinatura adicionais
Desde que as assinaturas estejam configuradas na guia Alertas e assinaturas e o Tableau
Server esteja usando suas configurações padrão, os usuários do servidor podem assinar as
exibições e as pastas de trabalho que veem. Para impedir que os usuários assinem ou
personalizem sua experiência de assinatura, vá para:
l
l
l
página dos Sites: Por padrão, as assinaturas são habilitadas para cada site, mas você
pode usar a página Sites para desabilitar assinaturas por site ou personalizá-lo. Por
exemplo, você pode inserir um Endereço de envio personalizado para assinaturas em
vez do especificado na caixa de diálogo Configuração. Você também pode criar seu
próprio rodapé para os emails da assinatura que seus usuários recebem.
Página Agendas: Seus usuários precisarão de pelo menos uma agenda de assinatura
para escolher quando assinarem. O Tableau fornece duas por padrão. Como
administrador do sistema, você pode criar agendas adicionais ou remover as padrão.
Consulte Criar ou modificar um agendamento para obter detalhes.
Página Assinaturas: Essa página lista todas as assinaturas no servidor ou, se você for
administrador do site, no site. Os administradores do sistema podem alterar a agenda
da assinatura de um usuário do servidor ou excluir a assinatura. Consulte os tópicos
abaixo para obter detalhes.
Para saber quais são as etapas para testar se você configurou as assinaturas corretamente,
consulte Testar sua configuração de assinatura. Se você estiver tendo um problema com
assinaturas, consulte Solucionar problemas de assinaturas.
Excluir uma assinatura
Para excluir uma assinatura, selecione a que você quer remover e clique em Excluir:
Editar uma agenda de assinatura
Para alterar a agenda para uma assinatura, selecione a assinatura, clique em Editar agenda
e selecione uma agenda:
Testar sua configuração de assinatura
Como administrador, você pode testar se configurou corretamente as assinaturas fazendo o
seguinte:
1. Assinar uma exibição.
2. Na página Agendas, selecione a agenda que contém sua assinatura.
3. Clique em Executar agora:
4. Em alguns instantes, sua assinatura deverá aparecer em sua caixa de entrada de email.
Solucionar problemas de assinaturas
"O instantâneo da exibição neste email não pôde ser renderizado adequadamente."
Se você receber uma assinatura com essa mensagem de erro, poderá ser por vários motivos:
l
l
l
Credenciais ausentes: Algumas exibições são publicadas com credenciais inseridas.
Você pode receber o erro acima se as credenciais inseridas estiverem desatualizadas,
ou se a exibição foi publicada novamente sem as credenciais inseridas.
Banco de dados temporariamente inativo: Se a exibição tiver uma conexão de
banco de dados ativa, e o banco de dados estava temporariamente inativo quando a
assinatura era gerada, você poderá receber o erro acima.
Tempo limite de processo em segundo plano: Por padrão, o processo em segundo
plano que administra as assinaturas tem seu tempo esgotado após 30 minutos. Na
maioria dos casos, isso é muito tempo. Entretanto, se o processo em segundo plano
estiver manipulando um painel extremamente grande e complexo, esse tempo talvez
não seja suficiente. Você poderá verificar a exibição do administrador Tarefas em
segundo plano para ver se é esse o caso. Para aumentar o tempo limite, use a opção
tabadmin subscriptions.timeout.
Não é possível assinar
Se você puder ver uma exibição ou pasta de trabalho no Tableau Server e ela tiver um ícone
de assinatura ( ) no canto superior direito, você poderá assiná-la.
Dois fatores precisam estar presentes para você assinar uma exibição: O Tableau Server
precisa estar configurado corretamente (descrito em Gerenciar assinaturas) e a exibição que
você está assinando deve ter credenciais inseridas para sua fonte de dados ou não usar
credenciais. Exemplos do último item são uma pasta de trabalho que se conecta a uma
extração que não está sendo atualizada, ou uma pasta de trabalho cujos dados estão em um
arquivo fornecido com a pasta de trabalho no momento da publicação. Inserir credenciais é
uma etapa que acontece no Tableau Desktop (consulte a ajuda do Tableau Desktop para
obter os detalhes).
Sem ícone de assinatura
É possível ver uma exibição no Tableau Server, mas não é possível assiná-la. Isso acontece
para exibições com conexões de banco de dados ativas, onde você é solicitado a fornecer as
credenciais do banco de dados ao clicar pela primeira vez na exibição. Uma assinatura inclui
uma exibição (ou pasta de trabalho), dados ou uma agenda. Para fornecer os dados, o
Tableau Server precisa das credenciais do banco de dados inseridas ou de dados que não
exigem credenciais. Em relação às conexões de bancos de dados ativas, o Tableau Server
não tem as credenciais, somente os usuários individuais têm. É por isso que você só pode
assinar exibições que não exigem credenciais ou as têm inseridas.
Você também pode ver uma exibição, mas não poder assiná-la (sem ícone de assinatura) se o
Tableau Server estiver configurado para a autenticação confiável. Consulte Requisitos de
assinatura para obter mais informações.
Recebimento de assinaturas inválidas ou "corrompidas"
Se você configurou assinaturas nas instâncias de teste ou desenvolvimento do Tableau
Server além de sua instância de produção, desabilite as assinaturas nas instâncias que não
são de produção. Manter as assinaturas habilitadas em todas as instâncias pode resultar em
seus usuários recebendo assinaturas que parecem ser válidas, mas não funcionam, ou
recebendo assinaturas mesmo que eles as tenham cancelado na exibição ou pasta de
trabalho.
As assinaturas não chegam ("Erro no envio de e-mail. Não é possível enviar o comando para o host
SMTP.")
Você pode ver o erro acima no Visualizador de Eventos do Windows se as assinaturas
aparecerem como enviadas (de acordo com a exibição de administração Tarefas em segundo
plano), mas não estiverem chegando, e seu servidor SMTP estiver usando sessões
criptografadas (SSL). Assinaturas são aceitas somente para conexões SMTP não
criptografadas. A solução é usar um servidor SMTP não criptografado.
Sites
Use a página Sites para criar sites independentes para diferentes organizações ou grupos em
um único sistema de servidor. As pastas de trabalho, os dados e as listas de usuários de cada
site são isolados desses mesmos itens de outros sites. Como administrador do sistema,
somente você pode ver cada site e executar ações como criar sites e fazer alterações em todo
o sistema. Consulte os tópicos abaixo para obter mais informações:
Trabalhar com sites
Os tópicos abaixo descrevem aspectos do trabalho com vários sites, como qual tipo de
autenticação será usado, bem como coisas que você deve saber sobre licenças de usuário e
funções de administrador.
Autenticação e credenciais de entrada
Todos os sites em um servidor usam a mesma conta Run As e modo de autenticação. Você
escolhe ambas as configurações quando instala o Tableau Server. Consulte Geral para obter
mais informações.
Os usuários que pertencem a mais de um site no mesmo sistema de servidor usam as
mesmas credenciais para cada site. Por exemplo, se Jane Silva tiver um nome de usuário
jsmith e uma senha “MyPassword” no Site A, ela usará essas mesmas credenciais no Site B.
Quando entrar no Tableau Server, ela poderá escolher qual site deseja acessar.
O site padrão
Para ajudar a fazer transição harmoniosa de um sistema de um único site para um com vários
sites, o Tableau Server é instalado com um site chamado Padrão. Se você estiver executando
no modo de único site, não será preciso usar explicitamente o Padrão; isso acontece
automaticamente. No entanto, caso você adicione um ou mais sites, o Padrão se torna um dos
sites nos quais pode entrar quando entra no Tableau Server. O Padrão é diferente dos sites
que você adiciona ao sistema nos seguintes aspectos:
l
l
l
Ele nunca pode ser excluído, mas, assim como os sites adicionados, ele pode ser
renomeado.
Ele armazena os exemplos e conexões de dados que são enviados com o Tableau
Server.
A URL usada para o Padrão não tem uma pasta da Web correspondente denominada
“padrão”. Por exemplo, a URL para uma exibição denominada Profits em um site
denominado Sales é http://localhost/t/sales/views/profits. A URL
para essa mesma exibição no site Padrão seria
http://localhost/views/profits.
As funções Administrador de site e sistema
Existem dois tipos de administrador no Tableau Server: administradores de sistema e
administradores de site. Os administradores de sistema podem controlar se os
administradores de site podem adicionar e remover usuários na caixa de diálogo Adicionar
novo site (ou Editar site):
Se a opção Apenas administradores de sistema estiver selecionada, os administradores
de site não poderão adicionar, nem remover usuários de site. No entanto, eles ainda poderão
gerenciar grupos, projetos, pastas de trabalho e conexões de dados em seus sites. Se a opção
Administradores de site e administradores de sistema estiver selecionada (o padrão),
os administradores de site poderão executar todas as ações acima e adicionar ou remover
usuários.
Licenciamento e limites do usuário
Os usuários podem pertencer a vários sites, com diferentes direitos de usuário e níveis de
licença em cada site. No entanto, um usuário que pertence a vários sites não precisa de uma
licença para cada site. Cada usuário do servidor precisa somente de uma licença.
Os administradores de sistema podem usar a configuração Quantidade máxima de
usuários no site <n> para especificar um limite de usuários de um site. Somente usuários
licenciados são contabilizados; os administradores de sistema não são considerados. Por
exemplo, se um site tiver 90 usuários licenciados, 20 usuários licenciados e um administrador
de sistema, a contagem de usuários será 90. Se a opção Quantidade máxima de usuários
no site estiver definida como 100, será possível adicionar mais 10 usuários licenciados.
Adicionar ou editar sites
Se você for um administrador de sistema, poderá adicionar um site ao Tableau Server ou
editar um existente seguindo as etapas abaixo:
1. Abra a página Sites clicando em Sites, em Admin e clique em Adicionar:
Ou, se você estiver editando um site, selecione o site que deseja alterar e clique em
Editar. Se você não adicionou sites ao Tableau Server, haverá apenas um único site
para selecionar: Padrão.
2. Insira um Nome do site e ID do site para o site (se você estiver editando usando o site
Padrão, não poderá alterar a ID do site):
A letra “t” na URL (por exemplo, http://localhost/t/wsales) não pode ser alterada. Em
sistemas de servidor de vários sites, ela aparece na URL de sites diferentes do site
padrão.
3. Pastas de trabalho, extrações e fontes de dados consomem espaço de armazenamento
no servidor. Selecione Sem limite ou Cota e insira o número de GB desejado como
limite. Se você definir uma cota e o site excedê-la, os publicadores serão impedidos de
carregar um novo conteúdo até que o site esteja dentro do limite novamente. Os
administradores do sistema podem rastrear onde o site é relativo a essa cota usando as
colunas Cota de armazenamento e % Cota usada na página Sites.
4. Em seguida, selecione se apenas você, o administrador de sistema, pode adicionar e
remover usuários (Apenas administradores de sistema) ou se isso pode ser feito por
ambos os tipos de administradores (Administradores de site e administradores de
sistema).
Se você estiver permitindo que administradores de site adicionem usuários, especifique
quantos usuários eles podem adicionar ao site selecionando uma destas opções:
l
l
Até a capacidade do servidor: Para um servidor com licenciamento baseado
em usuário, o limite é o número de licenças de posições no servidor disponíveis.
Para um servidor com licenciamento baseado no núcleo, não há um limite para o
número de usuários que podem ser adicionados.
Quantidade máxima de usuários no site <n>: Permite que um administrador
de site adicione usuários até um limite especificado por você. Consulte Como
trabalhar com sites para obter informações sobre licenciamento e limites de
usuário.
5. Selecione Permitir registro de desempenho para permitir que os usuários do site
coletem métricas sobre o desempenho das pastas de trabalho, como, por exemplo, a
velocidade de carregamento, etc.
Além de ter essa caixa de seleção marcada para o site, para começar a gravação, os
usuários devem adicionar um parâmetro à URL da pasta de trabalho. Consulte Criar um
registro de desempenho para obter mais informações.
6. Em Configurações de assinatura do site, mantenha Habilitar assinaturas selecionado
se quiser que os usuários do site possam assinar as exibições. Essa opção só estará
visível se você também tiver definido configurações de assinatura na caixa de diálogo
Configuração.
Você também pode inserir um Endereço de envio personalizado para as assinaturas.
Embora o endereço que você inserir deva usar uma sintaxe de endereço de email válida
(por exemplo, [email protected] ou noreply@sales), o Tableau Server não
exige que ele corresponda a uma conta de email real (alguns servidores de SMTP
podem exigir que seja um endereço real, no entanto).
7. Em Rodapé do email, selecione Personalizado e insira qualquer texto que você
quiser que apareça acima da URL do Tableau Server em rodapés de assinaturas. Por
exemplo, se você inserir este texto:
O rodapé do email será semelhante ao seguinte:
8. Clique em OK.
Se você estiver adicionando seu primeiro site ao Tableau Server, a guia Admin será alterada.
A opção Usuários agora é Todos os usuários, pois pertence a todos os usuários no
servidor, e uma categoria Usuários do site é exibida.
Adicionar usuários a um site
Ao adicionar um site ao Tableau Server, ele se torna um sistema com vários sites, e o que
antes era a página Usuários passa a ser duas páginas: Todos os usuários e Usuários do
site. Como administrador de sistema, só você pode acessar a página Todos os usuários,
que se aplica a todo o sistema do servidor. Ela é o único local em que você pode adicionar
usuários a vários sites de uma vez, remover usuários e, se o servidor estiver usando a
autenticação local, redefinir senhas de usuários.
A página Usuários do site é uma forma simples de ver rapidamente quais usuários estão no
site em que você entrou no momento. Você pode adicionar usuários a partir daqui, mas eles só
serão adicionados a esse site.
O procedimento a seguir descreve como adicionar usuários de Todos os usuários. Há duas
abordagens que você pode adotar: Um de cada vez (como descrito abaixo) ou em lotes
usando o comando Importar, que depende de um arquivo CSV (como descrito em Importar
usuários de um arquivo CSV).
Para adicionar um usuário:
1. Na página Todos os usuários, clique no link Adicionar na parte superior da lista de
usuários:
2. Insira um Nome de usuário:
l
l
Autenticação local — Se o servidor estiver usando autenticação local, utilizar
um endereço de e-mail como o nome de usuário é a melhor maneira de evitar
conflitos de nome de usuário (por exemplo, [email protected] e não jsmith).
Active Directory— Se você estiver adicionando um usuário do mesmo domínio
do Active Directory em que o servidor está sendo executado, poderá digitar o
Nome de usuário sem o domínio. O domínio do servidor será adotado.
Se houver uma configuração de confiança bidirecional entre o domínio do
servidor e outro domínio, você poderá adicionar usuários de ambos os domínios.
Na primeira vez que você adicionar um usuário do “domínio fora do servidor”, use
o nome de domínio totalmente qualificado com o nome de usuário. Os usuários
subsequentes podem ser adicionados usando o apelido do domínio. Por
exemplo, adotando um “domínio fora do servidor” de mybiz.lan, digite o primeiro
usuário desse domínio como [email protected] ou mybiz.lan\user1. O próximo
usuário pode ser inserido usando o apelido do domínio, como user2@mybiz ou
mybiz\user2.
Observação: Não insira o Nome completo do usuário nesse campo, pois isso
pode causar erros durante o processo de importação.
3. Se o servidor estiver usando autenticação local, forneça o seguinte:
l
Nome completo: digite um nome de exibição para o usuário (p. ex., John Smith).
l
Senha: digite uma senha para o usuário.
l
Confirmação: digite a senha novamente.
4. Associação ao site — Selecione de quais sites o usuário deve ser membro. O site em
que você entra é selecionado por padrão.
5. Nível de licença e direitos do usuário — Selecione o nível de licença, a função
Admin e se o usuário pode publicar pastas de trabalho e fontes de dados. Um usuário
que pertence a vários sites pode ter níveis de licença e direitos de usuário diferentes em
cada site. Consulte Sobre níveis de licença, Permissões e Sobre direitos do usuário
para saber mais.
6. Clique em Adicionar usuário.
Excluir sites
Os administradores de sistema podem excluir sites que foram adicionados ao Tableau Server.
A exclusão de um site também remove pastas de trabalho e fontes de dados que foram
publicadas no site, bem como usuários. Se um usuário pertencer a outros sites, eles não serão
removidos. Para remover permanentemente um usuário, você precisa usar a página Todos os
usuários.
Para excluir um site:
1. Abra a página Sites em Servidor:
2. Selecione o site que deseja remover e clique em Excluir:
3. Clique em Sim na caixa de diálogo de confirmação que aparece.
Navegação em vários sites
Vejamos algumas dicas sobre como navegar de site para site e identificar qual site você está
usando.
Entrada no site
Caso seja membro de vários sites, ao entrar no servidor, você deve escolher um site:
Navegação para outros sites
Se você pertence a vários sites, verá um menu Site no alto da página:
Para entrar em um site diferente, clique no menu Site e selecione o site:
Identificação de seu site
Caso o servidor esteja executado vários sites, mas você pertença a apenas um, você não
precisa escolher seu site na entrada no servidor. Depois de entrar, você não verá um menu
Site no alto da página:
No entanto, a URL do navegador da web mostrará um t seguido pela ID do site referente ao
seu site:
Se o servidor não estiver executando vários sites, a URL do navegador da web será
semelhante a isto (sem t, sem ID do site). Se você vir isto, estará usando o site interno do
Tableau, que é chamado de Padrão.
Manutenção do servidor
Como um administrador do sistema, você desejará verificar o status do servidor, analisar e
monitorar a atividade no servidor, gerenciar tarefas agendadas ou executar determinadas
atividades de manutenção, como recriar o índice de pesquisa. Além disso, existem várias
configurações que talvez você queira especificar para personalizar a experiência do usuário
para pessoas que usam o servidor. Isso tudo isso pode ser feito na página Manutenção.
Exibir o status de processo do servidor
Você pode usar a tabela Status na página Manutenção para exibir o estado dos processos do
Tableau em cada Tableau Server:
Para obter informações sobre o status não licenciado de um processo do VizQL Server,
consulte Manipular um processo do VizQL Server não licenciado.
Para exibir uma versão das informações acima que possa ser lida pelo computador, na página
Manutenção, substitua a palavra status na sua URL por systeminfo (por exemplo,
http://jsmith/admin/systeminfo). Uma página da Web semelhante à página a seguir aparece:
Os tipos de status para um serviço do Tableau são OK, Ocupado, Inoperante e Standby.
Acessar o status remotamente
Como administrador do Tableau, somente você pode ver as ferramentas na página
Manutenção, incluindo a tabela Status. No entanto, você pode disponibilizar a versão da
tabela Status que pode ser lida pelo computador para usuários não administrativos e a
computadores que não estejam hospedando o Tableau Server, por exemplo, como parte de
um processo de monitoramento remoto. Para conceder acesso remoto ao status do serviço do
Tableau:
1. No computador que está executando o Tableau Server, abra o arquivo config do
Tableau Server:
ProgramData\Tableau\Tableau Server\config\tabsvc.yml
2. Adicione a linha wgserver.systeminfo.allow_referrer_ips: <IP
address or name> para tabsvc. yml, em que <IP address or name> é o
endereço IPv4 ou o nome do computador que você gostaria de adicionar. Caso você
esteja concedendo acesso de status de serviço a vários computadores, use vírgulas
(sem espaços) para separar cada entrada. IP. Por exemplo:
3. Salve e feche tabsvc.yml.
4. Abra um prompt de comando como um administrador e digite:
cd "C:\Program Files\Tableau\Tableau Server\8.1\bin"
5. Em seguida, use o comando a seguir para reiniciar os processos do Tableau Server:
tabadmin restart
Agora, usuários em computadores cujos endereços IP ou nomes de computador
tenham sido adicionados a tabsvc.yml podem exibir o status do processo do Tableau
digitando a URL http://<server>/admin/systeminfo em um navegador ou
em uma linha de comando (por exemplo, curl
http://jsmith/admin/systeminfo). Essa funcionalidade também pode ser
usada como parte de um processo de monitoramento remoto automatizado.
Recompilar o índice de pesquisa
Se por qualquer motivo o índice de pesquisa parar de retornar os resultados corretos ou não
apresentar todos os resultados, talvez seja preciso recriar o índice de pesquisa. Além disso,
você deverá recriar o índice de pesquisa se o indexador for desativado por um longo período.
1. Para recompilar o índice de pesquisa clique em Manutenção na guia Admin:
2. Clique em Recompilar índice de pesquisa para começar.
Limpar senhas de conexão de dados salvas
Como administrador, se você habilitar a configuração Senhas salvas, os usuários do servidor
poderão salvar senhas de fonte de dados em vários navegadores e visitas. Você pode
redefinir todas as senhas de todos os usuários do Tableau Server, o que os força a entrar nas
fontes de dados na próxima vez em que visitarem uma exibição que exija autenticação do
banco de dados. Os usuários do servidor também podem limpar suas senhas de conexão de
dados salvas individualmente usando a página Preferências de usuário.
Para limpar senhas de conexão de dados salvas de todos os usuários do servidor:
1. Clique no link Manutenção na seção Administração no lado esquerdo da página:
2. Em Atividades, clique em Limpar todas as senhas de conexão de dados salvas
para todos os usuários.
Configurações de manutenção
As configurações a seguir estão disponíveis na seção Configurações da página Manutenção
no servidor:
Configuração
Descrição
Credenciais
inseridas
Permite que os publicadores anexem senhas a pastas de trabalho
publicadas que autenticarão automaticamente usuários da Web para se
conectarem às fontes de dados. As senhas são anexadas às pastas de
trabalho e só podem ser acessadas no servidor. Isto é, quando a pasta de
trabalho é aberta no Tableau Desktop, os usuários ainda precisarão
inserir um nome de usuário e uma senha para se conectarem à fonte de
dados. Quando essa configuração é desativada, todas as senhas
inseridas existentes são salvas, mas não são usadas para autenticação.
Dessa forma, se você ativar novamente a configuração, os usuários não
precisarão reinserir as senhas.
Agendamento
Permite que os publicadores atribuam pastas de trabalho a agendas.
Essa opção só estará disponível se Credenciais inseridas estiver
habilitada. Quando essa configuração for desabilitada, os publicadores
verão opções de agendamento na caixa de diálogo Publicar.
Permite que os usuários salvem senhas de fonte de dados em vários
navegadores e visitas. Por padrão, os usuários podem optar por "Lembrar
minha senha até eu sair", que os permite salvar suas senhas durante uma
sessão de navegador única. Quando a configuração Senhas salvas é
selecionada, um usuário pode optar por Lembrar minha senha, que salva
Senhas salvas
a senha em vários navegadores e visitas, de modo que os usuários serão
autenticados automaticamente, independentemente do computador que
estejam usando. Você, como um administrador, pode limpar todas as
senhas salvas a qualquer momento. Além disso, os usuários podem
limpar suas próprias senhas salvas.
Habilitar
convidado
Permite que os usuários exibam e interajam com exibições inseridas sem
precisar entrar em uma conta do Tableau Server. A permissão pode ser
atribuída à conta de usuário convidado para controlar a interatividade
permitida para cada exibição. Essa opção estará disponível somente se
você tiver uma licença de servidor baseada em núcleo. Esta opção pode
ser usada com Habilitar logon automático, uma opção que você pode
selecionar durante a Instalação.
Página inicial
padrão
Leva você à página inicial padrão atual do servidor para todos os usuários.
Consulte Definir a página inicial padrão para todos os usuários para ver as
etapas sobre como alterá-la. Usuários individuais poderão substituir essa
configuração (consulte Sua página Preferências de usuário para obter
detalhes).
Idioma e
localidade
padrão
Controla o idioma usado para a interface de usuário do servidor e a
localidade usada para exibições. Usuários individuais podem substituir
essa configuração em sua página Preferências do usuário. Além disso, as
configurações do navegador da Web são o primeiro item usado para
determinar qual idioma e localidade serão usados. Consulte Idioma e
localidade para obter mais informações.
Redefinir
todas as
configurações Qualquer configuração de servidor que tenha sido alterada desde a
para seus
Instalação será retornada ao seu estado original.
valores
padrão
Definir a página inicial padrão para todos os usuários
Por padrão, o Tableau Server é instalado com a página Exibições como a página inicial padrão
para todos os usuários. Como administrador, você pode alterar essa página para outra que
todos os usuários possam acessar, como a página Pastas de trabalho. Usuários individuais
poderão substituir sua configuração (consulte Sua página Preferências de usuário para obter
detalhes).
Para definir a página inicial padrão para todos os usuários:
1. Navegue até a página que você quer definir como padrão.
2. Clique em seu nome no canto superior direito da página.
3. Selecione Tornar esta a página inicial padrão para todos os usuários.
Tableau Server Monitor
O Tableau Server Monitor é instalado como parte do Tableau Server e pode ser acessado na
bandeja do sistema do Windows.
Usando essa ferramenta, é possível iniciar e interromper o servidor, abrir o Tableau Server e
exibir o status do servidor.
Abrir o servidor
Esse comando inicia o Tableau Server no navegador da Web. Essa é uma maneira fácil de
acessar o aplicativo Web e as ferramentas de manutenção associadas.
Iniciar/interromper o servidor
Você pode iniciar e interromper o servidor usando esses comandos. Quando você interrompe
o servidor, ele se torna indisponível para todos os usuários e encerra qualquer sessão que
esteja atualmente em andamento. Se alguém estiver publicando uma pasta de trabalho
quando o servidor for interrompido, o processo será abandonado. Como resultado, somente
algumas das planilhas na pasta de trabalho podem ser publicadas no servidor. Como
interromper o servidor pode atrapalhar bastante os usuários, certifique-se de avisá-los antes
de executar essa operação ou planeje a manutenção para que ela ocorra em horários não
comerciais.
Reiniciar o servidor
Esse comando reinicia o servidor. Enquanto o servidor estiver reiniciando, ele estará
indisponível a todos os usuários. Não se esqueça de avisar os usuários da paralisação antes
dessa operação. Será preciso reiniciar o servidor se você fizer alterações na configuração do
Tableau Server.
Exibir status
Esse comando abre uma dica de tela que contém o status de cada processo. Para obter mais
detalhes de status, use a página Manutenção.
Gerenciar chaves de produto
Esse comando abre o gerenciador de chaves de produto, onde é possível adicionar e remover
chaves de produto.
Sair
Esse comando fecha o Tableau Server Monitor. Ele não interrompe o Tableau Server. Você
pode reabrir o aplicativo selecionando Todos os Programas > Tableau Server 8.1 >
Tableau Server Monitor no menu Iniciar do Windows.
Fontes de dados
Uma fonte de dados do Tableau Server é uma conexão com dados reutilizável. Ela pode
incluir uma extração de dados ou informações de uma conexão de passagem para um banco
de dados relacional ativo. Também pode incluir uma camada de personalizações, como
cálculos, grupos ou conjuntos.Tableau Server Os usuários com as permissões apropriadas
podem usar uma fonte de dados para criar pastas de trabalho do zero no servidor. Consulte
Criar uma pasta de trabalho e criar uma exibição para obter detalhes. Os administradores
podem executar duas tarefas principais na página Fontes de dados:
l
l
Editar e exibir permissões de fonte de dados: Use permissões para especificar
quais usuários ou grupos podem se conectar a fontes de dados, modificá-las e baixálas. Consulte Definição de permissões para uma fonte de dados para obter mais
informações.
Agendar extrações de fonte de dados para atualização: Se uma fonte de dados
inclui uma extração, você pode atribuir a extração para uma agenda de atualização.
Consulte Agendamento de tarefas para obter mais informações.
Embora ambas as tarefas acima possam ser executadas no Tableau Desktop pela pessoa
que publicou a fonte de dados, os administradores também podem alterar as configurações.
Também é possível usar a página Fontes de dados para remover uma fonte de dados ou
adicionar marcas a ela. Consulte os tópicos abaixo para obter mais informações.
Gerenciar fontes de dados
Para que os usuários trabalhem com as fontes de dados do Tableau Server, eles precisam ter
as permissões apropriadas para a fonte de dados. Para fontes de dados que são conexões
proxy, você também deve estar ciente de como os usuários serão autenticados no banco de
dados e saber se você tem os drivers apropriados instalados no Tableau Server. Para obter
informações, veja a seguir.
Definir permissões para uma fonte de dados
Drivers de banco de dados
Segurança de dados
Sobre o Data Server do Tableau
O Data Server do Tableau é um componente de servidor que permite gerenciar e armazenar
centralmente as fontes de dados do Tableau Server. Uma fonte de dados é uma conexão com
dados reutilizável. Os dados podem ser localizados no processador de dados do Tableau,
como uma extração, ou em um banco de dados relacional dinâmico (cubos não têm suporte).
No segundo caso, as informações armazenadas na fonte de dados se destinam a uma
conexão de passagem. A fonte de dados também pode incluir personalizações feitas no nível
de campo no Tableau Desktop, como cálculos, aliases de dimensão, grupos ou conjuntos.
Para administradores, há muitas vantagens em usar as fontes de dados do Tableau Server.
Como uma extração de fonte de dados pode ser usada por muitas pastas de trabalho, você
economiza espaço no servidor e tempo de processamento. As atualizações da extração
podem ser agendadas por extração, e não por pasta de trabalho, e quando uma pasta de
trabalho que usa uma fonte de dados do Tableau Server for baixada, a extração de dados
permanecerá no servidor, resultando em menos tráfego de rede. Por fim, se um driver do
banco de dados for exigido para uma conexão, você só precisará instalá-lo uma vez, no
Tableau Server, e não várias vezes em todos os desktops dos usuários.
Para usar o Data Server, basta que os autores se conectem a dados no Tableau Desktop, seja
criando uma extração ou por uma conexão com o banco de dados relacional ativo, e que
publiquem isso no Tableau Server. Uma vez publicadas, essas fontes de dados reutilizáveis e
o servidor contêm tudo que os autores da pasta de trabalho precisam para se conectarem aos
dados rapidamente e iniciar a criação.Para alterar uma fonte de dados publicada, baixe-a no
Tableau Desktop, faça as alterações e republique-a, substituindo a versão original. Observe
que os membros novos adicionados a um parâmetro ou as alterações feitas na ordem de
classificação padrão não farão parte da fonte de dados (farão parte da pasta de trabalho).
Se você estiver executando uma instalação distribuída do Tableau Server e espera que as
fontes de dados sejam usadas continuamente, existem várias maneiras de otimizar a
implantação do seu servidor. Consulte Ambientes distribuídos para obter mais informações.
Usar fontes de dados
Se você for autor de uma pasta de trabalho, usar uma fonte de dados do Tableau Server é
simplesmente uma questão de se conectar a ela a partir do Tableau Desktop. Na página
Conectar a dados do Tableau Desktop, clique em Tableau Server e forneça suas
credenciais:
Depois que você entra no Tableau Server, as fontes de dados disponíveis são listadas à
direita. Para ver uma fonte de dados, a pessoa que a publicou precisa ter definido a permissão
Conectar como Permitir para você como um usuário. Por padrão, todos os usuários têm essa
permissão.
Selecione uma fonte de dados e ela será carregada na janela Dados da pasta de trabalho.
Tableau Server fontes de dados têm um ícone do Tableau em vez de um ícone de banco de
dados:
Para obter mais informações sobre a publicação de fontes de dados do Tableau Desktop,
consulte Publicar fontes de dados na ajuda on-line do Tableau Desktop.
Solucionar problemas de fontes de dados
Para que os usuários trabalhem com as fontes de dados do Tableau Server, até três itens
precisa ser definidos:
l
l
l
Permissões para a fonte de dados: Qualquer pessoa que for se conectar a uma
fonte de dados deve ter as permissões Conectar e Exibir para essa fonte. Isso
também se aplica a usuários que acessam exibições que se conectam a fontes de
dados. Qualquer pessoa que esteja publicando e modificando fontes de dados deve
estar licenciada para Publicar e também ter as permissões Baixar/salvar na Web
como e Baixar/salvar na Web como. Consulte Trabalhar com permissões e Definir
permissões para uma fonte de dados para obter mais informações.
Capacidade de autenticação no banco de dados: Há várias maneiras de se
conectar aos dados no Tableau e controlar quem tem acesso a quê. Basicamente,
qualquer entidade que esteja se conectando ao banco de dados deve ser capaz de se
autenticar. A entidade pode ser o Tableau Server executando uma atualização de
extração. Pode ser um usuário do Tableau Desktop se conectando a uma fonte de
dados que então se conecta a um banco de dados dinâmico. Também pode ser um
usuário do Tableau Server que está acessando uma exibição que se conecta a um
banco dedados ativo. Consulte Segurança de dados para saber mais sobre suas
opções.
Drivers de banco de dados: Se a pessoa que criou e publicou a fonte de dados no
Tableau Desktop precisou instalar drivers de bancos de dados adicionais, talvez você
precise instalá-los também no Tableau Server. Se você estiver executando uma
instalação distribuída do Tableau Server onde, por exemplo, o processo do data server
está sendo executado em um servidor de trabalho, todos os drivers de banco de dados
necessários devem ser instalados nesse servidor, bem como no servidor primário.
Outros processos também requerem drivers. Consulte Drivers de banco de dados para
obter mais informações.
Mensagens de erro da fonte de dados
Veja aqui alguns erros que os autores da pasta de trabalho e outros usuários podem encontrar
enquanto trabalham com fontes de dados e exibições:
A permissão para acessar esta fonte de dados do Tableau Server foi negada: A
conexão com uma fonte de dados exige a permissão Conectar. Consulte Trabalhar com
permissões e Definir permissões para uma fonte de dados para obter mais informações.
Fonte de dados não encontrada: Alguém que estiver trabalhando com uma exibição
poderá ver esse erro se uma fonte de dados for removida do Tableau Server ou se a página
Conectar a dados precisar ser atualizada. Para atualizar a página Conectar a dados no
Tableau Desktop, clique no ícone Atualizar:
Não é possível conectar a esta fonte de dados do Tableau Server: Esse erro pode
aparecer se as informações de conexão para a fonte de dados forem alteradas, por exemplo,
em resultado da alteração do nome do servidor de banco de dados. Observe as informações
de Conexão de dados da fonte de dados e verifique se as configurações estão corretas.
Não é possível listar fontes de dados do Tableau Server: Esse erro poderá ocorrer se
um usuário estiver tentando acessar as fontes de dados do Tableau Server e houver
problemas de conectividade entre o Tableau Server e o Tableau Desktop.
Não é possível conectar a uma fonte de dados de cubo: Não há suporte de conexões a
fontes de dados de cubos (como MSAS). Os dados precisam ser uma extração ou uma
conexão ativa a um banco de dados relacional.
Conexões de dados
Cada pasta de trabalho que é publicada no Tableau Server contém uma ou mais conexões.
Essas conexões são listadas na guia Admin, na página Conexões de dados:
A diferença entre Conexões de dados e Fontes de dados
As conexões de dados são diferentes das fontes de dados já que cada conexão é associada a
uma única pasta de trabalho e descreve os atributos exigidos para conexão com uma fonte de
dados (por exemplo, nome de servidor, nome do banco de dados, etc.). Isso significa que se
você tiver três pastas de trabalho que se conectam à mesma fonte de dados, existirão três
conexões listadas na página de conexões.
Pesquisa de conexões de dados
A área Pesquisar na parte superior da página Conexões de dados ajuda você a localizar
conexões por nome do servidor de banco de dados, nome de usuário, porta, tipo de conexão
geral e credenciais de banco de dados inseridas ou não. Para usar essa área para pesquisar
uma conexão, preencha uma ou mais áreas e clique em Pesquisar:
Que conexões eu posso editar?
Você pode editar informações de conexão para conexões de banco de dados ativas e para
extrações que precisam ser atualizadas pelo Tableau Server. Por exemplo, é possível ter um
grande número de pastas de trabalho que se conectam a um banco de dados em um servidor
de banco de dados específico. Se o nome do servidor for alterado, você poderá atualizar todas
as pastas de trabalho de uma vez para que elas façam referência ao novo nome do servidor.
Outro exemplo é se uma pasta de trabalho se conectar a um banco de dados usando um nome
de usuário e uma senha específicos. É possível atualizar rapidamente todas as pastas de
trabalho para usar um conjunto diferente de credenciais. Para obter detalhes sobre como
editar conexões de dados, consulte o tópico abaixo.
Editar conexões de dados
Use a página Conexão de dados para gerenciar as informações de conexão de todas as
pastas de trabalho publicadas no servidor ou em um site. Para modificar atributos de conexão:
1. Se você estiver executando vários sites no servidor, conecte-se ao site que tem as
conexões de dados que deseja modificar.
Navegue até a página Conexões de dados.
2. Use a caixa de pesquisa na parte superior da lista de conexões para encontrar as
conexões a serem editadas. Você pode procurar por Servidor, Tipo de conexão,
Porta do servidor, Nome de usuário do banco de dados e pela opção Tem senha
inserida.
Os valores digitados nos campos Servidor e Nome de usuário do banco de
dados são tratados como expressões regulares.
3. Selecione as conexões a serem modificadas na lista de resultados da pesquisa:
4. Digite um novo valor para um ou mais dos atributos de conexão. Se um banco de dados
ou um driver de banco de dados não aceitar conexão via endereço IP, o valor
especificado para Servidor deverá ser o nome do banco de dados. Todos os atributos
selecionados na coluna Alterar? serão atualizados. Se você marcar a caixa de seleção
Alterar? e deixar o campo Novo valor em branco, o atributo também será definido
como em branco.
5. Clique em Enviar.
6. Atualize a página do servidor (pressione F5) para que suas alterações entrem em vigor.
Monitorar andamento
Uma caixa de diálogo do monitor é aberta automaticamente quando você observa o
andamento das alterações. Se você fechar essa caixa de diálogo, as modificações serão
executadas em segundo plano até serem concluídas. Tableau Server fará o maior número de
alterações possível. Todas as falhas serão ignoradas, mas não impedirão que outras
alterações sejam feitas. Por exemplo, se você tentar alterar o nome do servidor e adicionar
uma senha a várias conexões, os nomes de servidor serão alterados e as senhas nas pastas
de trabalho também, mas como não é possível adicionar uma senha a uma fonte de dados, as
senhas para as fontes de dados não serão alteradas.
Há uma exibição administrativa que permite revisar detalhes de tarefas concluídas e
pendentes. Consulte Tarefas em segundo plano para saber mais.
Personalizar o servidor
É possível personalizar a aparência do Tableau Server para sua empresa ou seu grupo. Por
exemplo, você pode alterar o nome que aparece nas dicas e mensagens de tela, bem como
alterar o logotipo que aparece na maioria das páginas do servidor.
Também é possível personalizar como os usuários podem interagir com o servidor. Por
exemplo, você pode permitir que os editores da pasta de trabalho insiram as respectivas
credenciais de fonte de dados para que quando as pessoas cliquem em uma exibição
publicada com uma conexão a uma fonte de dados ativa, elas obtenham acesso imediato à
exibição e não tenham que fornecer as respectivas credenciais de banco de dados primeiro.
Também é possível controlar que idioma será usado para a interface de usuário do servidor e
qual localidade será usada para as exibições.
Consulte os tópicos a seguir para obter mais informações sobre como personalizar o Tableau
Server:
Alterar o nome ou o logotipo
É possível personalizar os seguintes aspectos da aparência do Tableau Server:
Alterar o nome
Você pode personalizar a aparência do Tableau Server personalizando o nome que aparece
nas dicas de ferramenta e mensagens. Por exemplo, se você alterar o nome para MyCo, o
texto na página Logon do servidor será "Digite seu nome de usuário e a senha do MyCo para
fazer logon," e a dica de ferramenta do ícone de navegação da página inicial exibirá Início do
MyCo em vez de Início do Tableau Server:
As informações de copyright no final de cada página do servidor ainda listarão Tableau (por
exemplo, ©2013, Tableau Software, Incorporated e seus licenciadores. Todos os direitos
reservados.)
Para alterar o nome que aparece nas dicas de ferramenta e mensagens:
1. Abra um prompt de comando como um administrador e digite o seguinte:
cd "C:\Program Files\Tableau\Tableau Server\8.1\bin"
2. Altere o nome digitando o seguinte:
tabadmin customize name "new_name"
Na linha acima, substitua "new_name" pelo texto que você quer que apareça como o
nome no servidor. Exemplo: tabadmin customize name "Company Server"
3. Reinicie o servidor para que a alteração entre em vigor digitando:
tabadmin restart
Alterar o logotipo
É possível personalizar a aparência do Tableau Server personalizando o logotipo que aparece
na página de logon do Tableau Server e na coluna esquerda das páginas principais do
servidor (como a página Projetos, página Pastas de trabalho, página Manutenção, etc.). O
tamanho de logotipo grande aceito é de até 160 x 160 px e é implementado com a execução
do comando tabadmin customize logo. Também é possível personalizar o logotipo que
aparece no canto superior esquerdo de cada pasta de trabalho e exibição. O tamanho de
logotipo pequeno aceito é de até 32 x 32 px e é implementado com a execução do comando
tabadmin customize smalllogo.
Se uma imagem for maior que 160 x 160 px (logotipo grande) ou 32 x 32 px (logotipo
pequeno), ela aparecerá cortada. O arquivo de imagem que você usa deve estar no formato
GIF, JPEG ou PNG. O logotipo do Tableau que aparece na guia do navegador da Web do
servidor e à esquerda do endereço da URL não pode ser alterado.
Para alterar o logotipo:
1. Abra um prompt de comando como um administrador e digite o seguinte:
cd "C:\Program Files\Tableau\Tableau Server\8.1\bin"
2. Altere o logotipo digitando o seguinte para um logotipo "tamanho grande" (até 160 x 160
px, mas não menor que 32 x 32 px):
tabadmin customize logo "C:\My Pictures\logo.png"
Se seu logotipo tiver o tamanho 32 x 32 px ou menor, use o seguinte comando:
tabadmin customize smalllogo "C:\My Pictures\logo.png"
3. Reinicie o servidor para que a alteração entre em vigor digitando:
tabadmin restart
Restaurar o nome ou o logotipo padrão
Você pode restaurar a aparência padrão do Tableau Server seguindo os passos a seguir:
1. Abra um prompt de comando como um administrador e digite o seguinte:
cd "C:\Program Files\Tableau\Tableau Server\8.1\bin"
2. Altere o logotipo digitando o seguinte:
tabadmin customize <parameter> -d
Na linha acima, substitua <parameter> pelo item que deseja restaurar, name ou
logo.
3. Reinicie o servidor para que a alteração entre em vigor digitando:
tabadmin restart
Idioma e localidade
O Tableau Server está localizado em vários idiomas e tem configurações de idioma e
localidade que podem ser definidas por usuário (consulte Sua página Preferências de usuário)
e para todo o sistema (consulte Configurações de manutenção). A definição de Idioma
controla itens de UI (interface de usuário), como menus e mensagens. A definição de
Localidade controla itens nas exibições, como formatação de número e moeda.
Configurações padrão
O Tableau Server obtém sua configuração padrão de idioma durante a instalação. Se o
computador host for definido para um idioma ao qual o Tableau Server oferece suporte, ele
será instalado com esse idioma. Se não for um idioma com suporte, o Tableau Server será
instalado em inglês.
Como o idioma e a localidade são determinados
Outra influência em que idioma e localidade são exibidos quando um usuário clica em uma
exibição é o navegador da Web do usuário. Se um usuário do servidor não tiver especificado
uma definição de Idioma na página Conta de usuário e o navegador da Web for definido para
um idioma com suporte do Tableau Server, o idioma do navegador será usado, mesmo se o
próprio Tableau Server estiver definido para um idioma diferente.
Vejamos um exemplo: Suponhamos que o Tableau Server tenha uma configuração que
abranja todo o sistema definindo Inglês como o Idioma para todos os usuários. O usuário do
servidor, Claude, não tem um idioma especificado na sua página Conta de usuário do Tableau
Server. O navegador de Claude usa Alemão (Alemanha) para seu idioma/localidade.
Quando Claude entra no Tableau Server, a UI do servidor é exibida em alemão e quando ele
clica em Exibição A, é usada a localidade Alemanha para números e moeda. Se Claude
tivesse definido Idioma e Localidade da sua conta de usuário para Francês (França), a UI e a
exibição teriam sido exibidas em francês. A definição da sua conta de usuário substitui as
definições do navegador da Web e ambas têm preferência sobre a configuração de todo o
sistema do Tableau Server.
Outra definição que precisa ser lembrada é a de Localidade no Tableau Desktop (Arquivo >
Localidade da pasta de trabalho). Essa definição determina a localidade dos dados na
exibição, como qual moeda é listada ou como os números são formatados. Por padrão,
Localidade no Tableau Desktop é definida como Automática. No entanto, um autor pode
substituir isso selecionando uma localidade específica. Usando o exemplo acima, se o autor
da Exibição A definisse Localidade para Grego (Grécia), determinados aspectos dos dados
na Exibição A seriam exibidos usando a localidade Grego (Grécia).
Veja as configurações que o Tableau usa para determinar o idioma e a localidade, na seguinte
ordem de preferência:
1. Localidade da pasta de trabalho (definida no Tableau Desktop)
2. Configurações de idioma/localidade da Conta de usuário do Tableau Server
3. Idioma/localidade do navegador da Web
4. Configurações de idioma/localidade da página Manutenção do Tableau Server
5. Configurações de idioma/localidade do computador host
Exibições administrativas
O Tableau Server apresenta várias exibições para administradores, desenvolvidas com o
intuito de ajudar a monitorar a atividade no Tableau Server. As exibições estão localizadas a
tabela Análise da página Manutenção:
Consulte o seguinte para obter mais informações:
Atividade do do servidor
A exibição administrativa Atividade do servidor mostra um instantâneo da atividade do
Tableau Server durante os últimos 30 dias.
Em Total de exibições ao longo do tempo, você pode focalizar em qualquer ponto da linha
e ver uma dica de ferramenta que mostra o número de exibições que foram abertas nesse dia,
além de outras informações:
Clique em um ponto na linha para atualizar os gráficos de barras para mostrar quais pastas de
trabalho foram visualizadas nesse dia e quem visualizou mais:
Selecionar a marca em Total de exibições ao longo do tempo também filtra o Padrão de
exibição total de 24 horas para mostrar o padrão de exibição desse dia específico. Se
nenhuma marca for selecionada em Total de exibições ao longo do tempo, o Padrão de
exibição total de 24 horas somará os dados em Total de exibições ao longo do tempo e
os exibirá em um período de 24 horas, para que você possa ver os padrões comuns no
período de um dia:
Atividade do usuário
A exibição Atividade do usuário pode ajudar a medir a intensidade da utilização da instalação
do Tableau Servere se você precisa comprar licenças adicionais. Especificamente, essa
exibição mostra para você quem entrou no Tableau Server, de onde e quando foi a última vez
em que ele interagiu com o servidor.
Se um usuário entrar usando vários navegadores, isso também será mostrado. Por exemplo,
caso um usuário entre uma vez usando o Internet Explorer e uma vez usando o Mozilla
Firefox, o nome desse usuário é exibido duas vezes. Mas, caso um usuário entre duas vezes
usando o Mozilla Firefox, o nome dele é exibido apenas uma vez.
Atualmente ativo significa que o usuário interagiu com o servidor durante os últimos cinco
minutos. Recentemente ativo indica que o usuário estava ativo entre os últimos cinco e 15
minutos; e Ocioso significa que não houve atividade do usuário nos últimos 15 minutos. Por
padrão, depois de quatro horas de inatividade, os usuários saem do Tableau Server. Você
pode alterar essa configuração usando a opção tabadmin Opções tabadmin set.
Na exibição Atividade detalhada do usuário, os círculos indicam uma ação como, por
exemplo, entrar ou filtrar uma exibição. As barras incluem o período total no qual houve
atividade. Para saber mais, basta focalizar uma área e uma dica de ferramenta será exibida:
Histórico do desempenho
Use Exibir histórico do desempenho para ver quais exibições são as mais caras em termos de
desempenho de servidor.
Há duas solicitações diferentes associadas a exibições: solicitações de carga inicial, em
laranja, e solicitações de cálculo, em azul. As últimas fazem com que o Tableau Server
recalcule o que o usuário está vendo. Isso inclui solicitações de recarga, bem como seleção e
filtragem de itens em uma exibição. As máscaras de exceções representam solicitações com
maior impacto no desempenho do servidor:
Tarefas em segundo plano
A exibição Tarefas em segundo plano mostra as tarefas executadas pelo servidor. As tarefas
mais comuns são aquelas associadas às ações do usuário. Elas são selecionadas por padrão
em Tipo de tarefa:
As tarefas podem ter um status de conclusão bem-sucedida, erro, em andamento ou
pendente:
Ícone Descrição
Erro: o servidor não pôde concluir a tarefa.
Êxito: o servidor concluiu a tarefa.
Em andamento: o servidor está concluindo a tarefa no momento.
Ícone Descrição
Pendente: uma tarefa que o servidor ainda não começou.
Para obter detalhes sobre uma máscara, focalize seu ícone:
Tableau Server pode executar vários processos em segundo plano paralelamente. Os
endereços IP em ID de segundo plano na exibição Tarefas em segundo plano mostram
quais máquinas foram designadas para executar processos em segundo plano:
Uma máquina com vários núcleos executando mais de um processo em segundo plano será
listada com <IP address>:0 para o primeiro processo, <IP address>:1 para o
segundo e assim por diante.
Utilização do espaço
A exibição Utilização do espaço pode ajudar a identificar quais pastas de trabalhos e fontes de
dados estão usando mais espaço em disco no servidor. A utilização do espaço em disco é
exibida por usuário, projeto e tamanho da pasta de trabalho ou fonte de dados e é
arredondada para o número inferior mais próximo.
Mova o cursor sobre qualquer barra de tamanho para exibir detalhes da utilização:
Você também pode analisar os links na dica de ferramenta. Por exemplo, você pode ir aos
detalhes do usuário e ver a pasta de trabalho.
Exibições personalizadas
As pessoas que trabalham com exibições podem usar a opção Lembrar minhas alterações
para salvar as respectivas exibições personalizadas e os editores podem permitir ou impedir o
compartilhamento das exibições personalizadas.
A exibição administrativa Exibições personalizadas lista todas as exibições no servidor que
foram personalizadas com Lembrar minhas alterações. Ela pode ser usada como um
indicador da popularidade ou importância da exibição.
Criar exibições administrativas personalizadas
Além das exibições administrativas predefinidas disponíveis na página Manutenção do
Servidor, você pode usar o Tableau Desktop para consultar e criar suas próprias análises de
atividade do servidor. O repositório do Tableau Server tem várias exibições de banco de dados
configuradas, às quais você pode se conectar e fazer consultas. A opção tabadmin
auditing.enabled controla se o Tableau Server coleta atividades de histórico do usuário e
outras informações no repositório. Ela é habilitada por padrão. A opção tabadmin
wgserver.audit_history_expiration_days controla quantos dias do histórico de eventos são
mantidos no repositório. Por padrão, isso é definido para 183 dias. Um aspecto a ser
observado é que a coleta de eventos de histórico não afetam o tamanho do arquivo de backup
do Tableau Server (.tsbak).
Para acessar essas exibições, primeiramente é preciso usar a ferramenta de linha de
comando para habilitar o acesso externo ao banco de dados do Tableau Server. Em seguida,
é preciso se conectar ao banco de dados do Tableau Server e consultá-lo.
Como habilitar o acesso externo ao banco de dados do Tableau Server
O repositório do Tableau Server tem várias exibições de banco de dados configuradas, às
quais você pode se conectar e fazer consultas como parte da criação de suas próprias
análises da atividade do Tableau Server. Para acessar essas exibições, primeiramente é
preciso usar o utilitário de linha de comando tabadmin de modo a habilitar o acesso externo ao
banco de dados.
1. Abra um prompt de comando como um administrador e digite:
cd "C:\Program Files\Tableau\Tableau Server\8.1\bin"
2. Em seguida, use o comando a seguir a fim de habilitar o acesso externo ao banco de
dados para o usuário "tableau" com uma senha especificada por você.
tabadmin dbpass [password]
Substitua a opção [password] por sua própria senha. Por exemplo:
tabadmin dbpass P@ssw0rD!
3. Reinicie o Tableau Server.
Depois de habilitar o acesso externo ao banco de dados, o Tableau permite que qualquer
endereço IP acesso o banco de dados, contanto que a senha correta seja fornecida. Siga as
etapas descrita em Conexão com o banco de dados do Tableau Server para conectar.
Para desabilitar o acesso externo mais tarde, execute tabadmin dbpass --disable e
reinicie o servidor.
Conexão com o banco de dados do Tableau Server
Após habilitar o acesso externo com o banco de dados do Tableau Server, siga as etapas
abaixo para se conectar ao banco de dados e consultá-lo.
1. No Tableau Desktop, selecione Dados > Conectar a dados e selecione PostgreSQL
como o banco de dados ao qual se conectar. Talvez seja preciso instalar drivers de
banco de dados PostgreSQL. Você pode baixar drivers do site
www.tableausoftware.com/drivers.
2. Na caixa de diálogo Conexão PostgreSQL, digite o nome ou a URL do Tableau Server.
Se você tiver uma instalação de servidor distribuída e um trabalho estiver hospedando o
repositório, insira o nome do trabalho.
Você deve se conectar usando a porta configurada para o pgsql.port, que é 8060, por
padrão. Para obter mais informações sobre portas, consulte Portas TCP/IP.
3. Digite workgroup como o banco de dados ao qual se conectar.
4. Conecte-se usando o seguinte nome de usuário e senha:
Nome de usuário: tableau
Senha: A senha que você especificou quando habilitou o acesso ao banco de dados do
Tableau Server.
5. Clique em Conectar.
6. Selecione uma ou mais tabelas para conectar. O usuário "tableau" tem acesso a todas
as tabelas que começam com um sublinhado e hist_. Por exemplo, é possível se
conectar a _background_tasks e _datasources. As tabelas que começam com
historical_ apontam para tabelas hist_. As tabelas hist_ contêm informações sobre os
usuários do servidor que não são apresentadas na exibição Atividade do usuário.
7. Clique em OK.
Segurança
Existem quatro componentes principais para segurança no Tableau Server:
Autenticação
A autenticação estabelece a identidade de um usuário. Isso é feito para impedir acesso não
autorizado ao Tableau Server e permite experiência de usuário personalizada. O Tableau
Server oferece suporte a quatro tipos de autenticação:
l
l
l
l
Active Directory: Autentica os usuários do Tableau Server com base nas respectivas
credenciais do Windows.
Autenticação local: Usa o mecanismo de autenticação interna fornecido com o
Tableau Server.
SAML: Usa um provedor de identidades (IdP) externo para autenticar usuários do
Tableau Server.
Autenticação confiável: Manipula a autenticação por meio de uma relação de
confiança entre o Tableau Server e um ou mais servidores Web.
Usar o Active Directory ou a Autenticação local é uma escolha que você faz durante a
Instalação do Tableau Server. Após a instalação, você não pode alternar entre as duas. Para
alternar os tipos de autenticação, desinstale o Tableau Server (seus dados serão
preservados) e execute a instalação novamente.
Você também pode optar por configurar o SAML durante a Instalação, mas este não é o único
momento em que pode configurá-lo. Quando o SAML identifica a autenticação do usuário, o
Active Directory ou a Autenticação local se torna aquilo que você está usando para gerenciar,
não autenticar, seus usuários do Tableau Server. O SAML pode ser habilitado ou desabilitado
sem que seja necessário desinstalar o Tableau Server e reexecutar a Instalação.
Active Directory
Quando o Active Directory é usado para autenticação de usuário, todos os nomes de usuário e
senha são gerenciados pelo Active Directory. Quando um usuário insere suas credenciais
para entrar no Tableau Server, o Tableau as transfere para o servidor Active Directory. Ele
não participa do processo de autenticação, embora armazene nomes de usuário (mas não
senhas) em seu repositório.
Com a autenticação de usuário do Active Directory, os administradores também podem entrar
automaticamente com base em suas credenciais do Windows (Habilitar logon automático).
Isso significa que as credenciais do usuário estão sendo passadas de seu computador local,
não de outro sistema ou portal em que eles possam ter entrado.
Por exemplo, se um usuário entrar em seu computador local como ‘MSmith’ e depois entrar no
portal do SharePoint como 'Mary', as credenciais passadas para o Tableau Server serão para
‘MSmith’. Para usar as credenciais do site do SharePoint (‘Mary’) em entrada automática, o
portal do SharePoint deve usar a web part do Tableau com autenticação confiável.
Os administradores podem sincronizar grupos com o Active Directory, seja de forma manual
ou programática, usando tabcmd. Consulte Sincronizar um grupo do Active Directory e
syncgroup group-name em Comandos de tabcmd para obter mais informações.
Autenticação local
Quando a Autenticação local é usada para autenticação do usuário, o Tableau Server
gerencia usuários, grupos, senhas e o processo inteiro de autenticação. As listas de usuários
podem ser facilmente importadas no Tableau Server e a maioria das funções de
gerenciamento de usuário pode ser executada de forma programática por meio de tabcmd. Os
usuários podem entrar manualmente inserindo suas credenciais quando solicitados ou ao
acessar conteúdo em um portal por meio da autenticação confiável transparente.
SAML
Quando o SAML é usado na autenticação do usuário, um provedor de identidades (IdP)
externo autentica usuários do Tableau Server. Ainda assim, você precisa usar o Active
Directory ou a Autenticação local para gerenciar seus usuários do Tableau Server, adicionálos ao Tableau Server etc., mas a parte da autenticação é identificada pelo IdP. Quando os
usuários entram no Tableau Server usando SAML, a entrada que eles veem pertence ao outro
IdP, e não ao Tableau Server. Consulte SAML para obter informações sobre como configurar
o SAML em seu site.
Autenticação confiável
A autenticação confiável significa que você configurou uma relação confiável entre o Tableau
Server e um ou mais servidores Web. Por exemplo, você pode ter sua autenticação confiável
de uso do wiki corporativo para mostrar painéis a funcionários que já estão conectados ao wiki,
sem exigência de outro logon.
Quando o Tableau Server recebe solicitações de um servidor Web confiável, ele supõe que o
servidor Web já foi tratado, independentemente de a autenticação ser necessária. O Tableau
Server recebe a solicitação com um token ou ticket resgatável e apresenta ao usuário uma
exibição personalizada que leva em consideração a função e as permissões do usuário.
Consulte Autenticação confiável para obter informações sobre como configurar a autenticação
confiável em seu site.
Autorização
A autorização é o que um usuário pode acessar e acessa assim que é autenticado. No
Tableau, a autorização é controlada pelos seguintes itens:
l
l
Funções e permissões: Definem recursos específicos que os usuários podem ou não
executar em certos objetos no Tableau. Uma função é um conjunto de permissões que
os administradores podem usar no estado em que se encontram ou personalizar.
Consulte Trabalhar com permissões para obter detalhes.
Licenciamento e direitos do usuário: Controla o conjunto máximo de permissões
que um usuário pode ter. Consulte Licenças e direitos do usuárioLicenças e direitos do
usuário e Permitir ou negar direitos do usuário.
Embora os itens acima controlem quais ações um usuário pode executar e sobre o quê, eles
não controlam quais dados aparecerão em uma exibição. Os dados que um usuário vê são
controlados por suas escolhas de segurança de dados.
Permissões iniciais
As permissões iniciais para um projeto são copiados do projeto Padrão. As permissões iniciais
para uma pasta de trabalho são copiadas das permissões para o respectivo projeto. As
permissões iniciais para uma exibição são copiadas das permissões da respectiva pasta de
trabalho. Essa é uma cópia ocasional das permissões do pai. As alterações nas permissões do
pai não são aplicadas automaticamente nos filhos, a menos que as novas permissões sejam
atribuídas ativamente ao conteúdo.
Qualquer item pode ter permissões que diferem do pai. Por exemplo, um grupo pode não ter
permissões para ver o Projeto X, mas pode ter permissões para ver uma exibição que é
publicada no Projeto X. O Tableau Server não oferece suporte a permissões de objeto
hierárquicas; no entanto, ele fornece um modelo de herança para usuários e grupos. Se um
usuário não tiver uma permissão explicitamente definida como Permitir ou Negar, a
configuração será herdada dos grupos aos quais o usuário pertence.
Permissões e o projeto padrão
Se o Tableau Server estiver implantado em um ambiente aberto onde o principal é o
compartilhamento de conhecimento e informações, você deverá considerar a definição de
permissões para o projeto Padrão para incluir o grupo Todos os usuários, com sua função
definida como Interagente. Os usuários poderão publicar automaticamente e consumir
conteúdo de novos projetos.
Se o Tableau Server estiver implantado em um ambiente restritivo onde o principal é a
segurança de dados e o controle de acesso, considere remover as permissões para o projeto
Padrão: Exclua as permissões de todos os usuários e grupos. Os usuários e grupos
precisarão receber permissões explicitamente para publicar e consumir conteúdo em novos
projetos.
Segurança de dados
O Tableau fornece várias maneiras de controlar quais usuários podem ver quais dados. Para
fontes de dados que se conectam a bancos de dados ativos, também é possível controlar se
os usuários serão solicitados a fornecer credenciais de banco de dados quando clicarem em
uma exibição publicada. As três opções a seguir trabalham juntas para atingir resultados
diferentes:
l
Conta de logon do banco de dados: Ao criar uma fonte de dados que se conecta a
um banco de dados dinâmico, você escolhe entre a autenticação no banco de dados por
meio do Windows NT ou por meio do mecanismo interno de segurança do banco de
dados.
l
l
Modo de autenticação: Ao publicar uma fonte de dados ou uma pasta de trabalho
com uma conexão de banco de dados ativa, você pode escolher um Modo de
autenticação. Os modos que serão disponibilizados dependem das escolhas feitas
acima.
Filtros de usuário: É possível definir filtros em uma pasta de trabalho ou fonte de
dados que controlam quais dados uma pessoa vê em uma exibição, com base na
respectiva conta de logon do Tableau Server.
A tabela abaixo descreve algumas dependências com as opções acima:
Opções de conexão de banco de
dados
A conta de
logon do
banco de
dados usa...
Segurança
integrada do
Windows NT
(Autenticação
do Windows)
Nome de
usuário e
senha
Perguntas sobre a segurança de dados
Modo de
autenticação
E possível
usar a
segurança
do banco
de dados
por
usuário
do
Tableau
Server?
Os filtros
de usuário
são a
única
maneira de
restringir
quais
dados
cada
usuário
vê?
Os caches da
Web são
compartilhados
entre
usuários?
Conta Run As do
servidor
Não
Sim
Sim
Representar por meio
da conta Run As do
servidor
Sim
Não*
Não
Avisar usuário: Os
visualizadores são
solicitados a fornecer
as credenciais do
banco de dados
quando clicam em
uma exibição. As
credenciais podem
ser salvas.
Sim
Não
Não
Credenciais inseridas:
O publicador da pasta
de trabalho ou fonte
Não
de dados pode inserir
as respectivas
credenciais de banco
Sim
Sim
Opções de conexão de banco de
dados
A conta de
logon do
banco de
dados usa...
Modo de
autenticação
Perguntas sobre a segurança de dados
E possível
usar a
segurança
do banco
de dados
por
usuário
do
Tableau
Server?
Os filtros
de usuário
são a
única
maneira de
restringir
quais
dados
cada
usuário
vê?
Os caches da
Web são
compartilhados
entre
usuários?
Sim
Não*
Não
de dados.
Representar por meio
da senha inserida: As
credenciais de banco
de dados com
permissão de
representação são
inseridas.
* Como podem ser criados resultados inesperados, o Tableau recomenda não usar esse
modo de autenticação com filtros de usuário.
Os filtros de usuário, a opção de credenciais inseridas e os modos de representação têm
efeitos semelhantes. Quando um usuário clica em uma exibição, não é solicitado que ele
forneça credenciais e ele vê apenas os dados que pertencem a ele. No entanto, os filtros de
usuário são aplicados na pasta de trabalho por editores, e os modos de autenticação de
representação dependem das políticas de segurança definidas pelos administradores no
próprio banco de dados.
Algumas das opções descritas acima exigem etapas de configuração que devem acontecer
durante a instalação do Tableau Server ou antes da publicação de uma pasta de trabalho ou
fonte de dados. Consulte os tópicos a seguir para obter mais informações:
l
Usuário Run As
l
Representação do SQL Server
l
Credenciais inseridas
l
Senhas salvas
Segurança de rede
Existem três interfaces de rede principais no Tableau Server:
l
l
l
Cliente para o Tableau Server:O cliente pode ser um navegador da Web, Tableau
Desktop ou o utilitário tabcmd.
Tableau Server para seu(s) banco(s) de dadosPara atualizar extrações de dados
ou manipular conexões de banco de dados ativas, o Tableau Server precisa se
comunicar com seus bancos de dados.
Comunicação de componente do servidor: Isso se aplica somente a implantações
distribuídas.
Cliente para o Tableau Server
O cliente do Tableau Server pode ser um navegador da Web, Tableau Desktop ou o utilitário
tabcmd. As comunicações entre o Tableau Server e seus clientes usam solicitações e
respostas HTTP padrão. O Tableau Server também pode ser configurado para HTTPS
(consulte SSL). Quando o Tableau Server é configurado para SSL, todo o conteúdo e as
comunicações entre clientes são criptografados e usam o protocolo HTTPS.
As senhas são comunicadas dos navegadores e do tabcmd para o Tableau Server usando
criptografia de chave pública/privada. O Tableau Server envia uma chave pública ao
navegador, que usa a chave para criptografar a senha para transmissão. Cada transmissão
criptografada usa uma chave uma vez antes de ela ser descartada. Isso significa que as
senhas são sempre protegidas, independentemente do uso do SSL.
Tableau Server para seu banco de dados
O Tableau Server faz conexões dinâmicas com bancos de dados para processar conjuntos de
resultados e atualizar extrações. Ele usa drivers nativos para se conectar a bancos de dados
sempre que possível e depende de um adaptador ODBC genérico quando drivers nativos
estiverem indisponíveis. Todas as comunicações com o banco de dados são roteadas por
meio desses drivers. Assim, configurar o driver para se comunicar em portas não padrão ou
fornecer criptografia de transporte faz parte da instalação do driver nativo. Esse tipo de
configuração é transparente para o Tableau.
Comunicação de componente do servidor
Existem dois aspectos para a comunicação entre os componentes do Tableau Server em uma
instalação de servidor distribuído: confiança e transmissão. Cada servidor em um cluster do
Tableau usa um modelo confiável rígido para garantir que ele receba solicitações válidas de
outros servidores no cluster. Computadores no cluster em que um processo de gateway está
em execução aceitam solicitações de terceiros (clientes), a menos que sejam antecedidos por
um balanceador de carga, que recebe as solicitações. Os servidores que não estejam
executando um processo de gateway só aceitam solicitações de outros membros confiáveis
do cluster. A confiança é estabelecida por uma lista de aprovações de endereço IP, porta e
protocolo. Se algum deles for inválido, a solicitação será ignorada. Todos os membros do
cluster podem se comunicar entre si. Com a exceção da validação de licença e acesso ao
repositório, a transmissão de toda a comunicação interna é executada via HTTP.
Quando as senhas são transmitidas dentro do cluster, a chave é usada para criptografar as
senhas transmitidas entre componentes do Tableau Server (por exemplo, entre os processos
do servidor de aplicativos e o servidor VizQL). Cada transmissão criptografada usa uma chave
uma vez antes de ela ser descartada.
Desempenho
Cada ambiente de servidor é exclusivo e há muitas variáveis que afetam o desempenho. As
variáveis incluem detalhes de hardware, como velocidade de disco, memória e núcleos; o
número de servidores na sua implantação; tráfego de rede; fatores de uso, como
complexidade da pasta de trabalho, atividade simultânea de usuário e armazenamento de
dados em cache; definições de configuração do Tableau Server, por exemplo, quantos de
cada processo de servidor você está executando; e considerações de dados, como volume de
dados, tipo de banco de dados e configuração de banco de dados. Devido a essa
complexidade, não há uma única fórmula para melhorar o desempenho do servidor, mas
algumas diretrizes básicas que podem ser seguidas. Use os tópicos abaixo para obter mais
informações:
Diretrizes gerais de desempenho
Hardware e software
Usar um sistema operacional de 64 bits e o produto de 64 bits: Embora o Tableau
Server seja executado tranquilamente em sistemas operacionais Microsoft de 32 bits, para
obter o melhor desempenho, escolha um sistema operacional de 64 bits e instale a versão 64
bits do Tableau Server.
Adicionar mais núcleos e memória: Independentemente de estar executando o Tableau
Server em um computador ou em vários, a regra geral é: quanto mais núcleos de CPU e mais
RAM, melhor desempenho você terá. Certifique-se de que você atendeu aos requisitos de
hardware e software recomendados do Tableau Server e veja Quando adicionar trabalhos e
reconfigurar para avaliar se é preciso adicionar mais computadores. Se estiver executando o
Tableau Server em um ambiente virtual, use as práticas recomendadas de sua VM para a
alocação vCPU em relação ao número de núcleos de CPU físicos no host da VM.
Configuração
Agende atualizações para horários fora de pico: as tarefas de backup tendem a atrasar
outras tarefas de segundo plano até o backup ser concluído. Use a exibição administrativa
Tarefas em segundo plano para ver suas agendas de tarefas de atualização e backup. Suas
tarefas de atualização devem ser agendadas para horários alternativos que não se
sobreponham à sua janela de backup.
Verificar o cache: O cache Tableau Server responde às solicitações de clientes
rapidamente, especialmente para exibições que se conectam aos bancos de dados ativos.
Verifique se Atualizar com menos frequência na guia Conexões de dados da caixa de
diálogo Configuração está selecionada.
Considere alterar as configurações de memória de duas sessões:
l
l
Tempo limite da sessão VizQL: O tempo limite padrão da sessão do VizQL é de 30
minutos. Mesmo se uma sessão VizQL estiver ociosa, ela ainda estará consumindo
memória e ciclos de CPU. Se você puder fazer isso com um limite inferior, use tabadmin
para alterar a configuração de vizqlserver.session.expiry.timeout .
Limpeza de sessão VizQL: Por padrão, as sessões VizQL são mantidas na memória
até mesmo quando o usuário navega afastado de uma exibição. Isso consome uma boa
parte da memória de sessão. Em vez disso, você pode finalizar as sessões quando os
usuários saem de uma exibição alterando o valor da configuração
vizqlserver.clear_session_on_unload para true (o padrão é false).
Avalie a configuração de seus processos: O Tableau Server é dividido em seis
componentes diferentes chamados processos de servidor. Embora a configuração padrão
tenha sido desenvolvida para trabalhar em uma ampla gama de cenários, você também pode
reconfigurá-la para atingir diferentes metas de desempenho. Mais especificamente, você pode
controlar em quais computadores os processos são executados e quantos são executados.
Consulte Aprimorar o desempenho do servidor para ver diretrizes para implantações de um,
dois e três nós.
Quando adicionar trabalhos e reconfigurar
O Tableau Server pode ser dimensionado horizontal e verticalmente, conforme o aumento dos
seus requisitos e necessidades. Veja algumas diretrizes que ajudam a perceber se é hora de
adicionar mais nós ao sistema, reconfigurar o servidor, ou ambos:
l
l
Mais de 100 usuários simultâneos: Se sua implantação tiver um grande número de
usuários (>100 visualizadores simultâneos), é importante ter processos VizQL
suficientes, mas nem tantos a ponto de exceder a capacidade do hardware para lidar
com eles. Além disso, habilitar a opção Conta de usuário convidado do Tableau Server
aumenta o número de possíveis visualizadores simultâneos para além da lista de
usuários que você acha que tem. A exibição administrativa Atividade do usuário pode
ajudar a fazer essa medição. Para obter dicas sobre como configurar ou dimensionar a
implantação, consulte Aprimorar o desempenho do servidor.
Uso intenso de extrações: As extrações podem consumir muitos recursos da
memória e da CPU. Não há uma medida que qualifique um site como grande
consumidor de extrações. Ter apenas algumas extrações extremamente grandes pode
colocar seu site nessa categoria, como se você tivesse muitas extrações pequenas. Os
sites com uso intenso de extrações se beneficiam do isolamento do processo do
mecanismo de dados em seu próprio computador. Consulte Aprimorar o desempenho
do servidor para ver as diretrizes.
l
l
l
Extrações atualizadas com frequência: Atualizar uma extração é uma tarefa que
consome muitos recursos da CPU. Os sites em que extrações são frequentemente
atualizadas (por exemplo, várias vezes ao dia) são geralmente ajudados pela maior
ênfase no processo em segundo plano, que lida com tarefas de atualização. Use a
Tarefas em segundo plano exibição administrativa para ver a taxa de atualização atual,
bem como Aprimorar o desempenho do servidor para obter detalhes sobre como fazer
o dimensionamento.
Solução de problemas de desempenho: Pode haver vários motivos para a lentidão
no carregamento de exibições ou o desempenho do servidor for geralmente lento.
Consulte Diretrizes gerais de desempenho, bem como Aprimorar o desempenho do
servidor.
Tempo de inatividade potencial: Se seu sistema de servidores for considerado
essencial e exigir um alto nível de disponibilidade, você poderá configurá-lo de forma
que haja redundância para os processos do servidor que identificam extrações, o
repositório e o gateway. Consulte Alta disponibilidade para obter detalhes.
Aprimorar o desempenho do servidor
Use os tópicos abaixo para saber como melhorar o desempenho das implantações que
consomem muitas extrações, ou com um grande número de usuários, ou ambos.
Qual é seu objetivo?
Quantos processos executar
Onde configurar processos
Otimização das extrações e pastas de trabalho
Avaliação da capacidade de resposta da exibição
Qual é seu objetivo?
Otimização de extrações
Exemplo de
um
computador:
Extrações
Exemplo de
dois
computadores:
Extrações
Exemplo de
dois
computadores:
Exibição
Exemplo de
três
computadores:
Extrações e
exibição
O processo do mecanismo de dados armazena extrações e responde às consultas; o
processo em segundo plano atualiza extrações. Como ambos exigem recursos de CPU, a
melhor abordagem para melhorar o desempenho de uma implantação com um uso intenso de
extrações é isolar esses dois processos um do outro, bem como de outros processos do
servidor. Isso pode exigir três máquinas. Se você não tiver três computadores com os quais
trabalhar, ainda há estratégias que podem ser usadas (consulte os exemplos de implantação
abaixo).
Otimização para usuários e exibição
O processo do VizQL Server lida com o carregamento e a renderização de exibições para os
usuários do Tableau Server. Se estiver tentando otimizar sua implantação para um número
alto de usuários e muitas interações de exibição, esse é o processo no qual se concentrar.
Quantos processos executar
Este tópico pressupõe que você esteja executando a versão de 64 bits do Tableau Server em
um sistema operacional de 64 bits. Nessa situação, duas instâncias de cada processo devem
atender às necessidades. Caso sua máquina atenda apenas ao requisito mínimo de RAM do
Tableau Server, que são 8 GB, seu limite deve ser uma instância de cada processo.
Processos em segundo plano
Um único processo em segundo plano pode consumir 100% de um único núcleo de CPU e, às
vezes, ainda mais para determinadas tarefas. Consequentemente, o número total de
instâncias que você deverá executar dependerá dos núcleos disponíveis no computador, bem
como do que você está tentando aprimorar. Os exemplos de implantação abaixo usam N para
representar o número total de núcleos da máquina e cada um sugere uma estratégia diferente
onde o processo em segundo plano está relacionado. Na dúvida, comece com o intervalo mais
baixo sugerido e avalie o desempenho antes de aumentar o número.
Processos do repositório e mecanismo de dados
Há cenários onde o processo de mecanismo de dados deve ser isolado em seu próprio nó –
como se você estivesse tentando melhorar uma implantação com alta utilização de extrações
e quisesse enfatizar a consulta mais do que as atualizações de extrações. Os exemplos de
implantação fornecem especificações. Como o mecanismo de dados armazena dados em
tempo real, transferi-lo é um procedimento de várias fases. Mover os processos de
mecanismo de dados e repositório descreve como fazer isso.
Outro motivo para isolar o mecanismo de dados (e/ou o repositório) é minimizar o potencial da
implantação para o tempo de inatividade. Consulte Alta disponibilidade para obter detalhes. A
menos que você esteja configurando para alta disponibilidade, geralmente, o repositório pode
permanecer no Tableau Server primário.
Onde configurar processos
Você configura o tipo e o número de processos em qualquer computador que esteja em
execução usando a caixa de diálogo Configuração do Tableau Server. Se estiver adicionando
novos computadores como parte da reconfiguração, eles já devem ter o software de trabalho
Tableau instalado. Consulte Instalar e configurar servidores de trabalho para ver as etapas.
Se estiver reconfigurando os processos em seu Tableau Server primário ou autônomo,
consulte Reconfigurar processos.
Otimização das extrações e pastas de trabalho
O desempenho rápido do servidor com extrações é, parcialmente, uma função das extrações
e pastas de trabalho em si. Os autores da pasta de trabalho podem ajudar a aumentar o
desempenho do servidor mantendo o conjunto de dados da extração reduzido, por meio da
filtragem ou agregação, e limitado, ocultando campos não utilizados. Use as opções do
Tableau Desktop Ocultar todos os campos não utilizados e Agregar dados para
dimensões visíveis para fazer isso. Para ver as etapas, consulte Criação de uma extração
(Ajuda do Tableau Desktop). Para obter dicas gerais sobre a criação de pastas de trabalho de
bom desempenho, procure por \"desempenho\" na ajuda do Tableau Desktop. Para ver o
desempenho das pastas de trabalho depois que elas são publicadas no Tableau Server, você
pode criar um registro de desempenho. Consulte Criar um registro de desempenho para obter
detalhes.
Avaliação da capacidade de resposta da exibição
Quando um usuário abre uma exibição, os componentes da exibição são primeiro
recuperados e interpretados e, em seguida, exibidos no navegador da web do usuário. Para a
maioria das exibições, a fase de renderização ocorre no navegador da web do usuário e, na
maior parte dos casos, isso gera os resultados mais rápidos e o mais alto nível de resposta
interativa. Lidar com a maioria das interações no navegador da web do cliente reduz a largura
de banda e elimina latências de solicitação de ida e volta. Se uma exibição for muito complexa,
o Tableau Server manipulará a fase de renderização no servidor, em vez de no navegador da
web do cliente, pois isso geralmente resulta no melhor desempenho. Se você achar que as
exibições não respondem conforme você gostaria, poderá testar e alterar o limite que faz com
que as exibições sejam renderizadas pelo servidor, em vez de no navegador da web do
cliente. Consulte Sobre a renderização do lado do cliente para obter mais informações.
Exemplo de um computador: Extrações
Uma instalação do Tableau Server 64 bits com uso intenso de extração pode ser executada
em uma única máquina de 64 bits configurada da seguinte forma:
A configuração acima deve ser parecida com a que se segue na página Manutenção do
Tableau Server:
Notas de configuração:
l
l
l
l
Execute 2 processos do VizQL Server.
Calcule o menor número dos processos em segundo plano a ser executado dividindo o
número total de núcleos do computador por 4. Para determinar o número máximo,
divida por 2.
Tanto os processos do mecanismo de dados, quanto do segundo plano consomem
muitos recursos de CPU e a configuração acima os equilibra.
Agendar as atualizações da extração para fora dos horários de pico ajuda os processos
de mecanismo de dados e em segundo plano a não competirem entre si pelos recursos
do sistema.
Exemplo de dois computadores: Extrações
Veja como você pode configurar uma implantação do Tableau Server com dois computadores
para que seja possível lidar com a utilização intensa de extrações. O mais importante a ser
notado neste exemplo é que o processo do mecanismo de dados é isolado dos processos em
segundo plano.
Com a configuração acima, a tabela Status na página Manutenção terá uma aparência
parecida com esta:
Notas de configuração:
l
l
l
Assim que você passa de uma implantação de um computador para dois computadores,
seu primeiro servidor torna-se o Tableau Server primário. Na tabela Status, ele obtém
um valor de Gateway.
Execute 2 processos do VizQL Server em cada máquina.
Para calcular o número mínimo dos processos em segundo plano a ser executado no
Tableau Server primário, divida o número total de núcleos do computador por 4. Para o
número máximo, divida por 2.
l
Mover o mecanismo de dados do Tableau Server primário para o computador de
trabalho é um procedimento de várias fases. Consulte Mover os processos de
mecanismo de dados e repositório para ver as etapas.
Exemplo de dois computadores: Exibição
Uma implantação de dois computadores com pouca utilização de extração e muita exibição
pode ser configurada da seguinte maneira:
A tabela Status para a configuração acima teria a uma aparência parecida com esta:
Notas de configuração:
l
l
Execute 2 processos do VizQL Server em cada máquina.
Um mínimo de 2 processos em segundo plano deve ser executado no Tableau Server
primário. O número máximo que você deve executar é igual ao número total de núcleos
do computador.
l
l
l
Em uma implantação onde as extrações são atualizadas raramente, o mecanismo de
dados e os processos em segundo plano podem estar no mesmo computador que os
outros processos.
Se os trabalhos de atualização de extrações forem executados somente fora do horário
de trabalho, muitos processos em segundo plano podem ser colocados em cada
computador para maximizar o paralelismo.
O número de máquinas no cluster é determinado exclusivamente pelo número total de
núcleos e pela memória principal disponível.
Exemplo de três computadores: Extrações e exibição
Uma configuração de três computadores será o número mínimo recomendado de
computadores para atingir o melhor desempenho se você tiver um volume alto de atualização
e utilização de extração, bem como um número alto de usuários simultâneos.
Veja a tabela Status para a configuração acima:
Notas de configuração:
l
l
l
l
l
Execute 2 processos do VizQL Server.
Os processos em segundo plano estão nas suas próprias máquinas, de modo que os
respectivos trabalhos não concorram com os de outros processos. Como o computador
é dedicado aos processos em segundo plano e eles podem consumir 100% dos
recursos da CPU, o intervalo mais baixo sugerido é igual ao número total de núcleos.
Dependendo do tamanho dos dados que estão sendo atualizados, é possível para
algumas implantações executar até duas vezes mais processos em segundo plano do
que os núcleos e ainda obter agilidade paralela.
Como o processo do mecanismo de dados pode consumir todos os recursos da CPU
em um computador, ele é isolado em seu próprio computador.
As cargas do usuário para processos do servidor de aplicativos e servidor de dados
geralmente podem ser manipuladas por 1 processo cada, mas podem ser definidas
para 2, de modo a fornecer redundância.
Sob a maioria das condições, o Tableau Server primário e o mecanismo de dados não
serão um afunilamento para a taxa de transferência geral do sistema, desde que
existam ciclos de CPU suficientes para eles. Para aumentar a capacidade de exibição,
adicione computadores dedicados ao processo do VizQL Server. Para aumentar a
capacidade de atualização de extrações, adicione computadores dedicados ao
processo em segundo plano.
Sobre a renderização do lado do cliente
Antes de as marcas e os dados de uma exibição serem mostrados em um navegador da web
do cliente, eles são recuperados, interpretados e renderizados. O Tableau Server pode
executar esse processo no navegador da web do cliente ou no servidor. A renderização no
lado do cliente é o modo padrão, pois a manipulação da renderização e de toda a interação no
servidor pode resultar na transferência de mais dados de rede e em atrasos de ida e volta.
Com a renderização no lado do cliente, a maior parte das interações de exibição são mais
rápidas, pois elas são interpretadas e renderizadas diretamente no cliente.
Algumas exibições, no entanto, são renderizadas com mais eficiência no servidor, onde há
mais poder de computação. A renderização no lado do servidor faz sentido para uma exibição
que é mais complexa na medida em que os arquivos de imagem ocupam largura de banda
significativamente menor do que os dados usados para criar as imagens. Além disso, como os
tablets normalmente têm um desempenho inferior ao dos computadores, eles podem lidar
com menos complexidade de exibição. Há casos em que uma exibição aberta no navegador
da web de um computador pode ser renderizada pelo cliente, mas a mesma exibição aberta
no navegador de um tablet é renderizada pelo servidor.
O Tableau Server é configurado para manipular automaticamente todas essas situações
usando um O cálculo do limite como gatilho para renderizar uma exibição no servidor, em vez
de no navegador da web. Como administrador, você pode testar ou fazer o ajuste fino dessa
configuração para PCs e tablets. Consulte os tópicos abaixo para obter mais informações.
Requisitos
l
l
Supported browsers: A renderização no lado do cliente é compatível com o Internet
Explorer versão 9.0 ou posterior, o Firefox, o Chrome e o Safari. Todos esses
navegadores da web incluem o elemento HTML 5 <canvas>, que é usado pela
renderização no lado do cliente.
Polígonos, formas personalizadas e o recurso Histórico de página: Se uma
exibição usar polígonos, formas personalizadas ou o recurso de histórico de página,
será realizada a renderização no lado do servidor, mesmo que a renderização no lado
do cliente esteja habilitada de outra forma.
O cálculo do limite
Quando a renderização no lado do cliente está habilitada, o Tableau Server usa um cálculo
para determinar a complexidade da exibição. Se o valor de complexidade exceder 100 (para
navegadores de computadores) ou 20 (para navegadores de tablets), a exibição será
renderizada no servidor em vez de no navegador da web. Aqui está o cálculo:
(# of marks) + 3(# of headers) + 3(# of annotations) + 3(# of
reference lines) = view complexity
Por exemplo, se você tiver uma exibição com 2.000 marcas, 150 cabeçalhos (às vezes é
possível determinar isso adicionando o número de linhas e colunas em uma exibição), 1
anotação e 1 linha de referência, sua equação será:
2,000 + 3(150) + 3(1) + 3(1) = 2,456
Agora pegue o valor de limite e divida-o por 100; em seguida, multiplique-o por 5.000 (dividir o
limite por 100 é uma normalização, e multiplicar por 5.000 é o fator de dimensionamento do
Tableau). Presumindo-se um valor de limite atual de 100, a equação seria a seguinte:
100/100 * 5,000 = 5,000
Compare as duas somas. Sabendo que 5.000 representa uma complexidade de 100, você
pode ver que 2.456 representa cerca da metade da complexidade (49). Portanto, para forçar a
renderização no lado do servidor para essa exibição em particular em um navegador de
computador, você precisaria definir esse limite como 48. Lembre-se de que as interações,
como a filtragem, podem alterar a complexidade da exibição, e uma sessão pode alternar
modos de renderização sempre que a complexidade muda.
Consulte os tópicos abaixo para obter detalhes sobre como testar e configurar a renderização
no lado do cliente:
Testar com o parâmetro de URL
O Tableau Server é configurado para realizar a renderização no lado do cliente por padrão,
desde que os requisitos sejam atendidos. Para testar a renderização no lado do servidor com
base na sessão, digite ?:render=false no final da URL da exibição. Por exemplo:
http://localhost/views/Supplies/MyView?:render=false
Se a renderização no lado do cliente for desabilitada no Tableau Server, insira
?:render=true para habilitá-la para a sessão.
http://localhost/views/Supplies/MyView?:render=true
Você também pode testar limites de complexidade em particular em exibições individuais para
ver se é apropriado ajustar o limite em todo o servidor para suas condições de servidor e rede.
Por exemplo, você poderá achar que os pontos decisivos de complexidade mais baixa (como
80) ou mais alta (como 120) resultam em mais capacidade de resposta às interações do
usuário. Para testar um limite, você pode manter a configuração padrão do servidor (habilitada
para renderização no lado do cliente) e inserir o número do limite de teste ao final da URL da
exibição. Por exemplo:
http://localhost/views/Supplies/MyView?:render=80
Configurar com as opções tabadmin set
É possível usar as opções tabadmin vizqlserver.browser.render para desabilitar ou
habilitar a renderização no lado do cliente, e vizqlserver.browser.render_
threshold e vizqlserver.browser.render_threshold_mobile para alterar os
limites dessa renderização. Consulte Opções tabadmin set para obter detalhes.
Os processos do Tableau Server
Existem seis processos do Tableau Server cuja configuração padrão você pode alterar para
atingir diferentes resultados. Os tópicos Aprimorar o desempenho do servidor e Alta
disponibilidade descrevem algumas das abordagens que podem ser adotadas. O status de
nível alto para cada processo é exibido na página Manutenção do servidor e informações mais
detalhadas relacionadas a alguns dos processos (como processo em segundo plano) estão
em Exibições administrativas. Em termos de arquitetura, a versão 64 bits do Tableau Server
usa processos nativos 64 bits; a versão 32 bits do Tableau Server usa processos 32 bits. A
exceção é o processador de dados. Caso a versão 32 bits do Tableau Server esteja instalada
em um sistema operacional de 64 bits, a versão 64 bits do processador de dados é usada.
Nome do
arquivo
servidor de wgserver.exe
aplicativos
Processo
MultiCaracterísticas de
thread? desempenho
Lida com o
Sim
Consome apenas
aplicativo Web,
recursos perceptíveis
oferece suporte à
durante operações
navegação e
raras, como publicação
pesquisa
Finalidade
MultiCaracterísticas de
thread? desempenho
de uma pasta de
trabalho com uma
extração ou geração de
uma imagem estática
para uma exibição. Sua
carga pode ser criada
pela interação baseada
em navegador e por
tabcmd.
segundo
backgrounder.exe Executa tarefas Não
Um processo de um
plano
de servidor,
único encadeamento
incluindo
onde vários processos
atualizações de
podem ser executados
extrações, tarefas
em qualquer
\"Executar agora\"
computador ou em todos
e tarefas iniciadas
eles no cluster para
em tabcmd.
expandir a capacidade.
Geralmente, o
processador em
segundo plano não
consome muita memória
para processo, mas
pode consumir recursos
de CPU, E/S ou rede, de
acordo com a natureza
da carga de trabalho
apresentada a ele. Por
exemplo, a execução de
grandes atualizações de
extrações pode usar
largura de banda da
rede para recuperação
de dados. Os recursos
de CPU podem ser
consumidos pela
recuperação de dados
ou tarefas tabcmd
complexas.
mecanismo tdeserver64.exe Armazena
Sim
A carga de trabalho do
de dados
extrações
de
mecanismo de dados é
tdeserver.exe
dados e responde
gerada pelas
às consultas
Processo
Nome do
arquivo
Finalidade
Processo
Nome do
arquivo
servidor de dataserver.exe
dados
MultiCaracterísticas de
thread? desempenho
solicitações do processo
do VizQL Server. Ela é o
componente que
carrega extrações na
memória e executa
consultas nela.
Basicamente, o
consumo de memória é
baseado no tamanho
das extrações de dados
que estão sendo
carregadas. O binário de
64 bits é usado como o
padrão em sistemas
operacionais de 64 bits,
mesmo que o Tableau
Server 32 bits esteja
instalado. O mecanismo
de dados é
multissegmentado para
lidar com várias
solicitações ao mesmo
tempo. Sob carga alta,
ele pode consumir
recursos de CPU, E/S e
rede, os quais podem
ser um afunilamento de
desempenho sob carga.
Na carga alta, uma única
instância do mecanismo
de dados pode consumir
todos os recursos de
CPU para processar as
solicitações.
Manipula
Sim
Como é um proxy,
conexões com as
normalmente é
fontes de dados
associado somente pela
do Tableau
rede, mas pode ser
Server
associado pela CPU
com sessões de usuário
simultâneo suficientes.
Sua carga é gerada pela
Finalidade
Processo
Nome do
arquivo
repositório
postgres.exe
VizQL
Server
vizqlserver.exe
MultiCaracterísticas de
thread? desempenho
interação baseada no
navegador e no Tableau
Desktop, bem como
pelos trabalhos de
atualização de extrações
para fontes de dados do
Tableau Server.
O banco de dados Geralmente, consome
do Tableau
poucos recursos. Pode
Server
se tornar um
armazenada
afunilamento em casos
metadados da
raros de implantações
pasta de trabalho
muito grandes (milhares
e do usuário
de usuários) enquanto
executa operações
como exibição de todas
as pastas de trabalho
pelo usuário ou
alteração de
permissões.
Carrega e
Sim
Consome recursos
renderiza
perceptíveis durante o
exibições, calcula
carregamento da
e executa
exibição e uso interativo
consultas
de um navegador da
Web. Pode ser
associado por CPU, E/S
ou rede. A carga pode
ser criada apenas pela
interação baseada em
navegador. Pode
esgotar a memória do
processo.
Finalidade
Criar um registro de desempenho
Com o recurso Registro de Desempenho no Tableau, é possível registrar informações de
desempenho sobre eventos importantes à medida que você interage com pastas de trabalho.
Em seguida, você exibe métricas de desempenho em uma pasta de trabalho de desempenho
que o Tableau cria automaticamente. As etapas seguidas para criar e exibir o registro de
desempenho variam um pouco entre o Tableau Desktop e o Tableau Server. Entretanto, as
pastas de trabalho de desempenho resultantes têm o mesmo formato no Tableau Desktop e
no Tableau Server.
Use as pastas de trabalho de desempenho para analisar e solucionar problemas de
desempenho relacionados a diferentes eventos que são conhecidos por afetar o desempenho,
incluindo:
l
l
l
l
l
l
l
Execução de consultas
Codificação geográfica
Conexões com fonte de dados
Cálculos de layout
Geração de extrações
Combinação de dados
Renderização do servidor (somente o Tableau Server)
O suporte do Tableau poderá solicitar que você crie pastas de trabalho de desempenho
durante o diagnóstico de problemas de desempenho.
Para criar um registro de desempenho no Tableau Server
A habilitação do registro de desempenho no nível de site é determinada pelo administrador do
servidor. Por padrão, o registro de desempenho não é habilitado no site padrão ou em
qualquer site que você crie. Para habilitar o registro de desempenho em um site, acompanhe
estes níveis:
1. Escolha o botão Admin no Tableau Server.
2. Escolha Site.
3. Selecione um site.
4. Escolha Editar.
5. Na caixa de diálogo Editar site, selecione Permitir registro de desempenho.
6. Escolha OK.
Você inicia o registro de desempenho para uma exibição específica adicionando ?:record_
performance=yes à URL. Por exemplo:
http://localhost/views/Variety/BaseballStatistics?:record_performance=yes
A confirmação visual de que o registro foi iniciado é um comando Mostrar registro de
desempenho na barra de ferramentas.
Escolha Mostrar registro de desempenho para abrir uma pasta de trabalho de
desempenho, que é um instantâneo atualizado de dados de desempenho. Você pode
continuar a tirar instantâneos adicionais enquanto trabalha com a exibição; os dados de
desempenho são cumulativos. Se você sair da página, ou remover ?:record_
performance=yes da URL, o registro parará.
Interpretar um registro de desempenho
Uma pasta de trabalho de registro de desempenho é um painel do Tableau que contém três
exibições. Linha do tempo, Eventos e Consulta.
Para obter informações sobre como criar um registro de desempenho no Tableau Server,
consulte Criar um registro de desempenho.
Linha do tempo
A exibição na parte superior de um painel de registro de desempenho mostra os eventos que
ocorreram durante o registro, organizados cronologicamente da esquerda para a direita. O
eixo inferior mostra o tempo decorrido desde que o registro começou.
Na exibição Linha do tempo, as colunas Pasta de trabalho, Painel e Planilha identificam o
contexto dos eventos. A coluna Evento identifica a natureza do evento, e a coluna final mostra
a duração de cada evento e como ele se compara cronologicamente a outros eventos
registrados:
Eventos
A exibição intermediária em uma pasta de trabalho de registro de desempenho mostra os
eventos, classificados por duração (da maior para a menor). Isso pode ajudar a identificar
onde procurar primeiro, caso você queira acelerar sua pasta de trabalho.
Cores diferentes indicam tipos de eventos diferentes. A variedade de eventos que podem ser
registrados é:
l
Cálculo de layouts.
Se os layouts estiverem muito demorados, considere simplificar sua pasta de trabalho.
l
Conexão à fonte de dados.
As conexões lentas podem ser devido a problemas de rede ou do servidor de banco de
dados.
l
Execução de consulta.
Se as consultas estiverem muito demoradas, consulte a documentação do servidor de
banco de dados.
l
Geração de extração.
Para acelerar a geração de extração, considere importar apenas alguns dados da fonte
de dados original. Por exemplo, você pode filtrar por campos de dados específicos, ou
criar uma amostra baseada em um número específico de linhas ou uma porcentagem
dos dados.
l
Codificação geográfica.
Para acelerar o desempenho da codificação geográfica, experimente usar menos
dados ou filtrar os dados.
l
Combinação de dados.
Para acelerar a combinação de dados, experimente usar menos dados ou filtrar os
dados.
l
Renderização do servidor.
Você pode acelerar a renderização do servidor executando processos adicionais do
VizQL Server em outros computadores.
Consulta
Se você clicar em um evento Executando consulta na seção Linha do tempo ou Eventos
de um painel de registro de desempenho, o texto dessa consulta será exibido na seção
Consulta. Por exemplo:
Às vezes, a consulta será truncada e você precisará consultar o log do Tableau para encontrar
a consulta completa. A maioria dos servidores de banco de dados podem aconselhar você
sobre como otimizar uma consulta adicionando índices ou outras técnicas. Consulte a
documentação do servidor de banco de dados para obter detalhes.
Inserir exibições
Você pode inserir exibições do Tableau Server em páginas da Web, blogs, wikis, aplicativos
Web e portais da intranet. As exibições inseridas mesclam-se perfeitamente às páginas da
Web e são interativas. As exibições são atualizadas à medida que os dados subjacentes
mudam ou que as pastas de trabalho são atualizadas no servidor. As exibições inseridas
seguem as mesmas restrições de permissão e licenciamento usadas no servidor.Em geral, as
pessoas que carregam uma página da Web com uma exibição inserida também têm uma
conta no Tableau Server. Caso tenha uma licença com base em núcleo, você pode selecionar
Habilitar convidado, que permite que os usuários carreguem a exibição sem entrar. Existem
três maneiras de inserir exibições:
l
l
l
Use o código inserido Compartilhar como está: O link Compartilhar no canto
superior esquerdo de cada exibição fornece o código inserido gerado automaticamente.
Tudo o que você precisa fazer é copiar o código e colá-lo na sua página da Web.
Escreva seu próprio código inserido: Você pode aprimorar o código inserido
padrão que o Tableau fornece ou pode criar seu próprio código. De qualquer maneira,
você pode adicionar parâmetros que controlam a barra de ferramentas, guias e muito
mais.
Use a API do Tableau JavaScript: Você pode usar objetos do Tableau JavaScript em
seu próprio código do aplicativo Web. Consulte JavaScript API para obter detalhes.
Para que os usuários consigam autenticar quando clicam em uma exibição inserida,
seus navegadores devem estar configurados para permitir cookies de terceiros.
Consulte os tópicos a seguir para obter detalhes sobre a inserção de exibições:
Como escrever código inserido
Se estiver escrevendo seu próprio código inserido, você pode adotar uma das duas
abordagens.
l
l
Usar o Tableau JavaScript: essa é a abordagem preferida. Basta usar o código
inserido Compartilhar como o ponto de partida para seu próprio código, adicionando ou
editando parâmetros de objeto que controlam a barra de ferramentas, guias, entre
outros. Basta usar o código inserido Compartilhar como o ponto de partida para seu
próprio código, adicionando ou editando parâmetros de objeto que controlam a barra de
ferramentas, guias, entre outros. O código inserido padrão, que depende de um arquivo
do Tableau JavaScript, também é o único meio de controlar a ordem de carregamento
de várias exibições inseridas.
Especifique a URL da exibição: Assim como nas versões anteriores do Tableau,
você pode inserir uma exibição usando uma marca Iframe ou Image, onde a fonte é a
URL bruta da exibição. Talvez seja conveniente fazer isso se não for possível usar o
JavaScript no seu site. Talvez também haja situações em que tudo o que você pode
fazer é especificar uma URL, como se você tivesse inserindo uma exibição usando Web
Part do Visualizador de Páginas do SharePoint.
Independentemente da abordagem adotada, é preciso definir a largura e a altura se estiver
inserindo uma exibição.
Tableau JavaScript
Veja um exemplo do código inserido que você obtém por padrão quando clica em
Compartilhar:
<script type="text/javascript"
src="http://myserver/javascripts/api/viz_v1.js"></script>
<div class="tableauPlaceholder" style="width:800; height:600;">
<object class="tableauViz" width="800" height="600"
style="display:none;">
<param name="host_url" value="http://myserver/" />
<param name="site_root" value="/t/Sales" />
<param name="name"
value="MyCoSales/SalesScoreCard/[email protected]/EastCoastSales"
/>
<param name="tabs" value="yes" />
<param name="toolbar" value="yes" /></object></div>
A origem da marca <script> é a URL do arquivo Tableau Server JavaScript, viz_v1.js. O
arquivo JavaScript trata da montagem da URL completa da exibição que é mostrada aos
usuários. Os parâmetros de objeto name e site_root são os únicos parâmetros exigidos;
todos os outros parâmetros são opcionais. Por obter exemplos, consulte a Lista de parâmetros
inseridos e os "Exemplos de marca de script" na seção Exemplos.
Exibir URL como a origem
Veja um exemplo de inserção da mesma exibição usando um IFrame, onde a origem é a URL
para a exibição:
<iframe
src="http://myserver/t/Sales/MyCoSales/SalesScoreCard?:embed=yes&:tabs=yes&:toolbar=yes" width="800" height="600"></iframe>
Especifique o parâmetro de URL embed e, se desejar, inclua parâmetros que controlam as
opções de barra de ferramentas e reversão, entre outros. Também é possível adicionar filtros
à URL que controla os dados específicos que mostram quando uma exibição é carregada.
Para obter exemplos, consulte Lista de parâmetros inseridos e os "Exemplos de marca Iframe"
na seção Exemplos.
Lista de parâmetros inseridos
Você pode inserir uma exibição usando uma marca Iframe, que usa parâmetros de URL, ou
uma marca JavaScript, que usa parâmetros de objeto. A tabela a seguir lista os conjuntos de
parâmetros e como usá-los:
Parâmetr- ParâmeValoo de
tro de
Descrição
res
objeto
URL
Oculta a
opção
“Lembrar
minhas
alterações”.
<param name="customViews"
value="no"/>
http://tabserver/views/DateTime/DateCalcs?:embed=yes&:customViews=no
yes
Obrigatório
para o
parâmetro
de URL.
Oculta a
área de
navegação
superior,
mesclando
a exibição
com a
página da
Web.
http://tabserver/views/DateTime/DateCalcs?:embed=yes
string
Personaliza o que é
exibido
quando a
exibição é
aberta. A
filtragem
por
parâmetros
de URL
<param name="filter"
também é
value="Team=Blue"/>
possível.
Consulte
os
exemplos
de marcas
Iframe em
Adicionar
filtros e
Filtrar por
vários
campos.
customV- :custono
iews
mViews
-
filter
:embed
-
Exemplos
Parâmetr- ParâmeValoo de
tro de
Descrição
res
objeto
URL
Exemplos
-
Mostra
uma
exibição
:forma- pdf;
como um
t
png
arquivo
PDF ou
.png.
-
Renderiza
uma
exibição
usando
DPI (dots
per inch,
:highd- fals- pontos por http://tableauserver/views/Salespi
e
/Q2?:highdpi=false
polegada)
padrão
para
monitores e
dispositivos
de alta
resolução.
host_
url
-
string
linktar- :linktstring
get
arget
loadorder
-
http://tabserver/views/Sales/Q2?:format=pdf
O nome do
servidor
conforme
ele aparece
na URL.
<param name="host_url"
value="http://myserver.bigco.com/">
O nome da
janela de
destino
para
hiperlinks
externos.
<param name="linktarget"
value="_blank"/>
<param name="host_url"
value="http://localhost/">
http://tabserver/views/DateTime/DateCalcs?:embed=yes&:linktarget=_blank
Quando
várias
exibições
<param name="load-order"
numb- forem
er
inseridas, a value="2"/>
ordem de
carregame-
Parâmetr- ParâmeValoo de
tro de
Descrição
res
objeto
URL
Exemplos
nto padrão
será a
ordem na
qual as
exibições
foram
listadas.
Use essa
configuração para
substituir
essa
ordem.
Números
negativos
são
permitidos.
name
path
-
-
string
Exigido
para
parâmetro
de objeto.
O nome da
pasta de
trabalho e
da folha e,
se desejar,
uma
exibição
personalizada
(username@domain/
[nome da
exibição
personalizada]).
string
Somente
<param name="path"
para
value="trusted/Etdpsm_Ew6rJYautenticaçã9kRrALjauU/views/workbookQ4/Saleo confiável;
sQ4"/>
<param name="name"
value="MyCoSales/Sales"/>
<param name="name"
value="MyCoSales/Sales/[email protected]/EastCoastSales"/>
Parâmetr- ParâmeValoo de
tro de
Descrição
res
objeto
URL
Exemplos
não pode
ser usado
com o
parâmetro
“ticket”.
Substitui o
valor do
parâmetro
“name” e é
usado
como a
URL.
Consulte
os
exemplos
de
autenticação confiável.
http://tableauserver/trusted/Etdpsm_Ew6rJY9kRrALjauU/views/workbookQ4/SalesQ4?:embed=yes&:tabs=yes
-
:refresh
Renderiza
a página
novamente. Consulte
Atualizar
dados para
obter
detalhes.
http://tabserver/views/DateTime/DateCalcs?:embed=yes&:refresh
-
all;
filters;
sort:revers;
t
axes;
shelves
Retorna o
item para
seu estado
original.
http://tabserver/views/DateTime/DateCalcs?:embed=yes&:revert=all
site_
root
-
string
Obrigatório. O nome
do site. O
valor do
<param name="site_root"
value="/t/Sales"/>
<param name="site_root"
value=""/>
Parâmetr- ParâmeValoo de
tro de
Descrição
res
objeto
URL
Exemplos
site padrão
é nulo
(
value=""
). Se seu
servidor
tiver vários
sites e você
desejar
usar a
autenticação, consulte
os
exemplos
de
Autenticação
Confiável.
tabs
ticket
:tabs
-
Exibe ou
yes;
oculta as
no
guias.
Somente
para
autenticação confiável;
não pode
ser usado
com o
parâmetro
de objeto
numb- “path”.
er
Deve ser
usado com
o objeto
“name”
para
construir a
URL de
resgate de
ticket
<param name="tabs" value="yes"/>
<param name="ticket"
value="Etdpsm_Ew6rJY9kRrALjauU"/>
http://tableauserver/trusted/Etdpsm_Ew6rJY9kRrALjauU/views/workbookQ4/SalesQ4?:embed=yes&:tabs=yes
Parâmetr- ParâmeValoo de
tro de
Descrição
res
objeto
URL
Exemplos
confiável.
Consulte
os
exemplos
de
autenticação confiável.
A barra de
ferramentas é exibida
por padrão
na parte
inferior
quando
esse
parâmetro
não está
definido.
Quando
yes;
:toolbno, a barra
toolbar
no;
ar
de
top
ferramentas é excluída
da exibição
inserida.
Quando
top, a
barra de
ferramentasé
colocada
acima da
exibição.
<param name="toolbar"
value="top"/>
http://tabserver/views/DateTime/DateCalcs?:embed=yes&:toolbar=no
Exemplos
Veja alguns exemplos de como é possível personalizar ou trabalhar com seu código inserido:
Adicionar filtros
Você pode passar valores de filtro para que a exibição abra mostrando apenas os dados
desejados. Por exemplo, talvez seja conveniente incluir um hiperlink de outra parte da sua
aplicação Web em uma exibição inserida de desempenho de vendas que mostra somente
uma região específica.
Exemplo de marca de script
<script type="text/javascript"
src="http://myserver/javascripts/api/viz_v1.js">
</script>
<object class="tableauViz" width="800" height="600"
style="display:none;">
<param name="host_url" value="http://myserver/" />
<param name="site_root" value="" />
<param name="name" value="Sales/Sales-Performance" />
<param name="filter" value="Region=East" />
</object>
Para passar por vários filtros, basta separar cada valor com uma vírgula. Por exemplo:
<param name="filter" value="Region=East,West" />
Exemplos de marca Iframe
<iframe
src="http://myserver/views/CalculatedFields?:embed=yes&Region=East"width="800" height="600"></iframe>
<iframe src="http://myserver/views/Sales/SalesPerformance?:embed=yes&Region=East,West" width="900px"
height="700px"></iframe>
Filtrar por vários campos
É possível passar filtros por quantos campos você desejar, incluindo campos que não estão na
exibição original.
Exemplo de marca de script
<script type="text/javascript"
src="http://myserver/javascripts/api/viz_v1.js">
</script>
<object class="tableauViz" width="800" height="600"
style="display:none;">
<param name="host_url" value="http://myserver/" />
<param name="site_root" value="" />
<param name="name" value="Sales/Sales-Performance" />
<param name="filter" value="Region=East,West&Customer
Segment=Consumer,HomeOffice" />
</object>
Exemplo de marca Iframe
<iframe
src="http://myserver/views/CalculatedFields?:embed=yes&Region=East,West&Customer Segment=Consumer,Home Office" width="800"
height="600"></iframe>
Se um valor de filtro contiver um caractere especial, como uma vírgula, substitua o
caractere pela sequência de codificação de URL para \ (barra invertida, %5c) seguido
pela sequência de codificação de URL do caractere especial. A barra invertida é
necessária para o escape do caractere especial. Por exemplo, a sequência de
codificação de URL para \, (barra invertida, vírgula) é %5c%2c.
Filtrar datas e horas
Se você deseja filtrar por um campo de Data/hora, inclua o valor usando o formato padrão do
Tableau mostrado abaixo:
yyyy-mm-dd hh:mm:ss
A parte da hora usa um relógio de 24 horas. Muitos bancos de dados armazenam todos os
valores de data como campos Datetime, de modo que talvez seja preciso passar um valor de
hora juntamente com a data.
Exemplo de marca de script
<script type="text/javascript"
src="http://myserver/javascripts/api/viz_v1.js"></script>
<object class="tableauViz" width="800" height="600"
style="display:none;">
<param name="host_url" value="http://myserver/" />
<param name="site_root" value="" />
<param name="name" value="Sales/Sales-Performance" />
<param name="filter" value="Date=2012-12-01" />
</object>
Esse exemplo filtra por um campo de data e por um campo datetime:
<param name="filter" value="2012-12-01%2022:18:00" />
Exemplo de marca Iframe
<iframe src="http://myserver/Sales/SalesPerformance?:embed=yes&Date=2008-12-01%2022:18:00" width="800"
height="600"></iframe>
Para filtrar várias datas, separe cada data com uma vírgula.
Filtrar medidas
É possível filtrar medidas incluindo um ou mais valores. Não há suporte para maior que, menor
que ou intervalos. O exemplo abaixo filtra para mostrar somente vendas de US$ 100 e US$
200.
Exemplo de marca de script
<script type="text/javascript"
src="http://myserver/javascripts/api/viz_v1.js">
</script>
<object class="tableauViz" width="800" height="600
"style="display:none;">
<param name="host_url" value="http://myserver/" />
<param name="site_root" value="" />
<param name="name" value="Sales/Sales-Performance" />
<param name="filter" value="Profit=100, 200" />
</object>
Exemplo de marca Iframe
<iframe src="http://myserver/Sales/SalesPerformance?:embed=yes&Profit=100,200" width="800"
height="600"></iframe>
Controlar o pedido de carregamento de várias exibições
Você pode controlar a ordem em que várias exibições são carregadas para que as pessoas
trabalhem com suas exibições. Esse recurso pode ser acessado apenas usando o código
inserido que depende do arquivo do Tableau JavaScript.
No exemplo a seguir, duas exibições são inseridas. A segunda exibição é carregada primeiro,
seguida pela primeira. Se você inseriu várias exibições e fornecer a elas o mesmo valor de
ordem de carregamento ou se não especificar os parâmetros de ordem de carregamento, elas
serão carregadas na ordem em que aparecem na página.
Exemplo de marca de script
<script type="text/javascript"
src="http://myserver/javascripts/api/viz_v1.js">
</script>
<object class="tableauViz" width="600" height="400"
style="display:none;">
<param name="host_url" value="http://myserver/" />
<param name="site_root" value="" />
<param name ="name" value="MyCoSales/TopPerformers" />
<param name="tabs" value="yes" />
<param name="toolbar" value="yes" />
<param name="filter" value="Salesperson=Top 5" />
<param name="load-order" value="0" />
</object>
<script type="text/javascript"
src="http://myserver/javascripts/api/viz_v1.js">
</script>
<object class="tableauViz" width="600" height="400"
style="display:none;">
<param name="host_url" value="http://myserver/" />
<param name="site_root" value="" />
<param
<param
<param
<param
</object>
name="name" value="MyCoSales/SalesScoreCard" />
name="tabs" value="yes" />
name="toolbar" value="yes" />
name="load-order" value="-1" />
Inserir exibições no SharePoint (Microsoft SSPI)
Você pode inserir uma exibição do Tableau Server em uma página do SharePoint. Para
autenticar os usuários do Tableau Server que acessam a exibição inserida, você tem duas
opções, que dependem do método de autenticação do usuário selecionado durante a
configuração do Tableau Server. Você pode usar Active Directory com Habilitar logon
automático para autenticar usuários do Tableau Server (também conhecidos por usarem o
Microsoft SSPI) ou pode usar a Autenticação local — e também configurar o Tableau
Server para autenticação confiável.
Este tópico se aplica à primeira opção, onde o Tableau Server e o SharePoint estão usando o
Microsoft SSPI. Se o Tableau Server estiver usando a Autenticação local, consulte as
etapas em Inserir exibições no SharePoint (autenticação local).
Siga as etapas abaixo para usar a Web Part Visualizador de Páginas do SharePoint inserida
em uma exibição em uma página do SharePoint.
1. Navegue até a página do SharePoint em que você deseja inserir uma exibição (o tipo da
página deve ser Página de Web Part).
2. No menu Ações do site, no canto superior esquerdo da página, selecione Editar
página.
3. Clique em Adicionar uma Web Part na seção da página onde você deseja inserir a
exibição.
4. Em Categorias, selecione TableauEmbeddedView, localizado na pasta Diversos ou
Personalizado, e clique em Adicionar.
5. De volta na página do SharePoint, selecione Editar Web Part no menu Editar da nova
web part.
6. No lado direito da página, é possível especificar os atributos da Web part da exibição de
página. Digite a URL para a exibição que deseja inserir. Use o formato especificado em
Inserir exibições. Por exemplo, você pode digitar:
http://tableauserver/views/DateTime/DateCalcs?:embed=yes&:toolbar=no
7. Na seção Aparência, você pode especificar o Título da web part, a Altura e a Largura.
Em geral, você deve especificar uma altura fixa (por exemplo, 700 pixels) e ajustar a
largura para se adequar à zona.
8. Clique em OK para aplicar as alterações e sair do modo de edição.
A exibição será inserida na web part que acabou de ser criada. Os usuários não
precisarão fazer logon no Tableau Server para ver a exibição inserida, em vez disso,
serão automaticamente autenticados usando o Microsoft SSPI.
Inserir exibições em wikis
Você pode inserir facilmente uma exibição em um wiki ou em outra página da Web, bastando
colocar a exibição dentro de uma marca <iframe>.
1. Navegue até a página wiki na qual deseja inserir uma exibição.
2. Edite a página e adicione um <iframe> onde a origem é a URL para a exibição. Por
exemplo:
<iframe src="http://tableauserver/views/DateTime/DateCalcs?:embed=yes&:toolbar=no" width="800"
height="600"></iframe>
3. Salve as alterações.
A exibição é inserida na página wiki.
Se o Tableau Server e o wiki forem configurados para usar o Microsoft SSPI, os
usuários que acessam uma exibição inserida no wiki entrarão automaticamente para
que possam ver a exibição.
Se o servidor e o wiki não estiverem usando o mesmo método para autenticação,
primeiro, os usuários serão solicitados a entrar no servidor para que possam ver a
exibição.
Inserir imagens
Além de inserir uma exibição em um <script> ou em uma marca <iframe>, você também
pode inserir a exibição como uma imagem. Quando você insere uma imagem, a exibição não é
interativa; no entanto, ela á atualizada toda vez que a página é completamente recarregada.
Dessa forma, a imagem mostra os dados mais recentes, mesmo se os dados subjacentes
forem alterados.
1. Navegue até a página em que você deseja inserir a imagem.
2. Edite a página e adicione uma marca <img> onde a origem é a URL para a exibição
mais a extensão de arquivo .png. Por exemplo:
<img src="http://tableauserver/views/Date-Time/DateCalcs.png"
width="900" height="700">
Observação:
Se a página da Web e o Tableau Server estiverem usando o Microsoft SSPI para
autenticação, qualquer pessoa que esteja acessando a imagem inserida entrará
automaticamente no Tableau Server e poderá ver a exibição. No entanto, se o servidor e a
página da Web não estiverem usando o mesmo método de autenticação, a imagem não será
exibida.
Inserir exibições no SharePoint (autenticação local)
Você pode inserir uma exibição do Tableau Server em uma página do SharePoint. Se
Autenticação local for o método de autenticação do usuário do Tableau Server, você deverá
executar algumas etapas antes de começar a inserir as exibições. As etapas identificam os
usuários do Tableau Server, entre outras coisas, no SharePoint. O Tableau fornece essa
funcionalidade por meio dos arquivos complementares TableauEmbeddedView.dll e
TableauEmbeddedView.wsp. Este tópico descreve como instalar e provisionar esses
arquivos, testar sua configuração e inserir uma exibição usando uma Web Part do SharePoint.
Se o Active Directory for seu método de autenticação de usuário, não será necessário
executar essas etapas extras, pois o Active Directory e o SharePoint usam o Microsoft SSPI.
Você pode começar a inserir agora mesmo. Consulte as etapas em Inserir exibições no
SharePoint (Microsoft SSPI).
Requisitos
Qualquer pessoa que acessa uma exibição inserida deve ser um usuário licenciado no
Tableau Server e o respectivo nome de usuário no SharePoint deve ser igual ao nome de
usuário no Tableau Server.
Editar permissões de segurança do DLL
A primeira etapa é editar as permissões de segurança do .dll para que todos os usuários do
sistema operacional possam usá-lo.
1. Localize os arquivos TableauEmbeddedView.dll e TableauEmbeddedView.wsp que
foram instalados com o Tableau Server:
C:\Program Files\Tableau\Tableau
Server\8.1\extras\embedding\sharepoint\
2. Copie os arquivos no diretório raiz do servidor SharePoint. O diretório raiz é
normalmente localizado em
C:\Inetpub\wwwroot\wss\VirtualDirectories\<port>\bin, por
exemplo:
C:\Inetpub\wwwroot\wss\VirtualDirectories\80\bin
O restante desse procedimento e tudo o que vem em seguida focará apenas no arquivo
.dll.
3. Edite as permissões de segurança em TableauEmbeddedView.dll clicando nele com o
botão direito do mouse e selecionando Propriedades > Segurança.
4. Em Nomes de grupos ou usuários, selecione Todos e clique em Editar.
5. Em Permissões para todos, selecione Permitir para a permissão Controle total.
6. Clique OK.
Instalar e implantar o arquivo WSP
O procedimento acima concedeu permissão para usar o arquivo .dll a todos os usuários do
sistema operacional. No procedimento a seguir, você dará ao SharePoint mais informações
sobre o que fazer com o arquivo .dll. Isso é feito pelo arquivo TableauEmbeddedView.wsp.
Você copiou esse arquivo na etapa 2 de Editar permissões de segurança do DLL. Para
instalar e implantar o arquivo .wsp:
1. Abra um prompt de comando como administrador.
2. Navegue para a pasta a seguir:
C:\Program Files (x86)\Common Files\Microsoft Shared\Web
Server Extensions\14\BIN
3. Execute o comando a seguir para adicionar o arquivo .wsp:
stsadm -o addsolution -filename
"C:\Inetpub\wwwroot\wss\VirtualDirectories\80\bin\TableauEmbeddedView.wsp"
4. Em seguida, execute o comando a seguir para implantá-lo. No comando,
http://<your SharePoint site>/ deve ser o diretório raiz do site do
SharePoint, como http://mySharePoint/.
stsadm -o deploysolution -name TableauEmbeddedView.wsp
http://<your SharePoint Site>/ -local -force allowgacdeployment
-url
5. Por fim, ative o recurso Web Part executando o seguinte comando:
stsadm -o activatefeature -name TableauEmbeddedView_Feature1
-url http://<your SharePoint Site>/
Verificar a implantação da Web Part
Depois de instalar e implantar o arquivo TableauEmbeddedView.wsp, verifique as
configurações fazendo o seguinte:
1. Abra o site do SharePoint em um navegador da Web. Pode demorar alguns instantes
para o site aparecer.
2. Na lista Ações do site, selecione Configurações do site.
3. Em Galerias, selecione Web parts.
4. Confirme que o TableauEmbeddedView está listado.
5. Retorne para Configurações do site e, em Administração de coleta do site,
selecione Recursos de coleta do site.
Confirme que o recurso TableauEmbeddedView está com o status de Ativo.
Inserir uma exibição usando a Web Part
Agora que você está pronto para inserir uma exibição em uma página do SharePoint:
1. Navegue até a página do SharePoint em que você deseja inserir uma exibição (o tipo da
página deve ser Página de Web Part).
2. No menu Ações do site, no canto superior esquerdo da página, selecione Editar
página.
3. Clique em Adicionar uma Web Part na seção da página onde você deseja inserir a
exibição.
4. Em Categorias, selecione TableauEmbeddedView, localizado na pasta Diversos ou
Personalizado, e clique em Adicionar.
5. De volta na página do SharePoint, selecione Editar Web Part no menu Editar da nova
web part.
6. No lado direito da página, é possível especificar os atributos da web part
TableauEmbeddedView. Digite o nome do seu Tableau Server e, em seguida, digite o
caminho da exibição que você deseja inserir. Por exemplo, você pode digitar
/views/Date-Time/DateCalcs.
7. Especifique outros atributos - se você deseja mostrar a barra de ferramentas ou, até
mesmo, se deseja inserir a exibição como uma imagem em vez de uma exibição
interativa.
8. Na seção Aparência, você pode especificar o Título da web part, a Altura e a
Largura. Em geral, você deve especificar uma altura fixa (por exemplo, 700 pixels) e
ajustar a largura para se adequar à zona.
9. Clique em OK para aplicar as alterações e sair do modo de edição.
Agora a exibição está inserida na página e os usuários que a acessarem entrarão
automaticamente com base em seus nomes de usuário e senhas do SharePoint.
Qualquer pessoa que acessa uma exibição inserida precisa ser um usuário licenciado
no Tableau Server e o respectivo nome de usuário no SharePoint deve ser igual ao
nome de usuário no Tableau Server.
Esse é um exemplo de inserção de exibições no SharePoint usando o arquivo .dll
fornecido. Você também pode inserir exibições em outros tipos de aplicativos
Web. Consulte JavaScript API para obter mais informações.
Servidores proxy
O Tableau Server também pode ser configurado para funcionar com um servidor proxy. Neste
tipo de ambiente, o servidor proxy atua como um intermediário entre o Tableau Server e os
clientes que estão fazendo solicitações de recursos no Tableau Server. Há várias maneiras de
configurar servidores proxy — por exemplo, como proxies avançados ou proxies reversos.
Estes tópicos pressupõem que você já configurou seu servidor proxy e agora precisa
identificá-lo para o Tableau Server.
Use os tópicos abaixo para obter mais informações:
Preparar-se para a configuração de um ambiente com proxy
Para configurar o Tableau Server para funcionar com um servidor proxy, você precisará das
seguintes informações sobre seu servidor proxy:
l
l
l
l
Endereço IP: Os endereços IP do servidor proxy. O endereço IP deve estar no formato
IPv4, por exemplo, 123.45.67.89, além de ser um IP estático.
FQDN: O nome de domínio totalmente qualificado do servidor proxy. Por exemplo,
bigbox.myco.com.
Não FQDN: Qualquer nome de domínio não totalmente qualificado do servidor proxy.
Usando o exemplo acima, o nome de domínio totalmente qualificado do servidor proxy
seria bigbox.
Aliases: Qualquer alias do servidor proxy. Os aliases são designados com o uso de
CNAMEs (registros de Nome canônico). Um exemplo seria um servidor proxy com um
CNAME de bigbox.myco.com e aliases de ftp.myco.com e www.myco.com.
Configurar o Tableau para funcionar com um servidor proxy
Após a coleta das informações descritas em Preparar-se para a configuração de um ambiente
com proxy, você pode configurar o Tableau Server para funcionar com um proxy executando
as etapas a seguir. Para obter informações sobre as configurações abaixo, consulte Opções
tabadmin set.
1. Interrompa o servidor.
2. Ainda no diretório bin do Tableau Server, insira o seguinte comando, onde name é o
nome canônico (externamente visível) do servidor proxy:
tabadmin set gateway.public.host "name"
3. Por padrão, o Tableau presume que o servidor proxy esteja ouvindo as comunicações
externas na porta 80. Para designar uma porta diferentes, digite o comando a seguir,
onde port_number corresponde à porta.
tabadmin set gateway.public.port "port_number"
4. Agora, digite o seguinte comando, em que server é o endereço IPv4 ou o nome do
computador do servidor proxy:
tabadmin set gateway.trusted "server"
O valor de server pode ser uma lista separada por vírgulas, por exemplo:
tabadmin set gateway.trusted "123.45.67.890, 123.45.67.880,
123.45.67.870"
ou
tabadmin set gateway.trusted "proxy1, proxy2, proxy3"
5. No comando seguinte, você fornecerá nomes alternativos para o servidor proxy, como
seu nome de domínio totalmente qualificado, nomes de domínio não totalmente
qualificados e aliases. Esses são os nomes que um usuário poderá digitar em um
navegador. Separe cada nome com uma vírgula:
tabadmin set gateway.trusted_hosts "name1, name2, name3"
Por exemplo:
tabadmin set gateway.trusted_hosts "proxy1.example.com,
proxy1, ftp.example.com, www.example.com"
6. Inicie o servidor para que as alterações possam ter efeito.
Autenticação confiável
Quando você insere exibições do Tableau Server em páginas da Web, todos que visitarem a
página deverão ser um usuário licenciado no Tableau Server. Ao visitarem a página, os
usuários são solicitados a entrarem no Tableau Server para que possam ver a exibição. Caso
já tenha uma maneira de autenticar usuários na página da Web ou em seu aplicativo web,
você pode evitar essa solicitação e evitar que seus usuários precisem entrar duas vezes
configurando a autenticação confiável.
A autenticação confiável simplesmente significa que você configurou uma relação confiável
entre o Tableau Server e um ou mais servidores Web. Quando o Tableau Server recebe
solicitações desses servidores Web confiáveis, ele supõe que o servidor já foi tratado,
independentemente de a autenticação ser necessária.
Se seu servidor Web usar SSPI (Security Support Provider Interface), você não precisará
configurar a autenticação confiável. É possível inserir exibições, e seus usuários terão acesso
seguro a elas desde que sejam usuários e membros licenciados do Tableau Server do seu
Active Directory. O uso de Habilitar logon automático (uma opção configurada durante a
Instalação que usa o Microsoft SSPI) e da autenticação confiável não é compatível. Se você
estiver usando o SSPI com o Active Directory e quiser que seus usuários tenham acesso
seguro às exibições do Tableau Server sem serem solicitados a inserir credenciais, você pode
configurar a autenticação confiável.
Para que os usuários possam ser autenticados quando clicam em uma exibição
inserida, seus navegadores devem estar configurados para permitir cookies de
terceiros.
Como a autenticação confiável funciona
O diagrama abaixo descreve como a autenticação confiável funciona entre o navegador da
Web do cliente, seu servidor Web e o Tableau Server.
O usuário visita a página
da Web: Quando um usuário
visita a página da Web com a
exibição inserida do Tableau
Server, ele envia uma
solicitação GET a seu servidor
Web para o HTML dessa
página.
O servidor Web envia
O servidor Web passa a URL para o
navegador: O servidor Web constrói a URL para a
exibição usando a URL da exibição ou sua marca
de objeto (se inserida na exibição) e a insere no
HTML da página. O ticket é incluído (ex.:
http://tabserver/trusted/<ticket>/views/requestedviewname). O servidor Web passa todo o HTML da
página de volta ao navegador da Web do cliente.
O navegador solicita a exibição do Tableau
Server: O navegador da Web do cliente envia uma
POSTS ao Tableau Server:
O servidor Web envia uma
solicitação POST ao Tableau
Server confiável (por exemplo,
http://tabaserver/trusted, não
http://tabserver). Essa
solicitação POST deve ter um
parâmetro username. O
valor de username deve ser
o nome de usuário de um
usuário licenciado do Tableau
Server. Se o servidor estiver
executando vários sites e a
exibição estiver em um site
que não seja o site padrão, a
solicitação POST também
deverá incluir um parâmetro
target_site.
O Tableau Server cria um
ticket: O Tableau Server
verifica o endereço IP ou o
nome de host do servidor Web
(192.168.1.XXX no diagrama
acima) que enviou a
solicitação POST. Caso seja
configurado como um host
confiável, o Tableau Server
cria um ticket na forma de uma
cadeia de caracteres exclusiva
de 24 caracteres (URL
segura, codificada com
Base64). O Tableau Server
responde à solicitação POST
com esse ticket. Se houver um
erro e o ticket não puder ser
criado, o Tableau Server
responderá com um valor de 1.
solicitação ao Tableau Server usando uma
solicitação GET que inclui a URL com o ticket.
O Tableau Server resgata o ticket: O Tableau
Server vê que o navegador da Web solicitou uma
URL com um ticket e resgata o ticket. Os tickets
devem ser resgatados em até três minutos, a contar
de quando foram emitidos. Assim que o ticket é
resgatado, o Tableau Server conecta o usuário,
remove o ticket da URL e envia a URL final de volta
para a exibição inserida.
Adicionar endereços IP confiáveis ou nomes de host ao Tableau Server
A primeira etapa da configuração da autenticação confiável é configurar o Tableau Server
para reconhecer e confiar em solicitações de um ou mais servidores Web:
1. Abra um prompt de comando como um administrador e navegue até seu diretório bin do
Tableau Server (por exemplo, C:\Program Files\Tableau\Tableau Server\8.1\bin).
2. Em seguida, digite o seguinte comando:
tabadmin set wgserver.trusted_hosts "<trusted IP addresses or
host names>"
No comando acima, <trusted IP addresses> deve ser uma lista separada por
vírgulas dos endereços IPv4 ou dos nomes de host de seus servidores Web. Por
exemplo:
tabadmin set wgserver.trusted_hosts "192.168.1.101,
192.168.1.102, 192.168.1.103"
ou
tabadmin set wgserver.trusted_hosts "webserv1, webserv2,
webserv3"
Observações:
l
l
A lista separada por vírgulas deve estar entre aspas com um espaço após
cada vírgula.
Os servidores Web especificados devem usar endereços IP estáticos,
mesmo que você use nomes de host aqui para especificá-los.
3. Caso tenha um ou mais servidores proxy entre o computador que está solicitando o
ticket confiável (um dos configurados na etapa 2, acima) e o Tableau Server, você
também precisa adicioná-los como gateways confiáveis. Consulte Configurar o Tableau
para funcionar com um servidor proxy para ver as etapas.
4. Por fim, digite o seguinte comando para reiniciar o servidor:
tabadmin restart
Em seguida, você deverá configurar seu servidor Web para receber tickets do Tableau Server.
Obter um ticket do Tableau Server
Depois de adicionar endereços IP confiáveis ao Tableau Server, você estará pronto para
configurar seu servidor Web para obter tickets do Tableau Server via solicitações POST
(etapa 3 do diagrama). A solicitação POST deve ser enviada a http://<server
name>/trusted — por exemplo, http://tabserv/trusted, não a
http://tabserv.
Para obter exemplos de códigos que você pode usar para criar a solicitação POST em Java,
Ruby e PHP, consulte o seguinte:
C:\Program Files\Tableau\Tableau Server\8.1\extras\embedding
Estes são os dados que você pode usar em uma solicitação POST ao Tableau Server:
l
l
l
username=<username> (obrigatório): O nome de usuário para um usuário
licenciado do Tableau Server. Se estiver usando a Autenticação local, o nome de
usuário pode ser uma string simples (por exemplo, username=jsmith). Se estiver
usando o Active Directory com vários domínios, você deverá incluir o nome de domínio
com o nome de usuário (por exemplo, username=MyCo\jsmith).
target_site=<site id> (obrigatório, se a exibição não estiver no site padrão):
Especifica o site que contém a exibição se o Tableau Server estiver executando vários
sites e a exibição estiver em um site diferente do site padrão (por exemplo, target_
site=Sales). O valor que você usa para <site id> deve ser o nome da pasta Web
do site.
client_ip=<IP address> (opcional): Usado para especificar o endereço IP do
computador cujo navegador da Web está acessando a exibição (por exemplo,
client_ip=123.45.67.891). Não é o endereço IP do servidor Web que está
fazendo a solicitação POST do Tableau Server. Se você decidir usar esse parâmetro,
consulte Opcional: Configurar a correspondência IP do cliente para obter mais
informações.
A resposta do Tableau Server à solicitação POST será uma string exclusiva de nove dígitos (o
ticket). Se o Tableau Server não puder processar a solicitação, a resposta será -1. Consulte
Valor de ticket -1 retornado pelo Tableau Server para ver as dicas de como corrigir isso. Além
disso, para que os usuários consigam se autenticar quando clicam em uma exibição inserida,
seus navegadores devem estar configurados para permitir cookies de terceiros.
Em seguida, você deverá adicionar o código que permite que o servidor Web construa uma
URL para a exibição que contenha o local da exibição e o ticket.
Ver a exibição com o ticket
Depois de criar a solicitação POST, você deverá gravar o código que fornece ao servidor Web
o local da exibição e o ticket do Tableau Server. Ele usará essas informações para mostrar a
exibição. A maneira como você especifica isso depende se a exibição é inserida e se o
Tableau Server está executando vários sites.
Exemplos de exibição do Tableau Server
Este é um exemplo de como especificar uma exibição que os usuários acessam somente via
Tableau Server (a exibição não é inserida):
http://tabserver/trusted/<ticket>/views/<workbook>/<view>
Se o Tableau Server estiver executando vários sites e a exibição estiver em um site diferente
do padrão, você deverá adicionar t/<site name> ao caminho. Por exemplo:
http://tabserver/trusted/<ticket>/t/Sales/views/<workbook>/<view>
Exemplos de exibição inserida
Estes são alguns exemplos de como especificar exibições inseridas. Como há duas
abordagens que você pode adotar para o código inserido, as duas maneiras são descritas
abaixo. Independentemente do que for usado, haverá algumas informações exclusivas da
autenticação confiável que você deverá fornecer.
Exemplos de marca de script
Este exemplo usa o parâmetro de objeto ticket:
<script type="text/javascript"
src="http://myserver/javascripts/api/viz_v1.js"></script>
<object class="tableauViz" width="800" height="600"
style="display:none;">
<param name="name" value="MyCoSales/SalesScoreCard" />
<param name="ticket" value="Etdpsm_Ew6rJY-9kRrALjauU" />
</object>
Aqui está como o exemplo acima ficaria em um Tableau Server com vários sites, onde a
exibição está publicada no site Sales:
<script type="text/javascript"
src="http://myserver/javascripts/api/viz_v1.js"></script>
<object class="tableauViz" width="800" height="600"
style="display:none;">
<param name="site_root" value="/t/Sales" />
<param name="name" value="MyCoSales/SalesScoreCard" />
<param name="ticket" value="Etdpsm_Ew6rJY-9kRrALjauU" />
</object>
Em vez de usar ticket, você pode usar o parâmetro path para indicar explicitamente o
caminho completo da exibição. Quando path é usado, você também não precisa do
parâmetro name, que é geralmente um parâmetro obrigatório no código inserido do Tableau
JavaScript:
<script type="text/javascript"
src="http://myserver/javascripts/api/viz_v1.js"></script>
<object class="tableauViz" width="900" height="700"
style="display:none;">
<param name="path" value="trusted/Etdpsm_Ew6rJY9kRrALjauU/views/MyCoSales/SalesScoreCard" />
</object>
Este é o mesmo exemplo, só que para um servidor com vários sites. Observe que /t/<site
name> é usado aqui:
<script type="text/javascript"
src="http://myserver/javascripts/api/viz_v1.js"></script>
<object class="tableauViz" width="900" height="700"
style="display:none;">
<param name="path" value="trusted/Etdpsm_Ew6rJY9kRrALjauU/t/Sales/views/MyCoSales/SalesScoreCard" />
</object>
Exemplo de marca Iframe
<iframe src="http://tabserver/trusted/Etdpsm_Ew6rJY9kRrALjauU/views/workbookQ4/SalesQ4?:embed=yes" width="800"
height="600"></iframe>
Opcional: Configurar a correspondência IP do cliente
Por padrão, o Tableau Server não considera o endereço IP do navegador da Web do cliente
quando ele cria ou resgata tickets. Para mudar isso, é necessário fazer duas coisas:
especificar um endereço IP usando o parâmetro client_ip na solicitação POST que obtém
o ticket e seguir as etapas abaixo para configurar o Tableau Server para impor a
correspondência de endereço IP do cliente.
1. Abra uma janela de comando e altere os diretórios para o local do diretório bin do
Tableau Server. O local padrão é C:\Program Files\Tableau\Tableau
Server\8.1\bin
2. Abra um prompt de comando como um administrador e digite o seguinte comando:
tabadmin set wgserver.extended_trusted_ip_checking true
3. Em seguida, digite o seguinte comando:
tabadmin configure
4. Por fim, reinicie o servidor digitando o seguinte:
tabadmin restart
Solucionar problemas de autenticação confiável
Veja abaixo alguns problemas e erros comuns que você pode encontrar quando estiver
configurando a autenticação confiável. As informações de autenticação confiável são
gravadas em ProgramData\Tableau\Tableau
Server\data\tabsvc\logs\vizqlserver\vizql-*.log. Para aumentar o nível de
registro de info para debug, use a configuração tabadmin vizqlserver.trustedticket.log_level.
Para obter dicas de teste de autenticação confiável, consulte a Base de dados de
conhecimento do Tableau.
Valor de ticket -1 retornado pelo Tableau Server
O Tableau Server retornará -1 para o valor do ticket se ele não puder emitir o ticket como parte
do processo de autenticação confiável. O motivo exato dessa mensagem está gravado no
arquivo production*.log na seguinte pasta:
ProgramData\Tableau\Tableau Server\data\tabsvc\logs\wgserver
Estes são alguns fatores a serem confirmados:
l
Todos os nomes de host do servidor Web ou endereços IP são adicionados a
hosts confiáveis
O endereço IP ou o nome de host do computador que envia a solicitação POST deve
estar na lista de hosts confiáveis no Tableau Server. Consulte Adicionar endereços IP
confiáveis ou nomes de host ao Tableau Server para saber como adicionar endereços
IP ou nomes de host a essa lista.
l
O valor de wgserver.trusted_hosts está formatado corretamente
A lista de hosts confiáveis fornecidas por você usando a configuração wgserver.trusted_
hosts deve ser uma lista separada por vírgulas com um espaço após cada vírgula. Por
exemplo, a lista deve ser semelhante ao seguinte: 192.168.1.101, 192.168.1.102,
192.168.1.103 ou bigbox1.example.lan, bixbox2.example.lan, bigbox3.example.lan.
l
Endereços IP são IPv4
Caso você esteja usando endereços IP para especificar hosts confiáveis, eles devem
estar no formato do protocolo IP versão 4 (IPv4). Um endereço IPv4 será semelhante a
isto: 123.456.7.890. Os endereços IPv6 (por exemplo, fe12::3c4a:5eab:6789:01c%34)
não são compatíveis como forma de inserir hosts confiáveis.
l
O nome de usuário na solicitação POST é um usuário válido do Tableau Server
O nome de usuário que você envia na solicitação POST deve ser um usuário licenciado
do Tableau Server com um nível de licença Visualizador ou Interagente. Você pode ver
uma lista de usuários e seus níveis de licença entrando no Tableau Server como um
administrador e clicando no link Licenciamento no lado esquerdo da página.
l
O nome de usuário na solicitação POST inclui o domínio
Se o Tableau Server for configurado para usar a Autenticação local, o nome de usuário
que você envia no POST pode ser uma string simples. No entanto, se o servidor for
configurado para o Active Directory, você deverá incluir o nome de domínio com o nome
de usuário (domínio\nome de usuário). Por exemplo, o parâmetro de nome de usuário
pode ser: username=dev\jsmith
HTTP 401 - Não autorizado
Caso receba um erro 401 – Não autorizado, você pode ter configurado o Tableau Server para
usar o Active Directory com SSPI (consulte Habilitar logon automático). Se seu servidor Web
usar SSPI, você não precisará configurar a autenticação confiável. É possível inserir exibições
e seus usuários terão acesso a elas, desde que eles sejam usuários e membros licenciados do
Tableau Server do seu Active Directory.
O uso simultâneo de Habilitar logon automático e da autenticação confiável não é
compatível.
HTTP 404 – Arquivo não encontrado
Você poderá receber esse erro se o código do seu programa fizer referência a uma URL do
Tableau Server que não existe. Por exemplo, o servidor Web pode construir uma URL inválida
que não pode ser encontrada quando a página da Web tenta recuperá-la.
Usuário inválido (SharePoint ou C#)
Você poderá encontrar esse erro se tiver configurado o Tableau Server para autenticação
confiável.
O código de exemplo para a .dll do SharePoint faz referência à seguinte solicitação GET:
SPContext.Current.Web.CurrentUser.Name
A solicitação acima retornará o nome para exibição do usuário atual do Windows Active
Directory. Se desejar usar a ID de logon, você precisará alterar o código para:
SPContext.Current.Web.CurrentUser.LoginName
Após fazer a alteração, recompile a .dll do SharePoint.
Tentativa de recuperar o ticket do endereço IP incorreto
Você poderá encontrar esse erro se tiver configurado o Tableau Server para autenticação
confiável.
O endereço IP do navegador da Web do cliente não é considerado por padrão no resgate do
ticket. Se o Tableau Server foi configurado para impor a correspondência de endereço IP do
cliente, certifique-se de que o endereço IP do navegador da Web do cliente que foi enviado na
POST ao Tableau Server é o mesmo de quando o navegador tentar recuperar a exibição
inserida. Por exemplo, no diagrama Autenticação confiável, se a solicitação POST na etapa 3
enviar o parâmetro client_ip=74.125.19.147, a solicitação GET na etapa 5 deverá vir do
mesmo endereço IP.
Consulte Opcional: Configurar a correspondência IP do cliente para saber como configurar o
Tableau Server para impor a correspondência de endereço IP do cliente.
Erro de restrição de cookie
Quando um usuário entra no Tableau Server, um cookie de sessão é armazenado em seu
navegador local. O cookie armazenado é a forma como o Tableau Server mantém que o
usuário que entrou foi autenticado e pode acessar o servidor. Como o cookie é definido com o
mesmo domínio ou subdomínio que a barra de endereços do navegador, ele é considerado
um cookie primário. Se o navegador de um usuário estiver configurado para bloquear cookies
primários, ele não conseguirá entrar no Tableau Server.
Quando um usuário entra no Tableau Server por meio de uma exibição inserida, ou em um
ambiente em que a autenticação confiável tenha sido configurada, o mesmo acontece: um
cookie é armazenado. Nesse caso, entretanto, o navegador trata o cookie como um cookie de
terceiros. Isso acontece porque o cookie é definido com um domínio que é diferente daquele
mostrado na barra de endereços do navegador. Se o navegador da web do usuário estiver
configurado para bloquear cookies de terceiros, a autenticação no Tableau Server falhará.
Para evitar que isso ocorra, os navegadores da web devem ser configurados para permitir
cookies de terceiros.
Erro na comunicação com o servidor (403)
Se o Tableau Server estiver configurado para a autenticação confiável, talvez você receba
esse erro depois de abrir uma nova exibição em um navegador e tentar navegar de volta para
as exibições abertas anteriormente. O Tableau Server fornece proteção contra reutilização
não autorizada das sessões VizQL por meio da opção tabadmin set vizqlserver.protect_
sessions, definida como true por padrão. Como o Tableau Server é configurado para
autenticação confiável, você também não precisa habilitar vizqlserver.protect_
sessions. Para desabilitá-la, use tabadmin set para mudar para false.
SAML
Você pode configurar o Tableau Server para usar um provedor de identidade externo (IdP)
para autenticar usuários do Tableau Server usando SAML. Toda a autenticação de usuário é
feita fora do Tableau, independentemente de você estar usando ou não o Active Directory ou a
autenticação local no Tableau Server para gerenciar suas contas de usuário no Tableau
Server. Isso permite oferecer uma experiência de logon único em todos os aplicativos na
organização. Consulte os links abaixo para obter mais informações sobre o SAML:
Como a autenticação SAML funciona
SAML é um padrão aberto com base em XML para troca de informações de autenticação
entre duas partes, um provedor de serviços (nesse caso, Tableau Server) e um provedor de
identidades (IdP). Quando você configura o Tableau Server para SAML, um IdP de terceiros é
usado para autenticar usuários e passar informações de identidade para o Tableau Server na
forma de um documento XML assinado digitalmente.
Tentativas de usuário para acessar
um link da pasta de trabalho do
Tableau Server ou outro recurso.
O Tableau Server inicia o processo
de autenticação e redireciona o
usuário para o IdP.
O IdP envia uma resposta de
êxito do SAML para o
Tableau Server.
O usuário abre a pasta de
trabalho no Tableau Server.
O IdP autentica o usuário.
Conta de
usuário do
Tableau
Server.
Este nome
de usuário
deve ser
igual ao
que o IdP
tem
armazenado como o
nome de
usuário (
).
Conta de
usuário no
IdP.
Requisitos do SAML
Para configurar o Tableau Server para SAML, você precisa do seguinte:
Arquivo de certificado: Um certificado x509 codificado por PEM com a extensão .crt.
Arquivo de chave do certificado: Um arquivo de chave RSA ou DSA não protegido pode
senha e que tenha uma extensão de arquivo .key.
Conta do IdP: Você precisa de uma conta com um provedor de identidades externo. Alguns
exemplos são PingFederate, SiteMinder e Open AM.
Atributo nomeado nome de usuário: Você deve configurar seu provedor de identidades
para retornar um atributo chamado username na resposta SAML.
Nomes de usuário correspondentes: Os nomes de usuário do Tableau Server e os nomes
de usuário no IdP devem ser iguais. Por exemplo, se o nome de usuário de Jane Silva estiver
armazenado no PingFederate como jsmith, ele também deverá ser armazenado no Tableau
Server como jsmith. Além disso, caso você esteja configurando SAML como parte da
Instalação do Tableau Server, parte da Instalação está criando a conta de administrador do
Tableau Server. Antes de executar a Instalação, verifique se a conta que você pretende usar
existe em seu IdP.
Nenhum logon automático do Active Directory: Caso você esteja usando SAML e o
Tableau Server também esteja configurado para usar o Active Directory no gerenciamento de
usuários, não use também Habilitar logon automático.
SAML
Você pode configurar o Tableau Server para usar um provedor de identidade externo (IdP)
para autenticar usuários do Tableau Server usando SAML. Toda a autenticação de usuário é
feita fora do Tableau, independentemente de você estar usando ou não o Active Directory ou a
autenticação local no Tableau Server para gerenciar suas contas de usuário no Tableau
Server. Isso permite oferecer uma experiência de logon único em todos os aplicativos na
organização.
Antes de configurar o Tableau Server for SAML, verifique se você atende aos Requisitos do
SAML.
Configurar SAML
Para configurar o Tableau Server a fim de usar SAML:
1. Coloque os arquivos de certificado em uma pasta chamada SAML, paralela à pasta 8.1
do Tableau Server. Por exemplo:
C:\Program Files\Tableau\Tableau Server\SAML
Esse local fornece à conta que está executando o Tableau Server as permissões
necessárias para os arquivos.
2. A configuração de SAML é identificada na guia SAML, exibida durante a Instalação do
Tableau Server. Caso você esteja configurando o SAML após a Instalação, acesse a
guia SAML abrindo o utilitário de configuração do Tableau Server (Iniciar > Todos os
Programas > Tableau Server8.1 > Configurar Tableau Server) e clicando na guia
SAML.
3. Na guia SAML, selecione Usar SAML para logon único e forneça o local para cada
uma das seguintes opções:
URL de retorno do Tableau Server — A URL que os usuários do Tableau Server
acessarão, como http://tableau_server. Usar http://localhost não é recomendável.
ID da entidade SAML — O ID da entidade identifica com exclusividade a instalação do
Tableau Server para o IdP. Você pode inserir o URL do Tableau Server novamente
aqui, caso queira, mas não precisa ser seu URL do Tableau Server.
Arquivo de certificado SAML — Um certificado x509 com codificação PEM e a
extensão .crt
Arquivo da chave de certificado SAML — Uma chave RSA ou DSA não protegida
por senha com a extensão de arquivo .key
4. Deixe a caixa de texto Arquivo de metadados IdP SAML vazia por enquanto e clique
em Exportar arquivo de metadados.
5. Uma caixa de diálogo que permite salvar as configurações SAML do Tableau Server
como um arquivo XML. Nesse ponto, os metadados de seu IdP não estão incluídos.
Salve o arquivo XML com o nome de sua escolha.
6. No site de seu IdP ou em seu aplicativo:
l
l
Adicione o Tableau Server como um provedor de serviços.Você precisará
consultar a documentação de seus IdPs sobre como fazer isso. Como parte
disso, você importará o arquivo salvo na etapa 5.
Confirme se seu IdP usa nome de usuário como o elemento de atributo a ser
verificado.
7. Ainda dentro de seu IdP, exporte o arquivo XML de metadados de seu IdP.
8. Copie o arquivo XML de metadados de seu IdP para a seguinte pasta em seu
computador do Tableau Server:
C:\Program Files\Tableau\Tableau Server\SAML
9. Na guia SAML, na caixa de diálogo Configuração do Tableau Server, informe o local até
o arquivo na caixa de texto Arquivo de metadados IdP SAML:
10. Clique em OK. O Tableau Server já está configurado para autenticação SAML.
Testar sua configuração
Teste sua configuração SAML abrindo uma nova instância do navegador da Web e digitando o
nome do Tableau Server na janela URL:
O prompt de entrada exibido é de seu IdP, e não do Tableau Server:
Solução de problemas do SAML
Use os tópicos a seguir para solucionar problemas do SAML.
SAML e habilitar logon automático
Caso você esteja usando SAML e o Tableau Server também esteja configurado para usar o
Active Directory, não selecione também Habilitar logon automático. Habilitar logon
automático e SAML não podem ser usados.
Falha no logon
Caso você receba a mensagem "Falha no logon: Autenticação do Provedor de identidade
bem-sucedida para o usuário <username from IdP>. Falha ao encontrar o usuário no Tableau
Server." Os nomes de usuário conforme armazenados no Tableau Server e conforme
armazenados em seu IdP não são idênticos. Para corrigir isso, verifique se eles são iguais. Por
exemplo, se o nome de usuário de Jane Silva estiver armazenado no IdP como jsmith, ele
deverá ser armazenado no Tableau Server como jsmith.
Log de erros do SAML
Os erros de entrada do SAML são registrados no local a seguir. Você pode usar esse log para
solucionar problemas.
C:\ProgramData\Tableau\Tableau
Server\data\tabsvc\logs\wgserver\error.log
Usuário Run As
Você pode usar uma conta de usuário AD (Active Directory) dedicada sob a qual executar o
serviço do Tableau Server chamada conta de usuário Run As. Alguns administradores optam
por fazer isso quando pastas publicadas no Tableau Server se conectam a fontes de dados
ativas. A conta Serviço de rede padrão do servidor (NT AUTHORITY\NetworkService) não
tem as permissões corretas para se conectar a fontes de dados em outros computadores.
Uma conta AD configurada corretamente sim.
Para fontes de dados que exigem autenticação NT, a conta AD também pode tratar
automaticamente do processo de autenticação, evitando, assim, que os usuários sejam
solicitados a fornecer credenciais quando a pasta de trabalho se conecta à fonte de dados
ativa. Por fim, a conta AD de usuário Run As que é dedicada a um recurso específico é, muitas
vezes, menos problemática para gerenciar do que uma conta AD associada a uma pessoa.
Para configurar o Tableau Server para usar uma conta de usuário Run As, siga os
procedimentos abaixo. Se você estiver executando uma instalação distribuída do Tableau
Server, estas etapas deverão ser executadas nos computadores de trabalho e primário.
Observe também que as etapas em Configurações da conta Run As a serem confirmadas
podem variar de site para site.
Observação:
Se estiver instalando o Tableau Server com sua conta de usuário Run As, antes de executar a
instalação, confirme se o serviço Logon Secundário do Windows tem os valores corretos para
Logon e Inicialização. Consulte Verificar as configurações do Tableau Service para obter mais
informações.
Identificar a conta
Sua primeira etapa é identificar ou criar uma conta Active Directory sob a qual executar o
serviço do Tableau Server. Essa será a conta de usuário Run As do Tableau Server e deverá
ter o seguinte:
l
l
l
Permissões para se conectar à fonte de dados com pelo menos acesso de leitura.
Credenciais para permitir que o Tableau Server atenda ao processo de autenticação
NT com a fonte de dados. As fontes de dados Microsoft que executam a autenticação
NT incluem o Microsoft SQL Server e Microsoft Analytical Services (MSAS), mas não o
Access nem o Excel.
Permissões para consultar seu controlador de domínio do Active Directory para
usuários e grupos. Uma conta de usuário criada no computador local em que o Tableau
Server está sendo executado provavelmente não terá essas permissões.
Confirmar a relação de confiança bidirecional do domínio
Confirme se existe uma relação de confiança bidirecional entre domínios, se alguma das
afirmações a seguir for verdadeira:
l
l
Os computadores que hospedam o Tableau Server e a fonte de dados estão em
domínios separados.
Os usuários do Tableau Server estão em domínio separado do Tableau Server ou da
fonte de dados.
Verificar as configurações do Tableau Service
Confirme se os serviços do Tableau receberam os valores corretos de Logon e Inicialização.
Se você estiver executando uma instalação distribuída do Tableau Server, execute estas
etapas nos computadores de trabalho e primário.
1. Faça logon como administrador no computador que está executando o Tableau Server.
2. No computador do Tableau Server, selecione Iniciar > Painel de controle >
Ferramentas administrativas > Gerenciamento de computador > Serviços e
aplicativos > Serviços.
3. Abra Serviços e aplicativos e clique em Serviços. Confirme se os serviços a seguir têm
as configurações corretas:
Nome do
serviço
Serviço de
licenciamento
FLEXnet
Logon
secundário
Tableau Server
(tabsvc)
Tablicsrv
Valor do logon
Sistema local
Valor de
inicialização
Manual
Sistema local
Automático
<domínio>\<nome_de_usuário> Essa
é a conta de usuário Run As. Veja
abaixo.
Sistema local
Automático
Automático
Alteração do valor de logon
Para alterar o valor de Logon do Tableau Server (tabsvc) para a conta de usuário Run As:
1. Na janela Serviços, interrompa o serviço do Tableau Server clicando com o botão direito
do mouse no Tableau Server (tabsvc) e selecionando Parar.
2. Selecione Iniciar > Todos os programas > Tableau Server > Configurar o
Tableau Server.
3. Na guia Geral, insira o domínio, o nome de usuário e a senha para a conta de usuário
Run As do Tableau Server.
4. Clique em OK e reinicie o Tableau Server (tabsvc).
Preparar a política de segurança local
Se sua conta de usuário Run As não for um administrador no computador (primário e de
trabalho, se estiver executando uma instalação distribuída) do Tableau Server, você deverá
preparar a política de segurança local do computador para que a conta de usuário Run As do
Tableau Server possa fazer logon no computador como um serviço e fazer alterações de
configuração. Para isso:
1. Selecione Iniciar > Painel de controle > Ferramentas administrativas > Política
de segurança local.
2. Na janela Configurações locais de segurança, abra Políticas locais, destaque
Atribuições de direitos do usuário e clique com o botão direito do mouse em Fazer
logon como um serviço e selecione Propriedades.
3. Na janela Propriedades de Fazer logon como um serviço, clique em Adicionar usuário
ou grupo.
4. Digite o <domain>\<username> para a conta de usuário Run As do Tableau Server
(por exemplo: MYCO\tableau_server) e clique em Verificar nomes.
5. Quando a conta for resolvida corretamente, ela será sublinhada. Clique em OK.
6. Repita estas etapas para remover a conta Run As da política Fazer logon localmente.
7. Repita estas etapas para remover a conta Run As da política Negar logon.
8. Clique em OK para fechar as janelas Configurações locais de segurança.
Definir as configurações de conexão à fonte de dados
Para autenticar automaticamente seus usuários quando a pasta de trabalho que eles
estiverem acessando se conectar a uma fonte de dados ativa, autenticada por NT, configure
sua conexão de dados do Tableau com a opção Use a segurança integrada do Windows
NT selecionada:
Segurança integrada do Windows NT
Autentica com a conta de usuário Run As do
servidor
Nome de usuário e senha
Cada usuário do Tableau Server é solicitado
a fornecer credenciais de banco de dados
Configurações da conta Run As a serem confirmadas
A conta de usuário Run As precisa de permissões que a permitam ler, executar e, às vezes,
modificar arquivos. Dependendo da conta usada como um ponto de partida, ela já pode ter as
permissões corretas. Sempre que você alterar a conta Run As do servidor, é preciso confirmar
se ela atende aos requisitos a seguir.Se você estiver executando uma instalação distribuída,
isso se aplicará aos computadores primário e de trabalho.
Conceder permissões de leitura e execução
A conta sob a qual o serviço do Tableau Server é executado precisa de permissão para ler e
executar arquivos. Sempre que a conta de usuário Run As do servidor for alterada, confirme
ou configure o seguinte:
1. No computador que está hospedando o Tableau Server (e o Tableau Worker, se
distribuído), use o Windows Explorer para clicar com o botão direito do mouse na
unidade na qual o Tableau está instalado, como Disco local (C:) e selecione
Propriedades.
2. Na janela Propriedades do disco local, selecione a guia Segurança.
3. Clique em Editar e em Adicionar.
4. Na caixa de diálogo, Selecionar usuários, computadores, contas de serviço ou grupos,
digite o <domain>\<username> para a conta de usuário Run As do Tableau Server.
Não use uma conta de grupo.
5. Clique em Verificar nomes para resolver a conta e em OK para confirmar.
6. Com a conta de usuário Run As do Tableau Server em destaque, confirme se ela tem
as permissões Ler e executar. A seleção de Ler e executar seleciona
automaticamente Listar conteúdo da pasta e Ler.
7. Clique em OK para sair.
Conceder permissões de modificação
A conta também precisa ter a capacidade de executar tarefas como criar arquivos de registro.
Confirme ou configure o seguinte:
1. Navegue até as seguintes pastas:
C:\Program Files\Tableau
C:\ProgramData\Tableau\
Se estiver executando o Tableau Server 32 bits em um sistema operacional de 64
bits, você precisará ir até C:\Program Files (x86)\Tableau, e não
C:\Program Files\Tableau. Além disso, a unidade acima e os caminhos
podem variar de acordo com o local da instalação do Tableau Server.
2. Clique com o botão direito do mouse na pasta, selecione Propriedades e clique na guia
Segurança:
l
l
l
l
Clique em Editar e em Adicionar.
Digite o <domain>\<username> para a conta de usuário Run As do Tableau
Server.
Clique em Verificar nomes para resolver a conta e em OK para confirmar.
Com a conta de usuário Run As do Tableau Server em destaque, confirme se ela
tem as permissões Modificar. A seleção de Modificar concede
automaticamente todas as permissões, exceto Controle total e Permissões
especiais:
3. Para cada pasta a partir da etapa 1 acima, na guia Segurança das propriedades do
Tableau, clique em Avançado:
4. Na janela Configurações de segurança avançada do Tableau, clique em Alterar
permissões.
5. Na caixa de diálogo Configurações de segurança avançada do Tableau, destaque a
conta de usuário Run As e marque a caixa de seleção Substituir todas as
permissões de objeto filho com permissões hereditárias desse objeto:
6. Clique em OK para aplicar alterações em todas as subpastas e arquivos. Isso pode
demorar alguns minutos. É comum receber várias mensagens de erro do Windows
quando você aplica essas alterações. Não há necessidade de cancelar o processo; em
vez disso, clique em Continuar.
7. Clique em OK para confirmar as alterações e depois clique em OK na caixa de diálogo
Propriedades do Tableau.
Modificar configurações de registro
A etapa a seguir é opcional e não é vista na maioria dos ambientes. Se a segurança de registro
for altamente restritiva, conceda à conta de usuário Run As do Tableau Server as permissões
de leitura e gravação para as seguintes ramificações de registro:
l
HKEY_CURRENT_USER\Software\Tableau
l
Computador de 32 bits: HKEY_LOCAL_MACHINE\Software\Tableau
l
Computador de 64 bits: HKEY_LOCAL_MACHINE\Software\Wow6432Node\Tableau
e
Representação do SQL Server
A representação acontece quando uma conta de usuário atua em nome de outra conta de
usuário. Você pode configurar o Tableau e o Microsoft SQL Server para executarem a
representação de usuários de banco de dados, de modo que a conta de banco de dados do
SQL Server usada pelo Tableau Server faz consultas em nome dos usuários do banco de
dados do SQL Server, que também são usuários do Tableau.
O principal benefício desse recurso é que ele permite aos administradores implementar e
controlar a respectiva política de segurança de dados em um local: nos respectivos bancos de
dados. Quando os usuários do Tableau acessam uma exibição com uma conexão ativa a um
banco de dados do SQL Server, a exibição mostra apenas o que as permissões de banco de
dado dos usuários permitem que eles vejam. Um benefício adicional é que os usuários não
precisam responder a uma solicitação de logon do banco de dados quando acessam a
exibição. Além disso, os editores da pasta de trabalho não precisam depender de filtros
específicos de usuário para restringir o que é visto nas exibições.
Use os tópicos abaixo para obter mais informações sobre o que você precisa para usar esse
recurso.
Requisitos de representação
Veja o que você precisa para usar o recurso:
l
l
l
l
Conexões ativas somente com o SQL Server: A representação pode ser usada
somente para exibições que têm conexão ativa com um banco de dados SQL Server
versão 2005 ou mais recente.
Contas de banco de dados individuais: Cada pessoa que acessará a exibição
deverá ter uma conta individual explícita no banco de dados do SQL Server ao qual a
exibição se conectará. Membros de um grupo do Active Directory (AD) não podem ser
representados. Por exemplo, se Jane Smith for um membro do grupo Vendas do AD e
seu administrador de banco de dados adicionar o grupo ao banco de dados do SQL
Server, Jane não poderá ser representada.
Credenciais correspondentes e tipo de autenticação: As credenciais de cada
conta de usuário do Tableau e o respectivo tipo de autenticação de usuário do Tableau
devem corresponder às credenciais e ao tipo de autenticação no banco de dados do
SQL Server. Em outras palavras, se a conta de usuário de Jane Smith no Tableau
Server tiver um nome de usuário de MyCo\jsmith e o Tableau Server estiver usando o
Active Directory para autenticação de usuário, seu nome de usuário no banco de dados
do SQL Server também deverá ser MyCo\jsmith e o SQL Server deverá estar usando a
Autenticação Integrada do Windows.
Pré-requisitos do SQL Server: No SQL Server, você deve ter uma tabela de
segurança de dados, uma exibição que imponha a segurança de dados, e você deve
exigir que os usuários de seu banco de dados usem a exibição.
l
Conta SQL IMPERSONATE: Você precisa de uma conta de banco de dados do SQL
Server que tenha a permissão IMPERSONATE para os usuários do banco de dados
acima. Essa é uma conta com a função sysadmin ou uma que tenha recebido a
permissão IMPERSONATE para cada conta de usuário individual (consulte o artigo do
MSDN em EXECUTE AS). Essa conta do SQL Server também deve ser uma de duas
contas no Tableau:
l
l
A conta de usuário Run As do Tableau Server (consulte Representação com uma
conta de usuário Run As).
A conta do publicador da pasta de trabalho (consulte Representação com
credenciais SQL inseridas).
Como funciona a representação
Veja uma ilustração de como funciona a representação do usuário do banco de dados:
Na ilustração acima, Jane Smith (MyCo\jsmith) é uma representante de vendas da Costa
Oeste e Henry Wilson (MyCo\hwilson) cobre a Leste. No banco de dados do SQL Server, as
permissões da conta de Jane, MyCo\jsmith, fornecem apenas acesso ao dados da Costa
Oeste. A conta de Henry, MyCo\hwilson, pode acessar apenas os dados da Costa Leste.
Uma exibição foi criada, mostrando dados do país inteiro. Ela tem um conexão ativa com um
banco de dados do SQL Server. Ambos os usuários entram no Tableau Server e clicam na
exibição. O Tableau Server se conecta ao SQL Server usando uma conta de banco de dados
com a permissão IMPERSONATE para a conta de banco de dados de cada usuário. Essa
conta atua em nome da conta de banco de dados de cada usuário.
Quando a exibição é mostrada, ela é restringida pelas permissões de banco de dados
individuais de cada usuário. Jane vê somente os dados de vendas da Costa Oeste; Henry vê
apenas os dados da Costa Leste.
Representação com uma conta de usuário Run As
A representação por uma conta de usuário Run As é a maneira recomendada de executar a
representação. A conta de usuário Run As é uma conta do AD que o serviço do Tableau
Server pode executar na máquina que está hospedando o Tableau Server (consulte Usuário
Run As). Essa mesma conta deve ter a permissão IMPERSONATE para as contas de usuário
do banco de dados no SQL Server. Do ponto de vista de segurança de dados, usar a conta
Run As do Tableau Server para representação fornece ao administrador mais controle.
Para configurar a representação com uma conta de usuário Run As:
1. Quando você configura o Tableau Server como parte da instalação, em Usuário Run
As do servidor, insira a conta do AD do usuário Run As que tem a permissão
IMPERSONATE para as contas de usuário. Em Autenticação do usuário, selecione
Usar Active Directory:
2. Clique em OK para concluir a configuração.
3. Crie uma pasta de trabalho no Tableau Desktop. Ao criar a conexão de dados,
selecione Use a segurança integrada do Windows NT para a conexão ativa da
pasta de trabalho com um banco de dados do SQL Server.
4. No Tableau Desktop, publique a pasta de trabalho no Tableau Server (Servidor >
Publicar pasta de trabalho).
5. Na caixa de diálogo Publicar, clique em Autenticação e, na caixa de diálogo
Autenticação, selecione Representar por meio da conta Run As do servidor na
lista suspensa:
6. Clique em OK.
7. Teste a conexão entrando no Tableau Server como um usuário. Ao clicar em uma
exibição, você não deve ser solicitado a fornecer credenciais de banco de dados e deve
ver apenas os dados que o usuário está autorizado a ver.
Representação com credenciais SQL inseridas
Também é possível executar a representação tendo a pessoa que publica uma exibição
inserindo suas respectivas credenciais de conta do SQL Server na exibição. O Tableau Server
pode ser executado sob qualquer tipo de conta, mas ele usará essas credenciais, fornecidas
pelo editor, para se conectar ao banco de dados.
Essa pode ser a escolha certa para seu site se a conta que manipula a representação não
puder ser uma conta do AD e se você se sentir à vontade fornecendo aos editores da pasta de
trabalho uma conta com um nível de permissão potencialmente alto no SQL Server.
Observação:
Para usar essa abordagem, Credenciais inseridas devem estar habilitadas no Tableau Server:
Para representar com a conta do SQL do publicador da pasta de trabalho:
1. No Tableau Desktop, crie uma pasta de trabalho. Ao criar a conexão de dados,
selecione Use um nome de usuário e uma senha específicos para a conexão ativa da
pasta de trabalho com um banco de dados do SQL Server:
2. Publique a pasta de trabalho no Tableau Server (Servidor > Publicar pasta de
trabalho).
3. Na caixa de diálogo Publicar, clique em Autenticação e, na caixa de diálogo
Autenticação, selecione Representar por meio da senha inserida na lista suspensa:
4. Clique em OK.
5. Teste a conexão entrando no Tableau Server como um usuário. Ao clicar em uma
exibição, você não deve ser solicitado a fornecer credenciais de banco de dados e deve
ver apenas os dados que o usuário está autorizado a ver.
Portas TCP/IP
A tabela a seguir lista as portas usadas por padrão pelo Tableau Server e quais devem estar
disponíveis para associação. Se o Firewall do Windows estiver habilitado, o Tableau Server
abrirá as portas necessárias; você não precisa fazer isso (para instalações distribuídas com
um computador de trabalho executando o Windows 7, consulte a Base de dados de
conhecimento do Tableau).
Usada por este
processo do
Porta servidor...
80
Gateway.
TIPO DE INSTALAÇÃO
Alta
Todos Distribuído disponibilidade Parâmetro
X
gateway.public.port,
worker0.gateway.port
Usada por este
processo do
Porta servidor...
TIPO DE INSTALAÇÃO
Alta
Todos Distribuído disponibilidade Parâmetro
443
SSL. Quando o
Tableau Server é
configurado para
SSL, o servidor de
aplicativos
redireciona
solicitações para
essa porta.
X
--
3729
Instalação do
Tableau Server.
X
--
O Tableau Worker
atua em ambientes
distribuídos e
3730- altamente
3731 disponíveis (o
Tableau Server
primário não escuta
nessas portas).
Servidor de
aplicativos (porta
base 8000). São
usadas as portas
consecutivas após a
8000, até o número
8000 de processos. Por
8059
padrão, o Tableau
Server é instalado
com dois processos
de servidor de
aplicativos (portas
8000 e 8001).
X
X
--
X
wgserver.port
8060
Banco de dados
PostgreSQL.
X
pgsql.port
8061
Firebird.
X
firebird.port
8062
Processo que
executa a
descoberta em um
ambiente
X
pgsql.initport
Usada por este
processo do
Porta servidor...
TIPO DE INSTALAÇÃO
Alta
Todos Distribuído disponibilidade Parâmetro
distribuído que foi
configurado para
alta disponibilidade.
8080
Solr e Tomcat
HTTP.
X
solr.port,
tomcat.http.port1
8250
Tarefas em
segundo plano.
X
backgrounder.port
9090
Processo que
executa a
replicação em um
ambiente
distribuído que foi
configurado para
alta disponibilidade.
X
rsync.port
VizQL Server (porta
base 9100). As
portas consecutivas
após a 9100, até o
número de
processos, também
9100 são usadas. Por
9199
padrão, o Tableau
Server é instalado
com dois processos
do VizQL Server
(portas 9100 e
9101).
X
vizqlserver.port
Data Server (porta
base 9700). As
portas consecutivas
após a 9700, até o
9700 - número de
9899 processos, também
são usadas. Por
padrão, o Tableau
Server é instalado
X
dataserver.port
1Esses parâmetros devem ser definidos para o mesmo valor.
Usada por este
processo do
Porta servidor...
TIPO DE INSTALAÇÃO
Alta
Todos Distribuído disponibilidade Parâmetro
com dois processos
de servidor de
dados (portas 9700
e 9701).
Servidores primário
e de trabalho para
comunicar
27000 informações de
licenciamento em
27009 ambientes
distribuídos e
altamente
disponíveis.
X
X
--
Uma porta adicional
é selecionada
dinamicamente
para servidores
primários ou de
trabalho de modo a
transmitir
informações de
licenciamento em
ambientes
distribuídos e
altamente
disponíveis. Em vez
disso, é possível
especificar uma
porta fixa (27010 é
recomendada).
Consulte a Base de
dados de
conhecimento do
Tableau para ver
detalhes. As
instalações onde o
servidor primário
está em um DMZ
devem usar essas
orientações.
X
X
--
Usada por este
processo do
Porta servidor...
Mecanismo de
dados. O Tableau
Server é instalado
com um processo
do processador de
dados. É possível
27042
que haja até dois
processos do
processador de
dados por nó, em
até dois nós em um
cluster.
Inicialização de
mecanismo de
dados em um
27043 ambiente
distribuído que foi
configurado para
alta disponibilidade.
TIPO DE INSTALAÇÃO
Alta
Todos Distribuído disponibilidade Parâmetro
X
dataengine.port
X
Editar as portas padrão
Você pode modificar as portas padrão usadas pelos processos do Tableau Server utilizando a
ferramenta administrativa de linha de comando, tabadmin. Por exemplo, a porta padrão do
processo do servidor de aplicativo (wgserver) é 8000. Você pode usar o parâmetro
tabadmin workerX.wgserver.port para alterá-la para uma porta diferente. Siga as
etapas abaixo para alterar a configuração da porta do Tableau Server. Se você estiver
habilitando portas JMX do servidor, consulte Habilitar as portas JMX
1. Abra um prompt de comando como um administrador e digite o seguinte:
cd “C:\Program Files\Tableau\Tableau Server\8.1\bin”
2. Modifique um valor de porta digitando o seguinte:
tabadmin set <workerX>.<parameter> <new port value>
No comando acima, <workerX> se refere ao computador cuja porta você deseja
alterar, <parameter> é um dos valores na tabela abaixo (uma porta do processo de
servidor, como wgserver.port) e <new port value> é o novo número de porta
que você deseja que o processo use. Se o Tableau Server estiver sendo executado em
uma máquina, <workerX> será worker0. Se você estiver executando um cluster,
worker0 será o primário, worker1 será seu primeiro servidor de trabalho, worker2
será o segundo etc. Nesse último caso, seria necessário executar o comando (de um
prompt de comando no primário) uma vez para cada máquina no cluster.
Aqui está um exemplo que define a porta no primário ou um servidor autônomo como
8020 para o processo do servidor de aplicativo (wgserver):
tabadmin set worker0.wgserver.port 8020
O exemplo a seguir define a porta para um cluster de 3 máquinas (uma primária e dois
trabalhos) como 9200 para o processo de servidor VizQL.
tabadmin set worker0.vizqlserver.port 9200
tabadmin set worker1.vizqlserver.port 9200
tabadmin set worker2.vizqlserver.port 9200
Você pode usar os parâmetros a seguir para modificar as portas correspondentes —
consulte Portas TCP/IP para obter uma lista completa dos parâmetros tabadmin que
podem ser definidos.
Porta a ser alterada Parâmetro
80
gateway.public.port, worker0.gateway.port
8000
wgserver.port
8060
pgsql.port
8080
solr.port, tomcat.http.port1
9100
vizqlserver.port
9700
dataserver.port
3. Depois que você fizer as alterações de configuração de porta necessárias, reinicie o
Tableau Server digitando o seguinte:
tabadmin restart
1Esses parâmetros devem ser definidos para o mesmo valor.
Enquanto o servidor estiver reiniciando, ele estará indisponível a todos os usuários. Não
se esqueça de avisar os usuários sobre a paralisação antes de executar essa operação
ou agende essa manutenção para ser executada fora de horários comerciais.
Habilitar as portas JMX
Para ajudá-lo a lidar com um problema no Tableau Server, o Suporte do Tableau poderá
solicitar que você habilite as portas JMX do servidor. Essas portas podem ser usadas para o
monitoramento e a solução de problemas, geralmente com uma ferramenta como o JConsole.
Para habilitar as portas JMX no Tableau Server:
1. Interrompa o servidor.
2. Insira o seguinte comando:
tabadmin set service.jmx_enabled true
3. Insira o comando configurar:
tabadmin configure
4. Inicie o servidor.
Lista de portas JMX
Aqui está a lista de portas JMX, todas as quais estão desabilitadas por padrão. Quando
habilitadas, essas portas são usadas para todos os tipos de instalações: servidor único,
distribuído e de alta disponibilidade.
Porta
Usada por este processo do servidor...
Parâmetro
8300 8359
Servidor de aplicativos JMX Determinada pelas portas do
-servidor de aplicativo + 300.
8550
Monitor em segundo plano JMX. Determinado pela porta
em segundo plano de 8250 + 300.
--
9095
Monitor de serviços JMX.
svcmonitor.jmx.port
9400 9499
VizQL Server JMX. Determinada pelas portas do VizQL
Server + 300.
--
10000 10299
Data Server JMX. Determinada pelas portas do servidor
de dados + 300.
--
Como as portas JMX são determinadas
As portas JMX para o servidor de aplicativos (8300 - 8359), o processador em segundo plano
(8550), o VizQL Server (9400 - 9599) e o Data Server (10000 - 10299) são atribuídas com o
uso da fórmula “porta base + 300” (consulte Portas TCP/IP para ver uma lista das portas base
padrão). Além disso, se houver várias instâncias de um processo, cada uma terá uma porta
JMX. Por exemplo, se você configurar o Tableau Server para executar quatro instâncias do
processo do servidor de aplicativos, as portas 8000 (porta base padrão), 8001, 8002 e 8003
são usadas. Em seguida, as portas JMX do servidor de aplicativo 8300 (porta base + 300),
8301, 8302 e 8303 são associadas a suas respectivas instâncias de processo.
Mesmo que não sejam usadas diretamente pelo Tableau Server, se uma porta JMX estiver
sendo usada por outro aplicativo, os processos do Tableau Server não serão executados.
Além disso, as portas JMX não podem ser editadas diretamente com o uso de tabadmin. Você
altera uma porta JMX alterando a porta base para seu processo. Em outras palavras, se a
porta 10000 não estiver disponível para o processo JMX do servidor de dados, você usará
tabadmin (conforme descrito em Editar as portas padrão) para alterar a porta base do servidor
de dados de 9700 para 9800. Isso moverá a porta JMX do servidor de dados para 11000.
Para reduzir os riscos de segurança, é uma boa prática configurar seu firewall para bloquear o
tráfego externo para as portas JMX.
Restaurar o valor padrão para uma porta
Você pode restaurar o valor padrão para uma porta seguindo o procedimento abaixo:
1. Abra um prompt de comando como um administrador e digite o seguinte:
cd “C:\Program Files\Tableau\Tableau Server\8.1\bin”
2. Restaure o valor de porta padrão digitando o seguinte:
tabadmin set <workerX>.<parameter> --default
Se o Tableau Server estiver sendo executado em uma máquina, <workerX> será
worker0. Se você estiver executando um cluster, worker0 será o primário, worker1
será seu primeiro servidor de trabalho, worker2 será o segundo etc.
Vejamos um exemplo:
tabadmin set worker0.wgserver.port --default
3. Reinicie o Tableau Server digitando o seguinte:
tabadmin restart
tabcmd
O utilitário tabcmd é uma das duas ferramentas de linha de comando que são instaladas com o
Tableau Server (a outra é tabadmin). Os comandos fornecidos pelo tabcmd podem ajudar a
automatizar tarefas comuns, como publicar pastas de trabalho em lotes e administrar usuários
e grupos. O utilitário tabcmd é instalado na pasta bin do Tableau Server (C:\Program
Files\Tableau Server\8.1\bin), mas você pode instalar e executar o tabcmd em outro
computador também. Consulte os tópicos abaixo para obter mais informações:
Instalar tabcmd
O utilitário de linha de comando tabcmd é instalado com o Tableau Server por padrão e pode
ser executado com base na pasta bin do servidor (por exemplo, C:\Program
Files\Tableau\Tableau Server\8.1\bin). Para flexibilidade administrativa, ele pode ser instalado
em outro computador também.
Para instalar o tabcmd:
1. Navegue até a pasta extras do Tableau Server:
C:\Program Files\Tableau\Tableau
Server\8.1\extras\TabcmdInstaller.exe
2. Copie TabcmdInstaller.exe no computador onde deseja instalá-lo.
3. Clique duas vezes em TabcmdInstaller.exe para executá-lo.
4. Siga as instruções para instalar o tabcmd.
Como tabcmd é uma ferramenta de linha de comando e, devido a algumas limitações
com o sistema operacional Windows, a Tableau recomenda instalar o tabcmd em uma
pasta chamada tabcmd na raiz de C:\ drive (C:\tabcmd).
Executar o programa de instalação tabcmd não adiciona tabcmd automaticamente à
variável PATH do Windows. Então, é necessário chamar tabcmd explicitamente usando
o caminho completo ou adicionar seu diretório à variável PATH.
Como usar tabcmd
A primeira etapa para usar o tabcmd é abrir um prompt de comando como administrador. Em
seguida, você navega até a pasta bin do Tableau Server (por exemplo, C:\Program
Files\Tableau\Tableau Server\8.1\bin) ou inclui esse local em seus comandos.
Para usar tabcmd para executar tarefas no Tableau Server, estabeleça uma sessão de
servidor autenticada. A sessão identifica o Tableau Server e o usuário do Tableau Server que
está executando a sessão. Você pode iniciar uma sessão primeiro e depois especificar seu
comando em seguida, ou você pode iniciar uma sessão e executar um comando de uma vez.
O comando a seguir demonstra como iniciar uma sessão com o Tableau Server chamada
tabserver.myco.com:
tabcmd login -s http://tabserver.myco.com -u admin -p p@ssw0rd!
Este comando exclui uma pasta de trabalho chamada Sales_Workbook:
tabcmd delete "Sales_Workbook"
Confira aqui como fazer tudo o que foi descrito acima com um comando; observe que não é
preciso usar login aqui:
tabcmd delete "Sales_Workbook" -s http://tabserver.myco.com -u
admin -p p@ssw0rd!
O Tableau Server Não pode executar vários sites. Quando uma pasta de trabalho está no site
Padrão de um servidor de vários sites, não é preciso especificar Padrão, o comando acima é o
suficiente. No entanto, se o comando se aplicar somente a algo em um site diferente do
Padrão, você deverá especificar a ID desse site (consulte login). Este é o mesmo comando
para uma pasta de trabalho que está no site West Coast Sales (ID de site wsales):
tabcmd delete "Sales_Workbook" -s http://tabserver.myco.com -t
wsales -u admin -p p@ssw0rd!
As opções -s, -t, -u e -p estão entre as variáveis globais do tabcmd, o que significa que elas
podem ser usadas com qualquer comando.
Quando o comando for bem-sucedido, tabcmd retornará um código de status de zero. Uma
mensagem de erro completa para códigos de status diferentes de zero é impressa para stderr.
Além disso, as mensagens de progresso ou informativas podem ser impressas para stdout.
Um registro completo chamado tabcmd.log que inclui mensagens de depuração, progresso e
erro é gravado em:
l
l
Windows Server 2012, Windows Server 2008 R2, Windows Vista, Windows 7,
Windows 8: C:\Users\<username>\AppData\Roaming\Tableau
Windows Server 2003: C:\Documents and Settings\<username>\Application
Data\Tableau
Opções globais de tabcmd
A tabela abaixo mostra as opções que são usadas por todos os comandos. As opções -server, --user e --password são exigidas pelo menos uma vez para iniciar a sessão.
Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser
executados sem incluir essas opções. Esse token permanece válido por cinco minutos depois
que o último comando o usou.
Opção Opção
(curta) (longa)
Argumento Descrição
Exibe a ajuda do comando.
-h
--help
-s
--server
Tableau
Server URL
Exigida pelo menos uma vez para iniciar
a sessão.
-u
--user
Tableau
Server
nome de
usuário
Exigida pelo menos uma vez para iniciar
a sessão.
-p
-password
Tableau
Server
Exigida pelo menos uma vez para iniciar
a sessão. Se preferir, você pode usar a
Opção Opção
(curta) (longa)
Argumento Descrição
senha
-P
-password- filename.txt
file
-t
--site
Tableau
Server site
name
-x
--proxy
Host:Port
opção -P.
Permite que a senha seja armazenada
no arquivo fornecido, em vez de na linha
de comando para aumento da
segurança.
Especifica que o comando se aplica ao
site do Tableau Server especificado. Se
você não especificar um site, o site
Padrão será adotado. Aplica-se
somente a servidores com vários sites.
Use o proxy HTTP especificado.
--noprompt
Quando especificada, o comando não
solicitará uma senha. Se nenhuma
senha válida for fornecida, o comando
falhará.
--noproxy
Quando especificada, um proxy HTTP
não será usado.
--nocertcheck
Quando especificada, o certificado SSL
não será validado.
--[no-]
cookie
Quando especificada, a Id da sessão é
salva no logon, para que comandos
subsequentes não precisem fazer
logon. Use o prefixo no- para não
salvar a Id da sessão. Por padrão, a
sessão é salva.
--timeout segundos
Aguarda o número especificado de
segundos para que o servidor conclua o
processamento do comando. Por
padrão, o tempo limite do processo se
esgotará em 30 segundos.
Comandos de tabcmd
Veja os comandos que podem ser usados com a ferramenta de linha de comando tabcmd:
addusers nome do grupo
creategroup nome do grupo
createproject nome do projeto
get url
listsites
login
createsite nome do site
createsiteusers filename.csv
createusers filename.csv
delete workbook-name or datasource-name
deletegroup nome do grupo
deletesite nome do site
deleteusers filename.csv
editsite nome do site
export
logout
publish
filename.twb
(x),
filename.tds
(x), or
filename.tde
refreshextracts
workbookname or
datasourcename
removeusers
nome do grupo
runschedule
nome da
agenda
set
configuração
syncgroup
nome do grupo
version
addusers nome do grupo
Adiciona os usuários listados no argumento --users ao grupo com o nome de grupo
fornecido.
Exemplo
tabcmd addusers "Development" --users "users.csv"
Opção
Opção (longa)
(curta)
--users
Argumento Descrição
Adiciona usuários no arquivo
fornecido ao grupo especificado.
O arquivo deve ser uma lista
simples com um nome de
filename.csv usuário por linha. Os usuários já
devem ter sido criados no
Tableau Server. Consulte
também Importar usuários de
um arquivo CSV.
Opção
Opção (longa)
(curta)
Argumento Descrição
--[no-]complete
Quando definida como
complete, essa opção exige
que todas as linhas sejam
válidas para que qualquer
alteração seja bem-sucedida. Se
não especificada, --complete
será usada.
creategroup nome do grupo
Cria um grupo com o nome do grupo fornecido. Use os comandos addusers (para grupos
locais) e syncgroup (para grupos do Active Directory) para adicionar usuários após a
criação do grupo.
Exemplo
tabcmd creategroup "Development"
createproject nome do projeto
Cria um projeto com o nome do projeto fornecido.
Exemplo
tabcmd createproject -n "Quarterly_Reports" -d "Workbooks showing
quarterly sales reports."
Opção
(curta)
Opção (longa) Argumento Descrição
-n
--name
-d
-descrição
description
nome
createsite nome do site
Cria um site com o nome do site fornecido.
Exemplos
Especifique o nome do projeto
que você deseja criar.
Especifique uma descrição para o
projeto.
Crie um site denominado West Coast Sales. Uma ID de site WestCoastSales será
automaticamente criada, o site não terá limite de cota de armazenamento e os
administradores de site poderão adicionar e remover usuários:
tabcmd createsite "West Coast Sales"
Crie um site denominado West Coast Sales com a ID de site wsales:
tabcmd createsite "West Coast Sales" -r "wcoast"
Impeça que os administradores de site adicionem usuários ao site:
tabcmd createsite "West Coast Sales" --no-site-mode
Defina uma cota de armazenamento, em MB:
tabcmd createsite "West Coast Sales" --storage-quota 100
OpçOpção
ão
(cur- (longa)
ta)
Argumento
Descrição
-r
--url
ID do site
Usada em URLs para especificar o site. Diferente do
nome do site.
-userquota
número de
usuários
Número máximo de usuários que podem ser adicionados
ao site.
-[no-]
sitemode
Permitir ou negar a administradores de site a capacidade
de adicionar usuários ao site ou removê-los.
-storag- número de
eMB
quota
Em MB, a quantidade de pastas de trabalho, extrações e
fontes de dados que podem ser armazenadas no site.
createsiteusers filename.csv
Esse comando permite que administradores de site adicionem usuários a um site. Isso cria
usuários no site atual usando o arquivo csv (valores separados por vírgula) fornecido. O
arquivo pode ter as seguintes colunas, na ordem mostrada abaixo:
1. Username
2. Password
3. Full Name
4. License Level (interactor/viewer/unlicensed)
5. Administrator (site/none)
6. Publisher (yes/true/1 ou no/false/0)
7. Email Address
O arquivo pode ter menos colunas. Por exemplo, ele pode ser uma lista simples com um nome
de usuário por linha. Quando o servidor estiver usando a autenticação do Active Directory, a
coluna Password deverá ser ignorada. As cotações poderão ser usadas se um valor contiver
vírgulas. Consulte Importar usuários de um arquivo CSV para obter outros detalhes.
Exemplo
tabcmd createsiteusers "users.csv" --license "Interactor" -publishers
Opção Opção
(curta) (longa)
Argumento
Descrição
--nowait
Não espera que os trabalhos
assíncronos sejam concluídos.
--silentprogress
Não exibe mensagens de progresso
para trabalhos assíncronos.
--license
--admintype
--[no-]
publishers
Define o nível de licença padrão para
Interactor
todos os usuários. Essa
, Viewer ou
configuração pode ser substituída
Unlicensed
pelo valor no arquivo CSV.
Site ou
None
Atribui ou remove o direito de
administração de site para todos os
usuários no arquivo CSV. Essa
configuração pode ser substituída
pelo valor no arquivo CSV. O padrão
é None para novos usuários e não
alterado para usuários existentes.
Administradores de sistema não
podem ser criados nem rebaixados
usando createsiteusers (use
createusers).
Atribui ou remove o direito de
publicação para todos os usuários no
arquivo CSV, por padrão. Essa
configuração pode ser substituída
pelo valor no arquivo CSV. O padrão
é no para novos usuários e não
Opção Opção
(curta) (longa)
Argumento
Descrição
alterado para usuários existentes.
Exige (ou não) que todas as linhas
sejam válidas para que qualquer
alteração seja bem-sucedida. Por
padrão, é usada a opção -complete.
--[no-]
complete
createusers filename.csv
Cria os usuários listados no arquivo CSV (valores separados por vírgula). Esse comando
pode ser usado somente por administradores de sistema. O arquivo pode ter as seguintes
colunas, na ordem mostrada abaixo:
1. Username
2. Password
3. Full Name
4. License Level (interactor/viewer/unlicensed)
5. Administrator (system/site/none)
6. Publisher (yes/true/1 ou no/false/0)
7. Email Address
O arquivo pode ter menos colunas. Por exemplo, ele pode ser uma lista simples com um nome
de usuário por linha. Quando o servidor estiver usando a autenticação do Active Directory, a
coluna Password deverá ser deixada em branco. As cotações poderão ser usadas se um
valor contiver vírgulas. Consulte Importar usuários de um arquivo CSV para obter mais
detalhes.
Exemplo
tabcmd createusers "users.csv" --license "Interactor" --publisher
Opção Opção
(curta) (longa)
Argumento
Descrição
--nowait
Não espera que os trabalhos
assíncronos sejam concluídos.
--silentprogress
Não exibe mensagens de progresso
para trabalhos assíncronos.
--license Interactor Define o nível de licença padrão para
Opção Opção
(curta) (longa)
Argumento
Descrição
todos os usuários. Essa configuração
, Viewer ou
pode ser substituída pelo valor no
Unlicensed
arquivo CSV.
--admintype
System,
Site ou
None
Atribui ou remove o direito Admin para
todos os usuários no arquivo CSV, por
padrão. Essa configuração pode ser
substituída pelo valor no arquivo CSV.
O padrão é None para novos usuários
e não alterado para usuários
existentes.
--[no-]
publisher
Atribui o direito Publicar a todos os
usuários no arquivo CSV, por padrão.
Essa configuração pode ser
substituída pelo valor no arquivo CSV.
O padrão é no para novos usuários e
não alterado para usuários existentes.
--[no-]
complete
Exige que todas as linhas sejam
válidas para que qualquer alteração
seja bem-sucedida. Por padrão, é
usada a opção --complete.
delete workbook-name or datasource-name
Exclui do servidor a pasta de trabalho ou fonte de dados fornecida. Esse comando captura o
nome da pasta de trabalho ou da fonte de dados como está no servidor, e não o nome do
arquivo quando ele foi publicado.
Exemplo
tabcmd delete "Sales_Analysis"
Opção Opção
(curta) (longa)
-r
Argumento Descrição
Nome do
projeto
O nome do projeto que contém a pasta
de trabalho ou a fonte de dados a ser
excluída. Caso não esteja
especificado, o projeto “Padrão” será
adotado.
--workbook Nome da
O nome da pasta de trabalho que você
--project
Opção Opção
(curta) (longa)
Argumento Descrição
pasta de
trabalho
Nome da
-fonte de
datasource
dados
deseja excluir.
O nome da fonte de dados que você
deseja excluir.
deletegroup nome do grupo
Exclui do servidor o grupo com o nome de grupo fornecido.
Exemplo
tabcmd deletegroup "Development"
deletesite nome do site
Exclui do servidor o site com o nome de site fornecido.
Exemplo
tabcmd deletesite "Development"
deleteusers filename.csv
Exclui os usuários listados no arquivo CSV (valores separados por vírgula) fornecido. O
arquivo é uma lista simples de um nome de usuário por linha.
Exemplo
tabcmd deleteusers "users.csv"
Opção Opção
(curta) (longa)
--[no-]
complete
Argumento Descrição
Quando definida como --complete,
essa opção exige que todas as linhas
sejam válidas para que qualquer
alteração seja bem-sucedida. Se não
especificada, --complete será usada.
editsite nome do site
Permite alterar o nome de um site ou o nome de sua pasta Web. Você também pode usar esse
comando para permitir ou negar a administradores de site a capacidade de adicionar e
remover usuários. Se os administradores de site tiverem direitos de gerenciamento de
usuário, você poderá especificar quantos usuários eles podem adicionar a um site.
Exemplos
tabcmd editsite wc_sales --site-name "West Coast Sales"
tabcmd editsite wc_sales --site-id "wsales"
tabcmd editsite wsales --status ACTIVE
tabcmd editsite wsales --user-quota 50
Opção
(longa)
Argumento
Descrição
--sitename
Nome para o
qual alterar o
site
O nome do site que é exibido.
--siteid
A ID para a
qual alterar o
site
Usada na URLs para identificar o site de forma
exclusiva.
--userquota
Número de
usuários
Número máximo de usuários que podem ser
membros do site.
--[no-]
sitemode
--status
Permitir ou impedir que os administradores de
site adicionem usuários ao site.
ACTIVE ou
Ativar ou suspender um site.
SUSPENDED
-Número de
storageMB
quota
Em MB, a quantidade de pastas de trabalho,
extrações e fontes de dados que podem ser
armazenadas no site.
export
Exporta uma exibição ou pasta de trabalho do Tableau Server e a salva em arquivo. Observe o
seguinte quando for usar esse comando:
l
Permissões: Para exportar, você deve ter a permissão Exportar imagem. Por
padrão, essa permissão é autorizada ou herdada para todas as funções, embora as
permissões possam ser definidas por pasta de trabalho ou exibição.
l
A exibição, a pasta de trabalho ou os dados a serem exportados: Você
especifica isso usando a string "workbook/view" como aparece na URL da pasta de
trabalho ou exibição, e não usando seu “nome amigável”. Por exemplo, para exportar o
exemplo de exibição do Investment Growth da pasta de trabalho Finance, você usaria a
string Finance/InvestmentGrowth. Use -t <site_id> se o servidor estiver
executando vários sites e a exibição ou pasta de trabalho estiver em um site que não
seja o site padrão.
Para exportar a pasta de trabalho, você ainda inclui uma exibição válida na string que
será usada. Usando o exemplo acima, para exportar a pasta de trabalho Finance, você
usaria a string Finance/InvestmentGrowth. Finalmente, para exportar uma pasta
de trabalho, ela deve ter sido publicada com a opção Mostrar planilhas como guias
na caixa de diálogo Publicar do Tableau Desktop.
l
l
l
O formato do arquivo salvo: Suas opções de formato dependem do que está sendo
exportado. Uma pasta de trabalho pode ser exportada somente como um PDF usando
o argumento --fullpdf. Uma exibição pode ser exportada como PDF (--pdf), PNG
(--png), ou você pode exportar os dados da exibição como arquivo CSV (--csv).
O nome e o local do arquivo salvo (opcional): Se você não fornecer um nome, ele
será derivado do nome da exibição ou da pasta de trabalho. Se você não fornecer um
local, o arquivo será salvo em seu diretório de trabalho atual. Caso contrário, você pode
especificar um caminho completo ou um que esteja relacionado ao seu diretório de
trabalho atual.
Objetos de página da Web do painel não incluídos em exportações para PDF:
Um painel também pode conter opcionalmente um objeto de página da Web. Se você
estiver executando uma exportação para PDF de um painel que contém um objeto de
página da Web, esse objeto não será incluído no PDF.
Limpeza do cache para usar dados em tempo real
Opcionalmente, você pode adicionar o parâmetro de URL ?:refresh=yes para forçar uma
consulta de dados atualizados em vez de extrair os resultados do cache. Se você estiver
usando o tabcmd com seu próprio script e o parâmetro de URL refresh estiver sendo muito
usado, isso poderá ter um impacto negativo sobre o desempenho. É recomendável usar
somente refresh quando dados em tempo real são necessários, por exemplo, em um painel
único em vez de uma pasta de trabalho inteira.
Exemplos
Exibições
tabcmd export "Q1Sales/Sales_Report" --csv -f "Weekly-Report"
tabcmd export -t Sales "Sales/Sales_Analysis" --pdf -f
"C:\Tableau_Workbooks\Weekly-Reports"
tabcmd export "Finance/InvestmentGrowth" --png
tabcmd export "Finance/InvestmentGrowth?:refresh=yes" --png
Pastas de trabalho
tabcmd export "Q1Sales/Sales_Report" --fullpdf
tabcmd export -t Sales "Sales/Sales_Analysis" --fullpdf -pagesize tabloid -f "C:\Tableau_Workbooks\Weekly-Reports"
Opção Opção
(curta) (longa)
Argumento
Descrição
-f
Nome para salvar o
arquivo
Salva o arquivo com o
nome de arquivo
fornecido.
--filename
--csv
Somente exibição.
Exporta os dados da
exibição no formato
CSV.
--pdf
Somente exibição.
Exportar como PDF.
--png
Somente exibição.
Exportar como imagem
em formato PNG.
--fullpdf
Somente pasta de
trabalho. Exportar como
PDF. A pasta de
trabalho deve ter sido
publicada com a opção
Mostrar planilhas
como guias habilitada.
-landscape,
pagelayout portrait
Define a orientação da
página do PDF
exportado. Se não
especificada, sua
configuração do Tableau
Desktop será usada.
unspecified,
letter, legal,
note folio,
--pagesize tabloid, ledger,
statement,
executive, a3,
a4, a5, b4, b5,
Define o tamanho da
página do PDF
exportado. O padrão é
letter.
Opção Opção
(curta) (longa)
Argumento
Descrição
quatro
--width
Número de pixels
Define a largura. O
padrão é 800 px.
--height
Número de pixels
Define a altura. O
padrão é 600 px.
get url
Usar uma string URL como um de seus parâmetros gera uma solicitação HTTP “GET” do
Tableau Server. O resultado é retornado como arquivo. Observe o seguinte quando for usar
esse comando:
l
l
l
l
Permissões: Para obter um arquivo, você deve ter a permissão Baixar/salvar na Web
como. Por padrão, essa permissão é autorizada ou herdada para todas as funções,
embora as permissões possam ser definidas por pasta de trabalho ou exibição.
Extensão do arquivo: A cadeia de caracteres de URL do arquivo que você deseja
OBTER deve conter uma extensão de arquivo - como
"/views/Finance/InvestmentGrowth.pdf". A extensão (por exemplo, .pdf)
determina o que será retornado. Uma exibição pode ser retornada em formato PDF,
PNG, CSV (somente dados) ou XML (somente informações). A pasta de trabalho pode
ser retornada como TWB ou TWBX. Para saber a extensão correta a ser usada, você
pode usar um navegador da Web para navegar até o item em que está interessado no
Tableau Server e adicionar a extensão de arquivo ao final da URL.
O nome e o local do arquivo salvo (opcional): O nome que você usa para -filename deve incluir a extensão do arquivo. Se você não fornecer um nome e
extensão de arquivo, ambos serão derivados da string URL. Se você não fornecer um
local, o arquivo será salvo em seu diretório de trabalho atual. Caso contrário, você pode
especificar um caminho completo ou um que esteja relacionado ao seu diretório de
trabalho atual.
Tamanho do PNG (opcional): Se o arquivo salvo estiver em PNG, você poderá
especificar o tamanho, em pixels, na URL.
Limpeza do cache para usar dados em tempo real
Opcionalmente, você pode adicionar o parâmetro de URL ?:refresh=yes para forçar uma
consulta de dados atualizados em vez de extrair os resultados do cache. Se você estiver
usando o tabcmd com seu próprio script e o parâmetro de URL refresh estiver sendo muito
usado, isso poderá ter um impacto negativo sobre o desempenho. É recomendável usar
somente refresh quando dados em tempo real são necessários, por exemplo, em um painel
único em vez de uma pasta de trabalho inteira.
Exemplos
Exibições
tabcmd get "/views/Sales_Analysis/Sales_Report.png" --filename
"Weekly-Report.png"
tabcmd get "/views/Finance/InvestmentGrowth.pdf" -f
"Q1Growth.pdf"
tabcmd get "/views/Finance/InvestmentGrowth.csv"
tabcmd get "/views/Finance/InvestmentGrowth.png?:size=640,480" -f
growth.png
tabcmd get "/views/Finance/InvestmentGrowth.png?:refresh=yes" -f
growth.png
Pastas de trabalho
tabcmd get "/workbooks/Sales_Analysis.twb" -f "C:\Tableau_
Workbooks\Weekly-Reports.twb"
tabcmd get "/workbooks/Sales.xml"
Outros
tabcmd get "/users.xml" --filename "UserList.xml"
Opção
(curta)
Opção
(longa)
-f
-Nome para
filename salvar o arquivo
Argumento
Descrição
Salva o arquivo com o nome de
arquivo fornecido.
listsites
Retorna uma lista de sites aos quais o usuário conectado pertence.
Exemplo
tabcmd listsites -u corman -pw P@ssword!
login
Conecta um usuário do Tableau Server. Use as opções globais --server, --site, -username, --password para criar uma sessão. e desejar fazer logon usando as mesmas
informações já usadas para criar uma sessão, basta especificar a opção --password. Serão
usados o nome de usuário e servidor armazenados no cookie.
Se o servidor estiver usando uma porta diferente de 80 (padrão), você deverá especificá-la.
Você só precisa da opção --site (-t) quando o servidor está executando vários sites e você
está se conectando a um site que não o site Padrão. Se você não fornecer uma senha, uma
será solicitada. Se a opção --no-prompt for especificada e nenhuma senha for fornecida, o
comando falhará.
Após o logon, a sessão continuará até expirar no servidor ou até que o comando logout seja
executado.
Exemplo
Conecta você ao Tableau Server executado em seu computador local:
tabcmd login -s http://localhost -u jsmith -p p@ssw0rd!
tabcmd login -s https://online.tableausoftware.com/t/oursite -u
[email protected] -p p@ssw0rd
Conecta você ao site Sales em sales-server:
tabcmd login -s http://sales-server -t Sales -u administrator -p
p@ssw0rd!
tabcmd login -s http://sales-server:8000 -t Sales -u
administrator -p p@ssw0rd!
Conecta você ao site Sales em sales-server usando SSL:
tabcmd login -s https://sales-server -t Sales -u administrator -p
p@ssw0rd!
Estabelece um proxy avançado e uma porta para localhost:
tabcmd login --proxy myfwdproxyserver:8888 -s http://localhost -u
jsmith -p p@ssW0rd!
Conecta você ao proxy reverso usando SSL:
tabcmd login -s https://myreverseproxy -u jsmith -p p@ssW0rd!
Opção Opção
(curta) (longa)
-s
Argumento Descrição
URL do
--server Tableau
Server
Se você estiver executando o
comando do computador do
Tableau Server, poderá usar
http://localhost. Caso contrário,
especifique a URL do computador,
por exemplo
http://bigbox.myco.com ou
http://bigbox.
Opção Opção
(curta) (longa)
Argumento Descrição
-t
--site
A ID do site. É usada na URL para
identificar o site de forma exclusiva.
Por exemplo, um site denominado
ID do site do West Coast Sales pode ter uma ID
Tableau
de site WestCoastSales. Use esta
Server
opção quando o servidor está
executando vários sites e você está
se conectando a um site que não é o
site padrão.
-u
Tableau
-Server
username nome de
usuário
O nome do usuário do Tableau
Server.
-p
Tableau
-Server
password
senha
Senha para o usuário do Tableau
Server. Se você não fornecer uma
senha, uma será solicitada.
-x
--proxy
Use para especificar o servidor
proxy HTTP e a porta para a
solicitação tabcmd.
--noprompt
Não solicite uma senha. Se
nenhuma senha for especificada, o
comando login falhará.
--noproxy
Não usar um servidor proxy HTTP.
--[no-]
cookie
Salva a ID de sessão no logon. Os
comandos subsequentes não
exigirão logon. Os cookies estão
habilitados (--cookie) por padrão.
-timeout
SECONDS
O número de segundos que o
servidor deve esperar antes de
processar o comando login.
Padrão: 30 segundos.
logout
Faz logout no servidor.
Exemplo
Host:Port
Número de
segundos
tabcmd logout
publish filename.twb(x), filename.tds(x), or filename.tde
Publica a pasta de trabalho (.twb(x)), fonte de dados (.tds(x)) ou extração de dados (.tde)
fornecida no Tableau Server. Por padrão, todas as planilhas na pasta de trabalho são
publicadas sem nomes de usuário ou senhas de banco de dados.
Exemplo
tabcmd publish "analysis.twbx" -n "Sales_Analysis" --db-user
"jsmith" --db-password "p@ssw0rd"
Opção
Opção (longa) Argumento Descrição
(curta)
-n
-o
-r
--name
Nome da
pasta de
trabalho ou
fonte de
dados no
servidor.
Se omitida, a pasta de trabalho,
fonte de dados ou extração de
dados terá o nome do arquivo.
--overwrite
Substitui a pasta de trabalho,
fonte de dados ou extração de
dados se ela já existir no
servidor.
--project
Publica a pasta de trabalho,
fonte de dados ou extração de
dados no projeto especificado.
Publica no projeto “Padrão” se
não for especificado.
Nome de
um projeto
--dbusername
Use essa opção para publicar
um nome de usuário de banco
de dados com a pasta de
trabalho, fonte de dados ou
extração de dados.
--dbpassword
Use essa opção para publicar
uma senha de banco de dados
com a pasta de trabalho, fonte
de dados ou extração de dados.
--save-dbpassword
Armazena a senha de banco de
dados fornecida no servidor.
Opção
Opção (longa) Argumento Descrição
(curta)
-thumbnailusername
Se a pasta de trabalho contiver
filtros de usuários, as miniaturas
serão geradas com base no que
o usuário específico pode ver.
Não pode ser especificada
quando a opção -thumbnail-group é
definida.
-thumbnailgroup
Se a pasta de trabalho contiver
filtros de usuários, as miniaturas
serão geradas com base no que
o grupo específico pode ver.
Não pode ser especificada
quando a opção -thumbnail-username é
definida.
--tabbed
Quando uma pasta de trabalho
com exibições com guias é
publicada, cada planilha tornase uma guia que os
visualizadores podem usar para
navegar pela pasta de trabalho.
Observe que essa configuração
substituirá qualquer segurança
no nível de planilha.
--append
Anexa o arquivo de extração à
fonte de dados existente.
--replace
Usa o arquivo de extração para
substituir a fonte de dados
existente.
--disableuploader
Desabilita o carregador de
arquivos incremental.
--disabletdecompression
Para a compactação do arquivo
de extração antes de ele ser
carregado.
--restart
Reinicia o upload do arquivo.
Se a pasta de trabalho contiver filtros de usuário, uma das opções de miniatura deverá ser
especificada.
refreshextracts workbook-name or datasource-name
Faz uma atualização completa ou incremental de extrações que pertencem à pasta de
trabalho ou fonte de dados especificada. Esse comando captura o nome da pasta de trabalho
ou fonte de dados como ele aparece no servidor, e não o nome do arquivo quando ele foi
publicado.
Exemplos
tabcmd refreshextracts --datasource sales_ds
tabcmd refreshextracts --workbook "My Workbook"
tabcmd refreshextracts --url SalesAnalysis
Opção
Opção (longa) Argumento Descrição
(curta)
-incremental
Executa a operação de atualização
incremental.
-synchronous
Executa a operação de atualização
completa imediatamente no primeiro
plano.
--workbook
Nome de
uma pasta
de trabalho
O nome da pasta de trabalho que
contém extrações para atualização.
Se a pasta de trabalho tiver espaços
no nome, coloque-o entre aspas.
-datasource
Nome de
uma fonte
de dados
O nome da fonte de dados que
contém extrações para atualização.
--project
Nome de
um projeto
Use com --workbook ou -datasource para identificar uma
pasta de trabalho ou fonte de dados
em um projeto que não seja Padrão.
Caso não esteja especificado, o
projeto Padrão será adotado.
--url
Nome de
URL de
uma pasta
de trabalho
O nome da pasta de trabalho
conforme ele aparece na URL. Uma
pasta de trabalho publicada como
“Análise de vendas” tem um nome de
URL denominado “SalesAnalysis”.
removeusers nome do grupo
Remove os usuários listados no argumento --users do grupo com o nome de grupo
fornecido.
Exemplo
tabcmd removeusers "Development" --users "users.csv"
Opção Opção
(curta) (longa)
--users
Argumento Descrição
Remove os usuários no arquivo fornecido
do grupo especificado. O arquivo deve ser
filename.csv
uma lista simples com um nome de
usuário por linha.
--[no-]
complete
Exige que todas as linhas sejam válidas
para que qualquer alteração seja bemsucedida. Se não especificada, -complete será usada.
runschedule nome da agenda
Executa a agenda especificada. Esse comando captura o nome da agenda como está no
servidor.
Exemplo
tabcmd runschedule "5AM Sales Refresh"
set configuração
Habilita a configuração especificada no servidor. Os detalhes sobre cada configuração podem
ser vistos na página Manutenção do servidor. Use um ponto de exclamação em frente ao
nome da configuração para desabilitá-la. É possível habilitar ou desabilitar as seguintes
configurações:
l
embedded_credentials
l
remember_passwords_forever
Exemplo
tabcmd set embedded_credentials
syncgroup nome do grupo
Sincroniza o grupo com o nome de grupo fornecido com o Active Directory. Esse comando
também pode ser usado para criar um novo grupo no servidor que é baseado em um grupo
existente do Active Directory.
Exemplo
tabcmd syncgroup "Development"
Opção
Opção (longa)
(curta)
--license
Argumento
Descrição
viewer
Define o nível de licença para
interactor
todos os usuários no grupo.
unlicensed
-system
administrator site none
Atribui ou remove o direito de
Administrador para todos os
usuários do grupo. O tipo de
usuário Administrador pode ser
de sistema, site ou nenhum. O
padrão é nenhum (novos
usuários não recebem o direito de
Administrador) e os usuários
existentes não são alterados.
--[no-]
publisher
Atribui ou remove o direito
Publicar para todos os usuários
do grupo. Se não especificada,
novos usuários não receberão
esse direito e usuários existentes
não serão alterados.
--[no-]
complete
Exige que todas as linhas sejam
válidas para que qualquer
alteração seja bem-sucedida. Se
não especificada, --complete
será usada.
--silentprogress
Suprime mensagens de
progresso.
versão
Imprime as informações da versão para a instalação atual do utilitário tabcmd.
Exemplo
tabcmd version
tabadmin
Você pode executar certas tarefas administrativas e alterar as configurações do Tableau
Server usando a ferramenta de linha de comando tabadmin. Para acessá-lo, abra um prompt
de comando como um administrador e altere os diretórios usando o comando abaixo:
cd "C:\Program Files\Tableau\Tableau Server\8.1\bin"
Para ver uma lista dos comandos tabadmin disponíveis, digite:
tabadmin help commands
Para obter mais informações, consulte os tópicos abaixo:
tabadmin set
Um dos comandos tabadmin usados com mais frequência é tabadmin set, que permite
alterar o valor das opções de configuração do Tableau Server. A sintaxe é a seguinte:
tabadmin set option-name value
Para usar este comando:
1. Interrompa o servidor.
2. Digite tabadmin set seguido do nome da opção e do valor.
Por exemplo, para alterar o valor padrão da opção tabadmin backgrounder.querylimit
de 7200 segundos (2 horas, o padrão) para 9000 segundos, digite o seguinte:
tabadmin set backgrounder.querylimit 9000
Se você configurar uma opção cujo valor começa com hífen, use aspas aninhadas:
tabadmin set option-name "'-value'"
tabadmin set option-name "'-value1 -value2'"
3. Depois de usar tabadmin set, digite o comando configure:
tabadmin configure
4. Por fim, inicie o Tableau Server.
Opções tabadmin set
Use a tabela abaixo para saber mais sobre as opções do Tableau Server que você pode
configurar usando o comando tabadmin set. Consulte Portas TCP/IP para obter uma lista
completa de portas.
Mostrar
padrão
Descrição
true
Permite acesso às tabelas de auditoria de
histórico PostgreSQL (banco de dados próprio
do Tableau Server). Consulte Criar exibições
administrativas personalizadas para obter
detalhes.
backgrounder.querylimit
7200
Tempo mais longo permitido para concluir uma
atualização de extração, em segundos (7200
segundo = 2 horas).
dataengine.port
27042
Porta em que o mecanismo de dados é
executado.
dataserver.port
9700
Porta em que o data server é executado.
gateway.public.host
Nome do
computador
O nome canônico do servidor, usado para
acesso externo ao Tableau Server. Se o
Tableau Server estiver configurado para
funcionar com um servidor proxy, ele será o
nome canônico do servidor proxy (não
Tableau Server).
gateway.public.port
80 (443 se
SSL)
Aplicável apenas a ambientes de servidor
proxy. A porta externa em que o servidor proxy
escuta.
gateway.timeout
1800
O tempo mais longo, em segundo, que o
gateway aguardará por certos eventos antes
de reprovar uma solicitação (1800 segundos =
30 minutos).
gateway.trusted
O endereço IP Aplicável apenas a ambientes de servidor
do computador proxy. Os endereços IP ou os nomes de host
servidor proxy do servidor proxy.
gateway.trusted_hosts
Nomes
alternativos d
servidor proxy
Aplicável apenas a ambientes de servidor
proxy. Qualquer nome de host alternativo do
servidor proxy.
java.heap.size
128m
Tamanho do heap para Tomcat (repositório e
solr). Isso geralmente não precisa ser
Opção
auditing.enabled
Opção
Mostrar
padrão
Descrição
alterado, exceto por recomendação da
Tableau.
pgsql.port
8060
Porta na qual o PostgreSQL escuta.
600
O tempo mais longo permitido, em segundos,
para concluir a sincronização de arquivos (600
segundos = 10 minutos). A sincronização de
arquivos ocorre como parte da configuração
da alta disponibilidade ou de processos para
mover o mecanismo de dados e o repositório.
service.jmx_enabled
falso
Configurar como true permite às portas JMX
o monitoramento opcional e a resolução de
problemas. Consulte Habilitar as portas JMX
para obter detalhes.
service.max_procs
Nº de
processos
Número máximo de processos do servidor.
subscriptions.enabled
falso
Controla se as assinaturas são configuráveis
em todo o sistema. Consulte Gerenciar
assinaturas.
subscriptions.timeout
1800
Número de segundos após o qual o processo
em segundo plano que manipula uma
assinatura atinge o tempo limite.
solr.port
8080
Porta na qual solr escuta. Dever ter o mesmo
valor de tomcat.http.port.
tomcat.http.port
8080
Porta na qual Tomcat é executado.
tomcat.https.port
8443
Porta SSL para Tomcat (não utilizada).
tomcat.server.port
8085
Portal na qual tomcat escuta mensagens de
desligamento.
rsync.timeout
vizqlserver.browser.render true
As exibições abaixo do limite definido por
vizqlserver.browser.render_
threshold ou
vizqlserver.browser.render_
threshold_mobile são renderizadas pelo
navegador da web do cliente e não pelo
servidor. Consulte Sobre a renderização do
lado do cliente para obter detalhes.
vizqlserver.browser.rende100
r_threshold
O valor padrão (100) representa um alto nível
de complexidade para uma exibição mostrada
Opção
Mostrar
padrão
Descrição
em um computador. Fatores de complexidade
incluem o número de marcas, cabeçalhos,
linhas de referência e anotações. As exibições
que excedem esse nível de complexidade são
renderizadas pelo servidor e não no
navegador da web do computador.
vizqlserver.browser.rende20
r_threshold_mobile
O valor padrão (20) representa um alto nível
de complexidade para uma exibição mostrada
em um tablet. Fatores de complexidade
incluem o número de marcas, cabeçalhos,
linhas de referência e anotações. As exibições
que excedem esse nível de complexidade são
renderizadas pelo servidor e não no
navegador da web do tablet.
vizqlserver.port
9100
Porta base para os servidores VizQL.
vizqlserver.protect_
sessions
true
Quando definido como true (o padrão),
impede que sessões VizQL sejam reutilizadas
após a saída do usuário original.
vizqlserver.querylimit
1800
Tempo mais longo permitido para atualizar
uma exibição, em segundos.
Especifica um host Rserve. Esta configuração
e as três configurações logo abaixo dão
suporte à funcionalidade R em pastas de
trabalho. R é uma linguagem de programação
de software com código-fonte aberto e um
ambiente de software para computação
estatística e gráficos. No Tableau Desktop,
você pode usar um conjunto de quatro funções
a fim de passar expressões R para um
servidor Rserve e obter um resultado. Caso
carregue uma pasta de trabalho que use
qualquer uma dessas funções, você deve
configurar o Tableau Server para uma
conexão Rserve definindo essa opção e as
três seguintes. Do contrário, todas as planilhas
que usam a funcionalidade R estarão
indisponíveis. Consulte Conexão R na ajuda
do Tableau Desktop para ver mais detalhes.
vizqlserver.rserve.host
vizqlserver.rserve.port
6311
Especifica uma porta de Rserve. Esta
configuração dá suporte à funcionalidade R
Opção
Mostrar
padrão
Descrição
em pastas de trabalho.
vizqlserver.rserve.username
Especifica um nome de usuário de Rserve.
Esta configuração dá suporte à funcionalidade
R em pastas de trabalho.Nem todos os hosts
Rserve exigem um nome de usuário e uma
senha.
vizqlserver.rserve.password
Especifica uma senha de Rserve. Esta
configuração dá suporte à funcionalidade R
em pastas de trabalho.Nem todos os hosts
Rserve exigem um nome de usuário e uma
senha.
vizqlserver.session.expiry.5
minimum
Número de minutos de tempo de inatividade
após o qual uma sessão VizQL poderá ser
descartada se o processo VizQL começar a
ficar sem memória suficiente.
vizqlserver.session.expiry.t30
imeout
Número de minutos do tempo ocioso após o
qual uma sessão VizQL é descartada.
vizqlserver.showdownload true
Controla a exibição do botão Baixar acima das
exibições.
vizqlserver.showshare
Controla a exibição do botão Compartilhar
acima das exibições.
true
vizqlserver.trustedticket.loinfo
g_level
O nível de registro da autenticação confiável,
gravado em
ProgramData\Tableau\Tableau
Server\data\tabsvc\logs\vizqlserver\vizql-*.log. Defina para debug
para obter mais informações.
vizqlserver.trustedticket.tok24
en_length
Determina o número de caracteres em cada
ticket confiável. A configuração padrão de 24
caracteres fornece 144 bits de aleatório. O
valor pode ser definido como qualquer inteiro
entre 9 e 255, inclusive.
vizqlserver.trustedticket.use_deprecated_9digit_
falso
token
Quando definido como true, os tickets têm 9
dígitos (como na versão 8.0 e anterior) e a
configuração
vizqlserver.trustedticket.token_
length é ignorada.
wgserver.audit_history_
Número de dias após o qual os registros de
183
Opção
Mostrar
padrão
Descrição
eventos de histórico são removidos do banco
de dados PostgreSQL (banco de dados
próprio do Tableau Server). Consulte Criar
exibições administrativas personalizadas para
obter detalhes.
expiration_days
wgserver.domain.fqdn
valor de
O nome de domínio totalmente qualificado do
%USERDOMservidor Active Directory a ser usado.
AIN%
wgserver.password_
autocomplete.enabled
falso
Controla se os navegadores da web podem
preencher campos de senhas
automaticamente.
wgserver.session.idle_limit 240
O número de minutos de tempo ocioso até
uma entrada no aplicativo web atingir o tempo
limite.
wgserver.trusted_hosts
Esta opção usa uma lista separada por
vírgulas de endereços IP ou nomes de host
confiáveis para o computador do qual você
deseja aceitar solicitações confiáveis. Um
valor comum é 127.0.0.1, caso você queira
colocar o servidor Web e o Tableau Server no
mesmo computador. Essa opção é usada na
configuração de uma relação confiável entre o
servidor Web e o Tableau Server na inserção
de exibições.
workerX.gateway.port
80 (443 se
SSL)
A porta externa em que o Apache escuta para
workerX. worker0.gateway.port é a porta
externa do Tableau Server. Em um ambiente
distribuído, worker0 é o Tableau Server
primário.
workerX.vizqlserver.procs
Nº de
processos
Número de servidores VizQL.
workerX.vizqlserver.port
9100
Porta base para o vizQL Server em workerX.
workerX.wgserver.port
8000
Porta base para os servidores de aplicativo
web em workerX.
workerX.wgserver.procs
Nº de
Número de processos do servidor de
processadores aplicativos Web.
Restaurar o valor padrão de uma configuração
Você pode restaurar o valor padrão para uma configuração do Tableau Server fazendo o
seguinte:
1. Interrompa o servidor.
2. Ainda no diretório Bin, restaure o valor padrão para uma configuração específica
digitando o seguinte:
tabadmin set option-name --default
Por exemplo, para definir a opção vizqlserver.session.expiry.timeout de tabadmin de
volta para seu valor padrão de 30 minutos, digite o seguinte:
tabadmin set vizqlserver.session.expiry.timeout --default
Opcionalmente, você pode usar o comando mais curto -d. Por exemplo:
tabadmin set vizqlserver.querylimit -d
3. Em seguida, execute o comando de configuração:
tabadmin configure
4. Inicie o servidor.
tabadmin stop
Para usar o tabadmin para interromper o Tableau Server:
1. Abra um prompt de comando como um administrador:
2. Digite o seguinte:
cd "C:\Program Files\Tableau\Tableau Server\8.1\bin"
3. Digite o seguinte para interromper o servidor:
tabadmin stop
tabadmin start
Para usar o tabadmin para iniciar o Tableau Server:
1. Abra um prompt de comando como um administrador:
2. Digite o seguinte:
cd "C:\Program Files\Tableau\Tableau Server\8.1\bin"
3. Digite o seguinte para iniciar o servidor:
tabadmin start
Manutenção do banco de dados
Você pode usar a ferramenta de linha de comando tabadmin para fazer backup e restaurar
seus dados do Tableau. Os dados do Tableau incluem seu próprio banco de dados
PostgreSQL do Tableau Server, que armazena metadados da pasta de trabalho e do usuário,
arquivos de extração de dados (.tde) e dados de configuração do servidor. Para automatizar o
backup desses dados, é possível usar os comandos descritos nos tópicos abaixo, juntamente
com o agendador de tarefas interno do Windows.
Fazer backup do banco de dados do Tableau
É importante fazer backup dos dados do Tableau para poder restaurar exibições publicadas e
outras informações em caso de falha do sistema. Os dados gerenciados pelo Tableau Server
consistem no próprio banco de dados PostgreSQL do Tableau, que contém metadados da
pasta de trabalho e do usuário, arquivos de extração de dados (.tde) e dados de configuração.
Quando você cria um backup, tudo isso é colocado em um único arquivo criado com a
extensão .tsbak. Caso você esteja executando uma instalação distribuída do Tableau Server,
esta etapa é realizada no computador primário, mesmo que o processador de dados, que
identifica os arquivos .tde, esteja em um computador de trabalho. Como ele pode ser um
backup efetivo para você, não se esqueça de armazenar o .tsbak em um computador fora do
host de seu Tableau Server.
Você pode criar um arquivo .tsbak usando o procedimento abaixo. Desinstalar o Tableau, que
é a primeira etapa para atualizar para uma nova versão, também cria automaticamente um
arquivo .tsbak. Esse mesmo arquivo .tsbak é usado para migrar seus dados para a versão
mais recente.
Executar o comando backup também remove os arquivos de registro do Tableau
Server anteriores a sete dias, bem como algumas das informações exibidas em
determinado Exibições administrativas do Tableau Server.
1. Abra um prompt de comando como um administrador e digite o seguinte:
cd "C:\Program Files\Tableau\Tableau Server\8.1\bin"
2. Crie um arquivo de backup digitando tabadmin backup <filename>, em que
<filename> é o nome ou o local e o nome de seu arquivo de backup. Não há
necessidade de parar o servidor antes de criar o backup. Por exemplo:
tabadmin backup tabserver
ou
tabadmin backup C:\backups\tableau\tabserver
Opcionalmente, você também pode usar -d para anexar a data atual ao nome do
arquivo e -t, seguido de um caminho, para especificar um local para arquivos
temporários que você criou durante o processo de backup. Por exemplo:
tabadmin backup tabserver -d -t C:\mytemp\tableau
Restaurar um backup
Quando você faz uma restauração, o conteúdo do banco de dados PostgreSQL do Tableau,
as extrações de dados e os arquivos de configuração são substituídos pelo conteúdo do
arquivo de backup (.tsbak). Se você está executando uma instalação distribuída do Tableau
Server, esta etapa é executada no computador primário.
Para restaurar usando um arquivo de backup de banco de dados:
1. Interrompa o servidor digitando:
tabadmin stop
2. Restaure o banco de dados de um arquivo de backup digitando:
tabadmin restore <filename>
Na linha acima, substitua <filename> pelo nome do arquivo de backup que deseja
usar para fazer a restauração.
Para restaurar apenas os dados e nenhuma definição de configuração, digite o
seguinte:
tabadmin restore --no-config <filename>
3.
Reinicie os processos do Tableau Server digitando:
tabadmin start
Recuperar extrações de um backup
O arquivo uninstall-<version>.tsbak (por exemplo, uninstall-8.0.tsbak) é criado como parte do
processo de desinstalação. Depois de atualizar para a versão 8.1, você poderá usar esse
arquivo para restaurar extrações de dados — por exemplo, se você excluiu a pasta dataengine
por engano durante a atualização. Para usar uninstall-<version>.tsbak para restaurar
extrações de dados:
1. Interrompa o servidor.
2. De dentro do seu diretório bin do Tableau Server versão 8.1 , digite o seguinte:
Windows Server 2012, Windows Server 2008, Windows Vista, Windows 7, Windows 8:
tabadmin restore \ProgramData\Tableau\Tableau
Server\uninstall-8.0.tsbak
Tableau Server 32 bits instalado no Windows Server 2003 64 bits: tabadmin
restore \Program Files (x86)\Tableau\Tableau
Server\uninstall-8.0.tsbak
Tableau Server 32 bits instalado no Windows Server 2003 32 bits: tabadmin
restore \Program Files\Tableau\Tableau Server\uninstall8.0.tsbak
Solução de problemas
Use os tópicos a seguir para solucionar problemas que você possa estar enfrentando com o
Tableau Server. Para obter dicas de solução de problemas de autenticação confiável, consulte
Solucionar problemas de autenticação confiável.
Registros e arquivos temporários
O Tableau Service gera vários registros e arquivos temporários que podem ajudar a entender
e rastrear a atividade recente, bem como depurar qualquer problema que possa surgir. Se
precisar salvar espaço na unidade de disco rígido, de vez em quando, você pode excluir esses
arquivos.
Use os tópicos a seguir para saber onde os arquivos de registro estão localizados, sua
finalidade, como arquivá-los e como salvar espaço executando o comando de limpeza.
Locais do arquivo de registro
Os arquivos de registro do Tableau Server podem ser encontrados nas seguintes pastas:
Registros de serviço do Tableau
Os arquivos de registro a seguir rastreiam atividades relacionadas ao aplicativo Web, banco
de dados e índice.
C:\ProgramData\Tableau\Tableau Server\data\tabsvc
Registros do VizQL
Esses arquivos de registro rastreiam atividades relacionadas à visualização de exibições,
como consulta no banco de dados e geração de imagens:
C:\ProgramData\Tableau\Tableau
Server\data\tabsvc\vizqlserver\Logs
Arquivos temporários
Todos os arquivos que começam com exe_ in na pasta abaixo é um arquivo do Tableau
Server e pode ser excluído.
C:\ProgramData\Tableau\Tableau Server\temp
Arquivar arquivos de registro
É possível arquivar arquivos de registro do Tableau Server usando o comando ziplogs. Esse
comando cria um arquivo zip contendo todos os arquivos de registro e é útil quando você está
trabalhando com o Suporte do Tableau. O comando ziplogs não remove os arquivos de
registro, mas os copia em um arquivo zip. Se você está executando uma instalação distribuída
do Tableau Server, esta etapa é executada no computador primário. Qualquer log de trabalho
será incluído no arquivo zip.
1. Abra um prompt de comando como administrador e navegue para o diretório bin do
Tableau Server. Por exemplo:
cd "C:\Program Files\Tableau\Tableau Server\8.1\bin"
2. Interrompa o Tableau Server digitando:
tabadmin stop
3. Crie o arquivo zip digitando tabadmin ziplogs -l -n <filename> onde
<filename> é o nome do arquivo zipado que você deseja criar. Escolha um nome
exclusivo sem espaços. O Tableau não substituirá um arquivo existente. Por exemplo:
tabadmin ziplogs -l -n my_logs
Se você não especificar um nome de arquivo, o arquivo será denominado logs.zip.
Também é possível usar -d mm/dd/yyyy para incluir apenas registros gerados
desde uma determinada data. Por exemplo:
tabadmin ziplogs -l -n -d 02/14/2013
O comando acima cria um arquivo compactado denominado logs.zip que inclui
registros datados de 14 de fevereiro de 2013 até a data atual; os registros mais antigos
são excluídos. A opção -n captura informações sobre o ambiente de servidor, incluindo
quais portas estão em uso. Para ver uma lista de todas as opções de ziplogs, digite
tabadmin ziplogs -h.
4. Reinicie o Tableau Server digitando:
tabadmin restart
Você pode encontrar o arquivo de registro compactado no diretório bin do Tableau
Server.
Remover arquivos de registro
O comando cleanup remove os registros de processo e as entradas de tabela HTTP do
Tableau Server anteriores a sete dias para economizar espaço. Isso afetará algumas das
informações apresentadas no Exibições administrativas Tableau Server.
l
Em um prompt de comando, digite:
tabadmin cleanup --restart
Em geral, você deve desligar o servidor antes de executar esse comando. No
entanto, se o servidor estiver em execução, você deverá incluir a opção -restart para garantir uma limpeza e restauração bem-sucedidas.
Manipular um servidor não licenciado
O Tableau oferece dois modelos de licenciamento: baseado em usuário e baseado em núcleo.
O licenciamento baseado em usuário exige que cada conta de usuário ativa seja coberta por
uma licença. As licenças baseadas em usuário têm uma capacidade definida ou número de
usuários que ela permite. Cada usuário tem um nome de usuário exclusivo atribuído a ele no
servidor e é exigido para identificar a si mesmo quando conectado ao servidor. O software
pode ser instalado em um computador único ou distribuído pelo número de computadores em
um ambiente de servidor distribuído.
O licenciamento baseado em núcleo não tem restrições quanto ao número de contas de
usuário no sistema, mas ele não restringe o número máximo de núcleos de processador que o
Tableau Server pode usar. Você pode instalar o servidor em um ou mais computadores para
criar um cluster, com as restrições de que o número total de núcleos em todos os
computadores não exceda o número de núcleos que você licenciou e que todos os núcleos em
um computador específico sejam cobertos pela licença.
Servidor baseado em usuário não licenciado
O motivo mais comum para que um servidor que tenha licenciamento baseado em usuário
tenha sua licença cancelada é uma chave de produto expirada ou um contrato de manutenção
expirado. Você pode ver suas chaves de produto e adicionar novas selecionando Iniciar >
Todos os programas > Tableau Server > Gerenciar chaves de produto.
Servidor baseado em núcleo não licenciado
Um servidor baseado em núcleo pode se tornar não licenciado por vários motivos. Um
problema comum é que o computador primário ou de trabalho tenha mais núcleos do que a
licença permite. Quando o servidor for não licenciado, você não poderá iniciar nem administrar
o servidor. No entanto, é possível gerenciar licenças usando a ferramenta de linha de
comando tabadmin. Siga as etapas abaixo para ver uma lista de suas licenças e o número de
núcleos por computador.
1. Abra um prompt de comando e digite o seguinte: cd C:\Program
Files\Tableau\Tableau Server\8.1\bin
2. Digite o seguinte: tabadmin licenses.
Manipular um processo do VizQL Server não licenciado
Há vários indicadores de status na página Manutenção do Tableau Server que o ajudam a
compreender o estado dos processos do Tableau Server. Uma caixa de status laranja, "Não
licenciado", indica que um dos processos de VizQL Server não pode recuperar informações de
licença do Tableau Server.
Vários motivos podem levar o processo a não acessar essas informações. Por exemplo, talvez
existam questões de rede impedindo que um processo VizQL, em execução em um
computador de trabalho, se comunique com o computador primário. Também é possível que o
processo esteja recebendo mais solicitações do que pode aceitar naquele momento e, assim,
não consiga lidar com a solicitação de licenciamento. Como resultado, alguns dos usuários
talvez consigam acessar exibições, enquanto outros não.
Para resolver o problema, interrompa e, depois, inicie o Tableau Server.
Erro de falta de memória do VizQL
Em versões de 32 bits do Tableau Server, caso um processo VizQL alcance seu limite de
sessões de exibição simultânea, você pode ver um erro ‘Falta de memória’, que também será
gravado nos logs vizqlserver*.txt localizados aqui:
C:\ProgramData\Tableau\Tableau
Server\data\tabsvc\vizqlserver\Logs
O processo VizQL não é encerrado quando esse erro ocorre, mas ele não aceitará conexões
adicionais. É possível resolver esse problema fazendo o seguinte:
l
l
l
Atualização para a versão de 64 bits do Tableau Server: Consulte upgrade.htm
para ver detalhes.
Aumentando o número de processos VizQL: Isso pode significar que você precisa
adicionar um ou mais trabalhos. Consulte Instalar e configurar servidores de trabalho
para saber como fazer isso.
Editar vizqlserver.session.expiry.timeout: Use tabadmin para alterar a
configuração vizqlserver.session.expiry.timeout de seu padrão (30 minutos) para um
período de tempo mais curto de 10 ou 5 minutos. Isso permitirá que sessões ociosas
expirem mais rápido, liberando memória para novas sessões.
Erro de restrição de cookie
Quando um usuário entra no Tableau Server, um cookie de sessão é armazenado em seu
navegador local. O cookie armazenado é a forma como o Tableau Server mantém que o
usuário que entrou foi autenticado e pode acessar o servidor. Como o cookie é definido com o
mesmo domínio ou subdomínio que a barra de endereços do navegador, ele é considerado
um cookie primário. Se o navegador de um usuário estiver configurado para bloquear cookies
primários, ele não conseguirá entrar no Tableau Server.
Quando um usuário entra no Tableau Server por meio de uma exibição inserida, ou em um
ambiente em que a autenticação confiável tenha sido configurada, o mesmo acontece: um
cookie é armazenado. Nesse caso, entretanto, o navegador trata o cookie como um cookie de
terceiros. Isso acontece porque o cookie é definido com um domínio que é diferente daquele
mostrado na barra de endereços do navegador. Se o navegador da web do usuário estiver
configurado para bloquear cookies de terceiros, a autenticação no Tableau Server falhará.
Para evitar que isso ocorra, os navegadores da web devem ser configurados para permitir
cookies de terceiros.
Solucionar problemas de fontes de dados
Para que os usuários trabalhem com as fontes de dados do Tableau Server, até três itens
precisa ser definidos:
l
l
l
Permissões para a fonte de dados: Qualquer pessoa que for se conectar a uma
fonte de dados deve ter as permissões Conectar e Exibir para essa fonte. Isso
também se aplica a usuários que acessam exibições que se conectam a fontes de
dados. Qualquer pessoa que esteja publicando e modificando fontes de dados deve
estar licenciada para Publicar e também ter as permissões Baixar/salvar na Web
como e Baixar/salvar na Web como. Consulte Trabalhar com permissões e Definir
permissões para uma fonte de dados para obter mais informações.
Capacidade de autenticação no banco de dados: Há várias maneiras de se
conectar aos dados no Tableau e controlar quem tem acesso a quê. Basicamente,
qualquer entidade que esteja se conectando ao banco de dados deve ser capaz de se
autenticar. A entidade pode ser o Tableau Server executando uma atualização de
extração. Pode ser um usuário do Tableau Desktop se conectando a uma fonte de
dados que então se conecta a um banco de dados dinâmico. Também pode ser um
usuário do Tableau Server que está acessando uma exibição que se conecta a um
banco dedados ativo. Consulte Segurança de dados para saber mais sobre suas
opções.
Drivers de banco de dados: Se a pessoa que criou e publicou a fonte de dados no
Tableau Desktop precisou instalar drivers de bancos de dados adicionais, talvez você
precise instalá-los também no Tableau Server. Se você estiver executando uma
instalação distribuída do Tableau Server onde, por exemplo, o processo do data server
está sendo executado em um servidor de trabalho, todos os drivers de banco de dados
necessários devem ser instalados nesse servidor, bem como no servidor primário.
Outros processos também requerem drivers. Consulte Drivers de banco de dados para
obter mais informações.
Mensagens de erro da fonte de dados
Veja aqui alguns erros que os autores da pasta de trabalho e outros usuários podem encontrar
enquanto trabalham com fontes de dados e exibições:
A permissão para acessar esta fonte de dados do Tableau Server foi negada: A
conexão com uma fonte de dados exige a permissão Conectar. Consulte Trabalhar com
permissões e Definir permissões para uma fonte de dados para obter mais informações.
Fonte de dados não encontrada: Alguém que estiver trabalhando com uma exibição
poderá ver esse erro se uma fonte de dados for removida do Tableau Server ou se a página
Conectar a dados precisar ser atualizada. Para atualizar a página Conectar a dados no
Tableau Desktop, clique no ícone Atualizar:
Não é possível conectar a esta fonte de dados do Tableau Server: Esse erro pode
aparecer se as informações de conexão para a fonte de dados forem alteradas, por exemplo,
em resultado da alteração do nome do servidor de banco de dados. Observe as informações
de Conexão de dados da fonte de dados e verifique se as configurações estão corretas.
Não é possível listar fontes de dados do Tableau Server: Esse erro poderá ocorrer se
um usuário estiver tentando acessar as fontes de dados do Tableau Server e houver
problemas de conectividade entre o Tableau Server e o Tableau Desktop.
Não é possível conectar a uma fonte de dados de cubo: Não há suporte de conexões a
fontes de dados de cubos (como MSAS). Os dados precisam ser uma extração ou uma
conexão ativa a um banco de dados relacional.
Solucionar problemas de assinaturas
"O instantâneo da exibição neste email não pôde ser renderizado adequadamente."
Se você receber uma assinatura com essa mensagem de erro, poderá ser por vários motivos:
l
l
l
Credenciais ausentes: Algumas exibições são publicadas com credenciais inseridas.
Você pode receber o erro acima se as credenciais inseridas estiverem desatualizadas,
ou se a exibição foi publicada novamente sem as credenciais inseridas.
Banco de dados temporariamente inativo: Se a exibição tiver uma conexão de
banco de dados ativa, e o banco de dados estava temporariamente inativo quando a
assinatura era gerada, você poderá receber o erro acima.
Tempo limite de processo em segundo plano: Por padrão, o processo em segundo
plano que administra as assinaturas tem seu tempo esgotado após 30 minutos. Na
maioria dos casos, isso é muito tempo. Entretanto, se o processo em segundo plano
estiver manipulando um painel extremamente grande e complexo, esse tempo talvez
não seja suficiente. Você poderá verificar a exibição do administrador Tarefas em
segundo plano para ver se é esse o caso. Para aumentar o tempo limite, use a opção
tabadmin subscriptions.timeout.
Não é possível assinar
Se você puder ver uma exibição ou pasta de trabalho no Tableau Server e ela tiver um ícone
de assinatura ( ) no canto superior direito, você poderá assiná-la.
Dois fatores precisam estar presentes para você assinar uma exibição: O Tableau Server
precisa estar configurado corretamente (descrito em Gerenciar assinaturas) e a exibição que
você está assinando deve ter credenciais inseridas para sua fonte de dados ou não usar
credenciais. Exemplos do último item são uma pasta de trabalho que se conecta a uma
extração que não está sendo atualizada, ou uma pasta de trabalho cujos dados estão em um
arquivo fornecido com a pasta de trabalho no momento da publicação. Inserir credenciais é
uma etapa que acontece no Tableau Desktop (consulte a ajuda do Tableau Desktop para
obter os detalhes).
Sem ícone de assinatura
É possível ver uma exibição no Tableau Server, mas não é possível assiná-la. Isso acontece
para exibições com conexões de banco de dados ativas, onde você é solicitado a fornecer as
credenciais do banco de dados ao clicar pela primeira vez na exibição. Uma assinatura inclui
uma exibição (ou pasta de trabalho), dados ou uma agenda. Para fornecer os dados, o
Tableau Server precisa das credenciais do banco de dados inseridas ou de dados que não
exigem credenciais. Em relação às conexões de bancos de dados ativas, o Tableau Server
não tem as credenciais, somente os usuários individuais têm. É por isso que você só pode
assinar exibições que não exigem credenciais ou as têm inseridas.
Você também pode ver uma exibição, mas não poder assiná-la (sem ícone de assinatura) se o
Tableau Server estiver configurado para a autenticação confiável. Consulte Requisitos de
assinatura para obter mais informações.
Recebimento de assinaturas inválidas ou "corrompidas"
Se você configurou assinaturas nas instâncias de teste ou desenvolvimento do Tableau
Server além de sua instância de produção, desabilite as assinaturas nas instâncias que não
são de produção. Manter as assinaturas habilitadas em todas as instâncias pode resultar em
seus usuários recebendo assinaturas que parecem ser válidas, mas não funcionam, ou
recebendo assinaturas mesmo que eles as tenham cancelado na exibição ou pasta de
trabalho.
As assinaturas não chegam ("Erro no envio de e-mail. Não é possível enviar o
comando para o host SMTP.")
Você pode ver o erro acima no Visualizador de Eventos do Windows se as assinaturas
aparecerem como enviadas (de acordo com a exibição de administração Tarefas em segundo
plano), mas não estiverem chegando, e seu servidor SMTP estiver usando sessões
criptografadas (SSL). Assinaturas são aceitas somente para conexões SMTP não
criptografadas. A solução é usar um servidor SMTP não criptografado.
Solução de problemas do SAML
Use os tópicos a seguir para solucionar problemas do SAML.
SAML e habilitar logon automático
Caso você esteja usando SAML e o Tableau Server também esteja configurado para usar o
Active Directory, não selecione também Habilitar logon automático. Habilitar logon
automático e SAML não podem ser usados.
Falha no logon
Caso você receba a mensagem "Falha no logon: Autenticação do Provedor de identidade
bem-sucedida para o usuário <username from IdP>. Falha ao encontrar o usuário no Tableau
Server." Os nomes de usuário conforme armazenados no Tableau Server e conforme
armazenados em seu IdP não são idênticos. Para corrigir isso, verifique se eles são iguais. Por
exemplo, se o nome de usuário de Jane Silva estiver armazenado no IdP como jsmith, ele
deverá ser armazenado no Tableau Server como jsmith.
Log de erros do SAML
Os erros de entrada do SAML são registrados no local a seguir. Você pode usar esse log para
solucionar problemas.
C:\ProgramData\Tableau\Tableau
Server\data\tabsvc\logs\wgserver\error.log
Identificar alertas de atualização da extração
Caso as atualizações de extração não tenham sido bem-sucedidas, o Tableau exibe um menu
Alertas no canto inferior direito:
Você só verá o menu Alertas se houver uma falha na atualização da extração e você estiver:
l
Um administrador de sistema ou do site.
l
Não foi possível atualizar o autor da pasta de trabalho ou da fonte de dados.
l
Não foi possível atualizar o autor de uma pasta de trabalho que se conecta a uma fonte
de dados.
Ao abrir o menu Alertas, você pode ver mais informações sobre as falhas de atualização:
Quando uma Fonte de dados é listada como Inserida isso significa que a definição da fonte
de dados (que inclui coisas como as credenciais da fonte de dados ou o nome do banco de
dados) está inserida ou reside dentro da própria pasta de trabalho. Isso também significa que
o problema deve ser corrigido no Tableau Desktop. Por exemplo, a fonte do problema pode
ser que as credenciais precisem ser inseridas na pasta de trabalho.
Quando o nome de uma fonte de dados ou de uma pasta de trabalho é listado como a Fonte
de dados (por exemplo, Fonte de dados: sales_data), significa que a fonte de dados é uma
Fonte de dados do Tableau Server. A definição da fonte de dados reside no Tableau Server.
Quando a pasta de trabalho ou a fonte de dados foi originalmente criada no Tableau Desktop,
um ícone do Tableau, e não um ícone de banco de dados, era exibido próximo à fonte de
dados, na janela Dados:
Às vezes, você pode corrigir um problema de atualização de extração clicando em Editar
informações da conexão, inserindo informações não encontradas e clicando em Salvar:
JavaScript API
With Tableau's JavaScript API you can integrate Tableau visualizations into your own web
applications. The API lets you tightly control your users' interactions and combine functionality
that otherwise couldn't be combined. For example, you can code a single control that filters a
group of marks, selects some of those marks, and presents their data for download. See the
topics below for details:
l
Requirements
l
Concepts
l
Tutorial
l
API Reference
Requirements
The requirements for Tableau's JavaScript API are as follows:
Tableau Server: To program with Tableau's JavaScript API you need Tableau Server,
version 8.1 or higher. The API is powered by the file tableau_v8.js, which is located in the
following folder: Program Files\Tableau\Tableau
Server\8.1\wgserver\public\javascripts\api. Your web application shouldn't
be on the same computer as Tableau Server, but it needs to be able to access it.
Supported browsers: Your end-users can experience the web application you create in most
supported web browsers, specifically: Chrome, Firefox, Safari 3.2.1 and higher, and Internet
Explorer 8.0 and higher. If you are using Internet Explorer 8.0, it must have compatability mode
disabled.
Concepts
This topic is designed for people familiar with JavaScript and object-oriented programming
concepts. You should also be familiar with Tableau visualizations from a user's point of view. If
you are just getting started, a good place to begin is the Tutorial.
Programming Approach
Tableau's JavaScript API uses an object model. The entry point into the object model is to
instantiate a new Viz object as follows:
var viz = new tableauSoftware.Viz(/* params omitted */);
Nearly every Tableau object allows you to navigate back to its parent Viz object by way of
"parent" properties on the object.
Accessing the API
The API is about programmatically controlling views embedded from Tableau Server. To use
it, you need access to a Tableau server running version 8.0 or higher, and a published
workbook on that server. The API is provided through the file tableau_v8.js (minimized) or
tableau_v8.debug.js, which install in the following folder on Tableau Server:
Program Files\Tableau\Tableau
Server\8.1\wgserver\public\javascripts\api
If you don't have a Tableau Server on-premise, you have a couple other options:
l
l
Tableau Public is a free Tableau Server implementation that you can also use to access
the JavaScript API. The workbooks published to Tableau Public must be packaged
.twbx workbooks (data extract and workbook bundled together). Workbooks published
to Tableau Public can't use live database connections or rely on extract refresh
schedules (Tableau can't connect to databases behind your firewall). The Tutorial uses
a workbook published to Tableau Public for its example.
Tableau Online is another Tableau-hosted implementation of Tableau Server, in the
cloud. Workbooks published to Tableau Online need to use extracts, or live connections
to certain cloud-based data sources like Salesforce and Google Analytics. Contact
Tableau Software to learn more.
Bootstrapping
There is only one entry point into the API: instantiating a new Viz object, which creates the
HTML necessary to embed a Tableau visualization. To instantiate a new Viz object, simply
call the Viz constructor via new, passing the required parentElement and URL parameters
and an optional set of options. The URL parameter is where you specify the name of the
Tableau server:
var placeholderDiv = document.getElementById("tableauViz");
var url = "http://tabserver/views/workbookname/viewname";
var options = {
hideTabs: true,
width: "800px",
height: "700px"
};
var viz = new tableauSoftware.Viz(placeholderDiv, url, options);
Trusted Authentication
If Tableau Server is using trusted authentication and the trusted ticket server is configured to
return the ticket value itself, add a ticket option. For example:
var placeholderDiv = document.getElementById("tableauViz");
var url = "http://tabserver/views/workbookname/viewname";
var options = {
hideTabs: true,
width: "800px",
height: "700px",
ticket: "Etdpsm_Ew6rJY-9kRrALjauU"
};
var viz = new tableauSoftware.Viz(placeholderDiv, url, options);
If the trusted ticket server is configured to return a full URL, specify the ticket in the URL by first
adding trusted after the server name, followed by the ticket. For example:
var placeholderDiv = document.getElementById("tableauViz");
var url = "http://tabserver/trusted/Etdpsm_Ew6rJY9kRrALjauU/views/workbookname/viewname";
var options = {
hideTabs: true,
width: "800px",
height: "700px"
};
var viz = new tableauSoftware.Viz(placeholderDiv, url, options);
Property Getters and Setters
Getters and setters are always functions that start with get or set. They can be called
multiple times with little performance impact (in other words, they should simply return cached
fields or do very simple calculations). Properties are always synchronous and return
immediately with the value, rather than having a callback function.
Call Behavior - Asynchronous
By default, calls are asynchronous since many of them may require a roundtrip to the server.
Methods use the following naming convention:
l
l
Asynchronous calls are indicated by an Async suffix on the method name, for example,
Worksheet.applyFilterAsync().
Asynchronous calls return a Promise object, allowing chaining.
The Tableau JavaScript API uses the CommonJS Promises/A standard. The premise behind
Tableau's implementation is that asynchronous methods return an object that has a then
method in the following form:
then(fulfilledHandler, errorHandler)
The fulfilledHandler is called when the promise is fulfilled (on success). The
errorHandler is called when a promise fails. All arguments are optional and non-function
values are ignored.
Chaining Promises
The promised result of an asynchronous method is passed as the parameter to the next then
() method. For example:
var activeSheet;
viz.getWorkbook().activateSheetAsync("Sheet 1")
.then(selectLemon).then(filterToLemonAndMint);
function selectLemon(sheet) {
activeSheet = sheet;
return sheet.selectMarksAsync("Product", "Lemon", "replace");
}
function filterToLemonAndMint() {
return activeSheet.applyFilterAsync("Product", ["Lemon",
"Mint"], "replace");
}
The result of activateSheetAsync() is a promise to eventually return the Sheet object
that was activated, which is passed as the first parameter to the selectLemon() method.
Notice that the selectLemon() method returns a Promise object (the return value of the
selectMarksAsync() method), not the result after the marks have been selected.
However, since it’s a Promise object, the next then() method is not called until that promise
is fulfilled.
If a link in the chain is added after the promise has been fulfilled, the callback will be
immediately called with the value that was previously returned. As the programmer, this means
you don't need to determine if the response has already been received from the server. The
asynchronous methods will always be called, whether it's now or later.
var promise = viz.getWorkbook().activateSheetAsync("Sheet 1");
// Pretend that activatSheeteAsync() has already returned from
the server.
promise.then(callback);
// callback will be called immediately using the Sheet object
// returned from activateSheetAsync()
Return Values of Then() Methods
Whatever is returned in a then() method will get passed as the first parameter to the next
then() method. It can be a scalar value (Number, Boolean, String, etc.), an object, or
another Promise. The infrastructure will automatically wrap non-Promise values into a
Promise value so that they can be chained.
viz.getWorkbook().activateSheetAsync("Sheet 1")
.then(function (sheet) {
return "First link";
})
.then(function (message) {
if (message === "First link") { alert("Expected"); }
// no return value here means nothing is passed to the next
link
})
.then(function () {
});
Breaking Out of a Chain
Technically, there’s no way to break out of a chain since that would invalidate the guarantee
that subsequent links in the chain will be called. If there is an exception thrown in part of the
chain, the rest of the chain is run but the errorHandler is called instead of the
fulfilledHandler.
If a link in the chain depends on the results of earlier links, then you should write an if
statement to check your condition. Here's an example:
viz.getWorkbook().activateSheetAsync("Sheet 1")
.then(function (sheet) {
// I’m returning a Promise
return sheet.selectMarksAsync("Product", "NoProduct",
"replace");
})
.then(function () {
return viz.getWorkbook().getActiveSheet().getSelectedMarksAsync
();
})
.then(function (marks) {
// The getSelectedMarksAsync call succeeded, but no marks were
selected
// because there are not any marks corresponding to
"NoProduct".
if (marks.length === 0) {
throw new Error("No marks selected");
}
var firstMarkValue = marks[0].getPairs().get("Product").value;
return sheet.applyFilterAsync("Product", firstMarkValue,
"replace");
})
.then(function (filterName) {
// applyFilterAsync succeeded
}, function(err) {
if (err.message === "No marks selected") {
alert("This was caused by the first link above");
}
})
.otherwise(function (err) {
alert("We handled the error above, so it’s not propagated to
this handler.");
});
If a callback is not provided (or is null or undefined), then the results are passed to the next link
in the chain:
viz.getWorkbook().activateSheetAsync("Sheet 1")
.then()
.then(function (sheet) {
// this is called
});
In this way, you can specify a single otherwise function to handle all errors in the chain. The
always function works the same way, but it is called regardless of success or failure. The
then/otherwise/always functions work similarly to a try/catch/finally block.
viz.getWorkbook().activateSheetAsync("Sheet 1")
.then(function () {
return sheet.selectMarksAsync(...);
})
.then(function (marks) {
// Do something with the marks.
})
.otherwise(function (err) {
// I’m handling all errors in one place.
console.log(err.message);
})
.always(function () {
// Do some cleanup or logging
});
Collections
Many classes have collections of items, where each item has a key (typically an ID or a name).
Examples include a collection of sheets keyed by name or the list of parameters on a sheet
keyed by name. Collections are publicly immutable, exposing read-only functionality. Each
Collection array is keyed with its elements’ identifiers. For example, the result of
Workbook.getPublishedSheetsInfo() is an array with the index corresponding to
the position of the sheet in the workbook. It is also keyed by the sheet name so that you can
access it like this:
var sheet = workbook.getPublishedSheetsInfo()[0];
var sameSheet = workbook.getPublishedSheetsInfo().get("Sheet 1");
Collection Interface
Name
Return
Type
get(key : Collection
string)
item type
has(key bool
: string)
Description
Gets the element in the collection associated with the key, or
undefined if there is nothing associated with it.
Returns true if there is an element in the collection associated
with the key; otherwise, false.
Events
The Viz class acts as the central event hub. This way you only have to go to one place for all
events. It also means that events can be raised on an object that may not have been created
yet. For example, the marksselection event can be raised for a particular sheet even
though the Sheet object hasn't been created yet. Each event contains an anonymous object
with information pertaining to that event, such as the sheet the event occurred on.
Listening to an event is done by calling Viz.addEventListener(type, callback)
and passing in a function callback. Here's an example of listening to an event:
viz.addEventListener("marksSelection", function (marks) {
changeMySelectionUI(marks);
});
Removing a listener is done by calling Viz.removeEventListener(type, listener)
and passing in the same callback function that was passed into Viz.addEventListener
(). For example:
function changeMySelectionUI(marks) {
viz.removeEventListener("marksSelection",
changeMySelectionUI);
}
viz.addEventListener("marksSelection", changeMySelectionUI);
Events are multicast delegates, meaning that multiple listeners are supported. The order in
which notifications are called is not specified. Every event callback takes a single object
containing a pointer to the Viz that raised the event. Each event also adds additional fields to
the event, as specified in the API Reference.
Filtering
When you program filtering you are mimicking the user behavior of clicking a filter in a view to
narrow down the data that is displayed. Here's an example of filtering on a single value:
worksheet.applyFilterAsync("Container", "Jumbo Box",
tableauSoftware.FilterUpdateType.REPLACE);
There is a difference between querying existing filter state and setting new or existing filters.
Querying filters is done via Worksheet.getFiltersAsync() which returns a collection
of Filter classes. Setting filters is done via Worksheet.applyFilterAsync (and its
variants) and is a function call that doesn't require you to instantiate a Filter class.
When you specify fields in a filter, you should use the caption as shown in the user interface,
not the database field name. For example, you should use Container (the caption) instead of
Product Container (the actual field name). In some cases, Tableau Desktop renames fields
after they've been dragged to a shelf. For example the Date field might be renamed to YEAR
(Date) after being dragged to the rows shelf. In this case, you should use YEAR(Date) as the
parameter. The exception is hierarchical filters, which use the full hierarchical name (for
example, [Product].[All Product].[Espresso]). Captions can use the optional []
delimiters around names.
Here are samples for many types of filtering:
var worksheet;
viz.getWorkbook().activateSheetAsync("Sheet 4").then(function
(sheet) {
worksheet = sheet;
})
// Single value
.then(function () {
return worksheet.applyFilterAsync("Product Type", "Coffee",
tableauSoftware.FilterUpdateType.REPLACE);
})
// Multiple values
.then(function () {
return worksheet.applyFilterAsync(
"Product Type", ["Coffee", "Tea"],
tableauSoftware.FilterUpdateType.REPLACE);
})
// Multiple Values - adding and removing
.then(function () {
return worksheet.applyFilterAsync("Product", ["Lemon", "Mint"],
tableauSoftware.FilterUpdateType.ADD);
})
.then(function () {
return worksheet.applyFilterAsync("Product", ["Caffe Latte",
"Green Tea"],
tableauSoftware.FilterUpdateType.REMOVE);
})
// All values
.then(function () {
return worksheet.applyFilterAsync("Product Type", "",
tableauSoftware.FilterUpdateType.ALL);
})
// Date Range
.then(function () {
return; worksheet.applyRangeFilterAsync("Date", {
min: new Date(Date.UTC(2010, 3, 1)),
max: new Date(Date.UTC(2010, 12, 31))
});
})
// Clearing a Filter
.then(function () {
return worksheet.clearFilterAsync("Date");
})
// Relative Date
.then(function () {
return worksheet.applyRelativeDateFilterAsync("Date", {
anchorDate: new Date(Date.UTC(2011, 5, 1)),
periodType: tableauSoftware.PeriodType.YEAR,
rangeType: tableauSoftware.DateRangeType.LASTN,
rangeN: 1
});
})
// Quantitative Filters
// SUM(Sales) > 2000 and SUM(Sales) < 4000
.then(function () {
return worksheet.applyRangeFilterAsync("SUM(Sales)", {
min: 2000,
max: 4000
});
})
// SUM(Sales) > 1000
.then(function () {
return worksheet.applyRangeFilterAsync("SUM(Sales)", {
min: 1000
});
})
// Hierarchical Filters - selecting all on a level
.then(function () {
return worksheet.applyHierarchicalFilterAsync("[Product].
[Product Categories]", {
levels: [0, 1]
}, tableauSoftware.FilterUpdateType.ADD);
}, function (err) { /* ignore errors */ })
// Hierarchical Filters - adding one item
.then(function () {
return worksheet.applyHierarchicalFilterAsync(
"[Product].[Product Categories].[Product Name]",
"Accessories.Bike Racks.Hitch Rack - 4-Bike",
tableauSoftware.FilterUpdateType.REPLACE);
}, function (err) { /* ignore errors */ })
// Hierarchical Filters - adding multiple items
.then(function () {
return worksheet.applyHierarchicalFilterAsync(
"[Product].[Product Categories].[Product Name]",
[
"Accessories.Bike Racks.Hitch Rack - 4-Bike",
"Accessories.Bike Stands.All-Purpose Bike Stand"
],
tableauSoftware.FilterUpdateType.REPLACE);
}, function (err) { /* ignore errors */ })
.otherwise(function (err) {
console.log(err);
});
Selecting Marks
Selecting marks is almost identical to filtering. For filtering,you use one of the
Worksheet.applyFilterAsync() methods. For selecting marks, you use
Worksheet.selectMarksAsync(). The parameters for mark selection are almost
identical to those used for filtering.
worksheet.selectMarksAsync("Product", "Caffe Latte",
tableauSoftware.SelectionUpdateType.REPLACE);
Here are samples of other types of selecting you can use:
var worksheet;
viz.getWorkbook().activateSheetAsync("Sheet 4").then(function
(sheet) {
worksheet = sheet;
})
// Single dimensions work just like filtering
// Single dimension - single value
.then(function () {
return worksheet.selectMarksAsync("Product", "Mint",
tableauSoftware.SelectionUpdateType.REPLACE);
})
// Single dimension - Multiple values
.then(function () {
return worksheet.selectMarksAsync(
"Product", ["Chamomile", "Mint"],
tableauSoftware.SelectionUpdateType.REPLACE);
})
// Single dimension - Multiple values (delta)
.then(function () {
return worksheet.selectMarksAsync("Product", ["Lemon", "Earl
Grey"],
tableauSoftware.SelectionUpdateType.ADD);
})
.then(function () {
return worksheet.selectMarksAsync(
"Product", ["Chamomile", "Earl Grey"],
tableauSoftware.SelectionUpdateType.REMOVE);
})
// Quantitative selection
.then(function () {
return worksheet.selectMarksAsync({
"State": ["Florida", "Missouri"],
"SUM(Sales)": { min: 3000, max: 4000 }
}, tableauSoftware.SelectionUpdateType.REPLACE);
})
// Hierarchical dimensions
.then(function () {
return worksheet.selectMarksAsync(
"[Product].[Product Categories].[Category]",
"Bikes",
tableauSoftware.SelectionUpdateType.REPLACE);
}, function (err) { /* ignore errors */ })
// Multiple dimensions - multiple values
// ((State = Washington OR Oregon) AND Product = Lemon)
// OR
// (State = Oregon AND Product = Chamomile)
.then(function () {
return worksheet.selectMarksAsync({
"State": ["Washington", "Oregon"],
"Product": "Lemon"
}, tableauSoftware.SelectionUpdateType.REPLACE);
})
.then(function () {
return worksheet.selectMarksAsync({
"State": "Oregon",
"Product": "Chamomile"
}, tableauSoftware.SelectionUpdateType.ADD);
})
// Round-tripping selection
.then(function () {
return worksheet.selectMarksAsync(
"Product",
"Lemon",
tableauSoftware.SelectionUpdateType.REPLACE);
})
.then(function () {
return worksheet.getSelectedMarksAsync();
}).then(function (marks) {
// filter out only the Washington and Oregon marks
var onlyWashingtonAndOregon = [];
for (var i = 0, len = marks.length; i < len; i++) {
var m = marks[i];
var pair = m.getPairs().get("State");
if (pair &&
(pair.value === "Washington" || pair.value === "Oregon")) {
onlyWashingtonAndOregon.push(m);
}
}
return worksheet.selectMarksAsync(
onlyWashingtonAndOregon,
tableauSoftware.SelectionUpdateType.REPLACE);
})
.otherwise(function (err) {
console.log(err);
});
API Reference
Style and Conventions
Tableau's JavaScript API follows these JavaScript standards:
l
l
l
l
Classes are PascalCase (initial capital letter, with each subsequent word capitalized)
Namespaces, methods, parameters, and variables are camelCase (initial lowercase letter, with each subsequent word capitalized)
Constants and enum values are UPPERCASE_UNDERSCORE_DELIMITED
Protected variables or methods start with an initial underscore '_' character,
indicating that it should not be referenced by the programmer.
Top-Level Class Diagram
The following class diagram shows the relationships between the top-level classes, as well as
the inheritance hierarchy for the Sheet, Dashboard, and Worksheet classes. Note that
there's always a way to traverse back up the containment hierarchy with parent pointers, with
the exception of VizManager, as it's a static class and always accessible.
Asynchronous and Error Classes
Promise Class
Represents a promise to return a value from an asynchronous method in the future. The
Tableau JavaScript API implements the Promises/A specification.
Methods
Name
Return Description
Type
then(callback: Promise Creates a link in the asynchronous callable chain. The
Function,
callback function is called on success. The errback
errback:
function is called when there is an error. Both parameters
Function)
are optional.
always
Promise Registers a callback that will be called when a promise is
(callback:
resolved or rejected. Shortcut for then(callback,
Function)
callback).
otherwise
Promise Registers a rejection handler. Shortcut for then(null,
(errback:
errback).
Function)
TableauException Class
The TableauException class is not a real class, but simply adds an id field to the standard
JavaScript Error object when an exception is thrown from within the API. As the
programmer, this allows you to uniquely identify the error without having to parse the error
string. It also allows you to add localized messages.
Constructor
There is no public constructor. The only way to get a reference to a TableauException is within
a catch block.
Fields
Name
Type
Description
tableauSoftwareErrorCode ErrorCode Represents an ErrorCode enum
value.
message
string
This is already defined on the standard
Error object, but the message will
contain a description of the exception
that the API code specifies.
ErrorCode Enum
Here's a list of the different exceptions that the API can throw:
Name
BROWSER_
NOT_
CAPABLE
DOWNLOAD_
WORKBOOK_
NOT_
ALLOWED
FILTER_
CANNOT_BE_
PERFORMED
INDEX_OUT_
OF_RANGE
Return Type
browserNotCapable
INTERNAL_
ERROR
internalError
INVALID_
CUSTOM_
VIEW_NAME
INVALID_
DATE_
PARAMETER
INVALID_
invalidCustomViewName
downloadWorkbookNotAllowed
filterCannotBePerformed
indexOutOfRange
invalidDateParameter
invalidFilterFieldName
Description
The browser is not capable of
supporting the Tableau
JavaScript API.
The permissions on a workbook
or a view do not allow
downloading the workbook.
An error occurred while
attempting to perform a filter
operation.
Attempted to switch to a sheet
by index that does not exist in
the workbook.
An error occurred within the
Tableau JavaScript API.
Contact Tableau Support.
An operation was attempted on
a custom view that does not
exist.
An invalid date was specified in
a method that required a date
parameter.
A filter operation was attempted
FILTER_
FIELDNAME
INVALID_
FILTER_
FIELDNAME_
OR_VALUE
on a field that does not exist in
the data source.
invalidFilterFieldNameOrValue
Either a filter operation was
attempted on a field that does
not exist in the data source, or
the value supplied in the filter
operation is the wrong data type
or format.
INVALID_
invalidFilterFieldValue
A filter operation was attempted
FILTER_
using a value that is the wrong
FIELDVALUE
data type or format.
INVALID_
invalidParameter
A parameter is not the correct
PARAMETER
data type or format. The name
of the parameter is specified in
the Error.message field.
INVALID_
invalidSelectionDate
An invalid date value was
SELECTION_
specified in a
Sheet.selectMarksAsync
DATE
() call for a date field.
INVALID_
invalidSelectionFieldName
A field was specified in a
Sheet.selectMarksAsync
SELECTION_
FIELDNAME
() call that does not exist in the
data source.
INVALID_
invalidSelectionValue
An invalid value was specified in
SELECTION_
a
Sheet.selectMarksAsync
VALUE
() call.
INVALID_SIZE invalidSize
A negative size was specified or
the maxSize value is less than
minSize in
Sheet.changeSizeAsync().
INVALID_
invalidSizeBehaviorOnWorkshe- A behavior other than
SheetSizeBehavior.AUTOSIZE_
et
MATIC was specified in
BEHAVIOR_
Sheet.changeSizeAsync
ON_
() when the sheet is a
WORKSHEET
Worksheet instance.
INVALID_URL invalidUrl
The URL specified in the Viz
class constructor is not valid.
MISSING_
missingMaxSize
The maxSize field is missing in
Sheet.changeSizeAsync
MAX_SIZE
() when specifying
SheetSizeBehavior.ATMOST.
MISSING_
missingMinSize
The minSize field is missing in
MIN_SIZE
MISSING_
missingMinMaxSize
MINMAX_SIZE
MISSING_
RANGEN_
FOR_
RELATIVE_
DATE_
FILTERS
NO_URL_
FOR_
HIDDEN_
WORKSHEET
NO_URL_OR_
PARENT_
ELEMENT_
NOT_FOUND
NOT_
ACTIVE_
SHEET
NULL_OR_
EMPTY_
PARAMETER
SERVER_
ERROR
SHEET_NOT_
IN_
WORKBOOK
STALE_
DATA_
REFERENCE
UNSUPPORTED_EVENT_
NAME
missingRangeNForRelativeDateFilters
noUrlForHiddenWorksheet
Sheet.changeSizeAsync
() when specifying
SheetSizeBehavior.ATLEAST.
Either or both of the minSize
or maxSize fields is missing in
Sheet.changeSizeAsync
() when specifying
SheetSizeBehavior.RANGE.
The rangeN field is missing for
a relative date filter of type
LASTN or NEXTN.
An attempt was made to access
Sheet.getUrl() on a hidden
sheet. Hidden sheets do not
have URLs.
noUrlOrParentElementNotFoun- One or both of the
d
parentElement or the URL
parameters is not specified in
the Viz constructor.
notActiveSheet
An operation was attempted on
a sheet that is not active or
embedded within the active
dashboard.
nullOrEmptyParameter
A required parameter was not
specified, null, or an empty
string/array.
serverError
A general-purpose server error
occurred. Details are contained
in the Error object.
sheetNotInWorkbook
An operation was attempted on
a sheet that does not exist in the
workbook.
staleDataReference
An operation is performed on a
CustomView object that is no
longer valid (it has been
removed).
unsupportedEventName
An unknown event name was
specified in the call to
Viz.addEventListener or
Viz.removeEventListene-
VIZ_
ALREADY_
IN_MANAGER
vizAlreadyInManager
r.
A Viz object has already been
created as a child of the
parentElement specified in
the Viz constructor.
Viz Classes
Class Diagram
VizManager Class
Manages all of the Viz instances on the page, but does not manage vizzes (views) earlier than
version 8.1. This is a static class, meaning that all properties and methods are static and there
is only a single instance of the class.
Properties
Name
getVizs()
Type
Viz[]
Description
Collection of version 8.1 views on the hosting page.
Viz Class
Wraps an <iframe> showing one or more sheets in a Tableau workbook. Contains all of the
chrome surrounding the view.
Constructor
Signature
Viz
(parentElement:
domNode, url:
Description
Creates a new Tableau Viz inside of the given HTML container,
which is typically a <div> element. Each option as well as the
options parameter is optional. If there is already a Viz
string, options:
associated with the parentElement, an exception is thrown.
VizCreateOptions Before reusing the parentElement you must first call
)
dispose().
Properties
Name
getAreTabsHidden()
Type
bool
Description
Indicates whether the tabs are
displayed in the UI. It does not
actually hide individual tabs.
getIsToolbarHidden()
bool
Indicates whether the toolbar is
displayed.
getIsHidden()
bool
Indicates whether the viz is
displayed on the hosting page.
getParentElement()
domNode Returns the node that was
specified in the constructor.
getUrl()
string
The URL of the viz, as specified in
the constructor
getWorkbook()
Workbook One Workbook is supported per
viz.
getAreAutomaticUpdatesPaused bool
Indicates whether automatic
()
updates are currently paused.
Events
Events are added or removed via the following two calls.
Name
addEventListener(
type:
TableauEventName,
listener: Function)
removeEventListener(
type:
TableauEventName,
listener: Function)
Return
Type
None
Description
None
Removes an event listener from the
specified event.
Adds an event listener to the specified event.
Methods
Name
show()
hide()
dispose()
Type
None
None
Description
Shows or hides the <iframe>
hosting the viz.
Cleans up any resources associated
with the viz, removes the viz from the
VizManager, and removes any DOM
elements from parentElement.
Basically, it restores the page to
what it was before instantiating a
new Viz object.
pauseAutomaticUpdatesAsync() None
resumeAutomaticUpdatesAsync
()
toggleAutomaticUpdatesAsync
()
revertAllAsync()
Promise
refreshDataAsync()
None
showDownloadWorkbookDialog
()
None
showExportImageDialog()
None
showExportPDFDialog()
None
showExportDataDialog(
worksheetInDashboard: Sheet
or SheetInfo or string)
None
showExportCrossTabDialog(
worksheetInDashboard: Sheet
or SheetInfo or string)
None
showShareDialog()
None
setFrameSize(width: int, height:
int)
None
Pauses or resumes layout updates.
This is useful if you are resizing the
viz or performing multiple calls that
could affect the layout.
Equivalent to clicking on the Revert
All toolbar button, which restores the
workbook to its starting state.
Equivalent to clicking on the Refresh
Data toolbar button.
Equivalent to clicking on the
Download toolbar button, which
downloads a copy of the original
workbook.
Equivalent to clicking on the Export
Image toolbar button, which creates
a PNG file of the current viz.
Equivalent to clicking on the Export
PDF toolbar button, which shows a
dialog allowing the user to select
options for the export.
Shows the Export Data dialog, which
is currently a popup window. The
worksheetInDashboard
parameter is optional. If not
specified, the currently active
Worksheet is used.
Shows the Export CrossTab dialog.
The worksheetInDashboard
parameter is optional. If not
specified, the currently active
Worksheet is used.
Equivalent to clicking on the Share
toolbar button, which displays a
dialog allowing the user to share the
viz by email or by embedding its
HTML in a web page.
Sets the size of the iFrame, which
causes the viz to expand or collapse
to fit the iFrame if the viz’s current
sheet’s size is set to AUTOMATIC.
VizCreateOptions Record
These are the options that are specified in the Viz constructor.
Fields
Name
hideTabs
hideToolbar
Type
bool
bool
Description
Indicates whether tabs are hidden or shown.
Indicates whether the toolbar is hidden or
shown.
toolbarPosition
ToolbarPosition Indicates where the toolbar should be placed
if hideToolbar is false.
height
string
Can be any valid CSS size specifier. If not
specified, defaults to 600px.
width
string
Can be any valid CSS size specifier. If not
specified, defaults to 800px.
onFirstInteractive callback(e:
Callback when the viz first becomes
TableauEvent) interactive. This is only called once, but it’s
guaranteed to be called. If the viz is already
interactive, it will be called immediately, but on
a separate "thread."
ToolbarPosition Enum
Enumeration
Name
TOP
BOTTOM
Description
Positions the toolbar along the top of the viz.
Positions the toolbar along the bottom of the viz.
Viz Event Classes
TableauEventName Enum
These are strings passed to Viz.addEventListener/removeEventListener. Note that the value
of the enums are all lowercase strings with no underscores. For example, CUSTOM_VIEW_
LOAD is customviewload. Either the fully-qualified enum
(tableauSoftware.TableauEventName.FILTER_CHANGE) or the raw string
(filterchange) is acceptable.
Name
CUSTOM_VIEW_
LOAD
CUSTOM_VIEW_
REMOVE
CUSTOM_VIEW_
SAVE
CUSTOM_VIEW_
SET_DEFAULT
FILTER_
Event Class
Passed in the
Callback
CustomViewEvent
CustomViewEvent
CustomViewEvent
CustomViewEvent
FilterEvent
Description
Raised when a custom view has finished
loading.
Raised when the user removes a custom
view.
Raised when the user saves a new or
existing custom view.
Raised when a custom view has been
made the default view for this viz.
Raised when any filter has changed
CHANGE
MARKS_
SELECTION
PARAMETER_
VALUE_
CHANGE
TAB_SWITCH
MarksEvent
ParameterEvent
TabSwitchEvent
state. The viz may not be interactive yet.
Raised when marks are selected or
deselected.
Raised when any parameter has
changed state.
Raised after the tab switched, but the viz
may not yet be interactive.
TableauEvent Class
Properties
Name
getViz()
Type
Viz
Description
Gets the Viz object associated with the
event.
getEventName TableauEventName Gets the name of the event which is a string,
()
but is also one of the items in the
TableauEventName enum.
CustomViewEvent Class
Properties
Name
getViz()
Type
Viz
Description
Gets the Viz object associated with the
event.
getEventName TableauEventName Gets the name of the event which is a string,
()
but is also one of the items in the
TableauEventName enum.
Methods
Name
Return Type
getCustomViewAsync Promise<
()
CustomView>
Description
Gets the CustomView object
associated with the event.
FilterEvent Class
Properties
Name
getViz()
Type
Viz
Description
Gets the Viz object associated with the
event.
getWorksheet Worksheet
Gets the Worksheet object associated with
()
the event.
getEventName TableauEventName Gets the name of the event which is a string,
()
but is also one of the items in the
TableauEventName enum.
getFieldName string
Gets the name of the field.
()
Methods
Name
Return Type
getFilterAsync() Promise<Field>
Description
Gets the Field object associated with the event.
MarksEvent Class
Properties
Name
getViz()
Type
Viz
Description
Gets the Viz object associated with the
event.
getWorksheet Worksheet
Gets the Worksheet object associated with
()
the event.
getEventName TableauEventName Gets the name of the event which is a string,
()
but is also one of the items in the
TableauEventName enum.
Methods
Name
Return Type Description
getMarksAsync Promise<Mark Gets the selected marks on the Worksheet that
()
[]>
triggered the event.
ParameterEvent Class
Properties
Name
getViz()
Type
Viz
Description
Gets the Viz object associated with the
event.
getEventName()
TableauEventName Gets the name of the event which is a
string, but is also one of the items in the
TableauEventName enum.
getParameterName string
Gets the name of the parameter that
()
changed.
Methods
Name
Return Type
Description
getParameterAsync Promise<Parameter> Gets the Parameter object that
()
triggered the event.
TabSwitchEvent Class
Properties
Name
getViz()
Type
Viz
Description
Gets the Viz object associated with the
event.
getEventName()
TableauEventName Gets the name of the event which is a
string, but is also one of the items in the
TableauEventName enum.
getOldSheetName string
Gets the name of the sheet that was
()
active before the tab switch event
occurred.
getNewSheetName string
Gets the name of the sheet that is
()
currently active.
Workbook Classes
Class Diagram
Workbook Class
A Workbook has a collection of Sheets represented as tabs. It also has associated objects like
DataSources and CustomViews.
Properties
Name
getViz()
Type
Viz
Description
Gets the Viz object that contains the
workbook.
getActiveSheet()
Sheet
Gets the currently active sheet (the active
tab)
getActiveCustomView() CustomView Gets the currently active custom view, or
null if no custom view is active.
getPublishedSheetsInfo SheetInfo[]
Note that this is synchronous, meaning
()
getName()
string
that all of the sheets are expected when
loaded.
Gets the name of the workbook saved to
the server. Note that this is not
necessarily the file name.
Methods
Name
revertAllAsync()
Return Type
Promise
Description
Reverts the
workbook to
its last saved
state.
getParametersAsync()
Promise<Parameter[]> Fetches the
parameters
for this
workbook.
changeParameterValueAsync(
Promise<Parameter>
Changes the
name: string,
value of the
value: object)
Parameter
with the given
name and
returns the
new
Parameter.
getCustomViewsAsync()
Promise<CustomView[] Gets the
>
collection of
CustomView
objects
associated
with the
workbook.
showCustomViewAsync(
Promise<CustomView> Changes the
customViewName: string)
viz to show
the named
saved state.
removeCustomViewAsync(
Promise<CustomView> Removes the
customViewName: string)
named
custom view.
rememberCustomViewAsync(
Promise<CustomView> Remembers
customViewName: string)
the current
state of the
workbook by
assigning a
custom view
name.
setActiveCustomViewAsDefaultAsync None
Sets the
()
active custom
view as the
default.
DataSource Class
The Workbook contains one or more data sources. Each Worksheet will have a primary
data source and can have multiple secondary data sources.
Properties
Name
getName()
getIsPrimary
()
getFields()
Type Description
string The name of the DataSource as seen in the UI.
bool Indicates whether this DataSource is a primary or a
secondary data source.
Field Gets an array of Fields associated with the DataSource.
[]
Field Class
A field contains information about what data source it belongs to, its role, and the ability to fetch
the domain values.
Properties
Name
Type
getName()
string
getAggregation FieldAggregationType
()
getDataSource
()
getRole()
DataSource
FieldRoleType
Description
Gets the field name (i.e. caption).
Gets the type of aggregation, which is
one of the following values: SUM, AVG,
MIN, MAX, STDEV, STDEVP, VAR,
VARP, COUNT, COUNTD, MEDIAN,
ATTR, NONE, YEAR, QTR, MONTH, DAY,
HOUR, MINUTE, SECOND, WEEK,
WEEKDAY, MONTHYEAR, MDY, END,
TRUNC_YEAR, TRUNC_QTR, TRUNC_
MONTH, TRUNC_WEEK, TRUNC_DAY,
TRUNC_HOUR, TRUNC_MINUTE,
TRUNC_SECOND, QUART1, QUART3,
SKEWNESS, KURTOSIS, INOUT, USER
Gets the data source to which this field
belongs.
One of the following values: DIMENSION,
MEASURE, UKNOWN
CustomView Class
Represents a named snapshot of the workbook at a specific moment.
Properties
Name
getName()
setName()
getAdvertised()
setAdvertised()
getDefault()
getOwnerName
()
getUrl()
getWorkbook()
Type
string
Description
User-friendly name for the custom view
bool
Indicates whether the custom view is public or private.
bool
string
Gets or sets whether this is the default custom view.
Gets the user that created the custom view.
string
Unique URL to load this view again.
Workbook Gets the Workbook to which this CustomView
belongs.
Methods
Name
Return Type
Description
saveAsync Promise<CustomView> After saveAsync() is called, the result of
()
the getUrl method is no longer blank.
Sheet Classes
Class Diagram
SheetInfo Class
Contains information about a Worksheet or a Dashboard and no methods. Returned as
part of Workbook.getPublishedSheetsInfo().
Constructor
There is no public constructor. You can only get instances of this class from
Workbook.getPublishedSheetsInfo().
Properties
Name
getName()
getIndex()
Type
string
int
Description
Gets the name of the sheet.
Gets the index of the sheet within the published tabs.
Note that hidden tabs are still counted in the ordering,
as long as they are published.
getIsActive()
bool
Gets a value indicating whether the sheet is the
currently active sheet.Due to a technical limitation in
version 8.0, this will always return false if the object is a
Worksheet instance that is part of a Dashboard.
getIsHidden() bool
Gets a value indicating whether the sheet is hidden in
the UI. Note that if the entire tab control is hidden, it
does not affect the state of this flag. This sheet may still
report that it is visible even when the tabs control is
hidden.
getSheetType SheetType Gets the type of the sheet. SheetType is an enum
()
with the following values: WORKSHEET and
DASHBOARD.
getSize()
SheetSize Gets the size information that the author specified
when publishing the workbook.
getUrl()
string
Gets the URL for this sheet.
getWorkbook Workbook Gets the Workbook to which this Sheet belongs.
()
Sheet Class
Constructor
There is no public constructor. You can only get instances of this class from
Workbook.getActiveSheet()or Dashboard.getObjects().
Properties
Name
getName()
getIndex()
Type
string
int
getIsActive()
bool
getIsHidden()
bool
Description
Gets the name of the sheet.
Gets the index of the sheet within the published tabs.
Note that hidden tabs are still counted in the ordering,
as long as they are published.
Gets a value indicating whether the sheet is the
currently active sheet.
Gets a value indicating whether the sheet is hidden in
the UI. Note that if the entire tab control is hidden, it
does not affect the state of this flag. This sheet may still
report that it is visible even when the tabs control is
hidden.
getSheetType SheetType Gets the type of the sheet. SheetType is an enum
()
with the following values: WORKSHEET and
DASHBOARD.
getSize()
SheetSize Gets the size information that the author specified
when publishing the workbook.
getUrl()
string
Gets the URL for this sheet.
getWorkbook Workbook Gets the Workbook to which this Sheet belongs.
()
Methods
Name
Return
Description
Type
changeSizeAsync Promise< Sets the size information on a sheet. Note that if the
(size: SheetSize)
SheetSize sheet is a Worksheet, only
>
SheetSizeBehavior.AUTOMATIC is allowed
since you can’t actually set a Worksheet to a fixed
size.
SheetSize Record
Describes the way a Sheet should be sized.
Fields
Name
Type
Description
behavior SheetSizeBehavior Contains an enumeration value of one of the
following: AUTOMATIC, EXACTLY, RANGE,
ATLEAST, and ATMOST.
maxSize int
This is only defined when behavior is EXACTLY,
RANGE or ATMOST.
This is only defined when behavior is EXACTLY,
minSize int
RANGE, or ATLEAST.
Worksheet Class
Represents a worksheet tab in the workbook or a dashboard object. These are two separate
concepts: a worksheet and a worksheet instance. However, for simplicity in the API, they are
both combined into the Worksheet class.
Constructor
There is no public constructor. You can only get instances of this class from
Workbook.getPublishedSheets() or Dashboard.getObjects().
Properties
Name
Type
Description
getParentDashboard Dashboard Returns the Dashboard object to which this
()
Worksheet belongs (if it’s on a dashboard).
Otherwise, it returns null.
Methods
Name
Return Type
Description
getDataSourcesAsync Promise<DataSource Gets the primary and all of the
()
[]>
secondary data sources for this
worksheet. Note that by
convention the primary data
source should always be the first
element.
Filtering methods are described in Worksheet Class (Filtering). Marks selection methods are
described in Worksheet Class (Selecting Marks).
Dashboard Class
Contains a collection of DashboardObject instances and a notion of the active object.
Constructor
There is no constructor. You get an instance of this from
Workbook.getPublishedSheets().
Properties
Name
Type
getObjects() DashboardObject[]
getWorkshe- Worksheet[]
ets()
Description
Gets the collection of objects.
Gets the collection of worksheets contained in the
dashboard. Note that this is a helper method and is
equivalent to looping through getObjects() and
collecting all of the
DashboardObject.Worksheet pointers when
DashboardObject.getType() ===
tableauSoftware.DashboardObjectType.WORKSHEET.
DashboardObject Class
Represents one of a series of different areas of the dashboard.
Constructor
There is no constructor. You get an instance of this from Dashboard.getObjects().
Properties
Name
Type
Description
getObjectType DashboardObjectType Gets what the object represents, which is
()
an enum with the following values:
BLANK, WORKSHEET, QUICK_FILTER,
PARAMETER_CONTROL, PAGE_
FILTER, LEGEND, TITLE, TEXT,
IMAGE, WEB_PAGE.
getDashboard
()
getWorksheet
()
Dashboard
getPosition()
Point
getSize()
Size
Worksheet
Gets the Dashboard object that contains
this object.
If getType() returns WORKSHEET, this
contains a pointer to the Worksheet
object.
Gets the coordinates relative to the top-left
corner of the dashboard of the object.
Gets the size of the object.
Parameter Classes
Class Diagram
Parameter Class
Contains information about a workbook parameter. To actually set a parameter’s value, call
workbook.changeParameterValueAsync().
Properties
Name
getName()
Type
string
getCurrentValue()
DataValue
getDataType()
ParameterDataType
getAllowableValuesT- ParameterAllowableValuesype()
Type
getAllowableValues()
DataValue[]
Description
A unique identifier for the
parameter, as specified by
the user.
The current value of the
parameter.
The data type of the
parameter can be one of the
following: FLOAT,
INTEGER, STRING,
BOOLEAN, DATE,
DATETIME.
The type of allowable
values that the parameter
can accept. It can be one of
the following enumeration
items: ALL, LIST, RANGE.
If the parameter is restricted
getMinValue()
DataValue
getMaxValue()
DataValue
getStepSize()
Number
getDateStepPeriod()
PeriodType
to a list of allowable values,
this property contains the
array of those values. Note
that this is not a standard
collection, but a JavaScript
array.
If
getAllowableValuesType is RANGE, this defines
the minimum allowable
value, inclusive. Otherwise
it’s undefined/null.
If
getAllowableValuesType is RANGE, this defines
the maximum allowable
value, inclusive. Otherwise
it’s undefined/null.
If
getAllowableValuesType is RANGE, this defines
the step size used in the
parameter UI control slider.
Otherwise it’s
undefined/null.
If
getAllowableValuesType is RANGE and
getDataType is DATE or
DATETIME, this defines the
step date period used in the
Parameter UI control slider.
Otherwise it’s
undefined/null.
Filtering
There is a difference between querying existing filter state and setting new or existing filters.
Querying filters is done via Worksheet.getFiltersAsync() which returns a collection of
Filter classes. Setting filters is done via Worksheet.applyFilterAsync (and its
variants) and is a function call that doesn't require you to instantiate a Filter class.
When you specify fields in a filter, you should use the caption as shown in the UI, not the
database field name. For example, use Container (the caption) instead of Product
Container (the actual field name). The exception is hierarchical filters, which use the full
hierarchical name (for example, [Product].[All Product].[Espresso]). Captions
can use the optional [] delimiters around names.
Class Diagram
Worksheet Class (Filtering)
These methods are on the Worksheet class, but are listed here for convenience.
Methods
Name
getFiltersAsync()
applyFilterAsync(
fieldName: string,
values: object[] or object,
updateType: FilterUpdateType,
options?: FilterOptions)
Return Type
Promise<Filter
[]>
Promise<string>
applyRangeFilterAsync(
fieldName: string,
range: RangeFilterOptions)
Promise<string>
applyRelativeDateFilterAsync(
Promise<strin-
Description
Fetches the collection of
filters used on the sheet.
Applies a simple categorical
filter (non-date). See the
filtering examples for more
details on these functions.
Returns the fieldName that
was filtered.
Applies a quantitative filter. If
a range is specified that is
outside of the domain
min/max values, no error is
raised and the command is
allowed. Subsequent calls to
getFiltersAsync[] will
return these values even if
they are outside of the
bounds of the domain. This is
equivalent to the behavior in
Tableau Desktop.
Applies a relative date filter.
fieldName: string,
options:
RelativeDateFilterOptions)
applyHierarchicalFilterAsync(
fieldName: string,
values: object,
options:
HierarchicalFilterOptions)
clearFilterAsync(fieldName:
string)
g>
Promise<string>
Promise<string>
Applies a hierarchical filter.
The values parameter is
either a single value, an array
of values, or an object { levels:
["1", "2"] }.
Clears the filter, no matter
what kind of filter it is. Note
that the filter is removed as
long as no associated quick
filter is showing for the field. If
there is a quick filter showing,
then the filter is kept, but it’s
reset to the “All” state
(effectually canceling the
filter). For relative date filters,
however, an error is returned
since there is no “All” state for
a relative date filter. To clear a
relative date filter with a quick
filter showing, you can call
applyRelativeDateFilter() instead using a range
that makes sense for the
specific field.
FilterOptions Record
Passed into the applyFilter methods to control advanced filtering options.
Fields
Name
isExcludeMode
Type
bool
Description
Determines whether the
filter will apply in exclude
mode or include mode. The
default is include, which
means that you use the
fields as part of a filter.
Exclude mode means that
you include everything else
except the specified fields.
RangeFilterOptions Record
Passed into the applyRangeFilterAsync method to control advanced filtering options.
Fields
Name
min
Type
int
max
int
nullOption
NullOption
Description
Minimum value for the range
(inclusive). Optional. Leave
blank if you want a <= filter.
Maximum value for the
range (inclusive). Optional.
Leave blank if you want a >=
filter.
The null values to include.
RelativeDateFilterOptions Record
Passed into the applyRelativeDateFilterAsync method to control advanced filtering
options.
Fields
Name
anchorDate
periodType
rangeType
rangeN
Type
Date
PeriodType
DateRangeType
int
Description
The UTC date from which to filter.
Year, quarter, month, etc.
LAST, LASTN, NEXT, etc.
The number used when the rangeType is LASTN
or NEXTN.
Filter Class
An abstract base class for all of the various filter types.
Properties
Name
getWorksheet
()
getFilterType
()
getFieldName
()
Type
Description
Worksheet Gets the parent worksheet
FilterType
string
Gets the type of the filter. See FilterType Enum for the
values in the enum.
Gets the name of the field being filtered. Note that this
is the caption as shown in the UI and not the actual
database field name.
Methods
Name
getFieldAsync()
Return Type
Promise<Field>
Description
Gets the field that is currently being filtered.
NullOption Enum
An enumeration that indicates what to do with null values for a given filter or mark selection call.
Enumeration
Name
NULL_VALUES
NON_NULL_VALUES
ALL_VALUES
Description
Only include null values in the filter.
Only include non-null values in the filter.
Include null and non-null values in the filter.
CategoricalFilter Class
Properties
Name
getIsExcludeMode
()
getAppliedValues
()
Type
bool
Description
Gets a value indicating whether the filter is exclude
or include (default).
DataValue Gets the collection of values that are currently set
[]
on the filter. Note that this is a native JavaScript
array and not a keyed collection.
QuantitativeFilter Class
Properties
Name
getDomainMinValue
()
getDomainMaxValue
()
getMinValue()
Type
Description
DataValue Gets the minimum value as specified in the
domain.
DataValue Gets the maximum value as specified in the
domain.
DataValue Gets the minimum value, inclusive, applied to
the filter.
getMaxValue()
DataValue Gets the maximum value, inclusive, applied to
the filter.
getIncludeNullValues bool
Indicates whether null values are included in
()
the filter.
RelativeDataFilter Class
Properties
Name
Type
getPeriod() PeriodType
Description
The date period of the filter. See PeriodType Enum
for the values in the enum.
getRange() DateRangeType The range of the date filter (years, months, etc.).
See DateRangeType Enum for the values in the
enum.
getRangeN int
When getRange returns LASTN or NEXTN, this is
()
the N value (how many years, months, etc.).
DataValue Record
A DataValue contains both the raw and formatted value for a filter or parameter. Date values
are always expressed in UTC dates.
Properties
Name
value
Type Description
object Contains the raw native value as a JavaScript type, which is
one of String, Number, Boolean, or Date
formattedValue string The value formatted according to the locale and the
formatting applied to the field or parameter.
FilterType Enum
An enumeration of the valid types of filters that can be applied.
Enumeration
Name
CATEGORICAL
Description
Categorical filters are used to filter to a set of values within the
domain.
QUANTITATIVE Quantitative filters are used to filter to a range of values from a
continuous domain.
HIERARCHICAL Hierarchical filters are used to filter to a set of values organized
into a hierarchy within the domain.
RELATIVE_
Relative date filters are used to filter a date/time domain to a
DATE
range of values relative to a fixed point in time.
FilterUpdateType Enum
An enumeration of the valid types of filtering that can be done.
Enumeration
Name
ALL
Description
Adds all values to the filter. Equivalent to checking the (All) value in a
quick filter.
REPLACE Replaces the current filter values with new ones specified in the call.
ADD
Adds the filter values as specified in the call to the current filter values.
Equivalent to checking a value in a quick filter.
REMOVE
Removes the filter values as specified in the call from the current filter
values. Equivalent to unchecking a value in a quick filter.
PeriodType Enum
An enumeration of a date period used in filters and in parameters.
Enumeration
Name
YEARS
QUARTERS
MONTHS
WEEKS
DAYS
HOURS
MINUTES
SECONDS
DateRangeType Enum
An enumeration of the valid date ranges for a relative date filter.
Enumeration
Name
LAST
LASTN
NEXT
NEXTN
CURRENT
TODATE
Description
Refers to the last day, week, month, etc. of the date period.
Refers to the last N days, weeks, months, etc. of the date period.
Refers to the next day, week, month, etc. of the date period.
Refers to the next N days, weeks, months, etc. of the date period.
Refers to the current day, week, month, etc. of the date period.
Refers to everything up to and including the current day, week, month,
etc. of the date period.
Marks Selection
Selecting marks is almost identical to filtering. For filtering, you use one of the
Worksheet.applyFilterAsync() methods. For selecting marks, you use
Worksheet.selectMarksAsync(). The parameters for marks selection are almost
identical to those used for filtering.This provides a very simple, easy to learn, and consistent
way to accomplish the two most common use cases for the API: filtering and selection.
Worksheet Class (Selecting Marks)
These methods are on the Worksheet class, but are shown here for convenience.
Methods
Name
Return Type
clearSelectedMarksAsync void
()
getSelectedMarksAsync() Promise<Mark
[]>
selectMarksAsync(
void
fieldName: string,
value: object or object[],
updateType:
SelectionUpdateType)
selectMarksAsync(
void
Description
Clears the selection for this
worksheet.
Gets the collection of marks that are
currently selected.
Selects the marks and returns them.
Allows selection based on this syntax
fieldValuesMap: object,
updateType:
SelectionUpdateType)
for the first parameter:
{
"Field1": value,
"Field2": [1, 2, 3]
}
selectMarksAsync(
marks: Mark[],
updateType:
SelectionUpdateType)
void
Mark Class
A mark represents a single data point on the viz. It is independent of the type of viz (bar, line,
pie, etc.).
Constructor
Signature
Pair(fieldName: string, value:
object)
Description
Creates a new Pair with the specified field
name/value pairing
Properties
Name
getPairs
()
Type Description
Pair[] Gets a collection of field name/value pairs associated with the
mark.
Pair Class
A pair contains a field name and a value (both the raw and formatted values).
Constructor
Signature
Mark(pairs: Pair[])
Description
Creates a new Mark with the specified pairs.
Fields
Name
fieldName
value
Type Description
string The field name to which the value is applied.
object Contains the raw native value for the field as a JavaScript
type, which is one of String, Number, Boolean, or Date.
formattedValue string The value formatted according to the locale and the
formatting applied to the field.
SelectionUpdateType Enum
An enumeration of the valid types of marks selection that can be done.
Enumeration
Name
Description
REPLACE Replaces the current marks values with new ones specified in the call.
ADD
Adds the values as specified in the call to the current selection.
Equivalent to control-clicking in desktop.
REMOVE
Removes the values as specified in the call from the current selection.
Equivalent to control-clicking an already selected mark in desktop.
Other Classes
Size Record
Represents a width and height in pixels. This is implemented as a plain JavaScript object (it’s
not a class).
Fields
Name
width
height
Type
int
int
Description
Expressed in pixel units.
Expressed in pixel units.
Point Record
Represents an x/y coordinate in pixels. This is implemented as a plain JavaScript object (it’s not
a class).
Fields
Name
x
y
Type
int
int
Description
Expressed in pixel units.
Expressed in pixel units.
Contato
Em caso de dúvidas sobre vendas, contate [email protected].
Para obter suporte ao cliente, contate [email protected].
Para tirar outras dúvidas, contate [email protected].
Telefone: (206) 633-3400
Copyright
©2013 Tableau Software, Incorporated e seus licenciantes. Todos os direitos reservados.
Patente www.tableausoftware.com/ip.
Partes do código copyright ©2002 The Board of Trustees of the Leland Stanford Junior
University. Todos os direitos reservados.
A instalação do Tableau inclui uma versão executável não modificada do banco de dados
Firebird. O código de origem desse banco de dados pode ser encontrado em
http://www.firebirdsql.org
Para obter uma listagem de avisos de copyright de terceiros, consulte o arquivo a seguir que é
instalado com o Tableau Server:
C:\Program Files\Tableau\Tableau Server\8.1\COPYRIGHTS.rtf
Observação: Se você tiver instalado o Tableau Server 32 bits em um sistema
operacional 64 bits, ele estará em C:\Program Files (x86)
\Tableau\Tableau Server\8.1\COPYRIGHTS.rtf
Este produto inclui software desenvolvido por Andy Clark.
Este produto inclui software desenvolvido pela Apache Software Foundation
(http://www.apache.org/).
Este produto é Client Software, conforme definido no Acordo de Licença de Software do
Usuário Final do Tableau Software.