Diretrizes do arquivo de importação CSV

Você pode automatizar a adição de usuários ao criar um arquivo de valores separados por vírgula (CSV) com informações do usuário e 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.

Para importar usuários, use as páginas de administração do servidor ou do site ou use o utilitário tabcmd. Usar o tabcmd oferece uma opção para atribuir uma função no site a todos os usuários no arquivo CSV. Para obter informações, consulte Importar usuários ou createsiteusers filename.csv.

É 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 quando configurado com ou sem pools de identidade(O link abre em nova janela).

Requisitos de formato do arquivo CSV

Quando você criar o arquivo CSV para importação dos usuários, certifique-se de que o arquivo atenda aos requisitos de formatação:

  • O arquivo não inclui os cabeçalhos da coluna. Tableau Server pressupõe que cada linha no arquivo representa um usuário.

  • O arquivo está no formato UTF-8 e inclui a marca de ordem de byte (BOM).

  • Codificações de caracteres, como BIG-5, foram convertidas para UTF-8. Isso é possível abrindo o arquivo em um editor de texto e usando o comando Salvar como.

  • Se um nome de usuário incluir um caractere @ que representa qualquer forma que não seja um separador de domínio, será necessário fazer referência ao símbolo usando o formato hexadecimal: \0x40

    Por exemplo, user@fremont@mycompany.com deve ser user\0x40fremont@mycompany.com

Colunas exigidas no arquivo CSV

Os campos a seguir são necessários para cada usuário:

  • Username. O nome de 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, você deverá incluir 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. Uma senha para o usuário.

    • Se o servidor estiver configurado para usar o Active Directory, esse valor não será usado, entretanto, deverá haver uma coluna de senha e a própria coluna deverá estar vazia.

    • Se o servidor estiver usando autenticação local, você deverá fornecer senhas para novos usuários.

    Observação: a aplicação do campo de senha obrigatório foi iniciada no Tableau Server 2024.2. Para obter mais informações, consulte o artigo de conhecimento Ocorre “errorCode=134” inesperado ao tentar adicionar usuários por meio de tabcmd no Tableau Server 2024.2.

Opções adicionais de arquivos de importação

O arquivo CSV pode conter os seguintes campos além dos campos listados acima, na ordem mostrada aqui:

  • Nome de exibição. O nome de exibição é parte da informação usada para identificar um usuário no servidor. Se o nome de exibição do usuário já estiver em uso, o Tableau Server atualiza as informações existentes do usuário com as configurações no arquivo CSV. Se o servidor for configurado usando o Active Directory, este valor não é usado.

  • Nível de licença. Isso pode ser Creator (Criador), Explorer (Explorador), Viewer (Visualizador) ou Não licenciado. Se você especificar Creator para uma conta de usuário específica, você também deverá definir o recurso de publicação como True.

  • Nível do administrador (System, Site ou None). Essa configuração determina se um usuário será importado como um administrador.

    Ao usar a UI da Web para importar usuários, você poderá definir a função no site de administrador como Sistema apenas se importar o arquivo a nível de servidor (todos os sites). Se 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 administrator de site.

  • Capacidade de publicação (yes/true/1 ou no/false/0). Ao usar as páginas de UI da Web, a configuração do publicador será empregada somente se a importação for realizada enquanto você estiver logado em um determinado site.

  • Endereço de e-mail. O endereço de e-mail é 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.

Ao adicionar usuários a um pool de identidades, os seguintes valores são necessários além dos acima:

  • Nome do pool de identidades. O nome do pool de identidades ao qual você deseja adicionar o usuário.

  • 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. Observação: o identificador é necessário ao adicionar um usuário a um grupo de identidades que usa armazenamento de identidades do Active Directory (ou LDAP). O identificador é opcional ao adicionar um usuário a um grupo de identidades que usa o armazenamento de identidades local.

    Observações:

    • 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.
    • Para obter o valor do nome de usuário, 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.
    • 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.

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.

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.

Observações

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

  • Se você tiver uma instalação de servidor baseada em usuário, e se adicionar usuários ultrapassaria o número permitido pela sua licença, os usuários serão adicionados como não licenciados.

  • Se você usar o 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.

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 tabela a seguir mostra como as configurações são convertidas a funções do site.

Configurações do CSVFunção de site

Nível de licença=(qualquer)

Administrador=Sistema

Publicador=verdadeiro

Administrador de servidor. Esta configuração se aplica apenas ao Tableau Server e é válida somente quando a importação de usuários ocorre durante o gerenciamento do servidor (ou seja, quando você não estiver logado em um determinado site).

A função no site de Administrador do servidor sempre recebe uma licença de 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.

Nível de licença=Creator ou Explorer

Administrado=Site

Publicador=verdadeiro

Creator (Administrador de site) ou Explorer (Administrador de site) Essa configuração é válida somente se você estiver importando usuários quando estiver conectado a um site específico.

Nível de licença=Criator

Administrador=Nenhum

Publicador=verdadeiro

Creator

Nível de licença=Explorer

Administrador=Nenhum

Publicador=verdadeiro

Explorer (pode publicar)

Nível de licença=Explorer

Administrador=Nenhum

Publicador=falso

Explorer

Nível de licença=Viewer (Visualizador)

Administrador=Nenhum

Publicador=falso

Viewer

Nível de licença=Não licenciado

Administrador=Nenhum

Publicador=falso

Não licenciado

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

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 de Criador do 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.

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 Silva,Viewer,None,yes,js@silva.com,General Contractors,jwang
laurar,laurapassword,Laura Rodriguez,Creator,None,no,lrodriguez@myco.com,General Contractors,jrodriguez
Agradecemos seu feedback!Seu feedback foi enviado. Obrigado!