Tableau Cloud 도움말

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

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

CSV 파일 형식 요구 사항

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

• 열 머리글이 없어야 합니다. Tableau Cloud는 파일의 모든 라인이 사용자를 나타내는 것으로 간주합니다.
• 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 Cloud CSV의 열 세부 정보

CSV 파일에 사용자 이름 값(이메일 주소)만 포함된 경우 사용자가 사이트 초대 이메일을 받습니다. 사용자는 사이트에 가입하여 자신의 계정을 만들 수 있지만 관리자가 계정을 구성(표시 이름, 라이선스 수준 등)할 때까지 계정에 라이선스가 부여되지 않습니다. 사이트에서 사용자의 이메일 주소는 처음 로그인할 때까지 선행 마침표(예: .user@domain.com)와 함께 사이트에 표시될 수 있습니다.

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

열 세부 정보:

Username: 필수 항목입니다. 사용자의 이메일 주소입니다.

Password: 무시됩니다. 가장 좋은 방법은 이 열을 비워 두는 것입니다.

• 새 사용자는 Tableau Cloud에 처음 로그인할 때 비밀번호와 표시 이름을 선택해야 합니다. 사용자에게 Tableau 계정이 이미 있는 경우 비밀번호도 이미 보유하고 있을 수 있습니다.

Display name: 무시됩니다. 가장 좋은 방법은 이 열을 비워 두는 것입니다.

License level: Creator, Explorer, Viewer 또는 Unlicensed일 수 있습니다. 비워 두면 라이선스 수준이 Unlicensed(라이선스 없음)가 됩니다.

Administrator level: Site 또는 None일 수 있습니다. 비워 두면 관리자 수준은 None(없음)이 됩니다.

• Site는 사이트 관리자이고, None은 관리자 이외의 사용자입니다.
• 참고: Cloud는 Tableau Cloud Manager를 사용하는 경우에만 관련되는 값입니다. 자세한 내용은 Tableau Cloud Manager로 사용자 관리를 참조하십시오.

Publishing capability: Yes/True/1 또는 No/False/0일 수 있습니다. 비워 두면 게시 기능이 false가 됩니다.

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

Email address: 2025년 7월(Tableau 2025.2)부터 사용자 이름과 다른 경우 이메일 주소를 지정해야 합니다. 이메일 주소는 알림 목적으로만 사용됩니다. 이메일 주소 값이 제공되지 않으면 Tableau Cloud는 필수 사용자 이름 필드의 값을 사용하여 알림을 보냅니다.

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

TCM을 사용하지 않는 인증 유형

Tableau Cloud Manager를 사용하지 않는 경우 업로드 중에 하나의 기본 인증 유형만 설정할 수 있습니다. 나중에 개별 사용자의 인증 유형을 변경할 수 있습니다.

• Tableau Cloud에서 CSV 파일을 직접 업로드하는 경우 파일을 가져올 때 인증 유형을 지정하면 가져온 모든 사용자에게 해당 유형이 적용됩니다.
• tabcmd를 사용하여 사용자를 가져오는 경우 업로드 중에 CSV 파일에 있는 모든 사용자에게 적용되는 인증 유형 및 사이트 역할을 설정할 수도 있습니다. 자세한 내용은 createsiteusers filename.csv를 참조하십시오.

업로드 시 사용자별로 특정 인증 유형을 설정하려면 Tableau Cloud Manager를 사용해야 합니다. 자세한 내용은 Tableau Cloud Manager로 사용자 관리를 참조하십시오.

Tableau Cloud CSV 구조 예

팁: 참고로, 구조는 username, password, display name, license level, administrator level, publishing capability, email address이며, 열을 비워 두려면 쉼표 사이에 공백을 넣으면 됩니다.

다음 예제에서는 Explorer(게시 가능) 사이트 역할이 부여되고, 사이트 관리자가 아니며, 적절한 콘텐츠 사용 권한이 있는 프로젝트에 게시할 수 있는 사용자를 보여 줍니다.

user1@domain.com,,,Explorer,None,true,user1@domain2.com

관리자 수준 열을 변경하면 다음 사용자를 사이트 관리자 Explorer 사이트 역할이 있는 사이트 관리자로 가져올 수 있습니다.

adminuser@domain.com,,,Explorer,Site,true,adminuser@domain2.com

TCM CSV의 열 세부 정보

CSV 파일에 사용자 이름(이메일 주소) 값만 포함된 경우 사용자가 사이트 초대 이메일을 받습니다. 사용자는 사이트에 가입하여 자신의 계정을 만들 수 있지만 관리자가 계정을 구성(표시 이름, 라이선스 수준 등)할 때까지 계정에 라이선스가 부여되지 않습니다.

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

CSV 파일의 열 구조: tenant or site URI, username, password, display name, license level, administrator level, publishing capability, authentication type

열 세부 정보: 

Tenant or site URI: 테넌트 또는 사이트의 Uniform Resource Identifier입니다.

Username: 필수 항목입니다. 사용자의 이메일 주소입니다.

Password: 무시됩니다. 가장 좋은 방법은 이 열을 비워 두는 것입니다.

• 새 사용자는 Tableau Cloud에 처음 로그인할 때 비밀번호와 표시 이름을 선택해야 합니다. 사용자에게 Tableau 계정이 이미 있는 경우 비밀번호도 이미 보유하고 있을 수 있습니다.

Display name: 무시됩니다. 가장 좋은 방법은 이 열을 비워 두는 것입니다.

License level: 사이트에 대해 Creator, Explorer, Viewer 또는 Unlicensed일 수 있습니다. 비워 두면 라이선스 수준이 Unlicensed(라이선스 없음)가 됩니다.

Administrator level: Site, Cloud 또는 None일 수 있습니다. 비워 두면 관리자 수준은 None(없음)이 됩니다.

• Site는 사이트 관리자이고, None은 관리자가 아닌 사용자이며 Cloud는 Cloud 관리자입니다.

Publishing capability: 사이트에 대해 True 또는 False일 수 있습니다. 비워 두면 게시 기능이 false가 됩니다.

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

Authentication type: 테넌트 또는 사이트에 액세스하기 위한 사용자 인증 유형입니다. Google, OpenID, Salesforce, SAML, TableauIDWithMFA 또는 DEFAULT일 수 있습니다.

TCM CSV 구조 예제

팁: 참고로, 구조는 tenant or site URI, username, password, display name, license level, administrator level, publishing capability, email address, authentication type이며, 열을 비워 두려면 쉼표 사이에 공백을 넣으면 됩니다.

다음 예에서는 Tableau Cloud Manager에서 Cloud 관리자 역할을 부여받고 Tableau 및 MFA를 사용하여 인증하는 사용자를 보여줍니다.

MyTCM,cloudadminuser@domain.com,,,,Cloud,,,TableauIDWithMFA

인증 열을 변경하면 Tableau Cloud Manager 설정에 대체 인증 유형이 구성된 경우 대체 인증 유형을 사용하여 다음 사용자를 가져올 수 있습니다.

MyTCM,cloudadminuser@domain.com,,,,Cloud,,,Salesforce

다음 예에서는 Explorer(게시 가능) 사이트 역할과 Tableau 및 MFA 인증을 사용하는 사용자를 가져올 수 있습니다.

MySite,user1@domain.com,,,Explorer,None,True,,TableauIDWithMFA