Linux 기반 Tableau Server 도움말

이 항목에서는 CSV 파일 자체에 대한 세부 정보를 다룹니다. CSV를 사용하여 사용자를 가져오려면 다음과 같이 하면 됩니다.

• 서버 또는 사이트 관리 페이지를 사용합니다. 자세한 내용은 사용자 가져오기를 참조하십시오.
• tabcmd 유틸리티를 사용합니다. 자세한 내용은 createsiteusers filename.csv를 참조하십시오.

사이트 또는 서버 수준에서 사용자를 가져올 수 있습니다. 특정 사이트가 아닌 서버로 사용자를 가져오는 경우 사용자를 사이트에 할당하지 않고 라이선스 없음으로 가져옵니다.

참고: 달리 명시되지 않는 한 이 항목에 명시된 지침은 ID 풀(링크가 새 창에서 열림) 유무와 관계없이 구성된 Tableau Server에 적용됩니다.

CSV 파일 형식 요구 사항

사용자를 가져오기 위한 CSV 파일의 형식 요구 사항은 다음과 같습니다.

• 열 머리글이 없어야 합니다. Tableau Server는 파일의 모든 라인이 사용자를 나타내는 것으로 간주합니다.
• BOM(바이트 순서 표시)이 있는 UTF-8 형식이어야 합니다.
  • BIG-5와 같은 문자 인코딩을 UTF-8로 변환해야 합니다. 이 작업은 텍스트 편집기에서 파일을 열고 다른 이름으로 저장 명령을 사용하여 수행할 수 있습니다.
  • 도메인 구분 기호 이외의 @ 문자가 username 필드에 있는 경우 16진수 형식인 \0x40이어야 합니다. 예를 들어 user@fremont@mycompany.com은 user\0x40fremont@mycompany.com이 되어야 합니다.

CSV 파일의 필수 열 구조

파일에는 머리글 행이 포함되어서는 안 됩니다. 모든 열을 채울 필요는 없지만 필요한 모든 쉼표 구분 기호를 포함하여 필수 열 구조를 유지해야 합니다.

열 구조는 제품과 가져오기 도구에 따라 다릅니다. 환경에 적합한 구조를 사용하고 있는지 확인해야 합니다.

• Tableau Cloud: 사용자 이름, 비밀번호, 표시 이름, 라이선스 수준, 관리자 수준, 게시 기능, 이메일 주소
• TCM(Tableau Cloud Manager)가 있는 Tableau Cloud: 테넌트 또는 사이트 URI, 사용자 이름, 비밀번호, 표시 이름, 라이선스 수준, 관리자 수준, 게시 기능, 이메일 주소, 인증 유형
• Tableau Server: 사용자 이름, 비밀번호, 표시 이름, 라이선스 수준, 관리 수준, 게시 기능, 이메일 주소
• ID 풀을 사용한 Tableau Server: 사용자 이름, 비밀번호, 표시 이름, 라이선스 수준, 관리 수준, 게시 기능, 이메일 주소, ID 풀 이름, 식별자

각 열에 사용할 수 있는 값에 대한 자세한 내용은 아래의 열 세부 정보 섹션을 참조하십시오.

중요: 열의 순서는 매우 중요합니다. 열의 내용과 관계없이 첫 번째 열은 사용자 이름으로, 두 번째 열은 암호로, 세 번째 열은 표시 이름으로 처리되는 식입니다. 필드의 값을 생략해도 필드의 쉼표 구분 기호는 포함해야 합니다.

Tableau Server의 열 세부 정보

참고: 특정 사이트에 로그인하지 않고 서버 수준에서 사용자를 가져오는 경우 서버 관리자 및 라이선스 없음 사이트 역할만 할당할 수 있습니다.

CSV 파일의 열 구조: username, password, display name, license level, admin level, publishing capability, email address

열 세부 정보: 

Username: 필수 항목입니다. 사용자의 이름입니다.

• 서버가 Active Directory를 사용하도록 구성되어 있는 경우 이 값은 Active Directory에 정의되어 있는 사용자와 일치해야 합니다. 사용자 이름이 도메인 간에서 고유하지 않은 경우 example\Adam또는 adam@example과 같이 사용자 이름의 일부로 도메인을 포함합니다.
• ID 풀(링크가 새 창에서 열림)에 사용자를 추가하는 경우 다음을 확인하십시오.
• AD를 ID 저장소로 사용하는 ID 풀에 사용자를 추가하는 경우 사용자 이름에 AD sAMAccountName 값을 사용해야 합니다.
• LDAP를 ID 저장소로 사용하는 ID 풀에 사용자를 추가하는 경우 사용자 이름에 LDAP username 값을 사용해야 합니다.

Password: 사용자의 비밀번호입니다. 이 열이 필요한지 여부는 서버 구성에 따라 다릅니다.

