Diretrizes do arquivo de importação CSV

Você pode adicionar usuários em massa ao criar um arquivo de valores separados por vírgula (CSV) com informações do usuário e ao importar o arquivo. Você pode incluir atributos no arquivo CSV, como o nível de licença e o acesso de publicação, para serem aplicados aos usuários ao mesmo tempo que são importados.

Este tópico aborda os detalhes do próprio arquivo CSV. Para importar usuários usando o CSV, você pode:

É possível importar usuários no nível de site ou servidor. Se você importar usuários para o servidor (não para um site específico), eles não serão atribuídos a um site e serão importados como Não licenciados.

Observação: salvo indicação em contrário, as diretrizes especificadas neste tópico se aplicam ao Tableau Server configurado com ou sem pools de identidade(O link abre em nova janela).

Requisitos de formato do arquivo CSV

O arquivo CSV para importação de usuários tem os seguintes requisitos de formatação:

  • Sem cabeçalhos de coluna. Tableau Server pressupõe que cada linha no arquivo representa um usuário.
  • Formato UTF-8 com a marca de ordem de byte (BOM).
    • As codificações de caracteres, como BIG-5, devem ser convertidas em UTF-8. Isso é possível abrindo o arquivo em um editor de texto e usando o comando Salvar como.
    • Se o caractere @ estiver presente no campo nome de usuário para qualquer coisa que não seja um separador de domínio, ele deverá estar no formato hexadecimal: \0x40. Por exemplo, user@fremont@mycompany.com deve ser user\0x40fremont@mycompany.com.

Estrutura de coluna necessária no arquivo CSV

O arquivo não deve conter uma linha de cabeçalho. Nem todas as colunas precisam ser preenchidas, mas a estrutura de coluna necessária deve ser preservada, incluindo todos os delimitadores de vírgula esperados.

A estrutura da coluna varia por produto e por ferramenta de importação. Verifique se você está usando a estrutura apropriada para seu ambiente:

  • Tableau Cloud: nome de usuário, senha, nome de exibição, nível de licença, nível de administrador, recurso de publicação, endereço de e-mail
  • Tableau Cloud with Tableau Cloud Manager (TCM): URI do locatário ou do site, nome de usuário, senha, nome de exibição, nível de licença, nível de administrador, capacidade de publicação, endereço de e-mail, tipo de autenticação
  • Tableau Server: nome de usuário, senha, nome de exibição, nível de licença, nível de administrador, recurso de publicação, endereço de e-mail
  • Tableau Server usando pools de identidades: nome de usuário, senha, nome de exibição, nível de licença, nível de administrador, recurso de publicação, endereço de e-mail, nome do pool de identidades, identificador

Consulte a seção de detalhes da coluna abaixo para obter mais informações sobre os valores possíveis para cada coluna.

Importante: a ordem da coluna é importante. A primeira coluna é tratada como o nome de usuário, a segunda como a senha, a terceira como nome de exibição etc., independentemente do conteúdo das colunas. Mesmo que você opte por omitir os valores de um campo, ainda será necessário incluir o delimitador de vírgula desse campo.

Detalhes de coluna do Tableau Server

Observação: se você não estiver conectado a um site específico e estiver importando usuários no nível de servidor, poderá atribuir apenas as funções no site Administrador do servidor e Não licenciado.

Estrutura de coluna para o arquivo CSV: username, password, display name, license level, admin level, publishing capability, email address

Detalhes da coluna: 

Nome de usuário: obrigatório. O nome do usuário.

  • Se o servidor estiver configurado para usar o Active Directory, este valor deve corresponder a um usuário definido no Active Directory. Se o nome de usuário não for exclusivo nos domínios, inclua o domínio como parte do nome de usuário (por exemplo, example\Adam ou adam@example).
  • Se for adicionar usuários a um pool de identidade(O link abre em nova janela), certifique-se do seguinte:
    • Se adicionar um usuário a um pool de identidades que usa o AD como seu armazenamento de identidades, certifique-se de usar o valor AD sAMAccountName para o nome do usuário.
    • Se adicionar um usuário a um pool de identidade que usa LDAP como seu armazenamento de identidade, certifique-se de usar o valor de nome de usuário do LDAP para nome de usuário.

Senha: senha para o usuário. A necessidade dessa coluna depende da configuração do servidor:

Nome de exibição: o nome de exibição faz parte da informação usada para identificar um usuário no servidor. A utilização dessa coluna depende da configuração do servidor:

  • Autenticação local: se o nome de exibição do usuário já estiver em uso, o Tableau Server atualizará as informações existentes do usuário com as configurações no arquivo CSV.
  • Active Directory: ignorado. Como prática recomendada, deixe esta coluna em branco.

Nível de licença: pode ser Creator (Criador), Explorer (Explorador), Viewer (Visualizador) ou Não licenciado.

  • Se o nível de licença for Creator, o recurso de publicação deverá ser Yes/True/1
  • Se você tiver uma instalação de servidor baseada em usuário e a adição de usuários exceder o número de usuários permitido pela sua licença, os usuários serão adicionados como não licenciados.
  • Se você usar tabcmd e especificar a licença, mas a importação de usuários exceder os seus limites de licença, os usuários serão importados como não licenciados.

Nível de administrador: pode ser Sistema, Site ou Nenhum e determina se o usuário será importado como um administrador.

  • Sistema = administrador do servidor, Site = administrador do site e Nenhum = não é administrador.
  • Se não estiver conectado a um site específico e estiver importando usuários no nível de servidor, poderá atribuir apenas o Administrador do servidor e Não licenciado.
  • Se você usar a interface do usuário da Web para importar usuários, poderá definir a função no site de administrador como Sistema apenas se importar o arquivo no nível de servidor (todos os sites). Se você estiver conectado a um site específico e a coluna de administrador para um usuário no arquivo CSV estiver definida como Sistema, o Tableau Server importará tal usuário como administrador de site.

Recurso de publicação: pode ser Yes/True/1 ou No/False/0. Se você usar a interface do usuário da Web, o recurso de publicação será usado somente se a importação for realizada enquanto você estiver conectado a um determinado site.

  • Se o nível de licença for Creator, o recurso de publicação deverá ser Yes/True/1
  • Se o nível de licença for Explorer, o valor do recurso de publicação será o que distingue a função no site entre Explorer (pode publicar) e Explorer
  • Se o nível de licença for Viewer ou Não licenciado, o usuário não poderá publicar, independentemente do valor desta coluna

Endereço de e-mail: o endereço de e-mail faz parte da informação usada para identificar um usuário no servidor. Se o endereço de e-mail já estiver sendo usado, o Tableau Server atualiza as informações existentes do usuário com as configurações no arquivo CSV.

As colunas deixadas em branco ainda devem ser delimitadas com vírgulas para preservar a estrutura da coluna.

Pools de identidade

Se você adicionar usuários a um pool de identidades, as seguintes colunas serão necessárias além das colunas padrão:

Estrutura de coluna para o arquivo CSV: username, password, display name, license level, admin level, publishing capability, email address, identity pool name, identifier

Detalhes adicionais da coluna:

Nome do pool de identidade: o nome do pool de identidades ao qual você deseja adicionar o usuário. Se você estiver adicionando usuários a um pool de identidades e não especificar o nome desse pool, os usuários serão adicionados ao grupo inicial (TSM configurado), que é o conjunto de usuários que foram provisionados no TSM durante a instalação do Tableau Server.

Identificador: o identificador do usuário que você deseja adicionar. Os identificadores são usados apenas para fins de correspondência de identidade. Para obter mais informações, veja Nomes de usuário e identificadores no Tableau.

  • Autenticação local: opcional
  • Active Directory ou LDAP: obrigatório

Adicionar usuários em massa com pools de identidades

Você pode usar o processo de importação de CSV para:

  • Adicionar usuários em massa a grupos de identidades adicionais. Observação: você não pode usar o processo de importação de CSV para substituir o grupo de identidades ao qual um usuário já pertence por outro grupo de identidades. Se você adicionar um usuário existente com um valor de grupo de identidades diferente, ele será adicionado a esse grupo de identidades adicional.
  • Adicione identificadores em massa para usuários que ainda não os possuem. Observação: se você adicionar um identificador diferente para um usuário no mesmo pool, ele não substituirá o identificador existente desse usuário. Em vez disso, um novo registro identificador será criado para esse usuário.

Exemplo de importação de CSV para o Tableau Server

Dica: lembre-se de que a estrutura é: username, password, display name, license level, admin level, publishing capability, email address.

O exemplo a seguir mostra um arquivo CSV que contém as informações de vários usuários.