• 로컬 인증: 필수 항목입니다. Tableau Server 2024.2부터 비밀번호 필드가 필수 사항이 되었습니다. 자세한 내용은 기술 자료 Tableau Server 2024.2에서 tabcmd를 통해 사용자를 추가하려고 하면 예기치 않은 'errorCode=134' 오류 발생(영문)을 참조하십시오.
• Active Directory: 무시됩니다. 가장 좋은 방법은 이 열을 비워 두는 것입니다.

Display name: 표시 이름은 서버에서 사용자를 식별하는 데 사용되는 정보에 속합니다. 이 열이 사용되는지 여부는 서버 구성에 따라 다릅니다.

• 로컬 인증: 사용자의 표시 이름이 이미 사용되고 있는 경우 Tableau Server는 기존 사용자 정보를 CSV 파일의 설정으로 업데이트합니다.
• Active Directory: 무시됩니다. 가장 좋은 방법은 이 열을 비워 두는 것입니다.

License level: Creator, Explorer, Viewer 또는 Unlicensed일 수 있습니다.

• 라이선스 수준이 Creator인 경우 게시 기능은 Yes/True/1이어야 합니다.
• 사용자 기반 서버 설치 환경에서 사용자 추가가 라이선스에서 허용하는 사용자 수를 초과하면 사용자가 라이선스 없음 사용자로 추가됩니다.
• tabcmd를 사용하고 라이선스를 지정했지만 사용자 가져오기에서 라이선스 한도를 초과한 경우 사용자를 라이선스 없음 사용자로 가져옵니다.

Administrator level: System, Site 또는 None일 수 있으며 사용자를 관리자로 가져올지 여부를 결정합니다.

• System은 서버 관리자이며, Site는 사이트 관리자이고, None은 관리자가 아닌 사용자입니다.
• 특정 사이트에 로그인하지 않고 서버 수준에서 사용자를 가져오는 경우 서버 관리자 및 라이선스 없음만 할당할 수 있습니다.
• 웹 UI를 사용하여 사용자를 가져오는 경우 서버(모든 사이트) 수준에서 파일을 가져오는 경우에만 관리자 사이트 역할을 System으로 설정할 수 있습니다. 특정 사이트에 로그인되어 있으며 CSV 파일에 사용자의 관리자 열이 System으로 설정되어 있으면 Tableau Server가 해당 사용자를 사이트 관리자로 가져옵니다.

Publishing capability: Yes/True/1 또는 No/False/0일 수 있습니다. 웹 UI를 사용하는 경우 특정 사이트에 로그인되어 있는 상태로 가져오는 경우에만 게시 기능이 사용됩니다.

• 라이선스 수준이 Creator인 경우 게시 기능은 Yes/True/1이어야 합니다.
• 라이선스 수준이 Explorer인 경우 게시 기능 값은 Explorer(게시 가능)와 Explorer 간의 사이트 역할을 구분하는 값입니다.
• 라이선스 수준이 Viewer(뷰어) 또는 Unlicensed(라이선스 없음)인 경우 사용자는 이 열의 값에 관계없이 게시할 수 없습니다.

Email address: 이메일 주소는 서버에서 사용자를 식별하는 데 사용되는 정보에 속합니다. 이메일 주소가 이미 사용되고 있는 경우 Tableau Server는 기존 사용자 정보를 CSV 파일의 설정으로 업데이트합니다.

비워 둔 열은 열 구조를 유지하기 위해 쉼표로 구분해야 합니다.

ID 풀

ID 풀에 사용자를 추가하는 경우 표준 열과 다음 열이 필요합니다.

CSV 파일의 열 구조: username, password, display name, license level, admin level, publishing capability, email address, identity pool name, identifier

추가 열 세부 정보:

Identity pool name: 사용자를 추가할 ID 풀의 이름입니다. ID 풀에 사용자를 추가하고 ID 풀 이름을 지정하지 않으면 Tableau Server 설치 중에 TSM에서 프로비저닝한 사용자 집합인 초기 풀(TSM 구성됨)에 사용자가 추가됩니다.

Identifier: 추가할 사용자의 식별자입니다. 식별자는 ID 일치 목적으로만 사용됩니다. 자세한 내용은 Tableau의 사용자 이름 및 식별자을 참조하십시오.

• 로컬 인증: 선택 사항
• Active Directory 또는 LDAP: 필수

ID 풀을 사용하여 사용자 일괄 추가

CSV 가져오기 프로세스를 사용하여 다음을 수행할 수 있습니다.

• 추가 ID 풀에 사용자를 일괄 추가합니다. 참고: CSV 가져오기 프로세스를 사용하여 사용자가 이미 속한 ID 풀을 다른 ID 풀로 바꿀 수는 없습니다. 다른 ID 풀 값을 가진 기존 사용자를 추가하면 해당 사용자가 추가 ID 풀에 추가됩니다.
• 아직 식별자가 없는 사용자를 위해 식별자를 일괄 추가합니다. 참고: 동일한 풀에 있는 사용자에 대해 다른 식별자를 추가해도 해당 사용자의 기존 식별자는 대체되지 않습니다. 대신 해당 사용자에 대한 새 식별자 레코드가 만들어집니다.

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

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

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

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