henryw,henrypassword,Henry Wilson,Creator,None,yes,henryw@example.com
freds,fredpassword,Fred Suzuki,Viewer,None,no,freds@example.com
alanw,alanpassword,Alan Wang,Explorer,Site,yes,alanw@example.com
michellek,michellepassword,Michelle Kim,Creator,System,yes,michellek@example.com
  • Se você importar este arquivo enquanto gerencia um site, quatro usuários são adicionados a esse site. A configuração Administrator para o usuário Michelle éSystem. No entanto, como você está importando os usuários para um site, o Tableau Server fornece a Michelle a função no site Creator (Administrador de site). Três usuários têm permissão para publicar.
  • Se você importar este arquivo enquanto gerencia o servidor, quatro usuários são adicionados ao servidor, mas não a qualquer site. Apenas um usuário é importado como administrador de servidor, os outros são definidos como não licenciados.

Exemplos de pools de identidades.

Dica: lembre-se de que a estrutura é: username, password, display name, license level, admin level, publishing capability, email address, identity pool name, identifier.

O exemplo a seguir mostra um arquivo CSV que contém informações de dois usuários adicionados a um pool de identidades.

henryw,henrypassword,Henry Wilson,Viewer,None,yes,hwilson@myco.com,General Contractors,hwilson
freds,fredpassword,Fred Suzuki,Creator,None,no,fsuzuki@myco.com,General Contractors,fsuzuki

O exemplo a seguir mostra um arquivo CSV que contém informações de dois usuários adicionados a um pool de outras identidades opcional.

henryw,henrypassword,Henry Wilson,Viewer,None,yes,hwilson@myco.com,General Contractors 2,hwilson
freds,fredpassword,Fred Suzuki,Creator,None,no,fsuzuki@myco.com,General Contractors 2,fsuzuki

O exemplo a seguir mostra um arquivo CSV que contém informações de dois usuários sem identificadores existentes.

janes,janepassword,Jane Smith,Viewer,None,yes,jsmith@myco.com,General Contractors,jwang
laurar,laurapassword,Laura Rodriguez,Creator,None,no,lrodriguez@myco.com,General Contractors,jrodriguez

Melhorar o desempenho de grandes arquivos CSV passados pelo tabcmd

Observação: essas configurações se aplicam ao Tableau Server versão 2022.1 e anteriores. O serviço de pesquisa e indexação afetado está obsoleto desde versão 2022.3 e descontinuado (removido completamente) em 2023.3.

Um administrador do servidor pode ativar as configurações do servidor que ajudam a melhorar o desempenho para a importação de arquivos CSV grandes por meio de comandos tabcmd. Para isso, é possível usar o comando tsm configuration set com as seguintes opções:

  • vizportal.csv_user_mgmt.index_site_users
  • vizportal.csv_user_mgmt.bulk_index_users
  • searchserver.index.bulk_query_user_groups

Em suma, essas opções constroem um índice de usuários após o processamento do arquivo CSV, em vez de um a um ao longo do processo de adição no banco de dados do servidor. Isso reduz o número de chamadas para o banco de dados e a memória necessária para processar o arquivo. Essas opções tsm configuration set se aplicam aos comandos tabcmd createsiteusers, deletesiteusers, addusers e removeusers.

Para obter as descrições dessas configurações, consulte Opções do tsm configuration set.

Configurações de CSV e funções no site

As configurações de nível de licença, administrador e publicação de um usuário determinam como a função no site do usuário é definida durante o processo de importação. A seguir, é mostrado como as funções no site devem ser capturadas no CSV.

Função no siteNível de licençaNível de administradorRecurso de publicação

Administrador de servidor

Essa função será válida somente se você estiver importando usuários durante o gerenciamento do servidor (ou seja, sem estar conectado a um site específico).

Qualquer um, mas a função no site Administrador do servidor sempre usa uma licença Creator se houver uma disponível. Se nenhuma licença de Creator estiver disponível, consulte Solucionar problemas de licenciamento para saber sobre como o Tableau Server lida com isso.SistemaTrue

Creator (Administrador de site) ou Explorer (Administrador de site)

Essas funções serão válidas somente se você estiver importando usuários quando estiver conectado a um site específico.

Creator ou ExplorerSiteTrue
CreatorCreatorNenhumTrue
Explorer (pode publicar)ExplorerNenhumTrue
ExplorerExplorerNenhumFalse
ViewerViewerNenhumFalse
Não licenciadoNão licenciadoNenhumFalse
Agradecemos seu feedback!Seu feedback foi enviado. Obrigado!